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
@@ -1,4 +1,34 @@
1
- import { AnalysisError } from "./analysisErrorBase.js";
1
+ import { AnalysisError, } from "./analysisErrorBase.js";
2
+ /** A readable supplied artifact lies outside this operation's supported target formats. */
3
+ export class AnalysisUnsupportedTargetError extends AnalysisError {
4
+ operation;
5
+ path;
6
+ reason;
7
+ _tag = "AnalysisUnsupportedTargetError";
8
+ constructor(operation, path, reason, options) {
9
+ super(`Unsupported target for ${operation} at ${path}: ${reason}`, options);
10
+ this.operation = operation;
11
+ this.path = path;
12
+ this.reason = reason;
13
+ }
14
+ }
15
+ /** An analysis or transport resource failure, distinct from malformed input or unsupported coverage. */
16
+ export class AnalysisResourceConstraintError extends AnalysisError {
17
+ operation;
18
+ resource;
19
+ reason;
20
+ reportedLimits;
21
+ _tag = "AnalysisResourceConstraintError";
22
+ remediationAction;
23
+ constructor(operation, resource, reason, reportedLimits, options) {
24
+ super(`Resource constraint during ${operation}: ${reason}`, options);
25
+ this.operation = operation;
26
+ this.resource = resource;
27
+ this.reason = reason;
28
+ this.reportedLimits = reportedLimits;
29
+ this.remediationAction = options?.remediationAction;
30
+ }
31
+ }
2
32
  /** Provider-neutral invalid analysis input or output at an application boundary. */
3
33
  export class AnalysisProtocolError extends AnalysisError {
4
34
  _tag = "AnalysisProtocolError";
@@ -44,8 +74,8 @@ export class AnalysisCapabilityUnavailableError extends AnalysisError {
44
74
  export class AnalysisCancelledError extends AnalysisError {
45
75
  operation;
46
76
  _tag = "AnalysisCancelledError";
47
- constructor(operation) {
48
- super(`Analysis operation was cancelled: ${operation}`);
77
+ constructor(operation, options) {
78
+ super(`Analysis operation was cancelled: ${operation}`, options);
49
79
  this.operation = operation;
50
80
  }
51
81
  }
@@ -54,9 +84,35 @@ export class AnalysisTimeoutError extends AnalysisError {
54
84
  operation;
55
85
  timeoutMs;
56
86
  _tag = "AnalysisTimeoutError";
57
- constructor(operation, timeoutMs) {
58
- super(`Analysis operation timed out after ${String(timeoutMs)}ms: ${operation}`);
87
+ constructor(operation, timeoutMs, options) {
88
+ super(`Analysis operation timed out after ${String(timeoutMs)}ms: ${operation}`, options);
59
89
  this.operation = operation;
60
90
  this.timeoutMs = timeoutMs;
61
91
  }
62
92
  }
93
+ /** Host filesystem permissions denied the selected read; this is not malformed caller input. */
94
+ export class AnalysisAccessDeniedError extends AnalysisError {
95
+ operation;
96
+ path;
97
+ systemCode;
98
+ _tag = "AnalysisAccessDeniedError";
99
+ constructor(operation, path, systemCode, options) {
100
+ super(`Host filesystem read access denied (${systemCode}) for ${path} during ${operation}`, options);
101
+ this.operation = operation;
102
+ this.path = path;
103
+ this.systemCode = systemCode;
104
+ }
105
+ }
106
+ /** Selected artifact acquisition observed a change, so no stable identity can be reported. */
107
+ export class AnalysisArtifactChangedError extends AnalysisError {
108
+ operation;
109
+ path;
110
+ reason;
111
+ _tag = "AnalysisArtifactChangedError";
112
+ constructor(operation, path, reason, options) {
113
+ super(`Selected artifact changed during acquisition: ${reason}`, options);
114
+ this.operation = operation;
115
+ this.path = path;
116
+ this.reason = reason;
117
+ }
118
+ }
@@ -1,31 +1,53 @@
1
- import { AnalysisInputError } from "./analysisErrorCore.js";
1
+ import { AnalysisAccessDeniedError, AnalysisArtifactChangedError, AnalysisInputError, AnalysisUnsupportedTargetError, AnalysisResourceConstraintError, } from "./analysisErrorCore.js";
2
2
  import { ArtifactOperationError } from "./artifactOperationError.js";
3
3
  import { BinaryTargetError, ConfigurationError, NoBinaryOpenError, } from "./configurationErrors.js";
4
4
  import { BrowserObservationError } from "./browserObservationError.js";
5
- import { EvidenceFileError, EvidenceIntegrityError, EvidenceReferenceError, } from "./evidenceErrors.js";
5
+ import { EvidenceFileError, EvidenceIntegrityError, EvidenceReferenceError, AnalysisSnapshotMismatchError, } from "./evidenceErrors.js";
6
6
  import { HopperRemoteError, HopperProcessError, HopperStartError, HopperTimeoutError, } from "./hopperErrors.js";
7
7
  import { ProviderSelectionError } from "./providerSelectionError.js";
8
8
  import { UnknownRegistryError } from "./unknownRegistryError.js";
9
+ import { providerRetryAction } from "./providerOperationHealth.js";
9
10
  import {} from "./analysisErrorBase.js";
10
11
  import {} from "./analysisErrorProjection.js";
11
12
  export const analysisErrorRemediationAction = (error) => {
13
+ if (error instanceof AnalysisSnapshotMismatchError)
14
+ return "Run analysis without this snapshot, then save a fresh snapshot using the intended artifact, provider, and analysis profile.";
15
+ if (error instanceof AnalysisUnsupportedTargetError)
16
+ return "Select a target supported by this operation or choose an operation supporting the reported target format.";
17
+ if (error instanceof AnalysisResourceConstraintError)
18
+ return (error.remediationAction ??
19
+ (error.resource === "transport"
20
+ ? "Export retained session evidence through export_evidence_bundle to a caller-selected path, or use complete CLI JSON output. Tools that accept retained-evidence references can inspect compatible records. The connection remains usable."
21
+ : error.resource === "cpu"
22
+ ? "Review the reported worker CPU limits and observed signal. Retry with sufficient CPU time or a smaller artifact; REA retains tighter inherited limits."
23
+ : error.resource === "file-size"
24
+ ? "Review the reported worker file-size limits and write failure. Retry with a sufficient file-size allowance for the evidence reply; REA retains tighter inherited limits."
25
+ : "Review the reported worker memory limits and available host memory. Retry with sufficient memory or a smaller artifact; REA retains tighter inherited limits."));
12
26
  if (error instanceof HopperTimeoutError)
13
- return error.providerState === "busy"
14
- ? "Check binary_session.analysis_activity, wait for the active Hopper request to finish, then retry."
15
- : "Check binary_session for Hopper health, then retry the operation.";
27
+ return error.operation === undefined
28
+ ? "Inspect Hopper for a loader or license dialog and review details.launcher. Correct the loader configuration or complete Hopper setup, then open the target again."
29
+ : error.providerState === "busy"
30
+ ? "Check binary_session.analysis_activity, wait for the active Hopper request to finish, then retry."
31
+ : "Check binary_session for Hopper health, then retry the operation.";
16
32
  if (error instanceof HopperProcessError)
17
- return "Check binary_session provider health. Restart the owned Hopper process only when it has stopped.";
33
+ return hopperProcessRemediation(error);
18
34
  if (error instanceof HopperStartError)
19
35
  return error.ownerRunId === undefined
20
36
  ? "Check the Hopper launcher and target details, then retry opening the target."
21
37
  : `Use the active REA session ${error.ownerRunId} or close it before opening this target again.`;
22
38
  if (error instanceof HopperRemoteError)
23
- return "Review the Hopper diagnostic details; correct the request or retry if the failure was transient.";
39
+ return error.diagnosticType === "invalid_request"
40
+ ? "Correct the reported address, document, or arguments and retry."
41
+ : "Review the Hopper diagnostic details; correct the request or retry if the failure was transient.";
24
42
  if (error instanceof EvidenceReferenceError)
25
43
  return "Use an exact Evidence reference retained by this session, supply the complete inline Evidence, re-run its producer, or import its Evidence bundle. close_binary clears retained records.";
26
44
  if (error instanceof BinaryTargetError &&
27
45
  error.constraint === "directory_requires_file")
28
46
  return "For a JavaScript/Electron application directory, call analyze_javascript_application with input_path or run `rea analyze <directory>`. For binary analysis, select its executable file.";
47
+ if (error instanceof AnalysisAccessDeniedError)
48
+ return "Check the current process's read access to the selected path. Retry with a readable local file.";
49
+ if (error instanceof AnalysisArtifactChangedError)
50
+ return "Wait until the selected file is stable. For an active binary session, reopen the target with open_binary before retrying so REA acquires its current identity; for a CLI command or target-free tool, rerun the operation.";
29
51
  if (error instanceof AnalysisInputError)
30
52
  return "Correct the listed arguments and retry.";
31
53
  if (error instanceof UnknownRegistryError && error.reason === "not-found")
@@ -39,7 +61,10 @@ export const analysisErrorCategory = (error) => {
39
61
  if (error._tag === "ProcessCaptureError")
40
62
  return error.userCategory ?? "execution_failure";
41
63
  if (error instanceof BrowserObservationError)
42
- return browserErrorCategory(error.reason);
64
+ return error.userCategory ?? browserErrorCategory(error.reason);
65
+ if (error instanceof HopperRemoteError &&
66
+ error.diagnosticType === "invalid_request")
67
+ return "invalid_input";
43
68
  if (error instanceof HopperRemoteError &&
44
69
  error.diagnosticType === "authorization")
45
70
  return "unavailable";
@@ -50,6 +75,10 @@ export const analysisErrorCategory = (error) => {
50
75
  return STATIC_ERROR_CATEGORIES[error._tag] ?? "execution_failure";
51
76
  };
52
77
  const browserErrorCategory = (reason) => {
78
+ if (reason === "cancelled")
79
+ return "cancelled";
80
+ if (reason === "timeout")
81
+ return "timeout";
53
82
  if (reason === "payload_limit")
54
83
  return "truncated";
55
84
  if (reason === "target_not_found" ||
@@ -73,17 +102,31 @@ const artifactErrorCategory = (reason) => {
73
102
  };
74
103
  const STATIC_ERROR_CATEGORIES = {
75
104
  AnalysisInputError: "invalid_input",
105
+ AnalysisAccessDeniedError: "unavailable",
106
+ AnalysisArtifactChangedError: "integrity_mismatch",
76
107
  AnalysisCapabilityUnavailableError: "unsupported_provider",
108
+ AnalysisUnsupportedTargetError: "unsupported_target",
77
109
  ProviderSelectionError: "unsupported_provider",
78
110
  EvidenceIntegrityError: "integrity_mismatch",
79
111
  AnalysisCancelledError: "cancelled",
80
112
  HopperCancelledError: "cancelled",
81
113
  AnalysisTimeoutError: "timeout",
114
+ AnalysisResourceConstraintError: "resource_constraint",
82
115
  HopperTimeoutError: "timeout",
83
116
  NoBinaryOpenError: "unavailable",
84
117
  BinaryTargetError: "unavailable",
85
118
  };
86
119
  export const analysisErrorUserMessage = (error) => {
120
+ if (error instanceof AnalysisSnapshotMismatchError)
121
+ return error.message;
122
+ if (error instanceof AnalysisUnsupportedTargetError)
123
+ return error.message;
124
+ if (error instanceof AnalysisResourceConstraintError)
125
+ return error.reason;
126
+ if (error instanceof AnalysisAccessDeniedError)
127
+ return "Host filesystem permissions denied read access to the selected path.";
128
+ if (error instanceof AnalysisArtifactChangedError)
129
+ return "The selected artifact changed during acquisition; no stable snapshot was decoded.";
87
130
  if (error instanceof AnalysisInputError)
88
131
  return "Analysis input is invalid. Check the arguments and try again.";
89
132
  const hopperMessage = hopperErrorUserMessage(error);
@@ -103,7 +146,7 @@ export const analysisErrorUserMessage = (error) => {
103
146
  if (error instanceof EvidenceIntegrityError)
104
147
  return "Evidence is invalid or has changed. Recreate or re-import it, then try again.";
105
148
  if (error instanceof EvidenceFileError)
106
- return evidenceFileMessage(error.reason);
149
+ return evidenceFileMessage(error);
107
150
  if (error instanceof UnknownRegistryError && error.reason === "not-found")
108
151
  return "The requested residual unknown does not exist in this session. Check the unknown_id and try again.";
109
152
  if (error instanceof UnknownRegistryError)
@@ -123,13 +166,15 @@ export const analysisErrorUserMessage = (error) => {
123
166
  };
124
167
  const hopperErrorUserMessage = (error) => {
125
168
  if (error instanceof HopperTimeoutError) {
126
- const request = error.operation ?? "startup";
169
+ if (error.operation === undefined)
170
+ return "REA timed out waiting for Hopper bridge readiness. Hopper may be waiting for a loader or license dialog; inspect its window and the captured launcher outcome before retrying.";
171
+ const request = error.operation;
127
172
  return error.providerState === "busy"
128
173
  ? `Hopper timed out during ${request} while the provider remained busy. Check binary_session.analysis_activity, wait for the active request to finish, then retry.`
129
174
  : `Hopper timed out during ${request} before it started. Check binary_session for provider health, then retry.`;
130
175
  }
131
176
  if (error instanceof HopperProcessError)
132
- return `Hopper stopped during ${error.operation ?? "connection"}${error.exitCode === null ? "; its exit was not observed" : ` with exit code ${String(error.exitCode)}`}.${error.userMessage === undefined ? "" : ` ${error.userMessage}`} Check binary_session provider health before retrying.`;
177
+ return hopperProcessMessage(error);
133
178
  if (error instanceof HopperStartError)
134
179
  return (error.userMessage ??
135
180
  "Hopper could not start. Check the launcher and target details, then retry opening the target.");
@@ -137,6 +182,36 @@ const hopperErrorUserMessage = (error) => {
137
182
  return `Hopper ${error.operation ?? "analysis"} failed (${String(error.code)}, ${error.diagnosticType}): ${error.safeMessage}`;
138
183
  return undefined;
139
184
  };
185
+ const RESTART_OWNED_PROVIDER = "Restart the owned provider by calling close_binary, then open the target again and retry.";
186
+ const hopperProcessRemediation = (error) => {
187
+ if (error.failureCode !== undefined && error.userMessage !== undefined)
188
+ return error.userMessage;
189
+ if (error.stage === "launch")
190
+ return "Review the captured launcher diagnostics and Hopper setup, then retry opening the target.";
191
+ if (providerRetryAction(error.providerState) === "restart_provider")
192
+ return RESTART_OWNED_PROVIDER;
193
+ return "Read binary_session.provider_operation_health for this request before retrying or restarting the owned provider.";
194
+ };
195
+ const hopperProcessMessage = (error) => {
196
+ const stage = error.stage;
197
+ const where = error.operation ?? stage;
198
+ const request = error.requestId === undefined
199
+ ? ""
200
+ : ` Request id ${String(error.requestId)}.`;
201
+ const startup = error.userMessage === undefined ? "" : ` ${error.userMessage}`;
202
+ if (error.providerState === "exited") {
203
+ const exit = error.exitCode === null
204
+ ? "no exit code was observed"
205
+ : `exit code ${String(error.exitCode)}`;
206
+ const recovery = error.failureCode === undefined && stage !== "launch"
207
+ ? ` ${RESTART_OWNED_PROVIDER}`
208
+ : "";
209
+ return `Hopper exited during ${where} (${exit}).${startup}${recovery}${request}`;
210
+ }
211
+ if (error.providerState === "unreachable")
212
+ return `Hopper became unreachable during ${where}; its process exit was not observed. ${RESTART_OWNED_PROVIDER}${startup}${request}`;
213
+ return `Hopper failed during ${where} and REA could not determine whether the provider is busy, exited, or unreachable.${startup} Read binary_session.provider_operation_health for this request before retrying or restarting.${request}`;
214
+ };
140
215
  const standardErrorMessage = (tag) => {
141
216
  if (UNREADABLE_OUTPUT_TAGS.has(tag))
142
217
  return "Analysis returned an unreadable result. Retry once; if it continues, run `rea doctor`.";
@@ -190,7 +265,11 @@ const artifactMessage = (reason) => {
190
265
  return "Artifact is invalid or has changed. Get a fresh copy and try again.";
191
266
  return "Artifact could not be read or written. Check file access and try again.";
192
267
  };
193
- const evidenceFileMessage = (reason) => {
268
+ const evidenceFileMessage = ({ operation, reason, }) => {
269
+ if (reason === "missing")
270
+ return operation === "read"
271
+ ? "Evidence file does not exist at the selected path. Check the path and try again."
272
+ : "Evidence output directory does not exist. Choose an existing directory and try again.";
194
273
  if (reason === "not-file")
195
274
  return "Evidence path does not point to a regular file. Choose a file and try again.";
196
275
  if (reason === "exists")
@@ -202,10 +281,14 @@ const evidenceFileMessage = (reason) => {
202
281
  const KNOWN_ERROR_TAGS = {
203
282
  AnalysisProtocolError: true,
204
283
  AnalysisInputError: true,
284
+ AnalysisAccessDeniedError: true,
285
+ AnalysisArtifactChangedError: true,
205
286
  AnalysisOutputError: true,
206
287
  AnalysisCapabilityUnavailableError: true,
288
+ AnalysisUnsupportedTargetError: true,
207
289
  AnalysisCancelledError: true,
208
290
  AnalysisTimeoutError: true,
291
+ AnalysisResourceConstraintError: true,
209
292
  ProviderSelectionError: true,
210
293
  ProviderAdapterError: true,
211
294
  BrowserObservationError: true,
@@ -1,19 +1,43 @@
1
+ import { jsonValueSchema } from "./jsonValue.js";
1
2
  import { analysisErrorCategory, analysisErrorRemediationAction, analysisErrorUserMessage, assertKnownAnalysisErrorTag, } from "./analysisErrorPresentation.js";
2
- import { AnalysisCancelledError, AnalysisCapabilityUnavailableError, AnalysisInputError, AnalysisOutputError, AnalysisTimeoutError, } from "./analysisErrorCore.js";
3
+ import { AnalysisAccessDeniedError, AnalysisArtifactChangedError, AnalysisCancelledError, AnalysisCapabilityUnavailableError, AnalysisUnsupportedTargetError, AnalysisInputError, AnalysisOutputError, AnalysisTimeoutError, AnalysisResourceConstraintError, } from "./analysisErrorCore.js";
3
4
  import { ArtifactOperationError } from "./artifactOperationError.js";
4
5
  import { BinaryTargetError } from "./configurationErrors.js";
5
6
  import { BrowserObservationError } from "./browserObservationError.js";
6
- import { EvidenceFileError, EvidenceReferenceError } from "./evidenceErrors.js";
7
- import { HopperCancelledError, HopperProcessError, HopperRemoteError, HopperTimeoutError, } from "./hopperErrors.js";
7
+ import { EvidenceFileError, EvidenceIntegrityError, EvidenceReferenceError, } from "./evidenceErrors.js";
8
+ import { HopperCancelledError, HopperProcessError, HopperRemoteError, HopperStartError, HopperTimeoutError, } from "./hopperErrors.js";
8
9
  import { ProviderAdapterError } from "./providerAdapterError.js";
9
10
  import { ProviderSelectionError } from "./providerSelectionError.js";
10
11
  import { UnknownRegistryError } from "./unknownRegistryError.js";
12
+ import { providerRetryAction } from "./providerOperationHealth.js";
11
13
  import {} from "./analysisErrorBase.js";
12
14
  /** Project expected failures into exhaustive, secret-safe caller fields. */
13
15
  export const projectAnalysisError = (error) => {
14
16
  assertKnownAnalysisErrorTag(error._tag);
15
- const code = errorCode(error);
16
- const details = errorDetails(error);
17
+ const underlyingCode = underlyingErrorCode(error);
18
+ const code = error.cleanupIncomplete ? "cleanup_incomplete" : underlyingCode;
19
+ const primaryDetails = errorDetails(error);
20
+ const details = {
21
+ ...primaryDetails,
22
+ ...(error.cleanupIncomplete
23
+ ? {
24
+ cleanup: "incomplete",
25
+ resources: [...error.cleanupResources],
26
+ ...(error.cleanup === undefined
27
+ ? {}
28
+ : { cleanup_reason: error.cleanup.reason }),
29
+ execution_failure: primaryDetails?.execution_failure ?? underlyingCode,
30
+ }
31
+ : {}),
32
+ ...(error.capturedOutput === undefined
33
+ ? {}
34
+ : { captured_output: { ...error.capturedOutput } }),
35
+ ...(error.partialObservation === undefined
36
+ ? {}
37
+ : {
38
+ partial_observation: jsonValueSchema.parse(error.partialObservation),
39
+ }),
40
+ };
17
41
  return {
18
42
  code,
19
43
  category: analysisErrorCategory(error),
@@ -22,18 +46,21 @@ export const projectAnalysisError = (error) => {
22
46
  remediation: {
23
47
  action: analysisErrorRemediationAction(error),
24
48
  },
25
- ...(details === undefined ? {} : { details }),
49
+ ...(Object.keys(details).length === 0 ? {} : { details }),
26
50
  };
27
51
  };
28
- const errorCode = (error) => {
29
- if (error.cleanupIncomplete)
30
- return "cleanup_incomplete";
52
+ const underlyingErrorCode = (error) => {
53
+ if (error instanceof HopperRemoteError &&
54
+ error.diagnosticType === "invalid_request")
55
+ return "invalid_request";
31
56
  if (error instanceof ProviderSelectionError)
32
57
  return error.reason === "provider_unavailable"
33
58
  ? "provider_unavailable"
34
59
  : "capability_unavailable";
35
60
  if (error instanceof BrowserObservationError)
36
- return browserErrorCode(error.reason);
61
+ return error.userCategory === "cancelled"
62
+ ? "cancelled"
63
+ : browserErrorCode(error.reason);
37
64
  if (error instanceof ArtifactOperationError)
38
65
  return artifactOperationCode(error);
39
66
  if (error instanceof EvidenceFileError)
@@ -45,6 +72,10 @@ const errorCode = (error) => {
45
72
  return staticErrorCode(error._tag);
46
73
  };
47
74
  const browserErrorCode = (reason) => {
75
+ if (reason === "cancelled")
76
+ return "cancelled";
77
+ if (reason === "timeout")
78
+ return "provider_timeout";
48
79
  if (reason === "payload_limit")
49
80
  return "truncated";
50
81
  if (reason === "target_not_found" ||
@@ -88,10 +119,14 @@ const STATIC_ERROR_CODES = {
88
119
  AnalysisOutputError: "unreadable_output",
89
120
  HopperProtocolError: "unreadable_output",
90
121
  AnalysisInputError: "invalid_request",
122
+ AnalysisAccessDeniedError: "access_denied",
123
+ AnalysisArtifactChangedError: "artifact_changed",
91
124
  AnalysisCapabilityUnavailableError: "capability_unavailable",
125
+ AnalysisUnsupportedTargetError: "unsupported_target",
92
126
  AnalysisCancelledError: "cancelled",
93
127
  HopperCancelledError: "cancelled",
94
128
  AnalysisTimeoutError: "provider_timeout",
129
+ AnalysisResourceConstraintError: "resource_constraint",
95
130
  HopperTimeoutError: "provider_timeout",
96
131
  HopperProcessError: "provider_unavailable",
97
132
  HopperStartError: "provider_unavailable",
@@ -120,6 +155,33 @@ const errorDetails = (error) => requestErrorDetails(error) ??
120
155
  providerErrorDetails(error) ??
121
156
  lifecycleErrorDetails(error);
122
157
  const requestErrorDetails = (error) => {
158
+ if (error instanceof AnalysisUnsupportedTargetError)
159
+ return {
160
+ operation: error.operation,
161
+ path: error.path,
162
+ reason: error.reason,
163
+ };
164
+ if (error instanceof AnalysisResourceConstraintError)
165
+ return {
166
+ operation: error.operation,
167
+ resource: error.resource,
168
+ reason: error.reason,
169
+ reported_limits: error.reportedLimits,
170
+ };
171
+ if (error instanceof AnalysisArtifactChangedError)
172
+ return {
173
+ operation: error.operation,
174
+ path: error.path,
175
+ reason: error.reason,
176
+ boundary: "stable-artifact-read",
177
+ };
178
+ if (error instanceof AnalysisAccessDeniedError)
179
+ return {
180
+ operation: error.operation,
181
+ path: error.path,
182
+ system_code: error.systemCode,
183
+ boundary: "filesystem-read",
184
+ };
123
185
  if (error instanceof AnalysisOutputError)
124
186
  return { operation: error.operation, reason: error.reason };
125
187
  if (error instanceof AnalysisInputError && error.issues.length > 0)
@@ -141,6 +203,8 @@ const requestErrorDetails = (error) => {
141
203
  expected: error.expected,
142
204
  actual: error.actual,
143
205
  };
206
+ if (error instanceof EvidenceIntegrityError)
207
+ return { reason: error.message };
144
208
  return undefined;
145
209
  };
146
210
  const artifactStateErrorDetails = (error) => {
@@ -161,7 +225,11 @@ const artifactStateErrorDetails = (error) => {
161
225
  if (error instanceof UnknownRegistryError)
162
226
  return { reason: error.reason };
163
227
  if (error instanceof EvidenceFileError)
164
- return { operation: error.operation, reason: error.reason };
228
+ return {
229
+ operation: error.operation,
230
+ reason: error.reason,
231
+ ...(error.path === undefined ? {} : { path: error.path }),
232
+ };
165
233
  return undefined;
166
234
  };
167
235
  const providerErrorDetails = (error) => {
@@ -222,10 +290,13 @@ const providerErrorDetails = (error) => {
222
290
  ...(error.operation === undefined ? {} : { operation: error.operation }),
223
291
  ...(error.requestId === undefined ? {} : { request_id: error.requestId }),
224
292
  };
225
- if (error instanceof HopperProcessError)
293
+ if (error instanceof HopperProcessError) {
294
+ const stage = error.stage;
226
295
  return {
227
296
  exit_code: error.exitCode,
228
- stage: error.operation === undefined ? "connection" : "analysis",
297
+ stage,
298
+ provider_state: error.providerState,
299
+ retry_action: providerRetryAction(error.providerState, error.failureCode !== undefined || error.stage === "launch"),
229
300
  ...(error.failureCode === undefined
230
301
  ? {}
231
302
  : { failure_code: error.failureCode }),
@@ -234,6 +305,22 @@ const providerErrorDetails = (error) => {
234
305
  ...(error.diagnostic === undefined
235
306
  ? {}
236
307
  : { diagnostics: { ...error.diagnostic } }),
308
+ ...(error.launcherFailure === undefined
309
+ ? {}
310
+ : { launcher: error.launcherFailure }),
311
+ };
312
+ }
313
+ if (error instanceof HopperStartError)
314
+ return {
315
+ stage: "launch",
316
+ provider_state: "unknown",
317
+ retry_action: error.ownerRunId === undefined ? "retry" : "unknown",
318
+ ...(error.ownerRunId === undefined
319
+ ? {}
320
+ : { owner_run_id: error.ownerRunId }),
321
+ ...(error.launcherFailure === undefined
322
+ ? {}
323
+ : { launcher: error.launcherFailure }),
237
324
  };
238
325
  return undefined;
239
326
  };
@@ -255,16 +342,40 @@ const primaryBrowserFailureReason = (error) => {
255
342
  };
256
343
  const lifecycleErrorDetails = (error) => {
257
344
  if (error instanceof AnalysisCancelledError)
258
- return { operation: error.operation, cleanup: "complete" };
345
+ return {
346
+ operation: error.operation,
347
+ cleanup: error.cleanup === undefined ? "complete" : "incomplete",
348
+ ...(error.cleanup === undefined
349
+ ? {}
350
+ : {
351
+ cleanup_reason: error.cleanup.reason,
352
+ resources: [...error.cleanup.resources],
353
+ execution_failure: "cancelled",
354
+ }),
355
+ };
259
356
  if (error instanceof HopperCancelledError)
260
357
  return { operation: "hopper", cleanup: "complete" };
261
358
  if (error instanceof AnalysisTimeoutError)
262
- return { operation: error.operation, timeout_ms: error.timeoutMs };
359
+ return {
360
+ operation: error.operation,
361
+ timeout_ms: error.timeoutMs,
362
+ ...(error.cleanup === undefined
363
+ ? {}
364
+ : {
365
+ cleanup: "incomplete",
366
+ cleanup_reason: error.cleanup.reason,
367
+ resources: [...error.cleanup.resources],
368
+ }),
369
+ };
263
370
  if (error instanceof HopperTimeoutError)
264
371
  return {
265
- stage: error.operation === undefined ? "startup" : "analysis",
372
+ stage: error.operation === undefined ? "startup" : error.stage,
266
373
  timeout_ms: error.timeoutMs,
374
+ ...(error.launcherOutcome === undefined
375
+ ? {}
376
+ : { launcher: error.launcherOutcome }),
267
377
  provider_state: error.providerState,
378
+ retry_action: error.providerState === "busy" ? "wait" : "retry",
268
379
  ...(error.operation === undefined ? {} : { operation: error.operation }),
269
380
  ...(error.requestId === undefined ? {} : { request_id: error.requestId }),
270
381
  };
@@ -272,10 +383,27 @@ const lifecycleErrorDetails = (error) => {
272
383
  return {
273
384
  cleanup: "incomplete",
274
385
  resources: [...error.cleanupResources],
386
+ ...(error.cleanupReport === undefined
387
+ ? {}
388
+ : { cleanup_report: jsonValueSchema.parse(error.cleanupReport) }),
389
+ ...(error.executionFailure === undefined
390
+ ? {}
391
+ : { execution_failure: error.executionFailure }),
392
+ };
393
+ if (error._tag === "ProcessCaptureError") {
394
+ const details = {
395
+ ...(error.userCategory === "cancelled"
396
+ ? { operation: "process_capture", cleanup: "complete" }
397
+ : {}),
398
+ ...(error.cleanupReport === undefined
399
+ ? {}
400
+ : { cleanup_report: jsonValueSchema.parse(error.cleanupReport) }),
401
+ ...(error.executionFailure === undefined
402
+ ? {}
403
+ : { execution_failure: error.executionFailure }),
275
404
  };
276
- if (error._tag === "ProcessCaptureError" &&
277
- error.userCategory === "cancelled")
278
- return { operation: "process_capture", cleanup: "complete" };
405
+ return Object.keys(details).length === 0 ? undefined : details;
406
+ }
279
407
  if (error instanceof BinaryTargetError)
280
408
  return {
281
409
  path: error.path,
@@ -287,6 +415,7 @@ const lifecycleErrorDetails = (error) => {
287
415
  return undefined;
288
416
  };
289
417
  const RETRYABLE_CODES = new Set([
418
+ "artifact_changed",
290
419
  "invalid_request",
291
420
  "provider_timeout",
292
421
  "cancelled",