rea-agents 6.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 (343) hide show
  1. package/README.md +23 -17
  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 +0 -2
  6. package/bridge/native/rea_lldb_tracer.py +630 -94
  7. package/bridge/process/ProcessRunTokenReader.swift +39 -5
  8. package/bridge/pwntools/recorded_crash_impl.py +4 -0
  9. package/dist/android/JadxConfiguration.js +196 -33
  10. package/dist/android/JadxMcpTransport.js +4 -0
  11. package/dist/android/JadxProtocol.js +6 -0
  12. package/dist/android/JadxProvider.js +19 -2
  13. package/dist/android/JadxSession.js +23 -4
  14. package/dist/application/AnalysisContextQueries.js +8 -35
  15. package/dist/application/AnalysisDocument.js +32 -0
  16. package/dist/application/AppBundleExecutable.js +67 -21
  17. package/dist/application/CallPathTracing.js +19 -3
  18. package/dist/application/CapabilityInventory.js +6 -3
  19. package/dist/application/ClientConfigurationDocument.js +871 -6
  20. package/dist/application/ClientRegistrationIdentity.js +26 -5
  21. package/dist/application/ClientRegistrationStatus.js +29 -14
  22. package/dist/application/DirectAnalysis.js +27 -37
  23. package/dist/application/Doctor.js +4 -2
  24. package/dist/application/DoctorScope.js +25 -13
  25. package/dist/application/EnhancedLiteralTracing.js +22 -25
  26. package/dist/application/EnhancedTools.js +13 -11
  27. package/dist/application/EvidenceBundleFiles.js +23 -11
  28. package/dist/application/FunctionAnalysisEvidence.js +2 -3
  29. package/dist/application/InventoryProjectionEvidence.js +4 -3
  30. package/dist/application/InvestigationProviders.js +3 -2
  31. package/dist/application/JsonFiles.js +50 -28
  32. package/dist/application/ProcedureAddressResolution.js +11 -0
  33. package/dist/application/ReconstructionCoverageService.js +7 -4
  34. package/dist/application/ReconstructionObligationLedgerService.js +4 -3
  35. package/dist/application/Setup.js +13 -1
  36. package/dist/application/SetupClientConfiguration.js +10 -15
  37. package/dist/application/SetupHost.js +5 -2
  38. package/dist/application/SetupPlan.js +5 -3
  39. package/dist/application/SupportedClients.js +34 -1
  40. package/dist/application/Uninstall.js +4 -3
  41. package/dist/application/Update.js +18 -3
  42. package/dist/application/UpdateRuntime.js +46 -25
  43. package/dist/application/WebModuleTraceService.js +4 -2
  44. package/dist/application/WebNetworkCaptureService.js +4 -2
  45. package/dist/application/WebRuntimeService.js +5 -3
  46. package/dist/application/WebScriptExportService.js +2 -2
  47. package/dist/application/WebSourceLocationService.js +4 -2
  48. package/dist/application/WorkflowEvidence.js +82 -0
  49. package/dist/application/binary/AnalysisProviderEvaluation.js +21 -5
  50. package/dist/application/binary/AnalysisProviderRegistry.js +2 -0
  51. package/dist/application/binary/AnalysisSnapshotCache.js +3 -6
  52. package/dist/application/binary/BinarySession.js +95 -68
  53. package/dist/application/binary/BinarySessionOpen.js +3 -3
  54. package/dist/application/binary/BinarySessionRecords.js +25 -3
  55. package/dist/application/binary/BinarySessionStatus.js +17 -1
  56. package/dist/application/binary/CompositeProvider.js +13 -0
  57. package/dist/application/binary/LazyAnalysisProvider.js +3 -0
  58. package/dist/application/binaryDiagnostics/BinaryLayoutService.js +4 -2
  59. package/dist/application/binaryDiagnostics/RecordedCrashService.js +4 -2
  60. package/dist/application/evm/EvmInterfaceService.js +4 -2
  61. package/dist/application/investigation/EvidenceLedger.js +21 -7
  62. package/dist/application/investigation/InvestigationRecords.js +8 -0
  63. package/dist/application/javascript/JavaScriptAnalysisControl.js +34 -0
  64. package/dist/application/javascript/JavaScriptApplicationEvidence.js +24 -3
  65. package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
  66. package/dist/application/javascript/JavaScriptApplicationService.js +22 -15
  67. package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
  68. package/dist/application/javascript/JavaScriptArtifactAnalysis.js +5 -4
  69. package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +39 -7
  70. package/dist/application/javascript/JavaScriptArtifactPathResolution.js +6 -3
  71. package/dist/application/javascript/JavaScriptArtifactReconstruction.js +11 -3
  72. package/dist/application/javascript/JavaScriptModuleRelationships.js +37 -8
  73. package/dist/application/javascript/JavaScriptRecoveryService.js +4 -2
  74. package/dist/application/javascript/JavaScriptRuntimeObservationService.js +3 -1
  75. package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +3 -3
  76. package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +63 -61
  77. package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +23 -1
  78. package/dist/application/managed/ManagedApplicationGraphService.js +4 -3
  79. package/dist/application/managed/ManagedMemberComparisonService.js +7 -4
  80. package/dist/application/managed/ManagedNativeVerificationService.js +4 -3
  81. package/dist/application/managed/ManagedReconstructionService.js +4 -3
  82. package/dist/application/process/ProcessCli.js +14 -6
  83. package/dist/application/process/ProcessEvidence.js +4 -3
  84. package/dist/application/workflowInputError.js +18 -0
  85. package/dist/artifacts/ArtifactProvider.js +12 -2
  86. package/dist/artifacts/MachOSliceArtifactReader.js +98 -14
  87. package/dist/artifacts/NativeDmgArtifactReader.js +13 -6
  88. package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +22 -3
  89. package/dist/artifacts/apple/InterfaceBuilderAnalysis.js +176 -56
  90. package/dist/artifacts/apple/InterfaceBuilderDecodeBudget.js +195 -0
  91. package/dist/artifacts/apple/KeyedArchiveReader.js +36 -22
  92. package/dist/artifacts/apple/MachoLoadCommandReader.js +92 -31
  93. package/dist/artifacts/apple/NibArchive.js +81 -14
  94. package/dist/artifacts/apple/NibViewHierarchy.js +10 -3
  95. package/dist/artifacts/apple/PlistNumberLiterals.js +164 -0
  96. package/dist/artifacts/inventory/ArtifactGraphConstruction.js +13 -8
  97. package/dist/artifacts/inventory/scanCanonical.js +11 -14
  98. package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
  99. package/dist/browser/CdpCaptureCompleteness.js +2 -0
  100. package/dist/browser/CdpCaptureEventHandlers.js +76 -11
  101. package/dist/browser/CdpCaptureEventTypes.js +5 -1
  102. package/dist/browser/CdpCaptureEvents.js +25 -0
  103. package/dist/browser/CdpConnection.js +30 -11
  104. package/dist/browser/CdpOptionalCommand.js +2 -3
  105. package/dist/browser/CdpPageCapture.js +23 -1
  106. package/dist/browser/PlaywrightElectronActiveActions.js +32 -23
  107. package/dist/browser/PlaywrightElectronActiveProjection.js +141 -0
  108. package/dist/browser/PlaywrightElectronActiveProvider.js +123 -124
  109. package/dist/browser/WebSourceMapFetcher.js +426 -72
  110. package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
  111. package/dist/browser/history/CaptureFailures.js +37 -1
  112. package/dist/browser/history/CaptureRelease.js +5 -0
  113. package/dist/browser/history/HarCaptureAdapter.js +3 -3
  114. package/dist/browser/history/HarJson.js +3 -2
  115. package/dist/browser/history/HistoricalCaptureDecoder.js +4 -2
  116. package/dist/cli/analysisSelector.js +23 -0
  117. package/dist/cli/applicationCommands.js +2 -3
  118. package/dist/cli/coreBinaryCommands.js +70 -12
  119. package/dist/cli/electronCommands.js +7 -6
  120. package/dist/cli/javascriptApplicationAnalysis.js +7 -3
  121. package/dist/cli/jsonOutput.js +4 -99
  122. package/dist/cli/nativeCallCommands.js +2 -3
  123. package/dist/cli/webRuntimeCommands.js +8 -8
  124. package/dist/cli.js +2 -1
  125. package/dist/cliCommandNames.js +0 -1
  126. package/dist/cliJsonInput.js +9 -4
  127. package/dist/config/environment.js +4 -0
  128. package/dist/config/ghidraStartupTimeout.js +17 -0
  129. package/dist/config/mcpResponseBudget.js +22 -0
  130. package/dist/config/parseConfig.js +2 -1
  131. package/dist/contracts/enhancedInputs.js +5 -3
  132. package/dist/contracts/enhancedToolContracts.js +3 -3
  133. package/dist/contracts/hopperMemoryContracts.js +2 -5
  134. package/dist/contracts/javascript/electronToolContracts.js +1 -1
  135. package/dist/contracts/managed/managedToolContracts.js +2 -4
  136. package/dist/contracts/native/nativeToolContracts.js +4 -2
  137. package/dist/contracts/officialToolContracts.js +14 -15
  138. package/dist/contracts/promptContracts.js +3 -3
  139. package/dist/contracts/sessionLifecycleInputs.js +3 -7
  140. package/dist/contracts/sessionStatusContract.js +2 -4
  141. package/dist/contracts/sessionToolContracts.js +4 -6
  142. package/dist/contracts/sessionToolSchemas.js +2 -5
  143. package/dist/contracts/toolContractExamples.js +0 -1
  144. package/dist/contracts/toolContractHelpers.js +4 -1
  145. package/dist/contracts/toolEffects.js +0 -1
  146. package/dist/contracts/toolOutputSchemaGroups.js +28 -27
  147. package/dist/contracts/toolOutputSchemaPrimitives.js +18 -0
  148. package/dist/contracts/toolSchemaMetadata.js +69 -10
  149. package/dist/contracts/webNetworkCaptureToolContracts.js +1 -1
  150. package/dist/domain/analysisErrorBase.js +8 -3
  151. package/dist/domain/analysisErrorCore.js +3 -1
  152. package/dist/domain/analysisErrorPresentation.js +72 -17
  153. package/dist/domain/analysisErrorProjection.js +106 -27
  154. package/dist/domain/android/androidAnalysis.js +2 -4
  155. package/dist/domain/android/androidApplication.js +17 -9
  156. package/dist/domain/apple/appleApplication.js +41 -14
  157. package/dist/domain/apple/dyldEnvironment.js +73 -0
  158. package/dist/domain/apple/dylibResolution.js +120 -9
  159. package/dist/domain/apple/dylibResolutionFindings.js +9 -7
  160. package/dist/domain/apple/interfaceBuilderGraph.js +25 -13
  161. package/dist/domain/apple/interfaceBuilderKeyedArchive.js +13 -3
  162. package/dist/domain/apple/keyedArchive.js +9 -1
  163. package/dist/domain/apple/machoContainer.js +54 -0
  164. package/dist/domain/apple/plistNumbers.js +76 -0
  165. package/dist/domain/artifactIdentity.js +29 -0
  166. package/dist/domain/artifactInventoryEvidence.js +19 -24
  167. package/dist/domain/bridgeCandidateProjection.js +71 -0
  168. package/dist/domain/browserCompleteness.js +1 -0
  169. package/dist/domain/browserObservationError.js +24 -5
  170. package/dist/domain/browserScenarioValues.js +2 -6
  171. package/dist/domain/bundleComparison.js +3 -2
  172. package/dist/domain/canonicalJsonDigestSteps.js +133 -0
  173. package/dist/domain/canonicalOrdering.js +9 -5
  174. package/dist/domain/changedBehavior.js +6 -6
  175. package/dist/domain/comparisonSourceEvidence.js +40 -0
  176. package/dist/domain/configurationErrors.js +1 -1
  177. package/dist/domain/evidence.js +64 -9
  178. package/dist/domain/evidenceBundle.js +42 -1
  179. package/dist/domain/evidenceErrors.js +12 -1
  180. package/dist/domain/explicitSensitiveFailure.js +17 -1
  181. package/dist/domain/firmware/firmwareAnalysis.js +6 -7
  182. package/dist/domain/hopperErrors.js +23 -2
  183. package/dist/domain/hopperValues.js +51 -8
  184. package/dist/domain/immutableJson.js +114 -0
  185. package/dist/domain/inputIssueProjection.js +3 -0
  186. package/dist/domain/javascript/electronActiveObservation.js +30 -4
  187. package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
  188. package/dist/domain/javascript/javascriptApplicationAnalysis.js +71 -23
  189. package/dist/domain/javascript/javascriptApplicationGraph.js +13 -0
  190. package/dist/domain/javascript/javascriptAstValues.js +20 -0
  191. package/dist/domain/javascript/javascriptRecovery.js +3 -8
  192. package/dist/domain/javascript/javascriptSemanticAnalysis.js +97 -2
  193. package/dist/domain/javascript/javascriptSemanticCoverage.js +6 -5
  194. package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +9 -17
  195. package/dist/domain/javascript/javascriptSemanticDataEffects.js +22 -5
  196. package/dist/domain/javascript/javascriptSemanticGraph.js +13 -0
  197. package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +1 -0
  198. package/dist/domain/javascript/javascriptSemanticPrimitives.js +25 -17
  199. package/dist/domain/javascript/javascriptSemanticQuerySchemas.js +8 -4
  200. package/dist/domain/javascript/javascriptSemanticResourceLimits.js +77 -0
  201. package/dist/domain/javascript/javascriptSemanticValues.js +83 -11
  202. package/dist/domain/javascript/javascriptSourceParser.js +6 -2
  203. package/dist/domain/javascript/javascriptStaticAnalysis.js +22 -17
  204. package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +5 -3
  205. package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +14 -4
  206. package/dist/domain/javascript/javascriptStaticAnalysisFindings.js +66 -7
  207. package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +28 -16
  208. package/dist/domain/javascript/javascriptStaticAnalysisState.js +3 -2
  209. package/dist/domain/jsonSerialization.js +109 -0
  210. package/dist/domain/jsonValue.js +90 -6
  211. package/dist/domain/localPath.js +6 -0
  212. package/dist/domain/managed/managedApplicationGraph.js +10 -10
  213. package/dist/domain/managed/managedInspectionEvidence.js +16 -0
  214. package/dist/domain/managed/managedMemberComparisonMatch.js +5 -9
  215. package/dist/domain/managed/managedNativeVerification.js +3 -9
  216. package/dist/domain/native/fileOffsetPartialObservation.js +1 -0
  217. package/dist/domain/native/nativeCallObservation.js +33 -11
  218. package/dist/domain/native/nativeCallPartialObservation.js +33 -0
  219. package/dist/domain/process/processCapture.js +8 -4
  220. package/dist/domain/process/processComparison.js +38 -4
  221. package/dist/domain/process/processScenario.js +11 -10
  222. package/dist/domain/propertyListKeys.js +1 -1
  223. package/dist/domain/propertyListXmlText.js +19 -0
  224. package/dist/domain/providerAdapterError.js +1 -1
  225. package/dist/domain/providerOperationHealth.js +54 -0
  226. package/dist/domain/reconstructionVerification.js +6 -43
  227. package/dist/domain/reconstructionVerificationSchemas.js +2 -2
  228. package/dist/domain/staticRuntimeCorrelation.js +6 -43
  229. package/dist/domain/webBundleAnalysis.js +20 -8
  230. package/dist/domain/webBundleAnalyzerInspection.js +13 -8
  231. package/dist/domain/webBundleAnalyzerResult.js +41 -2
  232. package/dist/domain/webRuntime.js +19 -5
  233. package/dist/domain/webSourceLocation.js +1 -0
  234. package/dist/firmware/FirmwareFiles.js +1 -1
  235. package/dist/generatedPackageMetadata.js +1 -1
  236. package/dist/ghidra/GhidraAnalysisProfile.js +5 -0
  237. package/dist/ghidra/GhidraClient.js +47 -14
  238. package/dist/ghidra/GhidraDiagnostics.js +7 -7
  239. package/dist/ghidra/GhidraFunctionValues.js +10 -7
  240. package/dist/ghidra/GhidraInstallation.js +18 -21
  241. package/dist/ghidra/GhidraInventoryValues.js +14 -4
  242. package/dist/ghidra/GhidraJavaLaunch.js +62 -0
  243. package/dist/ghidra/GhidraLauncher.js +33 -16
  244. package/dist/ghidra/GhidraProviderCapabilities.js +14 -2
  245. package/dist/ghidra/GhidraProviderClient.js +23 -12
  246. package/dist/ghidra/GhidraSessionError.js +11 -7
  247. package/dist/ghidra/GhidraTargetSnapshot.js +47 -12
  248. package/dist/ghidra/GhidraTransport.js +20 -0
  249. package/dist/hopper/BridgeLauncher.js +31 -11
  250. package/dist/hopper/HopperAnalysisProfile.js +62 -4
  251. package/dist/hopper/HopperCleanup.js +15 -3
  252. package/dist/hopper/HopperClient.js +222 -14
  253. package/dist/hopper/HopperFileOffset.js +237 -0
  254. package/dist/hopper/HopperMachOImage.js +196 -0
  255. package/dist/hopper/HopperOperationStage.js +6 -0
  256. package/dist/hopper/HopperProvider.js +63 -9
  257. package/dist/hopper/HopperProviderCapabilities.js +19 -1
  258. package/dist/hopper/HopperRegexSearch.js +137 -0
  259. package/dist/hopper/HopperRegexWorker.js +27 -0
  260. package/dist/hopper/HopperRequestQueue.js +68 -19
  261. package/dist/hopper/HopperTargetLease.js +3 -2
  262. package/dist/inspector/JavaScriptRuntimeScope.js +9 -1
  263. package/dist/inspector/V8InspectorCaptureProjection.js +8 -3
  264. package/dist/inspector/V8InspectorProvider.js +47 -11
  265. package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
  266. package/dist/javascript/sourceMaps/SourceMapCommand.js +16 -0
  267. package/dist/javascript/sourceMaps/SourceMapFormat.js +79 -31
  268. package/dist/javascript/sourceMaps/TraceSourceMap.js +14 -28
  269. package/dist/mcpDoctor.js +62 -2
  270. package/dist/native/AppleDispatchCoverage.js +47 -6
  271. package/dist/native/AppleDispatchDecodeFacts.js +6 -0
  272. package/dist/native/AppleDispatchMetadata.js +6 -3
  273. package/dist/native/AppleMachoFixups.js +48 -24
  274. package/dist/native/AppleMachoSelection.js +32 -16
  275. package/dist/native/AppleObjcCategories.js +6 -2
  276. package/dist/native/AppleObjcDispatchFacets.js +5 -2
  277. package/dist/native/AppleObjcProperties.js +2 -1
  278. package/dist/native/AppleSwiftDispatchFacets.js +27 -21
  279. package/dist/native/AppleSwiftVtables.js +21 -15
  280. package/dist/native/CommandRunner.js +81 -84
  281. package/dist/native/LldbCallTracer.js +365 -102
  282. package/dist/native/LldbRetainedObservations.js +178 -0
  283. package/dist/native/NativeCallObservation.js +62 -3
  284. package/dist/native/NativeMacOSProvider.js +98 -17
  285. package/dist/native/SignatureTargetBinding.js +155 -0
  286. package/dist/native/parsers/lipo.js +71 -1
  287. package/dist/native/pwndbg/PwndbgCoreContext.js +25 -5
  288. package/dist/native/pwntools/RecordedCrashStructureBindings.js +2 -0
  289. package/dist/process/DarwinProcessRunTokenReader.js +8 -9
  290. package/dist/process/ExecFileOutput.js +20 -0
  291. package/dist/process/OwnedCommand.js +7 -2
  292. package/dist/process/ProcessOwnership.js +203 -53
  293. package/dist/process/ProcessOwnershipObservation.js +49 -4
  294. package/dist/process/ProviderProcess.js +38 -7
  295. package/dist/process/capture/ProcessCaptureError.js +2 -2
  296. package/dist/process/capture/ProcessCaptureLifecycle.js +100 -34
  297. package/dist/server/EvidenceMcpServer.js +146 -0
  298. package/dist/server/createServer.js +15 -8
  299. package/dist/server/registerAndroidTools.js +2 -4
  300. package/dist/server/registerApplicationTools/helpers.js +2 -4
  301. package/dist/server/registerArtifactComparisonTool.js +11 -7
  302. package/dist/server/registerBinaryDiagnosticsTools.js +2 -4
  303. package/dist/server/registerBrowserScenarioTool.js +2 -4
  304. package/dist/server/registerBrowserTools.js +2 -4
  305. package/dist/server/registerBundleComparisonTool.js +2 -3
  306. package/dist/server/registerCloseLifecycleTool.js +8 -18
  307. package/dist/server/registerElectronTools.js +2 -4
  308. package/dist/server/registerEnhancedTools.js +18 -59
  309. package/dist/server/registerEvidenceTools.js +2 -4
  310. package/dist/server/registerEvmTools.js +2 -4
  311. package/dist/server/registerFirmwareTools.js +2 -4
  312. package/dist/server/registerFunctionComparisonTool.js +10 -6
  313. package/dist/server/registerInvestigationTools.js +7 -7
  314. package/dist/server/registerJavaScriptRecoveryTool.js +2 -4
  315. package/dist/server/registerJavaScriptRuntimeObservationTools.js +2 -4
  316. package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +2 -4
  317. package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +2 -4
  318. package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +2 -4
  319. package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +2 -4
  320. package/dist/server/registerOfficialTools.js +2 -4
  321. package/dist/server/registerProcessComparisonTool.js +71 -45
  322. package/dist/server/registerRecordedCrashTools.js +2 -4
  323. package/dist/server/registerSessionRecordTools.js +5 -6
  324. package/dist/server/registerSessionStatusTool.js +17 -3
  325. package/dist/server/registerSessionTools.js +11 -3
  326. package/dist/server/registerWebModuleTool.js +2 -4
  327. package/dist/server/registerWebNetworkCaptureTool.js +2 -4
  328. package/dist/server/registerWebRuntimeTools.js +3 -7
  329. package/dist/server/registerWebScriptTool.js +2 -4
  330. package/dist/server/registerWebSourceLocationTool.js +2 -4
  331. package/dist/server/runDerivedOperation.js +15 -3
  332. package/dist/server/sessionAvailabilityPolicy.js +0 -1
  333. package/dist/server/toolRegistrationOptions.js +2 -2
  334. package/dist/server/toolResult.js +62 -10
  335. package/dist/server/toolResultEncoding.js +33 -0
  336. package/install.sh +1 -1
  337. package/native/windows/build/manifest.json +1 -1
  338. package/package.json +8 -3
  339. package/scripts/electron-active-hook-boundaries.cjs +18 -20
  340. package/scripts/electron-active-hook.cjs +241 -37
  341. package/skills/reverse-engineer-anything/SKILL.md +11 -3
  342. package/skills/reverse-engineer-anything/references/javascript-applications.md +8 -1
  343. package/dist/ghidra/GhidraDefaults.js +0 -2
@@ -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;
@@ -28,7 +28,7 @@ const replySchema = z.discriminatedUnion("ok", [
28
28
  }),
29
29
  ]);
30
30
  /** Add mapping candidates from an owned core-only debugger, using the existing snapshot. */
31
- export const inspectPwndbgCore = async ({ environment, rootPath, diagnostics, options, launcher, }) => {
31
+ export const inspectPwndbgCore = async ({ environment, rootPath, diagnostics, options, launcher, probePath, }) => {
32
32
  const gdb = environment.REA_PWNDBG_GDB ?? "/usr/bin/gdb";
33
33
  const entry = environment.REA_PWNDBG_GDBINIT ?? "";
34
34
  const venv = environment.REA_PWNDBG_VENV_PATH ?? "";
@@ -37,23 +37,43 @@ export const inspectPwndbgCore = async ({ environment, rootPath, diagnostics, op
37
37
  userMessage: message,
38
38
  capturedOutput: diagnostics,
39
39
  });
40
+ const checkCancelled = () => {
41
+ if (options?.signal?.aborted)
42
+ throw new AnalysisCancelledError(OPERATION, {
43
+ capturedOutput: diagnostics,
44
+ });
45
+ };
46
+ checkCancelled();
40
47
  for (const [key, path, kind] of [
41
48
  ["REA_PWNDBG_GDB", gdb, "file"],
42
49
  ["REA_PWNDBG_GDBINIT", entry, "file"],
43
50
  ["REA_PWNDBG_VENV_PATH", venv, "directory"],
44
51
  ]) {
45
52
  try {
53
+ checkCancelled();
46
54
  if (!isAbsolute(path))
47
55
  throw new Error("Expected an absolute caller-supplied path.");
48
- await access(path, key === "REA_PWNDBG_GDB" ? constants.X_OK : constants.R_OK);
49
- const information = await stat(path);
50
- if (kind === "file" ? !information.isFile() : !information.isDirectory())
51
- throw new Error(`Expected a ${kind}.`);
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();
52
69
  }
53
70
  catch (cause) {
71
+ if (options?.signal?.aborted)
72
+ checkCancelled();
54
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);
55
74
  }
56
75
  }
76
+ checkCancelled();
57
77
  const stage = join(rootPath, "debugger");
58
78
  await mkdir(stage, { mode: 0o700 });
59
79
  const requestPath = join(stage, "request.json");
@@ -60,6 +60,8 @@ export function validateRecordedCrashStructure(report, snapshot, diagnostics) {
60
60
  if (!header
61
61
  .subarray(0, 6)
62
62
  .equals(Buffer.from([0x7f, 0x45, 0x4c, 0x46, 2, 1])) ||
63
+ header[6] !== 1 ||
64
+ header.readUInt32LE(20) !== 1 ||
63
65
  ![0, 3].includes(header[7] ?? -1) ||
64
66
  header[8] !== 0 ||
65
67
  header.readUInt16LE(16) !== 4 ||
@@ -114,18 +114,15 @@ export const createDarwinProcessRunTokenReader = (options = {}) => {
114
114
  if (signal.aborted || closed)
115
115
  throw abortReason(signal);
116
116
  const output = join(operationRoot, "reader");
117
+ const compilerEnvironment = { ...process.env };
118
+ // Use Swift's reusable default cache for REA's internal helper compilation.
119
+ delete compilerEnvironment.CLANG_MODULE_CACHE_PATH;
117
120
  try {
118
- await execFileOutput(options.xcrun ?? "/usr/bin/xcrun", [
119
- "swiftc",
120
- "-module-cache-path",
121
- join(operationRoot, "modules"),
122
- ...sourceFiles,
123
- "-o",
124
- output,
125
- ], {
121
+ await execFileOutput(options.xcrun ?? "/usr/bin/xcrun", ["swiftc", ...sourceFiles, "-o", output], {
126
122
  timeout: 60_000,
127
123
  maxBuffer: 1024 * 1024,
128
124
  signal,
125
+ env: compilerEnvironment,
129
126
  });
130
127
  }
131
128
  catch (cause) {
@@ -134,7 +131,9 @@ export const createDarwinProcessRunTokenReader = (options = {}) => {
134
131
  const code = cause instanceof Error && "code" in cause
135
132
  ? String(cause.code)
136
133
  : "unknown";
137
- throw new DarwinProcessOwnershipInspectionError(`macOS process ownership inspection requires the Apple Swift compiler via xcrun (compiler result: ${code})`, { cause });
134
+ throw new DarwinProcessOwnershipInspectionError(code === "ENOENT"
135
+ ? `macOS process ownership inspection requires the Apple Swift compiler via xcrun (compiler result: ${code})`
136
+ : `macOS process ownership helper compilation failed via xcrun (compiler result: ${code}): ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
138
137
  }
139
138
  if (signal.aborted || closed)
140
139
  throw abortReason(signal);
@@ -1,4 +1,24 @@
1
1
  import { execFile, } from "node:child_process";
2
+ /** Read captured output metadata from a failed execFileOutput invocation. */
3
+ export const execFileOutputFailure = (cause) => {
4
+ if (!(cause instanceof Error))
5
+ return undefined;
6
+ const stdout = Reflect.get(cause, "stdout");
7
+ const stderr = Reflect.get(cause, "stderr");
8
+ const code = Reflect.get(cause, "code");
9
+ const signal = Reflect.get(cause, "signal");
10
+ const killed = Reflect.get(cause, "killed");
11
+ if (typeof stdout !== "string" || typeof stderr !== "string")
12
+ return undefined;
13
+ return {
14
+ stdout,
15
+ stderr,
16
+ code: typeof code === "string" || typeof code === "number" ? code : null,
17
+ signal: typeof signal === "string" ? signal : null,
18
+ killed: killed === true,
19
+ outputTruncated: code === "ERR_CHILD_PROCESS_STDIO_MAXBUFFER",
20
+ };
21
+ };
2
22
  /** Run a shell-free command while capturing its complete UTF-8 output. */
3
23
  export const execFileOutput = (command, arguments_, options = {}) => new Promise((resolve, reject) => {
4
24
  execFile(command, [...arguments_], {
@@ -83,9 +83,14 @@ const collectOwnedCommand = async (spawn, limits, launcher, deadline, callerSign
83
83
  : "Command deadline elapsed.", snapshot);
84
84
  if (exceeded)
85
85
  throw new OwnedCommandFailure("output-limit", "Command diagnostic output exceeded its complete-output budget.", snapshot);
86
+ const acceptedNonzeroExit = limits.acceptNonZeroExit === true &&
87
+ snapshot.exitCode !== null &&
88
+ snapshot.exitCode !== undefined &&
89
+ snapshot.exitCode !== 0 &&
90
+ snapshot.signal === null;
86
91
  if (processFailure !== undefined ||
87
- snapshot.exitCode !== 0 ||
88
- snapshot.signal !== null)
92
+ ((snapshot.exitCode !== 0 || snapshot.signal !== null) &&
93
+ !acceptedNonzeroExit))
89
94
  throw new OwnedCommandFailure("process", processFailure ??
90
95
  "Command failed; inspect its exit status and diagnostics.", snapshot);
91
96
  }