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.
- package/README.md +23 -17
- package/bridge/android/ReaJadxBridge.java +14 -5
- package/bridge/ghidra/ReaGhidraBridge.java +173 -47
- package/bridge/hopper_bridge.py +310 -128
- package/bridge/mitmproxy/capture.py +0 -2
- package/bridge/native/rea_lldb_tracer.py +630 -94
- package/bridge/process/ProcessRunTokenReader.swift +39 -5
- package/bridge/pwntools/recorded_crash_impl.py +4 -0
- package/dist/android/JadxConfiguration.js +196 -33
- package/dist/android/JadxMcpTransport.js +4 -0
- package/dist/android/JadxProtocol.js +6 -0
- package/dist/android/JadxProvider.js +19 -2
- package/dist/android/JadxSession.js +23 -4
- package/dist/application/AnalysisContextQueries.js +8 -35
- package/dist/application/AnalysisDocument.js +32 -0
- package/dist/application/AppBundleExecutable.js +67 -21
- package/dist/application/CallPathTracing.js +19 -3
- package/dist/application/CapabilityInventory.js +6 -3
- package/dist/application/ClientConfigurationDocument.js +871 -6
- package/dist/application/ClientRegistrationIdentity.js +26 -5
- package/dist/application/ClientRegistrationStatus.js +29 -14
- package/dist/application/DirectAnalysis.js +27 -37
- package/dist/application/Doctor.js +4 -2
- package/dist/application/DoctorScope.js +25 -13
- package/dist/application/EnhancedLiteralTracing.js +22 -25
- package/dist/application/EnhancedTools.js +13 -11
- package/dist/application/EvidenceBundleFiles.js +23 -11
- package/dist/application/FunctionAnalysisEvidence.js +2 -3
- package/dist/application/InventoryProjectionEvidence.js +4 -3
- package/dist/application/InvestigationProviders.js +3 -2
- package/dist/application/JsonFiles.js +50 -28
- package/dist/application/ProcedureAddressResolution.js +11 -0
- package/dist/application/ReconstructionCoverageService.js +7 -4
- package/dist/application/ReconstructionObligationLedgerService.js +4 -3
- package/dist/application/Setup.js +13 -1
- package/dist/application/SetupClientConfiguration.js +10 -15
- package/dist/application/SetupHost.js +5 -2
- package/dist/application/SetupPlan.js +5 -3
- package/dist/application/SupportedClients.js +34 -1
- package/dist/application/Uninstall.js +4 -3
- package/dist/application/Update.js +18 -3
- package/dist/application/UpdateRuntime.js +46 -25
- package/dist/application/WebModuleTraceService.js +4 -2
- package/dist/application/WebNetworkCaptureService.js +4 -2
- package/dist/application/WebRuntimeService.js +5 -3
- package/dist/application/WebScriptExportService.js +2 -2
- package/dist/application/WebSourceLocationService.js +4 -2
- package/dist/application/WorkflowEvidence.js +82 -0
- package/dist/application/binary/AnalysisProviderEvaluation.js +21 -5
- package/dist/application/binary/AnalysisProviderRegistry.js +2 -0
- package/dist/application/binary/AnalysisSnapshotCache.js +3 -6
- package/dist/application/binary/BinarySession.js +95 -68
- package/dist/application/binary/BinarySessionOpen.js +3 -3
- package/dist/application/binary/BinarySessionRecords.js +25 -3
- package/dist/application/binary/BinarySessionStatus.js +17 -1
- package/dist/application/binary/CompositeProvider.js +13 -0
- package/dist/application/binary/LazyAnalysisProvider.js +3 -0
- package/dist/application/binaryDiagnostics/BinaryLayoutService.js +4 -2
- package/dist/application/binaryDiagnostics/RecordedCrashService.js +4 -2
- package/dist/application/evm/EvmInterfaceService.js +4 -2
- package/dist/application/investigation/EvidenceLedger.js +21 -7
- package/dist/application/investigation/InvestigationRecords.js +8 -0
- package/dist/application/javascript/JavaScriptAnalysisControl.js +34 -0
- package/dist/application/javascript/JavaScriptApplicationEvidence.js +24 -3
- package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
- package/dist/application/javascript/JavaScriptApplicationService.js +22 -15
- package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
- package/dist/application/javascript/JavaScriptArtifactAnalysis.js +5 -4
- package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +39 -7
- package/dist/application/javascript/JavaScriptArtifactPathResolution.js +6 -3
- package/dist/application/javascript/JavaScriptArtifactReconstruction.js +11 -3
- package/dist/application/javascript/JavaScriptModuleRelationships.js +37 -8
- package/dist/application/javascript/JavaScriptRecoveryService.js +4 -2
- package/dist/application/javascript/JavaScriptRuntimeObservationService.js +3 -1
- package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +3 -3
- package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +63 -61
- package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +23 -1
- package/dist/application/managed/ManagedApplicationGraphService.js +4 -3
- package/dist/application/managed/ManagedMemberComparisonService.js +7 -4
- package/dist/application/managed/ManagedNativeVerificationService.js +4 -3
- package/dist/application/managed/ManagedReconstructionService.js +4 -3
- package/dist/application/process/ProcessCli.js +14 -6
- package/dist/application/process/ProcessEvidence.js +4 -3
- package/dist/application/workflowInputError.js +18 -0
- package/dist/artifacts/ArtifactProvider.js +12 -2
- package/dist/artifacts/MachOSliceArtifactReader.js +98 -14
- package/dist/artifacts/NativeDmgArtifactReader.js +13 -6
- package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +22 -3
- package/dist/artifacts/apple/InterfaceBuilderAnalysis.js +176 -56
- package/dist/artifacts/apple/InterfaceBuilderDecodeBudget.js +195 -0
- package/dist/artifacts/apple/KeyedArchiveReader.js +36 -22
- package/dist/artifacts/apple/MachoLoadCommandReader.js +92 -31
- package/dist/artifacts/apple/NibArchive.js +81 -14
- package/dist/artifacts/apple/NibViewHierarchy.js +10 -3
- package/dist/artifacts/apple/PlistNumberLiterals.js +164 -0
- package/dist/artifacts/inventory/ArtifactGraphConstruction.js +13 -8
- package/dist/artifacts/inventory/scanCanonical.js +11 -14
- package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
- package/dist/browser/CdpCaptureCompleteness.js +2 -0
- package/dist/browser/CdpCaptureEventHandlers.js +76 -11
- package/dist/browser/CdpCaptureEventTypes.js +5 -1
- package/dist/browser/CdpCaptureEvents.js +25 -0
- package/dist/browser/CdpConnection.js +30 -11
- package/dist/browser/CdpOptionalCommand.js +2 -3
- package/dist/browser/CdpPageCapture.js +23 -1
- package/dist/browser/PlaywrightElectronActiveActions.js +32 -23
- package/dist/browser/PlaywrightElectronActiveProjection.js +141 -0
- package/dist/browser/PlaywrightElectronActiveProvider.js +123 -124
- package/dist/browser/WebSourceMapFetcher.js +426 -72
- package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
- package/dist/browser/history/CaptureFailures.js +37 -1
- package/dist/browser/history/CaptureRelease.js +5 -0
- package/dist/browser/history/HarCaptureAdapter.js +3 -3
- package/dist/browser/history/HarJson.js +3 -2
- package/dist/browser/history/HistoricalCaptureDecoder.js +4 -2
- package/dist/cli/analysisSelector.js +23 -0
- package/dist/cli/applicationCommands.js +2 -3
- package/dist/cli/coreBinaryCommands.js +70 -12
- package/dist/cli/electronCommands.js +7 -6
- package/dist/cli/javascriptApplicationAnalysis.js +7 -3
- package/dist/cli/jsonOutput.js +4 -99
- package/dist/cli/nativeCallCommands.js +2 -3
- package/dist/cli/webRuntimeCommands.js +8 -8
- package/dist/cli.js +2 -1
- package/dist/cliCommandNames.js +0 -1
- package/dist/cliJsonInput.js +9 -4
- package/dist/config/environment.js +4 -0
- package/dist/config/ghidraStartupTimeout.js +17 -0
- package/dist/config/mcpResponseBudget.js +22 -0
- package/dist/config/parseConfig.js +2 -1
- package/dist/contracts/enhancedInputs.js +5 -3
- package/dist/contracts/enhancedToolContracts.js +3 -3
- package/dist/contracts/hopperMemoryContracts.js +2 -5
- package/dist/contracts/javascript/electronToolContracts.js +1 -1
- package/dist/contracts/managed/managedToolContracts.js +2 -4
- package/dist/contracts/native/nativeToolContracts.js +4 -2
- package/dist/contracts/officialToolContracts.js +14 -15
- package/dist/contracts/promptContracts.js +3 -3
- package/dist/contracts/sessionLifecycleInputs.js +3 -7
- package/dist/contracts/sessionStatusContract.js +2 -4
- package/dist/contracts/sessionToolContracts.js +4 -6
- package/dist/contracts/sessionToolSchemas.js +2 -5
- package/dist/contracts/toolContractExamples.js +0 -1
- package/dist/contracts/toolContractHelpers.js +4 -1
- package/dist/contracts/toolEffects.js +0 -1
- package/dist/contracts/toolOutputSchemaGroups.js +28 -27
- package/dist/contracts/toolOutputSchemaPrimitives.js +18 -0
- package/dist/contracts/toolSchemaMetadata.js +69 -10
- package/dist/contracts/webNetworkCaptureToolContracts.js +1 -1
- package/dist/domain/analysisErrorBase.js +8 -3
- package/dist/domain/analysisErrorCore.js +3 -1
- package/dist/domain/analysisErrorPresentation.js +72 -17
- package/dist/domain/analysisErrorProjection.js +106 -27
- package/dist/domain/android/androidAnalysis.js +2 -4
- package/dist/domain/android/androidApplication.js +17 -9
- package/dist/domain/apple/appleApplication.js +41 -14
- package/dist/domain/apple/dyldEnvironment.js +73 -0
- package/dist/domain/apple/dylibResolution.js +120 -9
- package/dist/domain/apple/dylibResolutionFindings.js +9 -7
- package/dist/domain/apple/interfaceBuilderGraph.js +25 -13
- package/dist/domain/apple/interfaceBuilderKeyedArchive.js +13 -3
- package/dist/domain/apple/keyedArchive.js +9 -1
- package/dist/domain/apple/machoContainer.js +54 -0
- package/dist/domain/apple/plistNumbers.js +76 -0
- package/dist/domain/artifactIdentity.js +29 -0
- package/dist/domain/artifactInventoryEvidence.js +19 -24
- package/dist/domain/bridgeCandidateProjection.js +71 -0
- package/dist/domain/browserCompleteness.js +1 -0
- package/dist/domain/browserObservationError.js +24 -5
- package/dist/domain/browserScenarioValues.js +2 -6
- package/dist/domain/bundleComparison.js +3 -2
- package/dist/domain/canonicalJsonDigestSteps.js +133 -0
- package/dist/domain/canonicalOrdering.js +9 -5
- package/dist/domain/changedBehavior.js +6 -6
- package/dist/domain/comparisonSourceEvidence.js +40 -0
- package/dist/domain/configurationErrors.js +1 -1
- package/dist/domain/evidence.js +64 -9
- package/dist/domain/evidenceBundle.js +42 -1
- package/dist/domain/evidenceErrors.js +12 -1
- package/dist/domain/explicitSensitiveFailure.js +17 -1
- package/dist/domain/firmware/firmwareAnalysis.js +6 -7
- package/dist/domain/hopperErrors.js +23 -2
- package/dist/domain/hopperValues.js +51 -8
- package/dist/domain/immutableJson.js +114 -0
- package/dist/domain/inputIssueProjection.js +3 -0
- package/dist/domain/javascript/electronActiveObservation.js +30 -4
- package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
- package/dist/domain/javascript/javascriptApplicationAnalysis.js +71 -23
- package/dist/domain/javascript/javascriptApplicationGraph.js +13 -0
- package/dist/domain/javascript/javascriptAstValues.js +20 -0
- package/dist/domain/javascript/javascriptRecovery.js +3 -8
- package/dist/domain/javascript/javascriptSemanticAnalysis.js +97 -2
- package/dist/domain/javascript/javascriptSemanticCoverage.js +6 -5
- package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +9 -17
- package/dist/domain/javascript/javascriptSemanticDataEffects.js +22 -5
- package/dist/domain/javascript/javascriptSemanticGraph.js +13 -0
- package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +1 -0
- package/dist/domain/javascript/javascriptSemanticPrimitives.js +25 -17
- package/dist/domain/javascript/javascriptSemanticQuerySchemas.js +8 -4
- package/dist/domain/javascript/javascriptSemanticResourceLimits.js +77 -0
- package/dist/domain/javascript/javascriptSemanticValues.js +83 -11
- package/dist/domain/javascript/javascriptSourceParser.js +6 -2
- package/dist/domain/javascript/javascriptStaticAnalysis.js +22 -17
- package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +5 -3
- package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +14 -4
- package/dist/domain/javascript/javascriptStaticAnalysisFindings.js +66 -7
- package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +28 -16
- package/dist/domain/javascript/javascriptStaticAnalysisState.js +3 -2
- package/dist/domain/jsonSerialization.js +109 -0
- package/dist/domain/jsonValue.js +90 -6
- package/dist/domain/localPath.js +6 -0
- package/dist/domain/managed/managedApplicationGraph.js +10 -10
- package/dist/domain/managed/managedInspectionEvidence.js +16 -0
- package/dist/domain/managed/managedMemberComparisonMatch.js +5 -9
- package/dist/domain/managed/managedNativeVerification.js +3 -9
- package/dist/domain/native/fileOffsetPartialObservation.js +1 -0
- package/dist/domain/native/nativeCallObservation.js +33 -11
- package/dist/domain/native/nativeCallPartialObservation.js +33 -0
- package/dist/domain/process/processCapture.js +8 -4
- package/dist/domain/process/processComparison.js +38 -4
- package/dist/domain/process/processScenario.js +11 -10
- package/dist/domain/propertyListKeys.js +1 -1
- package/dist/domain/propertyListXmlText.js +19 -0
- package/dist/domain/providerAdapterError.js +1 -1
- package/dist/domain/providerOperationHealth.js +54 -0
- package/dist/domain/reconstructionVerification.js +6 -43
- package/dist/domain/reconstructionVerificationSchemas.js +2 -2
- package/dist/domain/staticRuntimeCorrelation.js +6 -43
- package/dist/domain/webBundleAnalysis.js +20 -8
- package/dist/domain/webBundleAnalyzerInspection.js +13 -8
- package/dist/domain/webBundleAnalyzerResult.js +41 -2
- package/dist/domain/webRuntime.js +19 -5
- package/dist/domain/webSourceLocation.js +1 -0
- package/dist/firmware/FirmwareFiles.js +1 -1
- package/dist/generatedPackageMetadata.js +1 -1
- package/dist/ghidra/GhidraAnalysisProfile.js +5 -0
- package/dist/ghidra/GhidraClient.js +47 -14
- package/dist/ghidra/GhidraDiagnostics.js +7 -7
- package/dist/ghidra/GhidraFunctionValues.js +10 -7
- package/dist/ghidra/GhidraInstallation.js +18 -21
- package/dist/ghidra/GhidraInventoryValues.js +14 -4
- package/dist/ghidra/GhidraJavaLaunch.js +62 -0
- package/dist/ghidra/GhidraLauncher.js +33 -16
- package/dist/ghidra/GhidraProviderCapabilities.js +14 -2
- package/dist/ghidra/GhidraProviderClient.js +23 -12
- package/dist/ghidra/GhidraSessionError.js +11 -7
- package/dist/ghidra/GhidraTargetSnapshot.js +47 -12
- package/dist/ghidra/GhidraTransport.js +20 -0
- package/dist/hopper/BridgeLauncher.js +31 -11
- package/dist/hopper/HopperAnalysisProfile.js +62 -4
- package/dist/hopper/HopperCleanup.js +15 -3
- package/dist/hopper/HopperClient.js +222 -14
- package/dist/hopper/HopperFileOffset.js +237 -0
- package/dist/hopper/HopperMachOImage.js +196 -0
- package/dist/hopper/HopperOperationStage.js +6 -0
- package/dist/hopper/HopperProvider.js +63 -9
- package/dist/hopper/HopperProviderCapabilities.js +19 -1
- package/dist/hopper/HopperRegexSearch.js +137 -0
- package/dist/hopper/HopperRegexWorker.js +27 -0
- package/dist/hopper/HopperRequestQueue.js +68 -19
- package/dist/hopper/HopperTargetLease.js +3 -2
- package/dist/inspector/JavaScriptRuntimeScope.js +9 -1
- package/dist/inspector/V8InspectorCaptureProjection.js +8 -3
- package/dist/inspector/V8InspectorProvider.js +47 -11
- package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
- package/dist/javascript/sourceMaps/SourceMapCommand.js +16 -0
- package/dist/javascript/sourceMaps/SourceMapFormat.js +79 -31
- package/dist/javascript/sourceMaps/TraceSourceMap.js +14 -28
- package/dist/mcpDoctor.js +62 -2
- package/dist/native/AppleDispatchCoverage.js +47 -6
- package/dist/native/AppleDispatchDecodeFacts.js +6 -0
- package/dist/native/AppleDispatchMetadata.js +6 -3
- package/dist/native/AppleMachoFixups.js +48 -24
- package/dist/native/AppleMachoSelection.js +32 -16
- package/dist/native/AppleObjcCategories.js +6 -2
- package/dist/native/AppleObjcDispatchFacets.js +5 -2
- package/dist/native/AppleObjcProperties.js +2 -1
- package/dist/native/AppleSwiftDispatchFacets.js +27 -21
- package/dist/native/AppleSwiftVtables.js +21 -15
- package/dist/native/CommandRunner.js +81 -84
- package/dist/native/LldbCallTracer.js +365 -102
- package/dist/native/LldbRetainedObservations.js +178 -0
- package/dist/native/NativeCallObservation.js +62 -3
- package/dist/native/NativeMacOSProvider.js +98 -17
- package/dist/native/SignatureTargetBinding.js +155 -0
- package/dist/native/parsers/lipo.js +71 -1
- package/dist/native/pwndbg/PwndbgCoreContext.js +25 -5
- package/dist/native/pwntools/RecordedCrashStructureBindings.js +2 -0
- package/dist/process/DarwinProcessRunTokenReader.js +8 -9
- package/dist/process/ExecFileOutput.js +20 -0
- package/dist/process/OwnedCommand.js +7 -2
- package/dist/process/ProcessOwnership.js +203 -53
- package/dist/process/ProcessOwnershipObservation.js +49 -4
- package/dist/process/ProviderProcess.js +38 -7
- package/dist/process/capture/ProcessCaptureError.js +2 -2
- package/dist/process/capture/ProcessCaptureLifecycle.js +100 -34
- package/dist/server/EvidenceMcpServer.js +146 -0
- package/dist/server/createServer.js +15 -8
- package/dist/server/registerAndroidTools.js +2 -4
- package/dist/server/registerApplicationTools/helpers.js +2 -4
- package/dist/server/registerArtifactComparisonTool.js +11 -7
- package/dist/server/registerBinaryDiagnosticsTools.js +2 -4
- package/dist/server/registerBrowserScenarioTool.js +2 -4
- package/dist/server/registerBrowserTools.js +2 -4
- package/dist/server/registerBundleComparisonTool.js +2 -3
- package/dist/server/registerCloseLifecycleTool.js +8 -18
- package/dist/server/registerElectronTools.js +2 -4
- package/dist/server/registerEnhancedTools.js +18 -59
- package/dist/server/registerEvidenceTools.js +2 -4
- package/dist/server/registerEvmTools.js +2 -4
- package/dist/server/registerFirmwareTools.js +2 -4
- package/dist/server/registerFunctionComparisonTool.js +10 -6
- package/dist/server/registerInvestigationTools.js +7 -7
- package/dist/server/registerJavaScriptRecoveryTool.js +2 -4
- package/dist/server/registerJavaScriptRuntimeObservationTools.js +2 -4
- package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +2 -4
- package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +2 -4
- package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +2 -4
- package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +2 -4
- package/dist/server/registerOfficialTools.js +2 -4
- package/dist/server/registerProcessComparisonTool.js +71 -45
- package/dist/server/registerRecordedCrashTools.js +2 -4
- package/dist/server/registerSessionRecordTools.js +5 -6
- package/dist/server/registerSessionStatusTool.js +17 -3
- package/dist/server/registerSessionTools.js +11 -3
- package/dist/server/registerWebModuleTool.js +2 -4
- package/dist/server/registerWebNetworkCaptureTool.js +2 -4
- package/dist/server/registerWebRuntimeTools.js +3 -7
- package/dist/server/registerWebScriptTool.js +2 -4
- package/dist/server/registerWebSourceLocationTool.js +2 -4
- package/dist/server/runDerivedOperation.js +15 -3
- package/dist/server/sessionAvailabilityPolicy.js +0 -1
- package/dist/server/toolRegistrationOptions.js +2 -2
- package/dist/server/toolResult.js +62 -10
- package/dist/server/toolResultEncoding.js +33 -0
- package/install.sh +1 -1
- package/native/windows/build/manifest.json +1 -1
- package/package.json +8 -3
- package/scripts/electron-active-hook-boundaries.cjs +18 -20
- package/scripts/electron-active-hook.cjs +241 -37
- package/skills/reverse-engineer-anything/SKILL.md +11 -3
- package/skills/reverse-engineer-anything/references/javascript-applications.md +8 -1
- 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
|
-
|
|
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
|
-
|
|
132
|
-
|
|
133
|
-
|
|
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
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
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
|
-
|
|
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(
|
|
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(
|
|
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
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
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
|
});
|