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
@@ -0,0 +1,155 @@
1
+ import { createHash } from "node:crypto";
2
+ import { constants } from "node:fs";
3
+ import { lstat, mkdtemp, open, rm } from "node:fs/promises";
4
+ import { tmpdir } from "node:os";
5
+ import { basename, join } from "node:path";
6
+ import { AnalysisError } from "../domain/analysisErrorBase.js";
7
+ import { AnalysisAccessDeniedError, AnalysisArtifactChangedError, AnalysisCancelledError, AnalysisResourceConstraintError, } from "../domain/analysisErrorCore.js";
8
+ import { ProviderAdapterError } from "../domain/providerAdapterError.js";
9
+ import { err, ok } from "../domain/result.js";
10
+ import { NATIVE_MACOS_PROVIDER_IDENTITY } from "./NativeMacOSProviderMetadata.js";
11
+ const identity = (stat) => [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
12
+ const changedTarget = (target, reason) => err(new AnalysisArtifactChangedError("inspect_signature", target.path, reason));
13
+ const signatureReadFailure = (target, cause) => {
14
+ if (cause instanceof AnalysisError)
15
+ return cause;
16
+ const code = cause instanceof Error && "code" in cause ? cause.code : undefined;
17
+ if (code === "EACCES" || code === "EPERM")
18
+ return new AnalysisAccessDeniedError("inspect_signature", target.path, code, { cause });
19
+ if (code === "ENOENT" || code === "ENOTDIR" || code === "ELOOP")
20
+ return new AnalysisArtifactChangedError("inspect_signature", target.path, `Registered signature target is no longer readable (${code}): ${target.path}`, { cause });
21
+ return new ProviderAdapterError(NATIVE_MACOS_PROVIDER_IDENTITY.id, "inspect_signature", {
22
+ cause,
23
+ diagnostics: {
24
+ path: target.path,
25
+ phase: "target-version-binding",
26
+ system_code: typeof code === "string" ? code : null,
27
+ reason: cause instanceof Error ? cause.message : String(cause),
28
+ },
29
+ });
30
+ };
31
+ /** Inspect a digest-verified private copy, releasing it on every exit path. */
32
+ export const withSignatureTarget = async (target, inspect, signal) => {
33
+ let directory;
34
+ try {
35
+ signal?.throwIfAborted();
36
+ directory = await mkdtemp(join(tmpdir(), "rea-signature-"));
37
+ }
38
+ catch (cause) {
39
+ return err(signal?.aborted
40
+ ? new AnalysisCancelledError("inspect_signature")
41
+ : snapshotFailure(target, "create", cause));
42
+ }
43
+ let result;
44
+ let cleanup;
45
+ try {
46
+ const binding = await bindSignatureTarget(target, join(directory, basename(target.path)), signal);
47
+ result = binding.ok ? await inspect(binding.value) : binding;
48
+ }
49
+ finally {
50
+ try {
51
+ await rm(directory, { recursive: true, force: true });
52
+ cleanup = ok(undefined);
53
+ }
54
+ catch (cause) {
55
+ cleanup = err(snapshotFailure(target, "cleanup", cause));
56
+ }
57
+ }
58
+ // Cleanup cannot replace the operation's original actionable failure.
59
+ return result.ok && !cleanup.ok ? cleanup : result;
60
+ };
61
+ const snapshotFailure = (target, phase, cause) => new ProviderAdapterError(NATIVE_MACOS_PROVIDER_IDENTITY.id, "inspect_signature", {
62
+ cause,
63
+ diagnostics: {
64
+ path: target.path,
65
+ phase: `signature-snapshot-${phase}`,
66
+ reason: cause instanceof Error ? cause.message : String(cause),
67
+ },
68
+ });
69
+ const snapshotIO = async (target, phase, operation) => {
70
+ try {
71
+ return await operation();
72
+ }
73
+ catch (cause) {
74
+ throw snapshotFailure(target, phase, cause);
75
+ }
76
+ };
77
+ const copySignatureBytes = async (target, source, snapshot, signal) => {
78
+ const size = Number(source.stat.size);
79
+ if (!Number.isSafeInteger(size))
80
+ throw new AnalysisResourceConstraintError("inspect_signature", "file-size", `Signature target size is not exactly representable: ${target.path}`, null);
81
+ const hash = createHash("sha256");
82
+ const chunk = Buffer.alloc(64 * 1024);
83
+ let position = 0;
84
+ while (position < size) {
85
+ signal?.throwIfAborted();
86
+ const { bytesRead } = await source.file.read(chunk, 0, Math.min(chunk.length, size - position), position);
87
+ signal?.throwIfAborted();
88
+ if (bytesRead === 0)
89
+ throw new AnalysisArtifactChangedError("inspect_signature", target.path, `Signature target was truncated while hashing: ${target.path}`);
90
+ const bytes = chunk.subarray(0, bytesRead);
91
+ hash.update(bytes);
92
+ // writeFile retries short writes; memory remains bounded to this chunk.
93
+ await snapshotIO(target, "write", () => snapshot.writeFile(bytes));
94
+ position += bytesRead;
95
+ }
96
+ return hash.digest("hex");
97
+ };
98
+ /** Hash and copy the same descriptor bytes, without reopening the mutable path. */
99
+ const bindSignatureTarget = async (target, snapshotPath, signal) => {
100
+ try {
101
+ signal?.throwIfAborted();
102
+ const before = await lstat(target.path, { bigint: true });
103
+ signal?.throwIfAborted();
104
+ if (!before.isFile() || before.isSymbolicLink())
105
+ return changedTarget(target, `Signature target is no longer a regular file: ${target.path}`);
106
+ const file = await open(target.path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
107
+ try {
108
+ const opened = await file.stat({ bigint: true });
109
+ signal?.throwIfAborted();
110
+ if (identity(opened) !== identity(before))
111
+ return changedTarget(target, `Signature target changed before open: ${target.path}`);
112
+ const snapshot = await snapshotIO(target, "create-file", () => open(snapshotPath, "wx", 0o600));
113
+ try {
114
+ const observed = await copySignatureBytes(target, { file, stat: opened }, snapshot, signal);
115
+ if (observed !== target.sha256)
116
+ return changedTarget(target, `Signature target digest changed: ${target.path}; expected ${target.sha256}, observed ${observed}`);
117
+ const after = await file.stat({ bigint: true });
118
+ const current = await lstat(target.path, { bigint: true });
119
+ signal?.throwIfAborted();
120
+ if (identity(after) !== identity(opened) ||
121
+ identity(current) !== identity(opened))
122
+ return changedTarget(target, `Signature target changed while establishing its version: ${target.path}`);
123
+ await snapshotIO(target, "seal", () => snapshot.chmod(0o400));
124
+ return ok({ identity: identity(opened), snapshotPath });
125
+ }
126
+ finally {
127
+ await snapshotIO(target, "close", () => snapshot.close());
128
+ }
129
+ }
130
+ finally {
131
+ await file.close();
132
+ }
133
+ }
134
+ catch (cause) {
135
+ return err(signal?.aborted
136
+ ? new AnalysisCancelledError("inspect_signature")
137
+ : signatureReadFailure(target, cause));
138
+ }
139
+ };
140
+ /** Reject target drift across signature command captures. */
141
+ export const verifySignatureTarget = async (target, binding, signal) => {
142
+ try {
143
+ signal?.throwIfAborted();
144
+ const current = await lstat(target.path, { bigint: true });
145
+ signal?.throwIfAborted();
146
+ return current.isFile() && identity(current) === binding.identity
147
+ ? ok(undefined)
148
+ : changedTarget(target, `Signature target changed during inspection: ${target.path}`);
149
+ }
150
+ catch (cause) {
151
+ return err(signal?.aborted
152
+ ? new AnalysisCancelledError("inspect_signature")
153
+ : signatureReadFailure(target, cause));
154
+ }
155
+ };
@@ -3,6 +3,9 @@ const architectureSchema = z.object({
3
3
  name: z.string().min(1),
4
4
  cpu_type: z.string().nullable(),
5
5
  cpu_subtype: z.string().nullable(),
6
+ cpu_type_code: z.number().int().nonnegative().nullable(),
7
+ cpu_subtype_code: z.number().int().nonnegative().nullable(),
8
+ capabilities: z.string().nullable(),
6
9
  file_offset: z.number().int().min(0).nullable(),
7
10
  size: z.number().int().min(0).nullable(),
8
11
  alignment: z.number().int().min(0).nullable(),
@@ -18,6 +21,9 @@ export const parseLipoArchitectures = (output) => {
18
21
  name: thinArchitecture,
19
22
  cpu_type: null,
20
23
  cpu_subtype: null,
24
+ cpu_type_code: null,
25
+ cpu_subtype_code: null,
26
+ capabilities: null,
21
27
  file_offset: null,
22
28
  size: null,
23
29
  alignment: null,
@@ -36,6 +42,9 @@ export const parseLipoArchitectures = (output) => {
36
42
  : name,
37
43
  cpu_type: current.cputype ?? null,
38
44
  cpu_subtype: current.cpusubtype ?? null,
45
+ cpu_type_code: cpuTypeCode(current.cputype),
46
+ cpu_subtype_code: cpuSubtypeCode(current.cpusubtype, current.capabilities),
47
+ capabilities: current.capabilities ?? null,
39
48
  file_offset: integer(current.offset),
40
49
  size: integer(current.size),
41
50
  alignment: alignment(current.align),
@@ -54,7 +63,7 @@ export const parseLipoArchitectures = (output) => {
54
63
  current = { architecture: line.slice("architecture ".length).trim() };
55
64
  continue;
56
65
  }
57
- const match = /^(cputype|cpusubtype|offset|size|align)\s+(.+)$/u.exec(line);
66
+ const match = /^(cputype|cpusubtype|capabilities|offset|size|align)\s+(.+)$/u.exec(line);
58
67
  if (match?.[1] !== undefined && match[2] !== undefined) {
59
68
  current ??= {};
60
69
  current[match[1]] = match[2].trim();
@@ -71,6 +80,67 @@ const integer = (value) => {
71
80
  const parsed = Number.parseInt(value, 10);
72
81
  return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : null;
73
82
  };
83
+ const CPU_TYPES = {
84
+ CPU_TYPE_X86: 7,
85
+ CPU_TYPE_X86_64: 0x01000007,
86
+ CPU_TYPE_ARM: 12,
87
+ CPU_TYPE_ARM64: 0x0100000c,
88
+ CPU_TYPE_ARM64_32: 0x0200000c,
89
+ CPU_TYPE_POWERPC: 18,
90
+ CPU_TYPE_POWERPC64: 0x01000012,
91
+ };
92
+ const CPU_SUBTYPES = {
93
+ CPU_SUBTYPE_X86_ALL: 3,
94
+ CPU_SUBTYPE_X86_64_ALL: 3,
95
+ CPU_SUBTYPE_X86_64_H: 8,
96
+ CPU_SUBTYPE_ARM64_ALL: 0,
97
+ CPU_SUBTYPE_ARM64_V8: 1,
98
+ CPU_SUBTYPE_ARM64E: 2,
99
+ CPU_SUBTYPE_ARM64_32_ALL: 0,
100
+ CPU_SUBTYPE_ARM64_32_V8: 1,
101
+ CPU_SUBTYPE_ARM_V7: 9,
102
+ CPU_SUBTYPE_ARM_V7S: 11,
103
+ CPU_SUBTYPE_ARM_V7K: 12,
104
+ CPU_SUBTYPE_POWERPC_ALL: 0,
105
+ CPU_SUBTYPE_POWERPC_970: 100,
106
+ };
107
+ /** Normalize known lipo names while retaining the producer's original text. */
108
+ const cpuTypeCode = (value) => {
109
+ if (value === undefined)
110
+ return null;
111
+ const numeric = unsigned32(value);
112
+ return numeric ?? CPU_TYPES[value] ?? null;
113
+ };
114
+ /** Normalize the subtype and its separately printed ptrauth capability bits. */
115
+ const cpuSubtypeCode = (value, capabilities) => {
116
+ if (value === undefined)
117
+ return null;
118
+ const numeric = unsigned32(value);
119
+ if (numeric !== null)
120
+ return numeric;
121
+ const subtype = CPU_SUBTYPES[value];
122
+ if (subtype === undefined)
123
+ return null;
124
+ if (value !== "CPU_SUBTYPE_ARM64E")
125
+ return subtype;
126
+ const version = /PTR_AUTH_VERSION\s+USERSPACE\s+(\d+)/u.exec(capabilities ?? "")?.[1];
127
+ if (version === undefined)
128
+ return null;
129
+ const parsedVersion = Number(version);
130
+ if (!Number.isInteger(parsedVersion) ||
131
+ parsedVersion < 0 ||
132
+ parsedVersion > 15)
133
+ return null;
134
+ return (0x80000000 | (parsedVersion << 24) | subtype) >>> 0;
135
+ };
136
+ const unsigned32 = (value) => {
137
+ if (!/^(?:\d+|0x[\da-f]+)$/iu.test(value))
138
+ return null;
139
+ const parsed = Number(value);
140
+ return Number.isInteger(parsed) && parsed >= 0 && parsed <= 0xffffffff
141
+ ? parsed >>> 0
142
+ : null;
143
+ };
74
144
  const alignment = (value) => {
75
145
  if (value === undefined)
76
146
  return null;
@@ -0,0 +1,180 @@
1
+ import { access, mkdir, stat, writeFile } from "node:fs/promises";
2
+ import { constants } from "node:fs";
3
+ import { randomUUID } from "node:crypto";
4
+ import { isAbsolute, join } from "node:path";
5
+ import { fileURLToPath } from "node:url";
6
+ import { z } from "zod";
7
+ import { AnalysisCancelledError, AnalysisCapabilityUnavailableError, AnalysisOutputError, } from "../../domain/analysisErrorCore.js";
8
+ import { ProviderAdapterError } from "../../domain/providerAdapterError.js";
9
+ import { recordedCrashDebuggerSchema, } from "../../domain/native/recordedCrash.js";
10
+ import { readStableArtifact } from "../../artifacts/readStableArtifact.js";
11
+ import { runOwnedCommand } from "../../process/OwnedCommand.js";
12
+ import { capturedPwntoolsOutput, pwntoolsDecoderFailure, } from "../pwntools/PwntoolsFailures.js";
13
+ import { PWNTOOLS_LIMITS } from "../pwntools/PwntoolsRelease.js";
14
+ import { readPwntoolsFailureEvidence } from "../pwntools/PwntoolsResourceLimits.js";
15
+ const OPERATION = "inspect_recorded_crash";
16
+ const replySchema = z.discriminatedUnion("ok", [
17
+ z.strictObject({ ok: z.literal(true), value: recordedCrashDebuggerSchema }),
18
+ z.strictObject({
19
+ ok: z.literal(false),
20
+ reason: z.enum([
21
+ "unavailable",
22
+ "unsupported",
23
+ "decoder",
24
+ "format",
25
+ "output-limit",
26
+ ]),
27
+ message: z.string(),
28
+ }),
29
+ ]);
30
+ /** Add mapping candidates from an owned core-only debugger, using the existing snapshot. */
31
+ export const inspectPwndbgCore = async ({ environment, rootPath, diagnostics, options, launcher, probePath, }) => {
32
+ const gdb = environment.REA_PWNDBG_GDB ?? "/usr/bin/gdb";
33
+ const entry = environment.REA_PWNDBG_GDBINIT ?? "";
34
+ const venv = environment.REA_PWNDBG_VENV_PATH ?? "";
35
+ const unavailable = (message, cause) => new AnalysisCapabilityUnavailableError("pwndbg-core", OPERATION, message, {
36
+ ...(cause === undefined ? {} : { cause }),
37
+ userMessage: message,
38
+ capturedOutput: diagnostics,
39
+ });
40
+ const checkCancelled = () => {
41
+ if (options?.signal?.aborted)
42
+ throw new AnalysisCancelledError(OPERATION, {
43
+ capturedOutput: diagnostics,
44
+ });
45
+ };
46
+ checkCancelled();
47
+ for (const [key, path, kind] of [
48
+ ["REA_PWNDBG_GDB", gdb, "file"],
49
+ ["REA_PWNDBG_GDBINIT", entry, "file"],
50
+ ["REA_PWNDBG_VENV_PATH", venv, "directory"],
51
+ ]) {
52
+ try {
53
+ checkCancelled();
54
+ if (!isAbsolute(path))
55
+ throw new Error("Expected an absolute caller-supplied path.");
56
+ const mode = key === "REA_PWNDBG_GDB" ? constants.X_OK : constants.R_OK;
57
+ if (probePath !== undefined) {
58
+ await probePath(path, kind, mode);
59
+ }
60
+ else {
61
+ await access(path, mode);
62
+ checkCancelled();
63
+ const information = await stat(path);
64
+ checkCancelled();
65
+ if (kind === "file" ? !information.isFile() : !information.isDirectory())
66
+ throw new Error(`Expected a ${kind}.`);
67
+ }
68
+ checkCancelled();
69
+ }
70
+ catch (cause) {
71
+ if (options?.signal?.aborted)
72
+ checkCancelled();
73
+ throw unavailable(`${key} is unavailable at ${path}: ${cause instanceof Error ? cause.message : String(cause)}. Configure the requested core-only context, or omit include_debugger_context for basic recorded evidence.`, cause);
74
+ }
75
+ }
76
+ checkCancelled();
77
+ const stage = join(rootPath, "debugger");
78
+ await mkdir(stage, { mode: 0o700 });
79
+ const requestPath = join(stage, "request.json");
80
+ const replyPath = join(stage, "reply.json");
81
+ await writeFile(requestPath, JSON.stringify({
82
+ snapshot_path: join(rootPath, "object.snapshot"),
83
+ reply_path: replyPath,
84
+ gdb,
85
+ gdbinit: entry,
86
+ venv,
87
+ }), { flag: "wx", mode: 0o600 });
88
+ let output;
89
+ try {
90
+ options?.signal?.throwIfAborted();
91
+ const execution = await runOwnedCommand({
92
+ command: environment.REA_PWNTOOLS_PYTHON ?? "",
93
+ arguments: [
94
+ "-I",
95
+ fileURLToPath(new URL("../../../bridge/pwndbg/launch.py", import.meta.url)),
96
+ join(stage, "resource.failure"),
97
+ requestPath,
98
+ ],
99
+ cwd: stage,
100
+ runId: `rea-recorded-core-debugger-${randomUUID()}`,
101
+ hostEnvironment: {
102
+ ...environment,
103
+ PWNDBG_NO_AUTOUPDATE: "1",
104
+ PWNDBG_VENV_PATH: venv,
105
+ PWNLIB_NOTERM: "1",
106
+ TERM: "dumb",
107
+ HOME: stage,
108
+ XDG_CACHE_HOME: join(stage, "cache"),
109
+ XDG_CONFIG_HOME: join(stage, "config"),
110
+ PYTHONNOUSERSITE: "1",
111
+ OPENBLAS_NUM_THREADS: "1",
112
+ OMP_NUM_THREADS: "1",
113
+ },
114
+ }, {
115
+ timeoutMs: PWNTOOLS_LIMITS.timeoutMs,
116
+ diagnosticBytes: PWNTOOLS_LIMITS.diagnosticBytes,
117
+ }, {
118
+ ...(options?.signal === undefined ? {} : { signal: options.signal }),
119
+ ...(launcher === undefined ? {} : { launcher }),
120
+ });
121
+ output = capturedPwntoolsOutput(execution);
122
+ let reply;
123
+ try {
124
+ const raw = await readStableArtifact(replyPath, PWNTOOLS_LIMITS.outputBytes, options?.signal);
125
+ reply = replySchema.parse(JSON.parse(raw.bytes.toString("utf8")));
126
+ }
127
+ catch (cause) {
128
+ if (options?.signal?.aborted)
129
+ throw new AnalysisCancelledError(OPERATION, {
130
+ capturedOutput: recordedCrashStageOutput(diagnostics, output),
131
+ });
132
+ throw new AnalysisOutputError(OPERATION, `Core-only debugger reply failed: ${cause instanceof Error ? cause.message : String(cause)}`, {
133
+ cause,
134
+ capturedOutput: recordedCrashStageOutput(diagnostics, output),
135
+ });
136
+ }
137
+ if (!reply.ok) {
138
+ if (reply.reason === "unavailable" || reply.reason === "unsupported")
139
+ throw new AnalysisCapabilityUnavailableError("pwndbg-core", OPERATION, reply.message, {
140
+ userMessage: reply.message,
141
+ capturedOutput: recordedCrashStageOutput(diagnostics, output),
142
+ });
143
+ if (reply.reason === "format" || reply.reason === "output-limit")
144
+ throw new AnalysisOutputError(OPERATION, reply.message, {
145
+ capturedOutput: recordedCrashStageOutput(diagnostics, output),
146
+ });
147
+ throw new ProviderAdapterError("pwndbg-core", OPERATION, {
148
+ diagnostics: {
149
+ stage: "debugger",
150
+ reason: reply.message,
151
+ captured_output: { ...recordedCrashStageOutput(diagnostics, output) },
152
+ },
153
+ });
154
+ }
155
+ if (reply.value.status !== "available")
156
+ throw new AnalysisOutputError(OPERATION, "Requested debugger context returned no core evidence.", { capturedOutput: recordedCrashStageOutput(diagnostics, output) });
157
+ return { ...reply.value, diagnostics: output };
158
+ }
159
+ catch (cause) {
160
+ if (options?.signal?.aborted &&
161
+ (cause === options.signal.reason ||
162
+ (cause instanceof Error && cause.name === "AbortError")))
163
+ throw new AnalysisCancelledError(OPERATION, {
164
+ capturedOutput: recordedCrashStageOutput(diagnostics, output),
165
+ });
166
+ throw pwntoolsDecoderFailure(cause, "debugger", gdb, environment.REA_PWNTOOLS_PYTHON ?? "", await readPwntoolsFailureEvidence(cause, stage), {
167
+ operation: OPERATION,
168
+ providerId: "pwndbg-core",
169
+ precedingOutput: diagnostics,
170
+ });
171
+ }
172
+ };
173
+ /** Preserve both stages' exact text and their independently observed truncation state. */
174
+ export const recordedCrashStageOutput = (basic, debuggerOutput) => debuggerOutput === undefined
175
+ ? basic
176
+ : {
177
+ stdout: `[core decoder]\n${basic.stdout}\n[debugger]\n${debuggerOutput.stdout}`,
178
+ stderr: `[core decoder]\n${basic.stderr}\n[debugger]\n${debuggerOutput.stderr}`,
179
+ truncated: basic.truncated || debuggerOutput.truncated,
180
+ };
@@ -0,0 +1,203 @@
1
+ import { pwntoolsDecoderFailure, pwntoolsUnavailable, capturedPwntoolsOutput, } from "./PwntoolsFailures.js";
2
+ import { randomUUID } from "node:crypto";
3
+ import { access, stat, writeFile } from "node:fs/promises";
4
+ import { constants } from "node:fs";
5
+ import { isAbsolute, join } from "node:path";
6
+ import { fileURLToPath } from "node:url";
7
+ import { z } from "zod";
8
+ import { readStableArtifact } from "../../artifacts/readStableArtifact.js";
9
+ import { AnalysisCancelledError, AnalysisCapabilityUnavailableError, AnalysisUnsupportedTargetError, AnalysisInputError, AnalysisOutputError, AnalysisResourceConstraintError, } from "../../domain/analysisErrorCore.js";
10
+ import { projectAnalysisError } from "../../domain/analysisErrorProjection.js";
11
+ import { ProviderAdapterError } from "../../domain/providerAdapterError.js";
12
+ import { ProviderCleanupError } from "../../domain/providerCleanupError.js";
13
+ import { err, ok } from "../../domain/result.js";
14
+ import { runOwnedCommand } from "../../process/OwnedCommand.js";
15
+ import { OwnedCommandFailure } from "../../process/OwnedCommand.js";
16
+ import { pwntoolsResourceLimitsSchema, readPwntoolsFailureEvidence, } from "./PwntoolsResourceLimits.js";
17
+ import { PrivateRuntimeRoot } from "../../process/PrivateRuntimeRoot.js";
18
+ import { PWNTOOLS_PROVIDER_IDENTITY, PWNTOOLS_LIMITS, } from "./PwntoolsRelease.js";
19
+ /** Thin owned-process adapter; all ELF parsing and heuristics come from unchanged upstream code. */
20
+ export class PwntoolsDecoder {
21
+ profile;
22
+ environment;
23
+ launcher;
24
+ createRuntime;
25
+ identity;
26
+ constructor(profile, environment, launcher, createRuntime = () => PrivateRuntimeRoot.create({ prefix: "rea-artifact-decoder-" })) {
27
+ this.profile = profile;
28
+ this.environment = environment;
29
+ this.launcher = launcher;
30
+ this.createRuntime = createRuntime;
31
+ this.identity = profile.identity;
32
+ }
33
+ /** Snapshot one explicit artifact and return complete static observations without launching the selected object as a host process. */
34
+ async inspect(input, options) {
35
+ const OPERATION = this.profile.operation;
36
+ const context = { operation: OPERATION, providerId: this.identity.id };
37
+ const replySchema = z.discriminatedUnion("ok", [
38
+ z.strictObject({
39
+ ok: z.literal(true),
40
+ profile: z.literal(PWNTOOLS_PROVIDER_IDENTITY.version),
41
+ value: this.profile.payloadSchema,
42
+ }),
43
+ z.strictObject({
44
+ ok: z.literal(false),
45
+ reason: z.enum([
46
+ "format",
47
+ "unsupported",
48
+ "unsupported-target",
49
+ "unavailable",
50
+ "resource-limit",
51
+ "output-limit",
52
+ "decoder",
53
+ ]),
54
+ message: z.string(),
55
+ reported_limits: pwntoolsResourceLimitsSchema.nullable().optional(),
56
+ }),
57
+ ]);
58
+ let root;
59
+ let result;
60
+ let phase = "configuration";
61
+ const executablePath = this.environment.REA_PWNTOOLS_PYTHON ?? "";
62
+ let selectedPath = executablePath;
63
+ try {
64
+ if (options?.signal?.aborted)
65
+ throw new AnalysisCancelledError(OPERATION);
66
+ if (process.platform !== "linux" || process.arch !== "x64")
67
+ throw new AnalysisCapabilityUnavailableError(this.identity.id, OPERATION, "The initial real-verified pwntools artifact profile supports Linux x64 only.");
68
+ if (!isAbsolute(selectedPath))
69
+ throw pwntoolsUnavailable("Set REA_PWNTOOLS_PYTHON to an absolute caller-supplied Python executable with pwntools 4.15.0, pyelftools 0.33 and Unicorn 2.1.2; REA never installs Python or packages.", selectedPath, undefined, undefined, context);
70
+ await access(selectedPath, constants.X_OK);
71
+ if (!(await stat(selectedPath)).isFile())
72
+ throw pwntoolsUnavailable("Selected Python executable must be a regular executable file, not a directory: " +
73
+ selectedPath, selectedPath, undefined, undefined, context);
74
+ phase = "artifact-read";
75
+ selectedPath = input.path;
76
+ const snapshot = await readStableArtifact(input.path, PWNTOOLS_LIMITS.inputBytes, options?.signal);
77
+ phase = "decoder";
78
+ root = await this.createRuntime();
79
+ const requestPath = join(root.path, "request.json");
80
+ const snapshotPath = join(root.path, "object.snapshot");
81
+ const replyPath = join(root.path, "reply.json");
82
+ await writeFile(snapshotPath, snapshot.bytes, {
83
+ flag: "wx",
84
+ mode: 0o600,
85
+ ...(options?.signal === undefined ? {} : { signal: options.signal }),
86
+ });
87
+ await writeFile(requestPath, JSON.stringify({ snapshot_path: snapshotPath, reply_path: replyPath }), { flag: "wx", mode: 0o600 });
88
+ const execution = await runOwnedCommand({
89
+ command: this.environment.REA_PWNTOOLS_PYTHON ?? "",
90
+ arguments: [
91
+ "-I",
92
+ fileURLToPath(this.profile.bridge),
93
+ join(root.path, "resource.failure"),
94
+ requestPath,
95
+ ],
96
+ cwd: root.path,
97
+ runId: `rea-artifact-decoder-${randomUUID()}`,
98
+ hostEnvironment: {
99
+ ...this.environment,
100
+ PWNLIB_NOTERM: "1",
101
+ OPENBLAS_NUM_THREADS: "1",
102
+ OMP_NUM_THREADS: "1",
103
+ },
104
+ }, {
105
+ timeoutMs: PWNTOOLS_LIMITS.timeoutMs,
106
+ diagnosticBytes: PWNTOOLS_LIMITS.diagnosticBytes,
107
+ }, {
108
+ ...(options?.signal === undefined ? {} : { signal: options.signal }),
109
+ ...(this.launcher === undefined ? {} : { launcher: this.launcher }),
110
+ });
111
+ const capturedOutput = capturedPwntoolsOutput(execution);
112
+ let reply;
113
+ try {
114
+ const file = await readStableArtifact(replyPath, PWNTOOLS_LIMITS.outputBytes, options?.signal);
115
+ reply = replySchema.parse(JSON.parse(file.bytes.toString("utf8")));
116
+ }
117
+ catch (cause) {
118
+ if (options?.signal?.aborted)
119
+ throw new AnalysisCancelledError(OPERATION, { capturedOutput });
120
+ throw new AnalysisOutputError(OPERATION, `Owned pwntools decoder reply failed for ${input.path}: ${cause instanceof z.ZodError ? cause.issues[0]?.message + " at " + (cause.issues[0]?.path.map(String).join(".") ?? "root") : cause instanceof Error ? cause.message : String(cause)}`, { cause, capturedOutput });
121
+ }
122
+ if (!reply.ok) {
123
+ if (reply.reason === "unsupported-target")
124
+ throw new AnalysisUnsupportedTargetError(OPERATION, input.path, reply.message, { capturedOutput });
125
+ if (reply.reason === "resource-limit")
126
+ throw new AnalysisResourceConstraintError(OPERATION, "memory", reply.message, reply.reported_limits ?? null, { capturedOutput });
127
+ if (reply.reason === "format")
128
+ throw new AnalysisInputError(OPERATION, { capturedOutput }, [
129
+ {
130
+ path: ["path"],
131
+ reason: "invalid_format",
132
+ message: reply.message,
133
+ },
134
+ ]);
135
+ if (reply.reason === "unavailable")
136
+ throw pwntoolsUnavailable(reply.message, this.environment.REA_PWNTOOLS_PYTHON ?? "", undefined, capturedOutput, context);
137
+ if (reply.reason === "unsupported")
138
+ throw new AnalysisCapabilityUnavailableError(this.identity.id, OPERATION, reply.message, { userMessage: reply.message, capturedOutput });
139
+ if (reply.reason === "output-limit")
140
+ throw new AnalysisOutputError(OPERATION, reply.message, {
141
+ capturedOutput,
142
+ });
143
+ throw new ProviderAdapterError(this.identity.id, OPERATION, {
144
+ diagnostics: {
145
+ phase,
146
+ failure_kind: reply.reason,
147
+ reason: reply.message,
148
+ stdout: execution.stdout.text,
149
+ stderr: execution.stderr.text,
150
+ captured_output: { ...capturedOutput },
151
+ },
152
+ });
153
+ }
154
+ result = ok(await this.profile.project({
155
+ input,
156
+ payload: reply.value,
157
+ snapshot,
158
+ rootPath: root.path,
159
+ diagnostics: capturedOutput,
160
+ options,
161
+ }));
162
+ }
163
+ catch (cause) {
164
+ const evidence = await readPwntoolsFailureEvidence(cause, root?.path);
165
+ result = err(options?.signal?.aborted &&
166
+ (cause === options.signal.reason ||
167
+ (cause instanceof Error && cause.name === "AbortError"))
168
+ ? new AnalysisCancelledError(OPERATION)
169
+ : pwntoolsDecoderFailure(cause, phase, selectedPath, executablePath, evidence, context));
170
+ }
171
+ if (root !== undefined) {
172
+ try {
173
+ await root.close();
174
+ }
175
+ catch (cause) {
176
+ return err(new ProviderCleanupError(this.identity.id, [root.path], {
177
+ reason: cause instanceof Error ? cause.message : String(cause),
178
+ previous_error: result.ok
179
+ ? null
180
+ : projectAnalysisError(result.error),
181
+ ...(result.ok
182
+ ? {
183
+ captured_output: {
184
+ stdout: result.value.diagnostics.stdout,
185
+ stderr: result.value.diagnostics.stderr,
186
+ truncated: result.value.diagnostics.truncated,
187
+ },
188
+ }
189
+ : {}),
190
+ }, { operation: OPERATION }));
191
+ }
192
+ }
193
+ return result.ok && options?.signal?.aborted
194
+ ? err(new AnalysisCancelledError(OPERATION, {
195
+ capturedOutput: {
196
+ stdout: result.value.diagnostics.stdout,
197
+ stderr: result.value.diagnostics.stderr,
198
+ truncated: result.value.diagnostics.truncated,
199
+ },
200
+ }))
201
+ : result;
202
+ }
203
+ }