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
@@ -3,7 +3,7 @@ import { verifyManagedNativeBoundariesEvidence } from "../../application/managed
3
3
  import { managedNativeVerificationResultSchema } from "../../domain/managed/managedNativeVerification.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 { resolveManagedBoundaryEvidence, resolveNativeEvidence, } from "./evidence.js";
9
9
  const nativeVerificationContract = managedWorkflowContract("verify_managed_native_boundaries");
@@ -57,8 +57,6 @@ export const registerVerifyManagedNativeBoundaries = (server, options) => {
57
57
  relationships: [],
58
58
  })
59
59
  : options.recordEvidence?.(result.value);
60
- if (output !== undefined && !output.ok)
61
- return toCallToolResult(output, nativeVerificationContract);
62
- return toCallToolResult(result, nativeVerificationContract);
60
+ return toEvidenceToolResult(result.value, nativeVerificationContract, output);
63
61
  });
64
62
  };
@@ -5,7 +5,7 @@ import { jsonObjectSchema, jsonValueSchema, } from "../domain/jsonValue.js";
5
5
  import { mcpProgressReporter } from "./mcpProgress.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 direct bridge proxies, preserving MCP cancellation and typed errors. */
10
10
  export const registerOfficialTools = (server, analysis, options) => {
11
11
  for (const contract of OFFICIAL_TOOL_CONTRACTS) {
@@ -40,9 +40,7 @@ const registerOfficialTool = (server, analysis, contract, registration) => {
40
40
  locations: result.value.locations,
41
41
  });
42
42
  const recorded = registration.recordEvidence?.(evidence);
43
- if (recorded !== undefined && !recorded.ok)
44
- return toCallToolResult(recorded, contract);
45
- return toCallToolResult({ ok: true, value: evidence }, contract);
43
+ return toEvidenceToolResult(evidence, contract, recorded);
46
44
  });
47
45
  };
48
46
  const runOfficialOperation = async (analysis, contract, arguments_, execution) => {
@@ -1,61 +1,83 @@
1
1
  import { toolContract } from "../contracts/toolContracts.js";
2
+ import { AnalysisInputError } from "../domain/analysisErrorCore.js";
3
+ import {} from "../domain/analysisErrorBase.js";
4
+ import { describeValidationFailure } from "../domain/evidenceBundle.js";
2
5
  import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";
3
6
  import { createEvidence, parseEvidence, } from "../domain/evidence.js";
4
7
  import { jsonValueSchema } from "../domain/jsonValue.js";
5
- import { compareProcessCaptures, parseProcessCapture, } from "../domain/processCapture.js";
6
- import { err } from "../domain/result.js";
8
+ import { compareProcessCaptures, parseProcessCapture, } from "../domain/process/processCapture.js";
9
+ import { err, ok } from "../domain/result.js";
7
10
  import { recordDerivedEvidence } from "./recordDerivedEvidence.js";
8
11
  import { recordSessionEvidenceSources } from "./sessionEvidence.js";
9
12
  import { runDerivedOperation } from "./runDerivedOperation.js";
10
13
  import { PROCESS_PROVIDER } from "./sessionToolPolicies.js";
11
14
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
12
- import { toCallToolResult } from "./toolResult.js";
15
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
13
16
  const PROCESS_CAPTURE_EVIDENCE = {
14
17
  operation: "capture_process_scenario",
15
18
  predicate: "rea.process-capture",
16
19
  };
17
20
  const sourceLocations = (left, right) => [...(left ?? []), ...(right ?? [])];
21
+ /**
22
+ * Parse one side and name the failed constraint: tampered Evidence, Evidence
23
+ * from another workflow, or an invalid capture result.
24
+ */
25
+ const parseCaptureSide = (operation, side, value) => {
26
+ let record;
27
+ try {
28
+ record = parseEvidence(value);
29
+ }
30
+ catch (cause) {
31
+ return err(new EvidenceIntegrityError(`${side} Evidence failed validation`, {
32
+ cause,
33
+ userMessage: `The ${side} Evidence failed validation (${describeValidationFailure(cause)}). Supply unmodified capture Evidence from capture_process_scenario.`,
34
+ }));
35
+ }
36
+ if (record.operation !== PROCESS_CAPTURE_EVIDENCE.operation ||
37
+ record.predicate_type !== PROCESS_CAPTURE_EVIDENCE.predicate)
38
+ return err(new AnalysisInputError(operation, undefined, [
39
+ {
40
+ path: [side],
41
+ reason: "invalid_value",
42
+ message: `Expected process capture Evidence (operation ${PROCESS_CAPTURE_EVIDENCE.operation}, predicate ${PROCESS_CAPTURE_EVIDENCE.predicate}); the ${side} Evidence has operation ${record.operation} and predicate ${record.predicate_type}.`,
43
+ },
44
+ ]));
45
+ try {
46
+ return ok({
47
+ record,
48
+ capture: parseProcessCapture(record.normalized_result),
49
+ });
50
+ }
51
+ catch (cause) {
52
+ return err(new EvidenceIntegrityError(`${side} process capture failed validation`, {
53
+ cause,
54
+ userMessage: `The ${side} Evidence has an invalid process capture result (${describeValidationFailure(cause)}). Recreate the capture with capture_process_scenario.`,
55
+ }));
56
+ }
57
+ };
18
58
  /** Register deterministic process-capture comparison and contradiction tracking. */
19
59
  export const registerProcessComparisonTool = (server, session, contract, now = Date.now) => {
20
60
  server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
21
- let leftRecord;
22
- let rightRecord;
23
- try {
24
- leftRecord = parseEvidence(input.left);
25
- rightRecord = parseEvidence(input.right);
26
- if (leftRecord.operation !== PROCESS_CAPTURE_EVIDENCE.operation ||
27
- rightRecord.operation !== PROCESS_CAPTURE_EVIDENCE.operation ||
28
- leftRecord.predicate_type !== PROCESS_CAPTURE_EVIDENCE.predicate ||
29
- rightRecord.predicate_type !== PROCESS_CAPTURE_EVIDENCE.predicate)
30
- throw new TypeError("Expected process capture Evidence");
31
- }
32
- catch (cause) {
33
- return toCallToolResult(err(new EvidenceIntegrityError(cause instanceof Error ? cause.message : "Invalid Evidence")), contract);
34
- }
35
- let comparison;
36
- let leftCapture;
37
- let rightCapture;
38
- try {
39
- leftCapture = parseProcessCapture(leftRecord.normalized_result);
40
- rightCapture = parseProcessCapture(rightRecord.normalized_result);
41
- const computed = await runDerivedOperation(context, contract.name, () => compareProcessCaptures(leftCapture, rightCapture, {
42
- ...(input.max_capture_age_ms === undefined
43
- ? {}
44
- : { maxCaptureAgeMs: input.max_capture_age_ms }),
45
- ...(input.trace_spec === undefined
46
- ? {}
47
- : { traceSpecification: input.trace_spec }),
48
- now,
49
- }));
50
- if (!computed.ok)
51
- return toCallToolResult(computed, contract);
52
- comparison = computed.value;
53
- }
54
- catch (cause) {
55
- return toCallToolResult(err(new EvidenceIntegrityError(cause instanceof Error
56
- ? cause.message
57
- : "Invalid process capture")), contract);
58
- }
61
+ const left = parseCaptureSide(contract.name, "left", input.left);
62
+ if (!left.ok)
63
+ return toCallToolResult(left, contract);
64
+ const right = parseCaptureSide(contract.name, "right", input.right);
65
+ if (!right.ok)
66
+ return toCallToolResult(right, contract);
67
+ const { record: leftRecord, capture: leftCapture } = left.value;
68
+ const { record: rightRecord, capture: rightCapture } = right.value;
69
+ const computed = await runDerivedOperation(context, contract.name, () => compareProcessCaptures(leftCapture, rightCapture, {
70
+ ...(input.max_capture_age_ms === undefined
71
+ ? {}
72
+ : { maxCaptureAgeMs: input.max_capture_age_ms }),
73
+ ...(input.trace_spec === undefined
74
+ ? {}
75
+ : { traceSpecification: input.trace_spec }),
76
+ now,
77
+ }));
78
+ if (!computed.ok)
79
+ return toCallToolResult(computed, contract);
80
+ const comparison = computed.value;
59
81
  const evidence = createEvidence(undefined, PROCESS_PROVIDER, {
60
82
  predicateType: "rea.process-comparison",
61
83
  operation: contract.name,
@@ -78,11 +100,11 @@ export const registerProcessComparisonTool = (server, session, contract, now = D
78
100
  const recordedSources = recordSessionEvidenceSources((evidence) => session.recordEvidence(evidence), [leftRecord, rightRecord]);
79
101
  if (!recordedSources.ok)
80
102
  return toCallToolResult(recordedSources, contract);
81
- return toCallToolResult(recordDerivedEvidence(session, evidence, comparisonUnknownInput({
103
+ return toEvidenceToolResult(evidence, contract, recordDerivedEvidence(session, evidence, comparisonUnknownInput({
82
104
  left_evidence_id: leftRecord.evidence_id,
83
105
  right_evidence_id: rightRecord.evidence_id,
84
106
  comparison_evidence_id: evidence.evidence_id,
85
- }, comparison)), contract);
107
+ }, comparison)));
86
108
  });
87
109
  };
88
110
  const comparisonUnknownInput = (parsed, comparison) => {
@@ -98,14 +120,18 @@ const comparisonUnknownInput = (parsed, comparison) => {
98
120
  .filter(([, status]) => status !== "unchanged")
99
121
  .map(([scope]) => scope)
100
122
  .join(", ");
123
+ const contradictory = comparison.status === "changed" &&
124
+ parsed.left_evidence_id !== parsed.right_evidence_id;
101
125
  // Unknown identity uses the question, not its supporting records. Bind the
102
126
  // question to this comparison so distinct capture pairs and policies coexist.
103
127
  return {
104
- question: `Process captures disagree across: ${differingScopes} (comparison ${parsed.comparison_evidence_id})`,
128
+ question: `${contradictory ? "Process captures disagree" : `Process comparison is ${comparison.status}`} across: ${differingScopes} (comparison ${parsed.comparison_evidence_id})`,
105
129
  severity: "high",
106
130
  domain: "process-comparison",
107
- supporting_evidence_ids: [parsed.left_evidence_id],
108
- contradicting_evidence_ids: [parsed.right_evidence_id],
131
+ supporting_evidence_ids: contradictory
132
+ ? [parsed.left_evidence_id]
133
+ : [...new Set([parsed.left_evidence_id, parsed.right_evidence_id])],
134
+ contradicting_evidence_ids: contradictory ? [parsed.right_evidence_id] : [],
109
135
  required_authority: "controlled-replay",
110
136
  required_confidence: "observed",
111
137
  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 recorded crash inspection to its named contract and session Evidence owner. */
6
+ export const registerRecordedCrashTools = (server, service, logger, recordEvidence) => {
7
+ const contract = toolContract("inspect_recorded_crash");
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
+ };
@@ -11,7 +11,7 @@ export const registerEvidenceTools = (registration) => {
11
11
  };
12
12
  const registerExportEvidenceTool = ({ server, session, exportContract, }) => {
13
13
  server.registerTool(exportContract.name, toolRegistrationOptions(exportContract), async (input) => {
14
- const bundle = session.exportEvidenceBundle();
14
+ const bundle = bundleForSerialization(session);
15
15
  const written = await writeEvidenceBundle(bundle, input.path, input.overwrite);
16
16
  return written.ok
17
17
  ? toCallToolResult(ok({
@@ -24,7 +24,7 @@ const registerExportEvidenceTool = ({ server, session, exportContract, }) => {
24
24
  });
25
25
  };
26
26
  const registerSnapshotEvidenceTool = ({ server, session, snapshotContract, }) => {
27
- server.registerTool(snapshotContract.name, toolRegistrationOptions(snapshotContract), () => toCallToolResult(ok(session.exportEvidenceBundle()), snapshotContract));
27
+ server.registerTool(snapshotContract.name, toolRegistrationOptions(snapshotContract), () => toCallToolResult(ok(bundleForSerialization(session)), snapshotContract));
28
28
  };
29
29
  const registerImportEvidenceTool = ({ server, session, importContract, }) => {
30
30
  server.registerTool(importContract.name, toolRegistrationOptions(importContract), async (input) => {
@@ -32,19 +32,18 @@ const registerImportEvidenceTool = ({ server, session, importContract, }) => {
32
32
  const loaded = await readEvidenceBundle(path);
33
33
  if (!loaded.ok)
34
34
  return toCallToolResult(loaded, importContract);
35
- const retainedUnknownRevisions = new Set(session
36
- .exportEvidenceBundle()
37
- .unknowns.map((unknown) => unknownRevisionKey(unknown)));
35
+ const retainedUnknownRevisions = new Set(bundleForSerialization(session).unknowns.map((unknown) => unknownRevisionKey(unknown)));
38
36
  const imported = session.importEvidenceBundle(loaded.value);
39
37
  return imported.ok
40
38
  ? toCallToolResult(ok({
41
39
  imported: imported.value,
42
40
  unknowns_added: loaded.value.unknowns.filter((unknown) => !retainedUnknownRevisions.has(unknownRevisionKey(unknown))).length,
43
- total: session.exportEvidenceBundle().records.length,
41
+ total: bundleForSerialization(session).records.length,
44
42
  }), importContract)
45
43
  : toCallToolResult(imported, importContract);
46
44
  });
47
45
  };
46
+ const bundleForSerialization = (session) => session.evidenceBundleForSerialization?.() ?? session.exportEvidenceBundle();
48
47
  const unknownRevisionKey = (unknown) => `${unknown.unknown_id}:${String(unknown.revision)}`;
49
48
  /** Register residual-unknown query and mutation tools. */
50
49
  const registerListUnknownsTool = ({ server, session, }) => {
@@ -1,3 +1,4 @@
1
+ import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";
1
2
  import { buildCapabilityInventory } from "../application/CapabilityInventory.js";
2
3
  import { toolContract } from "../contracts/toolContracts.js";
3
4
  import { jsonObjectSchema } from "../domain/jsonValue.js";
@@ -5,14 +6,27 @@ import { createServerIdentity } from "../serverIdentity.js";
5
6
  import { mcpClientMetadata } from "./mcpClientMetadata.js";
6
7
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
7
8
  import { toCallToolResult } from "./toolResult.js";
9
+ import { err } from "../domain/result.js";
8
10
  /** Register the read-only provider and target status operation. */
9
11
  export const registerSessionStatusTool = (options) => {
10
- const { server, session, contract, startedAt, availabilityPolicy } = options;
11
- server.registerTool(contract.name, toolRegistrationOptions(contract), (input, context) => {
12
+ const { server, session, contract, startedAt, availabilityPolicy, androidAnalysisAvailability, } = options;
13
+ server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
12
14
  const { client, clientFeatures, protocolVersion } = mcpClientMetadata(context);
15
+ let androidAvailability;
16
+ try {
17
+ androidAvailability = await androidAnalysisAvailability(context.mcpReq.signal);
18
+ }
19
+ catch (cause) {
20
+ if (!context.mcpReq.signal.aborted)
21
+ throw cause;
22
+ return toCallToolResult(err(new AnalysisCancelledError("binary_session")), contract);
23
+ }
13
24
  const status = session.status();
14
25
  const statusObject = jsonObjectSchema.parse(status);
15
- const toolAvailability = buildCapabilityInventory(status, availabilityPolicy(), clientFeatures);
26
+ const toolAvailability = buildCapabilityInventory(status, {
27
+ ...availabilityPolicy(),
28
+ androidAnalysisAvailability: androidAvailability,
29
+ }, clientFeatures);
16
30
  const serverIdentity = createServerIdentity({
17
31
  startedAt,
18
32
  expected: {
@@ -1,8 +1,8 @@
1
1
  import { z } from "zod";
2
2
  import { getNavigationContext, inspectAddressContext, } from "../application/AnalysisContextQueries.js";
3
3
  import { readAnalysisSnapshot } from "../application/binary/AnalysisSnapshotFiles.js";
4
- import { createProcessCaptureEvidence } from "../application/ProcessEvidence.js";
5
- import { captureProcessScenario } from "../application/ProcessHarness.js";
4
+ import { createProcessCaptureEvidence } from "../application/process/ProcessEvidence.js";
5
+ import { captureProcessScenario } from "../process/capture/ProcessHarness.js";
6
6
  import { toolContract } from "../contracts/toolContracts.js";
7
7
  import { UnknownRegistryError } from "../domain/unknownRegistryError.js";
8
8
  import {} from "../domain/analysisErrorBase.js";
@@ -19,7 +19,7 @@ import { registerSessionStatusTool } from "./registerSessionStatusTool.js";
19
19
  import { sessionAvailabilityPolicy, } from "./sessionAvailabilityPolicy.js";
20
20
  import { logToolExecution } from "./toolLogging.js";
21
21
  import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
22
- import { toCallToolResult } from "./toolResult.js";
22
+ import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
23
23
  const recordProcessResidualUnknowns = (session, evidence, residuals) => {
24
24
  for (const residual of residuals) {
25
25
  const unknown = session.recordUnknown({
@@ -73,11 +73,11 @@ const registerProcessTools = ({ server, session, logger, captureContract, }) =>
73
73
  const unknowns = recordProcessResidualUnknowns(session, evidence, captured.value.residual_unknowns);
74
74
  if (!unknowns.ok)
75
75
  return toCallToolResult(unknowns, captureContract);
76
- return toCallToolResult(ok(evidence), captureContract);
76
+ return toEvidenceToolResult(evidence, captureContract, recorded);
77
77
  });
78
78
  };
79
79
  const registerLifecycleTools = (registration) => {
80
- const { server, session, statusContract, startedAt, availabilityPolicy } = registration;
80
+ const { server, session, statusContract, startedAt, availabilityPolicy, androidAnalysisAvailability, } = registration;
81
81
  registerOpenLifecycleTool(registration);
82
82
  registerCloseLifecycleTool(registration);
83
83
  registerSessionStatusTool({
@@ -86,6 +86,7 @@ const registerLifecycleTools = (registration) => {
86
86
  contract: statusContract,
87
87
  startedAt,
88
88
  availabilityPolicy,
89
+ androidAnalysisAvailability,
89
90
  });
90
91
  };
91
92
  const registerOpenLifecycleTool = ({ server, session, logger, openContract, }) => {
@@ -153,6 +154,7 @@ export const registerSessionTools = (server, session, logger, options = {}) => {
153
154
  statusContract,
154
155
  startedAt: options.startedAt ?? new Date().toISOString(),
155
156
  availabilityPolicy: sessionAvailabilityPolicy(options.availabilityPolicy, {}),
157
+ androidAnalysisAvailability: options.androidAnalysisAvailability ?? missingAndroidAvailability,
156
158
  });
157
159
  registerEvidenceTools({
158
160
  server,
@@ -175,3 +177,9 @@ export const registerSessionTools = (server, session, logger, options = {}) => {
175
177
  registerUnknownTools({ server, session });
176
178
  registerContextTools(server, session);
177
179
  };
180
+ const missingAndroidAvailability = async () => ({
181
+ status: "unavailable",
182
+ code: "not_configured",
183
+ reason: "Set REA_JADX_MCP_JAR to a caller-supplied jadx-headless-mcp 0.7.1 JAR and provide a full JDK on Linux or macOS.",
184
+ diagnostics: { configured: false },
185
+ });
@@ -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 the module relationship workflow to its exact canonical contract. */
6
6
  export const registerWebModuleTool = (server, service, logger, recordEvidence) => {
7
7
  const contract = toolContract("trace_web_module_imports");
@@ -10,8 +10,6 @@ export const registerWebModuleTool = (server, service, logger, recordEvidence) =
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
  };
@@ -0,0 +1,26 @@
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 historical inspection to its named contract and caller-owned Evidence writer. */
6
+ export const registerWebNetworkCaptureTool = (server, service, logger, recordEvidence) => {
7
+ const contract = toolContract("inspect_web_network_capture");
8
+ const registration = toolRegistrationOptions(contract);
9
+ // Keep the exact advertised contract; the shared service validates raw input
10
+ // before effects so caller-declared sensitivity also covers invalid arguments.
11
+ // SDK pre-validation otherwise emits unprojected issue paths as plain text.
12
+ const inputSchema = {
13
+ "~standard": {
14
+ ...registration.inputSchema["~standard"],
15
+ vendor: "rea-application",
16
+ validate: (value) => ({ value }),
17
+ },
18
+ };
19
+ server.registerTool(contract.name, { ...registration, inputSchema }, async (input, context) => {
20
+ const result = await logToolExecution(logger, contract.name, () => service.inspect(input, { signal: context.mcpReq.signal }));
21
+ if (!result.ok)
22
+ return toCallToolResult(result, contract);
23
+ const recorded = recordEvidence?.(result.value);
24
+ return toEvidenceToolResult(result.value, contract, recorded);
25
+ });
26
+ };
@@ -2,7 +2,7 @@ import { toolContract } from "../contracts/toolContracts.js";
2
2
  import { mcpProgressReporter } from "./mcpProgress.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 distinct runtime operations to named contracts and the session's Evidence owner. */
7
7
  export const registerWebRuntimeTools = (server, service, logger, recordEvidence) => {
8
8
  const execution = toolContract("observe_web_execution");
@@ -15,17 +15,13 @@ export const registerWebRuntimeTools = (server, service, logger, recordEvidence)
15
15
  if (!result.ok)
16
16
  return toCallToolResult(result, execution);
17
17
  const recorded = recordEvidence?.(result.value);
18
- return recorded !== undefined && !recorded.ok
19
- ? toCallToolResult(recorded, execution)
20
- : toCallToolResult(result, execution);
18
+ return toEvidenceToolResult(result.value, execution, recorded);
21
19
  });
22
20
  server.registerTool(listeners.name, toolRegistrationOptions(listeners), async (input, context) => {
23
21
  const result = await logToolExecution(logger, listeners.name, () => service.inspect(input, { signal: context.mcpReq.signal }));
24
22
  if (!result.ok)
25
23
  return toCallToolResult(result, listeners);
26
24
  const recorded = recordEvidence?.(result.value);
27
- return recorded !== undefined && !recorded.ok
28
- ? toCallToolResult(recorded, listeners)
29
- : toCallToolResult(result, listeners);
25
+ return toEvidenceToolResult(result.value, listeners, recorded);
30
26
  });
31
27
  };
@@ -2,7 +2,7 @@ import { exportWebScriptsValidated } from "../application/WebScriptExportService
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
  /** Register local script export without requiring a live browser provider. */
7
7
  export const registerWebScriptTool = (server, options) => {
8
8
  const contract = toolContract("export_web_scripts");
@@ -11,8 +11,6 @@ export const registerWebScriptTool = (server, options) => {
11
11
  if (!result.ok)
12
12
  return toCallToolResult(result, contract);
13
13
  const recorded = options.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
  };
@@ -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 source point tracing to its exact named contract and session Evidence owner. */
6
6
  export const registerWebSourceLocationTool = (server, service, logger, recordEvidence) => {
7
7
  const contract = toolContract("trace_web_source_location");
@@ -10,8 +10,6 @@ export const registerWebSourceLocationTool = (server, service, logger, recordEvi
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
  };
@@ -1,5 +1,8 @@
1
1
  import { setImmediate } from "node:timers/promises";
2
+ import { z } from "zod";
3
+ import { AnalysisError } from "../domain/analysisErrorBase.js";
2
4
  import { AnalysisCancelledError, AnalysisInputError, } from "../domain/analysisErrorCore.js";
5
+ import { describeValidationFailure } from "../domain/evidenceBundle.js";
3
6
  import { err, ok } from "../domain/result.js";
4
7
  import { mcpProgressReporter } from "./mcpProgress.js";
5
8
  /** Run synchronous derived work with transport yields and a publication guard. */
@@ -19,9 +22,18 @@ export const runDerivedOperation = async (context, operation, compute) => {
19
22
  value = compute();
20
23
  }
21
24
  catch (cause) {
22
- return err(cause instanceof AnalysisCancelledError
23
- ? cause
24
- : new AnalysisInputError(operation, { cause }));
25
+ // Typed causes already name the failed constraint; keep their issues.
26
+ if (cause instanceof AnalysisError)
27
+ return err(cause);
28
+ return err(new AnalysisInputError(operation, { cause }, cause instanceof TypeError || cause instanceof z.ZodError
29
+ ? [
30
+ {
31
+ path: [],
32
+ reason: "invalid_value",
33
+ message: describeValidationFailure(cause),
34
+ },
35
+ ]
36
+ : []));
25
37
  }
26
38
  await progress.report({
27
39
  phase: "compute",
@@ -3,10 +3,12 @@ import { platform } from "node:process";
3
3
  export const sessionAvailabilityPolicy = (configured, defaults) => {
4
4
  const policy = configured ??
5
5
  (() => ({
6
+ evmInterfaceEnabled: defaults.optionalFeatures?.evmInterfaceEnabled ?? false,
6
7
  processCaptureEnabled: platform !== "win32",
8
+ recordedCrashEnabled: defaults.optionalFeatures?.recordedCrashEnabled ?? false,
9
+ binaryLayoutEnabled: defaults.optionalFeatures?.binaryLayoutEnabled ?? false,
7
10
  firmwareInspectionEnabled: defaults.optionalFeatures?.firmwareInspectionEnabled ?? false,
8
11
  firmwareExtractionEnabled: defaults.optionalFeatures?.firmwareExtractionEnabled ?? false,
9
- androidAnalysisEnabled: defaults.optionalFeatures?.androidAnalysisEnabled ?? false,
10
12
  javascriptRecoveryEnabled: defaults.optionalFeatures?.javascriptRecoveryEnabled ?? false,
11
13
  webModuleResolutionEnabled: defaults.optionalFeatures?.webModuleResolutionEnabled ?? false,
12
14
  browserObservationEnabled: defaults.optionalFeatures?.browserObservationEnabled ?? false,
@@ -1,2 +1,2 @@
1
- export { PROCESS_PROVIDER } from "../application/ProcessEvidence.js";
1
+ export { PROCESS_PROVIDER } from "../application/process/ProcessEvidence.js";
2
2
  export { ARTIFACT_COMPARISON_PROVIDER, BUNDLE_COMPARISON_PROVIDER, CALL_PATH_PROVIDER, CHANGED_BEHAVIOR_PROVIDER, FUNCTION_COMPARISON_PROVIDER, RECONSTRUCTION_PROVIDER, STATIC_RUNTIME_PROVIDER, } from "../application/InvestigationProviders.js";
@@ -1,9 +1,9 @@
1
- import { toolInputSchemaWithMetadata } from "../contracts/toolSchemaMetadata.js";
1
+ import { toolInputSchemaWithMetadata, toolOutputSchemaWithMetadata, } from "../contracts/toolSchemaMetadata.js";
2
2
  /** Project the canonical Zod contracts directly into SDK registration. */
3
3
  export const toolRegistrationOptions = (contract) => ({
4
4
  title: contract.title,
5
5
  description: contract.description,
6
6
  inputSchema: toolInputSchemaWithMetadata(contract),
7
- outputSchema: contract.outputSchema,
7
+ outputSchema: toolOutputSchemaWithMetadata(contract),
8
8
  annotations: contract.annotations,
9
9
  });
@@ -1,38 +1,90 @@
1
+ import { STDIO_DEFAULT_MAX_BUFFER_SIZE } from "@modelcontextprotocol/server";
1
2
  import { projectAnalysisError } from "../domain/analysisErrorProjection.js";
2
3
  import {} from "../domain/analysisErrorBase.js";
4
+ import { AnalysisResourceConstraintError } from "../domain/analysisErrorCore.js";
5
+ import { parseMcpResponseBudget } from "../config/mcpResponseBudget.js";
6
+ import { encodeToolResult, MCP_RESULT_BUDGET_BYTES, MCP_RESULT_STRING_LIMIT, } from "./toolResultEncoding.js";
3
7
  /**
4
8
  * Serialize an application result as MCP text and structured content.
5
9
  * Shared error projection preserves actionable local diagnostics while omitting
6
- * raw causes and captured process output.
10
+ * raw cause objects; explicitly retained bounded command output stays visible.
7
11
  */
8
- export const toCallToolResult = (result, contract) => result.ok ? successResult(result.value, contract) : errorResult(result.error);
9
- const errorResult = (error) => {
12
+ export const toCallToolResult = (result, contract, context) => result.ok
13
+ ? successResult(result.value, contract, context)
14
+ : toErrorToolResult(result.error);
15
+ /** Deliver Evidence using the producer's explicit recording acknowledgment. */
16
+ export const toEvidenceToolResult = (evidence, contract, recorded) => recorded !== undefined && !recorded.ok
17
+ ? toErrorToolResult(recorded.error)
18
+ : toCallToolResult({ ok: true, value: evidence }, contract, recorded === undefined
19
+ ? undefined
20
+ : { retainedEvidenceId: evidence.evidence_id });
21
+ /** Project an error without allocating oversized repeated MCP text. */
22
+ export const toErrorToolResult = (error) => {
10
23
  const projected = projectAnalysisError(error);
11
24
  const structuredContent = { error: projected };
25
+ const configured = parseMcpResponseBudget(process.env.REA_MCP_MAX_RESPONSE_BYTES);
26
+ const budget = configured.ok && configured.value !== undefined
27
+ ? configured.value - 1024
28
+ : MCP_RESULT_BUDGET_BYTES;
29
+ const encoded = encodeToolResult(structuredContent, budget);
30
+ // The session-bound transport retains an oversized projected error before
31
+ // replacing it with a recoverable delivery constraint. Avoid allocating its
32
+ // repeated text representation before that boundary has acknowledged it.
12
33
  return {
13
- content: [
14
- {
15
- type: "text",
16
- text: JSON.stringify(structuredContent),
17
- },
18
- ],
34
+ content: encoded.ok ? [{ type: "text", text: encoded.text }] : [],
19
35
  structuredContent,
20
36
  isError: true,
21
37
  };
22
38
  };
23
- const successResult = (value, contract) => {
39
+ const successResult = (value, contract, context) => {
24
40
  const candidate = projectEvidence(value) ??
25
41
  (contract.kind === "session" ? { result: value } : value);
42
+ const configured = parseMcpResponseBudget(process.env.REA_MCP_MAX_RESPONSE_BYTES);
43
+ if (!configured.ok)
44
+ return toErrorToolResult(configured.error);
45
+ const budget = configured.value === undefined
46
+ ? MCP_RESULT_BUDGET_BYTES
47
+ : configured.value - 1024;
48
+ const encoded = encodeToolResult(candidate, budget);
49
+ if (!encoded.ok)
50
+ return toErrorToolResult(new AnalysisResourceConstraintError(contract.name, "transport", encoded.constraint === "string-length"
51
+ ? "The operation completed, but its complete MCP response exceeds Node's single-string representation limit. Export retained evidence to consume the complete analysis, or use complete CLI JSON output."
52
+ : "The operation completed, but its complete MCP response exceeds the stdio response budget. The analysis result was not truncated; export retained evidence to consume it, or use complete CLI JSON output.", {
53
+ boundary: "mcp-response",
54
+ default_receive_buffer_bytes: STDIO_DEFAULT_MAX_BUFFER_SIZE,
55
+ result_budget_bytes: budget,
56
+ max_string_code_units: MCP_RESULT_STRING_LIMIT,
57
+ response_bytes_at_least: encoded.bytesAtLeast,
58
+ response_code_units_at_least: encoded.codeUnitsAtLeast,
59
+ constraint: encoded.constraint,
60
+ ...evidenceRecovery(value, context?.retainedEvidenceId),
61
+ }));
26
62
  return {
27
63
  content: [
28
64
  {
29
65
  type: "text",
30
- text: JSON.stringify(candidate),
66
+ text: encoded.text,
31
67
  },
32
68
  ],
33
69
  structuredContent: candidate,
34
70
  };
35
71
  };
72
+ const evidenceRecovery = (value, retainedEvidenceId) => {
73
+ const projected = projectEvidence(value);
74
+ if (projected === undefined ||
75
+ typeof projected !== "object" ||
76
+ projected === null ||
77
+ Array.isArray(projected))
78
+ return {};
79
+ if (projected.evidence_id !== retainedEvidenceId)
80
+ return { evidence_id: projected.evidence_id ?? null };
81
+ return {
82
+ evidence_reference: {
83
+ kind: "retained-evidence",
84
+ evidence_id: projected.evidence_id ?? null,
85
+ },
86
+ };
87
+ };
36
88
  const projectEvidence = (value) => {
37
89
  if (typeof value !== "object" ||
38
90
  value === null ||