@jshookmcp/jshook 0.2.2 → 0.2.5

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 (414) hide show
  1. package/LICENSE +661 -661
  2. package/README.md +15 -6
  3. package/README.zh.md +19 -4
  4. package/dist/native/scripts/linux/enum-windows.sh +12 -12
  5. package/dist/native/scripts/macos/enum-windows.applescript +22 -22
  6. package/dist/native/scripts/windows/enum-windows-by-class.ps1 +51 -51
  7. package/dist/native/scripts/windows/enum-windows.ps1 +44 -44
  8. package/dist/native/scripts/windows/inject-dll.ps1 +21 -21
  9. package/dist/packages/extension-sdk/src/bridges/shared.js +2 -2
  10. package/dist/packages/extension-sdk/src/plugin.d.ts +5 -0
  11. package/dist/packages/extension-sdk/src/plugin.js +119 -33
  12. package/dist/packages/extension-sdk/src/workflow.d.ts +156 -0
  13. package/dist/packages/extension-sdk/src/workflow.js +236 -0
  14. package/dist/src/config/search-defaults.js +161 -0
  15. package/dist/src/constants.d.ts +3 -0
  16. package/dist/src/constants.js +4 -1
  17. package/dist/src/index.d.ts +1 -1
  18. package/dist/src/index.js +13 -17
  19. package/dist/src/modules/analyzer/CodeAnalyzer.d.ts +1 -3
  20. package/dist/src/modules/analyzer/CodeAnalyzer.js +16 -28
  21. package/dist/src/modules/analyzer/CodeAnalyzerDataFlow.d.ts +1 -2
  22. package/dist/src/modules/analyzer/CodeAnalyzerDataFlow.js +1 -45
  23. package/dist/src/modules/analyzer/IntelligentAnalyzer.d.ts +1 -37
  24. package/dist/src/modules/analyzer/IntelligentAnalyzer.js +9 -142
  25. package/dist/src/modules/analyzer/PatternDetector.js +3 -3
  26. package/dist/src/modules/analyzer/PatternDetectorAuthPatterns.js +1 -1
  27. package/dist/src/modules/browser/BrowserDiscovery.d.ts +6 -5
  28. package/dist/src/modules/browser/BrowserDiscovery.js +3 -3
  29. package/dist/src/modules/browser/BrowserModeManager.d.ts +1 -1
  30. package/dist/src/modules/browser/BrowserModeManager.js +11 -10
  31. package/dist/src/modules/browser/TabRegistry.js +2 -2
  32. package/dist/src/modules/browser/UnifiedBrowserManager.d.ts +1 -0
  33. package/dist/src/modules/browser/UnifiedBrowserManager.js +19 -4
  34. package/dist/src/modules/captcha/AICaptchaDetector.d.ts +14 -23
  35. package/dist/src/modules/captcha/AICaptchaDetector.js +8 -202
  36. package/dist/src/modules/captcha/CaptchaDetector.d.ts +31 -17
  37. package/dist/src/modules/captcha/CaptchaDetector.js +1 -1
  38. package/dist/src/modules/collector/CodeCache.d.ts +2 -2
  39. package/dist/src/modules/collector/CodeCollector.d.ts +12 -9
  40. package/dist/src/modules/collector/CodeCollector.js +5 -6
  41. package/dist/src/modules/collector/DOMInspector.d.ts +3 -2
  42. package/dist/src/modules/collector/DOMInspector.js +49 -59
  43. package/dist/src/modules/collector/PageController.d.ts +17 -4
  44. package/dist/src/modules/collector/PageController.js +2 -5
  45. package/dist/src/modules/collector/PageScriptCollectors.js +3 -3
  46. package/dist/src/modules/crypto/CryptoDetector.d.ts +1 -4
  47. package/dist/src/modules/crypto/CryptoDetector.js +2 -42
  48. package/dist/src/modules/crypto/CryptoRules.js +1 -1
  49. package/dist/src/modules/debugger/BlackboxManager.js +1 -1
  50. package/dist/src/modules/debugger/DebuggerManager.impl.core.scope.js +1 -1
  51. package/dist/src/modules/debugger/ScriptManager.impl.extract-function-tree.js +5 -3
  52. package/dist/src/modules/debugger/WatchExpressionManager.js +1 -1
  53. package/dist/src/modules/deobfuscator/Deobfuscator.d.ts +1 -4
  54. package/dist/src/modules/deobfuscator/Deobfuscator.js +4 -39
  55. package/dist/src/modules/deobfuscator/JSVMPDeobfuscator.d.ts +0 -3
  56. package/dist/src/modules/deobfuscator/JSVMPDeobfuscator.js +2 -8
  57. package/dist/src/modules/deobfuscator/JSVMPDeobfuscator.restore.d.ts +2 -3
  58. package/dist/src/modules/deobfuscator/JSVMPDeobfuscator.restore.js +5 -57
  59. package/dist/src/modules/deobfuscator/JScramblerDeobfuscator.js +3 -4
  60. package/dist/src/modules/deobfuscator/PackerDeobfuscator.js +1 -1
  61. package/dist/src/modules/deobfuscator/VMDeobfuscator.d.ts +2 -10
  62. package/dist/src/modules/deobfuscator/VMDeobfuscator.js +3 -128
  63. package/dist/src/modules/deobfuscator/webcrack.js +15 -2
  64. package/dist/src/modules/emulator/AIEnvironmentAnalyzer.d.ts +5 -8
  65. package/dist/src/modules/emulator/AIEnvironmentAnalyzer.js +10 -102
  66. package/dist/src/modules/emulator/EnvironmentEmulator.d.ts +1 -5
  67. package/dist/src/modules/emulator/EnvironmentEmulator.js +7 -91
  68. package/dist/src/modules/emulator/EnvironmentEmulatorFetch.js +58 -61
  69. package/dist/src/modules/emulator/templates/chrome-env.d.ts +17 -7
  70. package/dist/src/modules/emulator/templates/chrome-env.js +14 -7
  71. package/dist/src/modules/external/ExternalToolRunner.d.ts +1 -1
  72. package/dist/src/modules/external/ExternalToolRunner.js +26 -23
  73. package/dist/src/modules/monitor/ConsoleMonitor.impl.core.class.d.ts +13 -0
  74. package/dist/src/modules/monitor/ConsoleMonitor.impl.core.class.js +42 -0
  75. package/dist/src/modules/monitor/FetchInterceptor.d.ts +46 -0
  76. package/dist/src/modules/monitor/FetchInterceptor.js +191 -0
  77. package/dist/src/modules/monitor/PerformanceMonitor.js +8 -7
  78. package/dist/src/modules/process/BaseMemoryManager.d.ts +1 -1
  79. package/dist/src/modules/process/LinuxProcessManager.js +4 -2
  80. package/dist/src/modules/process/MacProcessManager.js +1 -1
  81. package/dist/src/modules/process/MemoryManager.d.ts +1 -1
  82. package/dist/src/modules/process/MemoryManager.js +2 -2
  83. package/dist/src/modules/process/ProcessManager.impl.js +1 -1
  84. package/dist/src/modules/process/memory/AuditTrail.js +1 -1
  85. package/dist/src/modules/process/memory/reader.js +35 -3
  86. package/dist/src/modules/process/memory/regions.enumerate.js +1 -1
  87. package/dist/src/modules/process/memory/regions.protection.js +42 -9
  88. package/dist/src/modules/process/memory/scanner.d.ts +5 -1
  89. package/dist/src/modules/process/memory/scanner.darwin.js +57 -0
  90. package/dist/src/modules/process/memory/scanner.js +88 -4
  91. package/dist/src/modules/process/memory/writer.js +44 -4
  92. package/dist/src/modules/security/ExecutionSandbox.js +7 -8
  93. package/dist/src/modules/stealth/FingerprintManager.js +1 -1
  94. package/dist/src/modules/stealth/StealthScripts.d.ts +4 -2
  95. package/dist/src/modules/stealth/StealthScripts.js +53 -14
  96. package/dist/src/modules/stealth/StealthVerifier.d.ts +1 -1
  97. package/dist/src/modules/stealth/StealthVerifier.js +2 -4
  98. package/dist/src/modules/symbolic/JSVMPSymbolicExecutor.d.ts +14 -0
  99. package/dist/src/modules/symbolic/JSVMPSymbolicExecutor.js +181 -2
  100. package/dist/src/modules/trace/TraceDB.js +12 -6
  101. package/dist/src/modules/trace/TraceRecorder.js +1 -5
  102. package/dist/src/native/AntiCheatDetector.js +67 -16
  103. package/dist/src/native/CodeInjector.js +4 -4
  104. package/dist/src/native/HardwareBreakpoint.js +25 -16
  105. package/dist/src/native/HeapAnalyzer.js +2 -2
  106. package/dist/src/native/MemoryController.js +1 -1
  107. package/dist/src/native/MemoryScanSession.js +2 -2
  108. package/dist/src/native/MemoryScanner.js +4 -8
  109. package/dist/src/native/NativeMemoryManager.impl.js +2 -2
  110. package/dist/src/native/PEAnalyzer.js +14 -15
  111. package/dist/src/native/PointerChainEngine.js +2 -4
  112. package/dist/src/native/ScriptLoader.js +4 -9
  113. package/dist/src/native/Speedhack.js +1 -1
  114. package/dist/src/native/StructureAnalyzer.js +52 -33
  115. package/dist/src/native/Win32API.d.ts +1 -0
  116. package/dist/src/native/Win32API.js +13 -0
  117. package/dist/src/native/Win32Debug.js +19 -19
  118. package/dist/src/native/platform/darwin/DarwinAPI.d.ts +2 -0
  119. package/dist/src/native/platform/darwin/DarwinAPI.js +8 -0
  120. package/dist/src/native/platform/darwin/DarwinMemoryProvider.js +6 -1
  121. package/dist/src/server/MCPServer.context.d.ts +2 -1
  122. package/dist/src/server/MCPServer.d.ts +2 -1
  123. package/dist/src/server/MCPServer.domain.d.ts +1 -1
  124. package/dist/src/server/MCPServer.domain.js +81 -16
  125. package/dist/src/server/MCPServer.js +42 -14
  126. package/dist/src/server/MCPServer.resources.d.ts +2 -0
  127. package/dist/src/server/MCPServer.resources.js +91 -0
  128. package/dist/src/server/MCPServer.search.handlers.call.js +2 -1
  129. package/dist/src/server/MCPServer.search.helpers.js +2 -2
  130. package/dist/src/server/MCPServer.tools.js +1 -1
  131. package/dist/src/server/MCPServer.transport.js +12 -0
  132. package/dist/src/server/ToolCallContextGuard.d.ts +5 -0
  133. package/dist/src/server/ToolCallContextGuard.js +85 -0
  134. package/dist/src/server/ToolRouter.d.ts +26 -10
  135. package/dist/src/server/ToolRouter.intent.d.ts +26 -0
  136. package/dist/src/server/ToolRouter.intent.js +77 -0
  137. package/dist/src/server/ToolRouter.js +103 -284
  138. package/dist/src/server/ToolRouter.policy.d.ts +22 -0
  139. package/dist/src/server/ToolRouter.policy.js +163 -0
  140. package/dist/src/server/ToolRouter.probe.d.ts +17 -0
  141. package/dist/src/server/ToolRouter.probe.js +103 -0
  142. package/dist/src/server/ToolRouter.renderer.d.ts +9 -0
  143. package/dist/src/server/ToolRouter.renderer.js +52 -0
  144. package/dist/src/server/activation/ActivationController.js +15 -12
  145. package/dist/src/server/activation/CompoundConditionEngine.js +1 -1
  146. package/dist/src/server/activation/PredictiveBooster.js +1 -3
  147. package/dist/src/server/domains/analysis/definitions.js +155 -655
  148. package/dist/src/server/domains/analysis/handlers.impl.d.ts +8 -8
  149. package/dist/src/server/domains/analysis/handlers.impl.js +34 -28
  150. package/dist/src/server/domains/analysis/handlers.web-tools.js +4 -3
  151. package/dist/src/server/domains/analysis/manifest.js +6 -4
  152. package/dist/src/server/domains/antidebug/definitions.js +25 -111
  153. package/dist/src/server/domains/browser/definitions.tools.advanced.js +59 -88
  154. package/dist/src/server/domains/browser/definitions.tools.behavior.js +120 -227
  155. package/dist/src/server/domains/browser/definitions.tools.page-core.js +157 -386
  156. package/dist/src/server/domains/browser/definitions.tools.page-system.js +108 -250
  157. package/dist/src/server/domains/browser/definitions.tools.runtime.js +61 -174
  158. package/dist/src/server/domains/browser/definitions.tools.security.js +92 -237
  159. package/dist/src/server/domains/browser/handlers/camoufox-browser.js +3 -2
  160. package/dist/src/server/domains/browser/handlers/captcha-solver.js +3 -3
  161. package/dist/src/server/domains/browser/handlers/dom-query.js +2 -1
  162. package/dist/src/server/domains/browser/handlers/facade-initializer.d.ts +3 -3
  163. package/dist/src/server/domains/browser/handlers/facade-initializer.js +3 -3
  164. package/dist/src/server/domains/browser/handlers/framework-state.js +231 -3
  165. package/dist/src/server/domains/browser/handlers/indexeddb-dump.js +21 -20
  166. package/dist/src/server/domains/browser/handlers/script-management.js +1 -1
  167. package/dist/src/server/domains/browser/handlers/stealth-injection.js +8 -2
  168. package/dist/src/server/domains/browser/handlers.impl.d.ts +15 -12
  169. package/dist/src/server/domains/browser/handlers.impl.js +5 -6
  170. package/dist/src/server/domains/browser/manifest.js +37 -13
  171. package/dist/src/server/domains/coordination/definitions.js +50 -149
  172. package/dist/src/server/domains/coordination/index.d.ts +20 -1
  173. package/dist/src/server/domains/coordination/index.js +133 -0
  174. package/dist/src/server/domains/coordination/manifest.js +15 -0
  175. package/dist/src/server/domains/debugger/definitions.tools.advanced.js +72 -189
  176. package/dist/src/server/domains/debugger/definitions.tools.core.js +114 -288
  177. package/dist/src/server/domains/debugger/manifest.js +9 -2
  178. package/dist/src/server/domains/encoding/definitions.js +43 -153
  179. package/dist/src/server/domains/encoding/handlers.base.js +2 -2
  180. package/dist/src/server/domains/evidence/definitions.d.ts +2 -0
  181. package/dist/src/server/domains/evidence/definitions.js +42 -0
  182. package/dist/src/server/domains/evidence/handlers.d.ts +582 -0
  183. package/dist/src/server/domains/evidence/handlers.js +60 -0
  184. package/dist/src/server/domains/evidence/index.d.ts +2 -0
  185. package/dist/src/server/domains/evidence/index.js +2 -0
  186. package/dist/src/server/domains/evidence/manifest.d.ts +63 -0
  187. package/dist/src/server/domains/evidence/manifest.js +78 -0
  188. package/dist/src/server/domains/graphql/definitions.js +53 -141
  189. package/dist/src/server/domains/graphql/handlers.impl.core.runtime.replay.js +92 -114
  190. package/dist/src/server/domains/hooks/ai-handlers.d.ts +0 -7
  191. package/dist/src/server/domains/hooks/ai-handlers.js +4 -70
  192. package/dist/src/server/domains/hooks/definitions.js +69 -335
  193. package/dist/src/server/domains/hooks/manifest.d.ts +1 -1
  194. package/dist/src/server/domains/hooks/manifest.js +1 -2
  195. package/dist/src/server/domains/instrumentation/definitions.d.ts +2 -0
  196. package/dist/src/server/domains/instrumentation/definitions.js +99 -0
  197. package/dist/src/server/domains/instrumentation/handlers.d.ts +78 -0
  198. package/dist/src/server/domains/instrumentation/handlers.js +206 -0
  199. package/dist/src/server/domains/instrumentation/index.d.ts +2 -0
  200. package/dist/src/server/domains/instrumentation/index.js +2 -0
  201. package/dist/src/server/domains/instrumentation/manifest.d.ts +63 -0
  202. package/dist/src/server/domains/instrumentation/manifest.js +114 -0
  203. package/dist/src/server/domains/macro/definitions.js +16 -43
  204. package/dist/src/server/domains/maintenance/definitions.js +60 -219
  205. package/dist/src/server/domains/maintenance/handlers.d.ts +2 -2
  206. package/dist/src/server/domains/maintenance/handlers.extensions.js +78 -20
  207. package/dist/src/server/domains/maintenance/handlers.js +2 -2
  208. package/dist/src/server/domains/memory/definitions.js +387 -559
  209. package/dist/src/server/domains/memory/handlers/hooks.d.ts +55 -0
  210. package/dist/src/server/domains/memory/handlers/hooks.js +115 -0
  211. package/dist/src/server/domains/memory/handlers/integrity.d.ts +77 -0
  212. package/dist/src/server/domains/memory/handlers/integrity.js +180 -0
  213. package/dist/src/server/domains/memory/handlers/pointer-chain.d.ts +29 -0
  214. package/dist/src/server/domains/memory/handlers/pointer-chain.js +82 -0
  215. package/dist/src/server/domains/memory/handlers/readwrite.d.ts +41 -0
  216. package/dist/src/server/domains/memory/handlers/readwrite.js +78 -0
  217. package/dist/src/server/domains/memory/handlers/scan.d.ts +35 -0
  218. package/dist/src/server/domains/memory/handlers/scan.js +97 -0
  219. package/dist/src/server/domains/memory/handlers/session.d.ts +23 -0
  220. package/dist/src/server/domains/memory/handlers/session.js +49 -0
  221. package/dist/src/server/domains/memory/handlers/structure.d.ts +29 -0
  222. package/dist/src/server/domains/memory/handlers/structure.js +74 -0
  223. package/dist/src/server/domains/memory/handlers.impl.d.ts +49 -54
  224. package/dist/src/server/domains/memory/handlers.impl.js +63 -494
  225. package/dist/src/server/domains/memory/manifest.js +236 -64
  226. package/dist/src/server/domains/native-bridge/definitions.js +54 -192
  227. package/dist/src/server/domains/native-bridge/index.d.ts +1 -0
  228. package/dist/src/server/domains/native-bridge/index.js +2 -1
  229. package/dist/src/server/domains/network/auth-extractor.js +1 -1
  230. package/dist/src/server/domains/network/definitions.js +175 -578
  231. package/dist/src/server/domains/network/handlers.base.core.d.ts +64 -0
  232. package/dist/src/server/domains/network/handlers.base.core.js +623 -0
  233. package/dist/src/server/domains/network/handlers.base.d.ts +2 -124
  234. package/dist/src/server/domains/network/handlers.base.js +3 -878
  235. package/dist/src/server/domains/network/handlers.base.performance.d.ts +63 -0
  236. package/dist/src/server/domains/network/handlers.base.performance.js +193 -0
  237. package/dist/src/server/domains/network/handlers.base.types.d.ts +42 -0
  238. package/dist/src/server/domains/network/handlers.base.types.js +89 -0
  239. package/dist/src/server/domains/network/handlers.impl.core.runtime.d.ts +1 -1
  240. package/dist/src/server/domains/network/handlers.impl.core.runtime.intercept.d.ts +21 -0
  241. package/dist/src/server/domains/network/handlers.impl.core.runtime.intercept.js +186 -0
  242. package/dist/src/server/domains/network/handlers.impl.core.runtime.js +1 -1
  243. package/dist/src/server/domains/network/manifest.js +15 -0
  244. package/dist/src/server/domains/network/replay.js +1 -4
  245. package/dist/src/server/domains/platform/definitions.js +121 -112
  246. package/dist/src/server/domains/platform/handlers/bridge-handlers.d.ts +5 -1
  247. package/dist/src/server/domains/platform/handlers/bridge-handlers.js +194 -5
  248. package/dist/src/server/domains/platform/handlers/electron-asar-helpers.js +26 -6
  249. package/dist/src/server/domains/platform/handlers/electron-dual-cdp.d.ts +3 -0
  250. package/dist/src/server/domains/platform/handlers/electron-dual-cdp.js +170 -0
  251. package/dist/src/server/domains/platform/handlers/electron-fuse-handler.d.ts +3 -0
  252. package/dist/src/server/domains/platform/handlers/electron-fuse-handler.js +193 -0
  253. package/dist/src/server/domains/platform/handlers/electron-handlers.d.ts +6 -0
  254. package/dist/src/server/domains/platform/handlers/electron-handlers.js +95 -2
  255. package/dist/src/server/domains/platform/handlers/electron-ipc-sniffer.d.ts +2 -0
  256. package/dist/src/server/domains/platform/handlers/electron-ipc-sniffer.js +370 -0
  257. package/dist/src/server/domains/platform/handlers/electron-userdata-handler.d.ts +2 -0
  258. package/dist/src/server/domains/platform/handlers/electron-userdata-handler.js +78 -0
  259. package/dist/src/server/domains/platform/handlers/miniapp-handlers.d.ts +1 -1
  260. package/dist/src/server/domains/platform/handlers/miniapp-handlers.js +4 -4
  261. package/dist/src/server/domains/platform/handlers/v8-bytecode-handler.d.ts +2 -0
  262. package/dist/src/server/domains/platform/handlers/v8-bytecode-handler.js +207 -0
  263. package/dist/src/server/domains/platform/handlers.d.ts +48 -0
  264. package/dist/src/server/domains/platform/handlers.js +29 -0
  265. package/dist/src/server/domains/platform/manifest.js +38 -0
  266. package/dist/src/server/domains/process/definitions.js +163 -647
  267. package/dist/src/server/domains/process/handlers.base.d.ts +3 -95
  268. package/dist/src/server/domains/process/handlers.base.js +7 -462
  269. package/dist/src/server/domains/process/handlers.base.process.d.ts +61 -0
  270. package/dist/src/server/domains/process/handlers.base.process.js +417 -0
  271. package/dist/src/server/domains/process/handlers.base.types.d.ts +57 -0
  272. package/dist/src/server/domains/process/handlers.base.types.js +50 -0
  273. package/dist/src/server/domains/process/handlers.impl.core.runtime.inject.js +19 -17
  274. package/dist/src/server/domains/process/manifest.js +6 -1
  275. package/dist/src/server/domains/sandbox/definitions.js +11 -33
  276. package/dist/src/server/domains/sandbox/handlers.js +8 -3
  277. package/dist/src/server/domains/shared/ResponseBuilder.d.ts +209 -0
  278. package/dist/src/server/domains/shared/ResponseBuilder.js +48 -0
  279. package/dist/src/server/domains/shared/modules.d.ts +0 -2
  280. package/dist/src/server/domains/shared/modules.js +0 -1
  281. package/dist/src/server/domains/sourcemap/definitions.js +27 -111
  282. package/dist/src/server/domains/sourcemap/handlers.impl.sourcemap-common.js +7 -2
  283. package/dist/src/server/domains/sourcemap/handlers.impl.sourcemap-main.js +1 -1
  284. package/dist/src/server/domains/sourcemap/handlers.impl.sourcemap-parse-base.js +1 -1
  285. package/dist/src/server/domains/sourcemap/manifest.d.ts +1 -1
  286. package/dist/src/server/domains/sourcemap/manifest.js +1 -1
  287. package/dist/src/server/domains/streaming/definitions.js +36 -148
  288. package/dist/src/server/domains/streaming/handlers.impl.streaming-sse.js +163 -164
  289. package/dist/src/server/domains/streaming/handlers.impl.streaming-ws.js +1 -1
  290. package/dist/src/server/domains/trace/TraceSummarizer.d.ts +60 -0
  291. package/dist/src/server/domains/trace/TraceSummarizer.js +112 -0
  292. package/dist/src/server/domains/trace/definitions.tools.js +51 -176
  293. package/dist/src/server/domains/trace/handlers.d.ts +2 -1
  294. package/dist/src/server/domains/trace/handlers.js +62 -9
  295. package/dist/src/server/domains/trace/index.d.ts +2 -1
  296. package/dist/src/server/domains/trace/index.js +2 -1
  297. package/dist/src/server/domains/trace/manifest.js +18 -4
  298. package/dist/src/server/domains/transform/definitions.js +50 -210
  299. package/dist/src/server/domains/transform/handlers.impl.transform-base.js +6 -6
  300. package/dist/src/server/domains/transform/handlers.impl.transform-crypto.js +18 -19
  301. package/dist/src/server/domains/transform/manifest.d.ts +1 -1
  302. package/dist/src/server/domains/transform/manifest.js +1 -1
  303. package/dist/src/server/domains/wasm/definitions.js +55 -232
  304. package/dist/src/server/domains/wasm/handlers.js +3 -3
  305. package/dist/src/server/domains/workflow/definitions.js +144 -414
  306. package/dist/src/server/domains/workflow/handlers.impl.workflow-account-bundle.js +2 -2
  307. package/dist/src/server/domains/workflow/handlers.impl.workflow-base.d.ts +2 -0
  308. package/dist/src/server/domains/workflow/handlers.impl.workflow-base.js +126 -87
  309. package/dist/src/server/domains/workflow/handlers.impl.workflow-batch.js +5 -5
  310. package/dist/src/server/evidence/ReverseEvidenceGraph.d.ts +20 -0
  311. package/dist/src/server/evidence/ReverseEvidenceGraph.js +208 -0
  312. package/dist/src/server/evidence/index.d.ts +2 -0
  313. package/dist/src/server/evidence/index.js +1 -0
  314. package/dist/src/server/evidence/types.d.ts +22 -0
  315. package/dist/src/server/evidence/types.js +1 -0
  316. package/dist/src/server/extensions/ExtensionManager.d.ts +1 -0
  317. package/dist/src/server/extensions/ExtensionManager.discovery.js +72 -9
  318. package/dist/src/server/extensions/ExtensionManager.integrity.js +1 -1
  319. package/dist/src/server/extensions/ExtensionManager.js +193 -40
  320. package/dist/src/server/extensions/ExtensionManager.roots.d.ts +1 -1
  321. package/dist/src/server/extensions/ExtensionManager.roots.js +19 -9
  322. package/dist/src/server/extensions/plugin-config.js +1 -1
  323. package/dist/src/server/extensions/plugin-env.d.ts +1 -1
  324. package/dist/src/server/extensions/plugin-env.js +10 -4
  325. package/dist/src/server/extensions/types.d.ts +17 -0
  326. package/dist/src/server/extensions/types.js +1 -1
  327. package/dist/src/server/http/HttpMiddleware.js +1 -1
  328. package/dist/src/server/instrumentation/EvidenceGraphBridge.d.ts +13 -0
  329. package/dist/src/server/instrumentation/EvidenceGraphBridge.js +150 -0
  330. package/dist/src/server/instrumentation/InstrumentationSession.d.ts +60 -0
  331. package/dist/src/server/instrumentation/InstrumentationSession.js +269 -0
  332. package/dist/src/server/instrumentation/index.d.ts +2 -0
  333. package/dist/src/server/instrumentation/index.js +2 -0
  334. package/dist/src/server/instrumentation/types.d.ts +62 -0
  335. package/dist/src/server/instrumentation/types.js +7 -0
  336. package/dist/src/server/macros/MacroConfigLoader.d.ts +6 -5
  337. package/dist/src/server/macros/MacroConfigLoader.js +61 -59
  338. package/dist/src/server/macros/MacroRunner.js +6 -2
  339. package/dist/src/server/macros/builtins/index.d.ts +2 -3
  340. package/dist/src/server/macros/builtins/index.js +51 -7
  341. package/dist/src/server/plugins/PluginContract.d.ts +1 -1
  342. package/dist/src/server/registry/contracts.d.ts +7 -1
  343. package/dist/src/server/registry/discovery.js +5 -4
  344. package/dist/src/server/registry/ensure-browser-core.js +0 -3
  345. package/dist/src/server/registry/index.js +4 -4
  346. package/dist/src/server/registry/tool-builder.d.ts +46 -0
  347. package/dist/src/server/registry/tool-builder.js +105 -0
  348. package/dist/src/server/sandbox/MCPBridge.d.ts +9 -0
  349. package/dist/src/server/sandbox/MCPBridge.js +22 -0
  350. package/dist/src/server/sandbox/QuickJSSandbox.d.ts +4 -1
  351. package/dist/src/server/sandbox/QuickJSSandbox.js +162 -2
  352. package/dist/src/server/sandbox/types.d.ts +13 -0
  353. package/dist/src/server/search/AffinityGraph.d.ts +7 -1
  354. package/dist/src/server/search/AffinityGraph.js +24 -3
  355. package/dist/src/server/search/EmbeddingWorker.js +5 -3
  356. package/dist/src/server/search/FeedbackTracker.d.ts +9 -0
  357. package/dist/src/server/search/FeedbackTracker.js +26 -0
  358. package/dist/src/server/search/QueryNormalizer.d.ts +6 -0
  359. package/dist/src/server/search/QueryNormalizer.js +94 -0
  360. package/dist/src/server/search/ToolSearchEngineImpl.d.ts +2 -3
  361. package/dist/src/server/search/ToolSearchEngineImpl.js +38 -88
  362. package/dist/src/server/workflows/WorkflowContract.d.ts +24 -0
  363. package/dist/src/server/workflows/WorkflowContract.js +12 -0
  364. package/dist/src/server/workflows/WorkflowEngine.d.ts +1 -0
  365. package/dist/src/server/workflows/WorkflowEngine.js +136 -3
  366. package/dist/src/types/config.d.ts +0 -14
  367. package/dist/src/types/deobfuscator.d.ts +0 -1
  368. package/dist/src/types/index.d.ts +1 -1
  369. package/dist/src/utils/DetailedDataManager.js +2 -0
  370. package/dist/src/utils/RingBuffer.js +5 -5
  371. package/dist/src/utils/TokenBudgetManager.js +1 -1
  372. package/dist/src/utils/UnifiedCacheManager.d.ts +1 -1
  373. package/dist/src/utils/UnifiedCacheManager.js +3 -3
  374. package/dist/src/utils/artifactRetention.js +2 -2
  375. package/dist/src/utils/betterSqlite3.d.ts +11 -0
  376. package/dist/src/utils/betterSqlite3.js +88 -0
  377. package/dist/src/utils/browserExecutable.js +2 -2
  378. package/dist/src/utils/cliFastPath.js +17 -6
  379. package/dist/src/utils/config.js +4 -26
  380. package/dist/src/utils/environmentDoctor.js +138 -11
  381. package/dist/src/utils/outputPaths.js +16 -9
  382. package/dist/src/utils/parallel.js +1 -3
  383. package/package.json +76 -72
  384. package/scripts/postinstall.cjs +37 -37
  385. package/src/native/scripts/linux/enum-windows.sh +12 -12
  386. package/src/native/scripts/macos/enum-windows.applescript +22 -22
  387. package/src/native/scripts/windows/enum-windows-by-class.ps1 +51 -51
  388. package/src/native/scripts/windows/enum-windows.ps1 +44 -44
  389. package/src/native/scripts/windows/inject-dll.ps1 +21 -21
  390. package/workflows/.gitkeep +0 -0
  391. package/dist/src/modules/analyzer/AISummarizer.d.ts +0 -39
  392. package/dist/src/modules/analyzer/AISummarizer.js +0 -122
  393. package/dist/src/modules/hook/AIHookGenerator.d.ts +0 -52
  394. package/dist/src/modules/hook/AIHookGenerator.js +0 -360
  395. package/dist/src/modules/hook/AIHookGeneratorTemplates.d.ts +0 -9
  396. package/dist/src/modules/hook/AIHookGeneratorTemplates.js +0 -157
  397. package/dist/src/server/macros/builtins/deobfuscate-ast-flow.d.ts +0 -2
  398. package/dist/src/server/macros/builtins/deobfuscate-ast-flow.js +0 -25
  399. package/dist/src/server/macros/builtins/unpacker-flow.d.ts +0 -2
  400. package/dist/src/server/macros/builtins/unpacker-flow.js +0 -25
  401. package/dist/src/services/LLMService.d.ts +0 -37
  402. package/dist/src/services/LLMService.js +0 -233
  403. package/dist/src/services/prompts/analysis.d.ts +0 -9
  404. package/dist/src/services/prompts/analysis.js +0 -158
  405. package/dist/src/services/prompts/crypto.d.ts +0 -2
  406. package/dist/src/services/prompts/crypto.js +0 -108
  407. package/dist/src/services/prompts/deobfuscation.d.ts +0 -6
  408. package/dist/src/services/prompts/deobfuscation.js +0 -300
  409. package/dist/src/services/prompts/environment.d.ts +0 -16
  410. package/dist/src/services/prompts/environment.js +0 -372
  411. package/dist/src/services/prompts/intelligence.d.ts +0 -4
  412. package/dist/src/services/prompts/intelligence.js +0 -250
  413. package/dist/src/services/prompts/taint.d.ts +0 -2
  414. package/dist/src/services/prompts/taint.js +0 -54
@@ -213,6 +213,19 @@ export function GetModuleBaseName(hProcess, hModule, maxSize = 260) {
213
213
  }
214
214
  return buffer.toString('utf8', 0, len);
215
215
  }
216
+ export function GetModuleFileNameEx(hProcess, hModule, maxSize = 32_768) {
217
+ const fn = getPsapi().func('uint32 GetModuleFileNameExA(void *, void *, _Out_ char[], uint32)');
218
+ const buffer = Buffer.alloc(maxSize);
219
+ const result = fn(hProcess, hModule, buffer, maxSize);
220
+ if (typeof result !== 'number' || result <= 0) {
221
+ return null;
222
+ }
223
+ let len = 0;
224
+ while (len < maxSize && buffer[len] !== 0) {
225
+ len++;
226
+ }
227
+ return len > 0 ? buffer.toString('utf8', 0, len) : null;
228
+ }
216
229
  export function GetModuleInformation(hProcess, hModule) {
217
230
  const fn = getPsapi().func('int GetModuleInformation(void *, void *, _Out_ uint8_t[24], uint32)');
218
231
  const buffer = Buffer.alloc(24);
@@ -1,6 +1,6 @@
1
1
  import koffi from 'koffi';
2
2
  import { logger } from '../utils/logger.js';
3
- import { GetLastError } from './Win32API.js';
3
+ import { GetLastError, CloseHandle } from './Win32API.js';
4
4
  export const THREAD_ACCESS = {
5
5
  TERMINATE: 0x0001,
6
6
  SUSPEND_RESUME: 0x0002,
@@ -70,18 +70,18 @@ export function parseContext(buf) {
70
70
  rdx: buf.readBigUInt64LE(0x88),
71
71
  rbx: buf.readBigUInt64LE(0x90),
72
72
  rsp: buf.readBigUInt64LE(0x98),
73
- rbp: buf.readBigUInt64LE(0xA0),
74
- rsi: buf.readBigUInt64LE(0xA8),
75
- rdi: buf.readBigUInt64LE(0xB0),
76
- r8: buf.readBigUInt64LE(0xB8),
77
- r9: buf.readBigUInt64LE(0xC0),
78
- r10: buf.readBigUInt64LE(0xC8),
79
- r11: buf.readBigUInt64LE(0xD0),
80
- r12: buf.readBigUInt64LE(0xD8),
81
- r13: buf.readBigUInt64LE(0xE0),
82
- r14: buf.readBigUInt64LE(0xE8),
83
- r15: buf.readBigUInt64LE(0xF0),
84
- rip: buf.readBigUInt64LE(0xF8),
73
+ rbp: buf.readBigUInt64LE(0xa0),
74
+ rsi: buf.readBigUInt64LE(0xa8),
75
+ rdi: buf.readBigUInt64LE(0xb0),
76
+ r8: buf.readBigUInt64LE(0xb8),
77
+ r9: buf.readBigUInt64LE(0xc0),
78
+ r10: buf.readBigUInt64LE(0xc8),
79
+ r11: buf.readBigUInt64LE(0xd0),
80
+ r12: buf.readBigUInt64LE(0xd8),
81
+ r13: buf.readBigUInt64LE(0xe0),
82
+ r14: buf.readBigUInt64LE(0xe8),
83
+ r15: buf.readBigUInt64LE(0xf0),
84
+ rip: buf.readBigUInt64LE(0xf8),
85
85
  };
86
86
  }
87
87
  export function writeContext(buf, ctx) {
@@ -102,7 +102,7 @@ export function writeContext(buf, ctx) {
102
102
  if (ctx.dr7 !== undefined)
103
103
  buf.writeBigUInt64LE(ctx.dr7, 0x70);
104
104
  if (ctx.rip !== undefined)
105
- buf.writeBigUInt64LE(ctx.rip, 0xF8);
105
+ buf.writeBigUInt64LE(ctx.rip, 0xf8);
106
106
  }
107
107
  let kernel32Debug = null;
108
108
  function getKernel32() {
@@ -119,7 +119,7 @@ export function OpenThread(dwDesiredAccess, bInheritHandle, dwThreadId) {
119
119
  export function SuspendThread(hThread) {
120
120
  const fn = getKernel32().func('uint32 SuspendThread(void *)');
121
121
  const result = fn(hThread);
122
- if (result === 0xFFFFFFFF) {
122
+ if (result === 0xffffffff) {
123
123
  throw new Error(`SuspendThread failed. Error: 0x${GetLastError().toString(16)}`);
124
124
  }
125
125
  return result;
@@ -127,7 +127,7 @@ export function SuspendThread(hThread) {
127
127
  export function ResumeThread(hThread) {
128
128
  const fn = getKernel32().func('uint32 ResumeThread(void *)');
129
129
  const result = fn(hThread);
130
- if (result === 0xFFFFFFFF) {
130
+ if (result === 0xffffffff) {
131
131
  throw new Error(`ResumeThread failed. Error: 0x${GetLastError().toString(16)}`);
132
132
  }
133
133
  return result;
@@ -209,10 +209,9 @@ export function EnumerateProcessThreads(pid) {
209
209
  const entry = Buffer.alloc(28);
210
210
  entry.writeUInt32LE(28, 0);
211
211
  try {
212
- const { CloseHandle } = require('./Win32API.js');
213
212
  if (fnFirst(snapshot, entry) !== 0) {
214
213
  do {
215
- const ownerPid = entry.readUInt32LE(0x0C);
214
+ const ownerPid = entry.readUInt32LE(0x0c);
216
215
  if (ownerPid === pid) {
217
216
  threads.push(entry.readUInt32LE(0x08));
218
217
  }
@@ -221,7 +220,8 @@ export function EnumerateProcessThreads(pid) {
221
220
  }
222
221
  CloseHandle(snapshot);
223
222
  }
224
- catch {
223
+ catch (e) {
224
+ console.error('[EnumerateProcessThreads] cleanup error:', e);
225
225
  }
226
226
  return threads;
227
227
  }
@@ -115,6 +115,8 @@ export declare function machVmAllocate(task: number, size: bigint, flags: number
115
115
  address: bigint;
116
116
  };
117
117
  export declare function machVmDeallocate(task: number, address: bigint, size: bigint): number;
118
+ export declare function taskSuspend(task: number): number;
119
+ export declare function taskResume(task: number): number;
118
120
  export declare function dyldImageCount(): number;
119
121
  export declare function dyldGetImageName(index: number): string;
120
122
  export declare function dyldGetImageVmaddrSlide(index: number): bigint;
@@ -198,6 +198,14 @@ export function machVmDeallocate(task, address, size) {
198
198
  const fn = getLibSystem().func('int32 mach_vm_deallocate(uint32, uint64, uint64)');
199
199
  return fn(task, address, size);
200
200
  }
201
+ export function taskSuspend(task) {
202
+ const fn = getLibSystem().func('int32 task_suspend(uint32)');
203
+ return fn(task);
204
+ }
205
+ export function taskResume(task) {
206
+ const fn = getLibSystem().func('int32 task_resume(uint32)');
207
+ return fn(task);
208
+ }
201
209
  export function dyldImageCount() {
202
210
  const fn = getLibSystem().func('uint32 _dyld_image_count()');
203
211
  return fn();
@@ -68,9 +68,14 @@ export class DarwinMemoryProvider {
68
68
  }
69
69
  }
70
70
  catch (err) {
71
+ const message = err instanceof Error ? err.message : String(err);
72
+ const isCrash = /signal|bus error|segfault|abort/i.test(message);
71
73
  return {
72
74
  available: false,
73
- reason: `task_for_pid permission check failed: ${err instanceof Error ? err.message : String(err)}`,
75
+ reason: isCrash
76
+ ? `Mach API call crashed (${message}). This may be caused by SIP (System Integrity Protection) on ARM64 macOS. ` +
77
+ 'Disable SIP or use a code-signed binary with com.apple.security.cs.debugger entitlement.'
78
+ : `task_for_pid permission check failed: ${message}. Run with sudo or add debugger entitlement.`,
74
79
  platform: 'darwin',
75
80
  };
76
81
  }
@@ -61,7 +61,6 @@ export interface DomainInstances {
61
61
  debuggerManager?: import('../modules/debugger/DebuggerManager.js').DebuggerManager;
62
62
  runtimeInspector?: import('../modules/debugger/RuntimeInspector.js').RuntimeInspector;
63
63
  consoleMonitor?: import('../modules/monitor/ConsoleMonitor.js').ConsoleMonitor;
64
- llm?: import('../services/LLMService.js').LLMService;
65
64
  browserHandlers?: import('./domains/browser/index.js').BrowserToolHandlers;
66
65
  debuggerHandlers?: import('./domains/debugger/index.js').DebuggerToolHandlers;
67
66
  advancedHandlers?: import('./domains/network/index.js').AdvancedToolHandlers;
@@ -90,6 +89,8 @@ export interface DomainInstances {
90
89
  coordinationHandlers?: import('./domains/coordination/index.js').CoordinationHandlers;
91
90
  traceRecorder?: import('../modules/trace/TraceRecorder.js').TraceRecorder;
92
91
  traceHandlers?: import('./domains/trace/index.js').TraceToolHandlers;
92
+ evidenceHandlers?: import('./domains/evidence/index.js').EvidenceHandlers;
93
+ instrumentationHandlers?: import('./domains/instrumentation/index.js').InstrumentationHandlers | undefined;
93
94
  }
94
95
  export interface ServerMethods {
95
96
  registerCaches(): Promise<void>;
@@ -55,7 +55,6 @@ export declare class MCPServer implements MCPServerContext {
55
55
  debuggerManager: import('../modules/debugger/DebuggerManager.js').DebuggerManager | undefined;
56
56
  runtimeInspector: import('../modules/debugger/RuntimeInspector.js').RuntimeInspector | undefined;
57
57
  consoleMonitor: import('../modules/monitor/ConsoleMonitor.js').ConsoleMonitor | undefined;
58
- llm: import('../services/LLMService.js').LLMService | undefined;
59
58
  browserHandlers: import('./domains/browser/index.js').BrowserToolHandlers | undefined;
60
59
  debuggerHandlers: import('./domains/debugger/index.js').DebuggerToolHandlers | undefined;
61
60
  advancedHandlers: import('./domains/network/index.js').AdvancedToolHandlers | undefined;
@@ -82,6 +81,8 @@ export declare class MCPServer implements MCPServerContext {
82
81
  sourcemapHandlers: import('./domains/sourcemap/index.js').SourcemapToolHandlers | undefined;
83
82
  transformHandlers: import('./domains/transform/index.js').TransformToolHandlers | undefined;
84
83
  coordinationHandlers: import('./domains/coordination/index.js').CoordinationHandlers | undefined;
84
+ evidenceHandlers: import('./domains/evidence/index.js').EvidenceHandlers | undefined;
85
+ instrumentationHandlers: import('./domains/instrumentation/index.js').InstrumentationHandlers | undefined;
85
86
  constructor(config: Config);
86
87
  resolveEnabledDomains(tools: Tool[]): Set<string>;
87
88
  registerSingleTool(toolDef: Tool): RegisteredTool;
@@ -1,4 +1,4 @@
1
1
  import type { Tool } from '@modelcontextprotocol/sdk/types.js';
2
2
  import type { MCPServerContext } from './MCPServer.context.js';
3
3
  export declare function resolveEnabledDomains(tools: Tool[]): Set<string>;
4
- export declare function createDomainProxy<T extends object>(ctx: MCPServerContext, domain: string, label: string, factory: () => T): T;
4
+ export declare function createDomainProxy<T extends object>(ctx: MCPServerContext, domain: string, label: string, factory: () => T | Promise<T>): T;
@@ -1,6 +1,11 @@
1
1
  import { logger } from '../utils/logger.js';
2
2
  import { getToolDomain } from './ToolCatalog.js';
3
3
  import { ToolError } from '../errors/ToolError.js';
4
+ function isPromiseLike(value) {
5
+ return ((typeof value === 'object' || typeof value === 'function') &&
6
+ value !== null &&
7
+ typeof value.then === 'function');
8
+ }
4
9
  export function resolveEnabledDomains(tools) {
5
10
  const domains = new Set();
6
11
  for (const tool of tools) {
@@ -12,30 +17,90 @@ export function resolveEnabledDomains(tools) {
12
17
  return domains;
13
18
  }
14
19
  export function createDomainProxy(ctx, domain, label, factory) {
20
+ const errorDetails = { domain, label };
21
+ let initPromise;
15
22
  let instance;
16
- let initializing = false;
23
+ let factoryKind = 'unknown';
24
+ let factoryDepth = 0;
25
+ function bindPropertyValue(targetInstance, prop) {
26
+ const value = targetInstance[prop];
27
+ return typeof value === 'function' ? value.bind(targetInstance) : value;
28
+ }
29
+ function initialize() {
30
+ if (instance)
31
+ return instance;
32
+ if (initPromise)
33
+ return initPromise;
34
+ if (factoryDepth > 0) {
35
+ throw new ToolError('RUNTIME', `${label}: circular initialization detected for domain "${domain}"`, { details: errorDetails });
36
+ }
37
+ logger.info(`Lazy-initializing ${label} for domain "${domain}"`);
38
+ factoryDepth++;
39
+ try {
40
+ const created = factory();
41
+ if (isPromiseLike(created)) {
42
+ factoryKind = 'async';
43
+ initPromise = Promise.resolve(created).then((resolvedInstance) => {
44
+ instance = resolvedInstance;
45
+ return resolvedInstance;
46
+ });
47
+ return initPromise;
48
+ }
49
+ factoryKind = 'sync';
50
+ instance = created;
51
+ initPromise = Promise.resolve(created);
52
+ return created;
53
+ }
54
+ finally {
55
+ factoryDepth--;
56
+ }
57
+ }
58
+ async function getOrCreateInstance() {
59
+ const created = initialize();
60
+ return isPromiseLike(created) ? await created : created;
61
+ }
62
+ function createAsyncPropertyAccessor(prop) {
63
+ const resolveProperty = () => getOrCreateInstance().then((resolvedInstance) => bindPropertyValue(resolvedInstance, prop));
64
+ const accessor = (...args) => getOrCreateInstance().then((resolvedInstance) => {
65
+ const value = resolvedInstance[prop];
66
+ if (typeof value === 'function') {
67
+ return value.call(resolvedInstance, ...args);
68
+ }
69
+ return value;
70
+ });
71
+ return new Proxy(accessor, {
72
+ get: (target, asyncProp, receiver) => {
73
+ if (asyncProp === 'then') {
74
+ return (...args) => resolveProperty().then(...args);
75
+ }
76
+ if (asyncProp === 'catch') {
77
+ return (...args) => resolveProperty().catch(...args);
78
+ }
79
+ if (asyncProp === 'finally') {
80
+ return (...args) => resolveProperty().finally(...args);
81
+ }
82
+ return Reflect.get(target, asyncProp, receiver);
83
+ },
84
+ });
85
+ }
17
86
  return new Proxy({}, {
18
87
  get: (_target, prop) => {
19
88
  if (!ctx.enabledDomains.has(domain)) {
20
89
  return () => {
21
- throw new ToolError('PREREQUISITE', `${label} is unavailable: domain "${domain}" not enabled by current tool profile`, { details: { domain, label } });
90
+ throw new ToolError('PREREQUISITE', `${label} is unavailable: domain "${domain}" not enabled by current tool profile`, { details: errorDetails });
22
91
  };
23
92
  }
24
- if (!instance) {
25
- if (initializing) {
26
- throw new ToolError('RUNTIME', `${label}: circular initialization detected for domain "${domain}"`, { details: { domain, label } });
27
- }
28
- initializing = true;
29
- try {
30
- logger.info(`Lazy-initializing ${label} for domain "${domain}"`);
31
- instance = factory();
32
- }
33
- finally {
34
- initializing = false;
35
- }
93
+ if (prop === 'then' || prop === 'catch' || prop === Symbol.toStringTag) {
94
+ return undefined;
95
+ }
96
+ if (instance && factoryKind === 'sync') {
97
+ return bindPropertyValue(instance, prop);
98
+ }
99
+ const created = initialize();
100
+ if (isPromiseLike(created)) {
101
+ return createAsyncPropertyAccessor(prop);
36
102
  }
37
- const value = instance[prop];
38
- return typeof value === 'function' ? value.bind(instance) : value;
103
+ return bindPropertyValue(created, prop);
39
104
  },
40
105
  });
41
106
  }
@@ -13,8 +13,10 @@ import { resolveToolsForRegistration } from './MCPServer.registration.js';
13
13
  import { createDomainProxy, resolveEnabledDomains } from './MCPServer.domain.js';
14
14
  import { refreshDomainTtlForTool } from './MCPServer.activation.ttl.js';
15
15
  import { closeServer, startHttpTransport, startStdioTransport } from './MCPServer.transport.js';
16
+ import { ActivationController } from './activation/ActivationController.js';
16
17
  import { registerSingleTool as registerSingleToolImpl } from './MCPServer.tools.js';
17
18
  import { registerSearchMetaTools } from './MCPServer.search.js';
19
+ import { registerServerResources } from './MCPServer.resources.js';
18
20
  import { createServerEventBus } from './EventBus.js';
19
21
  import { getAllManifests } from './registry/index.js';
20
22
  import { listExtensions as listExtensionsImpl, reloadExtensions as reloadExtensionsImpl, } from './extensions/ExtensionManager.js';
@@ -81,8 +83,8 @@ export class MCPServer {
81
83
  if (!depsEntries.some(([k]) => k === key)) {
82
84
  depsEntries.push([
83
85
  key,
84
- createDomainProxy(this, m.domain, `${m.domain}:${key}`, () => {
85
- m.ensure(this);
86
+ createDomainProxy(this, m.domain, `${m.domain}:${key}`, async () => {
87
+ await m.ensure(this);
86
88
  return this[key];
87
89
  }),
88
90
  ]);
@@ -101,6 +103,7 @@ export class MCPServer {
101
103
  return null;
102
104
  });
103
105
  this.server = new McpServer({ name: config.mcp.name, version: config.mcp.version }, { capabilities: { tools: { listChanged: true }, logging: {} } });
106
+ this.setDomainInstance('activationController', new ActivationController(this.eventBus, this));
104
107
  this.registerTools();
105
108
  }
106
109
  resolveEnabledDomains(tools) {
@@ -153,6 +156,7 @@ export class MCPServer {
153
156
  async executeToolWithTracking(name, args) {
154
157
  try {
155
158
  const response = await this.router.execute(name, args);
159
+ this.contextGuard.recordCall(name);
156
160
  const enriched = this.contextGuard.enrichResponse(name, response);
157
161
  try {
158
162
  this.tokenBudget.recordToolCall(name, args, enriched);
@@ -209,22 +213,46 @@ export class MCPServer {
209
213
  this.registerSingleTool(toolDef);
210
214
  }
211
215
  registerSearchMetaTools(this);
216
+ registerServerResources(this);
212
217
  logger.info(`Registered ${this.selectedTools.length} tools + meta tools with McpServer`);
213
218
  }
214
219
  }
215
220
  const DOMAIN_INSTANCE_KEYS = [
216
- 'collector', 'pageController', 'domInspector',
217
- 'scriptManager', 'debuggerManager', 'runtimeInspector',
218
- 'consoleMonitor', 'llm',
219
- 'browserHandlers', 'debuggerHandlers', 'advancedHandlers',
220
- 'aiHookHandlers', 'hookPresetHandlers',
221
- 'deobfuscator', 'advancedDeobfuscator', 'astOptimizer',
222
- 'obfuscationDetector', 'analyzer', 'cryptoDetector', 'hookManager',
223
- 'coreAnalysisHandlers', 'coreMaintenanceHandlers', 'extensionManagementHandlers',
224
- 'processHandlers', 'workflowHandlers', 'wasmHandlers',
225
- 'streamingHandlers', 'encodingHandlers', 'antidebugHandlers',
226
- 'graphqlHandlers', 'platformHandlers', 'sourcemapHandlers',
227
- 'transformHandlers', 'coordinationHandlers',
221
+ 'collector',
222
+ 'pageController',
223
+ 'domInspector',
224
+ 'scriptManager',
225
+ 'debuggerManager',
226
+ 'runtimeInspector',
227
+ 'consoleMonitor',
228
+ 'browserHandlers',
229
+ 'debuggerHandlers',
230
+ 'advancedHandlers',
231
+ 'aiHookHandlers',
232
+ 'hookPresetHandlers',
233
+ 'deobfuscator',
234
+ 'advancedDeobfuscator',
235
+ 'astOptimizer',
236
+ 'obfuscationDetector',
237
+ 'analyzer',
238
+ 'cryptoDetector',
239
+ 'hookManager',
240
+ 'coreAnalysisHandlers',
241
+ 'coreMaintenanceHandlers',
242
+ 'extensionManagementHandlers',
243
+ 'processHandlers',
244
+ 'workflowHandlers',
245
+ 'wasmHandlers',
246
+ 'streamingHandlers',
247
+ 'encodingHandlers',
248
+ 'antidebugHandlers',
249
+ 'graphqlHandlers',
250
+ 'platformHandlers',
251
+ 'sourcemapHandlers',
252
+ 'transformHandlers',
253
+ 'coordinationHandlers',
254
+ 'evidenceHandlers',
255
+ 'instrumentationHandlers',
228
256
  ];
229
257
  for (const key of DOMAIN_INSTANCE_KEYS) {
230
258
  if (key === 'domainInstanceMap' || key === 'getDomainInstance' || key === 'setDomainInstance')
@@ -0,0 +1,2 @@
1
+ import type { MCPServerContext } from './MCPServer.context.js';
2
+ export declare function registerServerResources(ctx: MCPServerContext): void;
@@ -0,0 +1,91 @@
1
+ import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ function asJsonResource(uri, payload) {
3
+ return {
4
+ contents: [
5
+ {
6
+ uri,
7
+ mimeType: 'application/json',
8
+ text: JSON.stringify(payload, null, 2),
9
+ },
10
+ ],
11
+ };
12
+ }
13
+ function asTextResource(uri, text, mimeType) {
14
+ return {
15
+ contents: [
16
+ {
17
+ uri,
18
+ mimeType,
19
+ text,
20
+ },
21
+ ],
22
+ };
23
+ }
24
+ function getEvidenceGraph(ctx) {
25
+ return ctx.getDomainInstance('evidenceGraph');
26
+ }
27
+ function getSessionManager(ctx) {
28
+ return ctx.getDomainInstance('instrumentationSessionManager');
29
+ }
30
+ export function registerServerResources(ctx) {
31
+ ctx.server.registerResource('evidence_graph_json', 'jshook://evidence/graph', {
32
+ title: 'Evidence Graph JSON',
33
+ description: 'Serializable snapshot of the current reverse evidence graph.',
34
+ mimeType: 'application/json',
35
+ }, async (uri) => {
36
+ const graph = getEvidenceGraph(ctx);
37
+ return asJsonResource(uri.toString(), graph
38
+ ? graph.exportJson()
39
+ : { version: 1, nodes: [], edges: [], exportedAt: new Date().toISOString() });
40
+ });
41
+ ctx.server.registerResource('evidence_graph_markdown', 'jshook://evidence/graph.md', {
42
+ title: 'Evidence Graph Markdown',
43
+ description: 'Markdown report for the current reverse evidence graph.',
44
+ mimeType: 'text/markdown',
45
+ }, async (uri) => {
46
+ const graph = getEvidenceGraph(ctx);
47
+ return asTextResource(uri.toString(), graph
48
+ ? graph.exportMarkdown()
49
+ : '# Reverse Evidence Graph Report\n\nNo evidence graph is available.\n', 'text/markdown');
50
+ });
51
+ ctx.server.registerResource('instrumentation_sessions', 'jshook://instrumentation/sessions', {
52
+ title: 'Instrumentation Sessions',
53
+ description: 'Expanded snapshots for all active instrumentation sessions.',
54
+ mimeType: 'application/json',
55
+ }, async (uri) => {
56
+ const manager = getSessionManager(ctx);
57
+ return asJsonResource(uri.toString(), manager ? manager.listSessionSnapshots() : []);
58
+ });
59
+ const sessionTemplate = new ResourceTemplate('jshook://instrumentation/session/{sessionId}', {
60
+ list: async () => {
61
+ const manager = getSessionManager(ctx);
62
+ return {
63
+ resources: (manager?.listSessions() ?? []).map((session) => ({
64
+ name: session.name || `Instrumentation Session ${session.id}`,
65
+ uri: `jshook://instrumentation/session/${session.id}`,
66
+ mimeType: 'application/json',
67
+ description: `operations=${session.operationCount}, artifacts=${session.artifactCount}, status=${session.status}`,
68
+ })),
69
+ };
70
+ },
71
+ complete: {
72
+ sessionId: async () => {
73
+ const manager = getSessionManager(ctx);
74
+ return (manager?.listSessions() ?? []).map((session) => session.id);
75
+ },
76
+ },
77
+ });
78
+ ctx.server.registerResource('instrumentation_session_snapshot', sessionTemplate, {
79
+ title: 'Instrumentation Session Snapshot',
80
+ description: 'Expanded snapshot for a single instrumentation session.',
81
+ mimeType: 'application/json',
82
+ }, async (uri, variables) => {
83
+ const sessionId = String(variables['sessionId'] ?? '');
84
+ const manager = getSessionManager(ctx);
85
+ const snapshot = manager?.getSessionSnapshot(sessionId);
86
+ return asJsonResource(uri.toString(), snapshot ?? {
87
+ success: false,
88
+ error: `Instrumentation session "${sessionId}" not found`,
89
+ });
90
+ });
91
+ }
@@ -76,7 +76,8 @@ export async function handleCallTool(ctx, args) {
76
76
  const engine = getSearchEngine(ctx);
77
77
  engine.recordToolCallFeedback(name, '');
78
78
  }
79
- catch { }
79
+ catch {
80
+ }
80
81
  return attachCallToolMetadata(response, callMetadata);
81
82
  }
82
83
  catch (error) {
@@ -37,7 +37,7 @@ export function buildSearchSignature(ctx) {
37
37
  export function getSearchEngine(ctx) {
38
38
  const signature = buildSearchSignature(ctx);
39
39
  const cached = searchEngineCache.get(ctx);
40
- if (cached && cached.signature === signature)
40
+ if (cached?.signature === signature)
41
41
  return cached.engine;
42
42
  const tools = getCombinedTools(ctx);
43
43
  const extensionDomains = getExtensionDomainMap(ctx);
@@ -65,7 +65,7 @@ export function buildDomainDescription(ctx) {
65
65
  }
66
66
  const totalTools = getAllRegistrations().length + ctx.extensionToolsByName.size;
67
67
  const parts = Object.entries(groups)
68
- .sort((a, b) => b[1] - a[1])
68
+ .toSorted((a, b) => b[1] - a[1])
69
69
  .map(([domain, count]) => `${domain} (${count})`)
70
70
  .join(' | ');
71
71
  return (`Search ${totalTools} tools across ${Object.keys(groups).length} capability domains. ` +
@@ -1,4 +1,4 @@
1
- import { z } from 'zod';
1
+ import {} from 'zod';
2
2
  import { logger } from '../utils/logger.js';
3
3
  import { asErrorResponse, toolErrorToResponse } from './domains/shared/response.js';
4
4
  import { ToolError } from '../errors/ToolError.js';
@@ -119,6 +119,18 @@ export async function closeServer(ctx) {
119
119
  }
120
120
  ctx.domainTtlEntries.clear();
121
121
  ctx.detailedData.shutdown();
122
+ const activationController = typeof ctx.getDomainInstance === 'function'
123
+ ? ctx.getDomainInstance('activationController')
124
+ : (ctx
125
+ .activationController ?? undefined);
126
+ if (activationController && typeof activationController.dispose === 'function') {
127
+ try {
128
+ activationController.dispose();
129
+ }
130
+ catch (error) {
131
+ logger.warn('activationController cleanup failed:', error);
132
+ }
133
+ }
122
134
  if (ctx.httpServer) {
123
135
  const httpServer = ctx.httpServer;
124
136
  const closePromise = new Promise((resolve) => httpServer.close(() => resolve()));
@@ -9,12 +9,17 @@ interface TabContextProvider {
9
9
  export declare class ToolCallContextGuard {
10
10
  private getProvider;
11
11
  private readonly contextSensitiveCache;
12
+ private lastToolName;
13
+ private consecutiveCount;
12
14
  constructor(getProvider: () => TabContextProvider | null);
13
15
  isContextSensitive(toolName: string): boolean;
16
+ recordCall(toolName: string): number;
17
+ isRepeatLoop(): boolean;
14
18
  enrichResponse<T extends {
15
19
  content?: unknown[];
16
20
  isError?: boolean;
17
21
  }>(toolName: string, response: T): T;
18
22
  private spliceTabContext;
23
+ private injectRepeatWarning;
19
24
  }
20
25
  export {};