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
@@ -6,7 +6,13 @@ import { recordValue } from "./CdpCaptureValues.js";
6
6
  export {} from "./CdpCaptureEventTypes.js";
7
7
  /** Event accumulator that validates and normalizes payloads at ingestion. */
8
8
  export class CdpCaptureEvents {
9
+ #scriptMetadataBudgetExclusionsRecorded = false;
9
10
  scripts = new Map();
11
+ scriptMetadataBudgetOmissionsById = new Map();
12
+ rejectedScriptMetadataBudgetCount = 0;
13
+ rejectedSourceMapMetadataBudgetCount = 0;
14
+ scriptMetadataBytesById = new Map();
15
+ retainedScriptMetadataBytes = 0;
10
16
  executionContextFrames = new Map();
11
17
  network = new Map();
12
18
  networkRequestTimestamps = new Map();
@@ -39,6 +45,12 @@ export class CdpCaptureEvents {
39
45
  this.navigationDuringCapture = false;
40
46
  this.committedDocument = undefined;
41
47
  this.scripts.clear();
48
+ this.scriptMetadataBudgetOmissionsById.clear();
49
+ this.rejectedScriptMetadataBudgetCount = 0;
50
+ this.rejectedSourceMapMetadataBudgetCount = 0;
51
+ this.scriptMetadataBytesById.clear();
52
+ this.retainedScriptMetadataBytes = 0;
53
+ this.#scriptMetadataBudgetExclusionsRecorded = false;
42
54
  this.executionContextFrames.clear();
43
55
  this.network.clear();
44
56
  this.networkRequestTimestamps.clear();
@@ -67,6 +79,19 @@ export class CdpCaptureEvents {
67
79
  // compared against itself rather than the document we just left.
68
80
  this.committedDocument = undefined;
69
81
  }
82
+ /** Record final script metadata omissions after all scriptParsed replacements. */
83
+ recordScriptMetadataBudgetExclusions() {
84
+ if (this.#scriptMetadataBudgetExclusionsRecorded)
85
+ return;
86
+ this.#scriptMetadataBudgetExclusionsRecorded = true;
87
+ const omittedScripts = this.rejectedScriptMetadataBudgetCount;
88
+ const omittedSourceMaps = this.rejectedSourceMapMetadataBudgetCount +
89
+ this.scriptMetadataBudgetOmissionsById.size;
90
+ if (omittedScripts > 0)
91
+ this.completeness.exclude("scripts", "resource_budget_exhausted", omittedScripts);
92
+ if (omittedSourceMaps > 0)
93
+ this.completeness.exclude("source_maps", "resource_budget_exhausted", omittedSourceMaps);
94
+ }
70
95
  ingest(event) {
71
96
  const params = recordValue(event.params);
72
97
  if (params === undefined)
@@ -48,7 +48,7 @@ export class CdpConnection {
48
48
  /** Subscribe to an unexpected transport loss while an operation is active. */
49
49
  onDisconnect(listener) {
50
50
  if (this.#closed) {
51
- listener();
51
+ listener(this.#transportError(this.#transportFailure));
52
52
  return () => undefined;
53
53
  }
54
54
  this.#disconnectListeners.add(listener);
@@ -85,6 +85,7 @@ export class CdpConnection {
85
85
  signal?.addEventListener("abort", onAbort, { once: true });
86
86
  this.#pending.set(id, {
87
87
  method,
88
+ ...(sessionId === undefined ? {} : { sessionId }),
88
89
  resolve,
89
90
  reject,
90
91
  removeAbort: () => signal?.removeEventListener("abort", onAbort),
@@ -171,17 +172,34 @@ export class CdpConnection {
171
172
  const pending = this.#pending.get(id);
172
173
  if (pending === undefined)
173
174
  return;
174
- this.#complete(id, pending);
175
- if ("error" in message) {
176
- const reported = message.error;
177
- pending.reject(new CdpCommandRejection(this.operation, pending.method, isRecord(reported) && typeof reported.code === "number"
178
- ? reported.code
179
- : null, isRecord(reported) && typeof reported.message === "string"
180
- ? reported.message
181
- : null));
175
+ const hasResult = "result" in message;
176
+ const hasError = "error" in message;
177
+ if (("sessionId" in message &&
178
+ (typeof message.sessionId !== "string" ||
179
+ message.sessionId !== pending.sessionId)) ||
180
+ hasResult === hasError) {
181
+ this.#failPending("protocol_error");
182
182
  return;
183
183
  }
184
- pending.resolve("result" in message ? message.result : {});
184
+ if (hasResult) {
185
+ if (!isRecord(message.result)) {
186
+ this.#failPending("protocol_error");
187
+ return;
188
+ }
189
+ this.#complete(id, pending);
190
+ pending.resolve(message.result);
191
+ return;
192
+ }
193
+ const reported = message.error;
194
+ if (!isRecord(reported) ||
195
+ typeof reported.code !== "number" ||
196
+ !Number.isSafeInteger(reported.code) ||
197
+ typeof reported.message !== "string") {
198
+ this.#failPending("protocol_error");
199
+ return;
200
+ }
201
+ this.#complete(id, pending);
202
+ pending.reject(new CdpCommandRejection(this.operation, pending.method, reported.code, reported.message));
185
203
  }
186
204
  #complete(id, pending) {
187
205
  pending.removeAbort();
@@ -211,8 +229,9 @@ export class CdpConnection {
211
229
  this.#failPending(reason);
212
230
  if (wasClosed)
213
231
  return;
232
+ const error = this.#transportError(reason);
214
233
  for (const listener of this.#disconnectListeners)
215
- listener();
234
+ listener(error);
216
235
  this.#disconnectListeners.clear();
217
236
  }
218
237
  #transportError(reason) {
@@ -1,4 +1,4 @@
1
- import { BrowserObservationError } from "../domain/browserObservationError.js";
1
+ import { CdpCommandRejection } from "./CdpCommandRejection.js";
2
2
  import { CdpConnection } from "./CdpConnection.js";
3
3
  /** Execute an optional CDP method while preserving transport and cancellation failures. */
4
4
  export const optionalCdpCommand = async (context, method, parameters, limitations) => {
@@ -6,8 +6,7 @@ export const optionalCdpCommand = async (context, method, parameters, limitation
6
6
  return await context.connection.send(method, parameters, context.sessionId, context.signal);
7
7
  }
8
8
  catch (cause) {
9
- if (!(cause instanceof BrowserObservationError) ||
10
- cause.reason !== "protocol_error")
9
+ if (!(cause instanceof CdpCommandRejection) || cause.code !== -32_601)
11
10
  throw cause;
12
11
  limitations.push(`${method} was unavailable from this browser target.`);
13
12
  return undefined;
@@ -6,6 +6,7 @@ import { CdpCaptureEvents } from "./CdpCaptureEvents.js";
6
6
  import { authorizedMainFrame } from "./CdpAuthorizedMainFrame.js";
7
7
  import { captureStorage } from "./CdpCaptureStorage.js";
8
8
  import { optionalCdpCommand } from "./CdpOptionalCommand.js";
9
+ import { CdpCommandRejection } from "./CdpCommandRejection.js";
9
10
  import { captureAccessibility, captureDom, captureFrames, captureResources, mainFrameUrl, } from "./CdpCaptureDocuments.js";
10
11
  import { allowedSanitizedUrl, delayWithCancellation, } from "./CdpCaptureValues.js";
11
12
  import { captureScripts } from "./CdpPageCaptureScripts.js";
@@ -85,6 +86,7 @@ const captureAuthorizedPage = async (state) => {
85
86
  if (state.events.navigationDuringCapture || completedUrl !== attachedUrl)
86
87
  throw new BrowserObservationError("inspect_web_page", "target_changed");
87
88
  await report(context.progress, 3, "Normalizing browser evidence");
89
+ state.events.recordScriptMetadataBudgetExclusions();
88
90
  return {
89
91
  inspection: normalizedInspection(state, {
90
92
  attachedUrl,
@@ -105,7 +107,27 @@ const captureJsonResponseBodies = async (state) => {
105
107
  const requestId = requestIds[index];
106
108
  if (requestId === undefined)
107
109
  continue;
108
- const result = await optionalCdpCommand(state.context, "Network.getResponseBody", { requestId }, state.limitations);
110
+ const request = state.events.network.get(requestId);
111
+ if (request === undefined)
112
+ continue;
113
+ if (request.encoded_data_length === null) {
114
+ state.events.responseBodyUnavailable(requestId);
115
+ continue;
116
+ }
117
+ let result;
118
+ try {
119
+ result = await optionalCdpCommand(state.context, "Network.getResponseBody", { requestId }, state.limitations);
120
+ }
121
+ catch (cause) {
122
+ if (!(cause instanceof CdpCommandRejection) ||
123
+ cause.command !== "Network.getResponseBody" ||
124
+ cause.code !== -32_000 ||
125
+ cause.reportedMessage === null)
126
+ throw cause;
127
+ state.events.responseBodyUnavailable(requestId);
128
+ state.limitations.push(`Response body unavailable for request ${requestId}: ${cause.userMessage}`);
129
+ continue;
130
+ }
109
131
  if (result !== undefined) {
110
132
  state.events.ingestResponseBody(requestId, result);
111
133
  continue;
@@ -58,6 +58,21 @@ const hookEventSchema = z.strictObject({
58
58
  });
59
59
  const hookSnapshotSchema = z.strictObject({
60
60
  events: z.array(hookEventSchema),
61
+ retention_budget_bytes: z.number().int().min(0),
62
+ estimated_retained_bytes: z.number().int().min(0),
63
+ event_serialized_byte_upper_bound: z.number().int().min(0),
64
+ retained: z.number().int().min(0),
65
+ dropped: z.number().int().min(0),
66
+ dropped_ipc: z.number().int().min(0),
67
+ dropped_runtime: z.number().int().min(0),
68
+ dropped_event_families: z.array(z.strictObject({
69
+ family: z.string().min(1),
70
+ count: z.number().int().min(1),
71
+ })),
72
+ dropped_event_roles: z.array(z.strictObject({
73
+ role: z.string().min(1),
74
+ count: z.number().int().min(1),
75
+ })),
61
76
  observed: z.number().int().min(0),
62
77
  observed_ipc: z.number().int().min(0),
63
78
  observed_runtime: z.number().int().min(0),
@@ -72,6 +87,8 @@ const metricSchema = z.strictObject({
72
87
  const windowMetadataSchema = z.strictObject({
73
88
  window_id: z.string(),
74
89
  web_contents_id: z.string(),
90
+ url: z.string(),
91
+ title: z.string(),
75
92
  visible: z.boolean().nullable(),
76
93
  destroyed: z.boolean(),
77
94
  });
@@ -79,12 +96,12 @@ const windowMetadataSchema = z.strictObject({
79
96
  export const runElectronActions = async (application, input, options) => {
80
97
  const actions = [];
81
98
  for (const action of input.actions) {
82
- if (options.signal?.aborted === true)
83
- throw new BrowserObservationError(OPERATION, "cancelled");
84
99
  const actionStartedAt = Date.now();
85
100
  const windowIndex = actionWindowIndex(action);
86
101
  let selectedWindow;
87
102
  try {
103
+ if (options.signal?.aborted === true)
104
+ throw new BrowserObservationError(OPERATION, "cancelled");
88
105
  selectedWindow =
89
106
  windowIndex === null
90
107
  ? undefined
@@ -200,16 +217,12 @@ const emitDeepLink = (application, action) => application.evaluate(({ app }, pay
200
217
  /** Read the current Electron windows, metrics, and hook snapshot. */
201
218
  // oxlint-disable-next-line max-lines-per-function -- one state read must share one capture boundary.
202
219
  export const readApplicationState = async (application) => {
203
- const pages = application.windows();
204
- const pageSnapshotsPromise = Promise.all(pages.map(async (page, index) => ({
205
- index,
206
- url: page.url(),
207
- title: await page.title(),
208
- })));
209
220
  const windowMetadataPromise = application
210
221
  .evaluate(({ BrowserWindow }) => BrowserWindow.getAllWindows().map((window) => ({
211
222
  window_id: `window:${String(window.id)}`,
212
223
  web_contents_id: `webContents:${String(window.webContents.id)}`,
224
+ url: window.webContents.getURL(),
225
+ title: window.webContents.getTitle(),
213
226
  visible: window.isDestroyed() ? null : window.isVisible(),
214
227
  destroyed: window.isDestroyed(),
215
228
  })))
@@ -234,6 +247,15 @@ export const readApplicationState = async (application) => {
234
247
  ? candidate()
235
248
  : {
236
249
  events: [],
250
+ retention_budget_bytes: 0,
251
+ estimated_retained_bytes: 0,
252
+ event_serialized_byte_upper_bound: 0,
253
+ retained: 0,
254
+ dropped: 0,
255
+ dropped_ipc: 0,
256
+ dropped_runtime: 0,
257
+ dropped_event_families: [],
258
+ dropped_event_roles: [],
237
259
  observed: 0,
238
260
  observed_ipc: 0,
239
261
  observed_runtime: 0,
@@ -241,27 +263,14 @@ export const readApplicationState = async (application) => {
241
263
  };
242
264
  })
243
265
  .then((value) => hookSnapshotSchema.parse(value));
244
- const [pageSnapshots, windowMetadata, processMetrics, electronVersion, hookSnapshot,] = await Promise.all([
245
- pageSnapshotsPromise,
266
+ const [windowMetadata, processMetrics, electronVersion, hookSnapshot] = await Promise.all([
246
267
  windowMetadataPromise,
247
268
  processMetricsPromise,
248
269
  electronVersionPromise,
249
270
  hookSnapshotPromise,
250
271
  ]);
251
272
  return {
252
- windows: pageSnapshots.map((page) => {
253
- const metadata = windowMetadata[page.index];
254
- if (metadata === undefined)
255
- throw new BrowserObservationError(OPERATION, "window_metadata_missing");
256
- return {
257
- window_id: metadata.window_id,
258
- web_contents_id: metadata.web_contents_id,
259
- url: page.url,
260
- title: page.title,
261
- visible: metadata.visible,
262
- destroyed: metadata.destroyed,
263
- };
264
- }),
273
+ windows: windowMetadata,
265
274
  metrics: processMetrics,
266
275
  electronVersion,
267
276
  hookSnapshot,
@@ -0,0 +1,141 @@
1
+ import { electronActiveObservationResultSchema, } from "../domain/javascript/electronActiveObservation.js";
2
+ const observableEventFamilies = [
3
+ "app-lifecycle",
4
+ "window-lifecycle",
5
+ "web-contents-lifecycle",
6
+ "navigation",
7
+ "shell-attempt",
8
+ "process-lifecycle",
9
+ "permission",
10
+ "popup-attempt",
11
+ "download",
12
+ "protocol",
13
+ "preload",
14
+ "preload-configuration",
15
+ "renderer-ipc",
16
+ "native-addon",
17
+ "updater",
18
+ "error",
19
+ "ipc",
20
+ ];
21
+ const ipcEventKinds = new Set([
22
+ "main-handler-invocation",
23
+ "main-event-invocation",
24
+ "utility-process-fork",
25
+ "utility-process-message",
26
+ "ipc-main-to-renderer",
27
+ "ipc-utility-to-main",
28
+ "ipc-renderer-send",
29
+ "ipc-renderer-invoke",
30
+ "ipc-renderer-post-message",
31
+ ]);
32
+ const eventFamily = (kind, processType) => {
33
+ if (kind === "preload" &&
34
+ (processType === "main" || processType === "browser"))
35
+ return "preload-configuration";
36
+ if (kind.startsWith("ipc-renderer"))
37
+ return processType === "renderer" ? "renderer-ipc" : "ipc";
38
+ return ipcEventKinds.has(kind) ? "ipc" : kind;
39
+ };
40
+ const createCoverage = (hookSnapshot) => {
41
+ const observedEventFamilies = [
42
+ ...new Set([
43
+ ...hookSnapshot.events.map(({ kind, process_type }) => eventFamily(kind, process_type)),
44
+ ...hookSnapshot.dropped_event_families.map(({ family }) => family),
45
+ ]),
46
+ ].sort();
47
+ const unavailableEventFamilies = new Set(observableEventFamilies.filter((family) => !observedEventFamilies.includes(family)));
48
+ const observedRoles = [
49
+ ...new Set([
50
+ ...hookSnapshot.events.flatMap(({ process_type, kind }) => [
51
+ ...(process_type === null ? [] : [process_type]),
52
+ ...(kind === "window-lifecycle" ? ["window"] : []),
53
+ ...(kind === "web-contents-lifecycle" || kind === "navigation"
54
+ ? ["web_contents"]
55
+ : []),
56
+ ...(kind === "preload" && process_type === "preload"
57
+ ? ["preload"]
58
+ : []),
59
+ ...(kind.startsWith("ipc-renderer") && process_type === "renderer"
60
+ ? ["renderer"]
61
+ : []),
62
+ ]),
63
+ ...hookSnapshot.dropped_event_roles.map(({ role }) => role),
64
+ ]),
65
+ ].sort();
66
+ if (!observedRoles.includes("preload"))
67
+ unavailableEventFamilies.add("preload");
68
+ if (!observedRoles.includes("renderer"))
69
+ unavailableEventFamilies.add("renderer-ipc");
70
+ return {
71
+ status: hookSnapshot.hook_error ? "hook_conflict" : "partial_attach",
72
+ observed_event_families: observedEventFamilies,
73
+ unavailable_event_families: [...unavailableEventFamilies].sort(),
74
+ observed_roles: observedRoles,
75
+ pre_capture_activity: "unavailable",
76
+ };
77
+ };
78
+ /** Project one provider hook snapshot into the canonical public result. */
79
+ export const projectElectronActiveCapture = (paths, actions, state) => {
80
+ const { hookSnapshot } = state;
81
+ const ipcEvents = hookSnapshot.events.filter(({ kind }) => ipcEventKinds.has(kind));
82
+ return electronActiveObservationResultSchema.parse({
83
+ application: {
84
+ executable_path: paths.executable,
85
+ application_path: paths.application,
86
+ electron_version: state.electronVersion,
87
+ process_ownership: "provider-owned",
88
+ cleanup: "terminated-owned-process",
89
+ },
90
+ actions,
91
+ windows: state.windows,
92
+ processes: {
93
+ items: state.metrics,
94
+ },
95
+ ipc: {
96
+ events: ipcEvents,
97
+ observed: hookSnapshot.observed_ipc,
98
+ dropped: hookSnapshot.dropped_ipc,
99
+ },
100
+ timeline: {
101
+ events: hookSnapshot.events,
102
+ observed: hookSnapshot.observed,
103
+ dropped: hookSnapshot.dropped,
104
+ },
105
+ retention: {
106
+ budget_bytes: hookSnapshot.retention_budget_bytes,
107
+ estimated_retained_bytes: hookSnapshot.estimated_retained_bytes,
108
+ event_serialized_byte_upper_bound: hookSnapshot.event_serialized_byte_upper_bound,
109
+ retained: hookSnapshot.retained,
110
+ dropped: hookSnapshot.dropped,
111
+ dropped_event_families: hookSnapshot.dropped_event_families,
112
+ dropped_event_roles: hookSnapshot.dropped_event_roles,
113
+ observed_ipc: hookSnapshot.observed_ipc,
114
+ dropped_ipc: hookSnapshot.dropped_ipc,
115
+ observed_runtime: hookSnapshot.observed_runtime,
116
+ dropped_runtime: hookSnapshot.dropped_runtime,
117
+ },
118
+ coverage: createCoverage(hookSnapshot),
119
+ limitations: [
120
+ "IPC payloads are represented by value shapes; payload values are never retained.",
121
+ "IPC direction and sender/receiver identifiers are observed only where Electron exposes them at the hooked boundary.",
122
+ "The runtime timeline records lifecycle, navigation, shell, permission, popup, download, protocol, preload, native-addon, process, and IPC events; activity before hook installation is unavailable.",
123
+ "The preload and renderer process contexts are not instrumented by the main-process -r hook; preload configuration and contextBridge API-shape events are main-boundary observations, not proof of renderer-side execution.",
124
+ ...(!hookSnapshot.events.some(({ kind }) => kind === "preload")
125
+ ? [
126
+ "Preload configuration was not exposed by the observed Electron window metadata. Preload paths and execution remain unavailable.",
127
+ ]
128
+ : []),
129
+ "Process metrics are an Electron API snapshot and do not prove hostile-local-user isolation.",
130
+ ...(hookSnapshot.dropped > 0
131
+ ? [
132
+ `The active hook retained ${hookSnapshot.retained} of ${hookSnapshot.observed} observed events within a ${hookSnapshot.retention_budget_bytes}-byte retained-data budget; ${hookSnapshot.dropped} events were dropped (${hookSnapshot.dropped_ipc} IPC, ${hookSnapshot.dropped_runtime} runtime).`,
133
+ ]
134
+ : []),
135
+ "External shell opens, external navigation, permission grants, downloads, popup windows, updater relaunches, and OS integration are blocked and recorded by the active hook; other application filesystem and network behavior is not sandboxed by this provider.",
136
+ ...(hookSnapshot.hook_error
137
+ ? ["The active IPC hook could not be installed."]
138
+ : []),
139
+ ],
140
+ });
141
+ };