@duckmind/dm-darwin-x64 0.67.1 → 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 (784) hide show
  1. package/README.md +2 -2
  2. package/dm +2 -2
  3. package/extensions/.dm-extensions.json +147 -32
  4. package/extensions/dm-lens/clients/actionable-warnings.js +12 -4
  5. package/extensions/dm-lens/clients/advisory-provenance.js +11 -10
  6. package/extensions/dm-lens/clients/agent-nudge.js +1 -1
  7. package/extensions/dm-lens/clients/analysis-root.js +75 -34
  8. package/extensions/dm-lens/clients/bash-file-access.js +550 -123
  9. package/extensions/dm-lens/clients/blocker-freshness.js +202 -19
  10. package/extensions/dm-lens/clients/blocker-past-eof.js +3 -1
  11. package/extensions/dm-lens/clients/bounded-telemetry.js +3 -0
  12. package/extensions/dm-lens/clients/cache-manager.js +22 -1
  13. package/extensions/dm-lens/clients/cache-observability.js +278 -17
  14. package/extensions/dm-lens/clients/cargo-manifest.js +8 -12
  15. package/extensions/dm-lens/clients/cascade-format.js +162 -19
  16. package/extensions/dm-lens/clients/codebase-model.js +2 -2
  17. package/extensions/dm-lens/clients/config-locations.js +1 -8
  18. package/extensions/dm-lens/clients/content-stamp.js +16 -0
  19. package/extensions/dm-lens/clients/context-injection-ledger.js +160 -0
  20. package/extensions/dm-lens/clients/deferred-runner-blockers.js +46 -6
  21. package/extensions/dm-lens/clients/degradation-ledger.js +21 -1
  22. package/extensions/dm-lens/clients/deps/ast-grep-napi.js +10 -0
  23. package/extensions/dm-lens/clients/diagnostic-dispositions.js +28 -12
  24. package/extensions/dm-lens/clients/disk-change-consumers.js +312 -0
  25. package/extensions/dm-lens/clients/disk-change-subscribers.js +197 -0
  26. package/extensions/dm-lens/clients/disk-changes.js +168 -0
  27. package/extensions/dm-lens/clients/dispatch/auxiliary-lsp.js +10 -6
  28. package/extensions/dm-lens/clients/dispatch/dispatcher.js +300 -61
  29. package/extensions/dm-lens/clients/dispatch/fact-store.js +2 -8
  30. package/extensions/dm-lens/clients/dispatch/facts/function-facts.js +87 -94
  31. package/extensions/dm-lens/clients/dispatch/finding-policy.js +25 -1
  32. package/extensions/dm-lens/clients/dispatch/indent-detect.js +1 -1
  33. package/extensions/dm-lens/clients/dispatch/integration.js +349 -135
  34. package/extensions/dm-lens/clients/dispatch/lane-copies.js +23 -0
  35. package/extensions/dm-lens/clients/dispatch/pending-runner-findings.js +3 -0
  36. package/extensions/dm-lens/clients/dispatch/pre-edit-seed.js +57 -0
  37. package/extensions/dm-lens/clients/dispatch/rule-id-normalize.js +6 -1
  38. package/extensions/dm-lens/clients/dispatch/rules/high-complexity.js +2 -17
  39. package/extensions/dm-lens/clients/dispatch/rules/high-fan-out.js +1 -9
  40. package/extensions/dm-lens/clients/dispatch/runner-context.js +9 -10
  41. package/extensions/dm-lens/clients/dispatch/runners/ast-grep-literal-anchors.js +58 -0
  42. package/extensions/dm-lens/clients/dispatch/runners/ast-grep-napi.js +59 -14
  43. package/extensions/dm-lens/clients/dispatch/runners/biome-check.js +9 -18
  44. package/extensions/dm-lens/clients/dispatch/runners/cue-vet.js +11 -21
  45. package/extensions/dm-lens/clients/dispatch/runners/dart-analyze.js +1 -1
  46. package/extensions/dm-lens/clients/dispatch/runners/detekt.js +4 -3
  47. package/extensions/dm-lens/clients/dispatch/runners/dotnet-build.js +15 -6
  48. package/extensions/dm-lens/clients/dispatch/runners/fish-indent.js +59 -5
  49. package/extensions/dm-lens/clients/dispatch/runners/gleam-check.js +9 -19
  50. package/extensions/dm-lens/clients/dispatch/runners/go-vet.js +2 -2
  51. package/extensions/dm-lens/clients/dispatch/runners/golangci-lint.js +17 -1
  52. package/extensions/dm-lens/clients/dispatch/runners/helm-lint.js +8 -5
  53. package/extensions/dm-lens/clients/dispatch/runners/helm-render.js +1 -1
  54. package/extensions/dm-lens/clients/dispatch/runners/ktlint.js +27 -5
  55. package/extensions/dm-lens/clients/dispatch/runners/lsp.js +91 -30
  56. package/extensions/dm-lens/clients/dispatch/runners/oxlint.js +9 -18
  57. package/extensions/dm-lens/clients/dispatch/runners/shellcheck.js +11 -20
  58. package/extensions/dm-lens/clients/dispatch/runners/shfmt.js +7 -0
  59. package/extensions/dm-lens/clients/dispatch/runners/taplo.js +2 -1
  60. package/extensions/dm-lens/clients/dispatch/runners/tree-sitter.js +29 -16
  61. package/extensions/dm-lens/clients/dispatch/runners/utils/availability-policy.js +32 -4
  62. package/extensions/dm-lens/clients/dispatch/runners/utils/candidate-probe.js +8 -0
  63. package/extensions/dm-lens/clients/dispatch/runners/utils/diagnostic-parsers.js +2 -1
  64. package/extensions/dm-lens/clients/dispatch/runners/utils/runner-helpers.js +1 -1
  65. package/extensions/dm-lens/clients/dispatch/runners/utils/tool-failure.js +9 -18
  66. package/extensions/dm-lens/clients/dispatch/runners/vale.js +2 -16
  67. package/extensions/dm-lens/clients/dispatch/types.js +45 -0
  68. package/extensions/dm-lens/clients/dispatch/utils/lsp-diagnostics.js +2 -1
  69. package/extensions/dm-lens/clients/ephemeral-root.js +10 -20
  70. package/extensions/dm-lens/clients/file-kinds.js +6 -2
  71. package/extensions/dm-lens/clients/file-mutation-queue.js +4 -8
  72. package/extensions/dm-lens/clients/file-utils.js +167 -28
  73. package/extensions/dm-lens/clients/finding-delivery-gate.js +15 -1
  74. package/extensions/dm-lens/clients/finding-identity.js +56 -0
  75. package/extensions/dm-lens/clients/fix-run-restore.js +10 -0
  76. package/extensions/dm-lens/clients/format-service.js +23 -5
  77. package/extensions/dm-lens/clients/formatters.js +33 -25
  78. package/extensions/dm-lens/clients/git-guard.js +516 -85
  79. package/extensions/dm-lens/clients/govulncheck-client.js +8 -0
  80. package/extensions/dm-lens/clients/grammar-source.js +39 -5
  81. package/extensions/dm-lens/clients/gzip-stage-write.js +99 -18
  82. package/extensions/dm-lens/clients/inline-blocker-fields.js +1 -1
  83. package/extensions/dm-lens/clients/installer/index.js +83 -85
  84. package/extensions/dm-lens/clients/installer/managed-tool-refresh.js +211 -8
  85. package/extensions/dm-lens/clients/instance-reaper.js +19 -8
  86. package/extensions/dm-lens/clients/instance-registry.js +12 -0
  87. package/extensions/dm-lens/clients/jscpd-client.js +20 -4
  88. package/extensions/dm-lens/clients/language-profile.js +8 -7
  89. package/extensions/dm-lens/clients/language-registry.js +45 -4
  90. package/extensions/dm-lens/clients/latency-logger.js +10 -2
  91. package/extensions/dm-lens/clients/lens-config.js +14 -4
  92. package/extensions/dm-lens/clients/lens-engine.js +10 -2
  93. package/extensions/dm-lens/clients/lens-flag-registry.js +19 -3
  94. package/extensions/dm-lens/clients/line-alignment.js +200 -0
  95. package/extensions/dm-lens/clients/lsp/capabilities.js +2 -2
  96. package/extensions/dm-lens/clients/lsp/cascade-tier.js +148 -38
  97. package/extensions/dm-lens/clients/lsp/client-registry.js +906 -0
  98. package/extensions/dm-lens/clients/lsp/client.js +413 -108
  99. package/extensions/dm-lens/clients/lsp/config.js +151 -47
  100. package/extensions/dm-lens/clients/lsp/content-limits.js +2 -2
  101. package/extensions/dm-lens/clients/lsp/content-scan.js +69 -0
  102. package/extensions/dm-lens/clients/lsp/created-import-targets.js +134 -0
  103. package/extensions/dm-lens/clients/lsp/diagnostic-binding.js +34 -0
  104. package/extensions/dm-lens/clients/lsp/document-drift.js +63 -15
  105. package/extensions/dm-lens/clients/lsp/edits.js +109 -26
  106. package/extensions/dm-lens/clients/lsp/environment-gap.js +186 -0
  107. package/extensions/dm-lens/clients/lsp/file-server-match.js +26 -0
  108. package/extensions/dm-lens/clients/lsp/implicit-scope.js +208 -0
  109. package/extensions/dm-lens/clients/lsp/index.js +574 -916
  110. package/extensions/dm-lens/clients/lsp/inferred-project.js +37 -15
  111. package/extensions/dm-lens/clients/lsp/jvm-runtime.js +15 -9
  112. package/extensions/dm-lens/clients/lsp/language.js +8 -1
  113. package/extensions/dm-lens/clients/lsp/launch.js +93 -43
  114. package/extensions/dm-lens/clients/lsp/lombok.js +0 -13
  115. package/extensions/dm-lens/clients/lsp/path-utils.js +2 -0
  116. package/extensions/dm-lens/clients/lsp/position-encoding.js +0 -7
  117. package/extensions/dm-lens/clients/lsp/server-config-files.js +11 -0
  118. package/extensions/dm-lens/clients/lsp/server-traits.js +8 -2
  119. package/extensions/dm-lens/clients/lsp/server.js +273 -76
  120. package/extensions/dm-lens/clients/lsp/session-roots.js +38 -3
  121. package/extensions/dm-lens/clients/lsp/wait-policy/strategies.js +87 -5
  122. package/extensions/dm-lens/clients/lsp/watch-queue.js +23 -2
  123. package/extensions/dm-lens/clients/lsp/workspace-diagnostics-cache.js +183 -47
  124. package/extensions/dm-lens/clients/lsp/workspace-diagnostics-session.js +35 -0
  125. package/extensions/dm-lens/clients/lsp-mutation.js +1 -1
  126. package/extensions/dm-lens/clients/mcp/analyze.js +51 -13
  127. package/extensions/dm-lens/clients/mcp/ipc.js +24 -1
  128. package/extensions/dm-lens/clients/mcp/session.js +2 -7
  129. package/extensions/dm-lens/clients/memory-sampler.js +19 -1
  130. package/extensions/dm-lens/clients/metrics-history.js +16 -29
  131. package/extensions/dm-lens/clients/mutating-tool.js +4 -2
  132. package/extensions/dm-lens/clients/mutation-attribution.js +1 -4
  133. package/extensions/dm-lens/clients/observed-mutation.js +7 -1
  134. package/extensions/dm-lens/clients/opaque-mutation-scan.js +273 -59
  135. package/extensions/dm-lens/clients/opengrep-client.js +6 -1
  136. package/extensions/dm-lens/clients/opengrep-config.js +10 -5
  137. package/extensions/dm-lens/clients/opengrep-rule-pack.js +19 -0
  138. package/extensions/dm-lens/clients/out-of-band-changes.js +342 -0
  139. package/extensions/dm-lens/clients/package-manager.js +51 -62
  140. package/extensions/dm-lens/clients/package-root.js +8 -12
  141. package/extensions/dm-lens/clients/partial-edit-apply.js +8 -4
  142. package/extensions/dm-lens/clients/path-birth.js +58 -0
  143. package/extensions/dm-lens/clients/path-utils.js +145 -23
  144. package/extensions/dm-lens/clients/persist-worker-stats.js +8 -0
  145. package/extensions/dm-lens/clients/persistent-reverify.js +2 -1
  146. package/extensions/dm-lens/clients/pipeline.js +248 -35
  147. package/extensions/dm-lens/clients/probe-home-state.js +6 -0
  148. package/extensions/dm-lens/clients/project-changes.js +9 -3
  149. package/extensions/dm-lens/clients/project-diagnostics/fresh-fetch.js +1 -1
  150. package/extensions/dm-lens/clients/project-diagnostics/scanner.js +4 -2
  151. package/extensions/dm-lens/clients/project-lens-config.js +4 -6
  152. package/extensions/dm-lens/clients/project-root-markers.js +8 -0
  153. package/extensions/dm-lens/clients/project-snapshot-persist-worker.js +26 -8
  154. package/extensions/dm-lens/clients/project-snapshot.js +36 -10
  155. package/extensions/dm-lens/clients/python-environment.js +239 -12
  156. package/extensions/dm-lens/clients/read-guard-tool-lines.js +2 -8
  157. package/extensions/dm-lens/clients/read-guard.js +130 -43
  158. package/extensions/dm-lens/clients/review-graph/builder.js +102 -19
  159. package/extensions/dm-lens/clients/review-graph/git-identity.js +7 -2
  160. package/extensions/dm-lens/clients/review-graph/import-resolvers.js +9 -0
  161. package/extensions/dm-lens/clients/review-graph/tsconfig-paths.js +35 -2
  162. package/extensions/dm-lens/clients/ruff-client.js +0 -2
  163. package/extensions/dm-lens/clients/rules-scanner.js +0 -43
  164. package/extensions/dm-lens/clients/runtime-agent-end.js +37 -6
  165. package/extensions/dm-lens/clients/runtime-coordinator.js +177 -31
  166. package/extensions/dm-lens/clients/runtime-session.js +106 -66
  167. package/extensions/dm-lens/clients/runtime-tool-call.js +162 -65
  168. package/extensions/dm-lens/clients/runtime-tool-result.js +634 -147
  169. package/extensions/dm-lens/clients/runtime-turn.js +472 -150
  170. package/extensions/dm-lens/clients/rust-client.js +11 -13
  171. package/extensions/dm-lens/clients/safe-spawn.js +149 -17
  172. package/extensions/dm-lens/clients/sanitize.js +0 -169
  173. package/extensions/dm-lens/clients/search-read-registration.js +22 -4
  174. package/extensions/dm-lens/clients/session-lifecycle.js +44 -1
  175. package/extensions/dm-lens/clients/session-repository.js +119 -0
  176. package/extensions/dm-lens/clients/session-scope.js +1 -1
  177. package/extensions/dm-lens/clients/session-start-observability.js +12 -0
  178. package/extensions/dm-lens/clients/session-state-store.js +6 -1
  179. package/extensions/dm-lens/clients/sg-runner.js +5 -8
  180. package/extensions/dm-lens/clients/sgconfig.js +7 -14
  181. package/extensions/dm-lens/clients/single-flight.js +1 -0
  182. package/extensions/dm-lens/clients/source-filter.js +19 -16
  183. package/extensions/dm-lens/clients/source-walker.js +21 -3
  184. package/extensions/dm-lens/clients/startup-scan.js +18 -23
  185. package/extensions/dm-lens/clients/test-runner-client.js +21 -27
  186. package/extensions/dm-lens/clients/test-runner-delivery.js +2 -10
  187. package/extensions/dm-lens/clients/tool-config.js +24 -4
  188. package/extensions/dm-lens/clients/tool-cwd.js +11 -9
  189. package/extensions/dm-lens/clients/tool-policy.js +1 -8
  190. package/extensions/dm-lens/clients/tool-set-policy.js +32 -3
  191. package/extensions/dm-lens/clients/tree-sitter-client.js +70 -24
  192. package/extensions/dm-lens/clients/tree-sitter-query-loader.js +13 -1
  193. package/extensions/dm-lens/clients/tree-sitter-symbol-extractor.js +81 -56
  194. package/extensions/dm-lens/clients/warm-attach.js +33 -8
  195. package/extensions/dm-lens/clients/widget-state.js +48 -31
  196. package/extensions/dm-lens/clients/word-index-logger.js +3 -0
  197. package/extensions/dm-lens/clients/word-index.js +15 -2
  198. package/extensions/dm-lens/clients/workspace-topology.js +10 -8
  199. package/extensions/dm-lens/config/biome/core.jsonc +3 -3
  200. package/extensions/dm-lens/config/dependency-cruiser-eager-allowlist.json +1 -0
  201. package/extensions/dm-lens/dist/clients/actionable-warnings.js +8 -4
  202. package/extensions/dm-lens/dist/clients/advisory-provenance.js +11 -10
  203. package/extensions/dm-lens/dist/clients/agent-nudge.js +1 -1
  204. package/extensions/dm-lens/dist/clients/analysis-root.js +67 -34
  205. package/extensions/dm-lens/dist/clients/bash-file-access.js +550 -123
  206. package/extensions/dm-lens/dist/clients/blocker-freshness.js +195 -19
  207. package/extensions/dm-lens/dist/clients/blocker-past-eof.js +3 -1
  208. package/extensions/dm-lens/dist/clients/bounded-telemetry.js +3 -0
  209. package/extensions/dm-lens/dist/clients/cache-manager.js +22 -1
  210. package/extensions/dm-lens/dist/clients/cache-observability.js +275 -17
  211. package/extensions/dm-lens/dist/clients/cargo-manifest.js +8 -12
  212. package/extensions/dm-lens/dist/clients/cascade-format.js +160 -19
  213. package/extensions/dm-lens/dist/clients/codebase-model.js +2 -2
  214. package/extensions/dm-lens/dist/clients/config-locations.js +2 -8
  215. package/extensions/dm-lens/dist/clients/content-stamp.js +16 -0
  216. package/extensions/dm-lens/dist/clients/context-injection-ledger.js +157 -0
  217. package/extensions/dm-lens/dist/clients/deferred-runner-blockers.js +46 -6
  218. package/extensions/dm-lens/dist/clients/degradation-ledger.js +18 -1
  219. package/extensions/dm-lens/dist/clients/deps/ast-grep-napi.js +10 -0
  220. package/extensions/dm-lens/dist/clients/diagnostic-dispositions.js +28 -12
  221. package/extensions/dm-lens/dist/clients/disk-change-consumers.js +312 -0
  222. package/extensions/dm-lens/dist/clients/disk-change-subscribers.js +191 -0
  223. package/extensions/dm-lens/dist/clients/disk-changes.js +165 -0
  224. package/extensions/dm-lens/dist/clients/dispatch/auxiliary-lsp.js +10 -6
  225. package/extensions/dm-lens/dist/clients/dispatch/dispatcher.js +284 -61
  226. package/extensions/dm-lens/dist/clients/dispatch/fact-store.js +2 -8
  227. package/extensions/dm-lens/dist/clients/dispatch/facts/function-facts.js +87 -94
  228. package/extensions/dm-lens/dist/clients/dispatch/finding-policy.js +25 -1
  229. package/extensions/dm-lens/dist/clients/dispatch/indent-detect.js +1 -1
  230. package/extensions/dm-lens/dist/clients/dispatch/integration.js +333 -137
  231. package/extensions/dm-lens/dist/clients/dispatch/lane-copies.js +23 -0
  232. package/extensions/dm-lens/dist/clients/dispatch/pending-runner-findings.js +3 -0
  233. package/extensions/dm-lens/dist/clients/dispatch/pre-edit-seed.js +57 -0
  234. package/extensions/dm-lens/dist/clients/dispatch/rule-id-normalize.js +6 -1
  235. package/extensions/dm-lens/dist/clients/dispatch/rules/high-complexity.js +2 -17
  236. package/extensions/dm-lens/dist/clients/dispatch/rules/high-fan-out.js +1 -9
  237. package/extensions/dm-lens/dist/clients/dispatch/runner-context.js +5 -10
  238. package/extensions/dm-lens/dist/clients/dispatch/runners/ast-grep-literal-anchors.js +58 -0
  239. package/extensions/dm-lens/dist/clients/dispatch/runners/ast-grep-napi.js +59 -14
  240. package/extensions/dm-lens/dist/clients/dispatch/runners/biome-check.js +9 -18
  241. package/extensions/dm-lens/dist/clients/dispatch/runners/cue-vet.js +11 -21
  242. package/extensions/dm-lens/dist/clients/dispatch/runners/dart-analyze.js +1 -1
  243. package/extensions/dm-lens/dist/clients/dispatch/runners/detekt.js +4 -3
  244. package/extensions/dm-lens/dist/clients/dispatch/runners/dotnet-build.js +12 -6
  245. package/extensions/dm-lens/dist/clients/dispatch/runners/fish-indent.js +59 -5
  246. package/extensions/dm-lens/dist/clients/dispatch/runners/gleam-check.js +9 -19
  247. package/extensions/dm-lens/dist/clients/dispatch/runners/go-vet.js +2 -2
  248. package/extensions/dm-lens/dist/clients/dispatch/runners/golangci-lint.js +17 -1
  249. package/extensions/dm-lens/dist/clients/dispatch/runners/helm-lint.js +8 -5
  250. package/extensions/dm-lens/dist/clients/dispatch/runners/helm-render.js +1 -1
  251. package/extensions/dm-lens/dist/clients/dispatch/runners/ktlint.js +27 -5
  252. package/extensions/dm-lens/dist/clients/dispatch/runners/lsp.js +79 -30
  253. package/extensions/dm-lens/dist/clients/dispatch/runners/oxlint.js +9 -18
  254. package/extensions/dm-lens/dist/clients/dispatch/runners/shellcheck.js +11 -20
  255. package/extensions/dm-lens/dist/clients/dispatch/runners/shfmt.js +7 -0
  256. package/extensions/dm-lens/dist/clients/dispatch/runners/taplo.js +2 -1
  257. package/extensions/dm-lens/dist/clients/dispatch/runners/tree-sitter.js +29 -16
  258. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/availability-policy.js +32 -4
  259. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/candidate-probe.js +5 -0
  260. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/diagnostic-parsers.js +2 -1
  261. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/runner-helpers.js +1 -1
  262. package/extensions/dm-lens/dist/clients/dispatch/runners/utils/tool-failure.js +9 -19
  263. package/extensions/dm-lens/dist/clients/dispatch/runners/vale.js +2 -16
  264. package/extensions/dm-lens/dist/clients/dispatch/types.js +45 -0
  265. package/extensions/dm-lens/dist/clients/dispatch/utils/lsp-diagnostics.js +2 -1
  266. package/extensions/dm-lens/dist/clients/ephemeral-root.js +8 -20
  267. package/extensions/dm-lens/dist/clients/file-kinds.js +6 -2
  268. package/extensions/dm-lens/dist/clients/file-mutation-queue.js +4 -8
  269. package/extensions/dm-lens/dist/clients/file-utils.js +163 -29
  270. package/extensions/dm-lens/dist/clients/finding-delivery-gate.js +15 -1
  271. package/extensions/dm-lens/dist/clients/finding-identity.js +56 -0
  272. package/extensions/dm-lens/dist/clients/fix-run-restore.js +10 -0
  273. package/extensions/dm-lens/dist/clients/format-service.js +23 -5
  274. package/extensions/dm-lens/dist/clients/formatters.js +25 -25
  275. package/extensions/dm-lens/dist/clients/git-guard.js +507 -85
  276. package/extensions/dm-lens/dist/clients/govulncheck-client.js +5 -0
  277. package/extensions/dm-lens/dist/clients/grammar-source.js +39 -5
  278. package/extensions/dm-lens/dist/clients/gzip-stage-write.js +99 -18
  279. package/extensions/dm-lens/dist/clients/inline-blocker-fields.js +1 -1
  280. package/extensions/dm-lens/dist/clients/installer/index.js +76 -83
  281. package/extensions/dm-lens/dist/clients/installer/managed-tool-refresh.js +208 -9
  282. package/extensions/dm-lens/dist/clients/instance-reaper.js +19 -8
  283. package/extensions/dm-lens/dist/clients/instance-registry.js +12 -0
  284. package/extensions/dm-lens/dist/clients/jscpd-client.js +15 -4
  285. package/extensions/dm-lens/dist/clients/language-profile.js +3 -7
  286. package/extensions/dm-lens/dist/clients/language-registry.js +45 -4
  287. package/extensions/dm-lens/dist/clients/latency-logger.js +10 -2
  288. package/extensions/dm-lens/dist/clients/lens-config.js +12 -4
  289. package/extensions/dm-lens/dist/clients/lens-engine.js +10 -3
  290. package/extensions/dm-lens/dist/clients/lens-flag-registry.js +19 -3
  291. package/extensions/dm-lens/dist/clients/line-alignment.js +200 -0
  292. package/extensions/dm-lens/dist/clients/lsp/capabilities.js +2 -2
  293. package/extensions/dm-lens/dist/clients/lsp/cascade-tier.js +148 -38
  294. package/extensions/dm-lens/dist/clients/lsp/client-registry.js +877 -0
  295. package/extensions/dm-lens/dist/clients/lsp/client.js +398 -109
  296. package/extensions/dm-lens/dist/clients/lsp/config.js +147 -47
  297. package/extensions/dm-lens/dist/clients/lsp/content-limits.js +2 -2
  298. package/extensions/dm-lens/dist/clients/lsp/content-scan.js +69 -0
  299. package/extensions/dm-lens/dist/clients/lsp/created-import-targets.js +134 -0
  300. package/extensions/dm-lens/dist/clients/lsp/diagnostic-binding.js +34 -0
  301. package/extensions/dm-lens/dist/clients/lsp/document-drift.js +63 -15
  302. package/extensions/dm-lens/dist/clients/lsp/edits.js +104 -26
  303. package/extensions/dm-lens/dist/clients/lsp/environment-gap.js +186 -0
  304. package/extensions/dm-lens/dist/clients/lsp/file-server-match.js +26 -0
  305. package/extensions/dm-lens/dist/clients/lsp/implicit-scope.js +205 -0
  306. package/extensions/dm-lens/dist/clients/lsp/index.js +547 -894
  307. package/extensions/dm-lens/dist/clients/lsp/inferred-project.js +34 -15
  308. package/extensions/dm-lens/dist/clients/lsp/jvm-runtime.js +15 -9
  309. package/extensions/dm-lens/dist/clients/lsp/language.js +4 -1
  310. package/extensions/dm-lens/dist/clients/lsp/launch.js +85 -43
  311. package/extensions/dm-lens/dist/clients/lsp/lombok.js +0 -13
  312. package/extensions/dm-lens/dist/clients/lsp/path-utils.js +1 -1
  313. package/extensions/dm-lens/dist/clients/lsp/position-encoding.js +0 -7
  314. package/extensions/dm-lens/dist/clients/lsp/server-config-files.js +11 -0
  315. package/extensions/dm-lens/dist/clients/lsp/server-traits.js +8 -2
  316. package/extensions/dm-lens/dist/clients/lsp/server.js +267 -80
  317. package/extensions/dm-lens/dist/clients/lsp/session-roots.js +34 -3
  318. package/extensions/dm-lens/dist/clients/lsp/wait-policy/strategies.js +85 -5
  319. package/extensions/dm-lens/dist/clients/lsp/watch-queue.js +23 -2
  320. package/extensions/dm-lens/dist/clients/lsp/workspace-diagnostics-cache.js +172 -47
  321. package/extensions/dm-lens/dist/clients/lsp/workspace-diagnostics-session.js +35 -0
  322. package/extensions/dm-lens/dist/clients/lsp-mutation.js +1 -1
  323. package/extensions/dm-lens/dist/clients/mcp/analyze.js +51 -14
  324. package/extensions/dm-lens/dist/clients/mcp/ipc.js +24 -1
  325. package/extensions/dm-lens/dist/clients/mcp/session.js +2 -7
  326. package/extensions/dm-lens/dist/clients/memory-sampler.js +19 -1
  327. package/extensions/dm-lens/dist/clients/metrics-history.js +16 -29
  328. package/extensions/dm-lens/dist/clients/mutating-tool.js +4 -2
  329. package/extensions/dm-lens/dist/clients/mutation-attribution.js +1 -4
  330. package/extensions/dm-lens/dist/clients/observed-mutation.js +7 -1
  331. package/extensions/dm-lens/dist/clients/opaque-mutation-scan.js +260 -59
  332. package/extensions/dm-lens/dist/clients/opengrep-client.js +6 -1
  333. package/extensions/dm-lens/dist/clients/opengrep-config.js +10 -5
  334. package/extensions/dm-lens/dist/clients/opengrep-rule-pack.js +19 -0
  335. package/extensions/dm-lens/dist/clients/out-of-band-changes.js +329 -0
  336. package/extensions/dm-lens/dist/clients/package-manager.js +36 -62
  337. package/extensions/dm-lens/dist/clients/package-root.js +8 -12
  338. package/extensions/dm-lens/dist/clients/partial-edit-apply.js +8 -4
  339. package/extensions/dm-lens/dist/clients/path-birth.js +58 -0
  340. package/extensions/dm-lens/dist/clients/path-utils.js +142 -23
  341. package/extensions/dm-lens/dist/clients/persist-worker-stats.js +8 -0
  342. package/extensions/dm-lens/dist/clients/persistent-reverify.js +2 -1
  343. package/extensions/dm-lens/dist/clients/pipeline.js +229 -35
  344. package/extensions/dm-lens/dist/clients/probe-home-state.js +6 -0
  345. package/extensions/dm-lens/dist/clients/project-changes.js +9 -3
  346. package/extensions/dm-lens/dist/clients/project-diagnostics/fresh-fetch.js +1 -1
  347. package/extensions/dm-lens/dist/clients/project-diagnostics/scanner.js +4 -2
  348. package/extensions/dm-lens/dist/clients/project-lens-config.js +4 -6
  349. package/extensions/dm-lens/dist/clients/project-root-markers.js +8 -0
  350. package/extensions/dm-lens/dist/clients/project-snapshot-persist-worker.js +26 -8
  351. package/extensions/dm-lens/dist/clients/project-snapshot.js +33 -11
  352. package/extensions/dm-lens/dist/clients/python-environment.js +239 -13
  353. package/extensions/dm-lens/dist/clients/read-guard-tool-lines.js +2 -8
  354. package/extensions/dm-lens/dist/clients/read-guard.js +127 -39
  355. package/extensions/dm-lens/dist/clients/review-graph/builder.js +94 -22
  356. package/extensions/dm-lens/dist/clients/review-graph/git-identity.js +7 -2
  357. package/extensions/dm-lens/dist/clients/review-graph/import-resolvers.js +9 -0
  358. package/extensions/dm-lens/dist/clients/review-graph/tsconfig-paths.js +35 -2
  359. package/extensions/dm-lens/dist/clients/ruff-client.js +0 -2
  360. package/extensions/dm-lens/dist/clients/rules-scanner.js +0 -43
  361. package/extensions/dm-lens/dist/clients/runtime-agent-end.js +37 -6
  362. package/extensions/dm-lens/dist/clients/runtime-coordinator.js +168 -31
  363. package/extensions/dm-lens/dist/clients/runtime-session.js +103 -65
  364. package/extensions/dm-lens/dist/clients/runtime-tool-call.js +155 -64
  365. package/extensions/dm-lens/dist/clients/runtime-tool-result.js +586 -148
  366. package/extensions/dm-lens/dist/clients/runtime-turn.js +450 -152
  367. package/extensions/dm-lens/dist/clients/rust-client.js +11 -13
  368. package/extensions/dm-lens/dist/clients/safe-spawn.js +144 -17
  369. package/extensions/dm-lens/dist/clients/sanitize.js +0 -169
  370. package/extensions/dm-lens/dist/clients/search-read-registration.js +20 -4
  371. package/extensions/dm-lens/dist/clients/session-lifecycle.js +41 -1
  372. package/extensions/dm-lens/dist/clients/session-repository.js +113 -0
  373. package/extensions/dm-lens/dist/clients/session-scope.js +1 -1
  374. package/extensions/dm-lens/dist/clients/session-start-observability.js +12 -0
  375. package/extensions/dm-lens/dist/clients/session-state-store.js +6 -1
  376. package/extensions/dm-lens/dist/clients/sg-runner.js +5 -8
  377. package/extensions/dm-lens/dist/clients/sgconfig.js +7 -14
  378. package/extensions/dm-lens/dist/clients/single-flight.js +1 -0
  379. package/extensions/dm-lens/dist/clients/source-filter.js +19 -16
  380. package/extensions/dm-lens/dist/clients/source-walker.js +21 -3
  381. package/extensions/dm-lens/dist/clients/startup-scan.js +14 -23
  382. package/extensions/dm-lens/dist/clients/test-runner-client.js +17 -28
  383. package/extensions/dm-lens/dist/clients/test-runner-delivery.js +2 -10
  384. package/extensions/dm-lens/dist/clients/tool-config.js +24 -4
  385. package/extensions/dm-lens/dist/clients/tool-cwd.js +10 -9
  386. package/extensions/dm-lens/dist/clients/tool-policy.js +1 -8
  387. package/extensions/dm-lens/dist/clients/tool-set-policy.js +32 -3
  388. package/extensions/dm-lens/dist/clients/tree-sitter-client.js +69 -25
  389. package/extensions/dm-lens/dist/clients/tree-sitter-query-loader.js +13 -1
  390. package/extensions/dm-lens/dist/clients/tree-sitter-symbol-extractor.js +81 -56
  391. package/extensions/dm-lens/dist/clients/warm-attach.js +31 -9
  392. package/extensions/dm-lens/dist/clients/widget-state.js +48 -31
  393. package/extensions/dm-lens/dist/clients/word-index-logger.js +3 -0
  394. package/extensions/dm-lens/dist/clients/word-index.js +11 -2
  395. package/extensions/dm-lens/dist/clients/workspace-topology.js +10 -4
  396. package/extensions/dm-lens/dist/index.js +315 -144
  397. package/extensions/dm-lens/dist/mcp/analyze-cli.js +1 -1
  398. package/extensions/dm-lens/dist/mcp/cli.js +1 -1
  399. package/extensions/dm-lens/dist/mcp/server.js +16 -14
  400. package/extensions/dm-lens/dist/mcp/worker.js +1 -1
  401. package/extensions/dm-lens/dist/scripts/lib/process-scan.mjs +1 -1
  402. package/extensions/dm-lens/dist/tools/activate-tools.js +3 -2
  403. package/extensions/dm-lens/dist/tools/ast-grep-outline.js +6 -4
  404. package/extensions/dm-lens/dist/tools/ast-grep-replace.js +17 -10
  405. package/extensions/dm-lens/dist/tools/ast-grep-search.js +22 -19
  406. package/extensions/dm-lens/dist/tools/lens-diagnostic-mark.js +3 -3
  407. package/extensions/dm-lens/dist/tools/lens-diagnostics.js +245 -70
  408. package/extensions/dm-lens/dist/tools/lsp-diagnostics.js +276 -77
  409. package/extensions/dm-lens/dist/tools/lsp-navigation.js +152 -100
  410. package/extensions/dm-lens/dist/tools/module-report.js +2 -1
  411. package/extensions/dm-lens/dist/tools/shared.js +16 -2
  412. package/extensions/dm-lens/index.js +336 -141
  413. package/extensions/dm-lens/mcp/analyze-cli.js +1 -1
  414. package/extensions/dm-lens/mcp/cli.js +1 -1
  415. package/extensions/dm-lens/mcp/server.js +16 -13
  416. package/extensions/dm-lens/mcp/worker.js +1 -1
  417. package/extensions/dm-lens/package.json +1 -1
  418. package/extensions/dm-lens/rules/ast-grep-rules/rule-tests/no-return-value-in-generator-test.yml +17 -0
  419. package/extensions/dm-lens/rules/ast-grep-rules/rule-tests/no-sql-in-code-execute-js-test.yml +86 -0
  420. package/extensions/dm-lens/rules/ast-grep-rules/rule-tests/no-sql-in-code-execute-test.yml +86 -0
  421. package/extensions/dm-lens/rules/ast-grep-rules/rule-tests/unchecked-numeric-parse-python-test.yml +15 -0
  422. package/extensions/dm-lens/rules/ast-grep-rules/rules/no-return-value-in-generator.yml +9 -4
  423. package/extensions/dm-lens/rules/ast-grep-rules/rules/no-sql-in-code-execute-js.yml +119 -0
  424. package/extensions/dm-lens/rules/ast-grep-rules/rules/no-sql-in-code-execute.yml +119 -0
  425. package/extensions/dm-lens/rules/ast-grep-rules/rules/unchecked-numeric-parse-python.yml +13 -2
  426. package/extensions/dm-lens/rules/rule-catalog.json +25 -1
  427. package/extensions/dm-lens/scripts/lib/process-scan.mjs +1 -1
  428. package/extensions/dm-lens/skills/{pi-lens-ast-grep → dm-lens-ast-grep}/SKILL.md +1 -1
  429. package/extensions/dm-lens/tools/activate-tools.js +3 -2
  430. package/extensions/dm-lens/tools/ast-grep-outline.js +6 -4
  431. package/extensions/dm-lens/tools/ast-grep-replace.js +17 -10
  432. package/extensions/dm-lens/tools/ast-grep-search.js +27 -19
  433. package/extensions/dm-lens/tools/lens-diagnostic-mark.js +3 -3
  434. package/extensions/dm-lens/tools/lens-diagnostics.js +260 -68
  435. package/extensions/dm-lens/tools/lsp-diagnostics.js +303 -76
  436. package/extensions/dm-lens/tools/lsp-navigation.js +168 -102
  437. package/extensions/dm-lens/tools/module-report.js +2 -1
  438. package/extensions/dm-lens/tools/shared.js +16 -2
  439. package/extensions/dm-mcp-adapter/.github/workflows/ci.yml +82 -0
  440. package/extensions/dm-mcp-adapter/THIRD_PARTY_NOTICES.md +1 -1
  441. package/extensions/dm-mcp-adapter/VISION.md +94 -0
  442. package/extensions/dm-mcp-adapter/agent-dir.js +2 -2
  443. package/extensions/dm-mcp-adapter/bearer-command-resolver.js +5 -3
  444. package/extensions/dm-mcp-adapter/bench/server-memory.mjs +432 -0
  445. package/extensions/dm-mcp-adapter/bench/session.js +105 -0
  446. package/extensions/dm-mcp-adapter/bench/token-cost/data.mjs +231 -0
  447. package/extensions/dm-mcp-adapter/bench/token-cost/run.mjs +190 -0
  448. package/extensions/dm-mcp-adapter/bench/token-cost/server.mjs +109 -0
  449. package/extensions/dm-mcp-adapter/cli.js +55 -100
  450. package/extensions/dm-mcp-adapter/codemode-bridge.js +92 -0
  451. package/extensions/dm-mcp-adapter/commands.js +143 -26
  452. package/extensions/dm-mcp-adapter/config.js +303 -78
  453. package/extensions/dm-mcp-adapter/conformance/baseline-client.yml +22 -0
  454. package/extensions/dm-mcp-adapter/conformance/driver.js +200 -0
  455. package/extensions/dm-mcp-adapter/conformance/driver.sh +24 -0
  456. package/extensions/dm-mcp-adapter/conformance/run.sh +130 -0
  457. package/extensions/dm-mcp-adapter/deferred-tool-surface.js +69 -0
  458. package/extensions/dm-mcp-adapter/direct-tool-surface.js +96 -72
  459. package/extensions/dm-mcp-adapter/direct-tools.js +76 -53
  460. package/extensions/dm-mcp-adapter/dist/agent-dir.js +2 -2
  461. package/extensions/dm-mcp-adapter/dist/bearer-command-resolver.js +5 -3
  462. package/extensions/dm-mcp-adapter/dist/config.js +304 -55
  463. package/extensions/dm-mcp-adapter/dist/elicitation-handler.js +4 -0
  464. package/extensions/dm-mcp-adapter/dist/extraction-settings.js +43 -0
  465. package/extensions/dm-mcp-adapter/dist/mcp-probe.js +1 -1
  466. package/extensions/dm-mcp-adapter/dist/mcp-tasks.js +46 -7
  467. package/extensions/dm-mcp-adapter/dist/metadata-cache.js +93 -5
  468. package/extensions/dm-mcp-adapter/dist/output-shape.js +1 -1
  469. package/extensions/dm-mcp-adapter/dist/project-server-trust.js +108 -20
  470. package/extensions/dm-mcp-adapter/dist/request-headers-command.js +17 -1
  471. package/extensions/dm-mcp-adapter/dist/runtime-owner.js +7 -6
  472. package/extensions/dm-mcp-adapter/dist/sampling-handler.js +8 -2
  473. package/extensions/dm-mcp-adapter/dist/script-tools.js +72 -0
  474. package/extensions/dm-mcp-adapter/dist/semantic-settings.js +51 -0
  475. package/extensions/dm-mcp-adapter/dist/server-log.js +19 -0
  476. package/extensions/dm-mcp-adapter/dist/server-manager.js +62 -21
  477. package/extensions/dm-mcp-adapter/dist/task-entries.js +60 -0
  478. package/extensions/dm-mcp-adapter/dist/task-jobs.js +259 -0
  479. package/extensions/dm-mcp-adapter/dist/types.js +7 -0
  480. package/extensions/dm-mcp-adapter/dist/utils.js +33 -7
  481. package/extensions/dm-mcp-adapter/dm-host-tool-context.js +0 -0
  482. package/extensions/dm-mcp-adapter/elicitation-handler.js +4 -0
  483. package/extensions/dm-mcp-adapter/error-signal.js +12 -1
  484. package/extensions/dm-mcp-adapter/executor-accounts.js +192 -0
  485. package/extensions/dm-mcp-adapter/executor-app-tools.js +61 -0
  486. package/extensions/dm-mcp-adapter/executor-catalog.js +157 -0
  487. package/extensions/dm-mcp-adapter/executor-pauses.js +105 -0
  488. package/extensions/dm-mcp-adapter/extraction-settings.js +43 -0
  489. package/extensions/dm-mcp-adapter/extraction.js +396 -0
  490. package/extensions/dm-mcp-adapter/host-html-template.js +1 -1
  491. package/extensions/dm-mcp-adapter/host-managed.js +24 -5
  492. package/extensions/dm-mcp-adapter/index.js +761 -76
  493. package/extensions/dm-mcp-adapter/init.js +235 -11
  494. package/extensions/dm-mcp-adapter/jev-semantic-search.js +161 -0
  495. package/extensions/dm-mcp-adapter/mcp-code.js +12 -11
  496. package/extensions/dm-mcp-adapter/mcp-keyring-helper.cjs +1 -1
  497. package/extensions/dm-mcp-adapter/mcp-output-guard.js +7 -0
  498. package/extensions/dm-mcp-adapter/mcp-panel.js +23 -21
  499. package/extensions/dm-mcp-adapter/mcp-probe.js +1 -1
  500. package/extensions/dm-mcp-adapter/mcp-status.js +2 -1
  501. package/extensions/dm-mcp-adapter/mcp-tasks.js +46 -7
  502. package/extensions/dm-mcp-adapter/metadata-cache.js +93 -5
  503. package/extensions/dm-mcp-adapter/namespace-tools.js +12 -4
  504. package/extensions/dm-mcp-adapter/output-shape.js +1 -1
  505. package/extensions/dm-mcp-adapter/package.json +1 -1
  506. package/extensions/dm-mcp-adapter/pi-mcp.mp4 +0 -0
  507. package/extensions/dm-mcp-adapter/pi-signin-import.js +1 -1
  508. package/extensions/dm-mcp-adapter/project-server-trust.js +108 -20
  509. package/extensions/dm-mcp-adapter/proxy-modes.js +320 -110
  510. package/extensions/dm-mcp-adapter/request-headers-command.js +17 -1
  511. package/extensions/dm-mcp-adapter/runtime-owner.js +7 -6
  512. package/extensions/dm-mcp-adapter/sampling-handler.js +8 -2
  513. package/extensions/dm-mcp-adapter/script-tool-save.js +251 -0
  514. package/extensions/dm-mcp-adapter/script-tool-surface.js +100 -0
  515. package/extensions/dm-mcp-adapter/script-tools.js +72 -0
  516. package/extensions/dm-mcp-adapter/semantic-search.js +176 -50
  517. package/extensions/dm-mcp-adapter/semantic-settings.js +51 -0
  518. package/extensions/dm-mcp-adapter/server-log.js +19 -0
  519. package/extensions/dm-mcp-adapter/server-manager.js +64 -21
  520. package/extensions/dm-mcp-adapter/task-entries.js +60 -0
  521. package/extensions/dm-mcp-adapter/task-jobs.js +263 -0
  522. package/extensions/dm-mcp-adapter/tool-approval.js +49 -2
  523. package/extensions/dm-mcp-adapter/tool-metadata.js +70 -3
  524. package/extensions/dm-mcp-adapter/tool-registrar.js +8 -1
  525. package/extensions/dm-mcp-adapter/tool-result-renderer.js +10 -6
  526. package/extensions/dm-mcp-adapter/types.js +7 -0
  527. package/extensions/dm-mcp-adapter/ui-server.js +24 -18
  528. package/extensions/dm-mcp-adapter/ui-session.js +3 -3
  529. package/extensions/dm-mcp-adapter/upgrade-notice.js +42 -0
  530. package/extensions/dm-mcp-adapter/utils.js +33 -7
  531. package/extensions/dm-ponytail/extensions/ponytail.mjs +11 -3
  532. package/extensions/dm-ponytail/hooks/band/board.js +524 -0
  533. package/extensions/dm-ponytail/hooks/band/logo.js +2 -0
  534. package/extensions/dm-ponytail/hooks/band/metrics.js +238 -0
  535. package/extensions/dm-ponytail/hooks/band/register.js +532 -0
  536. package/extensions/dm-ponytail/hooks/claude-band.json +6 -0
  537. package/extensions/dm-ponytail/hooks/claude-codex-hooks.json +6 -6
  538. package/extensions/dm-ponytail/hooks/copilot-hooks.json +6 -6
  539. package/extensions/dm-ponytail/hooks/cursor-hooks.json +2 -2
  540. package/extensions/dm-ponytail/hooks/ponytail-activate.js +105 -70
  541. package/extensions/dm-ponytail/hooks/ponytail-band-import.js +308 -0
  542. package/extensions/dm-ponytail/hooks/ponytail-config.js +4 -0
  543. package/extensions/dm-ponytail/hooks/ponytail-instructions.js +1 -1
  544. package/extensions/dm-ponytail/hooks/ponytail-map.js +7 -3
  545. package/extensions/dm-ponytail/hooks/ponytail-mode-tracker.js +41 -4
  546. package/extensions/dm-ponytail/hooks/ponytail-runtime.js +11 -8
  547. package/extensions/dm-ponytail/pi-extension/index.js +11 -3
  548. package/extensions/dm-ponytail/skills/ponytail/SKILL.md +1 -1
  549. package/extensions/dm-ponytail/skills/ponytail-debt/SKILL.md +4 -5
  550. package/extensions/dm-ponytail/skills/ponytail-gain/SKILL.md +0 -1
  551. package/extensions/dm-ponytail/skills/ponytail-help/SKILL.md +6 -0
  552. package/extensions/dm-skills-manager/package.json +1 -1
  553. package/extensions/dm-subagents/VISION.md +98 -0
  554. package/extensions/dm-subagents/agents/evidence-auditor.md +1 -0
  555. package/extensions/dm-subagents/agents/oracle.md +1 -0
  556. package/extensions/dm-subagents/agents/reviewer.md +1 -0
  557. package/extensions/dm-subagents/package.json +2 -1
  558. package/extensions/dm-subagents/scripts/build-package.mjs +128 -0
  559. package/extensions/dm-subagents/skills/council-mode/SKILL.md +1 -4
  560. package/extensions/dm-subagents/skills/dm-subagents/SKILL.md +130 -106
  561. package/extensions/dm-subagents/skills/dm-subagents/references/execution-controls.md +4 -3
  562. package/extensions/dm-subagents/skills/dm-subagents/references/orchestration.md +124 -0
  563. package/extensions/dm-subagents/skills/dm-subagents/references/prompting-and-roles.md +96 -295
  564. package/extensions/dm-subagents/src/agents/agent-management.js +14 -19
  565. package/extensions/dm-subagents/src/agents/agent-memory.js +2 -1
  566. package/extensions/dm-subagents/src/agents/agent-serializer.js +1 -2
  567. package/extensions/dm-subagents/src/agents/agents.js +7 -8
  568. package/extensions/dm-subagents/src/agents/frontmatter.js +34 -16
  569. package/extensions/dm-subagents/src/agents/skills.js +1 -1
  570. package/extensions/dm-subagents/src/api/background-work.js +8 -5
  571. package/extensions/dm-subagents/src/api/external-runs.js +3 -4
  572. package/extensions/dm-subagents/src/extension/active-runs-prompt.js +20 -0
  573. package/extensions/dm-subagents/src/extension/config.js +12 -0
  574. package/extensions/dm-subagents/src/extension/declaration-pinning.js +20 -3
  575. package/extensions/dm-subagents/src/extension/herdr-dm-bridge.js +24 -12
  576. package/extensions/dm-subagents/src/extension/index.js +125 -20
  577. package/extensions/dm-subagents/src/extension/public-execution.js +3 -0
  578. package/extensions/dm-subagents/src/extension/reply-workflow-script.js +3 -2
  579. package/extensions/dm-subagents/src/extension/rpc.js +5 -3
  580. package/extensions/dm-subagents/src/extension/schemas.js +6 -5
  581. package/extensions/dm-subagents/src/extension/subagent-guide.js +1 -2
  582. package/extensions/dm-subagents/src/extension/tool-activation.js +60 -26
  583. package/extensions/dm-subagents/src/extension/tool-description.js +2 -2
  584. package/extensions/dm-subagents/src/extension/upgrade-notice.js +5 -1
  585. package/extensions/dm-subagents/src/intercom/native-supervisor-channel.js +143 -15
  586. package/extensions/dm-subagents/src/missions/actions.js +4 -1
  587. package/extensions/dm-subagents/src/missions/lifecycle.js +32 -8
  588. package/extensions/dm-subagents/src/missions/store.js +1 -0
  589. package/extensions/dm-subagents/src/runs/background/active-async-capacity.js +15 -9
  590. package/extensions/dm-subagents/src/runs/background/async-execution.js +30 -16
  591. package/extensions/dm-subagents/src/runs/background/async-job-tracker.js +12 -3
  592. package/extensions/dm-subagents/src/runs/background/async-resume.js +5 -3
  593. package/extensions/dm-subagents/src/runs/background/async-status-snapshot.js +4 -2
  594. package/extensions/dm-subagents/src/runs/background/async-status.js +32 -10
  595. package/extensions/dm-subagents/src/runs/background/auto-drain.js +2 -1
  596. package/extensions/dm-subagents/src/runs/background/await-async-run.js +2 -7
  597. package/extensions/dm-subagents/src/runs/background/boot-id.js +36 -0
  598. package/extensions/dm-subagents/src/runs/background/chain-root-attachment.js +4 -4
  599. package/extensions/dm-subagents/src/runs/background/index-segment.js +1 -1
  600. package/extensions/dm-subagents/src/runs/background/inspect-rpc.js +17 -3
  601. package/extensions/dm-subagents/src/runs/background/interrupted-elsewhere.js +55 -0
  602. package/extensions/dm-subagents/src/runs/background/notify.js +98 -10
  603. package/extensions/dm-subagents/src/runs/background/result-delivery-ownership.js +20 -22
  604. package/extensions/dm-subagents/src/runs/background/result-files.js +9 -6
  605. package/extensions/dm-subagents/src/runs/background/result-watcher.js +32 -17
  606. package/extensions/dm-subagents/src/runs/background/resume-guidance.js +2 -1
  607. package/extensions/dm-subagents/src/runs/background/retained-children.js +1 -1
  608. package/extensions/dm-subagents/src/runs/background/run-child-session.js +40 -21
  609. package/extensions/dm-subagents/src/runs/background/run-status.js +12 -5
  610. package/extensions/dm-subagents/src/runs/background/runner-aliases.js +7 -5
  611. package/extensions/dm-subagents/src/runs/background/runner-child-launch.js +1 -2
  612. package/extensions/dm-subagents/src/runs/background/stale-run-reconciler.js +89 -21
  613. package/extensions/dm-subagents/src/runs/background/subagent-runner-bootstrap.js +2 -0
  614. package/extensions/dm-subagents/src/runs/background/subagent-runner.js +190 -244
  615. package/extensions/dm-subagents/src/runs/background/subagent-wait.js +5 -2
  616. package/extensions/dm-subagents/src/runs/background/terminal-run-index.js +39 -4
  617. package/extensions/dm-subagents/src/runs/background/wait-subscriptions.js +5 -1
  618. package/extensions/dm-subagents/src/runs/background/workflow-terminal-proof.js +28 -2
  619. package/extensions/dm-subagents/src/runs/foreground/async-dismiss-action.js +2 -1
  620. package/extensions/dm-subagents/src/runs/foreground/async-steering-action.js +21 -7
  621. package/extensions/dm-subagents/src/runs/foreground/async-stop-action.js +10 -8
  622. package/extensions/dm-subagents/src/runs/foreground/command-action.js +2 -1
  623. package/extensions/dm-subagents/src/runs/foreground/execution.js +107 -66
  624. package/extensions/dm-subagents/src/runs/foreground/foreground-history.js +111 -32
  625. package/extensions/dm-subagents/src/runs/foreground/prompt-audit.js +2 -2
  626. package/extensions/dm-subagents/src/runs/foreground/subagent-executor.js +377 -126
  627. package/extensions/dm-subagents/src/runs/shared/async-status-projection.js +18 -1
  628. package/extensions/dm-subagents/src/runs/shared/child-commands.js +7 -1
  629. package/extensions/dm-subagents/src/runs/shared/child-runtime-config.js +1 -0
  630. package/extensions/dm-subagents/src/runs/shared/child-session.js +184 -65
  631. package/extensions/dm-subagents/src/runs/shared/child-tool-plan.js +14 -3
  632. package/extensions/dm-subagents/src/runs/shared/dm-spawn.js +71 -25
  633. package/extensions/dm-subagents/src/runs/shared/external-cli-runner.js +2 -1
  634. package/extensions/dm-subagents/src/runs/shared/herdr-connection.js +20 -10
  635. package/extensions/dm-subagents/src/runs/shared/herdr-external-adapters.js +1 -1
  636. package/extensions/dm-subagents/src/runs/shared/herdr-machine.js +50 -8
  637. package/extensions/dm-subagents/src/runs/shared/herdr-pane-host.js +212 -0
  638. package/extensions/dm-subagents/src/runs/shared/herdr-placed-run.js +47 -503
  639. package/extensions/dm-subagents/src/runs/shared/local-machine-access.js +29 -0
  640. package/extensions/dm-subagents/src/runs/shared/long-running-guard.js +70 -17
  641. package/extensions/dm-subagents/src/runs/shared/model-resolution.js +7 -1
  642. package/extensions/dm-subagents/src/runs/shared/nested-events.js +2 -0
  643. package/extensions/dm-subagents/src/runs/shared/orca-progress-tabs.js +2 -24
  644. package/extensions/dm-subagents/src/runs/shared/parallel-handoff.js +9 -6
  645. package/extensions/dm-subagents/src/runs/shared/partial-output.js +5 -0
  646. package/extensions/dm-subagents/src/runs/shared/placed-run-owner.js +157 -0
  647. package/extensions/dm-subagents/src/runs/shared/placement-host.js +166 -0
  648. package/extensions/dm-subagents/src/runs/shared/rex-machine.js +75 -0
  649. package/extensions/dm-subagents/src/runs/shared/rex-pane-host.js +306 -0
  650. package/extensions/dm-subagents/src/runs/shared/run-ownership.js +7 -0
  651. package/extensions/dm-subagents/src/runs/shared/single-output.js +29 -6
  652. package/extensions/dm-subagents/src/runs/shared/structured-output.js +1 -0
  653. package/extensions/dm-subagents/src/runs/shared/subagent-control.js +2 -1
  654. package/extensions/dm-subagents/src/runs/shared/subagent-prompt-runtime.js +177 -17
  655. package/extensions/dm-subagents/src/runs/shared/tool-budget.js +1 -1
  656. package/extensions/dm-subagents/src/shared/accessible-dir.js +1 -1
  657. package/extensions/dm-subagents/src/shared/child-transcript.js +1 -1
  658. package/extensions/dm-subagents/src/shared/completion-owner.js +1 -0
  659. package/extensions/dm-subagents/src/shared/dm-declarations.js +36 -1
  660. package/extensions/dm-subagents/src/shared/dm-safeguards.js +1 -1
  661. package/extensions/dm-subagents/src/shared/dm-settlement.js +2 -0
  662. package/extensions/dm-subagents/src/shared/extension-context.js +3 -0
  663. package/extensions/dm-subagents/src/shared/file-lease.js +4 -1
  664. package/extensions/dm-subagents/src/shared/fork-context.js +21 -8
  665. package/extensions/dm-subagents/src/shared/parent-wake.js +6 -11
  666. package/extensions/dm-subagents/src/shared/provider-diagnostics.js +59 -0
  667. package/extensions/dm-subagents/src/shared/session-identity.js +24 -0
  668. package/extensions/dm-subagents/src/shared/session-succession.js +18 -0
  669. package/extensions/dm-subagents/src/shared/types.js +5 -4
  670. package/extensions/dm-subagents/src/shared/utils.js +13 -0
  671. package/extensions/dm-subagents/src/slash/delegation-adapters.js +8 -1
  672. package/extensions/dm-subagents/src/slash/prompt-template-bridge.js +2 -1
  673. package/extensions/dm-subagents/src/slash/slash-commands.js +6 -4
  674. package/extensions/dm-subagents/src/slash/subagents-admin.js +3 -2
  675. package/extensions/dm-subagents/src/tui/dm-mouse-region.js +9 -1
  676. package/extensions/dm-subagents/src/tui/fleet-layout.js +19 -0
  677. package/extensions/dm-subagents/src/tui/fleet-status.js +20 -3
  678. package/extensions/dm-subagents/src/tui/fleet-viewport.js +59 -0
  679. package/extensions/dm-subagents/src/tui/fleet.js +92 -69
  680. package/extensions/dm-subagents/src/tui/render.js +45 -19
  681. package/extensions/dm-subagents/src/tui/subagent-messages.js +1 -0
  682. package/extensions/dm-subagents/src/watchdog/change-signature.js +1 -3
  683. package/extensions/dm-subagents/src/watchdog/diff-tool.js +7 -3
  684. package/extensions/dm-subagents/src/watchdog/permission-arbiter.js +15 -6
  685. package/extensions/dm-subagents/src/watchdog/register-main.js +10 -9
  686. package/extensions/dm-subagents/src/watchdog/review.js +9 -1
  687. package/extensions/dm-subagents/src/watchdog/runtime.js +3 -5
  688. package/extensions/dm-subagents/src/workflows/scripted-workflow.js +33 -6
  689. package/extensions/dm-subagents/src/workflows/structured-workflow-scripts.js +21 -8
  690. package/extensions/dm-subagents/src/workflows/workflow-auto-resume.js +81 -0
  691. package/extensions/dm-subagents/src/workflows/workflow-child-summary.js +18 -2
  692. package/extensions/dm-subagents/src/workflows/workflow-launch-record.js +45 -0
  693. package/extensions/dm-subagents/src/workflows/workflow-resources.js +2 -2
  694. package/extensions/dm-subagents/src/workflows/workflow-resume-claim.js +171 -0
  695. package/extensions/dm-subagents/src/workflows/workflow-resume.js +88 -0
  696. package/extensions/dm-subagents/src/workflows/workflow-reuse.js +72 -3
  697. package/extensions/dm-subagents/src/workflows/workflow-revival.js +1 -1
  698. package/extensions/dm-subagents/src/workflows/workflow-stop-cause.js +5 -0
  699. package/extensions/dm-web-access/.github/workflows/test.yml +28 -0
  700. package/extensions/dm-web-access/anysearch.js +3 -3
  701. package/extensions/dm-web-access/bocha.js +3 -3
  702. package/extensions/dm-web-access/brave-rate-limit.js +2 -2
  703. package/extensions/dm-web-access/brave.js +5 -10
  704. package/extensions/dm-web-access/brightdata-unlocker.js +2 -2
  705. package/extensions/dm-web-access/brightdata.js +3 -3
  706. package/extensions/dm-web-access/ceramic.js +2 -2
  707. package/extensions/dm-web-access/chrome-cookies.js +1 -1
  708. package/extensions/dm-web-access/claim-judge.js +147 -0
  709. package/extensions/dm-web-access/content-find.js +1 -1
  710. package/extensions/dm-web-access/credential-source.js +42 -5
  711. package/extensions/dm-web-access/curator-page.js +8 -2
  712. package/extensions/dm-web-access/curator-server.js +6 -0
  713. package/extensions/dm-web-access/deepseek.js +331 -0
  714. package/extensions/dm-web-access/duckduckgo-rate-limit.js +75 -0
  715. package/extensions/dm-web-access/duckduckgo.js +49 -43
  716. package/extensions/dm-web-access/endpoint-pdf-extract.js +30 -77
  717. package/extensions/dm-web-access/eval/claim-judge.mjs +96 -0
  718. package/extensions/dm-web-access/eval/field-extract.mjs +84 -0
  719. package/extensions/dm-web-access/eval/fixtures/claims-calibration.json +1026 -0
  720. package/extensions/dm-web-access/eval/fixtures/claims-holdout.json +896 -0
  721. package/extensions/dm-web-access/eval/fixtures/claims-sibling-holdout.json +226 -0
  722. package/extensions/dm-web-access/eval/fixtures/extract-calibration.json +12 -0
  723. package/extensions/dm-web-access/eval/fixtures/extract-holdout.json +172 -0
  724. package/extensions/dm-web-access/eval/fixtures/offtopic-calibration.json +103 -0
  725. package/extensions/dm-web-access/eval/fixtures/offtopic-holdout.json +307 -0
  726. package/extensions/dm-web-access/eval/offtopic-judge.mjs +66 -0
  727. package/extensions/dm-web-access/evidence/CONTRACT-EVIDENCE.md +496 -0
  728. package/extensions/dm-web-access/evidence/contract-probe.mjs +127 -0
  729. package/extensions/dm-web-access/exa.js +42 -4
  730. package/extensions/dm-web-access/extract.js +110 -19
  731. package/extensions/dm-web-access/fetch-params.js +12 -3
  732. package/extensions/dm-web-access/field-extract.js +324 -0
  733. package/extensions/dm-web-access/gemini-adc.js +47 -1
  734. package/extensions/dm-web-access/gemini-api.js +11 -0
  735. package/extensions/dm-web-access/gemini-search.js +204 -196
  736. package/extensions/dm-web-access/github-extract.js +1 -1
  737. package/extensions/dm-web-access/github-issue-pr.js +6 -6
  738. package/extensions/dm-web-access/index.js +159 -112
  739. package/extensions/dm-web-access/jina-search.js +6 -4
  740. package/extensions/dm-web-access/kagi.js +4 -4
  741. package/extensions/dm-web-access/keenable.js +2 -2
  742. package/extensions/dm-web-access/linkup.js +160 -0
  743. package/extensions/dm-web-access/mistral-search.js +4 -4
  744. package/extensions/dm-web-access/ninerouter.js +100 -0
  745. package/extensions/dm-web-access/offtopic-judge.js +56 -0
  746. package/extensions/dm-web-access/ollama.js +4 -4
  747. package/extensions/dm-web-access/openai-search.js +32 -12
  748. package/extensions/dm-web-access/package.json +1 -1
  749. package/extensions/dm-web-access/page-query.js +7 -4
  750. package/extensions/dm-web-access/parallel.js +6 -7
  751. package/extensions/dm-web-access/pdf-extract.js +1 -3
  752. package/extensions/dm-web-access/perplexity.js +6 -5
  753. package/extensions/dm-web-access/querit.js +3 -3
  754. package/extensions/dm-web-access/query-rewrite.js +32 -8
  755. package/extensions/dm-web-access/scripts/dm-extensions-dist.js +16 -0
  756. package/extensions/dm-web-access/scripts/publish.js +38 -0
  757. package/extensions/dm-web-access/search1api.js +3 -3
  758. package/extensions/dm-web-access/searchinfinity.js +3 -3
  759. package/extensions/dm-web-access/searxng.js +2 -1
  760. package/extensions/dm-web-access/serpapi.js +6 -5
  761. package/extensions/dm-web-access/serpbase.js +4 -4
  762. package/extensions/dm-web-access/serpdive.js +3 -3
  763. package/extensions/dm-web-access/serper.js +5 -4
  764. package/extensions/dm-web-access/serply.js +2 -2
  765. package/extensions/dm-web-access/source-check.js +22 -14
  766. package/extensions/dm-web-access/ssrf-protection.js +29 -4
  767. package/extensions/dm-web-access/summary-model-scope.js +11 -1
  768. package/extensions/dm-web-access/summary-review.js +36 -43
  769. package/extensions/dm-web-access/tool-activation.js +11 -2
  770. package/extensions/dm-web-access/upgrade-notice.js +41 -0
  771. package/extensions/dm-web-access/utils.js +51 -3
  772. package/extensions/dm-web-access/valyu.js +3 -3
  773. package/extensions/dm-web-access/video-extract.js +3 -2
  774. package/extensions/dm-web-access/web-tool-core.js +161 -51
  775. package/extensions/dm-web-access/xai-search.js +44 -9
  776. package/extensions/dm-web-access/xcrawl.js +3 -3
  777. package/extensions/dm-web-access/you.js +2 -2
  778. package/package.json +4 -4
  779. package/extensions/dm-web-access/dist/index.js +0 -28396
  780. package/extensions/dm-web-access/dist/mcp-cli.js +0 -28185
  781. /package/extensions/dm-lens/skills/{pi-lens-lsp-navigation → dm-lens-lsp-navigation}/SKILL.md +0 -0
  782. /package/extensions/dm-lens/skills/{pi-lens-write-ast-grep-rule → dm-lens-write-ast-grep-rule}/SKILL.md +0 -0
  783. /package/extensions/dm-lens/skills/{pi-lens-write-ast-grep-rule → dm-lens-write-ast-grep-rule}/reference.md +0 -0
  784. /package/extensions/dm-lens/skills/{pi-lens-write-tree-sitter-rule → dm-lens-write-tree-sitter-rule}/SKILL.md +0 -0
@@ -0,0 +1,496 @@
1
+ # SERPdive API — contract evidence
2
+
3
+ Every block below is a real call against `https://api.serpdive.com/v1/search`, captured on 2026-07-25. Reproduce any of them with your own key: the script that
4
+ generated this file is `evidence/contract-probe.mjs`. Page content is truncated to keep the file
5
+ readable — nothing else is edited, and the API key is redacted.
6
+
7
+ ---
8
+
9
+ ## 1. Default request and response shape
10
+
11
+ ### Query only
12
+
13
+ The whole request surface is `query`, `model`, `answer`, `max_results`. Everything else is ignored.
14
+
15
+ ```http
16
+ POST https://api.serpdive.com/v1/search
17
+ authorization: Bearer sd_live_… # a valid key, redacted
18
+ content-type: application/json
19
+
20
+ {"query":"best open source vector databases"}
21
+ ```
22
+
23
+ `HTTP 200` in 2059 ms
24
+
25
+ ```json
26
+ {
27
+ "query": "best open source vector databases",
28
+ "model": "mako",
29
+ "response_time_ms": 1906,
30
+ "results": [
31
+ {
32
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
33
+ "title": "Best open source vector database solutions: Top 5 in 2026",
34
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (431 chars)"
35
+ },
36
+ {
37
+ "url": "https://redis.io/blog/best-open-source-vector-databases-comparison/",
38
+ "title": "Comparing the best open source vector databases (2026)",
39
+ "content": "Chroma prioritizes simplicity and developer experience, particularly for Python workflows.… (90 chars)"
40
+ },
41
+ "… 5 more, same shape"
42
+ ]
43
+ }
44
+ ```
45
+
46
+ ## 2. Models
47
+
48
+ ### krill — free tier
49
+
50
+ No answer synthesis on this tier: requesting one is ignored rather than refused (see §3).
51
+
52
+ ```http
53
+ POST https://api.serpdive.com/v1/search
54
+ authorization: Bearer sd_live_… # a valid key, redacted
55
+ content-type: application/json
56
+
57
+ {"query":"best open source vector databases","model":"krill"}
58
+ ```
59
+
60
+ `HTTP 200` in 2145 ms
61
+
62
+ ```json
63
+ {
64
+ "query": "best open source vector databases",
65
+ "model": "krill",
66
+ "response_time_ms": 2113,
67
+ "results": [
68
+ {
69
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
70
+ "title": "Best open source vector database solutions: Top 5 in 2026",
71
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (213 chars)"
72
+ },
73
+ {
74
+ "url": "https://redis.io/blog/best-open-source-vector-databases-comparison/",
75
+ "title": "Comparing the best open source vector databases (2026)",
76
+ "content": "This comparison breaks down the leading open source vector databases for production AI wor… (190 chars)"
77
+ },
78
+ "… 3 more, same shape"
79
+ ]
80
+ }
81
+ ```
82
+
83
+ ### mako — 1 credit
84
+
85
+ ```http
86
+ POST https://api.serpdive.com/v1/search
87
+ authorization: Bearer sd_live_… # a valid key, redacted
88
+ content-type: application/json
89
+
90
+ {"query":"best open source vector databases","model":"mako"}
91
+ ```
92
+
93
+ `HTTP 200` in 1976 ms
94
+
95
+ ```json
96
+ {
97
+ "query": "best open source vector databases",
98
+ "model": "mako",
99
+ "response_time_ms": 1941,
100
+ "results": [
101
+ {
102
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
103
+ "title": "Best open source vector database solutions: Top 5 in 2026",
104
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (713 chars)"
105
+ },
106
+ {
107
+ "url": "https://redis.io/blog/best-open-source-vector-databases-comparison/",
108
+ "title": "Comparing the best open source vector databases (2026)",
109
+ "content": "This comparison breaks down the leading open source vector databases for production AI wor… (457 chars)"
110
+ },
111
+ "… 3 more, same shape"
112
+ ]
113
+ }
114
+ ```
115
+
116
+ ### moby — 1.5 credits
117
+
118
+ Full readable page content; note the content lengths against mako above.
119
+
120
+ ```http
121
+ POST https://api.serpdive.com/v1/search
122
+ authorization: Bearer sd_live_… # a valid key, redacted
123
+ content-type: application/json
124
+
125
+ {"query":"best open source vector databases","model":"moby"}
126
+ ```
127
+
128
+ `HTTP 200` in 2647 ms
129
+
130
+ ```json
131
+ {
132
+ "query": "best open source vector databases",
133
+ "model": "moby",
134
+ "response_time_ms": 2561,
135
+ "results": [
136
+ {
137
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
138
+ "title": "Best open source vector database solutions: Top 5 in 2026",
139
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (14041 chars)"
140
+ },
141
+ {
142
+ "url": "https://redis.io/blog/best-open-source-vector-databases-comparison/",
143
+ "title": "Comparing the best open source vector databases (2026)",
144
+ "content": "Serve your agents fresh data at Redis speed.\nComparing the best open source vector databas… (13856 chars)"
145
+ },
146
+ "… 4 more, same shape"
147
+ ]
148
+ }
149
+ ```
150
+
151
+ ## 3. `answer`
152
+
153
+ ### answer: true with mako
154
+
155
+ The `answer` key is present only when requested.
156
+
157
+ ```http
158
+ POST https://api.serpdive.com/v1/search
159
+ authorization: Bearer sd_live_… # a valid key, redacted
160
+ content-type: application/json
161
+
162
+ {"query":"best open source vector databases","model":"mako","answer":true}
163
+ ```
164
+
165
+ `HTTP 200` in 2490 ms
166
+
167
+ ```json
168
+ {
169
+ "query": "best open source vector databases",
170
+ "model": "mako",
171
+ "response_time_ms": 2456,
172
+ "answer": "The best open source vector databases are: \n1. Opensearch \n2. Apache Cassandra \n3. pgvector \n4. Milvus \n5. Qdrant \n6. Weaviate \n7. Vald.… (136 chars)",
173
+ "results": [
174
+ {
175
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
176
+ "title": "Best open source vector database solutions: Top 5 in 2026",
177
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (529 chars)"
178
+ },
179
+ {
180
+ "url": "https://redis.io/blog/best-open-source-vector-databases-comparison/",
181
+ "title": "Comparing the best open source vector databases (2026)",
182
+ "content": "This comparison breaks down the leading open source vector databases for production AI wor… (591 chars)"
183
+ },
184
+ "… 3 more, same shape"
185
+ ]
186
+ }
187
+ ```
188
+
189
+ ### answer: true with krill
190
+
191
+ Silently ignored on the free tier — no `answer` key, no error, still a complete result.
192
+
193
+ ```http
194
+ POST https://api.serpdive.com/v1/search
195
+ authorization: Bearer sd_live_… # a valid key, redacted
196
+ content-type: application/json
197
+
198
+ {"query":"best open source vector databases","model":"krill","answer":true}
199
+ ```
200
+
201
+ `HTTP 200` in 1642 ms
202
+
203
+ ```json
204
+ {
205
+ "query": "best open source vector databases",
206
+ "model": "krill",
207
+ "response_time_ms": 1612,
208
+ "results": [
209
+ {
210
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
211
+ "title": "Best open source vector database solutions: Top 5 in 2026",
212
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (322 chars)"
213
+ },
214
+ {
215
+ "url": "https://redis.io/blog/best-open-source-vector-databases-comparison/",
216
+ "title": "Comparing the best open source vector databases (2026)",
217
+ "content": "This comparison breaks down the leading open source vector databases for production AI wor… (293 chars)"
218
+ },
219
+ "… 2 more, same shape"
220
+ ]
221
+ }
222
+ ```
223
+
224
+ ## 4. `max_results` is a cap, never a minimum
225
+
226
+ A cap, applied at the edge after the search. The engine still reads a full corpus, so a small
227
+ cap trims the response, not the work — and asking for more does not produce more.
228
+
229
+ ### max_results: 1
230
+
231
+ ```http
232
+ POST https://api.serpdive.com/v1/search
233
+ authorization: Bearer sd_live_… # a valid key, redacted
234
+ content-type: application/json
235
+
236
+ {"query":"best open source vector databases","model":"krill","max_results":1}
237
+ ```
238
+
239
+ `HTTP 200` in 1697 ms
240
+
241
+ ```json
242
+ {
243
+ "query": "best open source vector databases",
244
+ "model": "krill",
245
+ "response_time_ms": 1665,
246
+ "results": [
247
+ {
248
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
249
+ "title": "Best open source vector database solutions: Top 5 in 2026",
250
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (213 chars)"
251
+ }
252
+ ]
253
+ }
254
+ ```
255
+
256
+ ### max_results: 3
257
+
258
+ ```http
259
+ POST https://api.serpdive.com/v1/search
260
+ authorization: Bearer sd_live_… # a valid key, redacted
261
+ content-type: application/json
262
+
263
+ {"query":"best open source vector databases","model":"krill","max_results":3}
264
+ ```
265
+
266
+ `HTTP 200` in 1725 ms
267
+
268
+ ```json
269
+ {
270
+ "query": "best open source vector databases",
271
+ "model": "krill",
272
+ "response_time_ms": 1681,
273
+ "results": [
274
+ {
275
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
276
+ "title": "Best open source vector database solutions: Top 5 in 2026",
277
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (634 chars)"
278
+ },
279
+ {
280
+ "url": "https://redis.io/blog/best-open-source-vector-databases-comparison/",
281
+ "title": "Comparing the best open source vector databases (2026)",
282
+ "content": "Some vector databases work best with Kubernetes orchestration, while others offer cloud-ho… (182 chars)"
283
+ },
284
+ "… 1 more, same shape"
285
+ ]
286
+ }
287
+ ```
288
+
289
+ ### max_results: 10
290
+
291
+ The ceiling of the range. Fewer come back when fewer are judged relevant — see §1, where no cap returned 5.
292
+
293
+ ```http
294
+ POST https://api.serpdive.com/v1/search
295
+ authorization: Bearer sd_live_… # a valid key, redacted
296
+ content-type: application/json
297
+
298
+ {"query":"best open source vector databases","model":"krill","max_results":10}
299
+ ```
300
+
301
+ `HTTP 200` in 1706 ms
302
+
303
+ ```json
304
+ {
305
+ "query": "best open source vector databases",
306
+ "model": "krill",
307
+ "response_time_ms": 1676,
308
+ "results": [
309
+ {
310
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
311
+ "title": "Best open source vector database solutions: Top 5 in 2026",
312
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (502 chars)"
313
+ },
314
+ {
315
+ "url": "https://redis.io/blog/best-open-source-vector-databases-comparison/",
316
+ "title": "Comparing the best open source vector databases (2026)",
317
+ "content": "This comparison breaks down the leading open source vector databases for production AI wor… (97 chars)"
318
+ },
319
+ "… 5 more, same shape"
320
+ ]
321
+ }
322
+ ```
323
+
324
+ ### max_results: 50
325
+
326
+ Above the range: clamped down to 10, silently. Never a 400.
327
+
328
+ ```http
329
+ POST https://api.serpdive.com/v1/search
330
+ authorization: Bearer sd_live_… # a valid key, redacted
331
+ content-type: application/json
332
+
333
+ {"query":"best open source vector databases","model":"krill","max_results":50}
334
+ ```
335
+
336
+ `HTTP 200` in 1820 ms
337
+
338
+ ```json
339
+ {
340
+ "query": "best open source vector databases",
341
+ "model": "krill",
342
+ "response_time_ms": 1788,
343
+ "results": [
344
+ {
345
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
346
+ "title": "Best open source vector database solutions: Top 5 in 2026",
347
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (213 chars)"
348
+ },
349
+ {
350
+ "url": "https://redis.io/blog/best-open-source-vector-databases-comparison/",
351
+ "title": "Comparing the best open source vector databases (2026)",
352
+ "content": "This comparison breaks down the leading open source vector databases for production AI wor… (247 chars)"
353
+ },
354
+ "… 3 more, same shape"
355
+ ]
356
+ }
357
+ ```
358
+
359
+ ### max_results: 0
360
+
361
+ Below the range: clamped UP to 1, silently — it is the minimum of the range, NOT a way to say "no cap". One result comes back.
362
+
363
+ ```http
364
+ POST https://api.serpdive.com/v1/search
365
+ authorization: Bearer sd_live_… # a valid key, redacted
366
+ content-type: application/json
367
+
368
+ {"query":"best open source vector databases","model":"krill","max_results":0}
369
+ ```
370
+
371
+ `HTTP 200` in 1845 ms
372
+
373
+ ```json
374
+ {
375
+ "query": "best open source vector databases",
376
+ "model": "krill",
377
+ "response_time_ms": 1800,
378
+ "results": [
379
+ {
380
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
381
+ "title": "Best open source vector database solutions: Top 5 in 2026",
382
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (322 chars)"
383
+ }
384
+ ]
385
+ }
386
+ ```
387
+
388
+ ### max_results: "abc"
389
+
390
+ Unparseable, and this is the asymmetry worth knowing: an out-of-range NUMBER is clamped into the range, but a value that is not a number at all drops the cap entirely and the default applies. Same for null or an absent field.
391
+
392
+ ```http
393
+ POST https://api.serpdive.com/v1/search
394
+ authorization: Bearer sd_live_… # a valid key, redacted
395
+ content-type: application/json
396
+
397
+ {"query":"best open source vector databases","model":"krill","max_results":"abc"}
398
+ ```
399
+
400
+ `HTTP 200` in 2096 ms
401
+
402
+ ```json
403
+ {
404
+ "query": "best open source vector databases",
405
+ "model": "krill",
406
+ "response_time_ms": 2014,
407
+ "results": [
408
+ {
409
+ "url": "https://www.instaclustr.com/education/vector-database/best-open-source-vector-database-solutions-top-5-in-2026/",
410
+ "title": "Best open source vector database solutions: Top 5 in 2026",
411
+ "content": "Notable open source vector database solutions · 1. Opensearch · 2. Apache Cassandra · 3. p… (520 chars)"
412
+ },
413
+ {
414
+ "url": "https://medium.com/@pratik-rupareliya/top-15-vector-databases-in-2026-a-production-decision-guide-from-100-enterprise-deployments-dd58a04f51a5",
415
+ "title": "Medium",
416
+ "content": "Top 15 vector databases in 2026: A production decision guide from 100+ enterprise deployme… (408 chars)"
417
+ },
418
+ "… 4 more, same shape"
419
+ ]
420
+ }
421
+ ```
422
+
423
+ ## 5. Errors
424
+
425
+ ### Missing query
426
+
427
+ ```http
428
+ POST https://api.serpdive.com/v1/search
429
+ authorization: Bearer sd_live_… # a valid key, redacted
430
+ content-type: application/json
431
+
432
+ {"model":"krill"}
433
+ ```
434
+
435
+ `HTTP 400` in 39 ms
436
+
437
+ ```json
438
+ {
439
+ "error": "missing_query",
440
+ "message": "The \"query\" field is required, e.g. {\"query\": \"your search\"}."
441
+ }
442
+ ```
443
+
444
+ ### Invalid key
445
+
446
+ ```http
447
+ POST https://api.serpdive.com/v1/search
448
+ authorization: Bearer sd_live_not_a_real_key
449
+ content-type: application/json
450
+
451
+ {"query":"best open source vector databases"}
452
+ ```
453
+
454
+ `HTTP 401` in 533 ms
455
+
456
+ ```json
457
+ {
458
+ "error": "invalid_api_key",
459
+ "message": "This API key is invalid or was revoked. Manage your keys at https://serpdive.com/dashboard/keys"
460
+ }
461
+ ```
462
+
463
+ ### No key at all
464
+
465
+ ```http
466
+ POST https://api.serpdive.com/v1/search
467
+ (no authorization header sent)
468
+ content-type: application/json
469
+
470
+ {"query":"best open source vector databases"}
471
+ ```
472
+
473
+ `HTTP 401` in 27 ms
474
+
475
+ ```json
476
+ {
477
+ "error": "missing_api_key",
478
+ "message": "No API key. Send it as \"Authorization: Bearer sd_live_…\" — create one at https://serpdive.com/dashboard/keys"
479
+ }
480
+ ```
481
+
482
+ ## 6. Abort
483
+
484
+ ### Client aborts mid-flight
485
+
486
+ The request is cancellable at any point; the provider maps this to the framework abort path.
487
+
488
+ ```http
489
+ POST https://api.serpdive.com/v1/search
490
+ authorization: Bearer sd_live_… # a valid key, redacted
491
+ content-type: application/json
492
+
493
+ {"query":"best open source vector databases","model":"krill"}
494
+ ```
495
+
496
+ Client aborted after 300 ms → `AbortError` raised locally; no response body.
@@ -0,0 +1,127 @@
1
+ import fs from "node:fs";
2
+ const KEY = process.env.SERPDIVE_API_KEY;
3
+ if (!KEY) {
4
+ console.error("SERPDIVE_API_KEY is not set. Get a key at https://serpdive.com/dashboard/keys");
5
+ process.exit(1);
6
+ }
7
+ const URL = "https://api.serpdive.com/v1/search";
8
+ const out = [];
9
+ const say = (s = "") => out.push(s);
10
+ async function call(body, { key = KEY, abortAfterMs = null } = {}) {
11
+ const ctrl = new AbortController;
12
+ if (abortAfterMs)
13
+ setTimeout(() => ctrl.abort(), abortAfterMs);
14
+ const t0 = Date.now();
15
+ try {
16
+ const res = await fetch(URL, {
17
+ method: "POST",
18
+ headers: { "content-type": "application/json", ...key ? { authorization: `Bearer ${key}` } : {} },
19
+ body: JSON.stringify(body),
20
+ signal: ctrl.signal
21
+ });
22
+ const json = await res.json().catch(() => null);
23
+ return { status: res.status, ms: Date.now() - t0, json };
24
+ } catch (err) {
25
+ return { status: null, ms: Date.now() - t0, aborted: err.name === "AbortError", err: err.name };
26
+ }
27
+ }
28
+ function shape(j) {
29
+ if (!j)
30
+ return null;
31
+ const c = JSON.parse(JSON.stringify(j));
32
+ if (Array.isArray(c.results)) {
33
+ c.results = c.results.slice(0, 2).map((r) => ({
34
+ ...r,
35
+ content: typeof r.content === "string" ? `${r.content.slice(0, 90)}… (${r.content.length} chars)` : r.content
36
+ }));
37
+ if (j.results.length > 2)
38
+ c.results.push(`… ${j.results.length - 2} more, same shape`);
39
+ }
40
+ if (typeof c.answer === "string")
41
+ c.answer = `${c.answer.slice(0, 160)}… (${j.answer.length} chars)`;
42
+ return c;
43
+ }
44
+ async function section(title, note, body, opts = {}) {
45
+ const r = await call(body, opts);
46
+ const keyLine = !("key" in opts) ? "authorization: Bearer sd_live_… # a valid key, redacted" : opts.key === null ? "(no authorization header sent)" : `authorization: Bearer ${opts.key}`;
47
+ say(`### ${title}`);
48
+ say();
49
+ if (note) {
50
+ say(note);
51
+ say();
52
+ }
53
+ say("```http");
54
+ say("POST https://api.serpdive.com/v1/search");
55
+ say(keyLine);
56
+ say("content-type: application/json");
57
+ say();
58
+ say(JSON.stringify(body));
59
+ say("```");
60
+ say();
61
+ if (r.aborted) {
62
+ say(`Client aborted after ${opts.abortAfterMs} ms → \`${r.err}\` raised locally; no response body.`);
63
+ } else {
64
+ say(`\`HTTP ${r.status}\` in ${r.ms} ms`);
65
+ say();
66
+ say("```json");
67
+ say(JSON.stringify(shape(r.json), null, 2));
68
+ say("```");
69
+ }
70
+ say();
71
+ return r;
72
+ }
73
+ const Q = "best open source vector databases";
74
+ say("# SERPdive API — contract evidence");
75
+ say();
76
+ say("Every block below is a real call against `https://api.serpdive.com/v1/search`, captured on " + new Date().toISOString().slice(0, 10) + ". Reproduce any of them with your own key: the script that");
77
+ say("generated this file is `evidence/contract-probe.mjs`. Page content is truncated to keep the file");
78
+ say("readable — nothing else is edited, and the API key is redacted.");
79
+ say();
80
+ say("---");
81
+ say();
82
+ say("## 1. Default request and response shape");
83
+ say();
84
+ await section("Query only", "The whole request surface is `query`, `model`, `answer`, `max_results`. Everything else is ignored.", { query: Q });
85
+ say("## 2. Models");
86
+ say();
87
+ await section("krill — free tier", "No answer synthesis on this tier: requesting one is ignored rather than refused (see §3).", { query: Q, model: "krill" });
88
+ await section("mako — 1 credit", null, { query: Q, model: "mako" });
89
+ await section("moby — 1.5 credits", "Full readable page content; note the content lengths against mako above.", { query: Q, model: "moby" });
90
+ say("## 3. `answer`");
91
+ say();
92
+ await section("answer: true with mako", "The `answer` key is present only when requested.", { query: Q, model: "mako", answer: true });
93
+ await section("answer: true with krill", "Silently ignored on the free tier — no `answer` key, no error, still a complete result.", { query: Q, model: "krill", answer: true });
94
+ say("## 4. `max_results` is a cap, never a minimum");
95
+ say();
96
+ say("A cap, applied at the edge after the search. The engine still reads a full corpus, so a small");
97
+ say("cap trims the response, not the work — and asking for more does not produce more.");
98
+ say();
99
+ for (const [n, note] of [
100
+ [1, null],
101
+ [3, null],
102
+ [10, "The ceiling of the range. Fewer come back when fewer are judged relevant — see §1, where no cap returned 5."],
103
+ [50, "Above the range: clamped down to 10, silently. Never a 400."],
104
+ [0, 'Below the range: clamped UP to 1, silently — it is the minimum of the range, NOT a way to say "no cap". One result comes back.'],
105
+ ["abc", "Unparseable, and this is the asymmetry worth knowing: an out-of-range NUMBER is clamped into the range, but a value that is not a number at all drops the cap entirely and the default applies. Same for null or an absent field."]
106
+ ]) {
107
+ await section(`max_results: ${JSON.stringify(n)}`, note, { query: Q, model: "krill", max_results: n });
108
+ }
109
+ say("## 5. Errors");
110
+ say();
111
+ await section("Missing query", null, { model: "krill" });
112
+ await section("Invalid key", null, { query: Q }, { key: "sd_live_not_a_real_key" });
113
+ await section("No key at all", null, { query: Q }, { key: null });
114
+ say("## 6. Abort");
115
+ say();
116
+ await section("Client aborts mid-flight", "The request is cancellable at any point; the provider maps this to the framework abort path.", { query: Q, model: "krill" }, { abortAfterMs: 300 });
117
+ const path = new URL("./CONTRACT-EVIDENCE.md", import.meta.url).pathname;
118
+ fs.writeFileSync(path, out.join(`
119
+ `));
120
+ console.log(`written: ${path}`);
121
+ console.log(`${out.join(`
122
+ `).length} characters`);
123
+ if (out.join(`
124
+ `).includes(KEY))
125
+ console.error("!! THE API KEY APPEARS IN THE OUTPUT — not written");
126
+ else
127
+ console.log("verified: the key appears nowhere in the output");