rea-agents 4.0.1 → 5.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +257 -96
- package/bridge/android/ReaJadxBridge.java +247 -0
- package/bridge/ghidra/ReaGhidraBridge.java +358 -15
- package/bridge/ghidra/ReaGhidraExtensions.java +113 -0
- package/bridge/ghidra/ReaGhidraPrepareCom.java +32 -0
- package/bridge/native/NativeUIChildren.swift +27 -0
- package/bridge/native/ReaNativeUI.swift +30 -16
- package/dist/android/AndroidTargetSnapshot.js +36 -0
- package/dist/android/JadxAnalysis.js +193 -0
- package/dist/android/JadxConfiguration.js +57 -0
- package/dist/android/JadxMcpTransport.js +172 -0
- package/dist/android/JadxProtocol.js +109 -0
- package/dist/android/JadxProvider.js +259 -0
- package/dist/android/JadxRelease.js +27 -0
- package/dist/android/JadxSession.js +111 -0
- package/dist/application/AnalysisContextQueries.js +2 -1
- package/dist/application/AppBundleExecutable.js +141 -0
- package/dist/application/ArtifactExtraction.js +7 -4
- package/dist/application/ArtifactGraphConstruction.js +10 -17
- package/dist/application/ArtifactInventory/classify.js +1 -1
- package/dist/application/ArtifactInventory/scanCanonical.js +9 -8
- package/dist/application/ArtifactInventory/scanReader.js +1 -1
- package/dist/application/ArtifactInventory.js +1 -1
- package/dist/application/BinaryTargetResolver.js +32 -68
- package/dist/application/BrowserObservationService.js +2 -1
- package/dist/application/BrowserScenarioCaptureService.js +2 -1
- package/dist/application/BrowserScenarioEvidence.js +2 -2
- package/dist/application/CallPathTracing.js +2 -1
- package/dist/application/CapabilityInventory.js +78 -2
- package/dist/application/ClientConfigPath.js +3 -1
- package/dist/application/ClientConfigurationDocument.js +83 -13
- package/dist/application/ClientRegistrationStatus.js +15 -9
- package/dist/application/DirectAnalysis.js +35 -21
- package/dist/application/DirectAnalysisStatus.js +7 -8
- package/dist/application/Doctor.js +48 -8
- package/dist/application/DoctorDiagnostics.js +9 -7
- package/dist/application/DoctorScope.js +1 -1
- package/dist/application/EnhancedLiteralTracing.js +2 -1
- package/dist/application/EnhancedToolTypes.js +2 -1
- package/dist/application/EnhancedTools.js +7 -5
- package/dist/application/EvidenceBundleCommands.js +3 -2
- package/dist/application/EvidenceBundleFiles.js +1 -1
- package/dist/application/EvidenceInputResolver.js +30 -0
- package/dist/application/FilesystemSnapshot.js +20 -5
- package/dist/application/FunctionAnalysisEvidence.js +32 -0
- package/dist/application/InventoryProjectionEvidence.js +2 -1
- package/dist/application/InvestigationProviders.js +6 -0
- package/dist/application/JsonFiles.js +1 -1
- package/dist/application/LinuxHopper.js +20 -6
- package/dist/application/MacHopper.js +20 -7
- package/dist/application/OptionalObservationProviders.js +3 -0
- package/dist/application/ProcessCaptureCapability.js +1 -1
- package/dist/application/ProcessCaptureError.js +1 -1
- package/dist/application/ProcessCaptureJournal.js +3 -1
- package/dist/application/ProcessCaptureLifecycle.js +8 -5
- package/dist/application/ProcessCli.js +14 -6
- package/dist/application/ProcessEvidence.js +2 -6
- package/dist/application/ProcessHarness.js +23 -11
- package/dist/application/ProcessNormalization.js +12 -5
- package/dist/application/ProcessSampling.js +3 -1
- package/dist/application/ReconstructionCoverageService.js +4 -7
- package/dist/application/ReconstructionObligationCandidates.js +5 -2
- package/dist/application/ReconstructionObligationLedgerService.js +2 -1
- package/dist/application/ReferenceSourceImport.js +2 -0
- package/dist/application/ReferenceSourceImportEntries.js +22 -3
- package/dist/application/ReferenceSourceImportPolicy.js +4 -2
- package/dist/application/ReferenceSourceImportTypes.js +5 -0
- package/dist/application/ReferenceSourceVcsAdapter.js +35 -4
- package/dist/application/Setup.js +11 -130
- package/dist/application/SetupClientConfiguration.js +36 -22
- package/dist/application/SetupHost.js +126 -0
- package/dist/application/SetupPlan.js +1 -1
- package/dist/application/SetupRegistrationEnvironment.js +1 -2
- package/dist/application/SetupSkill.js +9 -3
- package/dist/application/SetupTypes.js +17 -0
- package/dist/application/StoreFileLock.js +7 -2
- package/dist/application/SupportedClients.js +8 -0
- package/dist/application/Uninstall.js +32 -21
- package/dist/application/UpdateMaintenance.js +3 -3
- package/dist/application/UpdateRuntime.js +5 -2
- package/dist/application/ValidateSelectedWebScript.js +27 -0
- package/dist/application/WebModuleTraceService.js +209 -0
- package/dist/application/WebRuntimeService.js +73 -0
- package/dist/application/WebScriptExportService.js +115 -0
- package/dist/application/WebSourceLocationService.js +160 -0
- package/dist/application/WindowsCapabilities.js +7 -7
- package/dist/application/android/AndroidAnalysisService.js +37 -0
- package/dist/application/{AndroidApplicationService.js → android/AndroidApplicationService.js} +3 -3
- package/dist/application/{AppleApplicationService.js → apple/AppleApplicationService.js} +5 -5
- package/dist/application/{AnalysisClientCleanup.js → binary/AnalysisClientCleanup.js} +2 -2
- package/dist/application/{AnalysisProviderEvaluation.js → binary/AnalysisProviderEvaluation.js} +8 -6
- package/dist/application/{AnalysisProviderRegistry.js → binary/AnalysisProviderRegistry.js} +5 -4
- package/dist/application/{AnalysisSnapshotCache.js → binary/AnalysisSnapshotCache.js} +8 -7
- package/dist/application/{AnalysisSnapshotFiles.js → binary/AnalysisSnapshotFiles.js} +4 -4
- package/dist/application/{BinarySession.js → binary/BinarySession.js} +26 -11
- package/dist/application/{BinarySessionComposition.js → binary/BinarySessionComposition.js} +2 -1
- package/dist/application/{BinarySessionExecution.js → binary/BinarySessionExecution.js} +9 -4
- package/dist/application/{BinarySessionOpen.js → binary/BinarySessionOpen.js} +7 -6
- package/dist/application/{BinarySessionRecords.js → binary/BinarySessionRecords.js} +34 -40
- package/dist/application/{CompositeProvider.js → binary/CompositeProvider.js} +2 -2
- package/dist/application/{LazyAnalysisProvider.js → binary/LazyAnalysisProvider.js} +6 -4
- package/dist/application/{SessionProviderRouter.js → binary/SessionProviderRouter.js} +7 -4
- package/dist/application/firmware/FirmwareAnalysisPort.js +1 -0
- package/dist/application/firmware/FirmwareAnalysisService.js +35 -0
- package/dist/application/{EvidenceLedger.js → investigation/EvidenceLedger.js} +44 -6
- package/dist/application/investigation/InvestigationRecordPort.js +1 -0
- package/dist/application/investigation/InvestigationRecords.js +69 -0
- package/dist/application/{UnknownEvidence.js → investigation/UnknownEvidence.js} +1 -1
- package/dist/application/{ElectronActiveEvidence.js → javascript/ElectronActiveEvidence.js} +4 -4
- package/dist/application/javascript/ElectronActiveObservationPort.js +1 -0
- package/dist/application/{ElectronActiveObservationService.js → javascript/ElectronActiveObservationService.js} +3 -2
- package/dist/application/{ElectronBoundaryAnalysis.js → javascript/ElectronBoundaryAnalysis.js} +1 -1
- package/dist/application/{ElectronBoundaryGraphContext.js → javascript/ElectronBoundaryGraphContext.js} +1 -1
- package/dist/application/{ElectronEvidence.js → javascript/ElectronEvidence.js} +2 -2
- package/dist/application/javascript/ElectronObservationPort.js +1 -0
- package/dist/application/{ElectronObservationService.js → javascript/ElectronObservationService.js} +3 -2
- package/dist/application/{JavaScriptApplicationEvidence.js → javascript/JavaScriptApplicationEvidence.js} +3 -3
- package/dist/application/{JavaScriptApplicationEvidenceGraph.js → javascript/JavaScriptApplicationEvidenceGraph.js} +5 -5
- package/dist/application/javascript/JavaScriptApplicationService.js +99 -0
- package/dist/application/{JavaScriptApplicationWorkflowEvidence.js → javascript/JavaScriptApplicationWorkflowEvidence.js} +3 -3
- package/dist/application/{JavaScriptApplicationWorkflowService.js → javascript/JavaScriptApplicationWorkflowService.js} +12 -11
- package/dist/application/{JavaScriptArtifactAnalysis.js → javascript/JavaScriptArtifactAnalysis.js} +12 -26
- package/dist/application/javascript/JavaScriptArtifactAnalysisTypes.js +1 -0
- package/dist/application/{JavaScriptArtifactGraphAccumulator.js → javascript/JavaScriptArtifactGraphAccumulator.js} +16 -2
- package/dist/application/{JavaScriptArtifactGraphBuilder.js → javascript/JavaScriptArtifactGraphBuilder.js} +2 -2
- package/dist/application/{JavaScriptArtifactGraphContext.js → javascript/JavaScriptArtifactGraphContext.js} +1 -1
- package/dist/application/{JavaScriptArtifactGraphDocuments.js → javascript/JavaScriptArtifactGraphDocuments.js} +1 -1
- package/dist/application/{JavaScriptArtifactGraphFindings.js → javascript/JavaScriptArtifactGraphFindings.js} +20 -7
- package/dist/application/{JavaScriptArtifactGraphStructure.js → javascript/JavaScriptArtifactGraphStructure.js} +1 -1
- package/dist/application/{JavaScriptArtifactPathResolution.js → javascript/JavaScriptArtifactPathResolution.js} +12 -14
- package/dist/application/{JavaScriptArtifactReconstruction.js → javascript/JavaScriptArtifactReconstruction.js} +4 -8
- package/dist/application/{JavaScriptJsonModules.js → javascript/JavaScriptJsonModules.js} +3 -2
- package/dist/application/{JavaScriptModuleRelationships.js → javascript/JavaScriptModuleRelationships.js} +5 -3
- package/dist/application/javascript/JavaScriptRecoveryPort.js +1 -0
- package/dist/application/javascript/JavaScriptRecoveryService.js +52 -0
- package/dist/application/{JavaScriptReturnShapeProjection.js → javascript/JavaScriptReturnShapeProjection.js} +3 -3
- package/dist/application/{JavaScriptRuntimeObservationEvidence.js → javascript/JavaScriptRuntimeObservationEvidence.js} +2 -2
- package/dist/application/javascript/JavaScriptRuntimeObservationPort.js +1 -0
- package/dist/application/{JavaScriptRuntimeObservationService.js → javascript/JavaScriptRuntimeObservationService.js} +3 -2
- package/dist/application/{JavaScriptRuntimeReconciliationEvidence.js → javascript/JavaScriptRuntimeReconciliationEvidence.js} +3 -3
- package/dist/application/{JavaScriptRuntimeReconciliationService.js → javascript/JavaScriptRuntimeReconciliationService.js} +6 -5
- package/dist/application/{JavaScriptSemanticGraphAsyncProjection.js → javascript/JavaScriptSemanticGraphAsyncProjection.js} +1 -1
- package/dist/application/{JavaScriptSemanticGraphBuilder.js → javascript/JavaScriptSemanticGraphBuilder.js} +5 -3
- package/dist/application/{JavaScriptSemanticGraphChildProcessProjection.js → javascript/JavaScriptSemanticGraphChildProcessProjection.js} +1 -1
- package/dist/application/{JavaScriptSemanticGraphConstruction.js → javascript/JavaScriptSemanticGraphConstruction.js} +3 -2
- package/dist/application/{JavaScriptSemanticGraphDataProjection.js → javascript/JavaScriptSemanticGraphDataProjection.js} +1 -1
- package/dist/application/{JavaScriptSemanticGraphFingerprintProjection.js → javascript/JavaScriptSemanticGraphFingerprintProjection.js} +1 -1
- package/dist/application/{JavaScriptSemanticGraphFlowProjection.js → javascript/JavaScriptSemanticGraphFlowProjection.js} +2 -2
- package/dist/application/{JavaScriptSemanticGraphObjectProjection.js → javascript/JavaScriptSemanticGraphObjectProjection.js} +1 -1
- package/dist/application/{JavaScriptSemanticGraphProjection.js → javascript/JavaScriptSemanticGraphProjection.js} +2 -2
- package/dist/application/{JavaScriptSemanticGraphResourceProjection.js → javascript/JavaScriptSemanticGraphResourceProjection.js} +1 -1
- package/dist/application/{JavaScriptSemanticTraceService.js → javascript/JavaScriptSemanticTraceService.js} +6 -5
- package/dist/application/{ManagedApplicationGraphService.js → managed/ManagedApplicationGraphService.js} +7 -6
- package/dist/application/{ManagedMemberComparisonService.js → managed/ManagedMemberComparisonService.js} +10 -8
- package/dist/application/{ManagedNativeVerificationService.js → managed/ManagedNativeVerificationService.js} +7 -6
- package/dist/application/{ManagedReconstructionService.js → managed/ManagedReconstructionService.js} +7 -6
- package/dist/application/{NativeApiInspection.js → native/NativeApiInspection.js} +1 -1
- package/dist/application/{NativeCallRoutes.js → native/NativeCallRoutes.js} +3 -3
- package/dist/application/{NativeDispatchMetadataInspection.js → native/NativeDispatchMetadataInspection.js} +4 -4
- package/dist/application/{NativeUiActionTrace.js → native/NativeUiActionTrace.js} +7 -6
- package/dist/application/{NativeValueTrace.js → native/NativeValueTrace.js} +6 -6
- package/dist/{application/ArtifactInventory/hash.js → artifacts/ArtifactHash.js} +4 -2
- package/dist/artifacts/ArtifactPaths.js +3 -3
- package/dist/artifacts/ArtifactProvider.js +10 -38
- package/dist/artifacts/ArtifactProviderMetadata.js +36 -0
- package/dist/artifacts/AsarArtifactReader.js +195 -23
- package/dist/artifacts/AsarEntryStream.js +76 -0
- package/dist/artifacts/DirectoryArtifactReader.js +43 -7
- package/dist/artifacts/NativeDmgArtifactReader.js +171 -12
- package/dist/artifacts/SafeOutputTree.js +26 -10
- package/dist/artifacts/ZipArtifactReader.js +1 -0
- package/dist/{application → artifacts/apple}/AppleAssetCatalogAnalysis.js +4 -4
- package/dist/{application → artifacts/apple}/InterfaceBuilderAnalysis.js +125 -51
- package/dist/artifacts/{KeyedArchiveReader.js → apple/KeyedArchiveReader.js} +21 -27
- package/dist/artifacts/{NibArchive.js → apple/NibArchive.js} +4 -2
- package/dist/artifacts/apple/NibViewHierarchy.js +150 -0
- package/dist/{application → artifacts/javascript}/JavaScriptArtifactFiles.js +30 -7
- package/dist/artifacts/javascript/JavaScriptArtifactReader.js +6 -0
- package/dist/artifacts/readStableArtifact.js +52 -0
- package/dist/browser/BrowserProcessStartup.js +3 -1
- package/dist/browser/BrowserScenarioSecrets.js +50 -8
- package/dist/browser/CdpAuthorizedMainFrame.js +5 -5
- package/dist/browser/CdpAuthorizedTarget.js +22 -0
- package/dist/browser/CdpBrowserProvider.js +8 -16
- package/dist/browser/CdpCaptureDocuments.js +36 -22
- package/dist/browser/CdpCaptureEventBodyShapes.js +3 -3
- package/dist/browser/CdpCaptureEventHandlers.js +32 -28
- package/dist/browser/CdpCaptureEventHelpers.js +6 -6
- package/dist/browser/CdpCaptureStorage.js +10 -8
- package/dist/browser/CdpCaptureStorageFingerprints.js +25 -23
- package/dist/browser/CdpCaptureValues.js +8 -4
- package/dist/browser/CdpCommandRejection.js +17 -0
- package/dist/browser/CdpConnection.js +59 -17
- package/dist/browser/CdpElectronInspection.js +13 -13
- package/dist/browser/CdpElectronProvider.js +7 -7
- package/dist/browser/CdpElectronScriptEvents.js +6 -6
- package/dist/browser/CdpElectronScripts.js +4 -4
- package/dist/browser/CdpElectronWorkers.js +4 -4
- package/dist/browser/CdpEndpoint.js +22 -10
- package/dist/browser/CdpObservationSession.js +20 -24
- package/dist/browser/CdpOptionalCommand.js +1 -1
- package/dist/browser/CdpPageCapture.js +6 -5
- package/dist/browser/CdpPageCaptureScripts.js +2 -2
- package/dist/browser/CdpPageCaptureWorkers.js +9 -9
- package/dist/browser/CdpSafeMetadata.js +101 -18
- package/dist/browser/CdpScreenshot.js +6 -6
- package/dist/browser/CdpTargetEvents.js +8 -0
- package/dist/browser/CdpTargetSession.js +10 -7
- package/dist/browser/CdpWebMcpDiscovery.js +23 -17
- package/dist/browser/ElectronFileScope.js +9 -3
- package/dist/browser/PlaywrightBrowserScenarioProvider.js +10 -7
- package/dist/browser/PlaywrightElectronActiveActions.js +1 -1
- package/dist/browser/PlaywrightElectronActiveProvider.js +9 -8
- package/dist/browser/PlaywrightExecutionBoundary.js +1 -1
- package/dist/browser/PlaywrightScenarioArtifacts.js +10 -5
- package/dist/browser/PlaywrightScenarioBrowser.js +3 -1
- package/dist/browser/PlaywrightScenarioEvents.js +65 -53
- package/dist/browser/PlaywrightScenarioSession.js +13 -3
- package/dist/browser/WebSourceMapFetcher.js +55 -58
- package/dist/browser/assets/LocalWebScriptArtifacts.js +87 -0
- package/dist/browser/assets/PageScriptCapture.js +32 -0
- package/dist/browser/assets/PublishWebScripts.js +74 -0
- package/dist/browser/assets/ScenarioScriptCapture.js +76 -0
- package/dist/browser/assets/ScriptCaptureAdapters.js +57 -0
- package/dist/browser/assets/WebArtifactReads.js +56 -0
- package/dist/browser/assets/WebSourceLocationArtifacts.js +40 -0
- package/dist/browser/execution/CdpEventListeners.js +79 -0
- package/dist/browser/execution/CdpExecutionCapture.js +135 -0
- package/dist/browser/execution/CdpExecutionCollection.js +57 -0
- package/dist/browser/execution/CdpExecutionWindow.js +100 -0
- package/dist/browser/execution/CdpListenerSelector.js +22 -0
- package/dist/browser/execution/CdpPreciseCoverage.js +48 -0
- package/dist/browser/execution/CdpRuntimeInitiator.js +18 -0
- package/dist/browser/execution/CdpRuntimeProtocol.js +106 -0
- package/dist/browser/execution/CdpRuntimeRequests.js +81 -0
- package/dist/browser/execution/CdpRuntimeSession.js +163 -0
- package/dist/browser/execution/CdpRuntimeSources.js +223 -0
- package/dist/browser/execution/CdpWebRuntimeProvider.js +51 -0
- package/dist/browser/modules/NativeModuleResolver.js +210 -0
- package/dist/browser/modules/WebModuleArtifacts.js +40 -0
- package/dist/browser/network/PlaywrightNetworkContent.js +71 -0
- package/dist/browser/network/PlaywrightScenarioNetwork.js +180 -0
- package/dist/browser/providerIdentities.js +24 -0
- package/dist/catalogIdentity.js +23 -15
- package/dist/cli/androidCommands.js +91 -0
- package/dist/{cliApplicationCommands.js → cli/applicationCommands.js} +49 -16
- package/dist/cli/artifactCommands.js +1 -1
- package/dist/{cliBrowserAdvancedCommands.js → cli/browserAdvancedCommands.js} +39 -24
- package/dist/{cliBrowserCommands.js → cli/browserCommands.js} +9 -9
- package/dist/cli/commandCancellation.js +24 -0
- package/dist/cli/coreAnalysisCommands.js +5 -400
- package/dist/cli/coreBinaryCommands.js +211 -0
- package/dist/cli/coreNativeCommands.js +293 -0
- package/dist/{cliElectronCommands.js → cli/electronCommands.js} +20 -24
- package/dist/cli/firmwareCommands.js +75 -0
- package/dist/{cliSetup.js → cli/interactiveSetup.js} +1 -1
- package/dist/cli/javascriptApplicationAnalysis.js +2 -2
- package/dist/cli/javascriptRecoveryCommands.js +45 -0
- package/dist/cli/managedCommands.js +5 -5
- package/dist/cli/managedProjectGraphCommand.js +2 -2
- package/dist/cli/options.js +7 -1
- package/dist/{cliProcessCommands.js → cli/processCommands.js} +3 -3
- package/dist/cli/referenceSourceImportStatus.js +15 -0
- package/dist/cli/setupCommands.js +4 -2
- package/dist/cli/utilityCommands.js +50 -25
- package/dist/cli/webModuleCommands.js +56 -0
- package/dist/cli/webRuntimeCommands.js +60 -0
- package/dist/cli/webScriptCommands.js +31 -0
- package/dist/cli/webSourceLocationCommands.js +42 -0
- package/dist/cli.js +20 -15
- package/dist/cliBrowserContext.js +5 -3
- package/dist/cliBrowserScenarioCommands.js +6 -4
- package/dist/cliCommandNames.js +19 -2
- package/dist/cliEvidenceCommands.js +2 -1
- package/dist/cliJavaScriptRuntimeCommands.js +8 -5
- package/dist/cliJsonInput.js +35 -13
- package/dist/cliLogging.js +2 -1
- package/dist/cliOutput.js +52 -27
- package/dist/composition/android.js +3 -0
- package/dist/composition/auxiliaryAnalysisProviders.js +30 -0
- package/dist/composition/binary.js +25 -0
- package/dist/composition/browserObservation.js +3 -0
- package/dist/composition/browserScenario.js +3 -0
- package/dist/composition/directAnalysis.js +17 -0
- package/dist/composition/electronObservation.js +3 -0
- package/dist/composition/electronScenario.js +3 -0
- package/dist/composition/firmware.js +3 -0
- package/dist/composition/javascriptRecovery.js +3 -0
- package/dist/composition/javascriptRuntimeObservation.js +3 -0
- package/dist/composition/optionalObservationProviders.js +49 -0
- package/dist/composition/webModules.js +5 -0
- package/dist/composition/webRuntime.js +4 -0
- package/dist/composition/webSourceLocations.js +5 -0
- package/dist/config/environment.js +11 -1
- package/dist/config/parseConfig.js +29 -4
- package/dist/config/parsers.js +1 -1
- package/dist/contracts/android/androidToolContracts.js +77 -0
- package/dist/contracts/applicationToolContracts.js +75 -13
- package/dist/contracts/artifactComparisonExample.js +7 -14
- package/dist/contracts/artifactToolContracts.js +2 -2
- package/dist/contracts/browserScenarioToolContracts.js +1 -1
- package/dist/contracts/enhancedInputs.js +1 -1
- package/dist/contracts/enhancedToolContracts.js +31 -0
- package/dist/contracts/errorSchemas.js +4 -2
- package/dist/contracts/evidenceInputContracts.js +13 -0
- package/dist/contracts/firmware/firmwareToolContracts.js +38 -0
- package/dist/contracts/{applicationWorkflowInputContracts.js → javascript/applicationWorkflowInputContracts.js} +18 -18
- package/dist/contracts/{electronToolContracts.js → javascript/electronToolContracts.js} +6 -6
- package/dist/contracts/{javascriptApplicationWorkflowExamples.js → javascript/javascriptApplicationWorkflowExamples.js} +3 -3
- package/dist/contracts/javascript/javascriptRecoveryToolContracts.js +23 -0
- package/dist/contracts/{javascriptRuntimeObservationToolContracts.js → javascript/javascriptRuntimeObservationToolContracts.js} +3 -3
- package/dist/contracts/{javascriptRuntimeReconciliationExample.js → javascript/javascriptRuntimeReconciliationExample.js} +5 -5
- package/dist/contracts/{managedToolContracts.js → managed/managedToolContracts.js} +3 -3
- package/dist/contracts/{managedWorkflowExamples.js → managed/managedWorkflowExamples.js} +1 -1
- package/dist/contracts/{managedWorkflowToolContracts.js → managed/managedWorkflowToolContracts.js} +6 -6
- package/dist/contracts/mobileApplicationGraphExamples.js +105 -0
- package/dist/contracts/{nativeToolContracts.js → native/nativeToolContracts.js} +14 -7
- package/dist/contracts/officialToolContracts.js +66 -0
- package/dist/contracts/promptContracts.js +1 -1
- package/dist/contracts/sessionLifecycleInputs.js +4 -0
- package/dist/contracts/sessionToolContracts.js +43 -0
- package/dist/contracts/sessionToolSchemas.js +1 -1
- package/dist/contracts/toolContractExamples.js +5 -0
- package/dist/contracts/toolContractTypes.js +2 -0
- package/dist/contracts/toolContracts.js +18 -135
- package/dist/contracts/toolEffects.js +75 -0
- package/dist/contracts/toolOutputSchemaGroups.js +20 -16
- package/dist/contracts/toolOutputSchemaPrimitives.js +1 -0
- package/dist/contracts/webRuntimeToolContracts.js +43 -0
- package/dist/contracts/webScriptToolContracts.js +68 -0
- package/dist/doctorRuntime.js +5 -1
- package/dist/domain/analysisErrorBase.js +33 -0
- package/dist/domain/analysisErrorCore.js +62 -0
- package/dist/domain/analysisErrorPresentation.js +22 -2
- package/dist/domain/analysisErrorProjection.js +25 -3
- package/dist/domain/analysisSnapshot.js +1 -0
- package/dist/domain/android/androidAnalysis.js +141 -0
- package/dist/domain/{androidApplication.js → android/androidApplication.js} +7 -6
- package/dist/domain/apple/appleApplication.js +277 -0
- package/dist/domain/{appleAssetCatalog.js → apple/appleAssetCatalog.js} +2 -2
- package/dist/domain/apple/appleBundleAnatomy.js +236 -0
- package/dist/domain/{interfaceBuilderGraph.js → apple/interfaceBuilderGraph.js} +47 -312
- package/dist/domain/apple/interfaceBuilderKeyedArchive.js +411 -0
- package/dist/domain/{keyedArchive.js → apple/keyedArchive.js} +10 -9
- package/dist/domain/apple/plistValue.js +35 -0
- package/dist/domain/artifactGraph.js +1 -0
- package/dist/domain/artifactInspection.js +19 -17
- package/dist/domain/artifactInventoryEvidence.js +32 -27
- package/dist/domain/artifactInventorySnapshot.js +1 -0
- package/dist/domain/artifactOperationError.js +20 -0
- package/dist/domain/artifactPathSyntax.js +26 -0
- package/dist/domain/browserNetworkEvidence.js +82 -0
- package/dist/domain/browserObservation.js +12 -4
- package/dist/domain/browserObservationError.js +25 -0
- package/dist/domain/browserObservationSchemas.js +2 -1
- package/dist/domain/browserScenario.js +1 -1
- package/dist/domain/browserScenarioCapture.js +23 -1
- package/dist/domain/browserScenarioCaptureValues.js +25 -0
- package/dist/domain/browserScenarioDiff.js +7 -4
- package/dist/domain/browserScenarioDiffEvidence.js +35 -1
- package/dist/domain/browserScenarioNormalization.js +6 -11
- package/dist/domain/browserScenarioValues.js +15 -2
- package/dist/domain/browserSession.js +2 -7
- package/dist/domain/bundleComparison.js +2 -1
- package/dist/domain/callPath.js +86 -38
- package/dist/domain/canonicalDigest.js +65 -0
- package/dist/domain/canonicalOrdering.js +11 -0
- package/dist/domain/changedBehavior.js +8 -7
- package/dist/domain/comparisonSemantics.js +2 -4
- package/dist/domain/comparisonStatus.js +39 -0
- package/dist/domain/configurationErrors.js +25 -0
- package/dist/domain/dosCom.js +8 -0
- package/dist/domain/evidence.js +3 -11
- package/dist/domain/evidenceBundle.js +98 -35
- package/dist/domain/evidenceErrors.js +30 -0
- package/dist/domain/firmware/firmwareAnalysis.js +121 -0
- package/dist/domain/functionComparison.js +4 -2
- package/dist/domain/functionComparisonDimensions.js +6 -4
- package/dist/domain/functionComparisonNormalization.js +13 -8
- package/dist/domain/functionComparisonResults.js +1 -4
- package/dist/domain/hopperErrors.js +78 -0
- package/dist/domain/hopperValues.js +4 -3
- package/dist/domain/inputIssueProjection.js +17 -2
- package/dist/domain/{electronActiveObservation.js → javascript/electronActiveObservation.js} +3 -1
- package/dist/domain/{electronObservation.js → javascript/electronObservation.js} +5 -11
- package/dist/domain/{electronStaticAnalysisBrowser.js → javascript/electronStaticAnalysisBrowser.js} +15 -24
- package/dist/domain/{electronStaticAnalysisIpc.js → javascript/electronStaticAnalysisIpc.js} +2 -2
- package/dist/domain/{electronStaticAnalysisNative.js → javascript/electronStaticAnalysisNative.js} +12 -12
- package/dist/domain/javascript/electronStaticAnalysisTypes.js +1 -0
- package/dist/domain/{electronStaticAnalysisValues.js → javascript/electronStaticAnalysisValues.js} +24 -4
- package/dist/domain/{javascriptApplicationAnalysis.js → javascript/javascriptApplicationAnalysis.js} +2 -2
- package/dist/domain/{javascriptApplicationChangeGraph.js → javascript/javascriptApplicationChangeGraph.js} +2 -2
- package/dist/domain/{javascriptApplicationEvidenceSchemas.js → javascript/javascriptApplicationEvidenceSchemas.js} +6 -4
- package/dist/domain/{javascriptApplicationGraph.js → javascript/javascriptApplicationGraph.js} +13 -22
- package/dist/domain/{javascriptApplicationGraphSchemas.js → javascript/javascriptApplicationGraphSchemas.js} +2 -2
- package/dist/domain/{javascriptApplicationVersionComparison.js → javascript/javascriptApplicationVersionComparison.js} +3 -11
- package/dist/domain/{javascriptApplicationVersionComparisonSchemas.js → javascript/javascriptApplicationVersionComparisonSchemas.js} +3 -3
- package/dist/domain/{javascriptApplicationVersionItems.js → javascript/javascriptApplicationVersionItems.js} +4 -4
- package/dist/domain/{javascriptApplicationVersionKeys.js → javascript/javascriptApplicationVersionKeys.js} +16 -9
- package/dist/domain/javascript/javascriptArtifactFiles.js +1 -0
- package/dist/domain/{javascriptAstFingerprint.js → javascript/javascriptAstFingerprint.js} +38 -22
- package/dist/domain/javascript/javascriptAstValues.js +23 -0
- package/dist/domain/{javascriptExportShapeComparison.js → javascript/javascriptExportShapeComparison.js} +1 -2
- package/dist/domain/{javascriptExportShapeComparisonSchemas.js → javascript/javascriptExportShapeComparisonSchemas.js} +2 -2
- package/dist/domain/{javascriptExportShapeSelection.js → javascript/javascriptExportShapeSelection.js} +1 -1
- package/dist/domain/{javascriptExportShapeVariants.js → javascript/javascriptExportShapeVariants.js} +7 -3
- package/dist/domain/{javascriptFeatureSeed.js → javascript/javascriptFeatureSeed.js} +32 -11
- package/dist/domain/{javascriptFeatureTrace.js → javascript/javascriptFeatureTrace.js} +9 -13
- package/dist/domain/{javascriptFeatureTraceSchemas.js → javascript/javascriptFeatureTraceSchemas.js} +32 -18
- package/dist/domain/{javascriptFeatureTraversal.js → javascript/javascriptFeatureTraversal.js} +7 -2
- package/dist/domain/{javascriptNativeHandoff.js → javascript/javascriptNativeHandoff.js} +2 -1
- package/dist/domain/javascript/javascriptRecovery.js +88 -0
- package/dist/domain/{javascriptRuntimeLoadState.js → javascript/javascriptRuntimeLoadState.js} +2 -2
- package/dist/domain/{javascriptRuntimeObservation.js → javascript/javascriptRuntimeObservation.js} +2 -2
- package/dist/domain/{javascriptRuntimeReconciliationActive.js → javascript/javascriptRuntimeReconciliationActive.js} +5 -12
- package/dist/domain/{javascriptRuntimeReconciliationGraph.js → javascript/javascriptRuntimeReconciliationGraph.js} +2 -2
- package/dist/domain/{javascriptRuntimeReconciliationMatching.js → javascript/javascriptRuntimeReconciliationMatching.js} +4 -3
- package/dist/domain/{javascriptRuntimeReconciliationParsing.js → javascript/javascriptRuntimeReconciliationParsing.js} +11 -17
- package/dist/domain/{javascriptRuntimeReconciliationResult.js → javascript/javascriptRuntimeReconciliationResult.js} +4 -4
- package/dist/domain/{javascriptRuntimeReconciliationSchemas.js → javascript/javascriptRuntimeReconciliationSchemas.js} +8 -5
- package/dist/domain/{javascriptRuntimeStaticCandidates.js → javascript/javascriptRuntimeStaticCandidates.js} +8 -4
- package/dist/domain/{javascriptSemanticAnalysis.js → javascript/javascriptSemanticAnalysis.js} +80 -17
- package/dist/domain/{javascriptSemanticAsyncEffects.js → javascript/javascriptSemanticAsyncEffects.js} +2 -1
- package/dist/domain/{javascriptSemanticCallResolution.js → javascript/javascriptSemanticCallResolution.js} +11 -5
- package/dist/domain/{javascriptSemanticCalls.js → javascript/javascriptSemanticCalls.js} +7 -4
- package/dist/domain/{javascriptSemanticChildProcesses.js → javascript/javascriptSemanticChildProcesses.js} +5 -2
- package/dist/domain/{javascriptSemanticDataEffectHelpers.js → javascript/javascriptSemanticDataEffectHelpers.js} +7 -6
- package/dist/domain/{javascriptSemanticDataEffects.js → javascript/javascriptSemanticDataEffects.js} +9 -6
- package/dist/domain/{javascriptSemanticFingerprints.js → javascript/javascriptSemanticFingerprints.js} +40 -16
- package/dist/domain/{javascriptSemanticGraph.js → javascript/javascriptSemanticGraph.js} +23 -28
- package/dist/domain/{javascriptSemanticGraphSchemas.js → javascript/javascriptSemanticGraphSchemas.js} +3 -3
- package/dist/domain/javascript/javascriptSemanticMemberMutations.js +116 -0
- package/dist/domain/javascript/javascriptSemanticMutationValues.js +53 -0
- package/dist/domain/{javascriptSemanticObjects.js → javascript/javascriptSemanticObjects.js} +5 -5
- package/dist/domain/{javascriptSemanticPrimitives.js → javascript/javascriptSemanticPrimitives.js} +9 -2
- package/dist/domain/{javascriptSemanticProjection.js → javascript/javascriptSemanticProjection.js} +32 -44
- package/dist/domain/{javascriptSemanticPromises.js → javascript/javascriptSemanticPromises.js} +77 -21
- package/dist/domain/{javascriptSemanticProvenance.js → javascript/javascriptSemanticProvenance.js} +4 -1
- package/dist/domain/{javascriptSemanticQuery.js → javascript/javascriptSemanticQuery.js} +7 -8
- package/dist/domain/{javascriptSemanticQueryAssessment.js → javascript/javascriptSemanticQueryAssessment.js} +1 -2
- package/dist/domain/{javascriptSemanticQueryIdentity.js → javascript/javascriptSemanticQueryIdentity.js} +1 -2
- package/dist/domain/{javascriptSemanticQuerySchemas.js → javascript/javascriptSemanticQuerySchemas.js} +3 -3
- package/dist/domain/javascript/javascriptSemanticRequireOrigin.js +25 -0
- package/dist/domain/{javascriptSemanticResources.js → javascript/javascriptSemanticResources.js} +2 -1
- package/dist/domain/{javascriptSemanticReturns.js → javascript/javascriptSemanticReturns.js} +2 -1
- package/dist/domain/{javascriptSemanticTraceSchemas.js → javascript/javascriptSemanticTraceSchemas.js} +2 -2
- package/dist/domain/javascript/javascriptSemanticTraversal.js +55 -0
- package/dist/domain/javascript/javascriptSemanticValueTypes.js +1 -0
- package/dist/domain/{javascriptSemanticValues.js → javascript/javascriptSemanticValues.js} +118 -60
- package/dist/domain/{javascriptSourceParser.js → javascript/javascriptSourceParser.js} +4 -2
- package/dist/domain/{javascriptStaticAnalysis.js → javascript/javascriptStaticAnalysis.js} +8 -5
- package/dist/domain/{javascriptStaticAnalysisBundler.js → javascript/javascriptStaticAnalysisBundler.js} +15 -11
- package/dist/domain/{javascriptStaticAnalysisCalls.js → javascript/javascriptStaticAnalysisCalls.js} +16 -8
- package/dist/domain/{javascriptStaticAnalysisHelpers.js → javascript/javascriptStaticAnalysisHelpers.js} +261 -43
- package/dist/domain/{sourceToBundleComparison.js → javascript/sourceToBundleComparison.js} +6 -8
- package/dist/domain/{sourceToBundleComparisonSchemas.js → javascript/sourceToBundleComparisonSchemas.js} +4 -4
- package/dist/domain/{sourceToBundleSignals.js → javascript/sourceToBundleSignals.js} +7 -7
- package/dist/domain/jsonShape.js +6 -2
- package/dist/domain/{managedApplicationGraph.js → managed/managedApplicationGraph.js} +4 -4
- package/dist/domain/{managedApplicationGraphNodes.js → managed/managedApplicationGraphNodes.js} +1 -1
- package/dist/domain/{managedArtifact.js → managed/managedArtifact.js} +1 -1
- package/dist/domain/{managedMemberComparison.js → managed/managedMemberComparison.js} +5 -4
- package/dist/domain/{managedMemberComparisonCoverage.js → managed/managedMemberComparisonCoverage.js} +2 -1
- package/dist/domain/{managedMemberComparisonItems.js → managed/managedMemberComparisonItems.js} +99 -40
- package/dist/domain/{managedMemberComparisonMatch.js → managed/managedMemberComparisonMatch.js} +22 -11
- package/dist/domain/{managedNativeVerification.js → managed/managedNativeVerification.js} +1 -1
- package/dist/domain/{managedNativeVerificationMatch.js → managed/managedNativeVerificationMatch.js} +8 -6
- package/dist/domain/{managedNativeVerificationSchemas.js → managed/managedNativeVerificationSchemas.js} +6 -5
- package/dist/domain/{managedReconstruction.js → managed/managedReconstruction.js} +3 -3
- package/dist/domain/{nativeDataType.js → native/nativeDataType.js} +2 -0
- package/dist/domain/native/nativeFunctionAnnotations.js +43 -0
- package/dist/domain/{nativeInspection.js → native/nativeInspection.js} +1 -1
- package/dist/domain/{nativeInvestigationGraph.js → native/nativeInvestigationGraph.js} +13 -4
- package/dist/domain/native/nativeLoadImage.js +95 -0
- package/dist/domain/native/nativeMetadataRecovery.js +55 -0
- package/dist/domain/{nativeUiObservation.js → native/nativeUiObservation.js} +20 -6
- package/dist/domain/{objcSwiftMetadata.js → native/objcSwiftMetadata.js} +17 -0
- package/dist/domain/processCapture.js +4 -3
- package/dist/domain/processEvidenceProvider.js +11 -0
- package/dist/domain/processScenario.js +17 -17
- package/dist/domain/processTraceComparison.js +1 -1
- package/dist/domain/propertyListKeys.js +69 -0
- package/dist/domain/providerAdapterError.js +17 -0
- package/dist/domain/providerCleanupError.js +6 -3
- package/dist/domain/providerSelectionError.js +44 -0
- package/dist/domain/reconstructionCoverageEvaluation.js +46 -24
- package/dist/domain/reconstructionCoverageInput.js +7 -0
- package/dist/domain/reconstructionUnknowns.js +1 -1
- package/dist/domain/reconstructionVerification.js +22 -8
- package/dist/domain/referenceSourceClassification.js +5 -6
- package/dist/domain/referenceSourceGraph.js +9 -17
- package/dist/domain/referenceSourceImportParsing.js +38 -23
- package/dist/domain/runtimeIdentification.js +1 -1
- package/dist/domain/runtimeVersion.js +6 -7
- package/dist/domain/safeJson.js +13 -0
- package/dist/domain/sourceMapEnvelope.js +38 -0
- package/dist/domain/staticRuntimeCorrelation.js +9 -7
- package/dist/domain/unicodeCodePointOrder.js +11 -6
- package/dist/domain/unknownRegistryError.js +10 -0
- package/dist/domain/webBundleAnalyzerAst.js +23 -38
- package/dist/domain/webBundleAnalyzerInspection.js +29 -20
- package/dist/domain/webEventListeners.js +28 -0
- package/dist/domain/webExecution.js +74 -0
- package/dist/domain/webMcpDiscovery.js +1 -7
- package/dist/domain/webModuleImports.js +104 -0
- package/dist/domain/webModuleTrace.js +106 -0
- package/dist/domain/webRuntime.js +69 -0
- package/dist/domain/webScreenshot.js +1 -7
- package/dist/domain/webScriptArtifacts.js +39 -0
- package/dist/domain/webScriptExport.js +86 -0
- package/dist/domain/webScriptExportError.js +13 -0
- package/dist/domain/webScriptExportPlan.js +108 -0
- package/dist/domain/webSourceLocation.js +106 -0
- package/dist/domain/webSourcePosition.js +21 -0
- package/dist/dotnet/ManagedArtifactInspector.js +1 -1
- package/dist/dotnet/ManagedMemberInspector.js +1 -1
- package/dist/dotnet/ManagedMemberInspectorCore.js +34 -0
- package/dist/dotnet/ManagedMemberRows.js +6 -4
- package/dist/dotnet/ManagedMetadataHeaps.js +3 -2
- package/dist/dotnet/ManagedMetadataInventoryRows.js +4 -2
- package/dist/dotnet/ManagedMethodBodyReader.js +8 -1
- package/dist/dotnet/ManagedNativeBoundaryHelpers.js +22 -16
- package/dist/dotnet/ManagedNativeBoundaryInspector.js +56 -50
- package/dist/dotnet/ManagedStaticProvider.js +6 -34
- package/dist/dotnet/ManagedStaticProviderMetadata.js +36 -0
- package/dist/evaluation/CodexAgentEval.js +2 -1
- package/dist/firmware/FirmwareCommand.js +163 -0
- package/dist/firmware/FirmwareFiles.js +190 -0
- package/dist/firmware/FirmwareProvider.js +264 -0
- package/dist/firmware/FirmwarePublication.js +84 -0
- package/dist/firmware/FirmwareRelease.js +32 -0
- package/dist/firmware/FirmwareReports.js +235 -0
- package/dist/firmware/FirmwareVersion.js +80 -0
- package/dist/generatedMcpToolCatalog.js +1 -1
- package/dist/generatedPackageMetadata.js +5 -5
- package/dist/ghidra/GhidraAnalysisProfile.js +37 -8
- package/dist/ghidra/GhidraClient.js +52 -6
- package/dist/ghidra/GhidraDiagnostics.js +3 -0
- package/dist/ghidra/GhidraDoctor.js +38 -14
- package/dist/ghidra/GhidraFunctionValues.js +14 -8
- package/dist/ghidra/GhidraInstallation.js +48 -38
- package/dist/ghidra/GhidraInstallationPolicy.js +140 -0
- package/dist/ghidra/GhidraInventoryValues.js +39 -2
- package/dist/ghidra/GhidraLauncher.js +102 -29
- package/dist/ghidra/GhidraLoadImageAttest.js +36 -0
- package/dist/ghidra/GhidraLoadImageValues.js +199 -0
- package/dist/ghidra/GhidraProvider.js +47 -149
- package/dist/ghidra/GhidraProviderCapabilities.js +58 -28
- package/dist/ghidra/GhidraProviderClient.js +209 -0
- package/dist/ghidra/GhidraRequestQueue.js +2 -2
- package/dist/ghidra/GhidraResponseBuffer.js +7 -1
- package/dist/ghidra/GhidraSessionError.js +31 -4
- package/dist/ghidra/GhidraSessionValues.js +10 -7
- package/dist/ghidra/GhidraTargetSnapshot.js +16 -2
- package/dist/ghidra/GhidraTransport.js +12 -0
- package/dist/ghidra/extensions/GhidraExtensionFailures.js +20 -0
- package/dist/ghidra/extensions/GhidraExtensions.js +170 -0
- package/dist/ghidra/extensions/nativeaot/NativeAotAdapter.js +21 -0
- package/dist/ghidra/extensions/nativeaot/NativeAotReport.js +100 -0
- package/dist/hopper/BridgeLauncher.js +4 -2
- package/dist/hopper/HopperAnalysisProfile.js +7 -2
- package/dist/hopper/HopperCleanup.js +55 -9
- package/dist/hopper/HopperClient.js +14 -4
- package/dist/hopper/HopperProcessDiagnostic.js +1 -1
- package/dist/hopper/HopperProvider.js +8 -50
- package/dist/hopper/HopperProviderCapabilities.js +73 -0
- package/dist/hopper/HopperRequestQueue.js +7 -3
- package/dist/hopper/HopperResponseStream.js +7 -1
- package/dist/hopper/HopperSessionValues.js +1 -1
- package/dist/hopper/HopperSocketConnection.js +1 -1
- package/dist/hopper/HopperTargetLease.js +23 -15
- package/dist/hopper/LinuxPrivateDisplayDiagnostic.js +7 -8
- package/dist/hopper/LinuxPrivateDisplayProbe.js +10 -6
- package/dist/hopper/protocol.js +8 -8
- package/dist/ida/IdaConfiguration.js +56 -0
- package/dist/ida/IdaDoctor.js +53 -0
- package/dist/ida/IdaInput.js +62 -0
- package/dist/ida/IdaMcpConnection.js +111 -0
- package/dist/ida/IdaOperationRunner.js +299 -0
- package/dist/ida/IdaProtocolValues.js +178 -0
- package/dist/ida/IdaProvider.js +126 -0
- package/dist/ida/IdaProviderCapabilities.js +52 -0
- package/dist/ida/IdaSessionClient.js +318 -0
- package/dist/ida/IdaWorkspace.js +54 -0
- package/dist/{browser → inspector}/JavaScriptRuntimeScope.js +19 -6
- package/dist/{browser → inspector}/V8InspectorCaptureProjection.js +46 -8
- package/dist/{browser → inspector}/V8InspectorEndpoint.js +3 -2
- package/dist/{browser → inspector}/V8InspectorProvider.js +16 -14
- package/dist/inspector/providerIdentity.js +6 -0
- package/dist/javascript/recovery/RecoveryFiles.js +122 -0
- package/dist/javascript/recovery/WakaruCommand.js +116 -0
- package/dist/javascript/recovery/WakaruExecution.js +100 -0
- package/dist/javascript/recovery/WakaruProvider.js +96 -0
- package/dist/javascript/recovery/WakaruPublication.js +102 -0
- package/dist/javascript/recovery/WakaruRelease.js +29 -0
- package/dist/javascript/recovery/WakaruReport.js +134 -0
- package/dist/javascript/sourceMaps/SourceMapCodecProcess.js +37 -0
- package/dist/javascript/sourceMaps/SourceMapCodecProtocol.js +20 -0
- package/dist/javascript/sourceMaps/SourceMapCommand.js +176 -0
- package/dist/javascript/sourceMaps/SourceMapDecoder.js +61 -0
- package/dist/javascript/sourceMaps/SourceMapFormat.js +185 -0
- package/dist/javascript/sourceMaps/TraceSourceMap.js +138 -0
- package/dist/main/shutdown.js +29 -3
- package/dist/main/startup.js +1 -1
- package/dist/main/transport.js +32 -11
- package/dist/main.js +9 -20
- package/dist/native/AppleDispatchCoverage.js +58 -0
- package/dist/native/AppleDispatchMetadata.js +73 -490
- package/dist/native/AppleMachoFixups.js +292 -0
- package/dist/native/AppleMachoSelection.js +188 -0
- package/dist/native/AppleObjcCategories.js +59 -0
- package/dist/native/AppleObjcDispatchFacets.js +257 -0
- package/dist/native/AppleObjcProperties.js +68 -0
- package/dist/native/AppleObjcProtocols.js +2 -1
- package/dist/native/AppleSwiftDispatchFacets.js +150 -0
- package/dist/native/NativeMacOSProvider.js +204 -72
- package/dist/native/NativeMacOSProviderMetadata.js +42 -0
- package/dist/native/NativeMachoInspection.js +87 -26
- package/dist/native/NativeUiHelperRuntime.js +14 -4
- package/dist/native/NativeUiObservation.js +14 -6
- package/dist/native/NativeUiOutputBudget.js +8 -0
- package/dist/native/parsers/codesign.js +40 -5
- package/dist/native/parsers/demangle.js +6 -2
- package/dist/native/parsers/dyldInfo.js +16 -7
- package/dist/native/parsers/echoedPath.js +14 -0
- package/dist/native/parsers/lipo.js +14 -0
- package/dist/native/parsers/otool.js +5 -2
- package/dist/native/parsers/plist.js +174 -11
- package/dist/process/ExecFileOutput.js +2 -0
- package/dist/process/PrivateRuntimeRoot.js +13 -3
- package/dist/process/ProcessOwnership.js +5 -73
- package/dist/process/ProcessOwnershipObservation.js +62 -2
- package/dist/process/ProcessOwnershipProcessTree.js +13 -0
- package/dist/process/ProviderProcess.js +62 -24
- package/dist/process/ProviderRunLineage.js +1 -1
- package/dist/process/WindowsAuthority.js +20 -1
- package/dist/reference/ReferenceSourceReaderEntries.js +11 -2
- package/dist/reference/ReferenceSourceReaderFile.js +1 -0
- package/dist/server/createServer.js +67 -2
- package/dist/server/mcpClientMetadata.js +6 -3
- package/dist/server/mcpProgress.js +2 -1
- package/dist/server/promptCompletion.js +3 -3
- package/dist/server/registerAndroidTools.js +30 -0
- package/dist/server/registerApplicationTools/compareExportShapes.js +7 -3
- package/dist/server/registerApplicationTools/compareSourceToBundle.js +9 -4
- package/dist/server/registerApplicationTools/compareVersions.js +7 -3
- package/dist/server/registerApplicationTools/projectMobileApplicationGraph.js +43 -0
- package/dist/server/registerApplicationTools/traceFeature.js +8 -3
- package/dist/server/registerApplicationTools/traceSemantics.js +8 -3
- package/dist/server/registerApplicationTools.js +2 -0
- package/dist/server/registerBrowserScenarioTool.js +6 -2
- package/dist/server/registerBrowserTools.js +13 -2
- package/dist/server/registerCloseLifecycleTool.js +1 -1
- package/dist/server/registerElectronTools.js +21 -7
- package/dist/server/registerEnhancedTools.js +28 -1
- package/dist/server/registerFirmwareTools.js +22 -0
- package/dist/server/registerFunctionComparisonTool.js +1 -1
- package/dist/server/registerInvestigationTools/helpers.js +2 -1
- package/dist/server/registerJavaScriptRecoveryTool.js +17 -0
- package/dist/server/registerJavaScriptRuntimeObservationTools.js +9 -4
- package/dist/server/registerManagedTools.js +4 -4
- package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +2 -2
- package/dist/server/registerManagedWorkflowTools/contract.js +1 -1
- package/dist/server/registerManagedWorkflowTools/evidence.js +1 -1
- package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +1 -1
- package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +1 -1
- package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +2 -2
- package/dist/server/registerNativeTools.js +1 -1
- package/dist/server/registerOfficialTools.js +4 -1
- package/dist/server/registerProcessComparisonTool.js +5 -2
- package/dist/server/registerPrompts.js +5 -1
- package/dist/server/registerSessionTools.js +4 -2
- package/dist/server/registerWebModuleTool.js +17 -0
- package/dist/server/registerWebRuntimeTools.js +31 -0
- package/dist/server/registerWebScriptTool.js +18 -0
- package/dist/server/registerWebSourceLocationTool.js +17 -0
- package/dist/server/runDerivedOperation.js +1 -1
- package/dist/server/sessionAvailabilityPolicy.js +24 -9
- package/dist/server/sessionEvidence.js +1 -1
- package/dist/server/toolResult.js +2 -1
- package/dist/windows/WindowsNativeLoader.js +108 -0
- package/dist/windows/WindowsOwnedProcess.js +170 -0
- package/dist/windows/WindowsPrivateRuntime.js +137 -0
- package/install.sh +16 -8
- package/native/windows/README.md +107 -0
- package/native/windows/build/manifest.json +9 -0
- package/native/windows/build/rea-windows-x64.node +0 -0
- package/package.json +70 -35
- package/scripts/hopper-demo-x11.py +67 -8
- package/scripts/rea.mjs +10 -2
- package/scripts/verify-windows-native-artifact.mjs +39 -0
- package/skills/reverse-engineer-anything/SKILL.md +92 -24
- package/skills/reverse-engineer-anything/references/android-applications.md +31 -0
- package/skills/reverse-engineer-anything/references/javascript-applications.md +19 -2
- package/skills/reverse-engineer-anything/references/native-and-artifacts.md +61 -4
- package/dist/application/JavaScriptApplicationService.js +0 -52
- package/dist/application/runtime.js +0 -51
- package/dist/browser/CdpCanonicalJsonDigest.js +0 -9
- package/dist/domain/appleApplication.js +0 -181
- package/dist/domain/errors.js +0 -324
- package/dist/domain/javascriptAstValues.js +0 -13
- package/dist/domain/javascriptSemanticTraversal.js +0 -30
- package/dist/native/NativeHostCapabilities.js +0 -23
- /package/dist/application/{BinarySessionPort.js → DirectAnalysisDependencies.js} +0 -0
- /package/dist/application/{ElectronActiveObservationPort.js → WebModulePorts.js} +0 -0
- /package/dist/application/{ElectronObservationPort.js → WebRuntimePort.js} +0 -0
- /package/dist/application/{JavaScriptArtifactAnalysisTypes.js → WebScriptArtifactPort.js} +0 -0
- /package/dist/application/{JavaScriptRuntimeObservationPort.js → WebSourceLocationPorts.js} +0 -0
- /package/dist/{domain/electronStaticAnalysisTypes.js → application/android/AndroidAnalysisPort.js} +0 -0
- /package/dist/application/{AbortablePromise.js → binary/AbortablePromise.js} +0 -0
- /package/dist/{domain/javascriptSemanticValueTypes.js → application/binary/BinarySessionPort.js} +0 -0
- /package/dist/application/{BinarySessionStatus.js → binary/BinarySessionStatus.js} +0 -0
- /package/dist/application/{ElectronBoundaryGraph.js → javascript/ElectronBoundaryGraph.js} +0 -0
- /package/dist/application/{ElectronBoundaryGraphIpc.js → javascript/ElectronBoundaryGraphIpc.js} +0 -0
- /package/dist/application/{ElectronBoundaryGraphNative.js → javascript/ElectronBoundaryGraphNative.js} +0 -0
- /package/dist/application/{ElectronBoundaryGraphWindows.js → javascript/ElectronBoundaryGraphWindows.js} +0 -0
- /package/dist/application/{JavaScriptArtifactGraphBundlers.js → javascript/JavaScriptArtifactGraphBundlers.js} +0 -0
- /package/dist/application/{JavaScriptArtifactGraphEvidence.js → javascript/JavaScriptArtifactGraphEvidence.js} +0 -0
- /package/dist/application/{JavaScriptArtifactReconstructionInput.js → javascript/JavaScriptArtifactReconstructionInput.js} +0 -0
- /package/dist/application/{JavaScriptSemanticGraphEvidence.js → javascript/JavaScriptSemanticGraphEvidence.js} +0 -0
- /package/dist/application/{JavaScriptSemanticGraphValueProjection.js → javascript/JavaScriptSemanticGraphValueProjection.js} +0 -0
- /package/dist/domain/{electronStaticAnalysis.js → javascript/electronStaticAnalysis.js} +0 -0
- /package/dist/domain/{javascriptExportShapeComparisonIdentity.js → javascript/javascriptExportShapeComparisonIdentity.js} +0 -0
- /package/dist/domain/{javascriptRuntimeReconciliation.js → javascript/javascriptRuntimeReconciliation.js} +0 -0
- /package/dist/domain/{javascriptRuntimeReconciliationRuntime.js → javascript/javascriptRuntimeReconciliationRuntime.js} +0 -0
- /package/dist/domain/{javascriptSemanticCoverage.js → javascript/javascriptSemanticCoverage.js} +0 -0
- /package/dist/domain/{javascriptSemanticDerivedAnalysis.js → javascript/javascriptSemanticDerivedAnalysis.js} +0 -0
- /package/dist/domain/{javascriptSemanticGraphSerialization.js → javascript/javascriptSemanticGraphSerialization.js} +0 -0
- /package/dist/domain/{javascriptSemanticIr.js → javascript/javascriptSemanticIr.js} +0 -0
- /package/dist/domain/{javascriptSemanticQueryRelations.js → javascript/javascriptSemanticQueryRelations.js} +0 -0
- /package/dist/domain/{javascriptSemanticState.js → javascript/javascriptSemanticState.js} +0 -0
- /package/dist/domain/{javascriptStaticAnalysisFindings.js → javascript/javascriptStaticAnalysisFindings.js} +0 -0
- /package/dist/domain/{javascriptStaticAnalysisState.js → javascript/javascriptStaticAnalysisState.js} +0 -0
- /package/dist/domain/{javascriptStaticAnalysisTypes.js → javascript/javascriptStaticAnalysisTypes.js} +0 -0
- /package/dist/domain/{managedApplicationGraphCoverage.js → managed/managedApplicationGraphCoverage.js} +0 -0
- /package/dist/domain/{managedApplicationGraphNodeCoverage.js → managed/managedApplicationGraphNodeCoverage.js} +0 -0
- /package/dist/domain/{nativeApiBoundary.js → native/nativeApiBoundary.js} +0 -0
- /package/dist/domain/{nativeInstruction.js → native/nativeInstruction.js} +0 -0
- /package/dist/domain/{nativeValueFlow.js → native/nativeValueFlow.js} +0 -0
- /package/dist/domain/{nativeValueTrace.js → native/nativeValueTrace.js} +0 -0
package/dist/domain/callPath.js
CHANGED
|
@@ -1,8 +1,53 @@
|
|
|
1
|
-
import { DirectedGraph } from "graphology";
|
|
2
|
-
import { bidirectional } from "graphology-shortest-path/unweighted.js";
|
|
3
1
|
import { callPathInputSchema, callPathResultSchema, parseCallPathAddress, } from "./callPathSchemas.js";
|
|
4
2
|
import { parseFunctionEvidence, } from "./functionDossierEvidence.js";
|
|
5
3
|
export { callPathInputSchema, callPathResultSchema };
|
|
4
|
+
/** Minimal directed caller-to-callee adjacency for call-path search. */
|
|
5
|
+
class CallGraph {
|
|
6
|
+
successors = new Map();
|
|
7
|
+
predecessors = new Map();
|
|
8
|
+
mergeNode(node) {
|
|
9
|
+
if (!this.successors.has(node))
|
|
10
|
+
this.successors.set(node, new Set());
|
|
11
|
+
if (!this.predecessors.has(node))
|
|
12
|
+
this.predecessors.set(node, new Set());
|
|
13
|
+
}
|
|
14
|
+
mergeDirectedEdge(source, target) {
|
|
15
|
+
this.mergeNode(source);
|
|
16
|
+
this.mergeNode(target);
|
|
17
|
+
this.successors.get(source)?.add(target);
|
|
18
|
+
this.predecessors.get(target)?.add(source);
|
|
19
|
+
}
|
|
20
|
+
hasNode(node) {
|
|
21
|
+
return this.successors.has(node);
|
|
22
|
+
}
|
|
23
|
+
outDegree(node) {
|
|
24
|
+
return this.successors.get(node)?.size ?? 0;
|
|
25
|
+
}
|
|
26
|
+
outNeighbors(node) {
|
|
27
|
+
return [...(this.successors.get(node) ?? [])];
|
|
28
|
+
}
|
|
29
|
+
inNeighbors(node) {
|
|
30
|
+
return [...(this.predecessors.get(node) ?? [])];
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
/** Shortest remaining distance for every node that can reach the goal. */
|
|
34
|
+
const distancesToGoal = (graph, goal) => {
|
|
35
|
+
if (!graph.hasNode(goal))
|
|
36
|
+
return new Map();
|
|
37
|
+
const depth = new Map([[goal, 0]]);
|
|
38
|
+
const queue = [goal];
|
|
39
|
+
for (let index = 0; index < queue.length; index += 1) {
|
|
40
|
+
const node = queue[index] ?? "";
|
|
41
|
+
const next = (depth.get(node) ?? 0) + 1;
|
|
42
|
+
for (const neighbor of graph.inNeighbors(node)) {
|
|
43
|
+
if (!depth.has(neighbor)) {
|
|
44
|
+
depth.set(neighbor, next);
|
|
45
|
+
queue.push(neighbor);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
return depth;
|
|
50
|
+
};
|
|
6
51
|
/** Reconstruct direct-callee paths from explicit analyze_function Evidence. */
|
|
7
52
|
export const buildCallPath = (input) => {
|
|
8
53
|
const parsed = callPathInputSchema.parse(input);
|
|
@@ -13,16 +58,15 @@ export const buildCallPath = (input) => {
|
|
|
13
58
|
start: parsed.start.address,
|
|
14
59
|
goal: parsed.goal.address,
|
|
15
60
|
});
|
|
16
|
-
const
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
const paths = shortest === null
|
|
61
|
+
const goalDistances = distancesToGoal(graph, parsed.goal.address);
|
|
62
|
+
const shortestDepth = goalDistances.get(parsed.start.address) ?? null;
|
|
63
|
+
const paths = shortestDepth === null
|
|
20
64
|
? []
|
|
21
65
|
: enumeratePaths({
|
|
22
66
|
graph,
|
|
23
67
|
start: parsed.start.address,
|
|
24
68
|
goal: parsed.goal.address,
|
|
25
|
-
|
|
69
|
+
goalDistances,
|
|
26
70
|
}).paths.map((path) => citePath(path, snapshots));
|
|
27
71
|
const shortestHops = paths[0]?.hops;
|
|
28
72
|
const found = shortestHops !== undefined;
|
|
@@ -55,7 +99,7 @@ export const buildCallPath = (input) => {
|
|
|
55
99
|
const summarizeSearch = (graph, reached) => ({
|
|
56
100
|
nodes: reached.size,
|
|
57
101
|
edges: [...reached.keys()].reduce((count, node) => count + (graph.hasNode(node) ? graph.outDegree(node) : 0), 0),
|
|
58
|
-
depth_reached: Math.max(
|
|
102
|
+
depth_reached: [...reached.values()].reduce((maximum, depth) => Math.max(maximum, depth), 0),
|
|
59
103
|
});
|
|
60
104
|
const prepareCallGraph = (input) => {
|
|
61
105
|
const snapshots = parseSnapshots(input.functions);
|
|
@@ -94,7 +138,7 @@ const assertCompatible = (snapshots) => {
|
|
|
94
138
|
}
|
|
95
139
|
};
|
|
96
140
|
const createGraph = (snapshots) => {
|
|
97
|
-
const graph = new
|
|
141
|
+
const graph = new CallGraph();
|
|
98
142
|
for (const [address, snapshot] of snapshots) {
|
|
99
143
|
graph.mergeNode(address);
|
|
100
144
|
for (const callee of snapshot.collections.callees.items) {
|
|
@@ -148,41 +192,45 @@ const inspectSearch = ({ graph, snapshots, start, goal, }) => {
|
|
|
148
192
|
limitations,
|
|
149
193
|
};
|
|
150
194
|
};
|
|
151
|
-
const enumeratePaths = ({ graph, start, goal,
|
|
195
|
+
const enumeratePaths = ({ graph, start, goal, goalDistances, }) => {
|
|
152
196
|
const output = [];
|
|
153
|
-
const
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
197
|
+
const path = [start];
|
|
198
|
+
const neighbors = new Map();
|
|
199
|
+
const frame = (node) => {
|
|
200
|
+
let candidates = neighbors.get(node);
|
|
201
|
+
if (candidates === undefined) {
|
|
202
|
+
const distance = goalDistances.get(node);
|
|
203
|
+
candidates = graph
|
|
204
|
+
.outNeighbors(node)
|
|
205
|
+
.filter((neighbor) => distance !== undefined &&
|
|
206
|
+
goalDistances.get(neighbor) === distance - 1)
|
|
207
|
+
.sort((left, right) => left.localeCompare(right));
|
|
208
|
+
neighbors.set(node, candidates);
|
|
209
|
+
}
|
|
210
|
+
return { neighbors: candidates, nextIndex: 0 };
|
|
159
211
|
};
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
if (current === undefined)
|
|
167
|
-
return;
|
|
168
|
-
if (remaining === 0) {
|
|
169
|
-
if (current === goal)
|
|
212
|
+
const pending = [frame(start)];
|
|
213
|
+
while (pending.length > 0) {
|
|
214
|
+
const current = pending.at(-1);
|
|
215
|
+
if (current === undefined)
|
|
216
|
+
break;
|
|
217
|
+
if (path.at(-1) === goal) {
|
|
170
218
|
output.push([...path]);
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
219
|
+
pending.pop();
|
|
220
|
+
path.pop();
|
|
221
|
+
continue;
|
|
222
|
+
}
|
|
223
|
+
const neighbor = current.neighbors[current.nextIndex];
|
|
224
|
+
if (neighbor === undefined) {
|
|
225
|
+
pending.pop();
|
|
226
|
+
path.pop();
|
|
179
227
|
continue;
|
|
180
|
-
|
|
228
|
+
}
|
|
229
|
+
current.nextIndex += 1;
|
|
181
230
|
path.push(neighbor);
|
|
182
|
-
|
|
183
|
-
path.pop();
|
|
184
|
-
visited.delete(neighbor);
|
|
231
|
+
pending.push(frame(neighbor));
|
|
185
232
|
}
|
|
233
|
+
return { paths: output };
|
|
186
234
|
};
|
|
187
235
|
const citePath = (addresses, snapshots) => {
|
|
188
236
|
const edges = addresses.slice(0, -1).map((source, index) => {
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
/** Hash canonicalize-compatible JSON without assembling an aggregate string. */
|
|
3
|
+
export const digestCanonicalValue = (value, context = "Comparison") => {
|
|
4
|
+
const hash = createHash("sha256");
|
|
5
|
+
const encoded = emitCanonical(value, (part) => hash.update(part), new Set());
|
|
6
|
+
if (!encoded)
|
|
7
|
+
throw new TypeError(`${context} could not canonicalize data`);
|
|
8
|
+
return hash.digest("hex");
|
|
9
|
+
};
|
|
10
|
+
const emitCanonical = (value, emit, ancestors) => {
|
|
11
|
+
if (typeof value === "number" && !Number.isFinite(value))
|
|
12
|
+
throw new Error(Number.isNaN(value) ? "NaN is not allowed" : "Infinity is not allowed");
|
|
13
|
+
if (value === null || typeof value !== "object") {
|
|
14
|
+
const encoded = JSON.stringify(value);
|
|
15
|
+
if (encoded === undefined)
|
|
16
|
+
return false;
|
|
17
|
+
emit(encoded);
|
|
18
|
+
return true;
|
|
19
|
+
}
|
|
20
|
+
if (ancestors.has(value))
|
|
21
|
+
throw new Error("Circular reference detected");
|
|
22
|
+
ancestors.add(value);
|
|
23
|
+
try {
|
|
24
|
+
if ("toJSON" in value && typeof value.toJSON === "function") {
|
|
25
|
+
const normalized = value.toJSON();
|
|
26
|
+
return emitCanonical(normalized, emit, ancestors);
|
|
27
|
+
}
|
|
28
|
+
if (Array.isArray(value)) {
|
|
29
|
+
emit("[");
|
|
30
|
+
const length = value.length;
|
|
31
|
+
for (let index = 0; index < length; index += 1) {
|
|
32
|
+
if (index > 0)
|
|
33
|
+
emit(",");
|
|
34
|
+
// Preserve canonicalize's sparse-array and unsupported-value behavior.
|
|
35
|
+
if (!(index in value))
|
|
36
|
+
continue;
|
|
37
|
+
const item = value[index];
|
|
38
|
+
emitCanonical(item === undefined || typeof item === "symbol" ? null : item, emit, ancestors);
|
|
39
|
+
}
|
|
40
|
+
emit("]");
|
|
41
|
+
}
|
|
42
|
+
else {
|
|
43
|
+
emit("{");
|
|
44
|
+
let first = true;
|
|
45
|
+
for (const key of Object.keys(value).sort()) {
|
|
46
|
+
if (Reflect.get(value, key) === undefined ||
|
|
47
|
+
typeof Reflect.get(value, key) === "symbol")
|
|
48
|
+
continue;
|
|
49
|
+
const item = Reflect.get(value, key);
|
|
50
|
+
if (!first)
|
|
51
|
+
emit(",");
|
|
52
|
+
first = false;
|
|
53
|
+
emit(JSON.stringify(key));
|
|
54
|
+
emit(":");
|
|
55
|
+
if (!emitCanonical(item, emit, ancestors))
|
|
56
|
+
emit("undefined");
|
|
57
|
+
}
|
|
58
|
+
emit("}");
|
|
59
|
+
}
|
|
60
|
+
return true;
|
|
61
|
+
}
|
|
62
|
+
finally {
|
|
63
|
+
ancestors.delete(value);
|
|
64
|
+
}
|
|
65
|
+
};
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Canonical code-point ordering shared across domain and application layers.
|
|
3
|
+
*
|
|
4
|
+
* Compares strings by Unicode code point (`<`/`>`) so graph ordering,
|
|
5
|
+
* fingerprints, and deterministic tie-breaks stay stable regardless of
|
|
6
|
+
* locale. Prefer this over `String.prototype.localeCompare`, which is
|
|
7
|
+
* locale-dependent.
|
|
8
|
+
*/
|
|
9
|
+
export const compareCodePoints = (left, right) => left < right ? -1 : left > right ? 1 : 0;
|
|
10
|
+
/** Deduplicate and sort strings with canonical code-point ordering. */
|
|
11
|
+
export const uniqueSorted = (values) => [...new Set(values)].sort(compareCodePoints);
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { artifactComparisonResultSchema } from "./artifactComparison.js";
|
|
3
|
+
import { uniqueSorted } from "./canonicalOrdering.js";
|
|
3
4
|
import { evidenceSchema, parseEvidence } from "./evidence.js";
|
|
4
5
|
import { functionComparisonResultSchema } from "./functionComparison.js";
|
|
6
|
+
import { PROCESS_PROVIDER, isProcessEvidenceProvider, } from "./processEvidenceProvider.js";
|
|
5
7
|
import { comparisonStatusSchema, deriveProcessComparisonStatus, PROCESS_COMPARISON_DIMENSIONS, processCaptureComparisonSchema, } from "./processCapture.js";
|
|
6
8
|
import { prefixedDigestSchema } from "./../domain/digests.js";
|
|
7
9
|
const evidenceIdSchema = prefixedDigestSchema("ev");
|
|
@@ -65,9 +67,7 @@ export const changedBehaviorResultSchema = z
|
|
|
65
67
|
const EXPECTED_PROVIDERS = {
|
|
66
68
|
compare_process_captures: {
|
|
67
69
|
predicates: ["rea.process-comparison"],
|
|
68
|
-
|
|
69
|
-
name: "REA deterministic process harness",
|
|
70
|
-
version: "3",
|
|
70
|
+
...PROCESS_PROVIDER,
|
|
71
71
|
},
|
|
72
72
|
compare_artifacts: {
|
|
73
73
|
predicates: ["rea.artifact-comparison"],
|
|
@@ -132,9 +132,11 @@ const parseComparisonEvidence = (input) => {
|
|
|
132
132
|
.parse(evidence.operation);
|
|
133
133
|
const expected = EXPECTED_PROVIDERS[operation];
|
|
134
134
|
if (!acceptsPredicate(expected.predicates, evidence.predicate_type) ||
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
135
|
+
(operation === "compare_process_captures"
|
|
136
|
+
? !isProcessEvidenceProvider(evidence.provider)
|
|
137
|
+
: evidence.provider.id !== expected.id ||
|
|
138
|
+
evidence.provider.name !== expected.name ||
|
|
139
|
+
evidence.provider.version !== expected.version) ||
|
|
138
140
|
evidence.confidence !== "derived" ||
|
|
139
141
|
evidence.authority !== "analyst-inference" ||
|
|
140
142
|
evidence.subject !== null)
|
|
@@ -275,7 +277,6 @@ const count = (findings, classification) => findings.filter((finding) => finding
|
|
|
275
277
|
const compareFindings = (left, right) => [left.scope, left.dimension, left.source_comparison_id]
|
|
276
278
|
.join("\0")
|
|
277
279
|
.localeCompare([right.scope, right.dimension, right.source_comparison_id].join("\0"), "en");
|
|
278
|
-
const uniqueSorted = (values) => [...new Set(values)].sort((left, right) => left.localeCompare(right, "en"));
|
|
279
280
|
const assertUnique = (values, label) => {
|
|
280
281
|
if (new Set(values).size !== values.length)
|
|
281
282
|
throw new TypeError(`Changed-behavior analysis rejects duplicate ${label}`);
|
|
@@ -1,14 +1,12 @@
|
|
|
1
|
-
import { createHash } from "node:crypto";
|
|
2
1
|
import canonicalize from "canonicalize";
|
|
2
|
+
import { digestCanonicalValue } from "./canonicalDigest.js";
|
|
3
3
|
/** Whether an inventory can support a claim that an item is absent. */
|
|
4
4
|
export const absenceClaimable = (coverage) => coverage.status === "complete" &&
|
|
5
5
|
coverage.truncated !== true &&
|
|
6
6
|
(coverage.omitted_count === undefined || coverage.omitted_count === 0);
|
|
7
7
|
/** SHA-256 of canonical JSON for stable, provider-neutral comparison IDs. */
|
|
8
8
|
export const canonicalDigest = (value, context = "Comparison") => {
|
|
9
|
-
return
|
|
10
|
-
.update(canonicalJson(value, context))
|
|
11
|
-
.digest("hex");
|
|
9
|
+
return digestCanonicalValue(value, context);
|
|
12
10
|
};
|
|
13
11
|
/** Canonical JSON used for deterministic tie breaking and stable digests. */
|
|
14
12
|
export const canonicalJson = (value, context = "Comparison") => {
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
/**
|
|
3
|
+
* Canonical top-level comparison outcome shared by every comparison
|
|
4
|
+
* pipeline. Pipeline-native detail enums (bundle classifications,
|
|
5
|
+
* source-to-bundle split/merge kinds, scenario alignment states, function
|
|
6
|
+
* truncation) keep their wire schemas; the mappers below project each of
|
|
7
|
+
* them onto this triple without changing any pipeline result.
|
|
8
|
+
*/
|
|
9
|
+
export const comparisonStatusSchema = z.enum([
|
|
10
|
+
"unchanged",
|
|
11
|
+
"changed",
|
|
12
|
+
"unknown",
|
|
13
|
+
]);
|
|
14
|
+
/** Canonical comparison conclusion shared by every comparison pipeline. */
|
|
15
|
+
export const comparisonConclusionSchema = z.enum([
|
|
16
|
+
"observed_change",
|
|
17
|
+
"derived_relationship",
|
|
18
|
+
"contradiction",
|
|
19
|
+
"unresolved_branch",
|
|
20
|
+
]);
|
|
21
|
+
/** Project a bundle change classification onto the canonical triple. */
|
|
22
|
+
export const bundleClassificationToCanonical = (classification) => (classification === "unknown" ? "unknown" : "changed");
|
|
23
|
+
/** Project a source-to-bundle item status onto the canonical triple. */
|
|
24
|
+
export const sourceToBundleStatusToCanonical = (status) => status === "unchanged"
|
|
25
|
+
? "unchanged"
|
|
26
|
+
: status === "unknown"
|
|
27
|
+
? "unknown"
|
|
28
|
+
: "changed";
|
|
29
|
+
/**
|
|
30
|
+
* Project a function dimension status onto the canonical triple. A
|
|
31
|
+
* truncated dimension cannot support an unchanged/changed claim.
|
|
32
|
+
*/
|
|
33
|
+
export const functionStatusToCanonical = (status) => status === "unchanged"
|
|
34
|
+
? "unchanged"
|
|
35
|
+
: status === "changed"
|
|
36
|
+
? "changed"
|
|
37
|
+
: "unknown";
|
|
38
|
+
/** Project a browser-scenario artifact status onto the canonical triple. */
|
|
39
|
+
export const scenarioArtifactStatusToCanonical = (status) => status;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { AnalysisError } from "./analysisErrorBase.js";
|
|
2
|
+
/** Runtime configuration could not be parsed safely. */
|
|
3
|
+
export class ConfigurationError extends AnalysisError {
|
|
4
|
+
_tag = "ConfigurationError";
|
|
5
|
+
}
|
|
6
|
+
/** No app or binary session exists for an analysis request. */
|
|
7
|
+
export class NoBinaryOpenError extends AnalysisError {
|
|
8
|
+
_tag = "NoBinaryOpenError";
|
|
9
|
+
constructor() {
|
|
10
|
+
super("No app is open. Ask the user which app to investigate, then call open_binary with its local path.");
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
/** A supplied target path could not be safely opened as a supported app or binary. */
|
|
14
|
+
export class BinaryTargetError extends AnalysisError {
|
|
15
|
+
path;
|
|
16
|
+
reason;
|
|
17
|
+
_tag = "BinaryTargetError";
|
|
18
|
+
constraint;
|
|
19
|
+
constructor(path, reason, options) {
|
|
20
|
+
super(`Cannot open artifact: ${reason}`, options);
|
|
21
|
+
this.path = path;
|
|
22
|
+
this.reason = reason;
|
|
23
|
+
this.constraint = options?.constraint;
|
|
24
|
+
}
|
|
25
|
+
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { err, ok } from "./result.js";
|
|
3
|
+
/** Headerless DOS COM interpretation explicitly selected by the caller. */
|
|
4
|
+
export const executableFormatHintSchema = z.literal("dos-com");
|
|
5
|
+
/** Validate the single 64 KiB COM segment, excluding its 256-byte PSP prefix. */
|
|
6
|
+
export const validateDosComLength = (length) => Number.isSafeInteger(length) && length >= 1 && length <= 0xff00
|
|
7
|
+
? ok(null)
|
|
8
|
+
: err("DOS COM requires 1..65280 file bytes (64 KiB segment minus the 256-byte PSP prefix)");
|
package/dist/domain/evidence.js
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import { createHash } from "node:crypto";
|
|
2
|
-
import canonicalize from "canonicalize";
|
|
3
1
|
import { z } from "zod";
|
|
2
|
+
import { digestCanonicalValue } from "./canonicalDigest.js";
|
|
4
3
|
import { analysisProfileSchema, } from "./analysisProfile.js";
|
|
5
4
|
import { jsonValueSchema } from "./jsonValue.js";
|
|
6
5
|
import { digestSchema } from "./../domain/digests.js";
|
|
@@ -21,6 +20,7 @@ const subjectSchema = z.object({
|
|
|
21
20
|
"elf",
|
|
22
21
|
"pe",
|
|
23
22
|
"dos-mz",
|
|
23
|
+
"dos-com",
|
|
24
24
|
"zip",
|
|
25
25
|
"ipa",
|
|
26
26
|
"apk",
|
|
@@ -116,14 +116,6 @@ export const evidenceRecordSchema = z.union([
|
|
|
116
116
|
profiledEvidenceSchema,
|
|
117
117
|
evidenceBaseSchema,
|
|
118
118
|
]);
|
|
119
|
-
const sha256 = (value) => createHash("sha256").update(value).digest("hex");
|
|
120
|
-
/** Serialize JSON according to RFC 8785 JSON Canonicalization Scheme. */
|
|
121
|
-
const canonicalJson = (value) => {
|
|
122
|
-
const serialized = canonicalize(value);
|
|
123
|
-
if (serialized === undefined)
|
|
124
|
-
throw new TypeError("RFC 8785 canonicalization rejected a JSON value");
|
|
125
|
-
return serialized;
|
|
126
|
-
};
|
|
127
119
|
const semanticProjection = (evidence) => ({
|
|
128
120
|
subject: evidence.subject === null
|
|
129
121
|
? null
|
|
@@ -149,7 +141,7 @@ const semanticProjection = (evidence) => ({
|
|
|
149
141
|
evidence_links: evidence.evidence_links,
|
|
150
142
|
});
|
|
151
143
|
/** Recompute the semantic identifier, excluding paths and raw payload bytes. */
|
|
152
|
-
const computeEvidenceId = (evidence) => `ev_${
|
|
144
|
+
const computeEvidenceId = (evidence) => `ev_${digestCanonicalValue(semanticProjection(evidence), "Evidence")}`;
|
|
153
145
|
/** Parse evidence and reject a syntactically valid but tampered semantic ID. */
|
|
154
146
|
export const parseEvidence = (input) => {
|
|
155
147
|
const evidence = evidenceRecordSchema.parse(input);
|
|
@@ -69,21 +69,47 @@ export const createEvidenceBundle = (records, unknowns = []) => {
|
|
|
69
69
|
/** Restrict a bundle to records and complete unknown histories for one artifact. */
|
|
70
70
|
export const evidenceBundleForTarget = (bundle, sha256) => {
|
|
71
71
|
const recordsById = new Map(bundle.records.map((record) => [record.evidence_id, record]));
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
72
|
+
const candidates = bundle.unknowns.filter(({ scope_digest: scopeDigest }) => scopeDigest === sha256);
|
|
73
|
+
const retained = new Set();
|
|
74
|
+
const revisionsById = new Map();
|
|
75
|
+
const dependents = new Map();
|
|
76
|
+
for (const unknown of candidates) {
|
|
77
|
+
const mutationEvidenceIds = new Set(unknown.mutation_evidence_ids);
|
|
78
|
+
const evidenceAvailable = referencedEvidenceIds(unknown).every((id) => {
|
|
79
|
+
const record = recordsById.get(id);
|
|
80
|
+
return (record?.subject?.digest.sha256 === sha256 ||
|
|
81
|
+
(mutationEvidenceIds.has(id) &&
|
|
82
|
+
record?.subject === null &&
|
|
83
|
+
record.predicate_type === "rea.residual-unknown-mutation"));
|
|
84
|
+
});
|
|
85
|
+
if (!evidenceAvailable)
|
|
86
|
+
continue;
|
|
87
|
+
retained.add(unknown);
|
|
88
|
+
revisionsById.set(unknown.unknown_id, (revisionsById.get(unknown.unknown_id) ?? 0) + 1);
|
|
89
|
+
for (const relatedId of new Set(unknown.relationships.map(({ unknown_id: id }) => id))) {
|
|
90
|
+
const references = dependents.get(relatedId) ?? new Set();
|
|
91
|
+
references.add(unknown);
|
|
92
|
+
dependents.set(relatedId, references);
|
|
93
|
+
}
|
|
86
94
|
}
|
|
95
|
+
const pending = [];
|
|
96
|
+
for (const unknown of retained)
|
|
97
|
+
if (unknown.relationships.some(({ unknown_id: id }) => !revisionsById.has(id)))
|
|
98
|
+
pending.push(unknown);
|
|
99
|
+
for (let index = 0; index < pending.length; index += 1) {
|
|
100
|
+
const unknown = pending[index];
|
|
101
|
+
if (unknown === undefined || !retained.delete(unknown))
|
|
102
|
+
continue;
|
|
103
|
+
const remaining = (revisionsById.get(unknown.unknown_id) ?? 1) - 1;
|
|
104
|
+
if (remaining > 0) {
|
|
105
|
+
revisionsById.set(unknown.unknown_id, remaining);
|
|
106
|
+
continue;
|
|
107
|
+
}
|
|
108
|
+
revisionsById.delete(unknown.unknown_id);
|
|
109
|
+
for (const dependent of dependents.get(unknown.unknown_id) ?? [])
|
|
110
|
+
pending.push(dependent);
|
|
111
|
+
}
|
|
112
|
+
const unknowns = candidates.filter((unknown) => retained.has(unknown));
|
|
87
113
|
const mutationIds = new Set(unknowns.flatMap(({ mutation_evidence_ids: ids }) => ids));
|
|
88
114
|
return createEvidenceBundle(bundle.records.filter((record) => record.subject?.digest.sha256 === sha256 ||
|
|
89
115
|
mutationIds.has(record.evidence_id)), unknowns);
|
|
@@ -182,13 +208,20 @@ export const validateResidualUnknownAddition = (unknown, evidenceById, currentHe
|
|
|
182
208
|
throw new TypeError(`Residual unknown references missing unknown ${relationship.unknown_id}`);
|
|
183
209
|
if (unknown.resolution?.disposition === "verified")
|
|
184
210
|
validateVerifiedResolution(unknown, evidenceById);
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
211
|
+
// In a valid graph, no existing node can point to an absent ID. Since the
|
|
212
|
+
// schema rejects self-relations, a new node's outgoing edges cannot close a
|
|
213
|
+
// cycle; keep graph traversal for revisions of existing nodes only.
|
|
214
|
+
if (current !== undefined) {
|
|
215
|
+
const dependencies = unknown.relationships
|
|
216
|
+
.filter((relationship) => relationship.type === "depends-on")
|
|
217
|
+
.map(({ unknown_id }) => unknown_id);
|
|
218
|
+
if (dependencies.length > 0 &&
|
|
219
|
+
reachesUnknown(dependencies, unknown.unknown_id, currentHeads, unknown))
|
|
188
220
|
throw new TypeError("Residual unknown dependency graph contains a cycle");
|
|
221
|
+
}
|
|
189
222
|
};
|
|
190
|
-
const reachesUnknown = (
|
|
191
|
-
const pending = [
|
|
223
|
+
const reachesUnknown = (starts, goal, currentHeads, candidate) => {
|
|
224
|
+
const pending = [...starts];
|
|
192
225
|
const visited = new Set();
|
|
193
226
|
while (pending.length > 0) {
|
|
194
227
|
const id = pending.pop();
|
|
@@ -232,23 +265,53 @@ const evidenceQualifies = (unknown, evidence) => {
|
|
|
232
265
|
const rejectDependencyCycles = (unknownById) => {
|
|
233
266
|
const visited = new Set();
|
|
234
267
|
const active = new Set();
|
|
235
|
-
const
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
const unknown = unknownById.get(id);
|
|
242
|
-
if (unknown === undefined)
|
|
268
|
+
const pending = [];
|
|
269
|
+
for (const root of unknownById.keys()) {
|
|
270
|
+
if (visited.has(root))
|
|
271
|
+
continue;
|
|
272
|
+
const rootUnknown = unknownById.get(root);
|
|
273
|
+
if (rootUnknown === undefined)
|
|
243
274
|
throw new TypeError("Residual unknown dependency graph is inconsistent");
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
275
|
+
active.add(root);
|
|
276
|
+
pending.push({
|
|
277
|
+
id: root,
|
|
278
|
+
relationships: rootUnknown.relationships,
|
|
279
|
+
nextRelationship: 0,
|
|
280
|
+
});
|
|
281
|
+
while (pending.length > 0) {
|
|
282
|
+
const frame = pending[pending.length - 1];
|
|
283
|
+
if (frame === undefined)
|
|
284
|
+
break;
|
|
285
|
+
let descended = false;
|
|
286
|
+
while (frame.nextRelationship < frame.relationships.length) {
|
|
287
|
+
const relationship = frame.relationships[frame.nextRelationship];
|
|
288
|
+
frame.nextRelationship += 1;
|
|
289
|
+
if (relationship?.type !== "depends-on")
|
|
290
|
+
continue;
|
|
291
|
+
const dependency = relationship.unknown_id;
|
|
292
|
+
if (active.has(dependency))
|
|
293
|
+
throw new TypeError("Residual unknown dependency graph contains a cycle");
|
|
294
|
+
if (visited.has(dependency))
|
|
295
|
+
continue;
|
|
296
|
+
const unknown = unknownById.get(dependency);
|
|
297
|
+
if (unknown === undefined)
|
|
298
|
+
throw new TypeError("Residual unknown dependency graph is inconsistent");
|
|
299
|
+
active.add(dependency);
|
|
300
|
+
pending.push({
|
|
301
|
+
id: dependency,
|
|
302
|
+
relationships: unknown.relationships,
|
|
303
|
+
nextRelationship: 0,
|
|
304
|
+
});
|
|
305
|
+
descended = true;
|
|
306
|
+
break;
|
|
307
|
+
}
|
|
308
|
+
if (descended)
|
|
309
|
+
continue;
|
|
310
|
+
pending.pop();
|
|
311
|
+
active.delete(frame.id);
|
|
312
|
+
visited.add(frame.id);
|
|
313
|
+
}
|
|
314
|
+
}
|
|
252
315
|
};
|
|
253
316
|
/** Encode a validated bundle as byte-stable RFC 8785 canonical JSON. */
|
|
254
317
|
export const serializeEvidenceBundle = (bundle) => {
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { AnalysisError } from "./analysisErrorBase.js";
|
|
2
|
+
/** Evidence identity, schema, or bundle manifests failed integrity checks. */
|
|
3
|
+
export class EvidenceIntegrityError extends AnalysisError {
|
|
4
|
+
_tag = "EvidenceIntegrityError";
|
|
5
|
+
}
|
|
6
|
+
/** A session Evidence reference is missing or has the wrong semantic identity. */
|
|
7
|
+
export class EvidenceReferenceError extends EvidenceIntegrityError {
|
|
8
|
+
evidenceId;
|
|
9
|
+
reason;
|
|
10
|
+
expected;
|
|
11
|
+
actual;
|
|
12
|
+
constructor(evidenceId, reason, expected, actual) {
|
|
13
|
+
super(`Evidence reference ${reason}: ${evidenceId}`);
|
|
14
|
+
this.evidenceId = evidenceId;
|
|
15
|
+
this.reason = reason;
|
|
16
|
+
this.expected = expected;
|
|
17
|
+
this.actual = actual;
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
/** Evidence bundle filesystem access failed within the configured policy. */
|
|
21
|
+
export class EvidenceFileError extends AnalysisError {
|
|
22
|
+
operation;
|
|
23
|
+
reason;
|
|
24
|
+
_tag = "EvidenceFileError";
|
|
25
|
+
constructor(operation, reason, options) {
|
|
26
|
+
super(`Evidence bundle ${operation} failed: ${reason}`, options);
|
|
27
|
+
this.operation = operation;
|
|
28
|
+
this.reason = reason;
|
|
29
|
+
}
|
|
30
|
+
}
|