rea-agents 5.0.0 → 6.1.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 (507) hide show
  1. package/README.md +168 -655
  2. package/bridge/android/ReaJadxBridge.java +14 -5
  3. package/bridge/ghidra/ReaGhidraBridge.java +173 -47
  4. package/bridge/hopper_bridge.py +310 -128
  5. package/bridge/mitmproxy/capture.py +208 -0
  6. package/bridge/native/rea_lldb_tracer.py +839 -0
  7. package/bridge/process/ProcessRunTokenReader.swift +297 -0
  8. package/bridge/process/ProcessRunTokenReaderMain.swift +35 -0
  9. package/bridge/pwndbg/core_context.py +101 -0
  10. package/bridge/pwndbg/launch.py +39 -0
  11. package/bridge/pwndbg/launch_impl.py +34 -0
  12. package/bridge/pwntools/decoder_runtime.py +59 -0
  13. package/bridge/pwntools/layout.py +39 -0
  14. package/bridge/pwntools/layout_impl.py +309 -0
  15. package/bridge/pwntools/recorded_crash.py +39 -0
  16. package/bridge/pwntools/recorded_crash_impl.py +147 -0
  17. package/dist/android/JadxConfiguration.js +196 -33
  18. package/dist/android/JadxMcpTransport.js +4 -0
  19. package/dist/android/JadxProtocol.js +6 -0
  20. package/dist/android/JadxProvider.js +20 -2
  21. package/dist/android/JadxSession.js +23 -4
  22. package/dist/application/AnalysisContextQueries.js +8 -35
  23. package/dist/application/AnalysisDocument.js +32 -0
  24. package/dist/application/AppBundleExecutable.js +67 -21
  25. package/dist/application/CallPathTracing.js +19 -3
  26. package/dist/application/CapabilityInventory.js +27 -3
  27. package/dist/application/ClientConfigurationDocument.js +871 -6
  28. package/dist/application/ClientRegistrationIdentity.js +26 -5
  29. package/dist/application/ClientRegistrationStatus.js +29 -14
  30. package/dist/application/DirectAnalysis.js +97 -33
  31. package/dist/application/Doctor.js +4 -2
  32. package/dist/application/DoctorScope.js +25 -13
  33. package/dist/application/EnhancedLiteralTracing.js +22 -25
  34. package/dist/application/EnhancedTools.js +13 -11
  35. package/dist/application/EvidenceBundleFiles.js +24 -12
  36. package/dist/application/FunctionAnalysisEvidence.js +2 -3
  37. package/dist/application/InventoryProjectionEvidence.js +4 -3
  38. package/dist/application/InvestigationProviders.js +3 -2
  39. package/dist/application/JsonFiles.js +50 -28
  40. package/dist/application/ProcedureAddressResolution.js +11 -0
  41. package/dist/application/ReconstructionCoverageService.js +7 -4
  42. package/dist/application/ReconstructionObligationCandidates.js +5 -1
  43. package/dist/application/ReconstructionObligationLedgerService.js +4 -3
  44. package/dist/application/Setup.js +13 -1
  45. package/dist/application/SetupClientConfiguration.js +10 -15
  46. package/dist/application/SetupHost.js +5 -2
  47. package/dist/application/SetupPlan.js +5 -3
  48. package/dist/application/SupportedClients.js +34 -1
  49. package/dist/application/Uninstall.js +4 -3
  50. package/dist/application/Update.js +18 -3
  51. package/dist/application/UpdateRuntime.js +46 -25
  52. package/dist/application/WebModuleTraceService.js +4 -2
  53. package/dist/application/WebNetworkCapturePort.js +1 -0
  54. package/dist/application/WebNetworkCaptureService.js +134 -0
  55. package/dist/application/WebRuntimeService.js +5 -3
  56. package/dist/application/WebScriptExportService.js +2 -2
  57. package/dist/application/WebSourceLocationService.js +4 -2
  58. package/dist/application/WindowsCapabilities.js +1 -1
  59. package/dist/application/WorkflowEvidence.js +82 -0
  60. package/dist/application/binary/AnalysisProviderEvaluation.js +21 -5
  61. package/dist/application/binary/AnalysisProviderRegistry.js +2 -0
  62. package/dist/application/binary/AnalysisSnapshotCache.js +52 -12
  63. package/dist/application/binary/BinarySession.js +131 -76
  64. package/dist/application/binary/BinarySessionOpen.js +19 -6
  65. package/dist/application/binary/BinarySessionRecords.js +45 -3
  66. package/dist/application/binary/BinarySessionStatus.js +17 -1
  67. package/dist/application/binary/CompositeProvider.js +13 -0
  68. package/dist/application/binary/LazyAnalysisProvider.js +3 -0
  69. package/dist/application/binaryDiagnostics/BinaryLayoutPort.js +1 -0
  70. package/dist/application/binaryDiagnostics/BinaryLayoutService.js +59 -0
  71. package/dist/application/binaryDiagnostics/RecordedCrashPort.js +1 -0
  72. package/dist/application/binaryDiagnostics/RecordedCrashService.js +62 -0
  73. package/dist/application/evm/EvmInterfacePort.js +1 -0
  74. package/dist/application/evm/EvmInterfaceService.js +64 -0
  75. package/dist/application/investigation/EvidenceLedger.js +21 -7
  76. package/dist/application/investigation/InvestigationRecords.js +8 -0
  77. package/dist/application/javascript/JavaScriptAnalysisControl.js +34 -0
  78. package/dist/application/javascript/JavaScriptApplicationEvidence.js +25 -5
  79. package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
  80. package/dist/application/javascript/JavaScriptApplicationService.js +34 -14
  81. package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
  82. package/dist/application/javascript/JavaScriptArtifactAnalysis.js +47 -27
  83. package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +39 -7
  84. package/dist/application/javascript/JavaScriptArtifactGraphDocuments.js +26 -2
  85. package/dist/application/javascript/JavaScriptArtifactPathResolution.js +80 -27
  86. package/dist/application/javascript/JavaScriptArtifactReconstruction.js +33 -12
  87. package/dist/application/javascript/JavaScriptModuleRelationships.js +37 -8
  88. package/dist/application/javascript/JavaScriptRecoveryService.js +4 -2
  89. package/dist/application/javascript/JavaScriptRuntimeObservationService.js +3 -1
  90. package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +3 -3
  91. package/dist/application/javascript/JavaScriptSemanticGraphAsyncProjection.js +7 -7
  92. package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +149 -72
  93. package/dist/application/javascript/JavaScriptSemanticGraphChildProcessProjection.js +14 -15
  94. package/dist/application/javascript/JavaScriptSemanticGraphConstruction.js +41 -1
  95. package/dist/application/javascript/JavaScriptSemanticGraphDataProjection.js +7 -7
  96. package/dist/application/javascript/JavaScriptSemanticGraphFlowProjection.js +5 -9
  97. package/dist/application/javascript/JavaScriptSemanticGraphObjectProjection.js +3 -3
  98. package/dist/application/javascript/JavaScriptSemanticGraphProjection.js +118 -12
  99. package/dist/application/javascript/JavaScriptSemanticGraphResourceProjection.js +3 -3
  100. package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +27 -5
  101. package/dist/application/managed/ManagedApplicationGraphService.js +4 -3
  102. package/dist/application/managed/ManagedMemberComparisonService.js +7 -4
  103. package/dist/application/managed/ManagedNativeVerificationService.js +4 -3
  104. package/dist/application/managed/ManagedReconstructionService.js +4 -3
  105. package/dist/application/{ProcessCli.js → process/ProcessCli.js} +23 -15
  106. package/dist/application/{ProcessEvidence.js → process/ProcessEvidence.js} +8 -7
  107. package/dist/application/workflowInputError.js +18 -0
  108. package/dist/artifacts/ArtifactProvider.js +42 -5
  109. package/dist/artifacts/ArtifactProviderMetadata.js +2 -1
  110. package/dist/artifacts/MachOSliceArtifactReader.js +98 -14
  111. package/dist/artifacts/NativeDmgArtifactReader.js +13 -6
  112. package/dist/artifacts/ZipArtifactReader.js +3 -0
  113. package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +22 -3
  114. package/dist/artifacts/apple/DylibResolutionReader.js +259 -0
  115. package/dist/artifacts/apple/InterfaceBuilderAnalysis.js +176 -56
  116. package/dist/artifacts/apple/InterfaceBuilderDecodeBudget.js +195 -0
  117. package/dist/artifacts/apple/KeyedArchiveReader.js +36 -22
  118. package/dist/artifacts/apple/MachoLoadCommandReader.js +355 -0
  119. package/dist/artifacts/apple/NibArchive.js +81 -14
  120. package/dist/artifacts/apple/NibViewHierarchy.js +10 -3
  121. package/dist/artifacts/apple/PlistNumberLiterals.js +164 -0
  122. package/dist/{application → artifacts/extraction}/ArtifactExtraction.js +10 -10
  123. package/dist/{application → artifacts/inventory}/ArtifactGraphConstruction.js +16 -11
  124. package/dist/{application → artifacts/inventory}/ArtifactInventory.js +4 -4
  125. package/dist/{application/ArtifactInventory → artifacts/inventory}/classify.js +2 -2
  126. package/dist/{application/ArtifactInventory → artifacts/inventory}/reader.js +5 -5
  127. package/dist/{application/ArtifactInventory → artifacts/inventory}/scanCanonical.js +14 -17
  128. package/dist/{application/ArtifactInventory → artifacts/inventory}/scanReader.js +5 -5
  129. package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
  130. package/dist/artifacts/readStableArtifact.js +20 -4
  131. package/dist/browser/CdpCaptureCompleteness.js +2 -0
  132. package/dist/browser/CdpCaptureEventHandlers.js +165 -12
  133. package/dist/browser/CdpCaptureEventTypes.js +5 -1
  134. package/dist/browser/CdpCaptureEvents.js +34 -0
  135. package/dist/browser/CdpConnection.js +30 -11
  136. package/dist/browser/CdpOptionalCommand.js +2 -3
  137. package/dist/browser/CdpPageCapture.js +23 -1
  138. package/dist/browser/PlaywrightElectronActiveActions.js +32 -23
  139. package/dist/browser/PlaywrightElectronActiveProjection.js +141 -0
  140. package/dist/browser/PlaywrightElectronActiveProvider.js +130 -122
  141. package/dist/browser/WebSourceMapFetcher.js +426 -72
  142. package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
  143. package/dist/browser/history/CaptureFailures.js +137 -0
  144. package/dist/browser/history/CaptureFormatError.js +10 -0
  145. package/dist/browser/history/CaptureRedaction.js +65 -0
  146. package/dist/browser/history/CaptureRelease.js +17 -0
  147. package/dist/browser/history/HarCapture.js +165 -0
  148. package/dist/browser/history/HarCaptureAdapter.js +20 -0
  149. package/dist/browser/history/HarCaptureProcess.js +57 -0
  150. package/dist/browser/history/HarJson.js +92 -0
  151. package/dist/browser/history/HarSchema.js +72 -0
  152. package/dist/browser/history/HistoricalCaptureDecoder.js +188 -0
  153. package/dist/browser/history/HistoricalCaptureFormatAdapter.js +1 -0
  154. package/dist/browser/history/MitmproxyCaptureAdapter.js +42 -0
  155. package/dist/cli/analysisSelector.js +23 -0
  156. package/dist/cli/applicationCommands.js +2 -3
  157. package/dist/cli/artifactCommands.js +26 -1
  158. package/dist/cli/binaryDiagnosticsCommands.js +39 -0
  159. package/dist/cli/coreAnalysisCommands.js +2 -2
  160. package/dist/cli/coreBinaryCommands.js +78 -20
  161. package/dist/cli/electronCommands.js +21 -13
  162. package/dist/cli/evmCommands.js +24 -0
  163. package/dist/cli/firmwareCommands.js +6 -3
  164. package/dist/cli/javascriptApplicationAnalysis.js +20 -3
  165. package/dist/cli/jsonOutput.js +38 -0
  166. package/dist/cli/nativeCallCommands.js +34 -0
  167. package/dist/cli/processCommands.js +1 -1
  168. package/dist/cli/streamedJsonOutput.js +56 -0
  169. package/dist/cli/utilityCommands.js +2 -0
  170. package/dist/cli/webNetworkCaptureCommands.js +40 -0
  171. package/dist/cli/webRuntimeCommands.js +8 -8
  172. package/dist/cli.js +11 -4
  173. package/dist/cliBrowserScenarioCommands.js +2 -2
  174. package/dist/cliCommandNames.js +6 -1
  175. package/dist/cliJsonInput.js +35 -1
  176. package/dist/cliOutput.js +21 -6
  177. package/dist/composition/binaryDiagnostics.js +8 -0
  178. package/dist/composition/evm.js +4 -0
  179. package/dist/composition/webNetworkCaptures.js +6 -0
  180. package/dist/config/environment.js +4 -0
  181. package/dist/config/ghidraStartupTimeout.js +17 -0
  182. package/dist/config/mcpResponseBudget.js +22 -0
  183. package/dist/config/parseConfig.js +2 -1
  184. package/dist/contracts/artifactToolContracts.js +6 -0
  185. package/dist/contracts/browserCaptureToolInputSchema.js +43 -0
  186. package/dist/contracts/browserToolContracts.js +4 -3
  187. package/dist/contracts/enhancedInputs.js +5 -3
  188. package/dist/contracts/enhancedToolContracts.js +3 -3
  189. package/dist/contracts/errorSchemas.js +8 -1
  190. package/dist/contracts/evm/evmToolContracts.js +20 -0
  191. package/dist/contracts/hopperMemoryContracts.js +2 -5
  192. package/dist/contracts/investigationExamples.js +2 -2
  193. package/dist/contracts/javascript/electronToolContracts.js +1 -1
  194. package/dist/contracts/managed/managedToolContracts.js +8 -6
  195. package/dist/contracts/native/binaryDiagnosticsToolContracts.js +42 -0
  196. package/dist/contracts/native/nativeToolContracts.js +21 -3
  197. package/dist/contracts/officialToolContracts.js +26 -24
  198. package/dist/contracts/process/processCaptureExample.js +2 -0
  199. package/dist/contracts/promptContracts.js +3 -3
  200. package/dist/contracts/sessionLifecycleInputs.js +18 -5
  201. package/dist/contracts/sessionStatusContract.js +8 -2
  202. package/dist/contracts/sessionToolContracts.js +8 -3
  203. package/dist/contracts/sessionToolSchemas.js +8 -4
  204. package/dist/contracts/toolContractExamples.js +1 -2
  205. package/dist/contracts/toolContractHelpers.js +4 -1
  206. package/dist/contracts/toolContracts.js +6 -0
  207. package/dist/contracts/toolEffects.js +30 -1
  208. package/dist/contracts/toolOutputSchemaGroups.js +33 -28
  209. package/dist/contracts/toolOutputSchemaPrimitives.js +19 -1
  210. package/dist/contracts/toolSchemaMetadata.js +69 -10
  211. package/dist/contracts/webNetworkCaptureToolContracts.js +24 -0
  212. package/dist/domain/analysisErrorBase.js +22 -2
  213. package/dist/domain/analysisErrorCore.js +61 -5
  214. package/dist/domain/analysisErrorPresentation.js +95 -12
  215. package/dist/domain/analysisErrorProjection.js +148 -19
  216. package/dist/domain/analysisSnapshot.js +166 -2
  217. package/dist/domain/android/androidAnalysis.js +2 -4
  218. package/dist/domain/android/androidApplication.js +17 -9
  219. package/dist/domain/apple/appleApplication.js +41 -14
  220. package/dist/domain/apple/dyldEnvironment.js +73 -0
  221. package/dist/domain/apple/dyldPaths.js +81 -0
  222. package/dist/domain/apple/dylibResolution.js +478 -0
  223. package/dist/domain/apple/dylibResolutionFindings.js +77 -0
  224. package/dist/domain/apple/interfaceBuilderGraph.js +25 -13
  225. package/dist/domain/apple/interfaceBuilderKeyedArchive.js +13 -3
  226. package/dist/domain/apple/keyedArchive.js +9 -1
  227. package/dist/domain/apple/machoContainer.js +54 -0
  228. package/dist/domain/apple/plistNumbers.js +76 -0
  229. package/dist/domain/artifactIdentity.js +29 -0
  230. package/dist/domain/artifactInventoryEvidence.js +19 -24
  231. package/dist/domain/artifactPathSyntax.js +1 -1
  232. package/dist/domain/bridgeCandidateProjection.js +71 -0
  233. package/dist/domain/browserCompleteness.js +1 -0
  234. package/dist/domain/browserObservation.js +1 -1
  235. package/dist/domain/browserObservationError.js +24 -5
  236. package/dist/domain/browserObservationSchemas.js +13 -0
  237. package/dist/domain/browserScenarioValues.js +5 -2
  238. package/dist/domain/bundleComparison.js +3 -2
  239. package/dist/domain/callPathSchemas.js +1 -1
  240. package/dist/domain/canonicalDigest.js +13 -1
  241. package/dist/domain/canonicalJsonDigestSteps.js +133 -0
  242. package/dist/domain/canonicalOrdering.js +9 -5
  243. package/dist/domain/changedBehavior.js +9 -9
  244. package/dist/domain/comparisonSourceEvidence.js +40 -0
  245. package/dist/domain/comparisonStatus.js +2 -30
  246. package/dist/domain/configurationErrors.js +1 -1
  247. package/dist/domain/conformanceTrustGate.js +0 -16
  248. package/dist/domain/evidence.js +78 -11
  249. package/dist/domain/evidenceBundle.js +42 -1
  250. package/dist/domain/evidenceErrors.js +12 -1
  251. package/dist/domain/evm/evmInterface.js +63 -0
  252. package/dist/domain/explicitSensitiveFailure.js +108 -0
  253. package/dist/domain/explicitSensitiveValues.js +10 -0
  254. package/dist/domain/firmware/firmwareAnalysis.js +10 -4
  255. package/dist/domain/hopperErrors.js +23 -2
  256. package/dist/domain/hopperValues.js +51 -8
  257. package/dist/domain/immutableJson.js +114 -0
  258. package/dist/domain/inputIssueProjection.js +3 -0
  259. package/dist/domain/javascript/electronActiveObservation.js +37 -6
  260. package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
  261. package/dist/domain/javascript/htmlArtifactReferences.js +40 -0
  262. package/dist/domain/javascript/javascriptApplicationAnalysis.js +71 -23
  263. package/dist/domain/javascript/javascriptApplicationGraph.js +13 -0
  264. package/dist/domain/javascript/javascriptAstValues.js +20 -0
  265. package/dist/domain/javascript/javascriptExportShapeComparison.js +21 -5
  266. package/dist/domain/javascript/javascriptExportShapeVariants.js +0 -10
  267. package/dist/domain/javascript/javascriptRecovery.js +3 -8
  268. package/dist/domain/javascript/javascriptSemanticAnalysis.js +97 -2
  269. package/dist/domain/javascript/javascriptSemanticCoverage.js +6 -5
  270. package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +9 -17
  271. package/dist/domain/javascript/javascriptSemanticDataEffects.js +22 -5
  272. package/dist/domain/javascript/javascriptSemanticGraph.js +34 -5
  273. package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +1 -0
  274. package/dist/domain/javascript/javascriptSemanticPrimitives.js +25 -17
  275. package/dist/domain/javascript/javascriptSemanticQuerySchemas.js +8 -4
  276. package/dist/domain/javascript/javascriptSemanticResourceLimits.js +77 -0
  277. package/dist/domain/javascript/javascriptSemanticValues.js +83 -11
  278. package/dist/domain/javascript/javascriptSourceParser.js +6 -2
  279. package/dist/domain/javascript/javascriptStaticAnalysis.js +22 -17
  280. package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +5 -3
  281. package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +14 -4
  282. package/dist/domain/javascript/javascriptStaticAnalysisFindings.js +66 -7
  283. package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +28 -16
  284. package/dist/domain/javascript/javascriptStaticAnalysisState.js +3 -2
  285. package/dist/domain/jsonSerialization.js +109 -0
  286. package/dist/domain/jsonValue.js +91 -3
  287. package/dist/domain/localPath.js +8 -0
  288. package/dist/domain/managed/managedApplicationGraph.js +10 -10
  289. package/dist/domain/managed/managedInspectionEvidence.js +16 -0
  290. package/dist/domain/managed/managedMemberComparisonMatch.js +5 -9
  291. package/dist/domain/managed/managedNativeVerification.js +3 -9
  292. package/dist/domain/native/binaryLayout.js +357 -0
  293. package/dist/domain/native/fileOffsetPartialObservation.js +1 -0
  294. package/dist/domain/native/nativeCallObservation.js +186 -0
  295. package/dist/domain/native/nativeCallPartialObservation.js +33 -0
  296. package/dist/domain/native/objcSwiftMetadata.js +0 -39
  297. package/dist/domain/native/recordedCrash.js +266 -0
  298. package/dist/domain/native/recordedCrashNoteCoverage.js +73 -0
  299. package/dist/domain/{processCapture.js → process/processCapture.js} +143 -2
  300. package/dist/domain/{processCaptureExample.js → process/processCaptureExample.js} +5 -0
  301. package/dist/domain/process/processCaptureParsing.js +54 -0
  302. package/dist/domain/{processCaptureValidation.js → process/processCaptureValidation.js} +18 -2
  303. package/dist/domain/{processComparison.js → process/processComparison.js} +39 -5
  304. package/dist/domain/{processObservation.js → process/processObservation.js} +1 -1
  305. package/dist/domain/{processScenario.js → process/processScenario.js} +11 -10
  306. package/dist/domain/{processTraceSpecification.js → process/processTraceSpecification.js} +1 -1
  307. package/dist/domain/propertyListKeys.js +1 -1
  308. package/dist/domain/propertyListXmlText.js +19 -0
  309. package/dist/domain/providerAdapterError.js +1 -1
  310. package/dist/domain/providerOperationHealth.js +54 -0
  311. package/dist/domain/providerSelectionError.js +4 -2
  312. package/dist/domain/reconstructionVerification.js +9 -46
  313. package/dist/domain/reconstructionVerificationSchemas.js +3 -3
  314. package/dist/domain/residualUnknown.js +3 -2
  315. package/dist/domain/staticRuntimeCorrelation.js +9 -46
  316. package/dist/domain/webBundleAnalysis.js +20 -8
  317. package/dist/domain/webBundleAnalyzerInspection.js +13 -8
  318. package/dist/domain/webBundleAnalyzerResult.js +41 -2
  319. package/dist/domain/webCaptureDiff.js +1 -0
  320. package/dist/domain/webNetworkCapture.js +118 -0
  321. package/dist/domain/webNetworkCaptureCoordinates.js +58 -0
  322. package/dist/domain/webRuntime.js +19 -5
  323. package/dist/domain/webSourceLocation.js +1 -0
  324. package/dist/dotnet/ManagedExceptionRegionValidation.js +41 -0
  325. package/dist/dotnet/ManagedMemberInspector.js +4 -2
  326. package/dist/dotnet/ManagedMemberInspectorCore.js +38 -32
  327. package/dist/dotnet/ManagedMemberInstructionDecoder.js +23 -7
  328. package/dist/dotnet/ManagedMemberRows.js +14 -3
  329. package/dist/dotnet/ManagedMetadataHeaps.js +20 -2
  330. package/dist/dotnet/ManagedMetadataInventory.js +38 -28
  331. package/dist/dotnet/ManagedMetadataInventoryRows.js +24 -10
  332. package/dist/dotnet/ManagedMethodBodyReader.js +7 -1
  333. package/dist/dotnet/ManagedNativeBoundaryHelpers.js +15 -3
  334. package/dist/dotnet/ManagedNativeBoundaryInspector.js +3 -1
  335. package/dist/dotnet/ManagedPeReader.js +11 -0
  336. package/dist/evm/EvmBytecodeCarrier.js +21 -0
  337. package/dist/evm/EvmWorkerLimits.js +40 -0
  338. package/dist/evm/EvmoleFailures.js +126 -0
  339. package/dist/evm/EvmoleInterfaceAdapter.js +53 -0
  340. package/dist/evm/EvmoleInterfaceProvider.js +273 -0
  341. package/dist/evm/EvmoleInterfaceWorker.js +87 -0
  342. package/dist/evm/EvmoleRelease.js +16 -0
  343. package/dist/firmware/FirmwareCommand.js +1 -0
  344. package/dist/firmware/FirmwareFiles.js +1 -1
  345. package/dist/generatedPackageMetadata.js +2 -2
  346. package/dist/ghidra/GhidraAnalysisProfile.js +5 -0
  347. package/dist/ghidra/GhidraClient.js +47 -14
  348. package/dist/ghidra/GhidraDiagnostics.js +7 -7
  349. package/dist/ghidra/GhidraFunctionValues.js +10 -7
  350. package/dist/ghidra/GhidraInstallation.js +18 -21
  351. package/dist/ghidra/GhidraInventoryValues.js +14 -4
  352. package/dist/ghidra/GhidraJavaLaunch.js +62 -0
  353. package/dist/ghidra/GhidraLauncher.js +34 -16
  354. package/dist/ghidra/GhidraProvider.js +2 -2
  355. package/dist/ghidra/GhidraProviderCapabilities.js +15 -3
  356. package/dist/ghidra/GhidraProviderClient.js +23 -12
  357. package/dist/ghidra/GhidraSessionError.js +11 -7
  358. package/dist/ghidra/GhidraTargetSnapshot.js +47 -12
  359. package/dist/ghidra/GhidraTransport.js +20 -0
  360. package/dist/hopper/BridgeLauncher.js +33 -11
  361. package/dist/hopper/HopperAnalysisProfile.js +62 -4
  362. package/dist/hopper/HopperCleanup.js +15 -3
  363. package/dist/hopper/HopperClient.js +222 -14
  364. package/dist/hopper/HopperFileOffset.js +237 -0
  365. package/dist/hopper/HopperMachOImage.js +196 -0
  366. package/dist/hopper/HopperOperationStage.js +6 -0
  367. package/dist/hopper/HopperProvider.js +63 -9
  368. package/dist/hopper/HopperProviderCapabilities.js +19 -1
  369. package/dist/hopper/HopperRegexSearch.js +137 -0
  370. package/dist/hopper/HopperRegexWorker.js +27 -0
  371. package/dist/hopper/HopperRequestQueue.js +68 -19
  372. package/dist/hopper/HopperTargetLease.js +3 -2
  373. package/dist/hopper/LinuxPrivateDisplayProbe.js +4 -2
  374. package/dist/inspector/JavaScriptRuntimeScope.js +9 -1
  375. package/dist/inspector/V8InspectorCaptureProjection.js +8 -3
  376. package/dist/inspector/V8InspectorProvider.js +47 -11
  377. package/dist/javascript/recovery/WakaruCommand.js +3 -0
  378. package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
  379. package/dist/javascript/sourceMaps/SourceMapCommand.js +17 -0
  380. package/dist/javascript/sourceMaps/SourceMapFormat.js +79 -31
  381. package/dist/javascript/sourceMaps/TraceSourceMap.js +14 -28
  382. package/dist/mcpDoctor.js +62 -2
  383. package/dist/native/AppleDispatchCoverage.js +47 -6
  384. package/dist/native/AppleDispatchDecodeFacts.js +6 -0
  385. package/dist/native/AppleDispatchMetadata.js +6 -3
  386. package/dist/native/AppleMachoFixups.js +48 -24
  387. package/dist/native/AppleMachoSelection.js +32 -16
  388. package/dist/native/AppleObjcCategories.js +6 -2
  389. package/dist/native/AppleObjcDispatchFacets.js +5 -2
  390. package/dist/native/AppleObjcProperties.js +2 -1
  391. package/dist/native/AppleSwiftDispatchFacets.js +27 -21
  392. package/dist/native/AppleSwiftVtables.js +21 -15
  393. package/dist/native/CommandRunner.js +82 -84
  394. package/dist/native/LldbCallTracer.js +541 -0
  395. package/dist/native/LldbRetainedObservations.js +178 -0
  396. package/dist/native/NativeCallObservation.js +194 -0
  397. package/dist/native/NativeMacOSProvider.js +117 -20
  398. package/dist/native/NativeMacOSProviderMetadata.js +8 -3
  399. package/dist/native/SignatureTargetBinding.js +155 -0
  400. package/dist/native/parsers/lipo.js +71 -1
  401. package/dist/native/pwndbg/PwndbgCoreContext.js +180 -0
  402. package/dist/native/pwntools/PwntoolsDecoder.js +203 -0
  403. package/dist/native/pwntools/PwntoolsFailures.js +180 -0
  404. package/dist/native/pwntools/PwntoolsLayoutProvider.js +36 -0
  405. package/dist/native/pwntools/PwntoolsRecordedCrashProvider.js +75 -0
  406. package/dist/native/pwntools/PwntoolsRelease.js +19 -0
  407. package/dist/native/pwntools/PwntoolsResourceLimits.js +76 -0
  408. package/dist/native/pwntools/RecordedCrashSourceBindings.js +46 -0
  409. package/dist/native/pwntools/RecordedCrashStructureBindings.js +103 -0
  410. package/dist/process/DarwinProcessRunTokenReader.js +293 -0
  411. package/dist/process/ExecFileOutput.js +20 -0
  412. package/dist/process/OwnedCommand.js +118 -0
  413. package/dist/process/ProcessOwnership.js +431 -51
  414. package/dist/process/ProcessOwnershipObservation.js +209 -27
  415. package/dist/process/ProviderProcess.js +68 -10
  416. package/dist/{application → process/capture}/ProcessCaptureCapability.js +15 -0
  417. package/dist/{application → process/capture}/ProcessCaptureError.js +18 -2
  418. package/dist/process/capture/ProcessCaptureLifecycle.js +681 -0
  419. package/dist/{application → process/capture}/ProcessHarness.js +195 -29
  420. package/dist/{application → process/capture}/ProcessSampling.js +2 -2
  421. package/dist/server/EvidenceMcpServer.js +146 -0
  422. package/dist/server/createServer.js +37 -8
  423. package/dist/server/promptCompletion.js +10 -3
  424. package/dist/server/registerAndroidTools.js +2 -4
  425. package/dist/server/registerApplicationTools/helpers.js +2 -4
  426. package/dist/server/registerArtifactComparisonTool.js +11 -7
  427. package/dist/server/registerBinaryDiagnosticsTools.js +15 -0
  428. package/dist/server/registerBrowserScenarioTool.js +2 -4
  429. package/dist/server/registerBrowserTools.js +2 -4
  430. package/dist/server/registerBundleComparisonTool.js +2 -3
  431. package/dist/server/registerCloseLifecycleTool.js +8 -18
  432. package/dist/server/registerElectronTools.js +2 -4
  433. package/dist/server/registerEnhancedTools.js +18 -59
  434. package/dist/server/registerEvidenceTools.js +3 -5
  435. package/dist/server/registerEvmTools.js +15 -0
  436. package/dist/server/registerFirmwareTools.js +2 -4
  437. package/dist/server/registerFunctionComparisonTool.js +10 -6
  438. package/dist/server/registerInvestigationTools.js +7 -7
  439. package/dist/server/registerJavaScriptRecoveryTool.js +2 -4
  440. package/dist/server/registerJavaScriptRuntimeObservationTools.js +2 -4
  441. package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +2 -4
  442. package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +2 -4
  443. package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +2 -4
  444. package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +2 -4
  445. package/dist/server/registerOfficialTools.js +2 -4
  446. package/dist/server/registerProcessComparisonTool.js +72 -46
  447. package/dist/server/registerRecordedCrashTools.js +15 -0
  448. package/dist/server/registerSessionRecordTools.js +5 -6
  449. package/dist/server/registerSessionStatusTool.js +17 -3
  450. package/dist/server/registerSessionTools.js +13 -5
  451. package/dist/server/registerWebModuleTool.js +2 -4
  452. package/dist/server/registerWebNetworkCaptureTool.js +26 -0
  453. package/dist/server/registerWebRuntimeTools.js +3 -7
  454. package/dist/server/registerWebScriptTool.js +2 -4
  455. package/dist/server/registerWebSourceLocationTool.js +2 -4
  456. package/dist/server/runDerivedOperation.js +15 -3
  457. package/dist/server/sessionAvailabilityPolicy.js +3 -1
  458. package/dist/server/sessionToolPolicies.js +1 -1
  459. package/dist/server/toolRegistrationOptions.js +2 -2
  460. package/dist/server/toolResult.js +63 -11
  461. package/dist/server/toolResultEncoding.js +33 -0
  462. package/install.sh +1 -1
  463. package/native/windows/build/manifest.json +2 -2
  464. package/native/windows/build/rea-windows-x64.node +0 -0
  465. package/package.json +42 -9
  466. package/scripts/electron-active-hook-boundaries.cjs +18 -20
  467. package/scripts/electron-active-hook.cjs +241 -37
  468. package/scripts/rea.mjs +11 -3
  469. package/skills/reverse-engineer-anything/SKILL.md +32 -4
  470. package/skills/reverse-engineer-anything/references/javascript-applications.md +8 -1
  471. package/skills/reverse-engineer-anything/references/native-and-artifacts.md +29 -0
  472. package/third_party/README.md +60 -0
  473. package/third_party/evmole/LICENSE +21 -0
  474. package/third_party/evmole/README.md +22 -0
  475. package/third_party/pwndbg/LICENSE.md +21 -0
  476. package/third_party/pwndbg/README.md +23 -0
  477. package/third_party/pwntools/README.md +40 -0
  478. package/dist/application/AuthorizedArtifactInventory.js +0 -7
  479. package/dist/application/ProcessCaptureLifecycle.js +0 -299
  480. package/dist/application/StoreFileLock.js +0 -124
  481. package/dist/contracts/processCaptureExample.js +0 -2
  482. package/dist/domain/bytecodeProvider.js +0 -178
  483. package/dist/domain/customProtocolCapture.js +0 -137
  484. package/dist/domain/eventProcessTree.js +0 -225
  485. package/dist/domain/mobileApplicationInvestigation.js +0 -159
  486. package/dist/domain/packageAnalysis.js +0 -123
  487. package/dist/domain/peInspection.js +0 -197
  488. package/dist/domain/processCaptureParsing.js +0 -21
  489. package/dist/domain/protocolCapture.js +0 -217
  490. package/dist/domain/runtimeIdentification.js +0 -212
  491. package/dist/generatedMcpToolCatalog.js +0 -37
  492. package/dist/ghidra/GhidraDefaults.js +0 -2
  493. /package/dist/application/{ArtifactExtractionDestination.js → artifacts/ArtifactExtractionDestination.js} +0 -0
  494. /package/dist/{application/ArtifactInventory → artifacts/inventory}/policy.js +0 -0
  495. /package/dist/{application/ArtifactInventory → artifacts/inventory}/types.js +0 -0
  496. /package/dist/domain/{processEvidenceProvider.js → process/processEvidenceProvider.js} +0 -0
  497. /package/dist/domain/{processTraceComparison.js → process/processTraceComparison.js} +0 -0
  498. /package/dist/domain/{processTraceDimensionProjection.js → process/processTraceDimensionProjection.js} +0 -0
  499. /package/dist/domain/{processTraceEvaluation.js → process/processTraceEvaluation.js} +0 -0
  500. /package/dist/{application → process/capture}/FilesystemSnapshot.js +0 -0
  501. /package/dist/{application → process/capture}/ProcessCaptureEnvironment.js +0 -0
  502. /package/dist/{application → process/capture}/ProcessCaptureJournal.js +0 -0
  503. /package/dist/{application → process/capture}/ProcessFilesystemEffects.js +0 -0
  504. /package/dist/{application → process/capture}/ProcessNormalization.js +0 -0
  505. /package/dist/{application → process/capture}/ProcessScenarioRuntimeValidation.js +0 -0
  506. /package/dist/{application → process/capture}/ProcessTimer.js +0 -0
  507. /package/dist/{application → process/capture}/TerminalRenderer.js +0 -0
@@ -2,7 +2,7 @@ import { z } from "zod";
2
2
  import { uniqueSorted } from "../domain/canonicalOrdering.js";
3
3
  import { artifactInventoryResultSchema } from "../domain/artifactGraph.js";
4
4
  import { artifactInspectionResultSchema } from "../domain/artifactInspection.js";
5
- import { processCaptureSchema } from "../domain/processCapture.js";
5
+ import { parseProcessCapture } from "../domain/process/processCapture.js";
6
6
  const documentListSchema = z.array(z.string().min(1));
7
7
  const providerStatusSchema = z.object({
8
8
  providers: z.array(z.object({ id: z.string().min(1) })),
@@ -114,8 +114,15 @@ const evidenceValues = (kind, evidence) => {
114
114
  const isProcessCaptureEvidence = (evidence) => {
115
115
  if (evidence.operation !== "capture_process_scenario")
116
116
  return false;
117
- const capture = processCaptureSchema.safeParse(evidence.normalized_result);
118
- return capture.success;
117
+ try {
118
+ parseProcessCapture(evidence.normalized_result);
119
+ return true;
120
+ }
121
+ catch (cause) {
122
+ if (cause instanceof TypeError || cause instanceof z.ZodError)
123
+ return false;
124
+ throw cause;
125
+ }
119
126
  };
120
127
  const unknownCandidates = (session) => session === undefined
121
128
  ? []
@@ -2,7 +2,7 @@ import { AndroidAnalysisService } from "../application/android/AndroidAnalysisSe
2
2
  import { toolContract } from "../contracts/toolContracts.js";
3
3
  import { logToolExecution } from "./toolLogging.js";
4
4
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
5
- import { toCallToolResult } from "./toolResult.js";
5
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
6
6
  /** Bind Android handlers to their exact named contracts through shared workflows. */
7
7
  export const registerAndroidTools = (server, service, logger, recordEvidence) => {
8
8
  const handler = (contract) => {
@@ -12,9 +12,7 @@ export const registerAndroidTools = (server, service, logger, recordEvidence) =>
12
12
  if (!result.ok)
13
13
  return toCallToolResult(result, contract);
14
14
  const recorded = recordEvidence?.(result.value);
15
- return recorded !== undefined && !recorded.ok
16
- ? toCallToolResult(recorded, contract)
17
- : toCallToolResult(result, contract);
15
+ return toEvidenceToolResult(result.value, contract, recorded);
18
16
  };
19
17
  };
20
18
  const packageContract = toolContract("inspect_android_package");
@@ -1,12 +1,10 @@
1
1
  import { APPLICATION_TOOL_CONTRACTS } from "../../contracts/applicationToolContracts.js";
2
- import { toCallToolResult } from "../toolResult.js";
2
+ import { toEvidenceToolResult } from "../toolResult.js";
3
3
  export const recordResult = (options, contract, evidence, unknownKind) => {
4
4
  const recorded = unknownKind === undefined
5
5
  ? options.recordEvidence?.(evidence)
6
6
  : options.recordEvidenceWithUnknown?.(evidence, unknownRegistration(evidence, unknownKind));
7
- if (recorded !== undefined && !recorded.ok)
8
- return toCallToolResult(recorded, contract);
9
- return toCallToolResult({ ok: true, value: evidence }, contract);
7
+ return toEvidenceToolResult(evidence, contract, recorded);
10
8
  };
11
9
  const unknownRegistration = (evidence, kind) => ({
12
10
  question: kind === "application-version-comparison"
@@ -6,7 +6,7 @@ import { recordDerivedEvidence } from "./recordDerivedEvidence.js";
6
6
  import { runDerivedOperation } from "./runDerivedOperation.js";
7
7
  import { ARTIFACT_COMPARISON_PROVIDER } from "./sessionToolPolicies.js";
8
8
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
9
- import { toCallToolResult } from "./toolResult.js";
9
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
10
10
  /** Register Evidence-backed deterministic artifact comparison. */
11
11
  export const registerArtifactComparisonTool = (server, session, contract) => {
12
12
  server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
@@ -39,18 +39,22 @@ export const registerArtifactComparisonTool = (server, session, contract) => {
39
39
  limitations: comparison.limitations,
40
40
  evidenceLinks: [...leftEvidenceIds, ...rightEvidenceIds],
41
41
  });
42
- return toCallToolResult(recordDerivedEvidence(session, evidence, artifactUnknownInput(left, right, comparison.status)), contract);
42
+ return toEvidenceToolResult(evidence, contract, recordDerivedEvidence(session, evidence, artifactUnknownInput(left, right, comparison.status, evidence.evidence_id)));
43
43
  });
44
44
  };
45
- const artifactUnknownInput = (left, right, status) => {
46
- if (status === "unchanged" || left.evidence_id === right.evidence_id)
45
+ const artifactUnknownInput = (left, right, status, comparisonEvidenceId) => {
46
+ if (status === "unchanged")
47
47
  return undefined;
48
+ const contradictory = (status === "changed" || status === "contradiction") &&
49
+ left.evidence_id !== right.evidence_id;
48
50
  return {
49
- question: `Artifact comparison is ${status}`,
51
+ question: `Artifact comparison is ${status} (comparison ${comparisonEvidenceId})`,
50
52
  severity: status === "unknown" || status === "truncated" ? "high" : "medium",
51
53
  domain: "artifact-comparison",
52
- supporting_evidence_ids: [left.evidence_id],
53
- contradicting_evidence_ids: [right.evidence_id],
54
+ supporting_evidence_ids: contradictory
55
+ ? [left.evidence_id]
56
+ : [...new Set([left.evidence_id, right.evidence_id])],
57
+ contradicting_evidence_ids: contradictory ? [right.evidence_id] : [],
54
58
  required_authority: "shipped-artifact",
55
59
  required_confidence: "observed",
56
60
  required_environment: null,
@@ -0,0 +1,15 @@
1
+ import { toolContract } from "../contracts/toolContracts.js";
2
+ import { logToolExecution } from "./toolLogging.js";
3
+ import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
4
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
5
+ /** Bind offline layout inspection to its named contract and session Evidence owner. */
6
+ export const registerBinaryDiagnosticsTools = (server, service, logger, recordEvidence) => {
7
+ const contract = toolContract("inspect_binary_layout");
8
+ server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
9
+ const result = await logToolExecution(logger, contract.name, () => service.inspect(input, { signal: context.mcpReq.signal }));
10
+ if (!result.ok)
11
+ return toCallToolResult(result, contract);
12
+ const recorded = recordEvidence?.(result.value);
13
+ return toEvidenceToolResult(result.value, contract, recorded);
14
+ });
15
+ };
@@ -5,7 +5,7 @@ import { toolContract } from "../contracts/toolContracts.js";
5
5
  import { browserScenarioSchema } from "../domain/browserScenario.js";
6
6
  import { logToolExecution } from "./toolLogging.js";
7
7
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
8
- import { toCallToolResult } from "./toolResult.js";
8
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
9
9
  /** Register the browser scenario tool with execution-time provider diagnostics. */
10
10
  export const registerBrowserScenarioTool = (server, options) => {
11
11
  const contract = toolContract("capture_browser_scenario");
@@ -19,8 +19,6 @@ export const registerBrowserScenarioTool = (server, options) => {
19
19
  if (!result.ok)
20
20
  return toCallToolResult(result, contract);
21
21
  const recorded = options.recordEvidence?.(result.value);
22
- return recorded !== undefined && !recorded.ok
23
- ? toCallToolResult(recorded, contract)
24
- : toCallToolResult({ ok: true, value: result.value }, contract);
22
+ return toEvidenceToolResult(result.value, contract, recorded);
25
23
  });
26
24
  };
@@ -7,7 +7,7 @@ import { inspectWebPageInputSchema } from "../domain/browserObservation.js";
7
7
  import { mcpProgressReporter } from "./mcpProgress.js";
8
8
  import { logToolExecution } from "./toolLogging.js";
9
9
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
10
- import { toCallToolResult } from "./toolResult.js";
10
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
11
11
  /** Register browser tools with execution-time provider diagnostics. */
12
12
  // oxlint-disable-next-line max-lines-per-function -- direct SDK calls retain each schema-handler type correlation.
13
13
  export const registerBrowserTools = (server, options) => {
@@ -56,7 +56,5 @@ const runBrowserTool = async (options, contract, request, execute) => {
56
56
  };
57
57
  const evidenceResult = (options, contract, evidence) => {
58
58
  const recorded = options.recordEvidence?.(evidence);
59
- return recorded !== undefined && !recorded.ok
60
- ? toCallToolResult(recorded, contract)
61
- : toCallToolResult({ ok: true, value: evidence }, contract);
59
+ return toEvidenceToolResult(evidence, contract, recorded);
62
60
  };
@@ -3,11 +3,10 @@ import { toolContract } from "../contracts/toolContracts.js";
3
3
  import { compareBundles } from "../domain/bundleComparison.js";
4
4
  import { createEvidence } from "../domain/evidence.js";
5
5
  import { jsonValueSchema } from "../domain/jsonValue.js";
6
- import { ok } from "../domain/result.js";
7
6
  import { runDerivedOperation } from "./runDerivedOperation.js";
8
7
  import { BUNDLE_COMPARISON_PROVIDER } from "./sessionToolPolicies.js";
9
8
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
10
- import { toCallToolResult } from "./toolResult.js";
9
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
11
10
  /** Register canonical Evidence bundle comparison. */
12
11
  export const registerBundleComparisonTool = (server, session, contract) => {
13
12
  server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
@@ -37,6 +36,6 @@ export const registerBundleComparisonTool = (server, session, contract) => {
37
36
  limitations: comparison.limitations,
38
37
  });
39
38
  const recorded = session.recordEvidence(evidence);
40
- return toCallToolResult(recorded.ok ? ok(evidence) : recorded, contract);
39
+ return toEvidenceToolResult(evidence, contract, recorded);
41
40
  });
42
41
  };
@@ -1,6 +1,5 @@
1
- import { writeAnalysisSnapshot } from "../application/binary/AnalysisSnapshotFiles.js";
2
- import { ok } from "../domain/result.js";
3
1
  import { reportLifecycleEnd, reportLifecycleStart, } from "./lifecycleProgress.js";
2
+ import { ok } from "../domain/result.js";
4
3
  import { mcpProgressReporter } from "./mcpProgress.js";
5
4
  import { logToolExecution } from "./toolLogging.js";
6
5
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
@@ -9,27 +8,18 @@ import { toCallToolResult } from "./toolResult.js";
9
8
  export const registerCloseLifecycleTool = ({ server, session, logger, closeContract, }) => {
10
9
  server.registerTool(closeContract.name, toolRegistrationOptions(closeContract), async (input, context) => {
11
10
  const progress = mcpProgressReporter(context);
12
- if (input.snapshot_path === undefined) {
11
+ const snapshotPath = input.snapshot_path;
12
+ if (snapshotPath === undefined) {
13
13
  await reportLifecycleStart(progress, closeContract.name);
14
14
  const closed = await logToolExecution(logger, closeContract.name, () => session.close({ progress }));
15
15
  await reportLifecycleEnd(progress, closeContract.name, closed.ok);
16
16
  return toCallToolResult(closed, closeContract);
17
17
  }
18
- const snapshot = session.exportAnalysisSnapshot();
19
- if (!snapshot.ok)
20
- return toCallToolResult(snapshot, closeContract);
21
- const written = await writeAnalysisSnapshot(snapshot.value, input.snapshot_path, input.overwrite);
22
- if (!written.ok)
23
- return toCallToolResult(written, closeContract);
24
- await reportLifecycleStart(progress, closeContract.name, "snapshot written; closing provider");
25
- const closed = await logToolExecution(logger, closeContract.name, () => session.close({ progress }));
18
+ await reportLifecycleStart(progress, closeContract.name, "saving snapshot; closing provider");
19
+ const closed = await logToolExecution(logger, closeContract.name, () => session.closeWithSnapshot(snapshotPath, input.overwrite, {
20
+ progress,
21
+ }));
26
22
  await reportLifecycleEnd(progress, closeContract.name, closed.ok);
27
- return closed.ok
28
- ? toCallToolResult(ok({
29
- path: written.value.path,
30
- bytes: written.value.bytes,
31
- entries: snapshot.value.entries.length,
32
- }), closeContract)
33
- : toCallToolResult(closed, closeContract);
23
+ return toCallToolResult(closed.ok ? ok({ ...closed.value }) : closed, closeContract);
34
24
  });
35
25
  };
@@ -9,7 +9,7 @@ import { inspectElectronPageInputSchema } from "../domain/javascript/electronObs
9
9
  import { mcpProgressReporter } from "./mcpProgress.js";
10
10
  import { logToolExecution } from "./toolLogging.js";
11
11
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
12
- import { toCallToolResult } from "./toolResult.js";
12
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
13
13
  /** Register Electron tools even when a provider is absent. */
14
14
  // oxlint-disable-next-line max-lines-per-function -- direct SDK calls retain each schema-handler type correlation.
15
15
  export const registerElectronTools = (server, options) => {
@@ -55,7 +55,5 @@ const runElectronTool = async (options, contract, request, execute) => {
55
55
  };
56
56
  const evidenceResult = (options, contract, evidence) => {
57
57
  const recorded = options.recordEvidence?.(evidence);
58
- return recorded !== undefined && !recorded.ok
59
- ? toCallToolResult(recorded, contract)
60
- : toCallToolResult({ ok: true, value: evidence }, contract);
58
+ return toEvidenceToolResult(evidence, contract, recorded);
61
59
  };
@@ -1,12 +1,10 @@
1
1
  import { EnhancedTools, } from "../application/EnhancedTools.js";
2
- import { REA_WORKFLOW_PROVIDER, workflowAnalysisProfile, } from "../application/InvestigationProviders.js";
2
+ import { createWorkflowEvidence, workflowSnapshotRecord, recordWorkflowUnknowns, } from "../application/WorkflowEvidence.js";
3
3
  import { toolContract } from "../contracts/toolContracts.js";
4
- import { UnknownRegistryError } from "../domain/unknownRegistryError.js";
5
- import { createEvidence } from "../domain/evidence.js";
6
4
  import { mcpProgressReporter } from "./mcpProgress.js";
7
5
  import { logToolExecution } from "./toolLogging.js";
8
6
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
9
- import { toCallToolResult } from "./toolResult.js";
7
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
10
8
  import { executeFunctionAnalysisEvidence } from "../application/FunctionAnalysisEvidence.js";
11
9
  /** Register composed workflows against the same port as direct bridge tools. */
12
10
  // oxlint-disable-next-line max-lines-per-function -- direct SDK calls retain each schema-handler type correlation.
@@ -114,24 +112,25 @@ const executeEnhancedTool = async (analysis, registration, contract, request) =>
114
112
  terminal: true,
115
113
  });
116
114
  if (result.ok) {
117
- const upstreamProfile = registration.analysisProfile?.();
118
- const evidence = createEvidence(registration.activeTarget?.(), REA_WORKFLOW_PROVIDER, {
115
+ const evidence = createWorkflowEvidence({
116
+ target: registration.activeTarget?.(),
119
117
  operation: name,
120
118
  parameters,
121
119
  result: result.value,
122
- ...(upstreamProfile === undefined
123
- ? {}
124
- : {
125
- analysisProfile: workflowAnalysisProfile(upstreamProfile),
126
- }),
127
- confidence: "derived",
128
- limitations: [
129
- "Derived by an REA workflow from one or more provider observations.",
130
- ],
120
+ upstreamProfile: registration.analysisProfile?.(),
131
121
  });
132
122
  const recorded = registration.recordEvidence?.(evidence);
133
123
  if (recorded !== undefined && !recorded.ok)
134
124
  return toCallToolResult(recorded, contract);
125
+ if (name !== "trace_native_ui_action" &&
126
+ registration.allowsSnapshotReplay?.(name) === true) {
127
+ const workflowRecord = workflowSnapshotRecord(evidence, name);
128
+ if (workflowRecord !== undefined) {
129
+ const snapshot = registration.recordWorkflowSnapshot?.(workflowRecord);
130
+ if (snapshot !== undefined && !snapshot.ok)
131
+ return toCallToolResult(snapshot, contract);
132
+ }
133
+ }
135
134
  const unknowns = recordWorkflowUnknowns({
136
135
  name,
137
136
  result: result.value,
@@ -140,7 +139,7 @@ const executeEnhancedTool = async (analysis, registration, contract, request) =>
140
139
  });
141
140
  if (!unknowns.ok)
142
141
  return toCallToolResult(unknowns, contract);
143
- return toCallToolResult({ ok: true, value: evidence }, contract);
142
+ return toEvidenceToolResult(evidence, contract, recorded);
144
143
  }
145
144
  return toCallToolResult(result, contract);
146
145
  };
@@ -158,48 +157,8 @@ const executeFunctionTool = async (analysis, registration, contract, request) =>
158
157
  message: result.ok ? "completed" : "failed",
159
158
  terminal: true,
160
159
  });
161
- if (result.ok) {
162
- const recorded = registration.recordEvidence?.(result.value);
163
- if (recorded !== undefined && !recorded.ok)
164
- return toCallToolResult(recorded, contract);
165
- }
166
- return toCallToolResult(result, contract);
160
+ if (!result.ok)
161
+ return toCallToolResult(result, contract);
162
+ return toEvidenceToolResult(result.value, contract, registration.recordEvidence?.(result.value));
167
163
  };
168
164
  const jsonParameters = (input) => Object.fromEntries(Object.entries(input).filter((entry) => entry[1] !== undefined));
169
- const recordWorkflowUnknowns = ({ name, result, evidenceId, recordUnknown, }) => {
170
- if (!["trace_feature", "trace_call_path", "inspect_native_api"].includes(name) ||
171
- recordUnknown === undefined ||
172
- typeof result !== "object" ||
173
- result === null ||
174
- Array.isArray(result) ||
175
- !Array.isArray(result.residual_unknowns))
176
- return { ok: true, value: null };
177
- for (const question of result.residual_unknowns) {
178
- if (typeof question !== "string")
179
- continue;
180
- const recorded = recordUnknown({
181
- question,
182
- severity: "medium",
183
- domain: name === "inspect_native_api" ? "native-api" : "control-flow",
184
- supporting_evidence_ids: [evidenceId],
185
- contradicting_evidence_ids: [],
186
- required_authority: "shipped-artifact",
187
- required_confidence: "observed",
188
- required_environment: null,
189
- recommended_probes: [
190
- {
191
- operation: name,
192
- rationale: name === "inspect_native_api"
193
- ? "Confirm the unsupported boundary with a capable provider or ABI probe."
194
- : "Continue with a focused query or another available provider.",
195
- },
196
- ],
197
- relationships: [],
198
- });
199
- if (!recorded.ok &&
200
- !(recorded.error instanceof UnknownRegistryError &&
201
- recorded.error.reason === "already-exists"))
202
- return recorded;
203
- }
204
- return { ok: true, value: null };
205
- };
@@ -3,8 +3,8 @@ import { jsonObjectSchema } from "../domain/jsonValue.js";
3
3
  import { mcpProgressReporter } from "./mcpProgress.js";
4
4
  import { logToolExecution } from "./toolLogging.js";
5
5
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
6
- import { toCallToolResult } from "./toolResult.js";
7
- import { createArtifactExtractionDestination } from "../application/ArtifactExtractionDestination.js";
6
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
7
+ import { createArtifactExtractionDestination } from "../application/artifacts/ArtifactExtractionDestination.js";
8
8
  /** Register provider-backed contracts that return atomic Evidence observations. */
9
9
  export const registerEvidenceTools = (server, analysis, contracts, options) => {
10
10
  for (const contract of contracts) {
@@ -55,9 +55,7 @@ export const registerEvidenceTools = (server, analysis, contracts, options) => {
55
55
  return toCallToolResult(sourceRecorded, contract);
56
56
  }
57
57
  const recorded = options.recordEvidence?.(evidence);
58
- return recorded !== undefined && !recorded.ok
59
- ? toCallToolResult(recorded, contract)
60
- : toCallToolResult({ ok: true, value: evidence }, contract);
58
+ return toEvidenceToolResult(evidence, contract, recorded);
61
59
  });
62
60
  }
63
61
  };
@@ -0,0 +1,15 @@
1
+ import { toolContract } from "../contracts/toolContracts.js";
2
+ import { logToolExecution } from "./toolLogging.js";
3
+ import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
4
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
5
+ /** Bind the named EVM contract to shared validation and session Evidence recording. */
6
+ export const registerEvmTools = (server, service, logger, recordEvidence) => {
7
+ const contract = toolContract("inspect_evm_interface");
8
+ server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
9
+ const result = await logToolExecution(logger, contract.name, () => service.inspect(input, { signal: context.mcpReq.signal }));
10
+ if (!result.ok)
11
+ return toCallToolResult(result, contract);
12
+ const recorded = recordEvidence?.(result.value);
13
+ return toEvidenceToolResult(result.value, contract, recorded);
14
+ });
15
+ };
@@ -1,7 +1,7 @@
1
1
  import { toolContract } from "../contracts/toolContracts.js";
2
2
  import { logToolExecution } from "./toolLogging.js";
3
3
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
4
- import { toCallToolResult } from "./toolResult.js";
4
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
5
5
  /** Bind firmware handlers to their exact named schemas. */
6
6
  export const registerFirmwareTools = (server, service, logger, recordEvidence) => {
7
7
  const handler = (contract) => async (input, context) => {
@@ -11,9 +11,7 @@ export const registerFirmwareTools = (server, service, logger, recordEvidence) =
11
11
  if (!result.ok)
12
12
  return toCallToolResult(result, contract);
13
13
  const recorded = recordEvidence?.(result.value);
14
- return recorded !== undefined && !recorded.ok
15
- ? toCallToolResult(recorded, contract)
16
- : toCallToolResult(result, contract);
14
+ return toEvidenceToolResult(result.value, contract, recorded);
17
15
  };
18
16
  const inspect = toolContract("inspect_firmware_regions");
19
17
  server.registerTool(inspect.name, toolRegistrationOptions(inspect), handler(inspect));
@@ -9,7 +9,7 @@ import { recordSessionEvidenceSources } from "./sessionEvidence.js";
9
9
  import { runDerivedOperation } from "./runDerivedOperation.js";
10
10
  import { FUNCTION_COMPARISON_PROVIDER } from "./sessionToolPolicies.js";
11
11
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
12
- import { toCallToolResult } from "./toolResult.js";
12
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
13
13
  /** Register explicit Evidence-backed function comparison. */
14
14
  export const registerFunctionComparisonTool = (server, session, contract) => {
15
15
  server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
@@ -53,19 +53,23 @@ export const registerFunctionComparisonTool = (server, session, contract) => {
53
53
  status: comparison.status,
54
54
  leftIds,
55
55
  rightIds,
56
+ comparisonEvidenceId: evidence.evidence_id,
56
57
  }));
57
- return toCallToolResult(recorded, contract);
58
+ return toEvidenceToolResult(evidence, contract, recorded);
58
59
  });
59
60
  };
60
- const functionUnknownInput = ({ status, leftIds, rightIds, }) => {
61
+ const functionUnknownInput = ({ status, leftIds, rightIds, comparisonEvidenceId, }) => {
61
62
  if (status === "unchanged")
62
63
  return undefined;
64
+ const supportingIds = [...new Set([...leftIds, ...rightIds])];
65
+ const contradictingIds = rightIds.filter((id) => !leftIds.includes(id));
66
+ const contradictory = status === "changed";
63
67
  return {
64
- question: `Function comparison is ${status}`,
68
+ question: `Function comparison is ${status} (comparison ${comparisonEvidenceId})`,
65
69
  severity: status === "changed" ? "medium" : "high",
66
70
  domain: "function-comparison",
67
- supporting_evidence_ids: [...leftIds],
68
- contradicting_evidence_ids: [...rightIds],
71
+ supporting_evidence_ids: contradictory ? [...leftIds] : supportingIds,
72
+ contradicting_evidence_ids: contradictory ? contradictingIds : [],
69
73
  required_authority: "shipped-artifact",
70
74
  required_confidence: "observed",
71
75
  required_environment: null,
@@ -9,7 +9,7 @@ import { comparisonClosure, evidenceClosure, functionEvidenceIds, isIncomplete,
9
9
  import { runDerivedOperation } from "./runDerivedOperation.js";
10
10
  import { CALL_PATH_PROVIDER, CHANGED_BEHAVIOR_PROVIDER, RECONSTRUCTION_PROVIDER, STATIC_RUNTIME_PROVIDER, } from "./sessionToolPolicies.js";
11
11
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
12
- import { toCallToolResult } from "./toolResult.js";
12
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
13
13
  /** Register Evidence-composed differential investigation workflows. */
14
14
  export const registerInvestigationTools = (server, session) => {
15
15
  registerChangedBehavior(server, session, toolContract("find_changed_behavior"));
@@ -51,7 +51,7 @@ const registerChangedBehavior = (server, session, contract) => {
51
51
  },
52
52
  ],
53
53
  });
54
- return toCallToolResult(recorded, contract);
54
+ return toEvidenceToolResult(evidence, contract, recorded);
55
55
  });
56
56
  };
57
57
  const registerCallPath = (server, session, contract) => {
@@ -89,7 +89,7 @@ const registerCallPath = (server, session, contract) => {
89
89
  },
90
90
  ],
91
91
  });
92
- return toCallToolResult(recorded, contract);
92
+ return toEvidenceToolResult(evidence, contract, recorded);
93
93
  });
94
94
  };
95
95
  const registerStaticRuntime = (server, session, contract) => {
@@ -117,7 +117,7 @@ const registerStaticRuntime = (server, session, contract) => {
117
117
  limitations: result.limitations,
118
118
  evidenceLinks: links,
119
119
  });
120
- return toCallToolResult(recordWorkflowEvidence(session, evidence, result.status === "unknown" || result.status === "truncated", {
120
+ return toEvidenceToolResult(evidence, contract, recordWorkflowEvidence(session, evidence, result.status === "unknown" || result.status === "truncated", {
121
121
  question: "Does runtime behavior match the available static analysis?",
122
122
  domain: "static-runtime-correlation",
123
123
  requiredAuthority: null,
@@ -128,7 +128,7 @@ const registerStaticRuntime = (server, session, contract) => {
128
128
  rationale: "Repeat runtime observations and complete the mapped static comparison Evidence.",
129
129
  },
130
130
  ],
131
- }), contract);
131
+ }));
132
132
  });
133
133
  };
134
134
  const registerReconstruction = (server, session, contract) => {
@@ -155,7 +155,7 @@ const registerReconstruction = (server, session, contract) => {
155
155
  limitations: result.limitations,
156
156
  evidenceLinks: links,
157
157
  });
158
- return toCallToolResult(recordWorkflowEvidence(session, evidence, result.status === "unknown", {
158
+ return toEvidenceToolResult(evidence, contract, recordWorkflowEvidence(session, evidence, result.status === "unknown", {
159
159
  question: "Does the reconstruction satisfy every declared claim?",
160
160
  domain: "reconstruction-verification",
161
161
  requiredAuthority: null,
@@ -164,6 +164,6 @@ const registerReconstruction = (server, session, contract) => {
164
164
  operation,
165
165
  rationale,
166
166
  })),
167
- }), contract);
167
+ }));
168
168
  });
169
169
  };
@@ -1,7 +1,7 @@
1
1
  import { toolContract } from "../contracts/toolContracts.js";
2
2
  import { logToolExecution } from "./toolLogging.js";
3
3
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
4
- import { toCallToolResult } from "./toolResult.js";
4
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
5
5
  /** Bind optional recovery to its exact named contract without acquiring an engine. */
6
6
  export const registerJavaScriptRecoveryTool = (server, service, logger, recordEvidence) => {
7
7
  const contract = toolContract("recover_javascript_sources");
@@ -10,8 +10,6 @@ export const registerJavaScriptRecoveryTool = (server, service, logger, recordEv
10
10
  if (!result.ok)
11
11
  return toCallToolResult(result, contract);
12
12
  const recorded = recordEvidence?.(result.value);
13
- return recorded !== undefined && !recorded.ok
14
- ? toCallToolResult(recorded, contract)
15
- : toCallToolResult(result, contract);
13
+ return toEvidenceToolResult(result.value, contract, recorded);
16
14
  });
17
15
  };
@@ -5,7 +5,7 @@ import { toolContract } from "../contracts/toolContracts.js";
5
5
  import { observeJavaScriptRuntimeInputSchema } from "../domain/javascript/javascriptRuntimeObservation.js";
6
6
  import { logToolExecution } from "./toolLogging.js";
7
7
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
8
- import { toCallToolResult } from "./toolResult.js";
8
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
9
9
  /** Register passive Inspector tools even when policy keeps them unavailable. */
10
10
  export const registerJavaScriptRuntimeObservationTools = (server, options) => {
11
11
  const listContract = toolContract("list_javascript_runtime_targets");
@@ -24,7 +24,5 @@ const runRuntimeTool = async (options, contract, request, execute) => {
24
24
  if (!result.ok)
25
25
  return toCallToolResult(result, contract);
26
26
  const recorded = options.recordEvidence?.(result.value);
27
- return recorded !== undefined && !recorded.ok
28
- ? toCallToolResult(recorded, contract)
29
- : toCallToolResult({ ok: true, value: result.value }, contract);
27
+ return toEvidenceToolResult(result.value, contract, recorded);
30
28
  };
@@ -3,7 +3,7 @@ import { compareManagedMembersEvidenceValidated } from "../../application/manage
3
3
  import { managedMemberComparisonResultSchema } from "../../domain/managed/managedMemberComparison.js";
4
4
  import { logToolExecution } from "../toolLogging.js";
5
5
  import { toolRegistrationOptions } from "../toolRegistrationOptions.js";
6
- import { toCallToolResult } from "../toolResult.js";
6
+ import { toCallToolResult, toEvidenceToolResult } from "../toolResult.js";
7
7
  import { managedWorkflowContract } from "./contract.js";
8
8
  import { resolveManagedEvidence } from "./evidence.js";
9
9
  const compareContract = managedWorkflowContract("compare_managed_members");
@@ -51,8 +51,6 @@ export const registerCompareManagedMembers = (server, options) => {
51
51
  relationships: [],
52
52
  })
53
53
  : options.recordEvidence?.(result.value);
54
- if (output !== undefined && !output.ok)
55
- return toCallToolResult(output, compareContract);
56
- return toCallToolResult({ ok: true, value: result.value }, compareContract);
54
+ return toEvidenceToolResult(result.value, compareContract, output);
57
55
  });
58
56
  };
@@ -1,7 +1,7 @@
1
1
  import { importManagedReconstructionEvidenceValidated } from "../../application/managed/ManagedReconstructionService.js";
2
2
  import { logToolExecution } from "../toolLogging.js";
3
3
  import { toolRegistrationOptions } from "../toolRegistrationOptions.js";
4
- import { toCallToolResult } from "../toolResult.js";
4
+ import { toCallToolResult, toEvidenceToolResult } from "../toolResult.js";
5
5
  import { managedWorkflowContract } from "./contract.js";
6
6
  import { resolveManagedEvidence } from "./evidence.js";
7
7
  const reconstructionContract = managedWorkflowContract("import_managed_reconstruction");
@@ -22,8 +22,6 @@ export const registerImportManagedReconstruction = (server, options) => {
22
22
  if (recordedSource !== undefined && !recordedSource.ok)
23
23
  return toCallToolResult(recordedSource, reconstructionContract);
24
24
  const recorded = options.recordEvidence?.(result.value);
25
- if (recorded !== undefined && !recorded.ok)
26
- return toCallToolResult(recorded, reconstructionContract);
27
- return toCallToolResult(result, reconstructionContract);
25
+ return toEvidenceToolResult(result.value, reconstructionContract, recorded);
28
26
  });
29
27
  };
@@ -2,7 +2,7 @@ import { recordSessionEvidenceSources } from "../sessionEvidence.js";
2
2
  import { projectManagedApplicationGraphEvidence } from "../../application/managed/ManagedApplicationGraphService.js";
3
3
  import { logToolExecution } from "../toolLogging.js";
4
4
  import { toolRegistrationOptions } from "../toolRegistrationOptions.js";
5
- import { toCallToolResult } from "../toolResult.js";
5
+ import { toCallToolResult, toEvidenceToolResult } from "../toolResult.js";
6
6
  import { managedWorkflowContract } from "./contract.js";
7
7
  import { resolveManagedArtifactEvidence, resolveManagedBoundaryEvidence, resolveManagedEvidence, sourceEvidence, } from "./evidence.js";
8
8
  const graphContract = managedWorkflowContract("project_managed_application_graph");
@@ -36,8 +36,6 @@ export const registerProjectManagedApplicationGraph = (server, options) => {
36
36
  if (!recordedSources.ok)
37
37
  return toCallToolResult(recordedSources, graphContract);
38
38
  const recorded = options.recordEvidence?.(result.value);
39
- if (recorded !== undefined && !recorded.ok)
40
- return toCallToolResult(recorded, graphContract);
41
- return toCallToolResult(result, graphContract);
39
+ return toEvidenceToolResult(result.value, graphContract, recorded);
42
40
  });
43
41
  };