rea-agents 6.4.0 → 6.5.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/DISCLAIMER.md +136 -0
- package/README.md +67 -16
- package/THIRD_PARTY_NOTICES.md +134 -0
- package/bridge/android/ReaJadxBridge.java +123 -11
- package/bridge/cutter/rea_bridge.py +816 -0
- package/bridge/ghidra/ReaGhidraAnalysisOptions.java +38 -0
- package/bridge/ghidra/ReaGhidraBridge.java +1181 -123
- package/bridge/ghidra/ReaGhidraBundleActivator.java +14 -0
- package/bridge/ghidra/ReaGhidraMipsSoftFloat.java +176 -0
- package/bridge/ghidra/ReaGhidraPrepareRaw.java +49 -0
- package/bridge/hopper_bridge.py +103 -69
- package/bridge/mitmproxy/capture.py +189 -13
- package/bridge/native/rea_lldb_tracer.py +40 -6
- package/bridge/process/ProcessRunTokenReader.swift +76 -34
- package/bridge/pwntools/layout_impl.py +5 -0
- package/bridge/pwntools/recorded_crash_impl.py +31 -10
- package/dist/adb/AdbConfiguration.js +15 -3
- package/dist/adb/AdbDeviceOutput.js +59 -37
- package/dist/adb/AdbDirectoryListing.js +80 -0
- package/dist/adb/AdbHostFileName.js +34 -0
- package/dist/adb/AdbProvider.js +416 -173
- package/dist/adb/AdbShellOutput.js +55 -57
- package/dist/android/JadxAnalysis.js +32 -7
- package/dist/android/JadxConfiguration.js +119 -29
- package/dist/android/JadxDoctor.js +115 -0
- package/dist/android/JadxMcpTransport.js +5 -3
- package/dist/android/JadxProtocol.js +14 -0
- package/dist/android/JadxProvider.js +15 -9
- package/dist/android/JadxRelease.js +12 -1
- package/dist/android/JadxWorkspaceRoot.js +157 -0
- package/dist/apktool/ApktoolConfiguration.js +165 -22
- package/dist/apktool/ApktoolDecodeOutput.js +124 -41
- package/dist/apktool/ApktoolProvider.js +70 -33
- package/dist/application/AnalysisContextQueries.js +5 -8
- package/dist/application/AnalysisProvider.js +24 -20
- package/dist/application/AppBundleExecutable.js +5 -5
- package/dist/application/BinaryTargetResolver.js +195 -38
- package/dist/application/BrowserEvidence.js +1 -1
- package/dist/application/BrowserObservationService.js +13 -2
- package/dist/application/BrowserScenarioCaptureService.js +0 -1
- package/dist/application/CallPathTracing.js +52 -13
- package/dist/application/CapabilityInventory.js +168 -28
- package/dist/application/ClaudeDesktopConfigLocation.js +152 -0
- package/dist/application/ClientConfigurationDocument.js +102 -25
- package/dist/application/ClientConfigurationFiles.js +51 -14
- package/dist/application/ClientRegistrationEnvironment.js +10 -4
- package/dist/application/ClientRegistrationIdentity.js +94 -29
- package/dist/application/ClientRegistrationStatus.js +180 -59
- package/dist/application/DirectAnalysis.js +85 -30
- package/dist/application/DirectAnalysisStatus.js +13 -1
- package/dist/application/Doctor.js +113 -32
- package/dist/application/DoctorDiagnostics.js +34 -12
- package/dist/application/DoctorProviderIds.js +2 -0
- package/dist/application/DoctorScope.js +11 -2
- package/dist/application/DshCordisPatch.js +355 -0
- package/dist/application/DshCordisYaml.js +155 -0
- package/dist/application/EnhancedLiteralTracing.js +30 -16
- package/dist/application/EnhancedToolTypes.js +0 -1
- package/dist/application/EnhancedTools.js +164 -54
- package/dist/application/EvidenceBundleCommands.js +30 -7
- package/dist/application/EvidenceBundleFiles.js +29 -7
- package/dist/application/FunctionAnalysisEvidence.js +3 -0
- package/dist/application/GeminiClientSettings.js +25 -13
- package/dist/application/HermesConfigurationYaml.js +272 -0
- package/dist/application/InventoryProjectionEvidence.js +0 -1
- package/dist/application/InvestigationProviders.js +13 -3
- package/dist/application/JsonFiles.js +110 -20
- package/dist/application/JsonInputFile.js +220 -62
- package/dist/application/LinuxHopper.js +126 -48
- package/dist/application/MacHopper.js +21 -17
- package/dist/application/MacHopperPaths.js +40 -0
- package/dist/application/{MipsElfAbiFlags.js → MipsElfMetadata.js} +70 -9
- package/dist/application/MipsElfSharedLoad.js +164 -0
- package/dist/application/MipsGnuAttributes.js +90 -0
- package/dist/application/MsixPackageStorage.js +133 -0
- package/dist/application/ProgressReporter.js +1 -1
- package/dist/application/ProviderOperationExecution.js +11 -3
- package/dist/application/ReconstructionCoverageService.js +0 -1
- package/dist/application/ReconstructionObligationCandidates.js +3 -2
- package/dist/application/ReconstructionObligationLedgerDiagnostics.js +2 -2
- package/dist/application/ReconstructionObligationLedgerEvaluation.js +15 -33
- package/dist/application/ReconstructionObligationLedgerProjection.js +3 -72
- package/dist/application/ReconstructionObligationLedgerService.js +3 -1
- package/dist/application/ReconstructionObligationOriginalCases.js +2 -1
- package/dist/application/ReferenceSourceImport.js +24 -8
- package/dist/application/ReferenceSourceImportEntries.js +22 -21
- package/dist/application/ReferenceSourceImportTypes.js +0 -1
- package/dist/application/ReferenceSourceVcsAdapter.js +33 -16
- package/dist/application/RegularFileRead.js +46 -18
- package/dist/application/Setup.js +36 -10
- package/dist/application/SetupClientConfiguration.js +206 -37
- package/dist/application/SetupClients.js +12 -6
- package/dist/application/SetupHost.js +66 -24
- package/dist/application/SetupInstallFailure.js +42 -2
- package/dist/application/SetupPlan.js +79 -50
- package/dist/application/SetupRecoveryBackup.js +66 -0
- package/dist/application/SetupRegistrationEnvironment.js +2 -1
- package/dist/application/SetupSkill.js +323 -76
- package/dist/application/SupportedClients.js +162 -28
- package/dist/application/TypeScriptEmittedSourceCandidates.js +26 -0
- package/dist/application/Uninstall.js +273 -82
- package/dist/application/UninstallFailure.js +14 -0
- package/dist/application/Update.js +54 -25
- package/dist/application/UpdateFailure.js +17 -0
- package/dist/application/UpdateMaintenance.js +11 -29
- package/dist/application/UpdateRuntime.js +141 -27
- package/dist/application/WebModuleTraceService.js +7 -0
- package/dist/application/WebNetworkCaptureService.js +16 -7
- package/dist/application/WebSourceLocationService.js +20 -4
- package/dist/application/WindowsCapabilities.js +18 -15
- package/dist/application/WorkflowEvidence.js +24 -1
- package/dist/application/analysisView/AnalysisViewService.js +90 -12
- package/dist/application/android/AndroidPackageInspection.js +25 -0
- package/dist/application/android/AndroidSearchEvidenceSummary.js +100 -0
- package/dist/application/binary/AnalysisProviderEvaluation.js +1 -1
- package/dist/application/binary/AnalysisProviderRegistry.js +36 -21
- package/dist/application/binary/AnalysisSnapshotCache.js +41 -20
- package/dist/application/binary/AnalysisSnapshotFiles.js +75 -9
- package/dist/application/binary/BinarySession.js +248 -96
- package/dist/application/binary/BinarySessionExecution.js +5 -4
- package/dist/application/binary/BinarySessionOpen.js +13 -6
- package/dist/application/binary/BinarySessionRecords.js +33 -7
- package/dist/application/binary/BinarySessionStatus.js +93 -23
- package/dist/application/binary/BinaryTargetSummary.js +9 -0
- package/dist/application/binary/CompositeProvider.js +71 -28
- package/dist/application/binary/LazyAnalysisProvider.js +3 -1
- package/dist/application/binary/SessionProviderRouter.js +5 -2
- package/dist/application/binaryDiagnostics/BinaryLayoutService.js +11 -1
- package/dist/application/binaryDiagnostics/PeResourcesService.js +3 -0
- package/dist/application/binaryDiagnostics/RecordedCrashService.js +14 -3
- package/dist/application/captures/PacketCaptureService.js +83 -0
- package/dist/application/closeOwnedWebResources.js +7 -0
- package/dist/application/electron/ElectronFusePort.js +1 -0
- package/dist/application/electron/ElectronFuseService.js +80 -0
- package/dist/application/evm/EvmInterfaceService.js +1 -0
- package/dist/application/flutter/DartAotInspection.js +26 -0
- package/dist/application/flutter/FlutterBuildAnalysisPort.js +1 -0
- package/dist/application/flutter/FlutterBuildAnalysisService.js +13 -0
- package/dist/application/frida/FridaInstrumentationPort.js +8 -0
- package/dist/application/frida/FridaInstrumentationService.js +310 -0
- package/dist/application/frida/fridaInputErrors.js +17 -0
- package/dist/application/go/GoBinaryPort.js +1 -0
- package/dist/application/go/GoBinaryService.js +80 -0
- package/dist/application/harmony/HarmonyApplicationService.js +17 -0
- package/dist/application/investigation/EvidenceLedger.js +40 -14
- package/dist/application/investigation/InvestigationRecords.js +12 -21
- package/dist/application/investigation/UnknownEvidence.js +22 -18
- package/dist/application/javascript/ElectronActiveObservationService.js +55 -25
- package/dist/application/javascript/ElectronBoundaryAnalysis.js +17 -3
- package/dist/application/javascript/ElectronBoundaryGraph.js +2 -0
- package/dist/application/javascript/ElectronBoundaryGraphCallPaths.js +144 -0
- package/dist/application/javascript/ElectronBoundaryGraphIpc.js +26 -7
- package/dist/application/javascript/ElectronBoundaryGraphNative.js +1 -1
- package/dist/application/javascript/ElectronBoundaryGraphWindows.js +47 -9
- package/dist/application/javascript/ElectronObservationService.js +0 -1
- package/dist/application/javascript/JavaScriptApplicationEvidence.js +15 -0
- package/dist/application/javascript/JavaScriptApplicationService.js +29 -14
- package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +0 -1
- package/dist/application/javascript/JavaScriptArtifactAnalysis.js +86 -34
- package/dist/application/javascript/JavaScriptArtifactGraphAccumulator.js +51 -21
- package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +31 -7
- package/dist/application/javascript/JavaScriptArtifactGraphContext.js +25 -4
- package/dist/application/javascript/JavaScriptArtifactGraphDocuments.js +25 -14
- package/dist/application/javascript/JavaScriptArtifactGraphFindings.js +147 -41
- package/dist/application/javascript/JavaScriptArtifactGraphStructure.js +156 -7
- package/dist/application/javascript/JavaScriptArtifactPathResolution.js +892 -181
- package/dist/application/javascript/JavaScriptArtifactReconstruction.js +43 -30
- package/dist/application/javascript/JavaScriptArtifactReconstructionInput.js +2 -0
- package/dist/application/javascript/JavaScriptModuleRelationships.js +33 -11
- package/dist/application/javascript/JavaScriptRecoveryService.js +29 -9
- package/dist/application/javascript/JavaScriptRuntimeObservationService.js +2 -1
- package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +0 -1
- package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +42 -26
- package/dist/application/javascript/JavaScriptSemanticGraphElectronProjection.js +67 -0
- package/dist/application/javascript/JavaScriptSemanticTraceService.js +0 -1
- package/dist/application/managed/ManagedApplicationGraphService.js +0 -1
- package/dist/application/managed/ManagedMemberComparisonService.js +72 -54
- package/dist/application/managed/ManagedNativeVerificationService.js +0 -1
- package/dist/application/managed/ManagedReconstructionService.js +0 -1
- package/dist/application/native/NativeCallRoutes.js +54 -34
- package/dist/application/native/NativeDispatchMetadataInspection.js +6 -2
- package/dist/application/native/NativeUiActionTrace.js +35 -22
- package/dist/application/native/NativeValueTrace.js +57 -23
- package/dist/application/pcap/PcapAnalysisPort.js +1 -0
- package/dist/application/pcap/PcapAnalysisService.js +24 -0
- package/dist/application/process/ProcessCli.js +33 -13
- package/dist/application/reverse/ReverseEngineeringCommandPort.js +1 -0
- package/dist/application/reverse/ReverseEngineeringService.js +688 -0
- package/dist/application/rust/RustBinaryPort.js +1 -0
- package/dist/application/rust/RustBinaryService.js +80 -0
- package/dist/application/signals/SignalRecordingService.js +83 -0
- package/dist/application/sqlite/SqliteDatabaseCapability.js +30 -0
- package/dist/application/sqlite/SqliteDatabasePort.js +1 -0
- package/dist/application/sqlite/SqliteDatabaseService.js +76 -0
- package/dist/application/wasm/WasmArtifactPort.js +1 -0
- package/dist/application/wasm/WasmArtifactService.js +77 -0
- package/dist/application/wasm/WasmInterfaceComparisonService.js +188 -0
- package/dist/artifacts/ArtifactHash.js +13 -2
- package/dist/artifacts/ArtifactPaths.js +4 -7
- package/dist/artifacts/ArtifactProvider.js +8 -4
- package/dist/artifacts/ArtifactReader.js +13 -1
- package/dist/artifacts/ArtifactResourceScope.js +12 -3
- package/dist/artifacts/AsarArtifactReader.js +177 -112
- package/dist/artifacts/AsarListing.js +78 -0
- package/dist/artifacts/DirectoryArtifactReader.js +94 -24
- package/dist/artifacts/MachOSliceArtifactReader.js +83 -10
- package/dist/artifacts/NativeDmgArtifactReader.js +161 -58
- package/dist/artifacts/OrderedReads.js +57 -0
- package/dist/artifacts/SafeOutputTree.js +19 -4
- package/dist/artifacts/ZipArtifactReader.js +117 -12
- package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +77 -68
- package/dist/artifacts/apple/DylibResolutionReader.js +11 -5
- package/dist/artifacts/apple/InterfaceBuilderAnalysis.js +57 -21
- package/dist/artifacts/apple/InterfaceBuilderDecodeBudget.js +64 -12
- package/dist/artifacts/apple/KeyedArchiveReader.js +3 -2
- package/dist/artifacts/apple/MachoLoadCommandReader.js +62 -61
- package/dist/artifacts/apple/NibArchive.js +11 -4
- package/dist/artifacts/apple/PlistNumberLiterals.js +2 -2
- package/dist/artifacts/extraction/ArtifactExtraction.js +6 -7
- package/dist/artifacts/hostExecutableMarking.js +16 -0
- package/dist/artifacts/inventory/ArtifactGraphConstruction.js +134 -34
- package/dist/artifacts/inventory/ArtifactInventory.js +2 -2
- package/dist/artifacts/inventory/classify.js +32 -15
- package/dist/artifacts/inventory/reader.js +36 -21
- package/dist/artifacts/inventory/scanCanonical.js +25 -18
- package/dist/artifacts/inventory/scanReader.js +36 -10
- package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +163 -7
- package/dist/artifacts/readStableArtifact.js +28 -4
- package/dist/browser/BrowserProcessStartup.js +20 -9
- package/dist/browser/BrowserScenarioPartialObservation.js +60 -44
- package/dist/browser/BrowserScenarioSecrets.js +176 -46
- package/dist/browser/CdpBrowserProvider.js +70 -99
- package/dist/browser/CdpCaptureDocuments.js +231 -69
- package/dist/browser/CdpCaptureDomSvg.js +94 -61
- package/dist/browser/CdpCaptureEventBodyShapes.js +9 -5
- package/dist/browser/CdpCaptureEventHandlers.js +23 -12
- package/dist/browser/CdpCaptureEvents.js +49 -10
- package/dist/browser/CdpCaptureStorage.js +22 -5
- package/dist/browser/CdpCaptureStorageFingerprints.js +54 -11
- package/dist/browser/CdpCaptureValues.js +0 -1
- package/dist/browser/CdpConnection.js +3 -4
- package/dist/browser/CdpElectronInspection.js +14 -4
- package/dist/browser/CdpElectronProvider.js +7 -2
- package/dist/browser/CdpElectronScripts.js +2 -1
- package/dist/browser/CdpElectronWorkers.js +7 -2
- package/dist/browser/CdpEndpoint.js +143 -17
- package/dist/browser/CdpObservationSession.js +24 -8
- package/dist/browser/CdpPageCapture.js +66 -16
- package/dist/browser/CdpPageCaptureScripts.js +4 -3
- package/dist/browser/CdpPageCaptureWorkers.js +5 -1
- package/dist/browser/CdpSafeMetadata.js +9 -5
- package/dist/browser/CdpScreenshot.js +5 -14
- package/dist/browser/CdpSnapshotStrings.js +21 -0
- package/dist/browser/CdpTargetSession.js +29 -2
- package/dist/browser/CdpWebMcpDiscovery.js +23 -6
- package/dist/browser/PlaywrightBrowserScenarioProvider.js +4 -4
- package/dist/browser/PlaywrightElectronActiveActions.js +4 -4
- package/dist/browser/PlaywrightElectronActiveProjection.js +16 -4
- package/dist/browser/PlaywrightElectronActiveProvider.js +103 -30
- package/dist/browser/PlaywrightExecutionBoundary.js +2 -2
- package/dist/browser/PlaywrightScenarioBrowser.js +9 -6
- package/dist/browser/PlaywrightScenarioEvents.js +198 -36
- package/dist/browser/PlaywrightScenarioServiceWorkers.js +249 -0
- package/dist/browser/PlaywrightScenarioSession.js +61 -29
- package/dist/browser/WebSourceMapFetcher.js +163 -80
- package/dist/browser/assets/LocalWebScriptArtifacts.js +24 -3
- package/dist/browser/assets/PublishWebScripts.js +13 -2
- package/dist/browser/assets/ScenarioScriptCapture.js +2 -1
- package/dist/browser/assets/WebArtifactReads.js +11 -3
- package/dist/browser/assets/WebSourceLocationArtifacts.js +38 -3
- package/dist/browser/history/CaptureFailures.js +22 -8
- package/dist/browser/history/CaptureFormatError.js +2 -2
- package/dist/browser/history/{HarJson.js → CaptureJson.js} +14 -4
- package/dist/browser/history/CaptureRedaction.js +16 -3
- package/dist/browser/history/CaptureRelease.js +20 -2
- package/dist/browser/history/HarCapture.js +16 -23
- package/dist/browser/history/HarSchema.js +36 -36
- package/dist/browser/history/HistoricalCaptureDecoder.js +93 -25
- package/dist/browser/history/NodeCaptureAdapter.js +48 -0
- package/dist/browser/history/{HarCaptureProcess.js → NodeCaptureProcess.js} +18 -9
- package/dist/browser/history/QlogCapture.js +385 -0
- package/dist/browser/history/SazCapture.js +130 -0
- package/dist/browser/history/SazHttp.js +61 -0
- package/dist/browser/history/SazMetadata.js +92 -0
- package/dist/browser/history/SazProjection.js +90 -0
- package/dist/browser/modules/NativeModuleResolver.js +177 -110
- package/dist/browser/modules/WebModuleArtifacts.js +40 -3
- package/dist/browser/network/PlaywrightNetworkContent.js +40 -5
- package/dist/browser/network/PlaywrightScenarioNetwork.js +125 -11
- package/dist/captures/TsharkCaptureProvider.js +370 -0
- package/dist/captures/parseFieldDiscovery.js +66 -0
- package/dist/captures/parsePacketOutput.js +21 -0
- package/dist/catalogIdentity.js +46 -35
- package/dist/cli/adbCommands.js +2 -2
- package/dist/cli/analysisViewCommands.js +1 -1
- package/dist/cli/androidCommands.js +11 -2
- package/dist/cli/apktoolCommands.js +10 -11
- package/dist/cli/applicationCommands.js +44 -17
- package/dist/cli/artifactCommands.js +1 -1
- package/dist/cli/binaryDiagnosticsCommands.js +14 -10
- package/dist/cli/browserAdvancedCommands.js +37 -24
- package/dist/cli/browserCommands.js +46 -29
- package/dist/cli/captureCommands.js +72 -0
- package/dist/cli/cliResultOutput.js +188 -0
- package/dist/cli/coreBinaryCommands.js +73 -27
- package/dist/cli/coreNativeCommands.js +53 -31
- package/dist/cli/cutterCommands.js +50 -0
- package/dist/cli/electronCommands.js +45 -3
- package/dist/cli/evmCommands.js +4 -5
- package/dist/cli/finishAnalysisCommand.js +44 -0
- package/dist/cli/firmwareCommands.js +14 -36
- package/dist/cli/flutterCommands.js +69 -0
- package/dist/cli/fridaCommands.js +211 -0
- package/dist/cli/goCommands.js +20 -0
- package/dist/cli/interactiveSetup.js +11 -1
- package/dist/cli/javascriptApplicationAnalysis.js +1 -1
- package/dist/cli/javascriptRecoveryCommands.js +7 -0
- package/dist/cli/jsonOutput.js +2 -2
- package/dist/cli/managedCommands.js +31 -3
- package/dist/cli/options.js +20 -2
- package/dist/cli/pcapCommands.js +47 -0
- package/dist/cli/processCommands.js +1 -1
- package/dist/cli/reverseEngineeringCommands.js +268 -0
- package/dist/cli/rustCommands.js +21 -0
- package/dist/cli/setupCommands.js +40 -12
- package/dist/cli/signalCommands.js +72 -0
- package/dist/cli/sqliteCommands.js +79 -0
- package/dist/cli/utilityCommands.js +116 -74
- package/dist/cli/wasmCommands.js +61 -0
- package/dist/cli/webModuleCommands.js +36 -32
- package/dist/cli/webNetworkCaptureCommands.js +8 -8
- package/dist/cli-runtime/AbortablePromise-BVBemxbD.js +123 -0
- package/dist/cli-runtime/AnalysisProvider-D0Us2OTk.js +27 -0
- package/dist/cli-runtime/AnalysisSnapshotCache-BXS0wRd2.js +710 -0
- package/dist/cli-runtime/ArtifactReader-BXkffc1D.js +55 -0
- package/dist/cli-runtime/ArtifactResourceScope-DQWTcUwE.js +114 -0
- package/dist/cli-runtime/AsarHeader-CnzOzYEH.js +31 -0
- package/dist/cli-runtime/BinarySessionStatus-DnMxMk-r.js +211 -0
- package/dist/cli-runtime/BinaryTargetResolver-CVIJ_s1A.js +1308 -0
- package/dist/cli-runtime/BoundedFileBytes-BU30odTm.js +39 -0
- package/dist/cli-runtime/CdpTargetSession-DGX5pV9w.js +650 -0
- package/dist/cli-runtime/ClientConfigPath-c6jr6INc.js +36 -0
- package/dist/cli-runtime/ClientConfigurationDocument-ffQ9X0Se.js +1957 -0
- package/dist/cli-runtime/ClientRegistrationStatus-DszCyPEU.js +509 -0
- package/dist/cli-runtime/CurrentEntrypointPath-D5FRNdkq.js +14 -0
- package/dist/cli-runtime/DirectAnalysis-BgvAtpN3.js +528 -0
- package/dist/cli-runtime/Doctor-DIpf_I7N.js +588 -0
- package/dist/cli-runtime/ElectronFileScope-dpHm2nrS.js +1054 -0
- package/dist/cli-runtime/ExecFileOutput-BEQs-lDD.js +117 -0
- package/dist/cli-runtime/IdaConfiguration-CtGP7EKo.js +1094 -0
- package/dist/cli-runtime/InterfaceBuilderDecodeBudget-D4omRUe4.js +279 -0
- package/dist/cli-runtime/InventoryProjectionEvidence-DIsI4DJ6.js +49 -0
- package/dist/cli-runtime/InvestigationProviders-DoQRIHii.js +117 -0
- package/dist/cli-runtime/JavaScriptApplicationEvidenceGraph-D5aI_FSJ.js +160 -0
- package/dist/cli-runtime/JavaScriptApplicationWorkflowEvidence-Bz4-V0Ct.js +75 -0
- package/dist/cli-runtime/JavaScriptWorkerMemoryLimit-B1bwMM1a.js +86 -0
- package/dist/cli-runtime/JebMcpEndpoint-DUytrn5G.js +428 -0
- package/dist/cli-runtime/JsonFiles-DQa1PRKy.js +708 -0
- package/dist/cli-runtime/MacCodeSignature-MgYbRK_H.js +24 -0
- package/dist/cli-runtime/MacHopperPaths-CwL5lYPX.js +434 -0
- package/dist/cli-runtime/MachoLoadCommandReader-C7e074Ze.js +510 -0
- package/dist/cli-runtime/ManagedSnapshot-rqyBHcdL.js +4185 -0
- package/dist/cli-runtime/OwnedCommand-Cj9GhmPR.js +112 -0
- package/dist/cli-runtime/PrivateRuntimeRoot-DAy0PiBM.js +263 -0
- package/dist/cli-runtime/ProcessOwnership-DXC5-UWt.js +1378 -0
- package/dist/cli-runtime/ProviderDeadline-8m2pFRDc.js +122 -0
- package/dist/cli-runtime/RegularFile-B_6KPCNQ.js +139 -0
- package/dist/cli-runtime/RegularFileRead-DVlC5faM.js +125 -0
- package/dist/cli-runtime/SafeOutputTree-D6U15GXd.js +524 -0
- package/dist/cli-runtime/SetupHost-FkYWswsq.js +1098 -0
- package/dist/cli-runtime/SupportedClients-DaX6Lt2d.js +1049 -0
- package/dist/cli-runtime/UninstallFailure-1blyKXHE.js +22 -0
- package/dist/cli-runtime/Update-CbTC_eg1.js +143 -0
- package/dist/cli-runtime/UpdateFailure-BcFNxEZZ.js +24 -0
- package/dist/cli-runtime/ZipArtifactReader-B8ZgNe4D.js +248 -0
- package/dist/cli-runtime/analysisErrorCleanup-Do6YeeoD.js +32 -0
- package/dist/cli-runtime/analysisErrorPresentation-DGt7TdsH.js +497 -0
- package/dist/cli-runtime/appleArchiveFormat-tVoI2ykA.js +263 -0
- package/dist/cli-runtime/application__DirectAnalysisStatus-DpOejOf0.js +150 -0
- package/dist/cli-runtime/application__EnhancedTools-oFE2bOjs.js +1787 -0
- package/dist/cli-runtime/application__FunctionAnalysisEvidence-B6osuhvW.js +41 -0
- package/dist/cli-runtime/application__ReconstructionCoverageService-DN3wTFQj.js +32 -0
- package/dist/cli-runtime/application__ReconstructionObligationLedgerService-CKcTppX9.js +815 -0
- package/dist/cli-runtime/application__Setup-XpMaRNjy.js +514 -0
- package/dist/cli-runtime/application__Uninstall-_23pU2yB.js +427 -0
- package/dist/cli-runtime/application__UpdateRuntime-DPvY8ohd.js +345 -0
- package/dist/cli-runtime/application__android__AndroidApplicationService-CFgIFPM4.js +31 -0
- package/dist/cli-runtime/application__apple__AppleApplicationService-Db6QCsun.js +31 -0
- package/dist/cli-runtime/application__harmony__HarmonyApplicationService-CFjocHoK.js +31 -0
- package/dist/cli-runtime/application__javascript__ElectronActiveObservationService-CmVDUI_Z.js +118 -0
- package/dist/cli-runtime/application__javascript__ElectronObservationService-DEsR8KDN.js +63 -0
- package/dist/cli-runtime/application__javascript__JavaScriptApplicationService-CCkp8KBh.js +11450 -0
- package/dist/cli-runtime/application__javascript__JavaScriptApplicationWorkflowService-lPy0tzr3.js +2329 -0
- package/dist/cli-runtime/application__javascript__JavaScriptRuntimeReconciliationService-DWleA8K9.js +88 -0
- package/dist/cli-runtime/application__javascript__JavaScriptSemanticTraceService-DkALH4rL.js +299 -0
- package/dist/cli-runtime/artifactOperationError-B7n03FbD.js +27 -0
- package/dist/cli-runtime/artifacts__ArtifactProvider-zXI0QjSL.js +2187 -0
- package/dist/cli-runtime/binary-BVOr2mgE.js +14206 -0
- package/dist/cli-runtime/browserObservationError-Dx6xRTjb.js +40 -0
- package/dist/cli-runtime/catalogIdentity-DLoXgfIR.js +933 -0
- package/dist/cli-runtime/cli.js +41848 -0
- package/dist/cli-runtime/cliOutput-BC1BdAcB.js +122 -0
- package/dist/cli-runtime/cliOutput.js +5 -0
- package/dist/cli-runtime/cliResultOutput-DsRMI8CJ.js +780 -0
- package/dist/cli-runtime/cliResultOutput.js +5 -0
- package/dist/cli-runtime/composition__browserScenario-DHXC1a8n.js +2927 -0
- package/dist/cli-runtime/composition__electronObservation-GecK2EID.js +555 -0
- package/dist/cli-runtime/composition__electronScenario-CEZnVrAL.js +653 -0
- package/dist/cli-runtime/cutterToolContracts-TZH9EHr5.js +5134 -0
- package/dist/cli-runtime/doctorRuntime-BE5ZX8it.js +258 -0
- package/dist/cli-runtime/dotnet__ManagedStaticProvider-C8_yZCDc.js +5 -0
- package/dist/cli-runtime/errorSchemas-CTRmvMl3.js +601 -0
- package/dist/cli-runtime/javascriptApplicationAnalysis-HgMzVMQw.js +2068 -0
- package/dist/cli-runtime/javascriptExportReturnShapeProjection-Dg00g35t.js +78 -0
- package/dist/cli-runtime/javascriptExportShapeComparisonSchemas-BYnoIqIk.js +1242 -0
- package/dist/cli-runtime/javascriptRuntimeReconciliation-DNjDoL3S.js +1507 -0
- package/dist/cli-runtime/javascriptRuntimeReconciliationSchemas-BWpGWNcI.js +247 -0
- package/dist/cli-runtime/javascriptSemanticTraceSchemas-BTCNcvbc.js +126 -0
- package/dist/cli-runtime/lipo-DSWP6fv-.js +396 -0
- package/dist/cli-runtime/logger-CQQCI4a2.js +48 -0
- package/dist/cli-runtime/machoContainer-C8BIkkq3.js +172 -0
- package/dist/cli-runtime/managedApplicationGraph-B08jb3jq.js +1130 -0
- package/dist/cli-runtime/managedToolContracts-D60QmIYj.js +99 -0
- package/dist/cli-runtime/mcpDoctor.js +359 -0
- package/dist/cli-runtime/mcpStartupPolicy-CVVSOmRc.js +21 -0
- package/dist/cli-runtime/native__NativeMacOSProvider-YBTvUeJO.js +4875 -0
- package/dist/cli-runtime/officialToolContracts-CCFF0an9.js +1501 -0
- package/dist/cli-runtime/propertyListKeys-G8e74YWb.js +248 -0
- package/dist/cli-runtime/providerAdapterError-DAjhICdr.js +25 -0
- package/dist/cli-runtime/providerCleanupError-Ceq8f0wK.js +27 -0
- package/dist/cli-runtime/providerIdentities-Ao1XTvwx.js +31 -0
- package/dist/cli-runtime/providerStartupTimeout-B2tF2LtZ.js +17 -0
- package/dist/cli-runtime/readFileHandleChunks-dp60iZ6v.js +38 -0
- package/dist/cli-runtime/reconstructionObligationLedgerSchemas-Bao0xMr-.js +19478 -0
- package/dist/cli-runtime/rolldown-runtime-DXoylpqc.js +121 -0
- package/dist/cli-runtime/runtimeVersion-CMGd0bDu.js +23 -0
- package/dist/cli-runtime/safeJson-DKKACtdy.js +25 -0
- package/dist/cli-runtime/scanCanonical-KP4T9jSl.js +2724 -0
- package/dist/cli-runtime/snapshotEnvironment-D_tWyOub.js +813 -0
- package/dist/cli-runtime/toolContracts-D2FOG_Nb.js +3721 -0
- package/dist/cli-runtime/toolOutputSchemaGroups-DRiYs1je.js +12070 -0
- package/dist/cli-runtime/workflowInputError-n8Oo-bLA.js +26 -0
- package/dist/cli.js +38 -5
- package/dist/cliBrowserScenarioCommands.js +39 -4
- package/dist/cliCommandNames.js +48 -0
- package/dist/cliEvidenceCommands.js +0 -1
- package/dist/cliJavaScriptRuntimeCommands.js +16 -14
- package/dist/cliJsonInput.js +12 -4
- package/dist/cliLogging.js +50 -14
- package/dist/cliObservationOptions.js +6 -0
- package/dist/cliOutput.js +38 -5
- package/dist/composition/binary.js +4 -0
- package/dist/composition/captures.js +3 -0
- package/dist/composition/directAnalysis.js +28 -11
- package/dist/composition/electronFuses.js +4 -0
- package/dist/composition/evm.js +12 -0
- package/dist/composition/flutter.js +3 -0
- package/dist/composition/go.js +4 -0
- package/dist/composition/javascriptAnalysisWorkerProcess.js +5 -4
- package/dist/composition/jeb.js +33 -4
- package/dist/composition/pcap.js +3 -0
- package/dist/composition/resolveWindowsProviderExecutable.js +61 -0
- package/dist/composition/reverseEngineering.js +29 -0
- package/dist/composition/rust.js +4 -0
- package/dist/composition/signals.js +3 -0
- package/dist/composition/sqlite.js +4 -0
- package/dist/composition/wasm.js +22 -0
- package/dist/composition/webNetworkCaptures.js +7 -2
- package/dist/config/environment.js +45 -4
- package/dist/config/ghidraDisabledAnalyzers.js +25 -0
- package/dist/config/homeDirectory.js +9 -6
- package/dist/config/mcpInputSchemaProfile.js +4 -0
- package/dist/config/mcpOutputSchemaProfile.js +22 -0
- package/dist/config/parseConfig.js +21 -31
- package/dist/config/parsers.js +4 -3
- package/dist/config/{ghidraStartupTimeout.js → providerStartupTimeout.js} +7 -3
- package/dist/contracts/adb/adbToolContracts.js +7 -7
- package/dist/contracts/analysisDetail.js +6 -3
- package/dist/contracts/analysisViewApiSurfaceExample.js +68 -0
- package/dist/contracts/analysisViewToolContracts.js +24 -3
- package/dist/contracts/android/androidToolContracts.js +17 -8
- package/dist/contracts/applicationToolContracts.js +17 -2
- package/dist/contracts/artifactToolContracts.js +14 -2
- package/dist/contracts/browserToolContracts.js +1 -0
- package/dist/contracts/captures/captureToolContracts.js +42 -0
- package/dist/contracts/compactInputSchema.js +26 -6
- package/dist/contracts/cutterToolContracts.js +84 -0
- package/dist/contracts/enhancedToolContracts.js +2 -2
- package/dist/contracts/evm/evmToolContracts.js +30 -15
- package/dist/contracts/firmware/firmwareToolContracts.js +1 -1
- package/dist/contracts/flutter/flutterToolContracts.js +47 -0
- package/dist/contracts/fridaRemoteAddress.js +23 -0
- package/dist/contracts/fridaToolContracts.js +273 -0
- package/dist/contracts/functionComparisonExample.js +12 -1
- package/dist/contracts/gdbToolContracts.js +103 -0
- package/dist/contracts/go/goToolContracts.js +20 -0
- package/dist/contracts/hopperMemoryContracts.js +15 -0
- package/dist/contracts/inputSchemaPresentation.js +81 -14
- package/dist/contracts/investigationExamples.js +1 -0
- package/dist/contracts/javascript/electronToolContracts.js +27 -2
- package/dist/contracts/javascript/javascriptRecoveryToolContracts.js +13 -1
- package/dist/contracts/managed/managedToolContracts.js +43 -4
- package/dist/contracts/managed/managedWorkflowExamples.js +7 -1
- package/dist/contracts/managed/managedWorkflowToolContracts.js +4 -30
- package/dist/contracts/mobileApplicationGraphExamples.js +12 -0
- package/dist/contracts/native/binaryDiagnosticsToolContracts.js +3 -2
- package/dist/contracts/native/nativeToolContracts.js +10 -6
- package/dist/contracts/officialToolContracts.js +5 -5
- package/dist/contracts/pcap/pcapToolContracts.js +33 -0
- package/dist/contracts/providerSelection.js +1 -0
- package/dist/contracts/reconstructionReadinessExample.js +126 -119
- package/dist/contracts/reverseEngineeringToolContracts.js +52 -0
- package/dist/contracts/rizinDebugToolContracts.js +96 -0
- package/dist/contracts/rust/rustToolContracts.js +20 -0
- package/dist/contracts/sessionLifecycleInputs.js +34 -2
- package/dist/contracts/sessionToolContracts.js +2 -2
- package/dist/contracts/sessionToolSchemas.js +14 -0
- package/dist/contracts/signals/signalToolContracts.js +40 -0
- package/dist/contracts/sqlite/sqliteToolContracts.js +36 -0
- package/dist/contracts/toolContractExamples.js +29 -0
- package/dist/contracts/toolContractTypes.js +2 -0
- package/dist/contracts/toolContracts.js +26 -0
- package/dist/contracts/toolEffects.js +247 -8
- package/dist/contracts/toolOutputSchemaGroups.js +75 -32
- package/dist/contracts/toolOutputSchemaPrimitives.js +111 -10
- package/dist/contracts/toolSchemaMetadata.js +16 -2
- package/dist/contracts/unknownContractExamples.js +1 -1
- package/dist/contracts/wasm/wasmComparisonContracts.js +52 -0
- package/dist/contracts/wasm/wasmToolContracts.js +33 -0
- package/dist/contracts/webNetworkCaptureToolContracts.js +15 -4
- package/dist/cutter/CutterBridgeClient.js +621 -0
- package/dist/cutter/CutterBridgeService.js +139 -0
- package/dist/doctorRuntime.js +20 -8
- package/dist/domain/adb/adbDeviceAnalysis.js +26 -4
- package/dist/domain/analysisErrorBase.js +20 -0
- package/dist/domain/analysisErrorCleanup.js +1 -1
- package/dist/domain/analysisErrorCore.js +19 -0
- package/dist/domain/analysisErrorPresentation.js +58 -17
- package/dist/domain/analysisErrorProjection.js +31 -12
- package/dist/domain/analysisProfile.js +7 -3
- package/dist/domain/analysisSnapshot.js +311 -184
- package/dist/domain/analysisView/WebNetworkApiSurfaceAccumulator.js +414 -0
- package/dist/domain/analysisView/analysisView.js +366 -44
- package/dist/domain/analysisView/analysisViewCoverage.js +32 -0
- package/dist/domain/analysisView/analysisViewErrors.js +4 -0
- package/dist/domain/analysisView/analysisViewParent.js +12 -0
- package/dist/domain/analysisView/analysisViewText.js +29 -0
- package/dist/domain/analysisView/androidPackageView.js +102 -0
- package/dist/domain/analysisView/artifactInventoryView.js +140 -0
- package/dist/domain/analysisView/binaryLayoutView.js +11 -4
- package/dist/domain/analysisView/dartAotView.js +93 -0
- package/dist/domain/analysisView/evmInterfaceView.js +105 -0
- package/dist/domain/analysisView/interfaceBuilderView.js +182 -0
- package/dist/domain/analysisView/javascriptApplicationView.js +29 -28
- package/dist/domain/analysisView/machoView.js +186 -0
- package/dist/domain/analysisView/managedArtifactView.js +108 -0
- package/dist/domain/analysisView/managedMemberView.js +209 -0
- package/dist/domain/analysisView/nativeFunctionView.js +20 -25
- package/dist/domain/analysisView/pcapCaptureView.js +264 -0
- package/dist/domain/analysisView/qlogCaptureView.js +198 -0
- package/dist/domain/analysisView/wasmArtifactView.js +162 -0
- package/dist/domain/analysisView/webNetworkApiSurfaceView.js +123 -0
- package/dist/domain/analysisView/webNetworkCaptureView.js +388 -0
- package/dist/domain/android/androidAnalysis.js +36 -2
- package/dist/domain/android/androidApplication.js +32 -60
- package/dist/domain/apktool/apktoolResourceAnalysis.js +19 -7
- package/dist/domain/apple/appleApplication.js +31 -29
- package/dist/domain/apple/appleArchiveFormat.js +184 -0
- package/dist/domain/apple/appleAssetCatalog.js +15 -0
- package/dist/domain/apple/appleBundleAnatomy.js +1 -1
- package/dist/domain/apple/dyldPaths.js +9 -2
- package/dist/domain/apple/dylibResolution.js +19 -9
- package/dist/domain/apple/dylibResolutionFindings.js +8 -9
- package/dist/domain/apple/interfaceBuilderGraph.js +50 -26
- package/dist/domain/apple/interfaceBuilderKeyedArchive.js +28 -8
- package/dist/domain/apple/machoContainer.js +120 -8
- package/dist/domain/apple/machoCpuIdentity.js +4 -0
- package/dist/domain/apple/plistValue.js +6 -1
- package/dist/domain/artifactComparison.js +109 -32
- package/dist/domain/artifactDecompressionBudget.js +26 -0
- package/dist/domain/artifactGraph.js +23 -6
- package/dist/domain/artifactIdentity.js +4 -1
- package/dist/domain/artifactInspection.js +44 -2
- package/dist/domain/artifactInventoryEvidence.js +137 -39
- package/dist/domain/binaryTarget.js +251 -94
- package/dist/domain/binaryTargetTypes.js +14 -1
- package/dist/domain/browserNetworkEvidence.js +4 -0
- package/dist/domain/browserObservation.js +88 -29
- package/dist/domain/browserObservationSchemas.js +4 -1
- package/dist/domain/browserScenarioCapture.js +2 -1
- package/dist/domain/browserScenarioCaptureValues.js +26 -2
- package/dist/domain/browserScenarioDiff.js +120 -11
- package/dist/domain/browserScenarioDiffEvidence.js +46 -13
- package/dist/domain/browserScenarioDiffValues.js +10 -3
- package/dist/domain/browserScenarioNetworkComparison.js +158 -0
- package/dist/domain/browserScenarioNormalization.js +10 -13
- package/dist/domain/browserScenarioValues.js +2 -12
- package/dist/domain/browserSession.js +2 -2
- package/dist/domain/bundleComparison.js +1 -5
- package/dist/domain/callPath.js +40 -3
- package/dist/domain/captures/packetCapture.js +138 -0
- package/dist/domain/captures/packetFields.js +81 -0
- package/dist/domain/changedBehavior.js +43 -41
- package/dist/domain/comparisonSourceEvidence.js +6 -0
- package/dist/domain/dosCom.js +2 -2
- package/dist/domain/dosMz.js +52 -14
- package/dist/domain/electron/electronFuses.js +360 -0
- package/dist/domain/elfFixedHeader.js +42 -0
- package/dist/domain/evidence.js +103 -38
- package/dist/domain/evidenceBundle.js +58 -20
- package/dist/domain/evidenceErrors.js +5 -0
- package/dist/domain/evm/evmInterface.js +18 -4
- package/dist/domain/evm/solidityMetadata.js +70 -0
- package/dist/domain/explicitSensitiveFailure.js +42 -24
- package/dist/domain/firmware/firmwareAnalysis.js +29 -0
- package/dist/domain/flutter/flutterBuildAnalysis.js +141 -0
- package/dist/domain/functionCallCoverage.js +60 -0
- package/dist/domain/functionComparisonDimensions.js +101 -10
- package/dist/domain/functionComparisonNormalization.js +66 -10
- package/dist/domain/functionComparisonResults.js +7 -6
- package/dist/domain/functionComparisonSchemas.js +14 -3
- package/dist/domain/functionDossierEvidence.js +3 -0
- package/dist/domain/go/goBinary.js +96 -0
- package/dist/domain/harmony/harmonyApplication.js +156 -0
- package/dist/domain/hopperErrors.js +15 -16
- package/dist/domain/hopperPublisher.js +12 -0
- package/dist/domain/hopperValues.js +112 -34
- package/dist/domain/javascript/electronObservation.js +4 -1
- package/dist/domain/javascript/electronStaticAnalysisBrowser.js +15 -14
- package/dist/domain/javascript/electronStaticAnalysisIpc.js +3 -1
- package/dist/domain/javascript/electronStaticAnalysisNative.js +19 -5
- package/dist/domain/javascript/electronStaticAnalysisValues.js +14 -8
- package/dist/domain/javascript/electronWrappedCallPaths.js +498 -0
- package/dist/domain/javascript/htmlArtifactReferences.js +94 -4
- package/dist/domain/javascript/javascriptAnalysisResourceControls.js +21 -1
- package/dist/domain/javascript/javascriptApplicationAnalysis.js +3 -0
- package/dist/domain/javascript/javascriptApplicationChangeGraph.js +7 -2
- package/dist/domain/javascript/javascriptApplicationEvidenceSchemas.js +1 -1
- package/dist/domain/javascript/javascriptApplicationGraph.js +17 -1
- package/dist/domain/javascript/javascriptApplicationGraphSchemas.js +1 -0
- package/dist/domain/javascript/javascriptApplicationProjectionResources.js +8 -0
- package/dist/domain/javascript/javascriptApplicationVersionKeys.js +31 -18
- package/dist/domain/javascript/javascriptArtifactFiles.js +2 -1
- package/dist/domain/javascript/javascriptAstFingerprint.js +51 -17
- package/dist/domain/javascript/javascriptAstValues.js +52 -3
- package/dist/domain/javascript/javascriptBootstrap.js +94 -0
- package/dist/domain/javascript/javascriptBootstrapIntegrity.js +372 -0
- package/dist/domain/javascript/javascriptBuiltinResourceMethods.js +8 -0
- package/dist/domain/javascript/javascriptBundledRequireOrigin.js +291 -0
- package/dist/domain/javascript/javascriptContextBridgeExposure.js +23 -0
- package/dist/domain/javascript/javascriptElectronMemberWrites.js +86 -22
- package/dist/domain/javascript/javascriptExportShapeComparisonSchemas.js +6 -5
- package/dist/domain/javascript/javascriptExportShapeVariants.js +1 -1
- package/dist/domain/javascript/javascriptFeatureSeed.js +33 -16
- package/dist/domain/javascript/javascriptFeatureTrace.js +9 -3
- package/dist/domain/javascript/javascriptFeatureTraceSchemas.js +42 -11
- package/dist/domain/javascript/javascriptIntrinsicInvocation.js +132 -0
- package/dist/domain/javascript/javascriptModuleDeclaration.js +28 -0
- package/dist/domain/javascript/javascriptModuleInterop.js +618 -0
- package/dist/domain/javascript/javascriptModuleResolutionMode.js +18 -0
- package/dist/domain/javascript/javascriptModuleSpecifier.js +5 -0
- package/dist/domain/javascript/javascriptNativeHandoff.js +0 -1
- package/dist/domain/javascript/javascriptPackageImportAliases.js +58 -0
- package/dist/domain/javascript/javascriptRecovery.js +12 -5
- package/dist/domain/javascript/javascriptRpcEndpoints.js +119 -41
- package/dist/domain/javascript/javascriptRuntimeLoadState.js +11 -0
- package/dist/domain/javascript/javascriptRuntimeObservation.js +4 -1
- package/dist/domain/javascript/javascriptRuntimeReconciliationCaptureParsing.js +10 -4
- package/dist/domain/javascript/javascriptRuntimeReconciliationMatching.js +15 -2
- package/dist/domain/javascript/javascriptRuntimeReconciliationResult.js +0 -1
- package/dist/domain/javascript/javascriptRuntimeReconciliationSchemas.js +5 -4
- package/dist/domain/javascript/javascriptRuntimeStaticCandidates.js +113 -11
- package/dist/domain/javascript/javascriptSemanticAmbientWrites.js +251 -0
- package/dist/domain/javascript/javascriptSemanticAnalysis.js +340 -108
- package/dist/domain/javascript/javascriptSemanticAsyncEffects.js +17 -34
- package/dist/domain/javascript/javascriptSemanticCallResolution.js +4 -3
- package/dist/domain/javascript/javascriptSemanticCallableStack.js +52 -0
- package/dist/domain/javascript/javascriptSemanticCalls.js +6 -11
- package/dist/domain/javascript/javascriptSemanticChildProcesses.js +42 -55
- package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +428 -32
- package/dist/domain/javascript/javascriptSemanticDataEffects.js +14 -20
- package/dist/domain/javascript/javascriptSemanticDependencies.js +69 -0
- package/dist/domain/javascript/javascriptSemanticFingerprints.js +11 -14
- package/dist/domain/javascript/javascriptSemanticGraph.js +5 -1
- package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +0 -1
- package/dist/domain/javascript/javascriptSemanticIterationSources.js +2 -2
- package/dist/domain/javascript/javascriptSemanticMemberMutations.js +224 -91
- package/dist/domain/javascript/javascriptSemanticMutationInitializers.js +199 -3
- package/dist/domain/javascript/javascriptSemanticObjectReferences.js +333 -43
- package/dist/domain/javascript/javascriptSemanticObjects.js +20 -16
- package/dist/domain/javascript/javascriptSemanticProjection.js +151 -43
- package/dist/domain/javascript/javascriptSemanticPromises.js +6 -9
- package/dist/domain/javascript/javascriptSemanticProvenance.js +5 -1
- package/dist/domain/javascript/javascriptSemanticQuery.js +7 -2
- package/dist/domain/javascript/javascriptSemanticReferenceSources.js +25 -0
- package/dist/domain/javascript/javascriptSemanticRequireOrigin.js +331 -8
- package/dist/domain/javascript/javascriptSemanticResources.js +6 -40
- package/dist/domain/javascript/javascriptSemanticReturnedReferences.js +14 -0
- package/dist/domain/javascript/javascriptSemanticReturns.js +37 -30
- package/dist/domain/javascript/javascriptSemanticState.js +39 -2
- package/dist/domain/javascript/javascriptSemanticTraversal.js +6 -4
- package/dist/domain/javascript/javascriptSemanticValues.js +227 -30
- package/dist/domain/javascript/javascriptSourceMapPaths.js +44 -17
- package/dist/domain/javascript/javascriptSourceParser.js +72 -3
- package/dist/domain/javascript/javascriptSourceSelection.js +11 -0
- package/dist/domain/javascript/javascriptStaticAnalysis.js +51 -17
- package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +97 -23
- package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +224 -44
- package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +166 -56
- package/dist/domain/javascript/javascriptStaticAnalysisState.js +1 -0
- package/dist/domain/javascript/javascriptStaticAnalysisTypes.js +2 -1
- package/dist/domain/javascript/javascriptSymbolicBindings.js +836 -0
- package/dist/domain/javascript/javascriptSymbolicControlFlow.js +40 -0
- package/dist/domain/javascript/javascriptSymbolicValues.js +34 -0
- package/dist/domain/javascript/sourceToBundleComparison.js +3 -1
- package/dist/domain/javascript/sourceToBundleComparisonSchemas.js +2 -0
- package/dist/domain/javascript/sourceToBundleSignals.js +47 -13
- package/dist/domain/jsonValue.js +37 -12
- package/dist/domain/localPath.js +6 -3
- package/dist/domain/managed/managedApplicationGraph.js +5 -0
- package/dist/domain/managed/managedApplicationGraphCoverage.js +6 -2
- package/dist/domain/managed/managedApplicationGraphNodes.js +0 -1
- package/dist/domain/managed/managedArtifact.js +51 -1
- package/dist/domain/managed/managedInspectionEvidence.js +5 -6
- package/dist/domain/managed/managedMemberComparison.js +3 -0
- package/dist/domain/managed/managedMemberComparisonCoverage.js +23 -3
- package/dist/domain/managed/managedMemberComparisonItems.js +23 -19
- package/dist/domain/managed/managedMemberComparisonMatch.js +209 -18
- package/dist/domain/managed/managedNativeVerificationMatch.js +49 -26
- package/dist/domain/managed/managedNativeVerificationSchemas.js +13 -2
- package/dist/domain/managed/managedReconstruction.js +5 -8
- package/dist/domain/mobileApplicationGraphProjection.js +80 -0
- package/dist/domain/native/addressCoordinate.js +11 -0
- package/dist/domain/native/binaryLayout.js +2 -4
- package/dist/domain/native/bytePattern.js +100 -0
- package/dist/domain/native/nativeAotPe.js +2 -2
- package/dist/domain/native/nativeInspection.js +38 -4
- package/dist/domain/native/nativeInstruction.js +17 -2
- package/dist/domain/native/nativeInvestigationGraph.js +9 -5
- package/dist/domain/native/nativeLoadImage.js +19 -1
- package/dist/domain/native/nativeUiObservation.js +5 -6
- package/dist/domain/native/objcSwiftMetadata.js +4 -1
- package/dist/domain/native/peResources.js +8 -2
- package/dist/domain/native/recordedCrash.js +79 -10
- package/dist/domain/offsetDateTime.js +60 -0
- package/dist/domain/pcap/pcapAnalysis.js +91 -0
- package/dist/domain/pcap/pcapEvidence.js +15 -0
- package/dist/domain/peMachine.js +36 -0
- package/dist/domain/pngHeader.js +18 -0
- package/dist/domain/process/processCaptureCoverage.js +26 -3
- package/dist/domain/process/processCaptureExample.js +2 -0
- package/dist/domain/process/processCaptureValidation.js +33 -8
- package/dist/domain/process/processComparison.js +41 -13
- package/dist/domain/process/processScenario.js +7 -0
- package/dist/domain/process/processTraceEvaluation.js +54 -50
- package/dist/domain/process/processTraceSpecification.js +243 -89
- package/dist/domain/propertyListKeys.js +211 -11
- package/dist/domain/propertyListXmlText.js +20 -4
- package/dist/domain/providerAdapterError.js +0 -5
- package/dist/domain/providerConfigurationRefusal.js +12 -0
- package/dist/domain/providerSelectionError.js +2 -1
- package/dist/domain/qlogCapture.js +62 -0
- package/dist/domain/rawBinary.js +96 -0
- package/dist/domain/reconstructionCoverage.js +5 -1
- package/dist/domain/reconstructionCoverageEvaluation.js +18 -15
- package/dist/domain/reconstructionCoverageVerifierResults.js +35 -0
- package/dist/domain/reconstructionObligationLedgerIntegrity.js +114 -0
- package/dist/domain/reconstructionObligationLedgerSchemas.js +104 -1
- package/dist/domain/reconstructionReadiness.js +4 -8
- package/dist/domain/reconstructionReadinessJourneyFindings.js +4 -1
- package/dist/domain/reconstructionUnknowns.js +9 -1
- package/dist/domain/reconstructionVerification.js +54 -25
- package/dist/domain/recordedTransportUrl.js +59 -0
- package/dist/domain/referenceSourceClassification.js +27 -23
- package/dist/domain/referenceSourceGraph.js +51 -13
- package/dist/domain/referenceSourceImportParsing.js +23 -13
- package/dist/domain/referenceSourcePathIdentity.js +11 -1
- package/dist/domain/referenceSourceRequireBindings.js +5 -12
- package/dist/domain/referenceSourceSummary.js +92 -0
- package/dist/domain/relationshipCoverage.js +44 -0
- package/dist/domain/residualUnknown.js +93 -26
- package/dist/domain/reverseEngineering.js +31 -0
- package/dist/domain/runtimeVersion.js +8 -0
- package/dist/domain/rust/rustBinary.js +200 -0
- package/dist/domain/signals/annotationTextWindow.js +31 -0
- package/dist/domain/signals/signalDecoders.js +69 -0
- package/dist/domain/signals/signalRecording.js +115 -0
- package/dist/domain/sourceMapContents.js +10 -3
- package/dist/domain/sourceMapEnvelope.js +17 -11
- package/dist/domain/sqlite/sqliteDatabase.js +188 -0
- package/dist/domain/staticRuntimeCorrelation.js +7 -9
- package/dist/domain/swiftSymbolClassification.js +17 -0
- package/dist/domain/symbolAnalysis.js +16 -4
- package/dist/domain/urlComponents.js +6 -0
- package/dist/domain/wasm/wasmArtifact.js +119 -0
- package/dist/domain/wasm/wasmInterface.js +89 -0
- package/dist/domain/webBundleAnalysis.js +14 -3
- package/dist/domain/webBundleAnalyzerAst.js +7 -2
- package/dist/domain/webBundleAnalyzerInspection.js +54 -38
- package/dist/domain/webBundleAnalyzerResult.js +18 -6
- package/dist/domain/webCaptureDiff.js +140 -39
- package/dist/domain/webCaptureFrameComparison.js +49 -0
- package/dist/domain/webMcpDiscovery.js +5 -2
- package/dist/domain/webModuleImports.js +22 -27
- package/dist/domain/webModuleTrace.js +3 -8
- package/dist/domain/webNetworkCapture.js +101 -39
- package/dist/domain/webNetworkCaptureCoordinates.js +21 -0
- package/dist/domain/webRuntime.js +0 -1
- package/dist/domain/webScreenshot.js +2 -2
- package/dist/domain/webScriptArtifacts.js +2 -4
- package/dist/domain/webScriptExport.js +6 -8
- package/dist/domain/webScriptExportPlan.js +2 -2
- package/dist/domain/webSourceLocation.js +20 -9
- package/dist/domain/zipPackageFormat.js +29 -3
- package/dist/dotnet/ManagedArtifactInspector.js +27 -12
- package/dist/dotnet/ManagedDecodeBudget.js +66 -8
- package/dist/dotnet/ManagedMemberInspector.js +101 -21
- package/dist/dotnet/ManagedMemberInspectorCore.js +356 -140
- package/dist/dotnet/ManagedMemberInstructionDecoder.js +109 -37
- package/dist/dotnet/ManagedMemberOwnership.js +65 -0
- package/dist/dotnet/ManagedMemberPointers.js +69 -0
- package/dist/dotnet/ManagedMemberRows.js +179 -46
- package/dist/dotnet/ManagedMetadataHeaps.js +110 -24
- package/dist/dotnet/ManagedMetadataInventory.js +5 -5
- package/dist/dotnet/ManagedMetadataInventoryRows.js +36 -52
- package/dist/dotnet/ManagedMetadataLayout.js +9 -1
- package/dist/dotnet/ManagedMetadataRowSizes.js +1 -1
- package/dist/dotnet/ManagedMethodBodyReader.js +29 -11
- package/dist/dotnet/ManagedMethodSpecs.js +78 -0
- package/dist/dotnet/ManagedNativeBoundaryHelpers.js +2 -2
- package/dist/dotnet/ManagedNativeBoundaryInspector.js +6 -13
- package/dist/dotnet/ManagedPeReader.js +55 -27
- package/dist/dotnet/ManagedReaderFailure.js +9 -0
- package/dist/dotnet/ManagedSnapshot.js +88 -0
- package/dist/dotnet/ManagedStaticProvider.js +55 -64
- package/dist/dotnet/ManagedTypeMemberLists.js +105 -0
- package/dist/dotnet/ManagedTypeNames.js +98 -0
- package/dist/dotnet/ManagedUserStrings.js +75 -0
- package/dist/electron/ElectronFusePath.js +247 -0
- package/dist/electron/ElectronFuseProvider.js +113 -0
- package/dist/electron/ElectronFuseReader.js +317 -0
- package/dist/evaluation/AgentEvaluationFixtures.js +194 -11
- package/dist/evaluation/CodexAgentEval.js +19 -40
- package/dist/evaluation/KnownAnswerEvaluation.js +126 -57
- package/dist/evm/EvmoleFailures.js +19 -14
- package/dist/evm/EvmoleInterfaceAdapter.js +5 -1
- package/dist/evm/EvmoleInterfaceProvider.js +141 -31
- package/dist/evm/EvmoleInterfaceWorker.js +2 -0
- package/dist/evm/SolidityMetadata.js +139 -0
- package/dist/filesystem/OwnedStagedOutput.js +138 -0
- package/dist/filesystem/RegularFile.js +48 -4
- package/dist/filesystem/readFileHandleChunks.js +17 -8
- package/dist/firmware/FirmwareCommand.js +2 -2
- package/dist/firmware/FirmwareFiles.js +8 -12
- package/dist/firmware/FirmwareProvider.js +2 -0
- package/dist/firmware/FirmwarePublication.js +218 -1
- package/dist/firmware/FirmwareReports.js +202 -12
- package/dist/flutter/DartElf.js +418 -0
- package/dist/flutter/ElfBuildId.js +137 -0
- package/dist/flutter/ElfLoadMap.js +91 -0
- package/dist/flutter/FlutterBuildProvider.js +826 -0
- package/dist/flutter/FlutterPayloadScan.js +180 -0
- package/dist/frida/FridaInstrumentationManager.js +1104 -0
- package/dist/gdb/GdbSessionManager.js +1451 -0
- package/dist/generatedPackageMetadata.js +2 -2
- package/dist/ghidra/GhidraAnalysisProfile.js +130 -12
- package/dist/ghidra/GhidraClient.js +195 -88
- package/dist/ghidra/GhidraDiagnostics.js +7 -0
- package/dist/ghidra/GhidraDoctor.js +15 -12
- package/dist/ghidra/GhidraFunctionValues.js +49 -2
- package/dist/ghidra/GhidraInstallation.js +215 -19
- package/dist/ghidra/GhidraInstallationPolicy.js +79 -29
- package/dist/ghidra/GhidraInventoryValues.js +30 -0
- package/dist/ghidra/GhidraJavaLaunch.js +91 -10
- package/dist/ghidra/GhidraJavaProperties.js +117 -0
- package/dist/ghidra/GhidraLanguageCatalog.js +74 -4
- package/dist/ghidra/GhidraLauncher.js +234 -57
- package/dist/ghidra/GhidraLoadImageAttest.js +28 -8
- package/dist/ghidra/GhidraLoadImageValues.js +72 -0
- package/dist/ghidra/GhidraMipsProfile.js +250 -14
- package/dist/ghidra/GhidraPeProfile.js +21 -0
- package/dist/ghidra/GhidraPowerPcProfile.js +51 -0
- package/dist/ghidra/GhidraProvider.js +54 -16
- package/dist/ghidra/GhidraProviderCapabilities.js +13 -12
- package/dist/ghidra/GhidraProviderClient.js +260 -57
- package/dist/ghidra/GhidraPspExtension.js +140 -0
- package/dist/ghidra/GhidraPspProfile.js +59 -0
- package/dist/ghidra/GhidraRawBinaryLanguage.js +40 -0
- package/dist/ghidra/GhidraRiscvProfile.js +100 -0
- package/dist/ghidra/GhidraSessionError.js +155 -11
- package/dist/ghidra/GhidraSessionValues.js +66 -0
- package/dist/ghidra/GhidraTransport.js +2 -1
- package/dist/go/GoBinaryContainer.js +140 -0
- package/dist/go/GoBinaryImage.js +210 -0
- package/dist/go/GoBinaryProvider.js +151 -0
- package/dist/go/GoElfImage.js +211 -0
- package/dist/go/GoMachoImage.js +164 -0
- package/dist/go/GoModuleText.js +217 -0
- package/dist/go/GoPeImage.js +124 -0
- package/dist/hopper/BridgeLauncher.js +35 -2
- package/dist/hopper/HopperAnalysisProfile.js +21 -11
- package/dist/hopper/HopperCleanup.js +15 -3
- package/dist/hopper/HopperClient.js +188 -36
- package/dist/hopper/HopperMacPublisher.js +29 -0
- package/dist/hopper/HopperMachOImage.js +61 -29
- package/dist/hopper/HopperProcessDiagnostic.js +27 -0
- package/dist/hopper/HopperProvider.js +59 -28
- package/dist/hopper/HopperProviderCapabilities.js +7 -3
- package/dist/hopper/HopperRequestQueue.js +17 -5
- package/dist/hopper/HopperSessionValues.js +10 -1
- package/dist/hopper/HopperTargetLease.js +66 -19
- package/dist/ida/IdaBusyHealth.js +44 -0
- package/dist/ida/IdaCallGraph.js +134 -0
- package/dist/ida/IdaConfiguration.js +7 -2
- package/dist/ida/IdaDiagnosticRedactor.js +199 -0
- package/dist/ida/IdaDiagnosticWriter.js +62 -0
- package/dist/ida/IdaDoctor.js +7 -5
- package/dist/ida/IdaJsonDiagnostic.js +138 -0
- package/dist/ida/IdaMcpConnection.js +297 -27
- package/dist/ida/IdaNativeProtocol.js +93 -0
- package/dist/ida/IdaOperationRunner.js +246 -43
- package/dist/ida/IdaProtocolValues.js +86 -4
- package/dist/ida/IdaProvider.js +29 -10
- package/dist/ida/IdaProviderCapabilities.js +37 -8
- package/dist/ida/IdaSessionClient.js +331 -54
- package/dist/ida/IdaWorkspace.js +54 -6
- package/dist/inspector/V8InspectorCaptureProjection.js +7 -2
- package/dist/inspector/V8InspectorEndpoint.js +15 -13
- package/dist/inspector/V8InspectorProvider.js +41 -7
- package/dist/javascript/analysis/JavaScriptAnalysisTransfer.js +19 -8
- package/dist/javascript/analysis/JavaScriptAnalysisWorker.js +103 -29
- package/dist/javascript/analysis/JavaScriptAnalysisWorkerProtocol.js +6 -4
- package/dist/javascript/analysis/JavaScriptAnalysisWorkerSchemas.js +78 -9
- package/dist/javascript/analysis/JavaScriptAnalysisWorkerServer.js +15 -5
- package/dist/javascript/recovery/RecoveryFiles.js +51 -6
- package/dist/javascript/recovery/WakaruExecution.js +19 -11
- package/dist/javascript/recovery/WakaruProvider.js +12 -9
- package/dist/javascript/recovery/WakaruPublication.js +24 -10
- package/dist/javascript/recovery/WakaruRelease.js +1 -1
- package/dist/javascript/recovery/WakaruReport.js +3 -2
- package/dist/javascript/sourceMaps/DecodedSourceMap.js +2 -16
- package/dist/javascript/sourceMaps/SourceMapCommand.js +22 -4
- package/dist/javascript/sourceMaps/SourceMapDecoder.js +22 -4
- package/dist/javascript/sourceMaps/SourceMapFormat.js +25 -38
- package/dist/javascript/sourceMaps/TraceSourceMap.js +34 -6
- package/dist/jeb/JebMcpConnection.js +19 -12
- package/dist/jeb/JebMcpEndpoint.js +6 -1
- package/dist/jeb/JebProvider.js +5 -7
- package/dist/logger.js +14 -1
- package/dist/main/shutdown.js +3 -0
- package/dist/main/transport.js +48 -4
- package/dist/main.js +14 -3
- package/dist/mcp/AnalysisSnapshotFiles-BAbiJQOc.js +1412 -0
- package/dist/mcp/ArtifactProvider-DViCU_rn.js +2183 -0
- package/dist/mcp/ArtifactProviderMetadata-b7pOK5_t.js +76 -0
- package/dist/mcp/ArtifactReader-OyM03Gjn.js +55 -0
- package/dist/mcp/ArtifactResourceScope-P3tq5z8Z.js +162 -0
- package/dist/mcp/AsarHeader-WsPgoooH.js +31 -0
- package/dist/mcp/BinarySessionStatus-B4P9gf-S.js +212 -0
- package/dist/mcp/BinaryTargetResolver-BMaE_0H1.js +1427 -0
- package/dist/mcp/BoundedFileBytes-DuczXiQZ.js +68 -0
- package/dist/mcp/CdpCaptureDocuments-HDiF2O7k.js +746 -0
- package/dist/mcp/CdpCaptureValues-M-j6CIh1.js +90 -0
- package/dist/mcp/CdpConnection-BpDfz4MK.js +570 -0
- package/dist/mcp/CdpOptionalCommand-BPjRD9Kz.js +120 -0
- package/dist/mcp/CdpTargetSession-BsPoKhEU.js +86 -0
- package/dist/mcp/DirectAnalysis-DrafbXke.js +409 -0
- package/dist/mcp/DirectAnalysisStatus-CjjeDLzW.js +44 -0
- package/dist/mcp/ElectronFileScope-BPG_YoyU.js +110 -0
- package/dist/mcp/InterfaceBuilderDecodeBudget-5F2AkxJT.js +652 -0
- package/dist/mcp/ManagedStaticProvider-BthZbKyZ.js +5028 -0
- package/dist/mcp/NativeMacOSProvider-Bh79k8dI.js +4867 -0
- package/dist/mcp/NativeMacOSProviderMetadata-N1lPOaY_.js +307 -0
- package/dist/mcp/ProcedureAddressResolution-CQpuwm1h.js +19 -0
- package/dist/mcp/ProcessOwnership-Bl_3ejLe.js +1502 -0
- package/dist/mcp/ProviderDeadline-DskQ94YD.js +932 -0
- package/dist/mcp/WorkflowEvidence-umWrB_wm.js +111 -0
- package/dist/mcp/analysisErrorCore-DXRTvF_m.js +235 -0
- package/dist/mcp/analysisErrorProjection-BN0EPM-3.js +892 -0
- package/dist/mcp/artifactOperationError-CkHMMaf7.js +27 -0
- package/dist/mcp/artifactToolContracts-Di4qZlEt.js +72 -0
- package/dist/mcp/browserObservation-C0s4i8UI.js +4468 -0
- package/dist/mcp/browserObservationError-CyLugqX4.js +40 -0
- package/dist/mcp/browserObservationSchemas-tgqjH7aA.js +573 -0
- package/dist/mcp/browserScenario-CAQ8Fns9.js +2929 -0
- package/dist/mcp/browserScenarioCapture-CTNFN-FI.js +479 -0
- package/dist/mcp/canonicalDigest-Bi_0_zGi.js +71 -0
- package/dist/mcp/digests-BFoWUT_-.js +223 -0
- package/dist/mcp/electronActiveObservation-lDvQTMR0.js +226 -0
- package/dist/mcp/electronObservation-DFOFEood.js +112 -0
- package/dist/mcp/electronObservation-i7LcILQ-.js +562 -0
- package/dist/mcp/electronScenario-nCzE6IfJ.js +653 -0
- package/dist/mcp/emptyArraySchema-tL6Qymyd.js +140 -0
- package/dist/mcp/enhancedInputs-DgdEnzHy.js +56 -0
- package/dist/mcp/javascriptRuntimeObservation-61NhCf7H.js +690 -0
- package/dist/mcp/javascriptRuntimeObservation-PIUoLfX6.js +121 -0
- package/dist/mcp/jsonSerialization-V-wWiFRE.js +152 -0
- package/dist/mcp/lipo-Bnkoq_6W.js +502 -0
- package/dist/mcp/localPath-AxvW9aPe.js +19 -0
- package/dist/mcp/logger-BQY5ulYv.js +48 -0
- package/dist/mcp/main-kBXHZ8S5.js +69390 -0
- package/dist/mcp/main.js +6 -0
- package/dist/mcp/managedToolContracts-CK--I_s7.js +101 -0
- package/dist/mcp/nativeValueTrace-DR9UE62L.js +3439 -0
- package/dist/mcp/officialToolContracts-B67NJ2tC.js +1413 -0
- package/dist/mcp/pngHeader-DQ-ObyY2.js +147 -0
- package/dist/mcp/propertyListKeys-DD25WsjI.js +553 -0
- package/dist/mcp/providerAdapterError-sDxToNal.js +25 -0
- package/dist/mcp/providerIdentities--ptAh481.js +31 -0
- package/dist/mcp/providerIdentity-BCQ5n5tw.js +16 -0
- package/dist/mcp/providerOperationHealth-CTYa3iLf.js +48 -0
- package/dist/mcp/rolldown-runtime-BjeaiXFo.js +121 -0
- package/dist/mcp/safeJson-NeGfpkrI.js +25 -0
- package/dist/mcp/scanCanonical-CRXSpule.js +3982 -0
- package/dist/mcp/serverIdentity-Cio4iFV3.js +1328 -0
- package/dist/mcp/sourceMapEnvelope-C0uJlrOh.js +94 -0
- package/dist/mcp/toolContracts-BW05wpcr.js +12200 -0
- package/dist/mcp/toolOutputSchemaGroups-ColvNZ1r.js +17533 -0
- package/dist/mcp/unicodeCodePointOrder-BezCbTpg.js +26 -0
- package/dist/mcp/webContentArtifact-Dzjc1z-R.js +284 -0
- package/dist/mcp/webRuntime-K__NYzXm.js +74 -0
- package/dist/mcp/webSourceLocation-DbMAT2J9.js +11130 -0
- package/dist/mcpDoctor.js +93 -70
- package/dist/mcpStartupPolicy.js +3 -0
- package/dist/native/AppleDispatchCoverage.js +57 -17
- package/dist/native/AppleDispatchMetadata.js +6 -2
- package/dist/native/AppleMachoFixups.js +188 -25
- package/dist/native/AppleMachoSelection.js +30 -23
- package/dist/native/AppleObjcCategories.js +1 -2
- package/dist/native/AppleObjcDispatchFacets.js +76 -7
- package/dist/native/CommandRunner.js +142 -32
- package/dist/native/LldbCallTracer.js +5 -3
- package/dist/native/MachoArchitectureSelection.js +50 -0
- package/dist/native/NativeCallObservation.js +2 -1
- package/dist/native/NativeMacOSProvider.js +90 -29
- package/dist/native/NativeMachoInspection.js +136 -76
- package/dist/native/NativeUiObservation.js +2 -2
- package/dist/native/SignatureTargetBinding.js +118 -55
- package/dist/native/parsers/codesign.js +27 -10
- package/dist/native/parsers/demangle.js +7 -1
- package/dist/native/parsers/dyldInfo.js +73 -4
- package/dist/native/parsers/lipo.js +53 -19
- package/dist/native/parsers/machoUuid.js +150 -0
- package/dist/native/parsers/otool.js +232 -29
- package/dist/native/pe/PeResourcesProvider.js +20 -6
- package/dist/native/pwndbg/PwndbgCoreContext.js +20 -20
- package/dist/native/pwntools/PwntoolsDecoder.js +264 -40
- package/dist/native/pwntools/PwntoolsFailures.js +2 -1
- package/dist/native/pwntools/PwntoolsInputLimit.js +27 -0
- package/dist/native/pwntools/PwntoolsRecordedCrashProvider.js +27 -15
- package/dist/native/pwntools/PwntoolsResourceLimits.js +3 -3
- package/dist/native/pwntools/RecordedCrashSourceBindings.js +12 -8
- package/dist/native/pwntools/RecordedCrashStructureBindings.js +3 -1
- package/dist/objdump/ObjdumpCommand.js +21 -0
- package/dist/pcap/PcapCommand.js +146 -0
- package/dist/pcap/PcapConfiguration.js +93 -0
- package/dist/pcap/PcapNativeBound.js +58 -0
- package/dist/pcap/PcapOutput.js +240 -0
- package/dist/pcap/PcapProvider.js +424 -0
- package/dist/pcap/PcapSnapshot.js +171 -0
- package/dist/process/ArtifactAnalysisResources.js +213 -0
- package/dist/process/CurrentEntrypointPath.js +6 -0
- package/dist/process/DarwinProcessRunTokenReader.js +117 -13
- package/dist/process/ExecFileBoundedOutput.js +44 -0
- package/dist/process/ExecFileOutput.js +30 -6
- package/dist/process/JavaScriptWorkerMemoryLimit.js +25 -0
- package/dist/process/LinuxResourceLimits.js +80 -0
- package/dist/process/MacCodeSignature.js +3 -0
- package/dist/process/OwnedCommand.js +37 -13
- package/dist/process/PrivateRuntimeRoot.js +9 -19
- package/dist/process/PrivateRuntimeRootUnavailableError.js +10 -0
- package/dist/process/ProcessOwnership.js +70 -17
- package/dist/process/ProcessOwnershipObservation.js +35 -4
- package/dist/process/ProviderDeadline.js +58 -12
- package/dist/process/ProviderProcess.js +108 -11
- package/dist/process/WindowsAuthority.js +48 -39
- package/dist/process/WindowsBatchCommand.js +46 -0
- package/dist/process/boundedUtf8Text.js +13 -0
- package/dist/process/capture/FilesystemSnapshot.js +60 -9
- package/dist/process/capture/ProcessCaptureClock.js +2 -0
- package/dist/process/capture/ProcessCaptureError.js +22 -3
- package/dist/process/capture/ProcessCaptureJournal.js +2 -1
- package/dist/process/capture/ProcessCaptureLifecycle.js +87 -36
- package/dist/process/capture/ProcessCaptureProgress.js +2 -1
- package/dist/process/capture/ProcessHarness.js +17 -14
- package/dist/process/capture/ProcessNormalization.js +278 -36
- package/dist/process/capture/ProcessSampling.js +3 -2
- package/dist/process/capture/ProcessScenarioRuntimeValidation.js +13 -13
- package/dist/process/capture/TerminalRenderer.js +31 -10
- package/dist/process/ownedDebuggerSession.js +203 -0
- package/dist/reference/ReferenceSourceReader.js +0 -1
- package/dist/reference/ReferenceSourceReaderEntries.js +68 -54
- package/dist/reference/ReferenceSourceReaderErrors.js +5 -1
- package/dist/reference/ReferenceSourceReaderFile.js +0 -1
- package/dist/reference/ReferenceSourceReaderTypes.js +1 -2
- package/dist/reference/ReferenceSourceReaderValidate.js +0 -1
- package/dist/rizin/RizinCommand.js +14 -0
- package/dist/rizin/RizinDebugSessionManager.js +1072 -0
- package/dist/rust/RustAuditableReader.js +309 -0
- package/dist/rust/RustBinaryImage.js +116 -0
- package/dist/rust/RustBinaryProvider.js +162 -0
- package/dist/server/EvidenceMcpServer.js +160 -37
- package/dist/server/admittedToolOperation.js +7 -2
- package/dist/server/contractToolHandler.js +8 -1
- package/dist/server/createServer.js +157 -27
- package/dist/server/externalMutationAdmission.js +50 -0
- package/dist/server/mcpProgress.js +4 -2
- package/dist/server/promptCompletion.js +19 -6
- package/dist/server/providerEnvironment.js +3 -0
- package/dist/server/registerAnalysisViewTool.js +6 -2
- package/dist/server/registerAndroidTools.js +22 -4
- package/dist/server/registerApplicationTools/projectMobileApplicationGraph.js +8 -1
- package/dist/server/registerArtifactTools.js +21 -1
- package/dist/server/registerBrowserTools.js +2 -4
- package/dist/server/registerBundleComparisonTool.js +4 -4
- package/dist/server/registerCaptureTools.js +12 -0
- package/dist/server/registerCutterTools.js +33 -0
- package/dist/server/registerElectronTools.js +12 -9
- package/dist/server/registerEnhancedTools.js +7 -6
- package/dist/server/registerEvidenceTools.js +14 -10
- package/dist/server/registerEvmTools.js +22 -4
- package/dist/server/registerFlutterTools.js +17 -0
- package/dist/server/registerFridaTools.js +205 -0
- package/dist/server/registerFunctionComparisonTool.js +29 -9
- package/dist/server/registerGdbTools.js +64 -0
- package/dist/server/registerGoTools.js +9 -0
- package/dist/server/registerInvestigationTools/helpers.js +2 -2
- package/dist/server/registerInvestigationTools.js +12 -8
- package/dist/server/registerJavaScriptRuntimeObservationTools.js +1 -5
- package/dist/server/registerManagedTools.js +11 -1
- package/dist/server/registerNativeTools.js +14 -0
- package/dist/server/registerOfficialTools.js +5 -0
- package/dist/server/registerPcapTools.js +35 -0
- package/dist/server/registerProcessComparisonTool.js +9 -2
- package/dist/server/registerReverseEngineeringTools.js +86 -0
- package/dist/server/registerRizinDebugTools.js +53 -0
- package/dist/server/registerRustTools.js +9 -0
- package/dist/server/registerSessionRecordTools.js +19 -13
- package/dist/server/registerSessionStatusTool.js +22 -4
- package/dist/server/registerSessionTools.js +29 -16
- package/dist/server/registerSignalTools.js +12 -0
- package/dist/server/registerSqliteTools.js +9 -0
- package/dist/server/registerWasmTools.js +46 -0
- package/dist/server/registerWebNetworkCaptureTool.js +24 -10
- package/dist/server/retainedSummaryDelivery.js +28 -0
- package/dist/server/sessionAvailabilityPolicy.js +3 -0
- package/dist/server/toolRegistrationOptions.js +8 -0
- package/dist/server/toolResult.js +52 -19
- package/dist/server/toolResultEncoding.js +36 -3
- package/dist/serverIdentity.js +17 -8
- package/dist/signals/SigrokRecordingProvider.js +339 -0
- package/dist/signals/parseDecoderDiscovery.js +65 -0
- package/dist/sqlite/SqliteDatabaseFailures.js +134 -0
- package/dist/sqlite/SqliteDatabaseInspection.js +421 -0
- package/dist/sqlite/SqliteDatabaseLimits.js +16 -0
- package/dist/sqlite/SqliteDatabaseProvider.js +295 -0
- package/dist/sqlite/SqliteDatabaseSnapshot.js +156 -0
- package/dist/sqlite/SqliteDatabaseWorker.js +46 -0
- package/dist/sqlite/SqliteDatabaseWorkerExecution.js +112 -0
- package/dist/wasm/WabtArtifactProvider.js +336 -0
- package/dist/wasm/WabtFailures.js +101 -0
- package/dist/wasm/WabtInterface.js +309 -0
- package/dist/wasm/WabtOutput.js +60 -0
- package/dist/wasm/WabtRelease.js +12 -0
- package/dist/wasm/WabtString.js +48 -0
- package/dist/wasm/WabtWat.js +147 -0
- package/dist/wasm/WasmGlueAdapter.js +53 -0
- package/dist/wasm/WasmInterfaceBudget.js +11 -0
- package/dist/windows/WindowsNativeLoader.js +37 -7
- package/dist/windows/WindowsOwnedProcess.js +150 -17
- package/dist/windows/WindowsPrivateRuntime.js +22 -1
- package/install.sh +157 -98
- package/licenses/Apache-2.0.txt +202 -0
- package/licenses/GCC-Runtime-Library-Exception-3.1.txt +73 -0
- package/licenses/GPL-3.0.txt +674 -0
- package/licenses/LGPL-2.0.txt +480 -0
- package/licenses/MIT-template.txt +18 -0
- package/licenses/MinGW-w64-runtime.txt +240 -0
- package/licenses/Node-22.19.0-LICENSE.txt +2666 -0
- package/licenses/README.md +68 -0
- package/licenses/cfworker-MIT.txt +21 -0
- package/licenses/dotnet-runtime-MIT.txt +23 -0
- package/licenses/frida-17.23.2-COPYING.txt +50 -0
- package/licenses/ghidra-12.1.4-DISCLAIMER.txt +13 -0
- package/licenses/ghidra-12.1.4-LICENSE.txt +201 -0
- package/licenses/ghidra-12.1.4-NOTICE.txt +49 -0
- package/licenses/npm-dependencies.txt +3612 -0
- package/licenses/npm-runtime-notices.txt +8548 -0
- package/licenses/upstream-sources.json +72 -0
- package/licenses/xterm-MIT.txt +21 -0
- package/native/windows/README.md +92 -11
- package/native/windows/build/manifest.json +2 -2
- package/native/windows/build/rea-windows-x64.node +0 -0
- package/package.json +89 -22
- package/scripts/electron-active-hook.cjs +4 -1
- package/scripts/hopper-demo-x11.py +53 -3
- package/scripts/prepack.mjs +5 -0
- package/scripts/rea-android-workspace-guardian.mjs +46 -0
- package/scripts/rea.mjs +28 -12
- package/scripts/verify-windows-native-artifact.mjs +2 -2
- package/skills/reverse-engineer-anything/SKILL.md +131 -10
- package/skills/reverse-engineer-anything/references/connection-and-recovery.md +10 -10
- package/skills/reverse-engineer-anything/references/evidence-workflows.md +23 -0
- package/skills/reverse-engineer-anything/references/javascript-applications.md +28 -2
- package/skills/reverse-engineer-anything/references/native-and-artifacts.md +125 -15
- package/skills/reverse-engineer-anything/references/runtime-observation.md +57 -7
- package/third_party/README.md +1 -1
- package/third_party/wabt/README.md +24 -0
- package/dist/browser/history/HarCaptureAdapter.js +0 -20
- package/dist/cli/streamedJsonOutput.js +0 -135
- /package/dist/{application/binary → process}/AbortablePromise.js +0 -0
|
@@ -2,9 +2,10 @@ import { analysisErrorWithCleanupFailure } from "../domain/analysisErrorCleanup.
|
|
|
2
2
|
import { fileURLToPath } from "node:url";
|
|
3
3
|
import { createAnalysisExecution, } from "../application/AnalysisProvider.js";
|
|
4
4
|
import { ghidraSeedCommitmentSchema, ghidraSeedFailure, ghidraSeedLimitations, } from "./GhidraAnalysisSeeds.js";
|
|
5
|
-
import { ghidraProfileLanguageOverride, sameGhidraLanguageOverride, } from "./GhidraAnalysisProfile.js";
|
|
5
|
+
import { ghidraPinnedLanguage, ghidraProfileDisabledAnalyzers, ghidraProfileLanguageOverride, sameGhidraDisabledAnalyzers, sameGhidraLanguageOverride, } from "./GhidraAnalysisProfile.js";
|
|
6
|
+
import { ghidraPinnedMipsLanguage } from "./GhidraMipsProfile.js";
|
|
6
7
|
import { AnalysisCancelledError, AnalysisArtifactChangedError, AnalysisAccessDeniedError, AnalysisCapabilityUnavailableError, AnalysisInputError, AnalysisResourceConstraintError, AnalysisTimeoutError, } from "../domain/analysisErrorCore.js";
|
|
7
|
-
import {} from "../domain/
|
|
8
|
+
import { providerRetryAction, } from "../domain/providerOperationHealth.js";
|
|
8
9
|
import { jsonValueSchema } from "../domain/jsonValue.js";
|
|
9
10
|
import { ProviderAdapterError } from "../domain/providerAdapterError.js";
|
|
10
11
|
import { err, ok } from "../domain/result.js";
|
|
@@ -12,16 +13,23 @@ import { GhidraClient } from "./GhidraClient.js";
|
|
|
12
13
|
import { isGhidraFunctionOperation, parseGhidraFunctionInput, parseGhidraFunctionResult, } from "./GhidraFunctionValues.js";
|
|
13
14
|
import { isGhidraInventoryOperation, parseGhidraInventoryInput, parseGhidraInventoryResult, } from "./GhidraInventoryValues.js";
|
|
14
15
|
import { ghidraInstallationDiagnostics, } from "./GhidraInstallation.js";
|
|
16
|
+
import { isGhidraPspTarget, GHIDRA_PSP_LIMITATIONS, } from "./GhidraPspProfile.js";
|
|
17
|
+
import { ghidraPspExtensionSchema } from "./GhidraPspExtension.js";
|
|
18
|
+
import { GHIDRA_MIPS_SOFT_FLOAT_STORAGE, ghidraMipsSoftFloatFailure, ghidraMipsRelocatableLimitations, ghidraMipsSharedLimitations, ghidraMipsSoftFloatLimitations, isGhidraMipsSoftFloatTarget, } from "./GhidraMipsProfile.js";
|
|
19
|
+
import { ghidraRiscvLimitations } from "./GhidraRiscvProfile.js";
|
|
20
|
+
import { ghidraPeCodeViewLimitations } from "./GhidraPeProfile.js";
|
|
15
21
|
import { unverifiedGhidraBuildLimitation } from "./GhidraInstallationPolicy.js";
|
|
16
22
|
import { GhidraHeadlessLauncher } from "./GhidraLauncher.js";
|
|
17
23
|
import { attestGhidraNativeLoadImage } from "./GhidraLoadImageAttest.js";
|
|
18
24
|
import { NATIVE_AOT_MAX_REPORT_BYTES, NATIVE_AOT_MAX_SOURCE_BYTES, nativeAotSnapshotOverCapacity, parseNativeAotPe, } from "../domain/native/nativeAotPe.js";
|
|
19
|
-
import { ABORTED, waitForAbortable
|
|
25
|
+
import { ABORTED, waitForAbortable } from "../process/AbortablePromise.js";
|
|
20
26
|
import { nativeLoadImageObservationSchema } from "../domain/native/nativeLoadImage.js";
|
|
21
27
|
import { GHIDRA_PROVIDER_IDENTITY, healthLimitations, windowsP0Limitations, limitationsFor, } from "./GhidraProviderCapabilities.js";
|
|
28
|
+
import { ghidraPdbLimitations, } from "./GhidraSessionValues.js";
|
|
22
29
|
import { ghidraExtensionFailure } from "./extensions/GhidraExtensionFailures.js";
|
|
23
30
|
import { ghidraExtensionSchema, validateGhidraExtensionProfile, ghidraExtensionLimitations, } from "./extensions/GhidraExtensions.js";
|
|
24
|
-
import {
|
|
31
|
+
import { inspectWindowsNativeReadiness } from "../process/WindowsAuthority.js";
|
|
32
|
+
import { ghidraRawBinaryLanguage } from "./GhidraRawBinaryLanguage.js";
|
|
25
33
|
/** Own one session's captured PE snapshot and immutable NativeAOT derivation. */
|
|
26
34
|
const createNativeAotSnapshotOwner = (input) => {
|
|
27
35
|
const { client, target, startupTimeoutMs } = input;
|
|
@@ -175,6 +183,28 @@ export const createGhidraProviderClient = (input) => {
|
|
|
175
183
|
if (!prerequisites.ok)
|
|
176
184
|
return unavailableClient(prerequisites.error);
|
|
177
185
|
const committedProfile = prerequisites.value.profile;
|
|
186
|
+
const psp = isGhidraPspTarget(target);
|
|
187
|
+
const pspExtension = psp
|
|
188
|
+
? ghidraPspExtensionSchema.safeParse(committedProfile.parameters.psp_extension)
|
|
189
|
+
: null;
|
|
190
|
+
if (pspExtension !== null &&
|
|
191
|
+
(!pspExtension.success ||
|
|
192
|
+
committedProfile.parameters.language_id !== "Allegrex:LE:32:default" ||
|
|
193
|
+
committedProfile.parameters.loader !== "PspElfLoader"))
|
|
194
|
+
return unavailableClient(new ProviderAdapterError("ghidra", "open_binary", {
|
|
195
|
+
diagnostics: {
|
|
196
|
+
reason: "Resolve the supported PSP profile and installed Allegrex extension before opening the session.",
|
|
197
|
+
},
|
|
198
|
+
}));
|
|
199
|
+
const softFloat = isGhidraMipsSoftFloatTarget(target);
|
|
200
|
+
if (softFloat !==
|
|
201
|
+
(committedProfile.parameters.mips_soft_float_storage ===
|
|
202
|
+
GHIDRA_MIPS_SOFT_FLOAT_STORAGE))
|
|
203
|
+
return unavailableClient(new ProviderAdapterError("ghidra", "open_binary", {
|
|
204
|
+
diagnostics: {
|
|
205
|
+
reason: "Resolve the soft-float MIPS storage policy into the analysis profile before opening the session.",
|
|
206
|
+
},
|
|
207
|
+
}));
|
|
178
208
|
const extensionProfile = ghidraExtensionSchema
|
|
179
209
|
.array()
|
|
180
210
|
.safeParse(committedProfile.parameters.analysis_extensions ?? []);
|
|
@@ -198,13 +228,41 @@ export const createGhidraProviderClient = (input) => {
|
|
|
198
228
|
},
|
|
199
229
|
}));
|
|
200
230
|
const seeds = seedProfile.data;
|
|
201
|
-
const
|
|
202
|
-
|
|
231
|
+
const parameterLanguage = ghidraProfileLanguageOverride(committedProfile.parameters);
|
|
232
|
+
const pinnedLanguage = ghidraPinnedMipsLanguage(committedProfile.parameters);
|
|
233
|
+
const targetLanguage = ghidraPinnedLanguage(target);
|
|
234
|
+
if (pinnedLanguage !== undefined && targetLanguage === undefined)
|
|
235
|
+
return unavailableClient(new ProviderAdapterError("ghidra", "open_binary", {
|
|
236
|
+
diagnostics: {
|
|
237
|
+
reason: "The committed profile pins a MIPS language that the current target does not establish; reopen an admitted target to resolve a new profile.",
|
|
238
|
+
},
|
|
239
|
+
}));
|
|
240
|
+
// Provider-pinned profiles declare their language through the same
|
|
241
|
+
// parameter slot caller-configured profiles use, so only an environment
|
|
242
|
+
// override conflicts with the legacy pin; the slot itself carries it.
|
|
243
|
+
if (pinnedLanguage !== undefined &&
|
|
244
|
+
config.ghidraLanguageOverride !== undefined)
|
|
245
|
+
return unavailableClient(new ProviderAdapterError("ghidra", "open_binary", {
|
|
246
|
+
diagnostics: {
|
|
247
|
+
reason: "The committed legacy MIPS profile pins its import language; REA_GHIDRA_LANGUAGE_ID/REA_GHIDRA_COMPILER_SPEC_ID cannot be combined with it. Reopen the target without the override.",
|
|
248
|
+
},
|
|
249
|
+
}));
|
|
250
|
+
if (!sameGhidraLanguageOverride(parameterLanguage, config.ghidraLanguageOverride ?? targetLanguage))
|
|
203
251
|
return unavailableClient(new ProviderAdapterError("ghidra", "open_binary", {
|
|
204
252
|
diagnostics: {
|
|
205
253
|
reason: "The committed analysis profile and REA_GHIDRA_LANGUAGE_ID/REA_GHIDRA_COMPILER_SPEC_ID differ; reopen the target to resolve a new profile.",
|
|
206
254
|
},
|
|
207
255
|
}));
|
|
256
|
+
// Both caller-selected and provider-pinned languages use the validated
|
|
257
|
+
// committed slot; the profile cannot supply its own applicability proof.
|
|
258
|
+
const importLanguage = parameterLanguage;
|
|
259
|
+
const disabledAnalyzers = ghidraProfileDisabledAnalyzers(committedProfile.parameters);
|
|
260
|
+
if (!sameGhidraDisabledAnalyzers(disabledAnalyzers, config.ghidraDisabledAnalyzers))
|
|
261
|
+
return unavailableClient(new ProviderAdapterError("ghidra", "open_binary", {
|
|
262
|
+
diagnostics: {
|
|
263
|
+
reason: "The committed analysis profile and REA_GHIDRA_DISABLED_ANALYZERS differ; reopen the target to resolve a new profile.",
|
|
264
|
+
},
|
|
265
|
+
}));
|
|
208
266
|
const invalidProfile = validateGhidraExtensionProfile(extensions, config, target, installation.platform);
|
|
209
267
|
if (invalidProfile !== null)
|
|
210
268
|
return unavailableClient(new ProviderAdapterError("ghidra", "open_binary", {
|
|
@@ -213,6 +271,15 @@ export const createGhidraProviderClient = (input) => {
|
|
|
213
271
|
let extensionFailure;
|
|
214
272
|
// Replaced by the reported outcome once the session handshake is checked.
|
|
215
273
|
const seedLimitations = [...ghidraSeedLimitations(seeds)];
|
|
274
|
+
const pdbLimitations = [];
|
|
275
|
+
let pdbLoaded;
|
|
276
|
+
// Replaced by the reported storage outcome once the handshake is checked.
|
|
277
|
+
const softFloatLimitations = [
|
|
278
|
+
...ghidraMipsSoftFloatLimitations(softFloat),
|
|
279
|
+
];
|
|
280
|
+
const rawLanguage = target.format === "raw-binary"
|
|
281
|
+
? ghidraRawBinaryLanguage(target.architecture)
|
|
282
|
+
: undefined;
|
|
216
283
|
const targetLimitations = [
|
|
217
284
|
...(target.format === "dos-mz"
|
|
218
285
|
? [
|
|
@@ -220,9 +287,26 @@ export const createGhidraProviderClient = (input) => {
|
|
|
220
287
|
"Static DOS analysis does not emulate BIOS, DOS interrupts, device ports, or self-modifying unpacking code. Packed targets require a separately identified unpacked artifact for original-program analysis; appended overlays are not the initialized load module.",
|
|
221
288
|
]
|
|
222
289
|
: []),
|
|
290
|
+
...(target.format === "raw-binary"
|
|
291
|
+
? [
|
|
292
|
+
"Headerless raw-binary analysis uses the caller-supplied architecture and entry address; file offset 0 is mapped at that address. Headers are not discovered from file bytes.",
|
|
293
|
+
"Little-endian generic Ghidra languages are used for x86, x86_64, arm, arm64, and NMOS 6502. Big-endian, Thumb-only, Cortex-M, 65C02, 65816, and other processor variants are unsupported in this increment.",
|
|
294
|
+
"Static analysis does not emulate reset vectors, memory-mapped I/O, or firmware boot sequences.",
|
|
295
|
+
]
|
|
296
|
+
: []),
|
|
223
297
|
...(target.kind === "executable" && target.architecture === "mips"
|
|
224
298
|
? (target.mips.limitations ?? [])
|
|
225
299
|
: []),
|
|
300
|
+
...(committedProfile.parameters.mips_abi_basis ===
|
|
301
|
+
"inferred-o32-assumption-v1"
|
|
302
|
+
? [
|
|
303
|
+
"The ELF header declares no ABI field and no ABI flags record was observed; o32 calling conventions are an analysis assumption of this lane, not a declared fact.",
|
|
304
|
+
"Floating-point ABI semantics are unverified for this recordless legacy admission.",
|
|
305
|
+
]
|
|
306
|
+
: []),
|
|
307
|
+
...ghidraMipsRelocatableLimitations(target),
|
|
308
|
+
...ghidraMipsSharedLimitations(target),
|
|
309
|
+
...ghidraRiscvLimitations(target),
|
|
226
310
|
];
|
|
227
311
|
const providerLimitations = installation.platform === "win32"
|
|
228
312
|
? windowsP0Limitations
|
|
@@ -238,10 +322,31 @@ export const createGhidraProviderClient = (input) => {
|
|
|
238
322
|
environment: input.environment,
|
|
239
323
|
analyzeHeadlessPath: prerequisites.value.analyzeHeadlessPath,
|
|
240
324
|
javaHome: prerequisites.value.javaHome,
|
|
325
|
+
...(installation.javaVmName === undefined
|
|
326
|
+
? {}
|
|
327
|
+
: { javaVmName: installation.javaVmName }),
|
|
241
328
|
bridgeScriptPath: fileURLToPath(new URL("../../bridge/ghidra/ReaGhidraBridge.java", import.meta.url)),
|
|
329
|
+
...(pspExtension?.success === true
|
|
330
|
+
? { pspExtension: pspExtension.data }
|
|
331
|
+
: {}),
|
|
332
|
+
...(softFloat ? { mipsSoftFloat: true } : {}),
|
|
242
333
|
...(target.format === "dos-mz" ? { dosMz: true } : {}),
|
|
243
334
|
...(target.format === "dos-com" ? { dosCom: true } : {}),
|
|
244
|
-
...(
|
|
335
|
+
...(rawLanguage === undefined || target.format !== "raw-binary"
|
|
336
|
+
? {}
|
|
337
|
+
: {
|
|
338
|
+
rawBinary: {
|
|
339
|
+
languageId: rawLanguage.languageId,
|
|
340
|
+
compilerSpecId: rawLanguage.compilerSpecId,
|
|
341
|
+
baseAddr: target.entryPoint,
|
|
342
|
+
},
|
|
343
|
+
}),
|
|
344
|
+
...(importLanguage === undefined
|
|
345
|
+
? {}
|
|
346
|
+
: { languageOverride: importLanguage }),
|
|
347
|
+
...(config.ghidraDisabledAnalyzers === undefined
|
|
348
|
+
? {}
|
|
349
|
+
: { disabledAnalyzers: config.ghidraDisabledAnalyzers }),
|
|
245
350
|
...(seeds === undefined ? {} : { analysisSeeds: seeds }),
|
|
246
351
|
platform: installation.platform,
|
|
247
352
|
...(extensions.length === 0 ? {} : { analysisExtensions: extensions }),
|
|
@@ -260,22 +365,50 @@ export const createGhidraProviderClient = (input) => {
|
|
|
260
365
|
expectedLanguageId: "x86:LE:16:Real Mode",
|
|
261
366
|
expectedCompilerSpecId: "default",
|
|
262
367
|
}
|
|
263
|
-
:
|
|
264
|
-
?
|
|
368
|
+
: rawLanguage === undefined
|
|
369
|
+
? importLanguage === undefined
|
|
370
|
+
? {}
|
|
371
|
+
: {
|
|
372
|
+
expectedLanguageId: importLanguage.languageId,
|
|
373
|
+
...(importLanguage.compilerSpecId === undefined
|
|
374
|
+
? {}
|
|
375
|
+
: { expectedCompilerSpecId: importLanguage.compilerSpecId }),
|
|
376
|
+
}
|
|
265
377
|
: {
|
|
266
|
-
expectedLanguageId:
|
|
267
|
-
|
|
268
|
-
? {}
|
|
269
|
-
: { expectedCompilerSpecId: languageOverride.compilerSpecId }),
|
|
378
|
+
expectedLanguageId: rawLanguage.languageId,
|
|
379
|
+
expectedCompilerSpecId: rawLanguage.compilerSpecId,
|
|
270
380
|
}),
|
|
381
|
+
...(psp
|
|
382
|
+
? {
|
|
383
|
+
expectedLanguageId: "Allegrex:LE:32:default",
|
|
384
|
+
expectedCompilerSpecId: "default",
|
|
385
|
+
}
|
|
386
|
+
: {}),
|
|
271
387
|
...(context === undefined ? {} : { runId: context.runId }),
|
|
272
388
|
logger: logger.child({ layer: "ghidra-bridge" }),
|
|
273
389
|
});
|
|
274
|
-
|
|
390
|
+
// Startup failures retain installation guidance; only a previously running
|
|
391
|
+
// provider can be described as lost and reopened.
|
|
392
|
+
let providerStarted = false;
|
|
393
|
+
const lostProviderHealth = () => providerStarted ? client.operationHealthSnapshot?.() : undefined;
|
|
394
|
+
const checkSessionObservations = async (operation, info) => {
|
|
395
|
+
if (target.format === "pe") {
|
|
396
|
+
pdbLoaded = info.pdb?.loaded;
|
|
397
|
+
pdbLimitations.splice(0, pdbLimitations.length, ...ghidraPdbLimitations(info.pdb));
|
|
398
|
+
}
|
|
399
|
+
const softFloatReason = ghidraMipsSoftFloatFailure(softFloat, info.mips_soft_float_storage);
|
|
275
400
|
extensionFailure =
|
|
276
|
-
ghidraExtensionFailure(extensions, info.analysis_extensions ?? [], operation) ??
|
|
401
|
+
ghidraExtensionFailure(extensions, info.analysis_extensions ?? [], operation) ??
|
|
402
|
+
ghidraSeedFailure(seeds, info.analysis_seeds, operation) ??
|
|
403
|
+
(softFloatReason === undefined
|
|
404
|
+
? undefined
|
|
405
|
+
: new ProviderAdapterError("ghidra", operation, {
|
|
406
|
+
diagnostics: { reason: softFloatReason },
|
|
407
|
+
}));
|
|
277
408
|
if (extensionFailure === undefined && info.analysis_seeds !== undefined)
|
|
278
409
|
seedLimitations.splice(0, seedLimitations.length, ...ghidraSeedLimitations(seeds, info.analysis_seeds));
|
|
410
|
+
if (extensionFailure === undefined)
|
|
411
|
+
softFloatLimitations.splice(0, softFloatLimitations.length, ...ghidraMipsSoftFloatLimitations(softFloat, info.mips_soft_float_storage));
|
|
279
412
|
if (extensionFailure === undefined)
|
|
280
413
|
return undefined;
|
|
281
414
|
const closed = await client.close();
|
|
@@ -287,8 +420,12 @@ export const createGhidraProviderClient = (input) => {
|
|
|
287
420
|
const sessionLimitations = () => [
|
|
288
421
|
...providerLimitations,
|
|
289
422
|
...targetLimitations,
|
|
423
|
+
...(psp ? GHIDRA_PSP_LIMITATIONS : []),
|
|
424
|
+
...softFloatLimitations,
|
|
290
425
|
...ghidraExtensionLimitations(extensions),
|
|
291
426
|
...seedLimitations,
|
|
427
|
+
...pdbLimitations,
|
|
428
|
+
...ghidraPeCodeViewLimitations(target, pdbLoaded),
|
|
292
429
|
...(releaseLimitation === undefined ? [] : [releaseLimitation]),
|
|
293
430
|
];
|
|
294
431
|
const nativeAotOwner = target.format === "pe"
|
|
@@ -298,6 +435,27 @@ export const createGhidraProviderClient = (input) => {
|
|
|
298
435
|
startupTimeoutMs: config.ghidraStartupTimeoutMs,
|
|
299
436
|
})
|
|
300
437
|
: undefined;
|
|
438
|
+
const projectExecution = (operation, normalized, rawResult, observationLimitations = [], locations = [], relationshipCoverage) => {
|
|
439
|
+
return createAnalysisExecution(normalized, committedProfile.provider, {
|
|
440
|
+
rawResult,
|
|
441
|
+
locations,
|
|
442
|
+
analysisProfile: committedProfile,
|
|
443
|
+
...(relationshipCoverage === undefined ? {} : { relationshipCoverage }),
|
|
444
|
+
limitations: [
|
|
445
|
+
...limitationsFor(operation),
|
|
446
|
+
...observationLimitations,
|
|
447
|
+
...sessionLimitations(),
|
|
448
|
+
],
|
|
449
|
+
});
|
|
450
|
+
};
|
|
451
|
+
const inventoryExecution = (operation, called) => {
|
|
452
|
+
if (!called.ok)
|
|
453
|
+
return err(projectSessionError(operation, called.error, config.ghidraStartupTimeoutMs, lostProviderHealth()));
|
|
454
|
+
const parsed = parseGhidraInventoryResult(operation, called.value);
|
|
455
|
+
if (!parsed.ok)
|
|
456
|
+
return parsed;
|
|
457
|
+
return ok(projectExecution(operation, parsed.value, called.value));
|
|
458
|
+
};
|
|
301
459
|
return {
|
|
302
460
|
execute: async (operation, parameters, options) => {
|
|
303
461
|
if (extensionFailure !== undefined)
|
|
@@ -307,10 +465,12 @@ export const createGhidraProviderClient = (input) => {
|
|
|
307
465
|
!isGhidraFunctionOperation(operation))
|
|
308
466
|
return err(new AnalysisCapabilityUnavailableError(GHIDRA_PROVIDER_IDENTITY.id, operation, "The Ghidra adapter does not declare this operation."));
|
|
309
467
|
if (operation === "health") {
|
|
310
|
-
const started = await client.start(options?.signal);
|
|
468
|
+
const started = await client.start(options?.signal, options?.progress);
|
|
469
|
+
if (started.ok)
|
|
470
|
+
providerStarted = true;
|
|
311
471
|
if (!started.ok)
|
|
312
|
-
return err(projectSessionError(operation, started.error, config.ghidraStartupTimeoutMs));
|
|
313
|
-
const failed = await
|
|
472
|
+
return err(projectSessionError(operation, started.error, config.ghidraStartupTimeoutMs, lostProviderHealth()));
|
|
473
|
+
const failed = await checkSessionObservations(operation, started.value);
|
|
314
474
|
if (failed !== undefined)
|
|
315
475
|
return err(failed);
|
|
316
476
|
return ok(createAnalysisExecution(started.value, committedProfile.provider, {
|
|
@@ -323,25 +483,43 @@ export const createGhidraProviderClient = (input) => {
|
|
|
323
483
|
: parseGhidraInventoryInput(operation, parameters);
|
|
324
484
|
if (!input.ok)
|
|
325
485
|
return input;
|
|
326
|
-
if (
|
|
327
|
-
|
|
486
|
+
if (target.format === "pe" ||
|
|
487
|
+
extensions.length > 0 ||
|
|
488
|
+
seeds !== undefined ||
|
|
489
|
+
softFloat) {
|
|
490
|
+
const started = await client.start(options?.signal, options?.progress);
|
|
491
|
+
if (started.ok)
|
|
492
|
+
providerStarted = true;
|
|
328
493
|
if (!started.ok)
|
|
329
|
-
return err(projectSessionError(operation, started.error, config.ghidraStartupTimeoutMs));
|
|
330
|
-
const failed = await
|
|
494
|
+
return err(projectSessionError(operation, started.error, config.ghidraStartupTimeoutMs, lostProviderHealth()));
|
|
495
|
+
const failed = await checkSessionObservations(operation, started.value);
|
|
331
496
|
if (failed !== undefined)
|
|
332
497
|
return err(failed);
|
|
333
498
|
}
|
|
334
|
-
const called = await client.callTool(operation, input.value,
|
|
499
|
+
const called = await client.callTool(operation, input.value, {
|
|
500
|
+
...(options?.signal === undefined ? {} : { signal: options.signal }),
|
|
501
|
+
...(options?.progress === undefined
|
|
502
|
+
? {}
|
|
503
|
+
: { progress: options.progress }),
|
|
504
|
+
});
|
|
505
|
+
if (called.ok)
|
|
506
|
+
providerStarted = true;
|
|
507
|
+
if (operation === "list_documents" || operation === "list_procedures")
|
|
508
|
+
return inventoryExecution(operation, called);
|
|
335
509
|
if (!called.ok)
|
|
336
|
-
return err(projectSessionError(operation, called.error, config.ghidraStartupTimeoutMs));
|
|
510
|
+
return err(projectSessionError(operation, called.error, config.ghidraStartupTimeoutMs, lostProviderHealth()));
|
|
337
511
|
let normalized;
|
|
338
512
|
let observationLimitations = [];
|
|
513
|
+
let observationLocations = [];
|
|
514
|
+
let relationshipCoverage;
|
|
339
515
|
if (isGhidraFunctionOperation(operation)) {
|
|
340
516
|
const result = parseGhidraFunctionResult(operation, called.value);
|
|
341
517
|
if (!result.ok)
|
|
342
518
|
return result;
|
|
343
519
|
normalized = result.value.value;
|
|
344
520
|
observationLimitations = result.value.limitations;
|
|
521
|
+
observationLocations = result.value.locations ?? [];
|
|
522
|
+
relationshipCoverage = result.value.relationshipCoverage;
|
|
345
523
|
}
|
|
346
524
|
else {
|
|
347
525
|
const result = parseGhidraInventoryResult(operation, called.value);
|
|
@@ -353,9 +531,9 @@ export const createGhidraProviderClient = (input) => {
|
|
|
353
531
|
const address = input.value.address;
|
|
354
532
|
if (typeof address === "string") {
|
|
355
533
|
if (target.format === "pe" && nativeAotOwner !== undefined) {
|
|
356
|
-
const started = await client.start(options?.signal);
|
|
534
|
+
const started = await client.start(options?.signal, options?.progress);
|
|
357
535
|
if (!started.ok)
|
|
358
|
-
return err(projectSessionError(operation, started.error, config.ghidraStartupTimeoutMs));
|
|
536
|
+
return err(projectSessionError(operation, started.error, config.ghidraStartupTimeoutMs, lostProviderHealth()));
|
|
359
537
|
const derived = await nativeAotOwner.derive(started.value.target.image_base, operation, options?.signal, normalized);
|
|
360
538
|
if (!derived.ok)
|
|
361
539
|
return derived;
|
|
@@ -395,7 +573,7 @@ export const createGhidraProviderClient = (input) => {
|
|
|
395
573
|
operation,
|
|
396
574
|
measured: normalized,
|
|
397
575
|
client,
|
|
398
|
-
mapSessionError: (failure) => projectSessionError(operation, failure, config.ghidraStartupTimeoutMs),
|
|
576
|
+
mapSessionError: (failure) => projectSessionError(operation, failure, config.ghidraStartupTimeoutMs, lostProviderHealth()),
|
|
399
577
|
nativeAotResult: derived,
|
|
400
578
|
signal: options?.signal,
|
|
401
579
|
});
|
|
@@ -403,16 +581,24 @@ export const createGhidraProviderClient = (input) => {
|
|
|
403
581
|
return attested;
|
|
404
582
|
normalized = attested.value;
|
|
405
583
|
}
|
|
406
|
-
return ok(
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
584
|
+
return ok(projectExecution(operation, normalized, called.value, observationLimitations, observationLocations, relationshipCoverage));
|
|
585
|
+
},
|
|
586
|
+
executeIfReady: async (operation, parameters, options) => {
|
|
587
|
+
if (operation !== "list_documents" && operation !== "list_procedures")
|
|
588
|
+
return undefined;
|
|
589
|
+
if (extensionFailure !== undefined)
|
|
590
|
+
return err(extensionFailure);
|
|
591
|
+
const input = parseGhidraInventoryInput(operation, parameters);
|
|
592
|
+
if (!input.ok)
|
|
593
|
+
return input;
|
|
594
|
+
if (client.callToolIfReady === undefined)
|
|
595
|
+
return undefined;
|
|
596
|
+
const called = await client.callToolIfReady(operation, input.value, options?.signal === undefined ? {} : { signal: options.signal });
|
|
597
|
+
if (called === undefined)
|
|
598
|
+
return undefined;
|
|
599
|
+
return inventoryExecution(operation, called);
|
|
415
600
|
},
|
|
601
|
+
operationHealthSnapshot: () => client.operationHealthSnapshot?.(),
|
|
416
602
|
runtimeLineageSnapshots: () => {
|
|
417
603
|
const observation = client.runtimeLineage?.() ?? null;
|
|
418
604
|
return observation === null
|
|
@@ -432,9 +618,11 @@ const ghidraClientPrerequisites = (target, profile, installation) => {
|
|
|
432
618
|
return err(new ProviderAdapterError("ghidra", "health", {
|
|
433
619
|
diagnostics: ghidraInstallationDiagnostics(installation),
|
|
434
620
|
}));
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
621
|
+
const readiness = installation.platform === "win32"
|
|
622
|
+
? inspectWindowsNativeReadiness(installation.platform)
|
|
623
|
+
: undefined;
|
|
624
|
+
if (readiness?.available === false)
|
|
625
|
+
return err(new AnalysisCapabilityUnavailableError("ghidra", "health", readiness.reason));
|
|
438
626
|
if (profile === undefined || profile.provider.id !== "ghidra")
|
|
439
627
|
return err(new ProviderAdapterError("ghidra", "health"));
|
|
440
628
|
return ok({
|
|
@@ -448,44 +636,59 @@ const unavailableClient = (failure) => ({
|
|
|
448
636
|
execute: () => Promise.resolve(err(failure)),
|
|
449
637
|
close: () => Promise.resolve(ok(null)),
|
|
450
638
|
});
|
|
451
|
-
const projectSessionError = (operation, failure, startupTimeoutMs) => {
|
|
452
|
-
const primary = projectPrimarySessionError(operation, failure, startupTimeoutMs);
|
|
639
|
+
const projectSessionError = (operation, failure, startupTimeoutMs, health) => {
|
|
640
|
+
const primary = projectPrimarySessionError(operation, failure, startupTimeoutMs, health);
|
|
453
641
|
return failure.cleanupFailure === undefined
|
|
454
642
|
? primary
|
|
455
643
|
: analysisErrorWithCleanupFailure(primary, failure.cleanupFailure, operation);
|
|
456
644
|
};
|
|
457
|
-
const projectPrimarySessionError = (operation, failure, startupTimeoutMs) => {
|
|
645
|
+
const projectPrimarySessionError = (operation, failure, startupTimeoutMs, health) => {
|
|
646
|
+
const context = { cause: failure, diagnostics: failure.diagnostics };
|
|
458
647
|
if (failure.cause instanceof AnalysisAccessDeniedError)
|
|
459
|
-
return new AnalysisAccessDeniedError(operation, failure.cause.path, failure.cause.systemCode,
|
|
648
|
+
return new AnalysisAccessDeniedError(operation, failure.cause.path, failure.cause.systemCode, context);
|
|
460
649
|
if (failure.cause instanceof AnalysisArtifactChangedError)
|
|
461
|
-
return new AnalysisArtifactChangedError(operation, failure.cause.path, failure.cause.reason,
|
|
650
|
+
return new AnalysisArtifactChangedError(operation, failure.cause.path, failure.cause.reason, context);
|
|
462
651
|
if (operation === "annotate_native_function" &&
|
|
463
652
|
failure.kind === "remote" &&
|
|
464
653
|
failure.remoteCode === "invalid_function_name")
|
|
465
|
-
return new AnalysisInputError(operation,
|
|
654
|
+
return new AnalysisInputError(operation, context, [
|
|
466
655
|
{ path: ["name"], reason: "invalid_value", message: failure.message },
|
|
467
656
|
]);
|
|
468
|
-
if (failure.kind === "cancelled"
|
|
469
|
-
|
|
657
|
+
if (failure.kind === "cancelled" ||
|
|
658
|
+
(failure.kind === "remote" && failure.remoteCode === "decompile_cancelled"))
|
|
659
|
+
return new AnalysisCancelledError(operation, context);
|
|
470
660
|
if (failure.kind === "timeout" || failure.kind === "analysis_timeout")
|
|
471
|
-
return new AnalysisTimeoutError(operation, failure.timeoutMs ?? startupTimeoutMs);
|
|
472
|
-
if (failure.kind === "remote" && failure.remoteCode === "decompile_cancelled")
|
|
473
|
-
return new AnalysisCancelledError(operation);
|
|
661
|
+
return new AnalysisTimeoutError(operation, failure.timeoutMs ?? startupTimeoutMs, context);
|
|
474
662
|
if (failure.kind === "remote" &&
|
|
475
663
|
failure.remoteCode === "regex_stack_exhausted")
|
|
476
664
|
return new AnalysisResourceConstraintError(operation, "memory", failure.message, null, {
|
|
477
|
-
|
|
665
|
+
...context,
|
|
478
666
|
remediationAction: "Retry this search in literal mode or simplify the regex. The active analysis session and annotations remain available.",
|
|
479
667
|
});
|
|
480
668
|
if (failure.kind === "remote" &&
|
|
481
669
|
["invalid_request", "not_found", "ambiguous"].includes(failure.remoteCode ?? ""))
|
|
482
|
-
return new AnalysisInputError(operation,
|
|
670
|
+
return new AnalysisInputError(operation, context, [
|
|
483
671
|
{ path: [], reason: "invalid_value", message: failure.message },
|
|
484
672
|
]);
|
|
485
673
|
if (failure.kind === "remote" && failure.remoteCode === "method_unavailable")
|
|
486
|
-
return new AnalysisCapabilityUnavailableError("ghidra", operation, failure.message);
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
674
|
+
return new AnalysisCapabilityUnavailableError("ghidra", operation, failure.message, context);
|
|
675
|
+
const exited = exitedProviderMessage(operation, failure, health);
|
|
676
|
+
if (exited !== undefined)
|
|
677
|
+
return new ProviderAdapterError("ghidra", operation, {
|
|
678
|
+
...context,
|
|
679
|
+
userMessage: exited,
|
|
680
|
+
});
|
|
681
|
+
return new ProviderAdapterError("ghidra", operation, context);
|
|
682
|
+
};
|
|
683
|
+
/** A provider already observed as running can be restarted by reopening. */
|
|
684
|
+
const exitedProviderMessage = (operation, failure, health) => {
|
|
685
|
+
if (failure.kind !== "process" && failure.kind !== "protocol")
|
|
686
|
+
return undefined;
|
|
687
|
+
if (health === undefined ||
|
|
688
|
+
providerRetryAction(health.state) !== "restart_provider")
|
|
689
|
+
return undefined;
|
|
690
|
+
const observed = health.state === "exited"
|
|
691
|
+
? `exited${health.exitCode === null ? "" : ` with code ${String(health.exitCode)}`}`
|
|
692
|
+
: "became unreachable";
|
|
693
|
+
return `The Ghidra provider for this session ${observed} before ${operation} could complete. Call open_binary for the same target to start a new Ghidra session, then retry; session-only annotations from the previous provider are not retained.`;
|
|
491
694
|
};
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { lstat, opendir, realpath } from "node:fs/promises";
|
|
3
|
+
import { isAbsolute, join } from "node:path";
|
|
4
|
+
import { z } from "zod";
|
|
5
|
+
import { openRegularFile, sameRegularFileState, } from "../filesystem/RegularFile.js";
|
|
6
|
+
import { AnalysisCancelledError, AnalysisCapabilityUnavailableError, } from "../domain/analysisErrorCore.js";
|
|
7
|
+
import { err, ok } from "../domain/result.js";
|
|
8
|
+
import { parseGhidraJavaProperties } from "./GhidraJavaProperties.js";
|
|
9
|
+
/** Installed processor code and data, distinct from REA's analysis-extension ABI. */
|
|
10
|
+
export const ghidraPspExtensionSchema = z.strictObject({
|
|
11
|
+
id: z.literal("ghidra-allegrex"),
|
|
12
|
+
root: z.string().refine(isAbsolute),
|
|
13
|
+
ghidra_version: z.string().min(1),
|
|
14
|
+
sha256: z.string().regex(/^[a-f0-9]{64}$/u),
|
|
15
|
+
});
|
|
16
|
+
// Resource bounds for scanning a caller-installed extension, not target limits.
|
|
17
|
+
const MAX_ENTRIES = 1024;
|
|
18
|
+
const MAX_BYTES = 64 * 1024 * 1024;
|
|
19
|
+
const MAX_DEPTH = 16;
|
|
20
|
+
const REQUIRED = [
|
|
21
|
+
"Module.manifest",
|
|
22
|
+
"extension.properties",
|
|
23
|
+
"data/languages/allegrex.ldefs",
|
|
24
|
+
"data/languages/allegrex.sla",
|
|
25
|
+
"data/languages/allegrex.pspec",
|
|
26
|
+
"data/languages/allegrex.cspec",
|
|
27
|
+
];
|
|
28
|
+
/** Read-only fingerprint of all installed files; no home scanning or installation. */
|
|
29
|
+
export const inspectGhidraPspExtension = async (root, ghidraVersion, signal) => {
|
|
30
|
+
signal?.throwIfAborted();
|
|
31
|
+
if (!isAbsolute(root) || (await realpath(root)) !== root)
|
|
32
|
+
throw new Error("The installed Allegrex directory must be a canonical non-symlink path.");
|
|
33
|
+
const files = [];
|
|
34
|
+
let entries = 1; // The root itself consumes one inventory entry.
|
|
35
|
+
const visit = async (relative, depth) => {
|
|
36
|
+
signal?.throwIfAborted();
|
|
37
|
+
if (depth > MAX_DEPTH)
|
|
38
|
+
throw new Error("Allegrex extension directory nesting exceeds the inspection limit.");
|
|
39
|
+
const path = join(root, relative);
|
|
40
|
+
const metadata = await lstat(path);
|
|
41
|
+
if (metadata.isDirectory()) {
|
|
42
|
+
const children = [];
|
|
43
|
+
for await (const child of await opendir(path)) {
|
|
44
|
+
signal?.throwIfAborted();
|
|
45
|
+
if (++entries > MAX_ENTRIES)
|
|
46
|
+
throw new Error("Allegrex extension inventory exceeds the inspection limit.");
|
|
47
|
+
children.push(child.name);
|
|
48
|
+
}
|
|
49
|
+
children.sort();
|
|
50
|
+
for (const child of children)
|
|
51
|
+
await visit(relative === "" ? child : `${relative}/${child}`, depth + 1);
|
|
52
|
+
}
|
|
53
|
+
else if (metadata.isFile()) {
|
|
54
|
+
files.push(relative);
|
|
55
|
+
}
|
|
56
|
+
else
|
|
57
|
+
throw new Error(`Allegrex extension entries must be regular files or directories: ${relative}`);
|
|
58
|
+
};
|
|
59
|
+
await visit("", 0);
|
|
60
|
+
for (const required of REQUIRED)
|
|
61
|
+
if (!files.includes(required))
|
|
62
|
+
throw new Error(`Missing installed Allegrex component: ${required}`);
|
|
63
|
+
if (!files.some((path) => path.startsWith("lib/") && path.endsWith(".jar")))
|
|
64
|
+
throw new Error("The installed Allegrex extension has no loader JAR.");
|
|
65
|
+
const hash = createHash("sha256");
|
|
66
|
+
let bytesRead = 0;
|
|
67
|
+
let properties = Buffer.alloc(0);
|
|
68
|
+
for (const relative of files) {
|
|
69
|
+
signal?.throwIfAborted();
|
|
70
|
+
const path = join(root, relative);
|
|
71
|
+
const handle = await openRegularFile(path, { symlinks: "reject", signal });
|
|
72
|
+
try {
|
|
73
|
+
const before = await handle.stat();
|
|
74
|
+
if (!Number.isSafeInteger(before.size) ||
|
|
75
|
+
before.size > MAX_BYTES - bytesRead)
|
|
76
|
+
throw new Error("Allegrex extension bytes exceed the inspection limit.");
|
|
77
|
+
if (relative === "extension.properties" && before.size > 65536)
|
|
78
|
+
throw new Error("Allegrex extension properties exceed the inspection limit.");
|
|
79
|
+
hash.update(JSON.stringify([relative, before.size]));
|
|
80
|
+
const buffer = Buffer.alloc(Math.min(65536, before.size + 1));
|
|
81
|
+
let offset = 0;
|
|
82
|
+
const chunks = [];
|
|
83
|
+
while (offset < before.size) {
|
|
84
|
+
signal?.throwIfAborted();
|
|
85
|
+
const read = await handle.read(buffer, 0, Math.min(buffer.length, before.size - offset), offset);
|
|
86
|
+
if (read.bytesRead === 0)
|
|
87
|
+
throw new Error(`Truncated Allegrex component: ${relative}`);
|
|
88
|
+
const chunk = buffer.subarray(0, read.bytesRead);
|
|
89
|
+
hash.update(chunk);
|
|
90
|
+
if (relative === "extension.properties")
|
|
91
|
+
chunks.push(Buffer.from(chunk));
|
|
92
|
+
offset += read.bytesRead;
|
|
93
|
+
}
|
|
94
|
+
if (!sameRegularFileState(before, await handle.stat()) ||
|
|
95
|
+
!sameRegularFileState(before, await lstat(path)))
|
|
96
|
+
throw new Error(`Allegrex component changed during inspection: ${relative}`);
|
|
97
|
+
bytesRead += before.size;
|
|
98
|
+
if (relative === "extension.properties")
|
|
99
|
+
properties = Buffer.concat(chunks);
|
|
100
|
+
}
|
|
101
|
+
finally {
|
|
102
|
+
await handle.close();
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
// Ghidra's extension.properties version is the compatible Ghidra version,
|
|
106
|
+
// not the extension release (e.g. v21.4); content identity supplies the latter.
|
|
107
|
+
const parsedProperties = parseGhidraJavaProperties(properties.toString("latin1"));
|
|
108
|
+
if (!parsedProperties.ok)
|
|
109
|
+
throw new Error(`Invalid Allegrex extension properties: ${parsedProperties.error}`);
|
|
110
|
+
const property = (name) => parsedProperties.value.get(name);
|
|
111
|
+
if (property("name") !== "ghidra-allegrex" ||
|
|
112
|
+
property("version") !== ghidraVersion)
|
|
113
|
+
throw new Error(`Allegrex extension metadata does not match the selected Ghidra ${ghidraVersion}; install or rebuild a compatible extension.`);
|
|
114
|
+
signal?.throwIfAborted();
|
|
115
|
+
return {
|
|
116
|
+
id: "ghidra-allegrex",
|
|
117
|
+
root,
|
|
118
|
+
ghidra_version: ghidraVersion,
|
|
119
|
+
sha256: hash.digest("hex"),
|
|
120
|
+
};
|
|
121
|
+
};
|
|
122
|
+
/** Resolve prerequisites before opening or admitting cached PSP analysis. */
|
|
123
|
+
export const resolveGhidraPspExtension = async (installation, signal) => {
|
|
124
|
+
if (signal?.aborted)
|
|
125
|
+
return err(new AnalysisCancelledError("resolve_analysis_profile"));
|
|
126
|
+
try {
|
|
127
|
+
if (installation.status !== "available" ||
|
|
128
|
+
installation.platform !== "linux" ||
|
|
129
|
+
installation.architecture !== "x64")
|
|
130
|
+
throw new Error("The initial PSP profile requires a supported Linux x64 Ghidra installation.");
|
|
131
|
+
const root = join(await realpath(installation.installDir), "Ghidra", "Extensions", "ghidra-allegrex");
|
|
132
|
+
return ok(await inspectGhidraPspExtension(root, installation.providerVersion, signal));
|
|
133
|
+
}
|
|
134
|
+
catch (cause) {
|
|
135
|
+
if (signal?.aborted)
|
|
136
|
+
return err(new AnalysisCancelledError("resolve_analysis_profile"));
|
|
137
|
+
const reason = `PSP_EXTENSION_UNAVAILABLE: ${cause instanceof Error ? cause.message : String(cause)} Use a compatible caller-installed ghidra-allegrex under GHIDRA_INSTALL_DIR/Ghidra/Extensions; REA does not install it.`;
|
|
138
|
+
return err(new AnalysisCapabilityUnavailableError("ghidra", "resolve_analysis_profile", reason, { cause, userMessage: reason }));
|
|
139
|
+
}
|
|
140
|
+
};
|