rea-agents 5.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 +168 -655
- 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 +208 -0
- package/bridge/native/rea_lldb_tracer.py +839 -0
- package/bridge/process/ProcessRunTokenReader.swift +297 -0
- package/bridge/process/ProcessRunTokenReaderMain.swift +35 -0
- package/bridge/pwndbg/core_context.py +101 -0
- package/bridge/pwndbg/launch.py +39 -0
- package/bridge/pwndbg/launch_impl.py +34 -0
- package/bridge/pwntools/decoder_runtime.py +59 -0
- package/bridge/pwntools/layout.py +39 -0
- package/bridge/pwntools/layout_impl.py +309 -0
- package/bridge/pwntools/recorded_crash.py +39 -0
- package/bridge/pwntools/recorded_crash_impl.py +147 -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 +20 -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 +27 -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 +97 -33
- 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 +24 -12
- 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/ReconstructionObligationCandidates.js +5 -1
- 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/WebNetworkCapturePort.js +1 -0
- package/dist/application/WebNetworkCaptureService.js +134 -0
- package/dist/application/WebRuntimeService.js +5 -3
- package/dist/application/WebScriptExportService.js +2 -2
- package/dist/application/WebSourceLocationService.js +4 -2
- package/dist/application/WindowsCapabilities.js +1 -1
- 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 +52 -12
- package/dist/application/binary/BinarySession.js +131 -76
- package/dist/application/binary/BinarySessionOpen.js +19 -6
- package/dist/application/binary/BinarySessionRecords.js +45 -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/BinaryLayoutPort.js +1 -0
- package/dist/application/binaryDiagnostics/BinaryLayoutService.js +59 -0
- package/dist/application/binaryDiagnostics/RecordedCrashPort.js +1 -0
- package/dist/application/binaryDiagnostics/RecordedCrashService.js +62 -0
- package/dist/application/evm/EvmInterfacePort.js +1 -0
- package/dist/application/evm/EvmInterfaceService.js +64 -0
- 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 +25 -5
- package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
- package/dist/application/javascript/JavaScriptApplicationService.js +34 -14
- package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
- package/dist/application/javascript/JavaScriptArtifactAnalysis.js +47 -27
- package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +39 -7
- package/dist/application/javascript/JavaScriptArtifactGraphDocuments.js +26 -2
- package/dist/application/javascript/JavaScriptArtifactPathResolution.js +80 -27
- package/dist/application/javascript/JavaScriptArtifactReconstruction.js +33 -12
- 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/JavaScriptSemanticGraphAsyncProjection.js +7 -7
- package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +149 -72
- package/dist/application/javascript/JavaScriptSemanticGraphChildProcessProjection.js +14 -15
- package/dist/application/javascript/JavaScriptSemanticGraphConstruction.js +41 -1
- package/dist/application/javascript/JavaScriptSemanticGraphDataProjection.js +7 -7
- package/dist/application/javascript/JavaScriptSemanticGraphFlowProjection.js +5 -9
- package/dist/application/javascript/JavaScriptSemanticGraphObjectProjection.js +3 -3
- package/dist/application/javascript/JavaScriptSemanticGraphProjection.js +118 -12
- package/dist/application/javascript/JavaScriptSemanticGraphResourceProjection.js +3 -3
- package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +27 -5
- 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/{ProcessCli.js → process/ProcessCli.js} +23 -15
- package/dist/application/{ProcessEvidence.js → process/ProcessEvidence.js} +8 -7
- package/dist/application/workflowInputError.js +18 -0
- package/dist/artifacts/ArtifactProvider.js +42 -5
- package/dist/artifacts/ArtifactProviderMetadata.js +2 -1
- package/dist/artifacts/MachOSliceArtifactReader.js +98 -14
- package/dist/artifacts/NativeDmgArtifactReader.js +13 -6
- package/dist/artifacts/ZipArtifactReader.js +3 -0
- package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +22 -3
- package/dist/artifacts/apple/DylibResolutionReader.js +259 -0
- 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 +355 -0
- 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/{application → artifacts/extraction}/ArtifactExtraction.js +10 -10
- package/dist/{application → artifacts/inventory}/ArtifactGraphConstruction.js +16 -11
- package/dist/{application → artifacts/inventory}/ArtifactInventory.js +4 -4
- package/dist/{application/ArtifactInventory → artifacts/inventory}/classify.js +2 -2
- package/dist/{application/ArtifactInventory → artifacts/inventory}/reader.js +5 -5
- package/dist/{application/ArtifactInventory → artifacts/inventory}/scanCanonical.js +14 -17
- package/dist/{application/ArtifactInventory → artifacts/inventory}/scanReader.js +5 -5
- package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
- package/dist/artifacts/readStableArtifact.js +20 -4
- package/dist/browser/CdpCaptureCompleteness.js +2 -0
- package/dist/browser/CdpCaptureEventHandlers.js +165 -12
- package/dist/browser/CdpCaptureEventTypes.js +5 -1
- package/dist/browser/CdpCaptureEvents.js +34 -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 +130 -122
- package/dist/browser/WebSourceMapFetcher.js +426 -72
- package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
- package/dist/browser/history/CaptureFailures.js +137 -0
- package/dist/browser/history/CaptureFormatError.js +10 -0
- package/dist/browser/history/CaptureRedaction.js +65 -0
- package/dist/browser/history/CaptureRelease.js +17 -0
- package/dist/browser/history/HarCapture.js +165 -0
- package/dist/browser/history/HarCaptureAdapter.js +20 -0
- package/dist/browser/history/HarCaptureProcess.js +57 -0
- package/dist/browser/history/HarJson.js +92 -0
- package/dist/browser/history/HarSchema.js +72 -0
- package/dist/browser/history/HistoricalCaptureDecoder.js +188 -0
- package/dist/browser/history/HistoricalCaptureFormatAdapter.js +1 -0
- package/dist/browser/history/MitmproxyCaptureAdapter.js +42 -0
- package/dist/cli/analysisSelector.js +23 -0
- package/dist/cli/applicationCommands.js +2 -3
- package/dist/cli/artifactCommands.js +26 -1
- package/dist/cli/binaryDiagnosticsCommands.js +39 -0
- package/dist/cli/coreAnalysisCommands.js +2 -2
- package/dist/cli/coreBinaryCommands.js +78 -20
- package/dist/cli/electronCommands.js +21 -13
- package/dist/cli/evmCommands.js +24 -0
- package/dist/cli/firmwareCommands.js +6 -3
- package/dist/cli/javascriptApplicationAnalysis.js +20 -3
- package/dist/cli/jsonOutput.js +38 -0
- package/dist/cli/nativeCallCommands.js +34 -0
- package/dist/cli/processCommands.js +1 -1
- package/dist/cli/streamedJsonOutput.js +56 -0
- package/dist/cli/utilityCommands.js +2 -0
- package/dist/cli/webNetworkCaptureCommands.js +40 -0
- package/dist/cli/webRuntimeCommands.js +8 -8
- package/dist/cli.js +11 -4
- package/dist/cliBrowserScenarioCommands.js +2 -2
- package/dist/cliCommandNames.js +6 -1
- package/dist/cliJsonInput.js +35 -1
- package/dist/cliOutput.js +21 -6
- package/dist/composition/binaryDiagnostics.js +8 -0
- package/dist/composition/evm.js +4 -0
- package/dist/composition/webNetworkCaptures.js +6 -0
- 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/artifactToolContracts.js +6 -0
- package/dist/contracts/browserCaptureToolInputSchema.js +43 -0
- package/dist/contracts/browserToolContracts.js +4 -3
- package/dist/contracts/enhancedInputs.js +5 -3
- package/dist/contracts/enhancedToolContracts.js +3 -3
- package/dist/contracts/errorSchemas.js +8 -1
- package/dist/contracts/evm/evmToolContracts.js +20 -0
- package/dist/contracts/hopperMemoryContracts.js +2 -5
- package/dist/contracts/investigationExamples.js +2 -2
- package/dist/contracts/javascript/electronToolContracts.js +1 -1
- package/dist/contracts/managed/managedToolContracts.js +8 -6
- package/dist/contracts/native/binaryDiagnosticsToolContracts.js +42 -0
- package/dist/contracts/native/nativeToolContracts.js +21 -3
- package/dist/contracts/officialToolContracts.js +26 -24
- package/dist/contracts/process/processCaptureExample.js +2 -0
- package/dist/contracts/promptContracts.js +3 -3
- package/dist/contracts/sessionLifecycleInputs.js +18 -5
- package/dist/contracts/sessionStatusContract.js +8 -2
- package/dist/contracts/sessionToolContracts.js +8 -3
- package/dist/contracts/sessionToolSchemas.js +8 -4
- package/dist/contracts/toolContractExamples.js +1 -2
- package/dist/contracts/toolContractHelpers.js +4 -1
- package/dist/contracts/toolContracts.js +6 -0
- package/dist/contracts/toolEffects.js +30 -1
- package/dist/contracts/toolOutputSchemaGroups.js +33 -28
- package/dist/contracts/toolOutputSchemaPrimitives.js +19 -1
- package/dist/contracts/toolSchemaMetadata.js +69 -10
- package/dist/contracts/webNetworkCaptureToolContracts.js +24 -0
- package/dist/domain/analysisErrorBase.js +22 -2
- package/dist/domain/analysisErrorCore.js +61 -5
- package/dist/domain/analysisErrorPresentation.js +95 -12
- package/dist/domain/analysisErrorProjection.js +148 -19
- package/dist/domain/analysisSnapshot.js +166 -2
- 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/dyldPaths.js +81 -0
- package/dist/domain/apple/dylibResolution.js +478 -0
- package/dist/domain/apple/dylibResolutionFindings.js +77 -0
- 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/artifactPathSyntax.js +1 -1
- package/dist/domain/bridgeCandidateProjection.js +71 -0
- package/dist/domain/browserCompleteness.js +1 -0
- package/dist/domain/browserObservation.js +1 -1
- package/dist/domain/browserObservationError.js +24 -5
- package/dist/domain/browserObservationSchemas.js +13 -0
- package/dist/domain/browserScenarioValues.js +5 -2
- package/dist/domain/bundleComparison.js +3 -2
- package/dist/domain/callPathSchemas.js +1 -1
- package/dist/domain/canonicalDigest.js +13 -1
- package/dist/domain/canonicalJsonDigestSteps.js +133 -0
- package/dist/domain/canonicalOrdering.js +9 -5
- package/dist/domain/changedBehavior.js +9 -9
- package/dist/domain/comparisonSourceEvidence.js +40 -0
- package/dist/domain/comparisonStatus.js +2 -30
- package/dist/domain/configurationErrors.js +1 -1
- package/dist/domain/conformanceTrustGate.js +0 -16
- package/dist/domain/evidence.js +78 -11
- package/dist/domain/evidenceBundle.js +42 -1
- package/dist/domain/evidenceErrors.js +12 -1
- package/dist/domain/evm/evmInterface.js +63 -0
- package/dist/domain/explicitSensitiveFailure.js +108 -0
- package/dist/domain/explicitSensitiveValues.js +10 -0
- package/dist/domain/firmware/firmwareAnalysis.js +10 -4
- 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 +37 -6
- package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
- package/dist/domain/javascript/htmlArtifactReferences.js +40 -0
- 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/javascriptExportShapeComparison.js +21 -5
- package/dist/domain/javascript/javascriptExportShapeVariants.js +0 -10
- 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 +34 -5
- 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 +91 -3
- package/dist/domain/localPath.js +8 -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/binaryLayout.js +357 -0
- package/dist/domain/native/fileOffsetPartialObservation.js +1 -0
- package/dist/domain/native/nativeCallObservation.js +186 -0
- package/dist/domain/native/nativeCallPartialObservation.js +33 -0
- package/dist/domain/native/objcSwiftMetadata.js +0 -39
- package/dist/domain/native/recordedCrash.js +266 -0
- package/dist/domain/native/recordedCrashNoteCoverage.js +73 -0
- package/dist/domain/{processCapture.js → process/processCapture.js} +143 -2
- package/dist/domain/{processCaptureExample.js → process/processCaptureExample.js} +5 -0
- package/dist/domain/process/processCaptureParsing.js +54 -0
- package/dist/domain/{processCaptureValidation.js → process/processCaptureValidation.js} +18 -2
- package/dist/domain/{processComparison.js → process/processComparison.js} +39 -5
- package/dist/domain/{processObservation.js → process/processObservation.js} +1 -1
- package/dist/domain/{processScenario.js → process/processScenario.js} +11 -10
- package/dist/domain/{processTraceSpecification.js → process/processTraceSpecification.js} +1 -1
- 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/providerSelectionError.js +4 -2
- package/dist/domain/reconstructionVerification.js +9 -46
- package/dist/domain/reconstructionVerificationSchemas.js +3 -3
- package/dist/domain/residualUnknown.js +3 -2
- package/dist/domain/staticRuntimeCorrelation.js +9 -46
- package/dist/domain/webBundleAnalysis.js +20 -8
- package/dist/domain/webBundleAnalyzerInspection.js +13 -8
- package/dist/domain/webBundleAnalyzerResult.js +41 -2
- package/dist/domain/webCaptureDiff.js +1 -0
- package/dist/domain/webNetworkCapture.js +118 -0
- package/dist/domain/webNetworkCaptureCoordinates.js +58 -0
- package/dist/domain/webRuntime.js +19 -5
- package/dist/domain/webSourceLocation.js +1 -0
- package/dist/dotnet/ManagedExceptionRegionValidation.js +41 -0
- package/dist/dotnet/ManagedMemberInspector.js +4 -2
- package/dist/dotnet/ManagedMemberInspectorCore.js +38 -32
- package/dist/dotnet/ManagedMemberInstructionDecoder.js +23 -7
- package/dist/dotnet/ManagedMemberRows.js +14 -3
- package/dist/dotnet/ManagedMetadataHeaps.js +20 -2
- package/dist/dotnet/ManagedMetadataInventory.js +38 -28
- package/dist/dotnet/ManagedMetadataInventoryRows.js +24 -10
- package/dist/dotnet/ManagedMethodBodyReader.js +7 -1
- package/dist/dotnet/ManagedNativeBoundaryHelpers.js +15 -3
- package/dist/dotnet/ManagedNativeBoundaryInspector.js +3 -1
- package/dist/dotnet/ManagedPeReader.js +11 -0
- package/dist/evm/EvmBytecodeCarrier.js +21 -0
- package/dist/evm/EvmWorkerLimits.js +40 -0
- package/dist/evm/EvmoleFailures.js +126 -0
- package/dist/evm/EvmoleInterfaceAdapter.js +53 -0
- package/dist/evm/EvmoleInterfaceProvider.js +273 -0
- package/dist/evm/EvmoleInterfaceWorker.js +87 -0
- package/dist/evm/EvmoleRelease.js +16 -0
- package/dist/firmware/FirmwareCommand.js +1 -0
- package/dist/firmware/FirmwareFiles.js +1 -1
- package/dist/generatedPackageMetadata.js +2 -2
- 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 +34 -16
- package/dist/ghidra/GhidraProvider.js +2 -2
- package/dist/ghidra/GhidraProviderCapabilities.js +15 -3
- 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 +33 -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/hopper/LinuxPrivateDisplayProbe.js +4 -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/recovery/WakaruCommand.js +3 -0
- package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
- package/dist/javascript/sourceMaps/SourceMapCommand.js +17 -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 +82 -84
- package/dist/native/LldbCallTracer.js +541 -0
- package/dist/native/LldbRetainedObservations.js +178 -0
- package/dist/native/NativeCallObservation.js +194 -0
- package/dist/native/NativeMacOSProvider.js +117 -20
- package/dist/native/NativeMacOSProviderMetadata.js +8 -3
- package/dist/native/SignatureTargetBinding.js +155 -0
- package/dist/native/parsers/lipo.js +71 -1
- package/dist/native/pwndbg/PwndbgCoreContext.js +180 -0
- package/dist/native/pwntools/PwntoolsDecoder.js +203 -0
- package/dist/native/pwntools/PwntoolsFailures.js +180 -0
- package/dist/native/pwntools/PwntoolsLayoutProvider.js +36 -0
- package/dist/native/pwntools/PwntoolsRecordedCrashProvider.js +75 -0
- package/dist/native/pwntools/PwntoolsRelease.js +19 -0
- package/dist/native/pwntools/PwntoolsResourceLimits.js +76 -0
- package/dist/native/pwntools/RecordedCrashSourceBindings.js +46 -0
- package/dist/native/pwntools/RecordedCrashStructureBindings.js +103 -0
- package/dist/process/DarwinProcessRunTokenReader.js +293 -0
- package/dist/process/ExecFileOutput.js +20 -0
- package/dist/process/OwnedCommand.js +118 -0
- package/dist/process/ProcessOwnership.js +431 -51
- package/dist/process/ProcessOwnershipObservation.js +209 -27
- package/dist/process/ProviderProcess.js +68 -10
- package/dist/{application → process/capture}/ProcessCaptureCapability.js +15 -0
- package/dist/{application → process/capture}/ProcessCaptureError.js +18 -2
- package/dist/process/capture/ProcessCaptureLifecycle.js +681 -0
- package/dist/{application → process/capture}/ProcessHarness.js +195 -29
- package/dist/{application → process/capture}/ProcessSampling.js +2 -2
- package/dist/server/EvidenceMcpServer.js +146 -0
- package/dist/server/createServer.js +37 -8
- package/dist/server/promptCompletion.js +10 -3
- 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 +15 -0
- 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 +3 -5
- package/dist/server/registerEvmTools.js +15 -0
- 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 +72 -46
- package/dist/server/registerRecordedCrashTools.js +15 -0
- package/dist/server/registerSessionRecordTools.js +5 -6
- package/dist/server/registerSessionStatusTool.js +17 -3
- package/dist/server/registerSessionTools.js +13 -5
- package/dist/server/registerWebModuleTool.js +2 -4
- package/dist/server/registerWebNetworkCaptureTool.js +26 -0
- 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 +3 -1
- package/dist/server/sessionToolPolicies.js +1 -1
- package/dist/server/toolRegistrationOptions.js +2 -2
- package/dist/server/toolResult.js +63 -11
- package/dist/server/toolResultEncoding.js +33 -0
- package/install.sh +1 -1
- package/native/windows/build/manifest.json +2 -2
- package/native/windows/build/rea-windows-x64.node +0 -0
- package/package.json +42 -9
- package/scripts/electron-active-hook-boundaries.cjs +18 -20
- package/scripts/electron-active-hook.cjs +241 -37
- package/scripts/rea.mjs +11 -3
- package/skills/reverse-engineer-anything/SKILL.md +32 -4
- package/skills/reverse-engineer-anything/references/javascript-applications.md +8 -1
- package/skills/reverse-engineer-anything/references/native-and-artifacts.md +29 -0
- package/third_party/README.md +60 -0
- package/third_party/evmole/LICENSE +21 -0
- package/third_party/evmole/README.md +22 -0
- package/third_party/pwndbg/LICENSE.md +21 -0
- package/third_party/pwndbg/README.md +23 -0
- package/third_party/pwntools/README.md +40 -0
- package/dist/application/AuthorizedArtifactInventory.js +0 -7
- package/dist/application/ProcessCaptureLifecycle.js +0 -299
- package/dist/application/StoreFileLock.js +0 -124
- package/dist/contracts/processCaptureExample.js +0 -2
- package/dist/domain/bytecodeProvider.js +0 -178
- package/dist/domain/customProtocolCapture.js +0 -137
- package/dist/domain/eventProcessTree.js +0 -225
- package/dist/domain/mobileApplicationInvestigation.js +0 -159
- package/dist/domain/packageAnalysis.js +0 -123
- package/dist/domain/peInspection.js +0 -197
- package/dist/domain/processCaptureParsing.js +0 -21
- package/dist/domain/protocolCapture.js +0 -217
- package/dist/domain/runtimeIdentification.js +0 -212
- package/dist/generatedMcpToolCatalog.js +0 -37
- package/dist/ghidra/GhidraDefaults.js +0 -2
- /package/dist/application/{ArtifactExtractionDestination.js → artifacts/ArtifactExtractionDestination.js} +0 -0
- /package/dist/{application/ArtifactInventory → artifacts/inventory}/policy.js +0 -0
- /package/dist/{application/ArtifactInventory → artifacts/inventory}/types.js +0 -0
- /package/dist/domain/{processEvidenceProvider.js → process/processEvidenceProvider.js} +0 -0
- /package/dist/domain/{processTraceComparison.js → process/processTraceComparison.js} +0 -0
- /package/dist/domain/{processTraceDimensionProjection.js → process/processTraceDimensionProjection.js} +0 -0
- /package/dist/domain/{processTraceEvaluation.js → process/processTraceEvaluation.js} +0 -0
- /package/dist/{application → process/capture}/FilesystemSnapshot.js +0 -0
- /package/dist/{application → process/capture}/ProcessCaptureEnvironment.js +0 -0
- /package/dist/{application → process/capture}/ProcessCaptureJournal.js +0 -0
- /package/dist/{application → process/capture}/ProcessFilesystemEffects.js +0 -0
- /package/dist/{application → process/capture}/ProcessNormalization.js +0 -0
- /package/dist/{application → process/capture}/ProcessScenarioRuntimeValidation.js +0 -0
- /package/dist/{application → process/capture}/ProcessTimer.js +0 -0
- /package/dist/{application → process/capture}/TerminalRenderer.js +0 -0
|
@@ -1,4 +1,34 @@
|
|
|
1
|
-
import { AnalysisError } from "./analysisErrorBase.js";
|
|
1
|
+
import { AnalysisError, } from "./analysisErrorBase.js";
|
|
2
|
+
/** A readable supplied artifact lies outside this operation's supported target formats. */
|
|
3
|
+
export class AnalysisUnsupportedTargetError extends AnalysisError {
|
|
4
|
+
operation;
|
|
5
|
+
path;
|
|
6
|
+
reason;
|
|
7
|
+
_tag = "AnalysisUnsupportedTargetError";
|
|
8
|
+
constructor(operation, path, reason, options) {
|
|
9
|
+
super(`Unsupported target for ${operation} at ${path}: ${reason}`, options);
|
|
10
|
+
this.operation = operation;
|
|
11
|
+
this.path = path;
|
|
12
|
+
this.reason = reason;
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
/** An analysis or transport resource failure, distinct from malformed input or unsupported coverage. */
|
|
16
|
+
export class AnalysisResourceConstraintError extends AnalysisError {
|
|
17
|
+
operation;
|
|
18
|
+
resource;
|
|
19
|
+
reason;
|
|
20
|
+
reportedLimits;
|
|
21
|
+
_tag = "AnalysisResourceConstraintError";
|
|
22
|
+
remediationAction;
|
|
23
|
+
constructor(operation, resource, reason, reportedLimits, options) {
|
|
24
|
+
super(`Resource constraint during ${operation}: ${reason}`, options);
|
|
25
|
+
this.operation = operation;
|
|
26
|
+
this.resource = resource;
|
|
27
|
+
this.reason = reason;
|
|
28
|
+
this.reportedLimits = reportedLimits;
|
|
29
|
+
this.remediationAction = options?.remediationAction;
|
|
30
|
+
}
|
|
31
|
+
}
|
|
2
32
|
/** Provider-neutral invalid analysis input or output at an application boundary. */
|
|
3
33
|
export class AnalysisProtocolError extends AnalysisError {
|
|
4
34
|
_tag = "AnalysisProtocolError";
|
|
@@ -44,8 +74,8 @@ export class AnalysisCapabilityUnavailableError extends AnalysisError {
|
|
|
44
74
|
export class AnalysisCancelledError extends AnalysisError {
|
|
45
75
|
operation;
|
|
46
76
|
_tag = "AnalysisCancelledError";
|
|
47
|
-
constructor(operation) {
|
|
48
|
-
super(`Analysis operation was cancelled: ${operation}
|
|
77
|
+
constructor(operation, options) {
|
|
78
|
+
super(`Analysis operation was cancelled: ${operation}`, options);
|
|
49
79
|
this.operation = operation;
|
|
50
80
|
}
|
|
51
81
|
}
|
|
@@ -54,9 +84,35 @@ export class AnalysisTimeoutError extends AnalysisError {
|
|
|
54
84
|
operation;
|
|
55
85
|
timeoutMs;
|
|
56
86
|
_tag = "AnalysisTimeoutError";
|
|
57
|
-
constructor(operation, timeoutMs) {
|
|
58
|
-
super(`Analysis operation timed out after ${String(timeoutMs)}ms: ${operation}
|
|
87
|
+
constructor(operation, timeoutMs, options) {
|
|
88
|
+
super(`Analysis operation timed out after ${String(timeoutMs)}ms: ${operation}`, options);
|
|
59
89
|
this.operation = operation;
|
|
60
90
|
this.timeoutMs = timeoutMs;
|
|
61
91
|
}
|
|
62
92
|
}
|
|
93
|
+
/** Host filesystem permissions denied the selected read; this is not malformed caller input. */
|
|
94
|
+
export class AnalysisAccessDeniedError extends AnalysisError {
|
|
95
|
+
operation;
|
|
96
|
+
path;
|
|
97
|
+
systemCode;
|
|
98
|
+
_tag = "AnalysisAccessDeniedError";
|
|
99
|
+
constructor(operation, path, systemCode, options) {
|
|
100
|
+
super(`Host filesystem read access denied (${systemCode}) for ${path} during ${operation}`, options);
|
|
101
|
+
this.operation = operation;
|
|
102
|
+
this.path = path;
|
|
103
|
+
this.systemCode = systemCode;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
/** Selected artifact acquisition observed a change, so no stable identity can be reported. */
|
|
107
|
+
export class AnalysisArtifactChangedError extends AnalysisError {
|
|
108
|
+
operation;
|
|
109
|
+
path;
|
|
110
|
+
reason;
|
|
111
|
+
_tag = "AnalysisArtifactChangedError";
|
|
112
|
+
constructor(operation, path, reason, options) {
|
|
113
|
+
super(`Selected artifact changed during acquisition: ${reason}`, options);
|
|
114
|
+
this.operation = operation;
|
|
115
|
+
this.path = path;
|
|
116
|
+
this.reason = reason;
|
|
117
|
+
}
|
|
118
|
+
}
|
|
@@ -1,31 +1,53 @@
|
|
|
1
|
-
import { AnalysisInputError } from "./analysisErrorCore.js";
|
|
1
|
+
import { AnalysisAccessDeniedError, AnalysisArtifactChangedError, AnalysisInputError, AnalysisUnsupportedTargetError, AnalysisResourceConstraintError, } from "./analysisErrorCore.js";
|
|
2
2
|
import { ArtifactOperationError } from "./artifactOperationError.js";
|
|
3
3
|
import { BinaryTargetError, ConfigurationError, NoBinaryOpenError, } from "./configurationErrors.js";
|
|
4
4
|
import { BrowserObservationError } from "./browserObservationError.js";
|
|
5
|
-
import { EvidenceFileError, EvidenceIntegrityError, EvidenceReferenceError, } from "./evidenceErrors.js";
|
|
5
|
+
import { EvidenceFileError, EvidenceIntegrityError, EvidenceReferenceError, AnalysisSnapshotMismatchError, } from "./evidenceErrors.js";
|
|
6
6
|
import { HopperRemoteError, HopperProcessError, HopperStartError, HopperTimeoutError, } from "./hopperErrors.js";
|
|
7
7
|
import { ProviderSelectionError } from "./providerSelectionError.js";
|
|
8
8
|
import { UnknownRegistryError } from "./unknownRegistryError.js";
|
|
9
|
+
import { providerRetryAction } from "./providerOperationHealth.js";
|
|
9
10
|
import {} from "./analysisErrorBase.js";
|
|
10
11
|
import {} from "./analysisErrorProjection.js";
|
|
11
12
|
export const analysisErrorRemediationAction = (error) => {
|
|
13
|
+
if (error instanceof AnalysisSnapshotMismatchError)
|
|
14
|
+
return "Run analysis without this snapshot, then save a fresh snapshot using the intended artifact, provider, and analysis profile.";
|
|
15
|
+
if (error instanceof AnalysisUnsupportedTargetError)
|
|
16
|
+
return "Select a target supported by this operation or choose an operation supporting the reported target format.";
|
|
17
|
+
if (error instanceof AnalysisResourceConstraintError)
|
|
18
|
+
return (error.remediationAction ??
|
|
19
|
+
(error.resource === "transport"
|
|
20
|
+
? "Export retained session evidence through export_evidence_bundle to a caller-selected path, or use complete CLI JSON output. Tools that accept retained-evidence references can inspect compatible records. The connection remains usable."
|
|
21
|
+
: error.resource === "cpu"
|
|
22
|
+
? "Review the reported worker CPU limits and observed signal. Retry with sufficient CPU time or a smaller artifact; REA retains tighter inherited limits."
|
|
23
|
+
: error.resource === "file-size"
|
|
24
|
+
? "Review the reported worker file-size limits and write failure. Retry with a sufficient file-size allowance for the evidence reply; REA retains tighter inherited limits."
|
|
25
|
+
: "Review the reported worker memory limits and available host memory. Retry with sufficient memory or a smaller artifact; REA retains tighter inherited limits."));
|
|
12
26
|
if (error instanceof HopperTimeoutError)
|
|
13
|
-
return error.
|
|
14
|
-
? "
|
|
15
|
-
:
|
|
27
|
+
return error.operation === undefined
|
|
28
|
+
? "Inspect Hopper for a loader or license dialog and review details.launcher. Correct the loader configuration or complete Hopper setup, then open the target again."
|
|
29
|
+
: error.providerState === "busy"
|
|
30
|
+
? "Check binary_session.analysis_activity, wait for the active Hopper request to finish, then retry."
|
|
31
|
+
: "Check binary_session for Hopper health, then retry the operation.";
|
|
16
32
|
if (error instanceof HopperProcessError)
|
|
17
|
-
return
|
|
33
|
+
return hopperProcessRemediation(error);
|
|
18
34
|
if (error instanceof HopperStartError)
|
|
19
35
|
return error.ownerRunId === undefined
|
|
20
36
|
? "Check the Hopper launcher and target details, then retry opening the target."
|
|
21
37
|
: `Use the active REA session ${error.ownerRunId} or close it before opening this target again.`;
|
|
22
38
|
if (error instanceof HopperRemoteError)
|
|
23
|
-
return
|
|
39
|
+
return error.diagnosticType === "invalid_request"
|
|
40
|
+
? "Correct the reported address, document, or arguments and retry."
|
|
41
|
+
: "Review the Hopper diagnostic details; correct the request or retry if the failure was transient.";
|
|
24
42
|
if (error instanceof EvidenceReferenceError)
|
|
25
43
|
return "Use an exact Evidence reference retained by this session, supply the complete inline Evidence, re-run its producer, or import its Evidence bundle. close_binary clears retained records.";
|
|
26
44
|
if (error instanceof BinaryTargetError &&
|
|
27
45
|
error.constraint === "directory_requires_file")
|
|
28
46
|
return "For a JavaScript/Electron application directory, call analyze_javascript_application with input_path or run `rea analyze <directory>`. For binary analysis, select its executable file.";
|
|
47
|
+
if (error instanceof AnalysisAccessDeniedError)
|
|
48
|
+
return "Check the current process's read access to the selected path. Retry with a readable local file.";
|
|
49
|
+
if (error instanceof AnalysisArtifactChangedError)
|
|
50
|
+
return "Wait until the selected file is stable. For an active binary session, reopen the target with open_binary before retrying so REA acquires its current identity; for a CLI command or target-free tool, rerun the operation.";
|
|
29
51
|
if (error instanceof AnalysisInputError)
|
|
30
52
|
return "Correct the listed arguments and retry.";
|
|
31
53
|
if (error instanceof UnknownRegistryError && error.reason === "not-found")
|
|
@@ -39,7 +61,10 @@ export const analysisErrorCategory = (error) => {
|
|
|
39
61
|
if (error._tag === "ProcessCaptureError")
|
|
40
62
|
return error.userCategory ?? "execution_failure";
|
|
41
63
|
if (error instanceof BrowserObservationError)
|
|
42
|
-
return browserErrorCategory(error.reason);
|
|
64
|
+
return error.userCategory ?? browserErrorCategory(error.reason);
|
|
65
|
+
if (error instanceof HopperRemoteError &&
|
|
66
|
+
error.diagnosticType === "invalid_request")
|
|
67
|
+
return "invalid_input";
|
|
43
68
|
if (error instanceof HopperRemoteError &&
|
|
44
69
|
error.diagnosticType === "authorization")
|
|
45
70
|
return "unavailable";
|
|
@@ -50,6 +75,10 @@ export const analysisErrorCategory = (error) => {
|
|
|
50
75
|
return STATIC_ERROR_CATEGORIES[error._tag] ?? "execution_failure";
|
|
51
76
|
};
|
|
52
77
|
const browserErrorCategory = (reason) => {
|
|
78
|
+
if (reason === "cancelled")
|
|
79
|
+
return "cancelled";
|
|
80
|
+
if (reason === "timeout")
|
|
81
|
+
return "timeout";
|
|
53
82
|
if (reason === "payload_limit")
|
|
54
83
|
return "truncated";
|
|
55
84
|
if (reason === "target_not_found" ||
|
|
@@ -73,17 +102,31 @@ const artifactErrorCategory = (reason) => {
|
|
|
73
102
|
};
|
|
74
103
|
const STATIC_ERROR_CATEGORIES = {
|
|
75
104
|
AnalysisInputError: "invalid_input",
|
|
105
|
+
AnalysisAccessDeniedError: "unavailable",
|
|
106
|
+
AnalysisArtifactChangedError: "integrity_mismatch",
|
|
76
107
|
AnalysisCapabilityUnavailableError: "unsupported_provider",
|
|
108
|
+
AnalysisUnsupportedTargetError: "unsupported_target",
|
|
77
109
|
ProviderSelectionError: "unsupported_provider",
|
|
78
110
|
EvidenceIntegrityError: "integrity_mismatch",
|
|
79
111
|
AnalysisCancelledError: "cancelled",
|
|
80
112
|
HopperCancelledError: "cancelled",
|
|
81
113
|
AnalysisTimeoutError: "timeout",
|
|
114
|
+
AnalysisResourceConstraintError: "resource_constraint",
|
|
82
115
|
HopperTimeoutError: "timeout",
|
|
83
116
|
NoBinaryOpenError: "unavailable",
|
|
84
117
|
BinaryTargetError: "unavailable",
|
|
85
118
|
};
|
|
86
119
|
export const analysisErrorUserMessage = (error) => {
|
|
120
|
+
if (error instanceof AnalysisSnapshotMismatchError)
|
|
121
|
+
return error.message;
|
|
122
|
+
if (error instanceof AnalysisUnsupportedTargetError)
|
|
123
|
+
return error.message;
|
|
124
|
+
if (error instanceof AnalysisResourceConstraintError)
|
|
125
|
+
return error.reason;
|
|
126
|
+
if (error instanceof AnalysisAccessDeniedError)
|
|
127
|
+
return "Host filesystem permissions denied read access to the selected path.";
|
|
128
|
+
if (error instanceof AnalysisArtifactChangedError)
|
|
129
|
+
return "The selected artifact changed during acquisition; no stable snapshot was decoded.";
|
|
87
130
|
if (error instanceof AnalysisInputError)
|
|
88
131
|
return "Analysis input is invalid. Check the arguments and try again.";
|
|
89
132
|
const hopperMessage = hopperErrorUserMessage(error);
|
|
@@ -103,7 +146,7 @@ export const analysisErrorUserMessage = (error) => {
|
|
|
103
146
|
if (error instanceof EvidenceIntegrityError)
|
|
104
147
|
return "Evidence is invalid or has changed. Recreate or re-import it, then try again.";
|
|
105
148
|
if (error instanceof EvidenceFileError)
|
|
106
|
-
return evidenceFileMessage(error
|
|
149
|
+
return evidenceFileMessage(error);
|
|
107
150
|
if (error instanceof UnknownRegistryError && error.reason === "not-found")
|
|
108
151
|
return "The requested residual unknown does not exist in this session. Check the unknown_id and try again.";
|
|
109
152
|
if (error instanceof UnknownRegistryError)
|
|
@@ -123,13 +166,15 @@ export const analysisErrorUserMessage = (error) => {
|
|
|
123
166
|
};
|
|
124
167
|
const hopperErrorUserMessage = (error) => {
|
|
125
168
|
if (error instanceof HopperTimeoutError) {
|
|
126
|
-
|
|
169
|
+
if (error.operation === undefined)
|
|
170
|
+
return "REA timed out waiting for Hopper bridge readiness. Hopper may be waiting for a loader or license dialog; inspect its window and the captured launcher outcome before retrying.";
|
|
171
|
+
const request = error.operation;
|
|
127
172
|
return error.providerState === "busy"
|
|
128
173
|
? `Hopper timed out during ${request} while the provider remained busy. Check binary_session.analysis_activity, wait for the active request to finish, then retry.`
|
|
129
174
|
: `Hopper timed out during ${request} before it started. Check binary_session for provider health, then retry.`;
|
|
130
175
|
}
|
|
131
176
|
if (error instanceof HopperProcessError)
|
|
132
|
-
return
|
|
177
|
+
return hopperProcessMessage(error);
|
|
133
178
|
if (error instanceof HopperStartError)
|
|
134
179
|
return (error.userMessage ??
|
|
135
180
|
"Hopper could not start. Check the launcher and target details, then retry opening the target.");
|
|
@@ -137,6 +182,36 @@ const hopperErrorUserMessage = (error) => {
|
|
|
137
182
|
return `Hopper ${error.operation ?? "analysis"} failed (${String(error.code)}, ${error.diagnosticType}): ${error.safeMessage}`;
|
|
138
183
|
return undefined;
|
|
139
184
|
};
|
|
185
|
+
const RESTART_OWNED_PROVIDER = "Restart the owned provider by calling close_binary, then open the target again and retry.";
|
|
186
|
+
const hopperProcessRemediation = (error) => {
|
|
187
|
+
if (error.failureCode !== undefined && error.userMessage !== undefined)
|
|
188
|
+
return error.userMessage;
|
|
189
|
+
if (error.stage === "launch")
|
|
190
|
+
return "Review the captured launcher diagnostics and Hopper setup, then retry opening the target.";
|
|
191
|
+
if (providerRetryAction(error.providerState) === "restart_provider")
|
|
192
|
+
return RESTART_OWNED_PROVIDER;
|
|
193
|
+
return "Read binary_session.provider_operation_health for this request before retrying or restarting the owned provider.";
|
|
194
|
+
};
|
|
195
|
+
const hopperProcessMessage = (error) => {
|
|
196
|
+
const stage = error.stage;
|
|
197
|
+
const where = error.operation ?? stage;
|
|
198
|
+
const request = error.requestId === undefined
|
|
199
|
+
? ""
|
|
200
|
+
: ` Request id ${String(error.requestId)}.`;
|
|
201
|
+
const startup = error.userMessage === undefined ? "" : ` ${error.userMessage}`;
|
|
202
|
+
if (error.providerState === "exited") {
|
|
203
|
+
const exit = error.exitCode === null
|
|
204
|
+
? "no exit code was observed"
|
|
205
|
+
: `exit code ${String(error.exitCode)}`;
|
|
206
|
+
const recovery = error.failureCode === undefined && stage !== "launch"
|
|
207
|
+
? ` ${RESTART_OWNED_PROVIDER}`
|
|
208
|
+
: "";
|
|
209
|
+
return `Hopper exited during ${where} (${exit}).${startup}${recovery}${request}`;
|
|
210
|
+
}
|
|
211
|
+
if (error.providerState === "unreachable")
|
|
212
|
+
return `Hopper became unreachable during ${where}; its process exit was not observed. ${RESTART_OWNED_PROVIDER}${startup}${request}`;
|
|
213
|
+
return `Hopper failed during ${where} and REA could not determine whether the provider is busy, exited, or unreachable.${startup} Read binary_session.provider_operation_health for this request before retrying or restarting.${request}`;
|
|
214
|
+
};
|
|
140
215
|
const standardErrorMessage = (tag) => {
|
|
141
216
|
if (UNREADABLE_OUTPUT_TAGS.has(tag))
|
|
142
217
|
return "Analysis returned an unreadable result. Retry once; if it continues, run `rea doctor`.";
|
|
@@ -190,7 +265,11 @@ const artifactMessage = (reason) => {
|
|
|
190
265
|
return "Artifact is invalid or has changed. Get a fresh copy and try again.";
|
|
191
266
|
return "Artifact could not be read or written. Check file access and try again.";
|
|
192
267
|
};
|
|
193
|
-
const evidenceFileMessage = (reason) => {
|
|
268
|
+
const evidenceFileMessage = ({ operation, reason, }) => {
|
|
269
|
+
if (reason === "missing")
|
|
270
|
+
return operation === "read"
|
|
271
|
+
? "Evidence file does not exist at the selected path. Check the path and try again."
|
|
272
|
+
: "Evidence output directory does not exist. Choose an existing directory and try again.";
|
|
194
273
|
if (reason === "not-file")
|
|
195
274
|
return "Evidence path does not point to a regular file. Choose a file and try again.";
|
|
196
275
|
if (reason === "exists")
|
|
@@ -202,10 +281,14 @@ const evidenceFileMessage = (reason) => {
|
|
|
202
281
|
const KNOWN_ERROR_TAGS = {
|
|
203
282
|
AnalysisProtocolError: true,
|
|
204
283
|
AnalysisInputError: true,
|
|
284
|
+
AnalysisAccessDeniedError: true,
|
|
285
|
+
AnalysisArtifactChangedError: true,
|
|
205
286
|
AnalysisOutputError: true,
|
|
206
287
|
AnalysisCapabilityUnavailableError: true,
|
|
288
|
+
AnalysisUnsupportedTargetError: true,
|
|
207
289
|
AnalysisCancelledError: true,
|
|
208
290
|
AnalysisTimeoutError: true,
|
|
291
|
+
AnalysisResourceConstraintError: true,
|
|
209
292
|
ProviderSelectionError: true,
|
|
210
293
|
ProviderAdapterError: true,
|
|
211
294
|
BrowserObservationError: true,
|
|
@@ -1,19 +1,43 @@
|
|
|
1
|
+
import { jsonValueSchema } from "./jsonValue.js";
|
|
1
2
|
import { analysisErrorCategory, analysisErrorRemediationAction, analysisErrorUserMessage, assertKnownAnalysisErrorTag, } from "./analysisErrorPresentation.js";
|
|
2
|
-
import { AnalysisCancelledError, AnalysisCapabilityUnavailableError, AnalysisInputError, AnalysisOutputError, AnalysisTimeoutError, } from "./analysisErrorCore.js";
|
|
3
|
+
import { AnalysisAccessDeniedError, AnalysisArtifactChangedError, AnalysisCancelledError, AnalysisCapabilityUnavailableError, AnalysisUnsupportedTargetError, AnalysisInputError, AnalysisOutputError, AnalysisTimeoutError, AnalysisResourceConstraintError, } from "./analysisErrorCore.js";
|
|
3
4
|
import { ArtifactOperationError } from "./artifactOperationError.js";
|
|
4
5
|
import { BinaryTargetError } from "./configurationErrors.js";
|
|
5
6
|
import { BrowserObservationError } from "./browserObservationError.js";
|
|
6
|
-
import { EvidenceFileError, EvidenceReferenceError } from "./evidenceErrors.js";
|
|
7
|
-
import { HopperCancelledError, HopperProcessError, HopperRemoteError, HopperTimeoutError, } from "./hopperErrors.js";
|
|
7
|
+
import { EvidenceFileError, EvidenceIntegrityError, EvidenceReferenceError, } from "./evidenceErrors.js";
|
|
8
|
+
import { HopperCancelledError, HopperProcessError, HopperRemoteError, HopperStartError, HopperTimeoutError, } from "./hopperErrors.js";
|
|
8
9
|
import { ProviderAdapterError } from "./providerAdapterError.js";
|
|
9
10
|
import { ProviderSelectionError } from "./providerSelectionError.js";
|
|
10
11
|
import { UnknownRegistryError } from "./unknownRegistryError.js";
|
|
12
|
+
import { providerRetryAction } from "./providerOperationHealth.js";
|
|
11
13
|
import {} from "./analysisErrorBase.js";
|
|
12
14
|
/** Project expected failures into exhaustive, secret-safe caller fields. */
|
|
13
15
|
export const projectAnalysisError = (error) => {
|
|
14
16
|
assertKnownAnalysisErrorTag(error._tag);
|
|
15
|
-
const
|
|
16
|
-
const
|
|
17
|
+
const underlyingCode = underlyingErrorCode(error);
|
|
18
|
+
const code = error.cleanupIncomplete ? "cleanup_incomplete" : underlyingCode;
|
|
19
|
+
const primaryDetails = errorDetails(error);
|
|
20
|
+
const details = {
|
|
21
|
+
...primaryDetails,
|
|
22
|
+
...(error.cleanupIncomplete
|
|
23
|
+
? {
|
|
24
|
+
cleanup: "incomplete",
|
|
25
|
+
resources: [...error.cleanupResources],
|
|
26
|
+
...(error.cleanup === undefined
|
|
27
|
+
? {}
|
|
28
|
+
: { cleanup_reason: error.cleanup.reason }),
|
|
29
|
+
execution_failure: primaryDetails?.execution_failure ?? underlyingCode,
|
|
30
|
+
}
|
|
31
|
+
: {}),
|
|
32
|
+
...(error.capturedOutput === undefined
|
|
33
|
+
? {}
|
|
34
|
+
: { captured_output: { ...error.capturedOutput } }),
|
|
35
|
+
...(error.partialObservation === undefined
|
|
36
|
+
? {}
|
|
37
|
+
: {
|
|
38
|
+
partial_observation: jsonValueSchema.parse(error.partialObservation),
|
|
39
|
+
}),
|
|
40
|
+
};
|
|
17
41
|
return {
|
|
18
42
|
code,
|
|
19
43
|
category: analysisErrorCategory(error),
|
|
@@ -22,18 +46,21 @@ export const projectAnalysisError = (error) => {
|
|
|
22
46
|
remediation: {
|
|
23
47
|
action: analysisErrorRemediationAction(error),
|
|
24
48
|
},
|
|
25
|
-
...(details ===
|
|
49
|
+
...(Object.keys(details).length === 0 ? {} : { details }),
|
|
26
50
|
};
|
|
27
51
|
};
|
|
28
|
-
const
|
|
29
|
-
if (error
|
|
30
|
-
|
|
52
|
+
const underlyingErrorCode = (error) => {
|
|
53
|
+
if (error instanceof HopperRemoteError &&
|
|
54
|
+
error.diagnosticType === "invalid_request")
|
|
55
|
+
return "invalid_request";
|
|
31
56
|
if (error instanceof ProviderSelectionError)
|
|
32
57
|
return error.reason === "provider_unavailable"
|
|
33
58
|
? "provider_unavailable"
|
|
34
59
|
: "capability_unavailable";
|
|
35
60
|
if (error instanceof BrowserObservationError)
|
|
36
|
-
return
|
|
61
|
+
return error.userCategory === "cancelled"
|
|
62
|
+
? "cancelled"
|
|
63
|
+
: browserErrorCode(error.reason);
|
|
37
64
|
if (error instanceof ArtifactOperationError)
|
|
38
65
|
return artifactOperationCode(error);
|
|
39
66
|
if (error instanceof EvidenceFileError)
|
|
@@ -45,6 +72,10 @@ const errorCode = (error) => {
|
|
|
45
72
|
return staticErrorCode(error._tag);
|
|
46
73
|
};
|
|
47
74
|
const browserErrorCode = (reason) => {
|
|
75
|
+
if (reason === "cancelled")
|
|
76
|
+
return "cancelled";
|
|
77
|
+
if (reason === "timeout")
|
|
78
|
+
return "provider_timeout";
|
|
48
79
|
if (reason === "payload_limit")
|
|
49
80
|
return "truncated";
|
|
50
81
|
if (reason === "target_not_found" ||
|
|
@@ -88,10 +119,14 @@ const STATIC_ERROR_CODES = {
|
|
|
88
119
|
AnalysisOutputError: "unreadable_output",
|
|
89
120
|
HopperProtocolError: "unreadable_output",
|
|
90
121
|
AnalysisInputError: "invalid_request",
|
|
122
|
+
AnalysisAccessDeniedError: "access_denied",
|
|
123
|
+
AnalysisArtifactChangedError: "artifact_changed",
|
|
91
124
|
AnalysisCapabilityUnavailableError: "capability_unavailable",
|
|
125
|
+
AnalysisUnsupportedTargetError: "unsupported_target",
|
|
92
126
|
AnalysisCancelledError: "cancelled",
|
|
93
127
|
HopperCancelledError: "cancelled",
|
|
94
128
|
AnalysisTimeoutError: "provider_timeout",
|
|
129
|
+
AnalysisResourceConstraintError: "resource_constraint",
|
|
95
130
|
HopperTimeoutError: "provider_timeout",
|
|
96
131
|
HopperProcessError: "provider_unavailable",
|
|
97
132
|
HopperStartError: "provider_unavailable",
|
|
@@ -120,6 +155,33 @@ const errorDetails = (error) => requestErrorDetails(error) ??
|
|
|
120
155
|
providerErrorDetails(error) ??
|
|
121
156
|
lifecycleErrorDetails(error);
|
|
122
157
|
const requestErrorDetails = (error) => {
|
|
158
|
+
if (error instanceof AnalysisUnsupportedTargetError)
|
|
159
|
+
return {
|
|
160
|
+
operation: error.operation,
|
|
161
|
+
path: error.path,
|
|
162
|
+
reason: error.reason,
|
|
163
|
+
};
|
|
164
|
+
if (error instanceof AnalysisResourceConstraintError)
|
|
165
|
+
return {
|
|
166
|
+
operation: error.operation,
|
|
167
|
+
resource: error.resource,
|
|
168
|
+
reason: error.reason,
|
|
169
|
+
reported_limits: error.reportedLimits,
|
|
170
|
+
};
|
|
171
|
+
if (error instanceof AnalysisArtifactChangedError)
|
|
172
|
+
return {
|
|
173
|
+
operation: error.operation,
|
|
174
|
+
path: error.path,
|
|
175
|
+
reason: error.reason,
|
|
176
|
+
boundary: "stable-artifact-read",
|
|
177
|
+
};
|
|
178
|
+
if (error instanceof AnalysisAccessDeniedError)
|
|
179
|
+
return {
|
|
180
|
+
operation: error.operation,
|
|
181
|
+
path: error.path,
|
|
182
|
+
system_code: error.systemCode,
|
|
183
|
+
boundary: "filesystem-read",
|
|
184
|
+
};
|
|
123
185
|
if (error instanceof AnalysisOutputError)
|
|
124
186
|
return { operation: error.operation, reason: error.reason };
|
|
125
187
|
if (error instanceof AnalysisInputError && error.issues.length > 0)
|
|
@@ -141,6 +203,8 @@ const requestErrorDetails = (error) => {
|
|
|
141
203
|
expected: error.expected,
|
|
142
204
|
actual: error.actual,
|
|
143
205
|
};
|
|
206
|
+
if (error instanceof EvidenceIntegrityError)
|
|
207
|
+
return { reason: error.message };
|
|
144
208
|
return undefined;
|
|
145
209
|
};
|
|
146
210
|
const artifactStateErrorDetails = (error) => {
|
|
@@ -161,7 +225,11 @@ const artifactStateErrorDetails = (error) => {
|
|
|
161
225
|
if (error instanceof UnknownRegistryError)
|
|
162
226
|
return { reason: error.reason };
|
|
163
227
|
if (error instanceof EvidenceFileError)
|
|
164
|
-
return {
|
|
228
|
+
return {
|
|
229
|
+
operation: error.operation,
|
|
230
|
+
reason: error.reason,
|
|
231
|
+
...(error.path === undefined ? {} : { path: error.path }),
|
|
232
|
+
};
|
|
165
233
|
return undefined;
|
|
166
234
|
};
|
|
167
235
|
const providerErrorDetails = (error) => {
|
|
@@ -222,10 +290,13 @@ const providerErrorDetails = (error) => {
|
|
|
222
290
|
...(error.operation === undefined ? {} : { operation: error.operation }),
|
|
223
291
|
...(error.requestId === undefined ? {} : { request_id: error.requestId }),
|
|
224
292
|
};
|
|
225
|
-
if (error instanceof HopperProcessError)
|
|
293
|
+
if (error instanceof HopperProcessError) {
|
|
294
|
+
const stage = error.stage;
|
|
226
295
|
return {
|
|
227
296
|
exit_code: error.exitCode,
|
|
228
|
-
stage
|
|
297
|
+
stage,
|
|
298
|
+
provider_state: error.providerState,
|
|
299
|
+
retry_action: providerRetryAction(error.providerState, error.failureCode !== undefined || error.stage === "launch"),
|
|
229
300
|
...(error.failureCode === undefined
|
|
230
301
|
? {}
|
|
231
302
|
: { failure_code: error.failureCode }),
|
|
@@ -234,6 +305,22 @@ const providerErrorDetails = (error) => {
|
|
|
234
305
|
...(error.diagnostic === undefined
|
|
235
306
|
? {}
|
|
236
307
|
: { diagnostics: { ...error.diagnostic } }),
|
|
308
|
+
...(error.launcherFailure === undefined
|
|
309
|
+
? {}
|
|
310
|
+
: { launcher: error.launcherFailure }),
|
|
311
|
+
};
|
|
312
|
+
}
|
|
313
|
+
if (error instanceof HopperStartError)
|
|
314
|
+
return {
|
|
315
|
+
stage: "launch",
|
|
316
|
+
provider_state: "unknown",
|
|
317
|
+
retry_action: error.ownerRunId === undefined ? "retry" : "unknown",
|
|
318
|
+
...(error.ownerRunId === undefined
|
|
319
|
+
? {}
|
|
320
|
+
: { owner_run_id: error.ownerRunId }),
|
|
321
|
+
...(error.launcherFailure === undefined
|
|
322
|
+
? {}
|
|
323
|
+
: { launcher: error.launcherFailure }),
|
|
237
324
|
};
|
|
238
325
|
return undefined;
|
|
239
326
|
};
|
|
@@ -255,16 +342,40 @@ const primaryBrowserFailureReason = (error) => {
|
|
|
255
342
|
};
|
|
256
343
|
const lifecycleErrorDetails = (error) => {
|
|
257
344
|
if (error instanceof AnalysisCancelledError)
|
|
258
|
-
return {
|
|
345
|
+
return {
|
|
346
|
+
operation: error.operation,
|
|
347
|
+
cleanup: error.cleanup === undefined ? "complete" : "incomplete",
|
|
348
|
+
...(error.cleanup === undefined
|
|
349
|
+
? {}
|
|
350
|
+
: {
|
|
351
|
+
cleanup_reason: error.cleanup.reason,
|
|
352
|
+
resources: [...error.cleanup.resources],
|
|
353
|
+
execution_failure: "cancelled",
|
|
354
|
+
}),
|
|
355
|
+
};
|
|
259
356
|
if (error instanceof HopperCancelledError)
|
|
260
357
|
return { operation: "hopper", cleanup: "complete" };
|
|
261
358
|
if (error instanceof AnalysisTimeoutError)
|
|
262
|
-
return {
|
|
359
|
+
return {
|
|
360
|
+
operation: error.operation,
|
|
361
|
+
timeout_ms: error.timeoutMs,
|
|
362
|
+
...(error.cleanup === undefined
|
|
363
|
+
? {}
|
|
364
|
+
: {
|
|
365
|
+
cleanup: "incomplete",
|
|
366
|
+
cleanup_reason: error.cleanup.reason,
|
|
367
|
+
resources: [...error.cleanup.resources],
|
|
368
|
+
}),
|
|
369
|
+
};
|
|
263
370
|
if (error instanceof HopperTimeoutError)
|
|
264
371
|
return {
|
|
265
|
-
stage: error.operation === undefined ? "startup" :
|
|
372
|
+
stage: error.operation === undefined ? "startup" : error.stage,
|
|
266
373
|
timeout_ms: error.timeoutMs,
|
|
374
|
+
...(error.launcherOutcome === undefined
|
|
375
|
+
? {}
|
|
376
|
+
: { launcher: error.launcherOutcome }),
|
|
267
377
|
provider_state: error.providerState,
|
|
378
|
+
retry_action: error.providerState === "busy" ? "wait" : "retry",
|
|
268
379
|
...(error.operation === undefined ? {} : { operation: error.operation }),
|
|
269
380
|
...(error.requestId === undefined ? {} : { request_id: error.requestId }),
|
|
270
381
|
};
|
|
@@ -272,10 +383,27 @@ const lifecycleErrorDetails = (error) => {
|
|
|
272
383
|
return {
|
|
273
384
|
cleanup: "incomplete",
|
|
274
385
|
resources: [...error.cleanupResources],
|
|
386
|
+
...(error.cleanupReport === undefined
|
|
387
|
+
? {}
|
|
388
|
+
: { cleanup_report: jsonValueSchema.parse(error.cleanupReport) }),
|
|
389
|
+
...(error.executionFailure === undefined
|
|
390
|
+
? {}
|
|
391
|
+
: { execution_failure: error.executionFailure }),
|
|
392
|
+
};
|
|
393
|
+
if (error._tag === "ProcessCaptureError") {
|
|
394
|
+
const details = {
|
|
395
|
+
...(error.userCategory === "cancelled"
|
|
396
|
+
? { operation: "process_capture", cleanup: "complete" }
|
|
397
|
+
: {}),
|
|
398
|
+
...(error.cleanupReport === undefined
|
|
399
|
+
? {}
|
|
400
|
+
: { cleanup_report: jsonValueSchema.parse(error.cleanupReport) }),
|
|
401
|
+
...(error.executionFailure === undefined
|
|
402
|
+
? {}
|
|
403
|
+
: { execution_failure: error.executionFailure }),
|
|
275
404
|
};
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
return { operation: "process_capture", cleanup: "complete" };
|
|
405
|
+
return Object.keys(details).length === 0 ? undefined : details;
|
|
406
|
+
}
|
|
279
407
|
if (error instanceof BinaryTargetError)
|
|
280
408
|
return {
|
|
281
409
|
path: error.path,
|
|
@@ -287,6 +415,7 @@ const lifecycleErrorDetails = (error) => {
|
|
|
287
415
|
return undefined;
|
|
288
416
|
};
|
|
289
417
|
const RETRYABLE_CODES = new Set([
|
|
418
|
+
"artifact_changed",
|
|
290
419
|
"invalid_request",
|
|
291
420
|
"provider_timeout",
|
|
292
421
|
"cancelled",
|