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
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { constants } from "node:fs";
|
|
3
|
+
import { lstat, mkdtemp, open, rm } from "node:fs/promises";
|
|
4
|
+
import { tmpdir } from "node:os";
|
|
5
|
+
import { basename, join } from "node:path";
|
|
6
|
+
import { AnalysisError } from "../domain/analysisErrorBase.js";
|
|
7
|
+
import { AnalysisAccessDeniedError, AnalysisArtifactChangedError, AnalysisCancelledError, AnalysisResourceConstraintError, } from "../domain/analysisErrorCore.js";
|
|
8
|
+
import { ProviderAdapterError } from "../domain/providerAdapterError.js";
|
|
9
|
+
import { err, ok } from "../domain/result.js";
|
|
10
|
+
import { NATIVE_MACOS_PROVIDER_IDENTITY } from "./NativeMacOSProviderMetadata.js";
|
|
11
|
+
const identity = (stat) => [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(":");
|
|
12
|
+
const changedTarget = (target, reason) => err(new AnalysisArtifactChangedError("inspect_signature", target.path, reason));
|
|
13
|
+
const signatureReadFailure = (target, cause) => {
|
|
14
|
+
if (cause instanceof AnalysisError)
|
|
15
|
+
return cause;
|
|
16
|
+
const code = cause instanceof Error && "code" in cause ? cause.code : undefined;
|
|
17
|
+
if (code === "EACCES" || code === "EPERM")
|
|
18
|
+
return new AnalysisAccessDeniedError("inspect_signature", target.path, code, { cause });
|
|
19
|
+
if (code === "ENOENT" || code === "ENOTDIR" || code === "ELOOP")
|
|
20
|
+
return new AnalysisArtifactChangedError("inspect_signature", target.path, `Registered signature target is no longer readable (${code}): ${target.path}`, { cause });
|
|
21
|
+
return new ProviderAdapterError(NATIVE_MACOS_PROVIDER_IDENTITY.id, "inspect_signature", {
|
|
22
|
+
cause,
|
|
23
|
+
diagnostics: {
|
|
24
|
+
path: target.path,
|
|
25
|
+
phase: "target-version-binding",
|
|
26
|
+
system_code: typeof code === "string" ? code : null,
|
|
27
|
+
reason: cause instanceof Error ? cause.message : String(cause),
|
|
28
|
+
},
|
|
29
|
+
});
|
|
30
|
+
};
|
|
31
|
+
/** Inspect a digest-verified private copy, releasing it on every exit path. */
|
|
32
|
+
export const withSignatureTarget = async (target, inspect, signal) => {
|
|
33
|
+
let directory;
|
|
34
|
+
try {
|
|
35
|
+
signal?.throwIfAborted();
|
|
36
|
+
directory = await mkdtemp(join(tmpdir(), "rea-signature-"));
|
|
37
|
+
}
|
|
38
|
+
catch (cause) {
|
|
39
|
+
return err(signal?.aborted
|
|
40
|
+
? new AnalysisCancelledError("inspect_signature")
|
|
41
|
+
: snapshotFailure(target, "create", cause));
|
|
42
|
+
}
|
|
43
|
+
let result;
|
|
44
|
+
let cleanup;
|
|
45
|
+
try {
|
|
46
|
+
const binding = await bindSignatureTarget(target, join(directory, basename(target.path)), signal);
|
|
47
|
+
result = binding.ok ? await inspect(binding.value) : binding;
|
|
48
|
+
}
|
|
49
|
+
finally {
|
|
50
|
+
try {
|
|
51
|
+
await rm(directory, { recursive: true, force: true });
|
|
52
|
+
cleanup = ok(undefined);
|
|
53
|
+
}
|
|
54
|
+
catch (cause) {
|
|
55
|
+
cleanup = err(snapshotFailure(target, "cleanup", cause));
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
// Cleanup cannot replace the operation's original actionable failure.
|
|
59
|
+
return result.ok && !cleanup.ok ? cleanup : result;
|
|
60
|
+
};
|
|
61
|
+
const snapshotFailure = (target, phase, cause) => new ProviderAdapterError(NATIVE_MACOS_PROVIDER_IDENTITY.id, "inspect_signature", {
|
|
62
|
+
cause,
|
|
63
|
+
diagnostics: {
|
|
64
|
+
path: target.path,
|
|
65
|
+
phase: `signature-snapshot-${phase}`,
|
|
66
|
+
reason: cause instanceof Error ? cause.message : String(cause),
|
|
67
|
+
},
|
|
68
|
+
});
|
|
69
|
+
const snapshotIO = async (target, phase, operation) => {
|
|
70
|
+
try {
|
|
71
|
+
return await operation();
|
|
72
|
+
}
|
|
73
|
+
catch (cause) {
|
|
74
|
+
throw snapshotFailure(target, phase, cause);
|
|
75
|
+
}
|
|
76
|
+
};
|
|
77
|
+
const copySignatureBytes = async (target, source, snapshot, signal) => {
|
|
78
|
+
const size = Number(source.stat.size);
|
|
79
|
+
if (!Number.isSafeInteger(size))
|
|
80
|
+
throw new AnalysisResourceConstraintError("inspect_signature", "file-size", `Signature target size is not exactly representable: ${target.path}`, null);
|
|
81
|
+
const hash = createHash("sha256");
|
|
82
|
+
const chunk = Buffer.alloc(64 * 1024);
|
|
83
|
+
let position = 0;
|
|
84
|
+
while (position < size) {
|
|
85
|
+
signal?.throwIfAborted();
|
|
86
|
+
const { bytesRead } = await source.file.read(chunk, 0, Math.min(chunk.length, size - position), position);
|
|
87
|
+
signal?.throwIfAborted();
|
|
88
|
+
if (bytesRead === 0)
|
|
89
|
+
throw new AnalysisArtifactChangedError("inspect_signature", target.path, `Signature target was truncated while hashing: ${target.path}`);
|
|
90
|
+
const bytes = chunk.subarray(0, bytesRead);
|
|
91
|
+
hash.update(bytes);
|
|
92
|
+
// writeFile retries short writes; memory remains bounded to this chunk.
|
|
93
|
+
await snapshotIO(target, "write", () => snapshot.writeFile(bytes));
|
|
94
|
+
position += bytesRead;
|
|
95
|
+
}
|
|
96
|
+
return hash.digest("hex");
|
|
97
|
+
};
|
|
98
|
+
/** Hash and copy the same descriptor bytes, without reopening the mutable path. */
|
|
99
|
+
const bindSignatureTarget = async (target, snapshotPath, signal) => {
|
|
100
|
+
try {
|
|
101
|
+
signal?.throwIfAborted();
|
|
102
|
+
const before = await lstat(target.path, { bigint: true });
|
|
103
|
+
signal?.throwIfAborted();
|
|
104
|
+
if (!before.isFile() || before.isSymbolicLink())
|
|
105
|
+
return changedTarget(target, `Signature target is no longer a regular file: ${target.path}`);
|
|
106
|
+
const file = await open(target.path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
|
|
107
|
+
try {
|
|
108
|
+
const opened = await file.stat({ bigint: true });
|
|
109
|
+
signal?.throwIfAborted();
|
|
110
|
+
if (identity(opened) !== identity(before))
|
|
111
|
+
return changedTarget(target, `Signature target changed before open: ${target.path}`);
|
|
112
|
+
const snapshot = await snapshotIO(target, "create-file", () => open(snapshotPath, "wx", 0o600));
|
|
113
|
+
try {
|
|
114
|
+
const observed = await copySignatureBytes(target, { file, stat: opened }, snapshot, signal);
|
|
115
|
+
if (observed !== target.sha256)
|
|
116
|
+
return changedTarget(target, `Signature target digest changed: ${target.path}; expected ${target.sha256}, observed ${observed}`);
|
|
117
|
+
const after = await file.stat({ bigint: true });
|
|
118
|
+
const current = await lstat(target.path, { bigint: true });
|
|
119
|
+
signal?.throwIfAborted();
|
|
120
|
+
if (identity(after) !== identity(opened) ||
|
|
121
|
+
identity(current) !== identity(opened))
|
|
122
|
+
return changedTarget(target, `Signature target changed while establishing its version: ${target.path}`);
|
|
123
|
+
await snapshotIO(target, "seal", () => snapshot.chmod(0o400));
|
|
124
|
+
return ok({ identity: identity(opened), snapshotPath });
|
|
125
|
+
}
|
|
126
|
+
finally {
|
|
127
|
+
await snapshotIO(target, "close", () => snapshot.close());
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
finally {
|
|
131
|
+
await file.close();
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
catch (cause) {
|
|
135
|
+
return err(signal?.aborted
|
|
136
|
+
? new AnalysisCancelledError("inspect_signature")
|
|
137
|
+
: signatureReadFailure(target, cause));
|
|
138
|
+
}
|
|
139
|
+
};
|
|
140
|
+
/** Reject target drift across signature command captures. */
|
|
141
|
+
export const verifySignatureTarget = async (target, binding, signal) => {
|
|
142
|
+
try {
|
|
143
|
+
signal?.throwIfAborted();
|
|
144
|
+
const current = await lstat(target.path, { bigint: true });
|
|
145
|
+
signal?.throwIfAborted();
|
|
146
|
+
return current.isFile() && identity(current) === binding.identity
|
|
147
|
+
? ok(undefined)
|
|
148
|
+
: changedTarget(target, `Signature target changed during inspection: ${target.path}`);
|
|
149
|
+
}
|
|
150
|
+
catch (cause) {
|
|
151
|
+
return err(signal?.aborted
|
|
152
|
+
? new AnalysisCancelledError("inspect_signature")
|
|
153
|
+
: signatureReadFailure(target, cause));
|
|
154
|
+
}
|
|
155
|
+
};
|
|
@@ -3,6 +3,9 @@ const architectureSchema = z.object({
|
|
|
3
3
|
name: z.string().min(1),
|
|
4
4
|
cpu_type: z.string().nullable(),
|
|
5
5
|
cpu_subtype: z.string().nullable(),
|
|
6
|
+
cpu_type_code: z.number().int().nonnegative().nullable(),
|
|
7
|
+
cpu_subtype_code: z.number().int().nonnegative().nullable(),
|
|
8
|
+
capabilities: z.string().nullable(),
|
|
6
9
|
file_offset: z.number().int().min(0).nullable(),
|
|
7
10
|
size: z.number().int().min(0).nullable(),
|
|
8
11
|
alignment: z.number().int().min(0).nullable(),
|
|
@@ -18,6 +21,9 @@ export const parseLipoArchitectures = (output) => {
|
|
|
18
21
|
name: thinArchitecture,
|
|
19
22
|
cpu_type: null,
|
|
20
23
|
cpu_subtype: null,
|
|
24
|
+
cpu_type_code: null,
|
|
25
|
+
cpu_subtype_code: null,
|
|
26
|
+
capabilities: null,
|
|
21
27
|
file_offset: null,
|
|
22
28
|
size: null,
|
|
23
29
|
alignment: null,
|
|
@@ -36,6 +42,9 @@ export const parseLipoArchitectures = (output) => {
|
|
|
36
42
|
: name,
|
|
37
43
|
cpu_type: current.cputype ?? null,
|
|
38
44
|
cpu_subtype: current.cpusubtype ?? null,
|
|
45
|
+
cpu_type_code: cpuTypeCode(current.cputype),
|
|
46
|
+
cpu_subtype_code: cpuSubtypeCode(current.cpusubtype, current.capabilities),
|
|
47
|
+
capabilities: current.capabilities ?? null,
|
|
39
48
|
file_offset: integer(current.offset),
|
|
40
49
|
size: integer(current.size),
|
|
41
50
|
alignment: alignment(current.align),
|
|
@@ -54,7 +63,7 @@ export const parseLipoArchitectures = (output) => {
|
|
|
54
63
|
current = { architecture: line.slice("architecture ".length).trim() };
|
|
55
64
|
continue;
|
|
56
65
|
}
|
|
57
|
-
const match = /^(cputype|cpusubtype|offset|size|align)\s+(.+)$/u.exec(line);
|
|
66
|
+
const match = /^(cputype|cpusubtype|capabilities|offset|size|align)\s+(.+)$/u.exec(line);
|
|
58
67
|
if (match?.[1] !== undefined && match[2] !== undefined) {
|
|
59
68
|
current ??= {};
|
|
60
69
|
current[match[1]] = match[2].trim();
|
|
@@ -71,6 +80,67 @@ const integer = (value) => {
|
|
|
71
80
|
const parsed = Number.parseInt(value, 10);
|
|
72
81
|
return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : null;
|
|
73
82
|
};
|
|
83
|
+
const CPU_TYPES = {
|
|
84
|
+
CPU_TYPE_X86: 7,
|
|
85
|
+
CPU_TYPE_X86_64: 0x01000007,
|
|
86
|
+
CPU_TYPE_ARM: 12,
|
|
87
|
+
CPU_TYPE_ARM64: 0x0100000c,
|
|
88
|
+
CPU_TYPE_ARM64_32: 0x0200000c,
|
|
89
|
+
CPU_TYPE_POWERPC: 18,
|
|
90
|
+
CPU_TYPE_POWERPC64: 0x01000012,
|
|
91
|
+
};
|
|
92
|
+
const CPU_SUBTYPES = {
|
|
93
|
+
CPU_SUBTYPE_X86_ALL: 3,
|
|
94
|
+
CPU_SUBTYPE_X86_64_ALL: 3,
|
|
95
|
+
CPU_SUBTYPE_X86_64_H: 8,
|
|
96
|
+
CPU_SUBTYPE_ARM64_ALL: 0,
|
|
97
|
+
CPU_SUBTYPE_ARM64_V8: 1,
|
|
98
|
+
CPU_SUBTYPE_ARM64E: 2,
|
|
99
|
+
CPU_SUBTYPE_ARM64_32_ALL: 0,
|
|
100
|
+
CPU_SUBTYPE_ARM64_32_V8: 1,
|
|
101
|
+
CPU_SUBTYPE_ARM_V7: 9,
|
|
102
|
+
CPU_SUBTYPE_ARM_V7S: 11,
|
|
103
|
+
CPU_SUBTYPE_ARM_V7K: 12,
|
|
104
|
+
CPU_SUBTYPE_POWERPC_ALL: 0,
|
|
105
|
+
CPU_SUBTYPE_POWERPC_970: 100,
|
|
106
|
+
};
|
|
107
|
+
/** Normalize known lipo names while retaining the producer's original text. */
|
|
108
|
+
const cpuTypeCode = (value) => {
|
|
109
|
+
if (value === undefined)
|
|
110
|
+
return null;
|
|
111
|
+
const numeric = unsigned32(value);
|
|
112
|
+
return numeric ?? CPU_TYPES[value] ?? null;
|
|
113
|
+
};
|
|
114
|
+
/** Normalize the subtype and its separately printed ptrauth capability bits. */
|
|
115
|
+
const cpuSubtypeCode = (value, capabilities) => {
|
|
116
|
+
if (value === undefined)
|
|
117
|
+
return null;
|
|
118
|
+
const numeric = unsigned32(value);
|
|
119
|
+
if (numeric !== null)
|
|
120
|
+
return numeric;
|
|
121
|
+
const subtype = CPU_SUBTYPES[value];
|
|
122
|
+
if (subtype === undefined)
|
|
123
|
+
return null;
|
|
124
|
+
if (value !== "CPU_SUBTYPE_ARM64E")
|
|
125
|
+
return subtype;
|
|
126
|
+
const version = /PTR_AUTH_VERSION\s+USERSPACE\s+(\d+)/u.exec(capabilities ?? "")?.[1];
|
|
127
|
+
if (version === undefined)
|
|
128
|
+
return null;
|
|
129
|
+
const parsedVersion = Number(version);
|
|
130
|
+
if (!Number.isInteger(parsedVersion) ||
|
|
131
|
+
parsedVersion < 0 ||
|
|
132
|
+
parsedVersion > 15)
|
|
133
|
+
return null;
|
|
134
|
+
return (0x80000000 | (parsedVersion << 24) | subtype) >>> 0;
|
|
135
|
+
};
|
|
136
|
+
const unsigned32 = (value) => {
|
|
137
|
+
if (!/^(?:\d+|0x[\da-f]+)$/iu.test(value))
|
|
138
|
+
return null;
|
|
139
|
+
const parsed = Number(value);
|
|
140
|
+
return Number.isInteger(parsed) && parsed >= 0 && parsed <= 0xffffffff
|
|
141
|
+
? parsed >>> 0
|
|
142
|
+
: null;
|
|
143
|
+
};
|
|
74
144
|
const alignment = (value) => {
|
|
75
145
|
if (value === undefined)
|
|
76
146
|
return null;
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
import { access, mkdir, stat, writeFile } from "node:fs/promises";
|
|
2
|
+
import { constants } from "node:fs";
|
|
3
|
+
import { randomUUID } from "node:crypto";
|
|
4
|
+
import { isAbsolute, join } from "node:path";
|
|
5
|
+
import { fileURLToPath } from "node:url";
|
|
6
|
+
import { z } from "zod";
|
|
7
|
+
import { AnalysisCancelledError, AnalysisCapabilityUnavailableError, AnalysisOutputError, } from "../../domain/analysisErrorCore.js";
|
|
8
|
+
import { ProviderAdapterError } from "../../domain/providerAdapterError.js";
|
|
9
|
+
import { recordedCrashDebuggerSchema, } from "../../domain/native/recordedCrash.js";
|
|
10
|
+
import { readStableArtifact } from "../../artifacts/readStableArtifact.js";
|
|
11
|
+
import { runOwnedCommand } from "../../process/OwnedCommand.js";
|
|
12
|
+
import { capturedPwntoolsOutput, pwntoolsDecoderFailure, } from "../pwntools/PwntoolsFailures.js";
|
|
13
|
+
import { PWNTOOLS_LIMITS } from "../pwntools/PwntoolsRelease.js";
|
|
14
|
+
import { readPwntoolsFailureEvidence } from "../pwntools/PwntoolsResourceLimits.js";
|
|
15
|
+
const OPERATION = "inspect_recorded_crash";
|
|
16
|
+
const replySchema = z.discriminatedUnion("ok", [
|
|
17
|
+
z.strictObject({ ok: z.literal(true), value: recordedCrashDebuggerSchema }),
|
|
18
|
+
z.strictObject({
|
|
19
|
+
ok: z.literal(false),
|
|
20
|
+
reason: z.enum([
|
|
21
|
+
"unavailable",
|
|
22
|
+
"unsupported",
|
|
23
|
+
"decoder",
|
|
24
|
+
"format",
|
|
25
|
+
"output-limit",
|
|
26
|
+
]),
|
|
27
|
+
message: z.string(),
|
|
28
|
+
}),
|
|
29
|
+
]);
|
|
30
|
+
/** Add mapping candidates from an owned core-only debugger, using the existing snapshot. */
|
|
31
|
+
export const inspectPwndbgCore = async ({ environment, rootPath, diagnostics, options, launcher, probePath, }) => {
|
|
32
|
+
const gdb = environment.REA_PWNDBG_GDB ?? "/usr/bin/gdb";
|
|
33
|
+
const entry = environment.REA_PWNDBG_GDBINIT ?? "";
|
|
34
|
+
const venv = environment.REA_PWNDBG_VENV_PATH ?? "";
|
|
35
|
+
const unavailable = (message, cause) => new AnalysisCapabilityUnavailableError("pwndbg-core", OPERATION, message, {
|
|
36
|
+
...(cause === undefined ? {} : { cause }),
|
|
37
|
+
userMessage: message,
|
|
38
|
+
capturedOutput: diagnostics,
|
|
39
|
+
});
|
|
40
|
+
const checkCancelled = () => {
|
|
41
|
+
if (options?.signal?.aborted)
|
|
42
|
+
throw new AnalysisCancelledError(OPERATION, {
|
|
43
|
+
capturedOutput: diagnostics,
|
|
44
|
+
});
|
|
45
|
+
};
|
|
46
|
+
checkCancelled();
|
|
47
|
+
for (const [key, path, kind] of [
|
|
48
|
+
["REA_PWNDBG_GDB", gdb, "file"],
|
|
49
|
+
["REA_PWNDBG_GDBINIT", entry, "file"],
|
|
50
|
+
["REA_PWNDBG_VENV_PATH", venv, "directory"],
|
|
51
|
+
]) {
|
|
52
|
+
try {
|
|
53
|
+
checkCancelled();
|
|
54
|
+
if (!isAbsolute(path))
|
|
55
|
+
throw new Error("Expected an absolute caller-supplied path.");
|
|
56
|
+
const mode = key === "REA_PWNDBG_GDB" ? constants.X_OK : constants.R_OK;
|
|
57
|
+
if (probePath !== undefined) {
|
|
58
|
+
await probePath(path, kind, mode);
|
|
59
|
+
}
|
|
60
|
+
else {
|
|
61
|
+
await access(path, mode);
|
|
62
|
+
checkCancelled();
|
|
63
|
+
const information = await stat(path);
|
|
64
|
+
checkCancelled();
|
|
65
|
+
if (kind === "file" ? !information.isFile() : !information.isDirectory())
|
|
66
|
+
throw new Error(`Expected a ${kind}.`);
|
|
67
|
+
}
|
|
68
|
+
checkCancelled();
|
|
69
|
+
}
|
|
70
|
+
catch (cause) {
|
|
71
|
+
if (options?.signal?.aborted)
|
|
72
|
+
checkCancelled();
|
|
73
|
+
throw unavailable(`${key} is unavailable at ${path}: ${cause instanceof Error ? cause.message : String(cause)}. Configure the requested core-only context, or omit include_debugger_context for basic recorded evidence.`, cause);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
checkCancelled();
|
|
77
|
+
const stage = join(rootPath, "debugger");
|
|
78
|
+
await mkdir(stage, { mode: 0o700 });
|
|
79
|
+
const requestPath = join(stage, "request.json");
|
|
80
|
+
const replyPath = join(stage, "reply.json");
|
|
81
|
+
await writeFile(requestPath, JSON.stringify({
|
|
82
|
+
snapshot_path: join(rootPath, "object.snapshot"),
|
|
83
|
+
reply_path: replyPath,
|
|
84
|
+
gdb,
|
|
85
|
+
gdbinit: entry,
|
|
86
|
+
venv,
|
|
87
|
+
}), { flag: "wx", mode: 0o600 });
|
|
88
|
+
let output;
|
|
89
|
+
try {
|
|
90
|
+
options?.signal?.throwIfAborted();
|
|
91
|
+
const execution = await runOwnedCommand({
|
|
92
|
+
command: environment.REA_PWNTOOLS_PYTHON ?? "",
|
|
93
|
+
arguments: [
|
|
94
|
+
"-I",
|
|
95
|
+
fileURLToPath(new URL("../../../bridge/pwndbg/launch.py", import.meta.url)),
|
|
96
|
+
join(stage, "resource.failure"),
|
|
97
|
+
requestPath,
|
|
98
|
+
],
|
|
99
|
+
cwd: stage,
|
|
100
|
+
runId: `rea-recorded-core-debugger-${randomUUID()}`,
|
|
101
|
+
hostEnvironment: {
|
|
102
|
+
...environment,
|
|
103
|
+
PWNDBG_NO_AUTOUPDATE: "1",
|
|
104
|
+
PWNDBG_VENV_PATH: venv,
|
|
105
|
+
PWNLIB_NOTERM: "1",
|
|
106
|
+
TERM: "dumb",
|
|
107
|
+
HOME: stage,
|
|
108
|
+
XDG_CACHE_HOME: join(stage, "cache"),
|
|
109
|
+
XDG_CONFIG_HOME: join(stage, "config"),
|
|
110
|
+
PYTHONNOUSERSITE: "1",
|
|
111
|
+
OPENBLAS_NUM_THREADS: "1",
|
|
112
|
+
OMP_NUM_THREADS: "1",
|
|
113
|
+
},
|
|
114
|
+
}, {
|
|
115
|
+
timeoutMs: PWNTOOLS_LIMITS.timeoutMs,
|
|
116
|
+
diagnosticBytes: PWNTOOLS_LIMITS.diagnosticBytes,
|
|
117
|
+
}, {
|
|
118
|
+
...(options?.signal === undefined ? {} : { signal: options.signal }),
|
|
119
|
+
...(launcher === undefined ? {} : { launcher }),
|
|
120
|
+
});
|
|
121
|
+
output = capturedPwntoolsOutput(execution);
|
|
122
|
+
let reply;
|
|
123
|
+
try {
|
|
124
|
+
const raw = await readStableArtifact(replyPath, PWNTOOLS_LIMITS.outputBytes, options?.signal);
|
|
125
|
+
reply = replySchema.parse(JSON.parse(raw.bytes.toString("utf8")));
|
|
126
|
+
}
|
|
127
|
+
catch (cause) {
|
|
128
|
+
if (options?.signal?.aborted)
|
|
129
|
+
throw new AnalysisCancelledError(OPERATION, {
|
|
130
|
+
capturedOutput: recordedCrashStageOutput(diagnostics, output),
|
|
131
|
+
});
|
|
132
|
+
throw new AnalysisOutputError(OPERATION, `Core-only debugger reply failed: ${cause instanceof Error ? cause.message : String(cause)}`, {
|
|
133
|
+
cause,
|
|
134
|
+
capturedOutput: recordedCrashStageOutput(diagnostics, output),
|
|
135
|
+
});
|
|
136
|
+
}
|
|
137
|
+
if (!reply.ok) {
|
|
138
|
+
if (reply.reason === "unavailable" || reply.reason === "unsupported")
|
|
139
|
+
throw new AnalysisCapabilityUnavailableError("pwndbg-core", OPERATION, reply.message, {
|
|
140
|
+
userMessage: reply.message,
|
|
141
|
+
capturedOutput: recordedCrashStageOutput(diagnostics, output),
|
|
142
|
+
});
|
|
143
|
+
if (reply.reason === "format" || reply.reason === "output-limit")
|
|
144
|
+
throw new AnalysisOutputError(OPERATION, reply.message, {
|
|
145
|
+
capturedOutput: recordedCrashStageOutput(diagnostics, output),
|
|
146
|
+
});
|
|
147
|
+
throw new ProviderAdapterError("pwndbg-core", OPERATION, {
|
|
148
|
+
diagnostics: {
|
|
149
|
+
stage: "debugger",
|
|
150
|
+
reason: reply.message,
|
|
151
|
+
captured_output: { ...recordedCrashStageOutput(diagnostics, output) },
|
|
152
|
+
},
|
|
153
|
+
});
|
|
154
|
+
}
|
|
155
|
+
if (reply.value.status !== "available")
|
|
156
|
+
throw new AnalysisOutputError(OPERATION, "Requested debugger context returned no core evidence.", { capturedOutput: recordedCrashStageOutput(diagnostics, output) });
|
|
157
|
+
return { ...reply.value, diagnostics: output };
|
|
158
|
+
}
|
|
159
|
+
catch (cause) {
|
|
160
|
+
if (options?.signal?.aborted &&
|
|
161
|
+
(cause === options.signal.reason ||
|
|
162
|
+
(cause instanceof Error && cause.name === "AbortError")))
|
|
163
|
+
throw new AnalysisCancelledError(OPERATION, {
|
|
164
|
+
capturedOutput: recordedCrashStageOutput(diagnostics, output),
|
|
165
|
+
});
|
|
166
|
+
throw pwntoolsDecoderFailure(cause, "debugger", gdb, environment.REA_PWNTOOLS_PYTHON ?? "", await readPwntoolsFailureEvidence(cause, stage), {
|
|
167
|
+
operation: OPERATION,
|
|
168
|
+
providerId: "pwndbg-core",
|
|
169
|
+
precedingOutput: diagnostics,
|
|
170
|
+
});
|
|
171
|
+
}
|
|
172
|
+
};
|
|
173
|
+
/** Preserve both stages' exact text and their independently observed truncation state. */
|
|
174
|
+
export const recordedCrashStageOutput = (basic, debuggerOutput) => debuggerOutput === undefined
|
|
175
|
+
? basic
|
|
176
|
+
: {
|
|
177
|
+
stdout: `[core decoder]\n${basic.stdout}\n[debugger]\n${debuggerOutput.stdout}`,
|
|
178
|
+
stderr: `[core decoder]\n${basic.stderr}\n[debugger]\n${debuggerOutput.stderr}`,
|
|
179
|
+
truncated: basic.truncated || debuggerOutput.truncated,
|
|
180
|
+
};
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
import { pwntoolsDecoderFailure, pwntoolsUnavailable, capturedPwntoolsOutput, } from "./PwntoolsFailures.js";
|
|
2
|
+
import { randomUUID } from "node:crypto";
|
|
3
|
+
import { access, stat, writeFile } from "node:fs/promises";
|
|
4
|
+
import { constants } from "node:fs";
|
|
5
|
+
import { isAbsolute, join } from "node:path";
|
|
6
|
+
import { fileURLToPath } from "node:url";
|
|
7
|
+
import { z } from "zod";
|
|
8
|
+
import { readStableArtifact } from "../../artifacts/readStableArtifact.js";
|
|
9
|
+
import { AnalysisCancelledError, AnalysisCapabilityUnavailableError, AnalysisUnsupportedTargetError, AnalysisInputError, AnalysisOutputError, AnalysisResourceConstraintError, } from "../../domain/analysisErrorCore.js";
|
|
10
|
+
import { projectAnalysisError } from "../../domain/analysisErrorProjection.js";
|
|
11
|
+
import { ProviderAdapterError } from "../../domain/providerAdapterError.js";
|
|
12
|
+
import { ProviderCleanupError } from "../../domain/providerCleanupError.js";
|
|
13
|
+
import { err, ok } from "../../domain/result.js";
|
|
14
|
+
import { runOwnedCommand } from "../../process/OwnedCommand.js";
|
|
15
|
+
import { OwnedCommandFailure } from "../../process/OwnedCommand.js";
|
|
16
|
+
import { pwntoolsResourceLimitsSchema, readPwntoolsFailureEvidence, } from "./PwntoolsResourceLimits.js";
|
|
17
|
+
import { PrivateRuntimeRoot } from "../../process/PrivateRuntimeRoot.js";
|
|
18
|
+
import { PWNTOOLS_PROVIDER_IDENTITY, PWNTOOLS_LIMITS, } from "./PwntoolsRelease.js";
|
|
19
|
+
/** Thin owned-process adapter; all ELF parsing and heuristics come from unchanged upstream code. */
|
|
20
|
+
export class PwntoolsDecoder {
|
|
21
|
+
profile;
|
|
22
|
+
environment;
|
|
23
|
+
launcher;
|
|
24
|
+
createRuntime;
|
|
25
|
+
identity;
|
|
26
|
+
constructor(profile, environment, launcher, createRuntime = () => PrivateRuntimeRoot.create({ prefix: "rea-artifact-decoder-" })) {
|
|
27
|
+
this.profile = profile;
|
|
28
|
+
this.environment = environment;
|
|
29
|
+
this.launcher = launcher;
|
|
30
|
+
this.createRuntime = createRuntime;
|
|
31
|
+
this.identity = profile.identity;
|
|
32
|
+
}
|
|
33
|
+
/** Snapshot one explicit artifact and return complete static observations without launching the selected object as a host process. */
|
|
34
|
+
async inspect(input, options) {
|
|
35
|
+
const OPERATION = this.profile.operation;
|
|
36
|
+
const context = { operation: OPERATION, providerId: this.identity.id };
|
|
37
|
+
const replySchema = z.discriminatedUnion("ok", [
|
|
38
|
+
z.strictObject({
|
|
39
|
+
ok: z.literal(true),
|
|
40
|
+
profile: z.literal(PWNTOOLS_PROVIDER_IDENTITY.version),
|
|
41
|
+
value: this.profile.payloadSchema,
|
|
42
|
+
}),
|
|
43
|
+
z.strictObject({
|
|
44
|
+
ok: z.literal(false),
|
|
45
|
+
reason: z.enum([
|
|
46
|
+
"format",
|
|
47
|
+
"unsupported",
|
|
48
|
+
"unsupported-target",
|
|
49
|
+
"unavailable",
|
|
50
|
+
"resource-limit",
|
|
51
|
+
"output-limit",
|
|
52
|
+
"decoder",
|
|
53
|
+
]),
|
|
54
|
+
message: z.string(),
|
|
55
|
+
reported_limits: pwntoolsResourceLimitsSchema.nullable().optional(),
|
|
56
|
+
}),
|
|
57
|
+
]);
|
|
58
|
+
let root;
|
|
59
|
+
let result;
|
|
60
|
+
let phase = "configuration";
|
|
61
|
+
const executablePath = this.environment.REA_PWNTOOLS_PYTHON ?? "";
|
|
62
|
+
let selectedPath = executablePath;
|
|
63
|
+
try {
|
|
64
|
+
if (options?.signal?.aborted)
|
|
65
|
+
throw new AnalysisCancelledError(OPERATION);
|
|
66
|
+
if (process.platform !== "linux" || process.arch !== "x64")
|
|
67
|
+
throw new AnalysisCapabilityUnavailableError(this.identity.id, OPERATION, "The initial real-verified pwntools artifact profile supports Linux x64 only.");
|
|
68
|
+
if (!isAbsolute(selectedPath))
|
|
69
|
+
throw pwntoolsUnavailable("Set REA_PWNTOOLS_PYTHON to an absolute caller-supplied Python executable with pwntools 4.15.0, pyelftools 0.33 and Unicorn 2.1.2; REA never installs Python or packages.", selectedPath, undefined, undefined, context);
|
|
70
|
+
await access(selectedPath, constants.X_OK);
|
|
71
|
+
if (!(await stat(selectedPath)).isFile())
|
|
72
|
+
throw pwntoolsUnavailable("Selected Python executable must be a regular executable file, not a directory: " +
|
|
73
|
+
selectedPath, selectedPath, undefined, undefined, context);
|
|
74
|
+
phase = "artifact-read";
|
|
75
|
+
selectedPath = input.path;
|
|
76
|
+
const snapshot = await readStableArtifact(input.path, PWNTOOLS_LIMITS.inputBytes, options?.signal);
|
|
77
|
+
phase = "decoder";
|
|
78
|
+
root = await this.createRuntime();
|
|
79
|
+
const requestPath = join(root.path, "request.json");
|
|
80
|
+
const snapshotPath = join(root.path, "object.snapshot");
|
|
81
|
+
const replyPath = join(root.path, "reply.json");
|
|
82
|
+
await writeFile(snapshotPath, snapshot.bytes, {
|
|
83
|
+
flag: "wx",
|
|
84
|
+
mode: 0o600,
|
|
85
|
+
...(options?.signal === undefined ? {} : { signal: options.signal }),
|
|
86
|
+
});
|
|
87
|
+
await writeFile(requestPath, JSON.stringify({ snapshot_path: snapshotPath, reply_path: replyPath }), { flag: "wx", mode: 0o600 });
|
|
88
|
+
const execution = await runOwnedCommand({
|
|
89
|
+
command: this.environment.REA_PWNTOOLS_PYTHON ?? "",
|
|
90
|
+
arguments: [
|
|
91
|
+
"-I",
|
|
92
|
+
fileURLToPath(this.profile.bridge),
|
|
93
|
+
join(root.path, "resource.failure"),
|
|
94
|
+
requestPath,
|
|
95
|
+
],
|
|
96
|
+
cwd: root.path,
|
|
97
|
+
runId: `rea-artifact-decoder-${randomUUID()}`,
|
|
98
|
+
hostEnvironment: {
|
|
99
|
+
...this.environment,
|
|
100
|
+
PWNLIB_NOTERM: "1",
|
|
101
|
+
OPENBLAS_NUM_THREADS: "1",
|
|
102
|
+
OMP_NUM_THREADS: "1",
|
|
103
|
+
},
|
|
104
|
+
}, {
|
|
105
|
+
timeoutMs: PWNTOOLS_LIMITS.timeoutMs,
|
|
106
|
+
diagnosticBytes: PWNTOOLS_LIMITS.diagnosticBytes,
|
|
107
|
+
}, {
|
|
108
|
+
...(options?.signal === undefined ? {} : { signal: options.signal }),
|
|
109
|
+
...(this.launcher === undefined ? {} : { launcher: this.launcher }),
|
|
110
|
+
});
|
|
111
|
+
const capturedOutput = capturedPwntoolsOutput(execution);
|
|
112
|
+
let reply;
|
|
113
|
+
try {
|
|
114
|
+
const file = await readStableArtifact(replyPath, PWNTOOLS_LIMITS.outputBytes, options?.signal);
|
|
115
|
+
reply = replySchema.parse(JSON.parse(file.bytes.toString("utf8")));
|
|
116
|
+
}
|
|
117
|
+
catch (cause) {
|
|
118
|
+
if (options?.signal?.aborted)
|
|
119
|
+
throw new AnalysisCancelledError(OPERATION, { capturedOutput });
|
|
120
|
+
throw new AnalysisOutputError(OPERATION, `Owned pwntools decoder reply failed for ${input.path}: ${cause instanceof z.ZodError ? cause.issues[0]?.message + " at " + (cause.issues[0]?.path.map(String).join(".") ?? "root") : cause instanceof Error ? cause.message : String(cause)}`, { cause, capturedOutput });
|
|
121
|
+
}
|
|
122
|
+
if (!reply.ok) {
|
|
123
|
+
if (reply.reason === "unsupported-target")
|
|
124
|
+
throw new AnalysisUnsupportedTargetError(OPERATION, input.path, reply.message, { capturedOutput });
|
|
125
|
+
if (reply.reason === "resource-limit")
|
|
126
|
+
throw new AnalysisResourceConstraintError(OPERATION, "memory", reply.message, reply.reported_limits ?? null, { capturedOutput });
|
|
127
|
+
if (reply.reason === "format")
|
|
128
|
+
throw new AnalysisInputError(OPERATION, { capturedOutput }, [
|
|
129
|
+
{
|
|
130
|
+
path: ["path"],
|
|
131
|
+
reason: "invalid_format",
|
|
132
|
+
message: reply.message,
|
|
133
|
+
},
|
|
134
|
+
]);
|
|
135
|
+
if (reply.reason === "unavailable")
|
|
136
|
+
throw pwntoolsUnavailable(reply.message, this.environment.REA_PWNTOOLS_PYTHON ?? "", undefined, capturedOutput, context);
|
|
137
|
+
if (reply.reason === "unsupported")
|
|
138
|
+
throw new AnalysisCapabilityUnavailableError(this.identity.id, OPERATION, reply.message, { userMessage: reply.message, capturedOutput });
|
|
139
|
+
if (reply.reason === "output-limit")
|
|
140
|
+
throw new AnalysisOutputError(OPERATION, reply.message, {
|
|
141
|
+
capturedOutput,
|
|
142
|
+
});
|
|
143
|
+
throw new ProviderAdapterError(this.identity.id, OPERATION, {
|
|
144
|
+
diagnostics: {
|
|
145
|
+
phase,
|
|
146
|
+
failure_kind: reply.reason,
|
|
147
|
+
reason: reply.message,
|
|
148
|
+
stdout: execution.stdout.text,
|
|
149
|
+
stderr: execution.stderr.text,
|
|
150
|
+
captured_output: { ...capturedOutput },
|
|
151
|
+
},
|
|
152
|
+
});
|
|
153
|
+
}
|
|
154
|
+
result = ok(await this.profile.project({
|
|
155
|
+
input,
|
|
156
|
+
payload: reply.value,
|
|
157
|
+
snapshot,
|
|
158
|
+
rootPath: root.path,
|
|
159
|
+
diagnostics: capturedOutput,
|
|
160
|
+
options,
|
|
161
|
+
}));
|
|
162
|
+
}
|
|
163
|
+
catch (cause) {
|
|
164
|
+
const evidence = await readPwntoolsFailureEvidence(cause, root?.path);
|
|
165
|
+
result = err(options?.signal?.aborted &&
|
|
166
|
+
(cause === options.signal.reason ||
|
|
167
|
+
(cause instanceof Error && cause.name === "AbortError"))
|
|
168
|
+
? new AnalysisCancelledError(OPERATION)
|
|
169
|
+
: pwntoolsDecoderFailure(cause, phase, selectedPath, executablePath, evidence, context));
|
|
170
|
+
}
|
|
171
|
+
if (root !== undefined) {
|
|
172
|
+
try {
|
|
173
|
+
await root.close();
|
|
174
|
+
}
|
|
175
|
+
catch (cause) {
|
|
176
|
+
return err(new ProviderCleanupError(this.identity.id, [root.path], {
|
|
177
|
+
reason: cause instanceof Error ? cause.message : String(cause),
|
|
178
|
+
previous_error: result.ok
|
|
179
|
+
? null
|
|
180
|
+
: projectAnalysisError(result.error),
|
|
181
|
+
...(result.ok
|
|
182
|
+
? {
|
|
183
|
+
captured_output: {
|
|
184
|
+
stdout: result.value.diagnostics.stdout,
|
|
185
|
+
stderr: result.value.diagnostics.stderr,
|
|
186
|
+
truncated: result.value.diagnostics.truncated,
|
|
187
|
+
},
|
|
188
|
+
}
|
|
189
|
+
: {}),
|
|
190
|
+
}, { operation: OPERATION }));
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
return result.ok && options?.signal?.aborted
|
|
194
|
+
? err(new AnalysisCancelledError(OPERATION, {
|
|
195
|
+
capturedOutput: {
|
|
196
|
+
stdout: result.value.diagnostics.stdout,
|
|
197
|
+
stderr: result.value.diagnostics.stderr,
|
|
198
|
+
truncated: result.value.diagnostics.truncated,
|
|
199
|
+
},
|
|
200
|
+
}))
|
|
201
|
+
: result;
|
|
202
|
+
}
|
|
203
|
+
}
|