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
@@ -3,7 +3,6 @@ import { dirname } from "node:path";
3
3
  import { randomUUID } from "node:crypto";
4
4
  import { fileURLToPath } from "node:url";
5
5
  import { _electron as electron } from "playwright-core";
6
- import { electronActiveObservationResultSchema, } from "../domain/javascript/electronActiveObservation.js";
7
6
  import { AnalysisError } from "../domain/analysisErrorBase.js";
8
7
  import { BrowserObservationError } from "../domain/browserObservationError.js";
9
8
  import { ProviderAdapterError } from "../domain/providerAdapterError.js";
@@ -12,81 +11,13 @@ import { cleanupOwnedProcessGroup, cleanupWindowsProcessTree, verifyNoTokenOwned
12
11
  import { observeOwnedProcessLineage, prepareProcessOwnershipInspection, systemProcessOwnershipHost, } from "../process/ProcessOwnershipObservation.js";
13
12
  import { selectCapturedProcessGroupIds } from "../process/ProcessOwnershipProcessTree.js";
14
13
  import { runElectronActions, readApplicationState, runWithExecutionLimits, } from "./PlaywrightElectronActiveActions.js";
14
+ import { projectElectronActiveCapture } from "./PlaywrightElectronActiveProjection.js";
15
15
  const OPERATION = "capture_electron_scenario";
16
16
  const STARTUP_TIMEOUT_MS = 60_000;
17
17
  /** Public identity for provider-owned Electron runtime experiments. */
18
18
  export { PLAYWRIGHT_ELECTRON_ACTIVE_PROVIDER_IDENTITY } from "./providerIdentities.js";
19
19
  import { PLAYWRIGHT_ELECTRON_ACTIVE_PROVIDER_IDENTITY } from "./providerIdentities.js";
20
20
  const hookPath = fileURLToPath(new URL("../../scripts/electron-active-hook.cjs", import.meta.url));
21
- const observableEventFamilies = [
22
- "app-lifecycle",
23
- "window-lifecycle",
24
- "web-contents-lifecycle",
25
- "navigation",
26
- "shell-attempt",
27
- "process-lifecycle",
28
- "permission",
29
- "popup-attempt",
30
- "download",
31
- "protocol",
32
- "preload",
33
- "preload-configuration",
34
- "renderer-ipc",
35
- "native-addon",
36
- "updater",
37
- "error",
38
- "ipc",
39
- ];
40
- const ipcEventKinds = new Set([
41
- "main-handler-invocation",
42
- "main-event-invocation",
43
- "utility-process-fork",
44
- "utility-process-message",
45
- "ipc-main-to-renderer",
46
- "ipc-utility-to-main",
47
- "ipc-renderer-send",
48
- "ipc-renderer-invoke",
49
- "ipc-renderer-post-message",
50
- ]);
51
- const createCoverage = (hookSnapshot) => {
52
- const observedEventFamilies = [
53
- ...new Set(hookSnapshot.events.map(({ kind, process_type }) => {
54
- if (kind === "preload" && process_type === "main")
55
- return "preload-configuration";
56
- if (kind.startsWith("ipc-renderer") && process_type !== "renderer")
57
- return "ipc";
58
- return ipcEventKinds.has(kind) ? "ipc" : kind;
59
- })),
60
- ].sort();
61
- const unavailableEventFamilies = new Set(observableEventFamilies.filter((family) => !observedEventFamilies.includes(family)));
62
- const observedRoles = [
63
- ...new Set(hookSnapshot.events.flatMap(({ process_type, kind }) => [
64
- ...(process_type === null ? [] : [process_type]),
65
- ...(kind === "window-lifecycle" ? ["window"] : []),
66
- ...(kind === "web-contents-lifecycle" || kind === "navigation"
67
- ? ["web_contents"]
68
- : []),
69
- ...(kind === "preload" && process_type === "preload"
70
- ? ["preload"]
71
- : []),
72
- ...(kind.startsWith("ipc-renderer") && process_type === "renderer"
73
- ? ["renderer"]
74
- : []),
75
- ])),
76
- ].sort();
77
- const rendererContextObserved = hookSnapshot.events.some(({ process_type }) => process_type === "renderer" || process_type === "preload");
78
- if (!rendererContextObserved) {
79
- unavailableEventFamilies.add("preload");
80
- unavailableEventFamilies.add("renderer-ipc");
81
- }
82
- return {
83
- status: hookSnapshot.hook_error ? "hook_conflict" : "partial_attach",
84
- observed_event_families: observedEventFamilies,
85
- unavailable_event_families: [...unavailableEventFamilies].sort(),
86
- observed_roles: observedRoles,
87
- pre_capture_activity: "unavailable",
88
- };
89
- };
90
21
  /** Launch an owned Electron application through the official Playwright API. */
91
22
  export class PlaywrightElectronActiveProvider {
92
23
  identity() {
@@ -96,6 +27,10 @@ export class PlaywrightElectronActiveProvider {
96
27
  let application;
97
28
  let ownership;
98
29
  let lineage;
30
+ let capture;
31
+ let paths;
32
+ let initialState;
33
+ let actions = [];
99
34
  let outcome;
100
35
  const runId = randomUUID();
101
36
  try {
@@ -103,7 +38,7 @@ export class PlaywrightElectronActiveProvider {
103
38
  throw new BrowserObservationError(OPERATION, "cancelled");
104
39
  await prepareProcessOwnershipInspection(options.signal);
105
40
  const startupDeadline = Date.now() + STARTUP_TIMEOUT_MS;
106
- const paths = await canonicalPaths(input);
41
+ paths = await canonicalPaths(input);
107
42
  const captureBaseline = await systemProcessOwnershipHost.captureBaseline?.(options.signal);
108
43
  if (options.signal?.aborted)
109
44
  throw new BrowserObservationError(OPERATION, "cancelled");
@@ -128,20 +63,53 @@ export class PlaywrightElectronActiveProvider {
128
63
  sweepTokenOwnedProcesses: true,
129
64
  ...(captureBaseline === undefined ? {} : { captureBaseline }),
130
65
  };
131
- const actions = await runElectronActions(application, input, options);
132
- const state = await runWithExecutionLimits(readApplicationState(application), options.signal);
133
- outcome = ok(createResult(paths, input, actions, state));
66
+ lineage = await observeOwnedProcessLineage(ownership);
67
+ initialState = await readApplicationState(application);
68
+ actions = await runElectronActions(application, input, options);
69
+ const state = await runWithExecutionLimits(readApplicationState(application), undefined, options.signal?.aborted ? Date.now() + 5_000 : undefined);
70
+ capture = projectElectronActiveCapture(paths, actions, state);
71
+ outcome = options.signal?.aborted
72
+ ? err(new BrowserObservationError(OPERATION, "cancelled", {
73
+ partialObservation: {
74
+ kind: "electron-active-observation",
75
+ capture,
76
+ },
77
+ }))
78
+ : ok(capture);
134
79
  }
135
80
  catch (cause) {
136
- outcome = err(options.signal?.aborted === true &&
137
- (cause === options.signal.reason ||
138
- (cause instanceof Error && cause.name === "AbortError"))
139
- ? new BrowserObservationError(OPERATION, "cancelled", { cause })
81
+ if (options.signal?.aborted &&
82
+ paths !== undefined &&
83
+ initialState !== undefined) {
84
+ const retainedCapture = projectElectronActiveCapture(paths, actions, initialState);
85
+ capture = {
86
+ ...retainedCapture,
87
+ limitations: [
88
+ ...retainedCapture.limitations,
89
+ `Final Electron state was unavailable after cancellation: ${cause instanceof Error ? cause.message : String(cause)}. Windows, metrics, IPC, and timeline are the snapshot collected before actions and may omit their effects.`,
90
+ ],
91
+ };
92
+ }
93
+ outcome = err(options.signal?.aborted === true
94
+ ? new BrowserObservationError(OPERATION, "cancelled", {
95
+ cause,
96
+ ...(capture === undefined
97
+ ? {}
98
+ : {
99
+ partialObservation: {
100
+ kind: "electron-active-observation",
101
+ capture,
102
+ },
103
+ }),
104
+ })
140
105
  : providerError(cause));
141
106
  }
142
107
  if (application !== undefined) {
143
- if (ownership !== undefined)
144
- lineage = await observeOwnedProcessLineage(ownership);
108
+ if (ownership !== undefined) {
109
+ const currentLineage = await observeOwnedProcessLineage(ownership);
110
+ if (currentLineage.status === "verified" || lineage === undefined)
111
+ lineage = currentLineage;
112
+ }
145
113
  let closeError;
146
114
  try {
147
115
  await runWithExecutionLimits(application.close(), undefined, Date.now() + 5_000);
@@ -156,11 +124,55 @@ export class PlaywrightElectronActiveProvider {
156
124
  }
157
125
  : await cleanupElectronProcesses(ownership, lineage);
158
126
  if (!cleanup.cleaned)
159
- return err(providerError(new BrowserObservationError(OPERATION, "cleanup_failed", {
160
- cause: new Error(cleanup.reason),
161
- })));
127
+ return err(new BrowserObservationError(OPERATION, "cleanup_failed", {
128
+ cause: outcome.ok ? new Error(cleanup.reason) : outcome.error,
129
+ detail: `Electron cleanup could not be verified: ${cleanup.reason}.${capture !== undefined ? " Collected observations are retained in partial_observation." : ""}${outcome.ok ? "" : ` Capture also failed: ${outcome.error.message}.`} Inspect the reported process resources before launching another capture.`,
130
+ cleanup: {
131
+ reason: cleanup.reason,
132
+ resources: ownership === undefined
133
+ ? ["owned_process_group"]
134
+ : [
135
+ "owned_process_group",
136
+ `run:${ownership.runId}`,
137
+ `process-group:${String(ownership.processGroupId)}`,
138
+ ],
139
+ },
140
+ ...(capture !== undefined
141
+ ? {
142
+ partialObservation: {
143
+ kind: "electron-active-observation",
144
+ capture: {
145
+ ...capture,
146
+ application: {
147
+ ...capture.application,
148
+ cleanup: "unverified",
149
+ },
150
+ },
151
+ },
152
+ }
153
+ : {}),
154
+ }));
162
155
  if (closeError !== undefined)
163
- return err(providerError(closeError));
156
+ return err(new BrowserObservationError(OPERATION, "cleanup_failed", {
157
+ cause: outcome.ok ? closeError : outcome.error,
158
+ detail: `Electron transport teardown failed after process cleanup: ${closeError instanceof Error ? closeError.message : String(closeError)}.${capture !== undefined ? " Collected observations are retained in partial_observation." : ""}${outcome.ok ? "" : ` Capture also failed: ${outcome.error.message}.`}`,
159
+ ...(capture !== undefined
160
+ ? {
161
+ partialObservation: {
162
+ kind: "electron-active-observation",
163
+ capture,
164
+ },
165
+ }
166
+ : {}),
167
+ }));
168
+ if (outcome.ok && cleanup.unverified !== undefined)
169
+ outcome = ok({
170
+ ...outcome.value,
171
+ limitations: [
172
+ ...outcome.value.limitations,
173
+ ...cleanup.unverified.map(({ pid, diagnostic }) => `Ownership of unrelated process ${String(pid)} could not be verified; it was left untouched: ${diagnostic}`),
174
+ ],
175
+ });
164
176
  }
165
177
  return outcome;
166
178
  }
@@ -196,6 +208,7 @@ const cleanupElectronProcesses = async (ownership, lineage) => {
196
208
  process_group_id: processGroupId,
197
209
  })));
198
210
  let signaled = false;
211
+ const unverified = [];
199
212
  for (const processGroupId of groupIds) {
200
213
  const cleanupOwnership = processGroupId === ownership.processGroupId
201
214
  ? { ...ownership, leaderPid: processGroupId, processGroupId }
@@ -208,49 +221,32 @@ const cleanupElectronProcesses = async (ownership, lineage) => {
208
221
  if (!result.cleaned)
209
222
  return result;
210
223
  signaled ||= result.signaled;
224
+ unverified.push(...(result.unverified ?? []));
211
225
  }
212
- const remaining = await verifyNoTokenOwnedProcesses(ownership.runId, undefined, ownership.captureBaseline);
226
+ const remaining = await verifyNoTokenOwnedProcesses(ownership.runId, undefined, ownership.captureBaseline, {
227
+ leaderPid: ownership.leaderPid,
228
+ processGroupId: ownership.processGroupId,
229
+ ...(ownership.sampledProcessGroupIds === undefined
230
+ ? {}
231
+ : { sampledProcessGroupIds: ownership.sampledProcessGroupIds }),
232
+ });
213
233
  if (!remaining.cleaned)
214
234
  return remaining;
215
- return { cleaned: true, signaled };
216
- };
217
- const createResult = (paths, input, actions, state) => {
218
- const { hookSnapshot } = state;
219
- const ipcEvents = hookSnapshot.events.filter(({ kind }) => ipcEventKinds.has(kind));
220
- return electronActiveObservationResultSchema.parse({
221
- application: {
222
- executable_path: paths.executable,
223
- application_path: paths.application,
224
- electron_version: state.electronVersion,
225
- process_ownership: "provider-owned",
226
- cleanup: "terminated-owned-process",
227
- },
228
- actions,
229
- windows: state.windows,
230
- processes: {
231
- items: state.metrics,
232
- },
233
- ipc: {
234
- events: ipcEvents,
235
- observed: hookSnapshot.observed_ipc,
236
- },
237
- timeline: {
238
- events: hookSnapshot.events,
239
- observed: hookSnapshot.observed,
240
- },
241
- coverage: createCoverage(hookSnapshot),
242
- limitations: [
243
- "IPC payloads are represented by value shapes; payload values are never retained.",
244
- "IPC direction and sender/receiver identifiers are observed only where Electron exposes them at the hooked boundary.",
245
- "The runtime timeline records lifecycle, navigation, shell, permission, popup, download, protocol, preload, native-addon, process, and IPC events; activity before hook installation is unavailable.",
246
- "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.",
247
- "Process metrics are an Electron API snapshot and do not prove hostile-local-user isolation.",
248
- "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.",
249
- ...(hookSnapshot.hook_error
250
- ? ["The active IPC hook could not be installed."]
251
- : []),
252
- ],
253
- });
235
+ unverified.push(...(remaining.unverified ?? []));
236
+ return {
237
+ cleaned: true,
238
+ signaled,
239
+ ...(unverified.length === 0
240
+ ? {}
241
+ : {
242
+ unverified: [
243
+ ...new Map(unverified.map((item) => [
244
+ `${String(item.pid)}:${item.diagnostic}`,
245
+ item,
246
+ ])).values(),
247
+ ],
248
+ }),
249
+ };
254
250
  };
255
251
  const canonicalPaths = async (input) => {
256
252
  const [executable, application] = await Promise.all([
@@ -281,4 +277,7 @@ const providerError = (cause) => cause instanceof AnalysisError
281
277
  ? cause
282
278
  : new ProviderAdapterError(PLAYWRIGHT_ELECTRON_ACTIVE_PROVIDER_IDENTITY.id, OPERATION, {
283
279
  cause,
280
+ diagnostics: {
281
+ message: cause instanceof Error ? cause.message : String(cause),
282
+ },
284
283
  });