rea-agents 3.0.0 → 3.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (628) hide show
  1. package/README.md +83 -108
  2. package/bridge/ghidra/ReaGhidraBridge.java +609 -841
  3. package/bridge/hopper_bridge.py +99 -344
  4. package/dist/application/AbortablePromise.js +6 -3
  5. package/dist/application/AnalysisContextQueries.js +21 -9
  6. package/dist/application/AnalysisSnapshotCache.js +0 -1
  7. package/dist/application/AnalysisSnapshotFiles.js +7 -7
  8. package/dist/application/AndroidApplicationService.js +1 -1
  9. package/dist/application/AppleApplicationService.js +1 -1
  10. package/dist/application/ArtifactExtraction.js +35 -54
  11. package/dist/application/ArtifactExtractionDestination.js +17 -0
  12. package/dist/application/ArtifactGraphConstruction.js +2 -17
  13. package/dist/application/ArtifactInventory/classify.js +2 -6
  14. package/dist/application/ArtifactInventory/hash.js +2 -20
  15. package/dist/application/ArtifactInventory/policy.js +17 -0
  16. package/dist/application/ArtifactInventory/reader.js +1 -4
  17. package/dist/application/ArtifactInventory/scanCanonical.js +8 -15
  18. package/dist/application/ArtifactInventory/scanReader.js +76 -58
  19. package/dist/application/ArtifactInventory/types.js +1 -5
  20. package/dist/application/ArtifactInventory.js +6 -14
  21. package/dist/application/AuthorizedArtifactInventory.js +3 -13
  22. package/dist/application/BinarySession.js +54 -28
  23. package/dist/application/BinarySessionComposition.js +0 -11
  24. package/dist/application/BinarySessionOpen.js +2 -1
  25. package/dist/application/BinarySessionRecords.js +24 -86
  26. package/dist/application/BinarySessionStatus.js +16 -21
  27. package/dist/application/BinaryTargetResolver.js +216 -0
  28. package/dist/application/BrowserEvidence.js +39 -57
  29. package/dist/application/BrowserObservationService.js +3 -6
  30. package/dist/application/BrowserScenarioCaptureService.js +3 -6
  31. package/dist/application/BrowserScenarioEvidence.js +3 -3
  32. package/dist/application/CallPathTracing.js +2 -36
  33. package/dist/application/CapabilityClientRequirements.js +26 -0
  34. package/dist/application/CapabilityInventory.js +143 -77
  35. package/dist/application/ClientConfigurationDocument.js +27 -0
  36. package/dist/application/ClientRegistrationStatus.js +16 -13
  37. package/dist/application/CommandShimReplay.js +14 -1
  38. package/dist/application/DirectAnalysis.js +22 -46
  39. package/dist/application/DirectAnalysisStatus.js +5 -61
  40. package/dist/application/Doctor.js +11 -32
  41. package/dist/application/DoctorDiagnostics.js +1 -2
  42. package/dist/application/DoctorScope.js +1 -1
  43. package/dist/application/ElectronActiveEvidence.js +50 -0
  44. package/dist/application/ElectronActiveObservationPort.js +1 -0
  45. package/dist/application/ElectronActiveObservationService.js +78 -0
  46. package/dist/application/ElectronBoundaryAnalysis.js +7 -8
  47. package/dist/application/ElectronBoundaryGraphContext.js +1 -1
  48. package/dist/application/ElectronBoundaryGraphIpc.js +3 -3
  49. package/dist/application/ElectronBoundaryGraphNative.js +1 -2
  50. package/dist/application/ElectronBoundaryGraphWindows.js +6 -8
  51. package/dist/application/ElectronEvidence.js +4 -7
  52. package/dist/application/ElectronObservationService.js +5 -9
  53. package/dist/application/EnhancedLiteralTracing.js +42 -65
  54. package/dist/application/EnhancedTools.js +98 -64
  55. package/dist/application/EvidenceBundleCommands.js +16 -12
  56. package/dist/application/EvidenceBundleFiles.js +9 -15
  57. package/dist/application/EvidenceLedger.js +14 -42
  58. package/dist/application/FilesystemSnapshot.js +2 -3
  59. package/dist/application/InterfaceBuilderAnalysis.js +266 -0
  60. package/dist/application/InventoryProjectionEvidence.js +4 -2
  61. package/dist/application/InvestigationProviders.js +1 -1
  62. package/dist/application/JavaScriptApplicationEvidence.js +2 -5
  63. package/dist/application/JavaScriptApplicationEvidenceGraph.js +6 -10
  64. package/dist/application/JavaScriptApplicationService.js +6 -29
  65. package/dist/application/JavaScriptApplicationWorkflowEvidence.js +5 -5
  66. package/dist/application/JavaScriptApplicationWorkflowService.js +0 -8
  67. package/dist/application/JavaScriptArtifactAnalysis.js +38 -127
  68. package/dist/application/JavaScriptArtifactFiles.js +67 -107
  69. package/dist/application/JavaScriptArtifactGraphAccumulator.js +0 -7
  70. package/dist/application/JavaScriptArtifactGraphBuilder.js +7 -58
  71. package/dist/application/JavaScriptArtifactGraphBundlers.js +1 -6
  72. package/dist/application/JavaScriptArtifactGraphContext.js +12 -39
  73. package/dist/application/JavaScriptArtifactGraphDocuments.js +4 -11
  74. package/dist/application/JavaScriptArtifactGraphEvidence.js +0 -14
  75. package/dist/application/JavaScriptArtifactGraphFindings.js +3 -3
  76. package/dist/application/JavaScriptArtifactGraphStructure.js +16 -17
  77. package/dist/application/JavaScriptArtifactPathResolution.js +61 -49
  78. package/dist/application/JavaScriptArtifactReconstruction.js +5 -10
  79. package/dist/application/JavaScriptArtifactReconstructionInput.js +2 -14
  80. package/dist/application/JavaScriptJsonModules.js +2 -2
  81. package/dist/application/JavaScriptModuleRelationships.js +22 -27
  82. package/dist/application/JavaScriptReplayPermission.js +1 -1
  83. package/dist/application/JavaScriptReplayPlanning.js +9 -3
  84. package/dist/application/JavaScriptReplayService.js +29 -47
  85. package/dist/application/JavaScriptReturnShapeProjection.js +12 -42
  86. package/dist/application/JavaScriptRuntimeObservationEvidence.js +7 -8
  87. package/dist/application/JavaScriptRuntimeObservationService.js +4 -8
  88. package/dist/application/JavaScriptRuntimeReconciliationEvidence.js +2 -3
  89. package/dist/application/JavaScriptSemanticGraphBuilder.js +11 -41
  90. package/dist/application/JavaScriptSemanticGraphConstruction.js +5 -29
  91. package/dist/application/JavaScriptSemanticGraphEvidence.js +1 -1
  92. package/dist/application/JavaScriptSemanticGraphFingerprintProjection.js +1 -1
  93. package/dist/application/JavaScriptSemanticGraphFlowProjection.js +0 -13
  94. package/dist/application/JavaScriptSemanticGraphProjection.js +1 -3
  95. package/dist/application/JavaScriptSemanticTraceService.js +1 -10
  96. package/dist/application/JsonFiles.js +79 -0
  97. package/dist/application/LinuxHopper.js +11 -9
  98. package/dist/application/LoopbackReplay.js +26 -23
  99. package/dist/application/LoopbackReplayRecorder.js +29 -1
  100. package/dist/application/ManagedApplicationGraphService.js +1 -2
  101. package/dist/application/ManagedMemberComparisonService.js +11 -41
  102. package/dist/application/ManagedNativeVerificationService.js +1 -2
  103. package/dist/application/ManagedReconstructionService.js +1 -1
  104. package/dist/application/ManagedRuntimeCorrelationService.js +14 -13
  105. package/dist/application/NativeApiInspection.js +2 -7
  106. package/dist/application/NativeUiActionTrace.js +394 -0
  107. package/dist/application/NodeRuntimeCharacterizationService.js +11 -16
  108. package/dist/application/PermissionAuthority.js +15 -7
  109. package/dist/application/PermissionFailure.js +5 -0
  110. package/dist/application/ProcessCaptureAuthority.js +5 -7
  111. package/dist/application/ProcessCaptureJournal.js +3 -2
  112. package/dist/application/ProcessCaptureLifecycle.js +10 -12
  113. package/dist/application/ProcessCheckpoints.js +29 -11
  114. package/dist/application/ProcessCli.js +8 -17
  115. package/dist/application/ProcessEvidence.js +5 -7
  116. package/dist/application/ProcessHarness.js +60 -20
  117. package/dist/application/ProcessNormalization.js +2 -1
  118. package/dist/application/ProcessReactiveCoordinator.js +2 -4
  119. package/dist/application/ProcessReactiveEffects.js +9 -3
  120. package/dist/application/ProcessReactiveHarness.js +13 -7
  121. package/dist/application/ProcessSampling.js +2 -4
  122. package/dist/application/ProcessTimer.js +39 -0
  123. package/dist/application/ProjectPermissionStore.js +39 -95
  124. package/dist/application/RealHopperAssertions.js +20 -66
  125. package/dist/application/ReconstructionCoverageService.js +12 -58
  126. package/dist/application/ReconstructionObligationAuthority.js +2 -2
  127. package/dist/application/ReconstructionObligationCandidates.js +4 -4
  128. package/dist/application/ReconstructionObligationLedgerEvaluation.js +8 -15
  129. package/dist/application/ReconstructionObligationLedgerProjection.js +3 -7
  130. package/dist/application/ReconstructionObligationLedgerService.js +19 -38
  131. package/dist/application/ReferenceSourceImport.js +21 -47
  132. package/dist/application/ReferenceSourceImportEntries.js +2 -4
  133. package/dist/application/ReferenceSourceImportPolicy.js +5 -32
  134. package/dist/application/ReferenceSourceImportTypes.js +0 -16
  135. package/dist/application/RuntimeExecutableDiagnostics.js +55 -29
  136. package/dist/application/SessionProviderRouter.js +2 -2
  137. package/dist/application/Setup.js +1 -3
  138. package/dist/application/SetupClientConfiguration.js +22 -88
  139. package/dist/application/SetupRegistrationEnvironment.js +0 -7
  140. package/dist/application/StoreFileLock.js +119 -0
  141. package/dist/application/TerminalRenderer.js +2 -3
  142. package/dist/application/Uninstall.js +9 -14
  143. package/dist/application/UnknownEvidence.js +1 -1
  144. package/dist/application/WindowsCapabilities.js +5 -4
  145. package/dist/artifacts/ArtifactPaths.js +2 -5
  146. package/dist/artifacts/ArtifactProvider.js +43 -67
  147. package/dist/artifacts/DirectoryArtifactReader.js +13 -8
  148. package/dist/artifacts/MachOSliceArtifactReader.js +1 -5
  149. package/dist/artifacts/NativeDmgArtifactReader.js +11 -11
  150. package/dist/artifacts/NibArchive.js +269 -0
  151. package/dist/artifacts/SafeOutputTree.js +21 -31
  152. package/dist/browser/BrowserProcessStartup.js +1 -2
  153. package/dist/browser/CdpAuthorizedMainFrame.js +16 -0
  154. package/dist/browser/CdpBrowserProvider.js +3 -13
  155. package/dist/browser/CdpCanonicalJsonDigest.js +9 -0
  156. package/dist/browser/CdpCaptureDocuments.js +28 -76
  157. package/dist/browser/CdpCaptureEventBodyShapes.js +13 -33
  158. package/dist/browser/CdpCaptureEventHandlers.js +22 -87
  159. package/dist/browser/CdpCaptureEvents.js +2 -8
  160. package/dist/browser/CdpCaptureStorage.js +9 -20
  161. package/dist/browser/CdpCaptureStorageFingerprints.js +85 -95
  162. package/dist/browser/CdpCaptureValues.js +21 -21
  163. package/dist/browser/CdpConnection.js +10 -25
  164. package/dist/browser/CdpElectronInspection.js +29 -51
  165. package/dist/browser/CdpElectronProvider.js +10 -35
  166. package/dist/browser/CdpElectronScriptEvents.js +8 -16
  167. package/dist/browser/CdpElectronScripts.js +6 -35
  168. package/dist/browser/CdpElectronWorkers.js +6 -10
  169. package/dist/browser/CdpEndpoint.js +25 -41
  170. package/dist/browser/CdpObservationSession.js +14 -26
  171. package/dist/browser/CdpPageCapture.js +34 -48
  172. package/dist/browser/CdpPageCaptureScripts.js +1 -19
  173. package/dist/browser/CdpPageCaptureWorkers.js +6 -10
  174. package/dist/browser/CdpSafeMetadata.js +19 -22
  175. package/dist/browser/CdpScreenshot.js +3 -5
  176. package/dist/browser/CdpTargetSession.js +1 -2
  177. package/dist/browser/CdpWebMcpDiscovery.js +13 -22
  178. package/dist/browser/ElectronFileScope.js +8 -19
  179. package/dist/browser/JavaScriptRuntimeScope.js +10 -10
  180. package/dist/browser/PlaywrightBrowserScenarioProvider.js +31 -64
  181. package/dist/browser/PlaywrightElectronActiveActions.js +309 -0
  182. package/dist/browser/PlaywrightElectronActiveProvider.js +274 -0
  183. package/dist/browser/PlaywrightExecutionBoundary.js +16 -5
  184. package/dist/browser/PlaywrightScenarioActions.js +3 -7
  185. package/dist/browser/PlaywrightScenarioArtifacts.js +23 -92
  186. package/dist/browser/PlaywrightScenarioBrowser.js +7 -9
  187. package/dist/browser/PlaywrightScenarioEvents.js +45 -94
  188. package/dist/browser/PlaywrightScenarioSession.js +18 -34
  189. package/dist/browser/PngVisualDiff.js +22 -14
  190. package/dist/browser/SensitiveTextCapture.js +1 -18
  191. package/dist/browser/V8InspectorCaptureProjection.js +7 -7
  192. package/dist/browser/V8InspectorEndpoint.js +12 -14
  193. package/dist/browser/V8InspectorProvider.js +20 -61
  194. package/dist/browser/WebSourceMapFetcher.js +56 -176
  195. package/dist/catalogIdentity.js +12 -60
  196. package/dist/cli/artifactCommands.js +49 -77
  197. package/dist/cli/coreAnalysisCommands.js +83 -133
  198. package/dist/cli/javascriptApplicationAnalysis.js +1 -9
  199. package/dist/cli/managedCommands.js +6 -271
  200. package/dist/cli/setupCommands.js +3 -12
  201. package/dist/cli/utilityCommands.js +7 -41
  202. package/dist/cli.js +0 -2
  203. package/dist/cliApplicationCommands.js +44 -114
  204. package/dist/cliBrowserAdvancedCommands.js +12 -102
  205. package/dist/cliBrowserCommands.js +19 -124
  206. package/dist/cliBrowserContext.js +30 -0
  207. package/dist/cliCommandNames.js +5 -5
  208. package/dist/cliElectronCommands.js +49 -71
  209. package/dist/cliEvidenceCommands.js +8 -77
  210. package/dist/cliJavaScriptRuntimeCommands.js +18 -92
  211. package/dist/cliJsonInput.js +4 -14
  212. package/dist/cliObservationOptions.js +11 -92
  213. package/dist/cliPolicyCommands.js +2 -16
  214. package/dist/cliProcessCommands.js +3 -3
  215. package/dist/cliSetup.js +0 -13
  216. package/dist/config/browserScenario.js +77 -0
  217. package/dist/config/electronAutomation.js +35 -0
  218. package/dist/config/environment.js +6 -9
  219. package/dist/config/javascriptReplay.js +41 -0
  220. package/dist/config/managedRuntime.js +25 -0
  221. package/dist/config/parseConfig.js +56 -232
  222. package/dist/config/parsers.js +16 -28
  223. package/dist/config/passiveObservation.js +87 -0
  224. package/dist/config/permissions.js +0 -7
  225. package/dist/config/processCapture.js +47 -0
  226. package/dist/contracts/analysisSearchContract.js +2 -5
  227. package/dist/contracts/applicationToolContracts.js +58 -114
  228. package/dist/contracts/applicationWorkflowInputContracts.js +29 -114
  229. package/dist/contracts/artifactComparisonExample.js +58 -60
  230. package/dist/contracts/artifactToolContracts.js +37 -91
  231. package/dist/contracts/browserScenarioToolContracts.js +6 -51
  232. package/dist/contracts/browserToolContracts.js +10 -75
  233. package/dist/contracts/electronToolContracts.js +27 -98
  234. package/dist/contracts/enhancedInputs.js +31 -78
  235. package/dist/contracts/errorSchemas.js +0 -1
  236. package/dist/contracts/functionComparisonExample.js +10 -24
  237. package/dist/contracts/functionInstructionContract.js +1 -3
  238. package/dist/contracts/functionWorkflowToolContracts.js +4 -5
  239. package/dist/contracts/hopperMemoryContracts.js +3 -3
  240. package/dist/contracts/investigationExamples.js +14 -11
  241. package/dist/contracts/javascriptApplicationWorkflowExamples.js +12 -19
  242. package/dist/contracts/javascriptRuntimeObservationToolContracts.js +2 -20
  243. package/dist/contracts/javascriptRuntimeReconciliationExample.js +45 -12
  244. package/dist/contracts/managedToolContracts.js +10 -104
  245. package/dist/contracts/managedWorkflowExamples.js +77 -125
  246. package/dist/contracts/managedWorkflowToolContracts.js +51 -74
  247. package/dist/contracts/nativeToolContracts.js +9 -14
  248. package/dist/contracts/processCaptureExample.js +2 -69
  249. package/dist/contracts/promptContracts.js +49 -67
  250. package/dist/contracts/providerSelection.js +0 -1
  251. package/dist/contracts/reconstructionReadinessExample.js +1 -6
  252. package/dist/contracts/sessionStatusContract.js +1 -17
  253. package/dist/contracts/sessionToolSchemas.js +52 -0
  254. package/dist/contracts/toolContractExamples.js +11 -10
  255. package/dist/contracts/toolContractHelpers.js +19 -0
  256. package/dist/contracts/toolContracts.js +60 -143
  257. package/dist/contracts/toolEffects.js +16 -9
  258. package/dist/contracts/toolOutputSchemaGroups.js +47 -86
  259. package/dist/contracts/toolOutputSchemaPrimitives.js +72 -62
  260. package/dist/contracts/toolSchemaMetadata.js +117 -0
  261. package/dist/contracts/unknownContractExamples.js +0 -2
  262. package/dist/doctorRuntime.js +1 -1
  263. package/dist/domain/analysisErrorPresentation.js +46 -54
  264. package/dist/domain/analysisErrorProjection.js +28 -37
  265. package/dist/domain/analysisProfile.js +3 -31
  266. package/dist/domain/analysisSnapshot.js +3 -12
  267. package/dist/domain/androidApplication.js +15 -52
  268. package/dist/domain/appleApplication.js +24 -65
  269. package/dist/domain/artifactComparison.js +11 -29
  270. package/dist/domain/artifactGraph.js +14 -44
  271. package/dist/domain/artifactInspection.js +38 -69
  272. package/dist/domain/artifactInventoryEvidence.js +27 -21
  273. package/dist/domain/binaryTarget.js +2 -219
  274. package/dist/domain/binaryTargetTypes.js +1 -0
  275. package/dist/domain/browserCaptureComparison.js +35 -60
  276. package/dist/domain/browserObservation.js +45 -197
  277. package/dist/domain/browserObservationSchemas.js +5 -23
  278. package/dist/domain/browserScenario.js +11 -14
  279. package/dist/domain/browserScenarioCapture.js +11 -12
  280. package/dist/domain/browserScenarioCaptureValues.js +146 -84
  281. package/dist/domain/browserScenarioDiff.js +2 -59
  282. package/dist/domain/browserScenarioDiffEvidence.js +51 -0
  283. package/dist/domain/browserScenarioDiffValues.js +21 -38
  284. package/dist/domain/browserScenarioValues.js +80 -109
  285. package/dist/domain/browserSession.js +4 -7
  286. package/dist/domain/bundleComparison.js +6 -32
  287. package/dist/domain/bytecodeProvider.js +53 -54
  288. package/dist/domain/callPath.js +50 -169
  289. package/dist/domain/callPathSchemas.js +79 -0
  290. package/dist/domain/changedBehavior.js +34 -60
  291. package/dist/domain/completionLedgerGeneration.js +8 -14
  292. package/dist/domain/conformancePackage.js +126 -97
  293. package/dist/domain/conformanceReplay.js +39 -11
  294. package/dist/domain/conformanceTrustGate.js +174 -30
  295. package/dist/domain/customProtocolCapture.js +4 -4
  296. package/dist/domain/electronActiveObservation.js +244 -0
  297. package/dist/domain/electronObservation.js +21 -83
  298. package/dist/domain/electronStaticAnalysisBrowser.js +36 -46
  299. package/dist/domain/electronStaticAnalysisIpc.js +38 -14
  300. package/dist/domain/electronStaticAnalysisNative.js +1 -8
  301. package/dist/domain/electronStaticAnalysisValues.js +14 -18
  302. package/dist/domain/errors.js +33 -54
  303. package/dist/domain/eventProcessTree.js +101 -90
  304. package/dist/domain/evidence.js +2 -10
  305. package/dist/domain/evidenceBundle.js +3 -5
  306. package/dist/domain/evidenceCompletionLedger.js +6 -8
  307. package/dist/domain/functionComparison.js +4 -14
  308. package/dist/domain/functionComparisonNormalization.js +8 -8
  309. package/dist/domain/functionComparisonResults.js +25 -15
  310. package/dist/domain/functionComparisonSchemas.js +49 -33
  311. package/dist/domain/functionDossierEvidence.js +31 -151
  312. package/dist/domain/hopperStartupFailure.js +1 -1
  313. package/dist/domain/hopperValues.js +17 -141
  314. package/dist/domain/inputIssueProjection.js +4 -1
  315. package/dist/domain/interfaceBuilderGraph.js +654 -0
  316. package/dist/domain/javascriptApplicationAnalysis.js +8 -112
  317. package/dist/domain/javascriptApplicationChangeGraph.js +22 -82
  318. package/dist/domain/javascriptApplicationEvidenceSchemas.js +59 -47
  319. package/dist/domain/javascriptApplicationGraph.js +3 -13
  320. package/dist/domain/javascriptApplicationGraphSchemas.js +12 -34
  321. package/dist/domain/javascriptApplicationVersionComparison.js +26 -30
  322. package/dist/domain/javascriptApplicationVersionComparisonSchemas.js +123 -68
  323. package/dist/domain/javascriptApplicationVersionItems.js +120 -53
  324. package/dist/domain/javascriptApplicationVersionKeys.js +24 -11
  325. package/dist/domain/javascriptAstFingerprint.js +25 -58
  326. package/dist/domain/javascriptAstValues.js +9 -0
  327. package/dist/domain/javascriptExportInstrumentation.js +2 -4
  328. package/dist/domain/javascriptExportShapeComparison.js +6 -7
  329. package/dist/domain/javascriptExportShapeComparisonSchemas.js +70 -77
  330. package/dist/domain/javascriptExportShapeSelection.js +17 -19
  331. package/dist/domain/javascriptFeatureSeed.js +20 -12
  332. package/dist/domain/javascriptFeatureTrace.js +13 -67
  333. package/dist/domain/javascriptFeatureTraceSchemas.js +24 -52
  334. package/dist/domain/javascriptFeatureTraversal.js +1 -44
  335. package/dist/domain/javascriptNativeHandoff.js +1 -1
  336. package/dist/domain/javascriptReplay.js +100 -101
  337. package/dist/domain/javascriptRuntimeLoadState.js +3 -8
  338. package/dist/domain/javascriptRuntimeObservation.js +43 -103
  339. package/dist/domain/javascriptRuntimeReconciliation.js +1 -3
  340. package/dist/domain/javascriptRuntimeReconciliationActive.js +80 -0
  341. package/dist/domain/javascriptRuntimeReconciliationGraph.js +21 -33
  342. package/dist/domain/javascriptRuntimeReconciliationMatching.js +75 -61
  343. package/dist/domain/javascriptRuntimeReconciliationParsing.js +21 -46
  344. package/dist/domain/javascriptRuntimeReconciliationResult.js +25 -19
  345. package/dist/domain/javascriptRuntimeReconciliationRuntime.js +8 -12
  346. package/dist/domain/javascriptRuntimeReconciliationSchemas.js +34 -49
  347. package/dist/domain/javascriptRuntimeStaticCandidates.js +3 -3
  348. package/dist/domain/javascriptSemanticAnalysis.js +12 -45
  349. package/dist/domain/javascriptSemanticAsyncEffects.js +1 -9
  350. package/dist/domain/javascriptSemanticCallResolution.js +6 -16
  351. package/dist/domain/javascriptSemanticCalls.js +5 -32
  352. package/dist/domain/javascriptSemanticChildProcesses.js +1 -11
  353. package/dist/domain/javascriptSemanticCoverage.js +11 -0
  354. package/dist/domain/javascriptSemanticDataEffectHelpers.js +1 -8
  355. package/dist/domain/javascriptSemanticDataEffects.js +1 -11
  356. package/dist/domain/javascriptSemanticFingerprints.js +3 -5
  357. package/dist/domain/javascriptSemanticGraphSchemas.js +25 -51
  358. package/dist/domain/javascriptSemanticGraphSerialization.js +2 -13
  359. package/dist/domain/javascriptSemanticIr.js +1 -29
  360. package/dist/domain/javascriptSemanticObjects.js +1 -5
  361. package/dist/domain/javascriptSemanticPrimitives.js +2 -9
  362. package/dist/domain/javascriptSemanticProjection.js +0 -18
  363. package/dist/domain/javascriptSemanticPromises.js +9 -16
  364. package/dist/domain/javascriptSemanticProvenance.js +16 -19
  365. package/dist/domain/javascriptSemanticQuery.js +17 -139
  366. package/dist/domain/javascriptSemanticQueryAssessment.js +9 -37
  367. package/dist/domain/javascriptSemanticQueryIdentity.js +2 -23
  368. package/dist/domain/javascriptSemanticQuerySchemas.js +14 -107
  369. package/dist/domain/javascriptSemanticResources.js +1 -6
  370. package/dist/domain/javascriptSemanticReturns.js +10 -27
  371. package/dist/domain/javascriptSemanticValueTypes.js +1 -0
  372. package/dist/domain/javascriptSemanticValues.js +44 -62
  373. package/dist/domain/javascriptStaticAnalysis.js +21 -43
  374. package/dist/domain/javascriptStaticAnalysisBundler.js +34 -93
  375. package/dist/domain/javascriptStaticAnalysisCalls.js +17 -16
  376. package/dist/domain/javascriptStaticAnalysisFindings.js +3 -19
  377. package/dist/domain/javascriptStaticAnalysisHelpers.js +47 -88
  378. package/dist/domain/javascriptStaticAnalysisState.js +1 -5
  379. package/dist/domain/javascriptStaticAnalysisTypes.js +1 -0
  380. package/dist/domain/jsonShape.js +7 -33
  381. package/dist/domain/localPath.js +7 -0
  382. package/dist/domain/managedApplicationGraph.js +9 -41
  383. package/dist/domain/managedApplicationGraphCoverage.js +24 -156
  384. package/dist/domain/managedApplicationGraphNodes.js +10 -13
  385. package/dist/domain/managedArtifact.js +14 -27
  386. package/dist/domain/managedMemberComparison.js +90 -92
  387. package/dist/domain/managedMemberComparisonCoverage.js +11 -33
  388. package/dist/domain/managedMemberComparisonItems.js +221 -0
  389. package/dist/domain/managedMemberComparisonMatch.js +8 -208
  390. package/dist/domain/managedNativeVerification.js +3 -6
  391. package/dist/domain/managedNativeVerificationMatch.js +55 -59
  392. package/dist/domain/managedNativeVerificationSchemas.js +83 -47
  393. package/dist/domain/managedReconstruction.js +19 -23
  394. package/dist/domain/managedRuntimeCorrelation.js +6 -9
  395. package/dist/domain/nativeApiBoundary.js +17 -14
  396. package/dist/domain/nativeInspection.js +0 -2
  397. package/dist/domain/nativeInvestigationGraph.js +351 -0
  398. package/dist/domain/nativeValueFlow.js +61 -0
  399. package/dist/domain/nodeRuntimeCharacterization.js +15 -18
  400. package/dist/domain/objcSwiftMetadata.js +254 -0
  401. package/dist/domain/peInspection.js +1 -1
  402. package/dist/domain/permissionPolicy.js +13 -0
  403. package/dist/domain/processCapture.js +76 -113
  404. package/dist/domain/processCaptureExample.js +68 -0
  405. package/dist/domain/processCaptureParsing.js +21 -0
  406. package/dist/domain/processCaptureReactiveSchema.js +68 -0
  407. package/dist/domain/processCaptureReactiveValidation.js +8 -3
  408. package/dist/domain/processCaptureValidation.js +8 -10
  409. package/dist/domain/processComparison.js +12 -16
  410. package/dist/domain/processObservation.js +5 -6
  411. package/dist/domain/processReactiveMatching.js +32 -46
  412. package/dist/domain/processReactiveRuntime.js +4 -8
  413. package/dist/domain/processReactiveScenario.js +28 -94
  414. package/dist/domain/processReactiveScenarioPreflight.js +5 -30
  415. package/dist/domain/processReactiveTransition.js +42 -21
  416. package/dist/domain/processScenario.js +62 -93
  417. package/dist/domain/processTraceComparison.js +0 -7
  418. package/dist/domain/processTraceEvaluation.js +14 -4
  419. package/dist/domain/processTraceSpecification.js +11 -17
  420. package/dist/domain/protocolCapture.js +11 -9
  421. package/dist/domain/reconstructionCoverage.js +62 -129
  422. package/dist/domain/reconstructionCoverageEvaluation.js +17 -17
  423. package/dist/domain/reconstructionObligationLedgerSchemas.js +45 -72
  424. package/dist/domain/reconstructionReadiness.js +1 -2
  425. package/dist/domain/reconstructionReadinessSchemas.js +66 -40
  426. package/dist/domain/reconstructionUnknowns.js +3 -3
  427. package/dist/domain/reconstructionVerification.js +13 -47
  428. package/dist/domain/reconstructionVerificationSchemas.js +50 -38
  429. package/dist/domain/referenceSourceGraph.js +53 -61
  430. package/dist/domain/referenceSourceImportParsing.js +3 -7
  431. package/dist/domain/replayMachine.js +19 -31
  432. package/dist/domain/replayMachineRun.js +15 -63
  433. package/dist/domain/replayMachineRuntime.js +46 -44
  434. package/dist/domain/replayMachineValues.js +84 -0
  435. package/dist/domain/residualUnknown.js +25 -30
  436. package/dist/domain/runtimeCharacterization.js +15 -16
  437. package/dist/domain/runtimeIdentification.js +48 -47
  438. package/dist/domain/sourceToBundleComparison.js +11 -87
  439. package/dist/domain/sourceToBundleComparisonSchemas.js +25 -50
  440. package/dist/domain/sourceToBundleSignals.js +11 -16
  441. package/dist/domain/staticRuntimeCorrelation.js +44 -54
  442. package/dist/domain/symbolAnalysis.js +10 -19
  443. package/dist/domain/unicodeCodePointOrder.js +12 -0
  444. package/dist/domain/webBundleAnalysis.js +70 -99
  445. package/dist/domain/webBundleAnalyzer.js +2 -4
  446. package/dist/domain/webBundleAnalyzerAst.js +0 -13
  447. package/dist/domain/webBundleAnalyzerInspection.js +26 -52
  448. package/dist/domain/webBundleAnalyzerResult.js +7 -24
  449. package/dist/domain/webCaptureDiff.js +48 -85
  450. package/dist/domain/webCaptureDiffSchemas.js +86 -0
  451. package/dist/domain/webContentArtifact.js +1 -10
  452. package/dist/domain/webMcpDiscovery.js +3 -14
  453. package/dist/domain/webScreenshot.js +58 -34
  454. package/dist/domain/zipPackageFormat.js +7 -0
  455. package/dist/dotnet/ManagedArtifactInspector.js +17 -50
  456. package/dist/dotnet/ManagedMemberInspector.js +27 -58
  457. package/dist/dotnet/ManagedMemberInspectorCore.js +14 -51
  458. package/dist/dotnet/ManagedMemberInstructionDecoder.js +2 -2
  459. package/dist/dotnet/ManagedMemberRows.js +16 -16
  460. package/dist/dotnet/ManagedMetadataHeaps.js +26 -8
  461. package/dist/dotnet/ManagedMetadataInventory.js +21 -30
  462. package/dist/dotnet/ManagedMetadataInventoryRows.js +57 -63
  463. package/dist/dotnet/ManagedMetadataLayout.js +3 -5
  464. package/dist/dotnet/ManagedMethodBodyReader.js +5 -30
  465. package/dist/dotnet/ManagedNativeBoundaryHelpers.js +19 -49
  466. package/dist/dotnet/ManagedNativeBoundaryInspector.js +13 -42
  467. package/dist/dotnet/ManagedPeReader.js +2 -2
  468. package/dist/dotnet/ManagedStaticProvider.js +13 -71
  469. package/dist/generatedMcpToolCatalog.js +1 -1
  470. package/dist/generatedPackageMetadata.js +1 -1
  471. package/dist/ghidra/GhidraAnalysisProfile.js +3 -8
  472. package/dist/ghidra/GhidraClient.js +5 -13
  473. package/dist/ghidra/GhidraClientStartup.js +1 -1
  474. package/dist/ghidra/GhidraClientWire.js +9 -5
  475. package/dist/ghidra/GhidraDefaults.js +0 -18
  476. package/dist/ghidra/GhidraDiagnostics.js +0 -2
  477. package/dist/ghidra/GhidraDoctor.js +16 -12
  478. package/dist/ghidra/GhidraFunctionValues.js +67 -108
  479. package/dist/ghidra/GhidraInstallation.js +98 -42
  480. package/dist/ghidra/GhidraInventoryValues.js +18 -77
  481. package/dist/ghidra/GhidraLauncher.js +0 -8
  482. package/dist/ghidra/GhidraProvider.js +32 -31
  483. package/dist/ghidra/GhidraProviderCapabilities.js +11 -48
  484. package/dist/ghidra/GhidraRequestQueue.js +6 -30
  485. package/dist/ghidra/GhidraResponseBuffer.js +1 -7
  486. package/dist/ghidra/GhidraSessionValues.js +0 -2
  487. package/dist/ghidra/GhidraSocketConnection.js +1 -1
  488. package/dist/ghidra/GhidraTransport.js +4 -7
  489. package/dist/ghidra/protocol.js +19 -42
  490. package/dist/hopper/BridgeLauncher.js +115 -37
  491. package/dist/hopper/HopperAnalysisProfile.js +3 -5
  492. package/dist/hopper/HopperCleanup.js +11 -9
  493. package/dist/hopper/HopperClient.js +5 -8
  494. package/dist/hopper/HopperProcessDiagnostic.js +2 -2
  495. package/dist/hopper/HopperProvider.js +0 -30
  496. package/dist/hopper/HopperRequestQueue.js +21 -40
  497. package/dist/hopper/HopperResponseStream.js +1 -9
  498. package/dist/hopper/HopperSessionValues.js +3 -2
  499. package/dist/hopper/HopperTargetLease.js +119 -0
  500. package/dist/hopper/LinuxPrivateDisplayDiagnostic.js +24 -31
  501. package/dist/hopper/LinuxPrivateDisplayProbe.js +21 -26
  502. package/dist/hopper/protocol.js +6 -4
  503. package/dist/main/reload.js +1 -9
  504. package/dist/main/shutdown.js +1 -1
  505. package/dist/main/state.js +0 -23
  506. package/dist/main/transport.js +27 -39
  507. package/dist/main.js +17 -15
  508. package/dist/mcpDoctor.js +27 -69
  509. package/dist/native/CommandRunner.js +18 -25
  510. package/dist/native/NativeMacOSProvider.js +13 -38
  511. package/dist/native/NativeMachoInspection.js +1 -1
  512. package/dist/process/BoundedFileBytes.js +17 -0
  513. package/dist/process/ExecFileOutput.js +11 -0
  514. package/dist/process/PendingOperations.js +8 -6
  515. package/dist/process/PrivateRuntimeRoot.js +17 -0
  516. package/dist/process/ProcessOwnership.js +67 -130
  517. package/dist/process/ProcessOwnershipIdentity.js +13 -0
  518. package/dist/process/ProcessOwnershipObservation.js +87 -0
  519. package/dist/process/ProcessOwnershipProcessTree.js +22 -0
  520. package/dist/process/ProviderDeadline.js +8 -12
  521. package/dist/process/ProviderProcess.js +7 -28
  522. package/dist/process/WindowsAuthority.js +32 -0
  523. package/dist/reference/ReferenceSourceReader.js +8 -24
  524. package/dist/reference/ReferenceSourceReaderEntries.js +11 -39
  525. package/dist/reference/ReferenceSourceReaderFile.js +13 -31
  526. package/dist/reference/ReferenceSourceReaderPaths.js +3 -18
  527. package/dist/reference/ReferenceSourceReaderValidate.js +3 -6
  528. package/dist/replay/JavaScriptReplayWorker.js +95 -13
  529. package/dist/replay/JavaScriptReplayWorkerTypes.js +1 -0
  530. package/dist/replay/LinuxJavaScriptReplayRunner.js +42 -43
  531. package/dist/replay/LinuxJavaScriptReplaySandbox.js +0 -19
  532. package/dist/replay/LinuxRuntimeClosure.js +1 -3
  533. package/dist/replay/ReplayOutcome.js +27 -18
  534. package/dist/replay/ReplayProcessLifecycle.js +32 -7
  535. package/dist/replay/ReplaySeccompFile.js +29 -0
  536. package/dist/replay/ReplayWorkerProtocol.js +33 -30
  537. package/dist/replay/SystemJavaScriptReplayHost.js +45 -74
  538. package/dist/server/ProcessCaptureElicitation.js +4 -8
  539. package/dist/server/createServer.js +145 -119
  540. package/dist/server/mcpClientMetadata.js +32 -0
  541. package/dist/server/promptCompletion.js +37 -61
  542. package/dist/server/recordDerivedEvidence.js +1 -1
  543. package/dist/server/registerApplicationTools/characterization.js +10 -21
  544. package/dist/server/registerApplicationTools/compareExportShapes.js +6 -16
  545. package/dist/server/registerApplicationTools/compareSourceToBundle.js +6 -15
  546. package/dist/server/registerApplicationTools/compareVersions.js +6 -16
  547. package/dist/server/registerApplicationTools/controlledReplay.js +8 -15
  548. package/dist/server/registerApplicationTools/coverage.js +7 -78
  549. package/dist/server/registerApplicationTools/helpers.js +1 -13
  550. package/dist/server/registerApplicationTools/obligationLedger.js +4 -8
  551. package/dist/server/registerApplicationTools/traceFeature.js +6 -15
  552. package/dist/server/registerApplicationTools/traceSemantics.js +5 -13
  553. package/dist/server/registerApplicationTools.js +0 -2
  554. package/dist/server/registerArtifactComparisonTool.js +27 -35
  555. package/dist/server/registerBrowserScenarioTool.js +3 -8
  556. package/dist/server/registerBrowserTools.js +36 -81
  557. package/dist/server/registerBundleComparisonTool.js +10 -16
  558. package/dist/server/registerCloseLifecycleTool.js +5 -27
  559. package/dist/server/registerElectronTools.js +29 -65
  560. package/dist/server/registerEnhancedTools.js +118 -127
  561. package/dist/server/registerEvidenceTools.js +19 -30
  562. package/dist/server/registerFunctionComparisonTool.js +35 -34
  563. package/dist/server/registerInvestigationTools/helpers.js +3 -32
  564. package/dist/server/registerInvestigationTools.js +36 -148
  565. package/dist/server/registerJavaScriptRuntimeObservationTools.js +15 -27
  566. package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +16 -23
  567. package/dist/server/registerManagedWorkflowTools/contract.js +2 -3
  568. package/dist/server/registerManagedWorkflowTools/evidence.js +19 -35
  569. package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +4 -14
  570. package/dist/server/registerManagedWorkflowTools/planManagedRuntimeCorrelation.js +4 -14
  571. package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +11 -20
  572. package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +10 -21
  573. package/dist/server/registerOfficialTools.js +8 -51
  574. package/dist/server/registerProcessComparisonTool.js +43 -38
  575. package/dist/server/registerPrompts.js +19 -17
  576. package/dist/server/registerReplayMachineTool.js +4 -10
  577. package/dist/server/registerSessionRecordTools.js +36 -153
  578. package/dist/server/registerSessionStatusTool.js +18 -96
  579. package/dist/server/registerSessionTools.js +34 -91
  580. package/dist/server/sessionAvailabilityPolicy.js +2 -3
  581. package/dist/server/sessionEvidence.js +9 -15
  582. package/dist/server/sessionToolPolicies.js +1 -13
  583. package/dist/server/toolRegistrationOptions.js +4 -192
  584. package/dist/server/toolResult.js +15 -67
  585. package/dist/serverIdentity.js +0 -20
  586. package/install.sh +1 -1
  587. package/package.json +27 -15
  588. package/scripts/electron-active-hook-boundaries.cjs +394 -0
  589. package/scripts/electron-active-hook.cjs +469 -0
  590. package/scripts/hopper-demo-x11.py +13 -32
  591. package/scripts/rea.mjs +1 -11
  592. package/skills/reverse-engineer-anything/SKILL.md +46 -11
  593. package/skills/reverse-engineer-anything/references/evidence-workflows.md +6 -4
  594. package/skills/reverse-engineer-anything/references/javascript-applications.md +13 -13
  595. package/skills/reverse-engineer-anything/references/native-and-artifacts.md +12 -8
  596. package/dist/application/ApplicationWorkflowEvidenceResolver.js +0 -180
  597. package/dist/application/BoundedJsonFiles.js +0 -86
  598. package/dist/application/CrossVersionInventory.js +0 -128
  599. package/dist/application/CrossVersionInvestigation.js +0 -301
  600. package/dist/application/CrossVersionInvestigationCollections.js +0 -23
  601. package/dist/application/CrossVersionInvestigationEvidence.js +0 -64
  602. package/dist/application/CrossVersionInvestigationReplay.js +0 -170
  603. package/dist/application/DeferredFileAuthorization.js +0 -61
  604. package/dist/application/DoctorProjection.js +0 -43
  605. package/dist/application/EnhancedToolPagination.js +0 -22
  606. package/dist/application/EvidenceReferenceResolver.js +0 -26
  607. package/dist/application/InvestigationWorkspaceStore.js +0 -204
  608. package/dist/application/ProcessPairedExperiment.js +0 -72
  609. package/dist/application/ReconstructionCoverageWorkspaceStore.js +0 -31
  610. package/dist/application/ReconstructionReadinessService.js +0 -48
  611. package/dist/cliInvestigationCommands.js +0 -173
  612. package/dist/domain/boundedCartesianProjection.js +0 -15
  613. package/dist/domain/investigationWorkspace.js +0 -346
  614. package/dist/domain/jsonLimits.js +0 -26
  615. package/dist/domain/knownPageCoverage.js +0 -21
  616. package/dist/domain/processPairedExperiment.js +0 -128
  617. package/dist/server/DynamicToolAvailability.js +0 -70
  618. package/dist/server/LazyToolCatalog.js +0 -134
  619. package/dist/server/hydrateServerTools.js +0 -191
  620. package/dist/server/javascriptApplicationResult.js +0 -106
  621. package/dist/server/permissionFailure.js +0 -12
  622. package/dist/server/registerApplicationTools/readiness.js +0 -55
  623. package/dist/server/registerEvidenceResources.js +0 -315
  624. package/dist/server/registerJavaScriptApplicationGraphResource.js +0 -65
  625. package/dist/server/registerReconstructionObligationLedgerResource.js +0 -32
  626. package/dist/server/registerReconstructionReadinessResource.js +0 -32
  627. package/dist/server/toolInputValidation.js +0 -77
  628. package/scripts/package-runner-bootstrap.mjs +0 -72
@@ -1,27 +1,19 @@
1
- import { resolveTraceJavaScriptSemanticsRequestValidated } from "../../application/ApplicationWorkflowEvidenceResolver.js";
1
+ import { recordSessionEvidenceSources } from "../sessionEvidence.js";
2
2
  import { traceJavaScriptSemanticsEvidenceValidated } from "../../application/JavaScriptSemanticTraceService.js";
3
3
  import { applicationToolContract } from "../../contracts/applicationToolContracts.js";
4
- import { traceJavaScriptSemanticsRequestSchema } from "../../contracts/applicationWorkflowInputContracts.js";
5
- import { safeParseToolInput } from "../toolInputValidation.js";
6
4
  import { logToolExecution } from "../toolLogging.js";
7
5
  import { toolRegistrationOptions } from "../toolRegistrationOptions.js";
8
6
  import { toCallToolResult } from "../toolResult.js";
9
- import { recordResult, recordSources } from "./helpers.js";
7
+ import { recordResult } from "./helpers.js";
10
8
  const contract = applicationToolContract("trace_javascript_semantics");
11
9
  /** Register the bounded JavaScript semantic relation trace tool. */
12
10
  export const registerTraceJavaScriptSemanticsTool = (server, options) => {
13
11
  server.registerTool(contract.name, toolRegistrationOptions(contract), async (input) => {
14
- const parsedInput = safeParseToolInput(traceJavaScriptSemanticsRequestSchema, input, contract.name);
15
- if (!parsedInput.ok)
16
- return toCallToolResult(parsedInput, contract);
17
- const resolved = resolveTraceJavaScriptSemanticsRequestValidated(parsedInput.value, options.evidenceLookup);
18
- if (!resolved.ok)
19
- return toCallToolResult(resolved, contract);
20
- const result = await logToolExecution(options.logger, contract.name, () => Promise.resolve(traceJavaScriptSemanticsEvidenceValidated(resolved.value)));
12
+ const result = await logToolExecution(options.logger, contract.name, () => Promise.resolve(traceJavaScriptSemanticsEvidenceValidated(input)));
21
13
  if (!result.ok)
22
14
  return toCallToolResult(result, contract);
23
- const recorded = recordSources(options.recordEvidence, [
24
- resolved.value.application,
15
+ const recorded = recordSessionEvidenceSources(options.recordEvidence, [
16
+ input.application,
25
17
  ]);
26
18
  if (!recorded.ok)
27
19
  return toCallToolResult(recorded, contract);
@@ -7,7 +7,6 @@ import { registerControlledReplayTool } from "./registerApplicationTools/control
7
7
  import { registerCharacterizationTools } from "./registerApplicationTools/characterization.js";
8
8
  import { registerCoverageTools } from "./registerApplicationTools/coverage.js";
9
9
  import { registerReconstructionObligationLedgerTool } from "./registerApplicationTools/obligationLedger.js";
10
- import { registerReconstructionReadinessTool } from "./registerApplicationTools/readiness.js";
11
10
  /** Register provider-neutral JavaScript application graph workflows. */
12
11
  export const registerApplicationTools = (server, options) => {
13
12
  registerTraceFeatureTool(server, options);
@@ -18,6 +17,5 @@ export const registerApplicationTools = (server, options) => {
18
17
  registerControlledReplayTool(server, options);
19
18
  registerCharacterizationTools(server, options);
20
19
  registerReconstructionObligationLedgerTool(server, options);
21
- registerReconstructionReadinessTool(server, options);
22
20
  registerCoverageTools(server, options);
23
21
  };
@@ -1,44 +1,37 @@
1
- import { artifactComparisonInputSchema, compareArtifacts, } from "../domain/artifactComparison.js";
2
- import { createEvidence } from "../domain/evidence.js";
1
+ import { SESSION_TOOL_CONTRACTS } from "../contracts/toolContracts.js";
2
+ import { compareArtifacts } from "../domain/artifactComparison.js";
3
+ import { createEvidence, parseEvidence } from "../domain/evidence.js";
3
4
  import { jsonValueSchema } from "../domain/jsonValue.js";
4
5
  import { recordDerivedEvidence } from "./recordDerivedEvidence.js";
5
- import { resolveSessionEvidenceIds } from "./sessionEvidence.js";
6
+ import { runDerivedOperation } from "./runDerivedOperation.js";
6
7
  import { ARTIFACT_COMPARISON_PROVIDER } from "./sessionToolPolicies.js";
7
- import { toCallToolResult } from "./toolResult.js";
8
8
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
9
- import { runDerivedOperation } from "./runDerivedOperation.js";
10
- import { safeParseToolInput } from "./toolInputValidation.js";
9
+ import { toCallToolResult } from "./toolResult.js";
11
10
  /** Register Evidence-backed deterministic artifact comparison. */
12
11
  export const registerArtifactComparisonTool = (server, session, contract) => {
13
12
  server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
14
- const parsedInput = safeParseToolInput(artifactComparisonInputSchema, input, contract.name);
15
- if (!parsedInput.ok)
16
- return toCallToolResult(parsedInput, contract);
17
- const parsed = parsedInput.value;
18
- const expected = {
19
- operation: "inventory_artifact",
20
- predicate: "rea.analysis/v2",
21
- };
22
- const left = resolveSessionEvidenceIds(session, parsed.left_evidence_ids, expected);
23
- if (!left.ok)
24
- return toCallToolResult(left, contract);
25
- const right = resolveSessionEvidenceIds(session, parsed.right_evidence_ids, expected);
26
- if (!right.ok)
27
- return toCallToolResult(right, contract);
28
- const computed = await runDerivedOperation(context, contract.name, () => compareArtifacts(left.value, right.value, parsed.offset, parsed.limit));
13
+ const computed = await runDerivedOperation(context, contract.name, () => {
14
+ const left = parseEvidence(input.left);
15
+ const right = parseEvidence(input.right);
16
+ return { left, right, comparison: compareArtifacts(left, right) };
17
+ });
29
18
  if (!computed.ok)
30
19
  return toCallToolResult(computed, contract);
31
- const comparison = computed.value;
32
- const leftEvidenceIds = parsed.left_evidence_ids;
33
- const rightEvidenceIds = parsed.right_evidence_ids;
20
+ const { left, right, comparison } = computed.value;
21
+ const sources = [left, right];
22
+ for (const source of sources) {
23
+ const recordedSource = session.recordEvidence(source);
24
+ if (!recordedSource.ok)
25
+ return toCallToolResult(recordedSource, contract);
26
+ }
27
+ const leftEvidenceIds = [left.evidence_id];
28
+ const rightEvidenceIds = [right.evidence_id];
34
29
  const evidence = createEvidence(undefined, ARTIFACT_COMPARISON_PROVIDER, {
35
- predicateType: "rea.artifact-comparison/v1",
30
+ predicateType: "rea.artifact-comparison",
36
31
  operation: contract.name,
37
32
  parameters: {
38
33
  left_evidence_ids: leftEvidenceIds,
39
34
  right_evidence_ids: rightEvidenceIds,
40
- offset: parsed.offset,
41
- limit: parsed.limit,
42
35
  },
43
36
  result: jsonValueSchema.parse(comparison),
44
37
  confidence: "derived",
@@ -46,26 +39,25 @@ export const registerArtifactComparisonTool = (server, session, contract) => {
46
39
  limitations: comparison.limitations,
47
40
  evidenceLinks: [...leftEvidenceIds, ...rightEvidenceIds],
48
41
  });
49
- return toCallToolResult(recordDerivedEvidence(session, evidence, artifactUnknownInput(parsed, comparison.status)), contract);
42
+ return toCallToolResult(recordDerivedEvidence(session, evidence, artifactUnknownInput(left, right, comparison.status)), contract);
50
43
  });
51
44
  };
52
- const artifactUnknownInput = (input, status) => {
53
- if (input.unknown_registry_approved !== true || status === "unchanged")
45
+ const artifactUnknownInput = (left, right, status) => {
46
+ if (status === "unchanged" || left.evidence_id === right.evidence_id)
54
47
  return undefined;
55
48
  return {
56
- approved: true,
57
49
  question: `Artifact comparison is ${status}`,
58
50
  severity: status === "unknown" || status === "truncated" ? "high" : "medium",
59
51
  domain: "artifact-comparison",
60
- supporting_evidence_ids: [...input.left_evidence_ids],
61
- contradicting_evidence_ids: [...input.right_evidence_ids],
52
+ supporting_evidence_ids: [left.evidence_id],
53
+ contradicting_evidence_ids: [right.evidence_id],
62
54
  required_authority: "shipped-artifact",
63
55
  required_confidence: "observed",
64
56
  required_environment: null,
65
57
  recommended_probes: [
66
58
  {
67
- operation: "inventory_artifact",
68
- rationale: "Capture both complete artifact graphs under equal limits.",
59
+ operation: "inspect_artifact",
60
+ rationale: "Inspect both artifacts and compare their complete graphs.",
69
61
  },
70
62
  ],
71
63
  relationships: [],
@@ -2,24 +2,19 @@ import { captureBrowserScenario } from "../application/BrowserScenarioCaptureSer
2
2
  import { BROWSER_SCENARIO_TOOL_CONTRACTS } from "../contracts/browserScenarioToolContracts.js";
3
3
  import { browserScenarioSchema } from "../domain/browserScenario.js";
4
4
  import { logToolExecution } from "./toolLogging.js";
5
- import { safeParseToolInput } from "./toolInputValidation.js";
6
5
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
7
6
  import { toCallToolResult } from "./toolResult.js";
8
7
  /** Register the controlled browser scenario tool even when policy disables it. */
9
8
  export const registerBrowserScenarioTool = (server, options) => {
10
9
  const [contract] = BROWSER_SCENARIO_TOOL_CONTRACTS;
11
10
  server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
12
- const parsed = safeParseToolInput(browserScenarioSchema, input, contract.name);
13
- if (!parsed.ok)
14
- return toCallToolResult(parsed, contract);
15
- const result = await logToolExecution(options.logger, contract.name, () => captureBrowserScenario(options.provider, options.permissionAuthority, parsed.value, { signal: context.mcpReq.signal }));
11
+ const scenario = browserScenarioSchema.parse(input);
12
+ const result = await logToolExecution(options.logger, contract.name, () => captureBrowserScenario(options.provider, options.permissionAuthority, scenario, { signal: context.mcpReq.signal }));
16
13
  if (!result.ok)
17
14
  return toCallToolResult(result, contract);
18
15
  const recorded = options.recordEvidence?.(result.value);
19
16
  return recorded !== undefined && !recorded.ok
20
17
  ? toCallToolResult(recorded, contract)
21
- : toCallToolResult({ ok: true, value: result.value }, contract, {
22
- evidenceResourcesAvailable: recorded !== undefined,
23
- });
18
+ : toCallToolResult({ ok: true, value: result.value }, contract);
24
19
  });
25
20
  };
@@ -1,96 +1,51 @@
1
1
  import { analyzeWebBundle, captureWebScreenshot, compareWebCaptureEvidence, compareWebScreenshotEvidence, discoverWebMcpTools, inspectWebPage, listBrowserTargets, observeWebSession, } from "../application/BrowserObservationService.js";
2
2
  import { BROWSER_TOOL_CONTRACTS } from "../contracts/browserToolContracts.js";
3
- import { inspectWebPageInputSchema, listBrowserTargetsInputSchema, } from "../domain/browserObservation.js";
4
3
  import { analyzeWebBundleInputSchema } from "../domain/webBundleAnalysis.js";
5
- import { observeWebSessionInputSchema } from "../domain/browserSession.js";
6
- import { discoverWebMcpToolsInputSchema } from "../domain/webMcpDiscovery.js";
7
- import { browserCaptureComparisonInputSchema } from "../domain/browserCaptureComparison.js";
8
- import { captureWebScreenshotInputSchema, compareWebScreenshotsInputSchema, } from "../domain/webScreenshot.js";
4
+ import { inspectWebPageInputSchema } from "../domain/browserObservation.js";
5
+ import { mcpProgressReporter } from "./mcpProgress.js";
9
6
  import { logToolExecution } from "./toolLogging.js";
10
- import { toCallToolResult } from "./toolResult.js";
11
7
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
12
- import { safeParseToolInput } from "./toolInputValidation.js";
13
- import { mcpProgressReporter } from "./mcpProgress.js";
8
+ import { toCallToolResult } from "./toolResult.js";
14
9
  /** Register browser tools even when policy/provider availability denies execution. */
10
+ // oxlint-disable-next-line max-lines-per-function -- direct SDK calls retain each schema-handler type correlation.
15
11
  export const registerBrowserTools = (server, options) => {
16
12
  const [listContract, inspectContract, analyzeContract, sessionContract, webMcpContract, captureDiffContract, screenshotContract, screenshotDiffContract,] = BROWSER_TOOL_CONTRACTS;
17
- registerBrowserTool(server, options, {
18
- contract: listContract,
19
- schema: listBrowserTargetsInputSchema,
20
- execute: (parsed, { signal }) => listBrowserTargets(options.browser, options.permissionAuthority, parsed, {
21
- signal,
22
- }),
23
- });
24
- registerBrowserTool(server, options, {
25
- contract: inspectContract,
26
- schema: inspectWebPageInputSchema,
27
- execute: (parsed, { signal, progress }) => inspectWebPage(options.browser, options.permissionAuthority, parsed, {
28
- signal,
29
- progress,
30
- }),
31
- });
32
- registerBrowserTool(server, options, {
33
- contract: analyzeContract,
34
- schema: analyzeWebBundleInputSchema,
35
- execute: (parsed, { signal, progress }) => analyzeWebBundle(options.browser, options.permissionAuthority, parsed, {
36
- signal,
37
- progress,
38
- }),
39
- });
40
- registerBrowserTool(server, options, {
41
- contract: sessionContract,
42
- schema: observeWebSessionInputSchema,
43
- execute: (parsed, { signal, progress }) => observeWebSession(options.browser, options.permissionAuthority, parsed, {
44
- signal,
45
- progress,
46
- }),
47
- });
48
- registerBrowserTool(server, options, {
49
- contract: webMcpContract,
50
- schema: discoverWebMcpToolsInputSchema,
51
- execute: (parsed, { signal, progress }) => discoverWebMcpTools(options.browser, options.permissionAuthority, parsed, {
52
- signal,
53
- progress,
54
- }),
55
- });
56
- registerBrowserTool(server, options, {
57
- contract: captureDiffContract,
58
- schema: browserCaptureComparisonInputSchema,
59
- execute: (parsed, _context) => compareWebCaptureEvidence(options.browser, parsed),
60
- });
61
- registerBrowserTool(server, options, {
62
- contract: screenshotContract,
63
- schema: captureWebScreenshotInputSchema,
64
- execute: (parsed, { signal, progress }) => captureWebScreenshot(options.browser, options.permissionAuthority, parsed, {
65
- signal,
66
- progress,
67
- }),
68
- });
69
- registerBrowserTool(server, options, {
70
- contract: screenshotDiffContract,
71
- schema: compareWebScreenshotsInputSchema,
72
- execute: (parsed, _context) => compareWebScreenshotEvidence(options.browser, parsed),
73
- });
13
+ server.registerTool(listContract.name, toolRegistrationOptions(listContract), (input, context) => runBrowserTool(options, listContract, { input, context }, (parsed, { signal }) => listBrowserTargets(options.browser, options.permissionAuthority, parsed, {
14
+ signal,
15
+ })));
16
+ server.registerTool(inspectContract.name, toolRegistrationOptions(inspectContract), (input, context) => runBrowserTool(options, inspectContract, { input, context }, (parsed, { signal, progress }) => inspectWebPage(options.browser, options.permissionAuthority, inspectWebPageInputSchema.parse(parsed), { signal, progress })));
17
+ server.registerTool(analyzeContract.name, toolRegistrationOptions(analyzeContract), (input, context) => runBrowserTool(options, analyzeContract, { input, context }, (parsed, { signal, progress }) => analyzeWebBundle(options.browser, options.permissionAuthority, analyzeWebBundleInputSchema.parse(parsed), {
18
+ signal,
19
+ progress,
20
+ })));
21
+ server.registerTool(sessionContract.name, toolRegistrationOptions(sessionContract), (input, context) => runBrowserTool(options, sessionContract, { input, context }, (parsed, { signal, progress }) => observeWebSession(options.browser, options.permissionAuthority, parsed, {
22
+ signal,
23
+ progress,
24
+ })));
25
+ server.registerTool(webMcpContract.name, toolRegistrationOptions(webMcpContract), (input, context) => runBrowserTool(options, webMcpContract, { input, context }, (parsed, { signal, progress }) => discoverWebMcpTools(options.browser, options.permissionAuthority, parsed, {
26
+ signal,
27
+ progress,
28
+ })));
29
+ server.registerTool(captureDiffContract.name, toolRegistrationOptions(captureDiffContract), (input, context) => runBrowserTool(options, captureDiffContract, { input, context }, (parsed) => compareWebCaptureEvidence(options.browser, parsed)));
30
+ server.registerTool(screenshotContract.name, toolRegistrationOptions(screenshotContract), (input, context) => runBrowserTool(options, screenshotContract, { input, context }, (parsed, { signal, progress }) => captureWebScreenshot(options.browser, options.permissionAuthority, parsed, {
31
+ signal,
32
+ progress,
33
+ })));
34
+ server.registerTool(screenshotDiffContract.name, toolRegistrationOptions(screenshotDiffContract), (input, context) => runBrowserTool(options, screenshotDiffContract, { input, context }, (parsed) => compareWebScreenshotEvidence(options.browser, parsed)));
74
35
  };
75
- const registerBrowserTool = (server, options, spec) => {
76
- server.registerTool(spec.contract.name, toolRegistrationOptions(spec.contract), async (input, context) => {
77
- const parsedInput = safeParseToolInput(spec.schema, input, spec.contract.name);
78
- if (!parsedInput.ok)
79
- return toCallToolResult(parsedInput, spec.contract);
80
- const result = await logToolExecution(options.logger, spec.contract.name, () => spec.execute(parsedInput.value, {
81
- signal: context.mcpReq.signal,
82
- progress: mcpProgressReporter(context),
83
- }));
84
- if (!result.ok)
85
- return toCallToolResult(result, spec.contract);
86
- return evidenceResult(options, spec.contract, result.value);
87
- });
36
+ const runBrowserTool = async (options, contract, request, execute) => {
37
+ const { input, context } = request;
38
+ const result = await logToolExecution(options.logger, contract.name, () => execute(input, {
39
+ signal: context.mcpReq.signal,
40
+ progress: mcpProgressReporter(context),
41
+ }));
42
+ if (!result.ok)
43
+ return toCallToolResult(result, contract);
44
+ return evidenceResult(options, contract, result.value);
88
45
  };
89
46
  const evidenceResult = (options, contract, evidence) => {
90
47
  const recorded = options.recordEvidence?.(evidence);
91
48
  return recorded !== undefined && !recorded.ok
92
49
  ? toCallToolResult(recorded, contract)
93
- : toCallToolResult({ ok: true, value: evidence }, contract, {
94
- evidenceResourcesAvailable: recorded !== undefined,
95
- });
50
+ : toCallToolResult({ ok: true, value: evidence }, contract);
96
51
  };
@@ -1,41 +1,35 @@
1
1
  import { readEvidenceBundle } from "../application/EvidenceBundleFiles.js";
2
- import { bundleComparisonInputSchema, compareBundles, } from "../domain/bundleComparison.js";
2
+ import { SESSION_TOOL_CONTRACTS } from "../contracts/toolContracts.js";
3
+ import { compareBundles } from "../domain/bundleComparison.js";
3
4
  import { createEvidence } from "../domain/evidence.js";
4
5
  import { jsonValueSchema } from "../domain/jsonValue.js";
5
6
  import { ok } from "../domain/result.js";
7
+ import { runDerivedOperation } from "./runDerivedOperation.js";
6
8
  import { BUNDLE_COMPARISON_PROVIDER } from "./sessionToolPolicies.js";
7
- import { toCallToolResult } from "./toolResult.js";
8
9
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
9
- import { runDerivedOperation } from "./runDerivedOperation.js";
10
- import { safeParseToolInput } from "./toolInputValidation.js";
10
+ import { toCallToolResult } from "./toolResult.js";
11
11
  /** Register canonical Evidence bundle comparison. */
12
- export const registerBundleComparisonTool = (server, session, contract, evidenceFilePolicy) => {
12
+ export const registerBundleComparisonTool = (server, session, contract) => {
13
13
  server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
14
- const parsedInput = safeParseToolInput(bundleComparisonInputSchema, input, contract.name);
15
- if (!parsedInput.ok)
16
- return toCallToolResult(parsedInput, contract);
17
- const parsed = parsedInput.value;
18
14
  const [left, right] = await Promise.all([
19
- readEvidenceBundle(parsed.left_bundle_path, evidenceFilePolicy),
20
- readEvidenceBundle(parsed.right_bundle_path, evidenceFilePolicy),
15
+ readEvidenceBundle(input.left_bundle_path),
16
+ readEvidenceBundle(input.right_bundle_path),
21
17
  ]);
22
18
  if (!left.ok)
23
19
  return toCallToolResult(left, contract);
24
20
  if (!right.ok)
25
21
  return toCallToolResult(right, contract);
26
- const computed = await runDerivedOperation(context, contract.name, () => compareBundles(left.value, right.value, parsed.record_pairs, parsed.offset, parsed.limit));
22
+ const computed = await runDerivedOperation(context, contract.name, () => compareBundles(left.value, right.value, input.record_pairs));
27
23
  if (!computed.ok)
28
24
  return toCallToolResult(computed, contract);
29
25
  const comparison = computed.value;
30
26
  const evidence = createEvidence(undefined, BUNDLE_COMPARISON_PROVIDER, {
31
- predicateType: "rea.bundle-comparison/v1",
27
+ predicateType: "rea.bundle-comparison",
32
28
  operation: contract.name,
33
29
  parameters: {
34
30
  left_bundle_sha256: comparison.left_bundle_sha256,
35
31
  right_bundle_sha256: comparison.right_bundle_sha256,
36
- record_pairs: parsed.record_pairs,
37
- offset: parsed.offset,
38
- limit: parsed.limit,
32
+ record_pairs: input.record_pairs,
39
33
  },
40
34
  result: jsonValueSchema.parse(comparison),
41
35
  confidence: "derived",
@@ -1,51 +1,29 @@
1
1
  import { writeAnalysisSnapshot } from "../application/AnalysisSnapshotFiles.js";
2
- import { closeBinaryInputSchema } from "../contracts/sessionLifecycleInputs.js";
3
2
  import { ok } from "../domain/result.js";
4
3
  import { reportLifecycleEnd, reportLifecycleStart, } from "./lifecycleProgress.js";
5
- import { logToolExecution } from "./toolLogging.js";
6
- import { toCallToolResult } from "./toolResult.js";
7
4
  import { mcpProgressReporter } from "./mcpProgress.js";
8
- import { permissionFailure } from "./permissionFailure.js";
9
- import { safeParseToolInput } from "./toolInputValidation.js";
5
+ import { logToolExecution } from "./toolLogging.js";
10
6
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
7
+ import { toCallToolResult } from "./toolResult.js";
11
8
  /** Register provider cleanup and optional pre-close snapshot persistence. */
12
- export const registerCloseLifecycleTool = ({ server, session, logger, contracts: [, closeContract], snapshotFilePolicy, permissionAuthority, }) => {
9
+ export const registerCloseLifecycleTool = ({ server, session, logger, contracts: [, closeContract], }) => {
13
10
  server.registerTool(closeContract.name, toolRegistrationOptions(closeContract), async (input, context) => {
14
- const parsedInput = safeParseToolInput(closeBinaryInputSchema, input, closeContract.name);
15
- if (!parsedInput.ok)
16
- return toCallToolResult(parsedInput, closeContract);
17
- const parsed = parsedInput.value;
18
11
  const progress = mcpProgressReporter(context);
19
- if (parsed.snapshot_path === undefined) {
12
+ if (input.snapshot_path === undefined) {
20
13
  await reportLifecycleStart(progress, closeContract.name);
21
14
  const closed = await logToolExecution(logger, closeContract.name, () => session.close({ progress }));
22
15
  await reportLifecycleEnd(progress, closeContract.name, closed.ok);
23
- server.sendToolListChanged();
24
16
  return toCallToolResult(closed, closeContract);
25
17
  }
26
- if (permissionAuthority !== undefined) {
27
- const authorized = await permissionAuthority.authorize({
28
- capability: "snapshot_write",
29
- roots: [parsed.snapshot_path],
30
- executables: [],
31
- environment_names: [],
32
- network: "none",
33
- mount: false,
34
- operation_identity: `close_binary:snapshot:${parsed.snapshot_path}`,
35
- }, "write");
36
- if (!authorized.ok)
37
- return toCallToolResult(permissionFailure(authorized), closeContract);
38
- }
39
18
  const snapshot = session.exportAnalysisSnapshot();
40
19
  if (!snapshot.ok)
41
20
  return toCallToolResult(snapshot, closeContract);
42
- const written = await writeAnalysisSnapshot(snapshot.value, parsed.snapshot_path, parsed.overwrite, snapshotFilePolicy);
21
+ const written = await writeAnalysisSnapshot(snapshot.value, input.snapshot_path, input.overwrite);
43
22
  if (!written.ok)
44
23
  return toCallToolResult(written, closeContract);
45
24
  await reportLifecycleStart(progress, closeContract.name, "snapshot written; closing provider");
46
25
  const closed = await logToolExecution(logger, closeContract.name, () => session.close({ progress }));
47
26
  await reportLifecycleEnd(progress, closeContract.name, closed.ok);
48
- server.sendToolListChanged();
49
27
  return closed.ok
50
28
  ? toCallToolResult(ok({
51
29
  path: written.value.path,
@@ -1,77 +1,41 @@
1
+ import { captureElectronScenario } from "../application/ElectronActiveObservationService.js";
2
+ import { inspectElectronPage, listElectronTargets, } from "../application/ElectronObservationService.js";
1
3
  import { analyzeJavaScriptApplicationValidated } from "../application/JavaScriptApplicationService.js";
2
4
  import { reconcileJavaScriptRuntimeEvidenceValidated } from "../application/JavaScriptRuntimeReconciliationService.js";
3
- import { inspectElectronPage, listElectronTargets, } from "../application/ElectronObservationService.js";
4
- import { analyzeJavaScriptApplicationToolInputSchema, ELECTRON_TOOL_CONTRACTS, } from "../contracts/electronToolContracts.js";
5
- import { inspectElectronPageInputSchema, listElectronTargetsInputSchema, } from "../domain/electronObservation.js";
6
- import { reconcileJavaScriptRuntimeInputSchema } from "../domain/javascriptRuntimeReconciliationSchemas.js";
5
+ import { ELECTRON_TOOL_CONTRACTS } from "../contracts/electronToolContracts.js";
6
+ import { inspectElectronPageInputSchema } from "../domain/electronObservation.js";
7
+ import { mcpProgressReporter } from "./mcpProgress.js";
7
8
  import { logToolExecution } from "./toolLogging.js";
8
- import { toCallToolResult } from "./toolResult.js";
9
9
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
10
- import { safeParseToolInput } from "./toolInputValidation.js";
11
- import { mcpProgressReporter } from "./mcpProgress.js";
12
- import { summarizeJavaScriptApplicationEvidence } from "./javascriptApplicationResult.js";
10
+ import { toCallToolResult } from "./toolResult.js";
13
11
  /** Register Electron tools even when provider or permission policy is absent. */
12
+ // oxlint-disable-next-line max-lines-per-function -- direct SDK calls retain each schema-handler type correlation.
14
13
  export const registerElectronTools = (server, options) => {
15
- const [listContract, inspectContract, analyzeContract, reconcileContract] = ELECTRON_TOOL_CONTRACTS;
16
- registerElectronTool(server, options, {
17
- contract: listContract,
18
- schema: listElectronTargetsInputSchema,
19
- execute: (parsed, { signal }) => listElectronTargets(options.electron, options.permissionAuthority, parsed, {
20
- signal,
21
- }),
22
- });
23
- registerElectronTool(server, options, {
24
- contract: inspectContract,
25
- schema: inspectElectronPageInputSchema,
26
- execute: (parsed, { signal, progress }) => inspectElectronPage(options.electron, options.permissionAuthority, parsed, {
27
- signal,
28
- progress,
29
- }),
30
- });
31
- registerElectronTool(server, options, {
32
- contract: analyzeContract,
33
- schema: analyzeJavaScriptApplicationToolInputSchema,
34
- execute: (parsed, { signal, progress }) => analyzeJavaScriptApplicationValidated(options.permissionAuthority, parsed, { signal, progress }),
35
- projectEvidence: (evidence, parsed) => {
36
- const summary = summarizeJavaScriptApplicationEvidence(evidence);
37
- return parsed.detail === "full"
38
- ? { structured: evidence.normalized_result, text: summary }
39
- : { structured: summary };
40
- },
41
- });
42
- registerElectronTool(server, options, {
43
- contract: reconcileContract,
44
- schema: reconcileJavaScriptRuntimeInputSchema,
45
- execute: (parsed, _context) => Promise.resolve(reconcileJavaScriptRuntimeEvidenceValidated(parsed)),
46
- });
14
+ const [listContract, inspectContract, analyzeContract, reconcileContract, activeContract,] = ELECTRON_TOOL_CONTRACTS;
15
+ server.registerTool(listContract.name, toolRegistrationOptions(listContract), (input, context) => runElectronTool(options, listContract, { input, context }, (parsed, { signal }) => listElectronTargets(options.electron, options.permissionAuthority, parsed, {
16
+ signal,
17
+ })));
18
+ server.registerTool(inspectContract.name, toolRegistrationOptions(inspectContract), (input, context) => runElectronTool(options, inspectContract, { input, context }, async (parsed, { signal, progress }) => {
19
+ const request = inspectElectronPageInputSchema.parse(parsed);
20
+ return inspectElectronPage(options.electron, options.permissionAuthority, request, { signal, progress });
21
+ }));
22
+ server.registerTool(analyzeContract.name, toolRegistrationOptions(analyzeContract), (input, context) => runElectronTool(options, analyzeContract, { input, context }, (parsed, { signal, progress }) => analyzeJavaScriptApplicationValidated(parsed, { signal, progress })));
23
+ server.registerTool(reconcileContract.name, toolRegistrationOptions(reconcileContract), (input, context) => runElectronTool(options, reconcileContract, { input, context }, (parsed) => Promise.resolve(reconcileJavaScriptRuntimeEvidenceValidated(parsed))));
24
+ server.registerTool(activeContract.name, toolRegistrationOptions(activeContract), (input, context) => runElectronTool(options, activeContract, { input, context }, (parsed, { signal, progress }) => captureElectronScenario(options.electronActive, options.permissionAuthority, parsed, { signal, progress })));
47
25
  };
48
- const registerElectronTool = (server, options, spec) => {
49
- server.registerTool(spec.contract.name, toolRegistrationOptions(spec.contract), async (input, context) => {
50
- const parsedInput = safeParseToolInput(spec.schema, input, spec.contract.name);
51
- if (!parsedInput.ok)
52
- return toCallToolResult(parsedInput, spec.contract);
53
- const result = await logToolExecution(options.logger, spec.contract.name, () => spec.execute(parsedInput.value, {
54
- signal: context.mcpReq.signal,
55
- progress: mcpProgressReporter(context),
56
- }));
57
- if (!result.ok)
58
- return toCallToolResult(result, spec.contract);
59
- return evidenceResult(options, spec.contract, result.value, spec.projectEvidence?.(result.value, parsedInput.value));
60
- });
26
+ const runElectronTool = async (options, contract, request, execute) => {
27
+ const { input, context } = request;
28
+ const result = await logToolExecution(options.logger, contract.name, () => execute(input, {
29
+ signal: context.mcpReq.signal,
30
+ progress: mcpProgressReporter(context),
31
+ }));
32
+ if (!result.ok)
33
+ return toCallToolResult(result, contract);
34
+ return evidenceResult(options, contract, result.value);
61
35
  };
62
- const evidenceResult = (options, contract, evidence, projection) => {
36
+ const evidenceResult = (options, contract, evidence) => {
63
37
  const recorded = options.recordEvidence?.(evidence);
64
38
  return recorded !== undefined && !recorded.ok
65
39
  ? toCallToolResult(recorded, contract)
66
- : toCallToolResult({ ok: true, value: evidence }, contract, {
67
- evidenceResourcesAvailable: recorded !== undefined,
68
- ...(projection === undefined
69
- ? {}
70
- : {
71
- evidenceResultProjection: projection.structured,
72
- ...(projection.text === undefined
73
- ? {}
74
- : { evidenceTextProjection: projection.text }),
75
- }),
76
- });
40
+ : toCallToolResult({ ok: true, value: evidence }, contract);
77
41
  };