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
|
@@ -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
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
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
|
-
|
|
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 {
|
|
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
|
|
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
|
|
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 [
|
|
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:
|
|
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
|
+
};
|