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
@@ -16,9 +16,19 @@ const ipcEventKinds = new Set([
16
16
  "ipc-renderer-post-message",
17
17
  ]);
18
18
  const events = [];
19
+ // Budget serialized data and estimated retained object/array storage together.
20
+ const retentionBudgetBytes = 16 * 1024 * 1024;
21
+ const snapshotEnvelopeReserveBytes = 1024;
22
+ let estimatedRetainedBytes = 0;
23
+ let serializedBytes = 0;
19
24
  let observed = 0;
20
25
  let observedIpc = 0;
21
26
  let observedRuntime = 0;
27
+ let dropped = 0;
28
+ let droppedIpc = 0;
29
+ let droppedRuntime = 0;
30
+ const droppedFamilies = new Map();
31
+ const droppedRoles = new Map();
22
32
  let sequence = 0;
23
33
  let correlationSequence = 0;
24
34
 
@@ -43,6 +53,73 @@ const shape = (value, depth = 0) => {
43
53
  }
44
54
  };
45
55
 
56
+ // Measure JSON strings without allocating an encoded copy of a caller value.
57
+ const jsonStringBytes = (value) => {
58
+ let bytes = 2;
59
+ for (let index = 0; index < value.length; index += 1) {
60
+ const code = value.charCodeAt(index);
61
+ if (code === 0x22 || code === 0x5c) bytes += 2;
62
+ else if (
63
+ code === 0x08 ||
64
+ code === 0x09 ||
65
+ code === 0x0a ||
66
+ code === 0x0c ||
67
+ code === 0x0d
68
+ )
69
+ bytes += 2;
70
+ else if (code <= 0x1f) bytes += 6;
71
+ else if (code >= 0xd800 && code <= 0xdbff) {
72
+ const next = value.charCodeAt(index + 1);
73
+ if (next >= 0xdc00 && next <= 0xdfff) {
74
+ bytes += 4;
75
+ index += 1;
76
+ } else bytes += 6;
77
+ } else if (code >= 0xdc00 && code <= 0xdfff) bytes += 6;
78
+ else if (code <= 0x7f) bytes += 1;
79
+ else if (code <= 0x7ff) bytes += 2;
80
+ else bytes += 3;
81
+ if (bytes > retentionBudgetBytes) return bytes;
82
+ }
83
+ return bytes;
84
+ };
85
+
86
+ const jsonScalarBytes = (value) => {
87
+ if (value === null) return 4;
88
+ if (typeof value === "string") return jsonStringBytes(value);
89
+ if (typeof value === "boolean") return value ? 4 : 5;
90
+ return String(value).length;
91
+ };
92
+
93
+ const eventFamily = (kind, processTypeValue) => {
94
+ if (kind === "preload" && processTypeValue === "main")
95
+ return "preload-configuration";
96
+ if (kind.startsWith("ipc-renderer"))
97
+ return processTypeValue === "renderer" ? "renderer-ipc" : "ipc";
98
+ return ipcEventKinds.has(kind) ? "ipc" : kind;
99
+ };
100
+
101
+ const noteDropped = (kind, processTypeValue, isIpc) => {
102
+ dropped += 1;
103
+ if (isIpc) droppedIpc += 1;
104
+ else droppedRuntime += 1;
105
+ const family = eventFamily(kind, processTypeValue);
106
+ droppedFamilies.set(family, (droppedFamilies.get(family) ?? 0) + 1);
107
+ if (typeof processTypeValue === "string")
108
+ droppedRoles.set(
109
+ processTypeValue,
110
+ (droppedRoles.get(processTypeValue) ?? 0) + 1,
111
+ );
112
+ if (kind === "window-lifecycle")
113
+ droppedRoles.set("window", (droppedRoles.get("window") ?? 0) + 1);
114
+ if (kind === "web-contents-lifecycle" || kind === "navigation")
115
+ droppedRoles.set(
116
+ "web_contents",
117
+ (droppedRoles.get("web_contents") ?? 0) + 1,
118
+ );
119
+ if (kind === "preload" && processTypeValue === "preload")
120
+ droppedRoles.set("preload", (droppedRoles.get("preload") ?? 0) + 1);
121
+ };
122
+
46
123
  const isAllowedNavigation = (value) => {
47
124
  if (typeof value !== "string") return true;
48
125
  try {
@@ -83,7 +160,8 @@ const frameIdentity = (event) => {
83
160
 
84
161
  const record = (event) => {
85
162
  observed += 1;
86
- if (ipcEventKinds.has(event.kind)) observedIpc += 1;
163
+ const isIpc = ipcEventKinds.has(event.kind);
164
+ if (isIpc) observedIpc += 1;
87
165
  else observedRuntime += 1;
88
166
  const raw = {
89
167
  sequence: ++sequence,
@@ -109,10 +187,15 @@ const record = (event) => {
109
187
  error: false,
110
188
  ...event,
111
189
  };
112
- const argumentShapes = Array.isArray(raw.argument_shapes)
190
+ const shapeGroups = Array.isArray(raw.argument_shape_value_groups)
191
+ ? raw.argument_shape_value_groups.filter(Array.isArray)
192
+ : Array.isArray(raw.argument_shape_values)
193
+ ? [raw.argument_shape_values]
194
+ : [];
195
+ const existingShapes = Array.isArray(raw.argument_shapes)
113
196
  ? raw.argument_shapes
114
197
  : [];
115
- events.push({
198
+ const retainedEvent = {
116
199
  ...raw,
117
200
  correlation_id: raw.correlation_id,
118
201
  event: typeof raw.event === "string" ? raw.event : null,
@@ -121,9 +204,7 @@ const record = (event) => {
121
204
  receiver: typeof raw.receiver === "string" ? raw.receiver : null,
122
205
  frame: typeof raw.frame === "string" ? raw.frame : null,
123
206
  target: typeof raw.target === "string" ? raw.target : null,
124
- argument_shapes: argumentShapes.map((value) =>
125
- typeof value === "string" ? value : "unknown",
126
- ),
207
+ argument_shapes: [],
127
208
  result_shape:
128
209
  typeof raw.result_shape === "string" ? raw.result_shape : null,
129
210
  process_type:
@@ -132,8 +213,91 @@ const record = (event) => {
132
213
  typeof raw.artifact_path === "string" ? raw.artifact_path : null,
133
214
  artifact_sha256:
134
215
  typeof raw.artifact_sha256 === "string" ? raw.artifact_sha256 : null,
135
- });
136
- return events.at(-1);
216
+ };
217
+ delete retainedEvent.argument_shape_values;
218
+ delete retainedEvent.argument_shape_value_groups;
219
+
220
+ // All event values are JSON scalars except argument_shapes. Measure them
221
+ // incrementally so large channels, paths, or shape lists never require a
222
+ // full JSON.stringify temporary allocation before the budget decision.
223
+ let eventBytes = 2;
224
+ let argumentShapeCount = 0;
225
+ const eventKeys = Object.keys(retainedEvent);
226
+ for (let index = 0; index < eventKeys.length; index += 1) {
227
+ const key = eventKeys[index];
228
+ const value = retainedEvent[key];
229
+ if (index > 0) eventBytes += 1;
230
+ eventBytes += jsonStringBytes(key) + 1;
231
+ if (key === "argument_shapes") {
232
+ eventBytes += 2;
233
+ let shapeOverflow = false;
234
+ const countShape = (argument) => {
235
+ const encodedShapeBytes = jsonStringBytes(shape(argument));
236
+ eventBytes += encodedShapeBytes + (argumentShapeCount === 0 ? 0 : 1);
237
+ argumentShapeCount += 1;
238
+ shapeOverflow =
239
+ eventBytes + estimatedRetainedBytes + snapshotEnvelopeReserveBytes >
240
+ retentionBudgetBytes;
241
+ };
242
+ for (const group of shapeGroups)
243
+ for (const argument of group) {
244
+ countShape(argument);
245
+ if (shapeOverflow) break;
246
+ }
247
+ if (shapeOverflow) {
248
+ noteDropped(raw.kind, retainedEvent.process_type, isIpc);
249
+ return null;
250
+ }
251
+ for (const valueShape of existingShapes)
252
+ if (!shapeOverflow) {
253
+ eventBytes +=
254
+ jsonStringBytes(
255
+ typeof valueShape === "string" ? valueShape : "unknown",
256
+ ) + (argumentShapeCount++ === 0 ? 0 : 1);
257
+ shapeOverflow =
258
+ eventBytes + estimatedRetainedBytes + snapshotEnvelopeReserveBytes >
259
+ retentionBudgetBytes;
260
+ }
261
+ if (shapeOverflow) {
262
+ noteDropped(raw.kind, retainedEvent.process_type, isIpc);
263
+ return null;
264
+ }
265
+ } else eventBytes += jsonScalarBytes(value);
266
+ if (
267
+ eventBytes + estimatedRetainedBytes + snapshotEnvelopeReserveBytes >
268
+ retentionBudgetBytes
269
+ ) {
270
+ noteDropped(raw.kind, retainedEvent.process_type, isIpc);
271
+ return null;
272
+ }
273
+ }
274
+ // Reserve room for the only fields mutated after recording: result_shape and
275
+ // error. The shape vocabulary's longest value is "undefined".
276
+ const reservedMutationBytes = retainedEvent.result_shape === null ? 7 : 0;
277
+ // Include one byte for the event-array separator and reserve space for the
278
+ // snapshot's counters and JSON delimiters.
279
+ // One retained event, one defensive snapshot copy, and up to two serialized
280
+ // result views (timeline plus IPC), with per-object and per-array-slot costs.
281
+ const eventEstimateBytes = eventBytes * 3 + 512 + argumentShapeCount * 16;
282
+ const retainedEventBytes = eventEstimateBytes + reservedMutationBytes + 1;
283
+ if (
284
+ estimatedRetainedBytes + retainedEventBytes + snapshotEnvelopeReserveBytes >
285
+ retentionBudgetBytes
286
+ ) {
287
+ noteDropped(raw.kind, retainedEvent.process_type, isIpc);
288
+ return null;
289
+ }
290
+ for (const group of shapeGroups)
291
+ for (const argument of group)
292
+ retainedEvent.argument_shapes.push(shape(argument));
293
+ for (const valueShape of existingShapes)
294
+ retainedEvent.argument_shapes.push(
295
+ typeof valueShape === "string" ? valueShape : "unknown",
296
+ );
297
+ events.push(retainedEvent);
298
+ estimatedRetainedBytes += retainedEventBytes;
299
+ serializedBytes += eventBytes + reservedMutationBytes + 1;
300
+ return retainedEvent;
137
301
  };
138
302
 
139
303
  const recordRuntime = (kind, event, phase, details = {}) =>
@@ -145,7 +309,7 @@ const recordIpc = (kind, channel, args, details = {}) =>
145
309
  return record({
146
310
  kind,
147
311
  channel: typeof channel === "string" ? channel : null,
148
- argument_shapes: values.map((value) => shape(value)),
312
+ argument_shape_values: values,
149
313
  ...details,
150
314
  });
151
315
  })();
@@ -222,7 +386,7 @@ const patchNavigationMethods = (webContents, contentsId) => {
222
386
  webContents[method] = function patchedNavigation(...args) {
223
387
  recordRuntime("navigation", method, "attempted", {
224
388
  target: contentsId,
225
- argument_shapes: args.map((value) => shape(value)),
389
+ argument_shape_values: args,
226
390
  });
227
391
  if (method === "loadURL" && !isAllowedNavigation(args[0])) {
228
392
  recordRuntime("navigation", method, "blocked", {
@@ -354,7 +518,7 @@ const patchWebContents = (webContents, windowId) => {
354
518
  recordRuntime("navigation", event, "blocked", {
355
519
  target: contentsId,
356
520
  sender: windowId,
357
- argument_shapes: args.map((value) => shape(value)),
521
+ argument_shape_values: args,
358
522
  error: true,
359
523
  });
360
524
  return;
@@ -363,7 +527,7 @@ const patchWebContents = (webContents, windowId) => {
363
527
  recordRuntime(kind, event, "observed", {
364
528
  target: contentsId,
365
529
  sender: windowId,
366
- argument_shapes: args.map((value) => shape(value)),
530
+ argument_shape_values: args,
367
531
  error: kind === "error",
368
532
  });
369
533
  if (event === "did-create-window") {
@@ -379,31 +543,44 @@ const patchWebContents = (webContents, windowId) => {
379
543
  boundaries.patchWindowOpenHandler(webContents, contentsId);
380
544
  };
381
545
 
382
- const patchBrowserWindow = (electron) => {
383
- const original = electron.BrowserWindow;
384
- if (typeof original !== "function") return;
385
- electron.BrowserWindow = new Proxy(original, {
386
- construct(target, args, newTarget) {
387
- const window = Reflect.construct(target, args, newTarget);
388
- const targetId = identity(window, "window");
389
- recordRuntime("window-lifecycle", "created", "completed", {
390
- target: targetId,
391
- argument_shapes: args.map((value) => shape(value)),
392
- });
393
- const preload = args[0]?.webPreferences?.preload;
546
+ const patchWindows = (app) => {
547
+ if (app === null || app === undefined) return;
548
+ app.on("browser-window-created", (_event, window) => {
549
+ const targetId = identity(window, "window");
550
+ recordRuntime("window-lifecycle", "created", "completed", {
551
+ target: targetId,
552
+ capture_method: "event-emitter",
553
+ });
554
+ try {
555
+ // Electron 44 separates the preload descriptor from WebPreferences.
556
+ // Read the engine's descriptor, never infer a path from application code.
557
+ const preferences = window.webContents.getLastWebPreferences?.();
558
+ const preload =
559
+ typeof preferences?.preload === "string"
560
+ ? preferences.preload
561
+ : window.webContents._getPreloadScript?.()?.filePath;
394
562
  if (typeof preload === "string")
395
563
  recordRuntime("preload", "configured", "completed", {
396
564
  target: targetId,
397
565
  artifact_path: preload,
398
566
  });
399
- patchEmitter(window, (event) =>
400
- recordRuntime("window-lifecycle", event, "observed", {
567
+ } catch (cause) {
568
+ recordRuntime(
569
+ "error",
570
+ cause instanceof Error ? cause.message : String(cause),
571
+ "failed",
572
+ {
401
573
  target: targetId,
402
- }),
574
+ error: true,
575
+ },
403
576
  );
404
- patchWebContents(window.webContents, targetId);
405
- return window;
406
- },
577
+ }
578
+ patchEmitter(window, (event) =>
579
+ recordRuntime("window-lifecycle", event, "observed", {
580
+ target: targetId,
581
+ }),
582
+ );
583
+ patchWebContents(window.webContents, targetId);
407
584
  });
408
585
  };
409
586
 
@@ -427,7 +604,7 @@ try {
427
604
  "observed",
428
605
  {
429
606
  target: "app",
430
- argument_shapes: args.map((value) => shape(value)),
607
+ argument_shape_values: args,
431
608
  process_type: "main",
432
609
  },
433
610
  ),
@@ -435,33 +612,60 @@ try {
435
612
  patchIpcMain(electron.ipcMain);
436
613
  boundaries.patchIpcRenderer(electron.ipcRenderer);
437
614
  boundaries.patchContextBridge(electron.contextBridge);
438
- patchBrowserWindow(electron);
615
+ patchWindows(electron.app);
439
616
  boundaries.patchUtilityProcess(electron.utilityProcess);
440
617
  boundaries.patchShell(electron.shell);
441
- boundaries.patchSessionManager(electron.session);
618
+ boundaries.patchSessionManager(electron.session, electron.app);
442
619
  boundaries.patchApplicationEffects(electron.app);
443
620
  boundaries.patchNativeAddonLoading();
444
621
  boundaries.patchChildProcess();
445
622
  process.once("uncaughtException", (cause, origin) => {
446
623
  recordRuntime("process-lifecycle", "uncaught-exception", "observed", {
447
- argument_shapes: [shape(cause), shape(origin)],
624
+ argument_shape_values: [cause, origin],
448
625
  error: true,
449
626
  });
450
627
  throw cause;
451
628
  });
452
629
  process.once("unhandledRejection", (reason, promise) => {
453
630
  recordRuntime("process-lifecycle", "unhandled-rejection", "observed", {
454
- argument_shapes: [shape(reason), shape(promise)],
631
+ argument_shape_values: [reason, promise],
455
632
  error: true,
456
633
  });
457
634
  throw reason;
458
635
  });
459
- } catch {
636
+ } catch (cause) {
460
637
  globalThis.__reaElectronActiveHookError = true;
638
+ recordRuntime(
639
+ "error",
640
+ cause instanceof Error ? cause.message : String(cause),
641
+ "failed",
642
+ {
643
+ target: "active-hook-installation",
644
+ error: true,
645
+ },
646
+ );
461
647
  }
462
648
 
463
649
  globalThis.__reaElectronActiveSnapshot = () => ({
464
- events: events.slice(),
650
+ events: events.map((event) => ({
651
+ ...event,
652
+ argument_shapes: [...event.argument_shapes],
653
+ })),
654
+ retention_budget_bytes: retentionBudgetBytes,
655
+ estimated_retained_bytes: estimatedRetainedBytes,
656
+ event_serialized_byte_upper_bound: serializedBytes,
657
+ retained: events.length,
658
+ dropped,
659
+ dropped_ipc: droppedIpc,
660
+ dropped_runtime: droppedRuntime,
661
+ dropped_event_families: [...droppedFamilies].map(([family, count]) => ({
662
+ family,
663
+ count,
664
+ })),
665
+ dropped_event_roles: [...droppedRoles].map(([role, count]) => ({
666
+ role,
667
+ count,
668
+ })),
465
669
  observed,
466
670
  observed_ipc: observedIpc,
467
671
  observed_runtime: observedRuntime,
@@ -3,8 +3,7 @@ name: reverse-engineer-anything
3
3
  description: Reverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.
4
4
  metadata:
5
5
  version: "33"
6
- tool_count: 139
7
- catalog_digest: "4c5f67d076baf821b5cb6d6fb2cc0f6c274e96b627b85b892577760a6f71ab1a"
6
+ tool_count: 138
8
7
  ---
9
8
 
10
9
  # REA
@@ -33,7 +32,9 @@ When tools are absent or registration is stale:
33
32
  `npx -y rea-agents@latest doctor --client codex --json`. Substitute the current
34
33
  supported client: `claude_code`, `claude_desktop`, `codex`, `cursor`,
35
34
  `gemini_cli`, `windsurf`, `devin`, `opencode`, `antigravity`, `copilot_cli`,
36
- `commandcode`, or `vscode`. If the client is unknown, use `doctor --json` and
35
+ `commandcode`, `vscode`, `grok_build`, or `grok_bot`. `grok_bot` has no local
36
+ file registration: doctor reports the Grok Bot chat step, and setup does not
37
+ write `mcp.json`. If the client is unknown, use `doctor --json` and
37
38
  inspect its registration results before choosing a setup scope.
38
39
  2. Distinguish the reason. Missing, malformed, or stale registration needs a
39
40
  scoped configuration repair. An aligned registration with no tools in the
@@ -146,6 +147,13 @@ Start with the default result and use its inline Evidence and graph context.
146
147
  Do not repeat an identical tool call. Make a focused follow-up only when the
147
148
  returned result leaves a specific question unanswered.
148
149
 
150
+ If MCP reports `resource_constraint` with `details.resource: "transport"`, use
151
+ its reported same-session Evidence reference with a focused application tool,
152
+ or call `export_evidence_bundle` to write the complete session to a selected
153
+ path. The analysis remains complete in the ledger; avoid repeating it merely
154
+ to request the same oversized response. Complete CLI JSON output also streams
155
+ without a single MCP frame.
156
+
149
157
  Every conclusion must distinguish observations, inferences, and unknowns. Cite
150
158
  Evidence IDs, preserve limitations and incomplete coverage, and never imply
151
159
  that static analysis observed execution. Runtime requests execute the declared
@@ -2,10 +2,17 @@
2
2
 
3
3
  Use `analyze_javascript_application` directly on the operator-supplied ASAR or
4
4
  extracted tree. The complete result, graph, and Evidence context are returned
5
- inline. Source-map contents are part of the static analysis. Start from its
5
+ inline when they fit the MCP frame. Source-map contents are part of the static analysis. Start from its
6
6
  findings, coverage, unknowns, and graph context, then make a focused follow-up
7
7
  only when a specific question remains unanswered.
8
8
 
9
+ An oversized response reports `resource_constraint` and
10
+ `details.resource: "transport"`. Reuse
11
+ `details.reported_limits.evidence_reference` with `trace_application_feature`
12
+ for the module or feature under investigation. `export_evidence_bundle` writes
13
+ the complete canonical session to a caller-selected file. Both workflows keep
14
+ the original Evidence and coverage; a broad follow-up can also exceed framing.
15
+
9
16
  BrowserWindow preferences, preload and contextBridge surfaces, IPC
10
17
  registrations, utility processes, and native binding requests are static syntax
11
18
  observations. Only a unique exact literal IPC channel match supports an inferred
@@ -1,2 +0,0 @@
1
- /** Absolute import, analysis, bridge, and health startup deadline. */
2
- export const GHIDRA_STARTUP_TIMEOUT_MS = 330_000;