rea-agents 6.1.0 → 6.2.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 +7 -5
- package/bridge/ghidra/ReaGhidraBridge.java +32 -4
- package/bridge/hopper_bridge.py +6 -1
- package/dist/android/JadxConfiguration.js +87 -7
- package/dist/android/JadxMcpTransport.js +14 -2
- package/dist/android/JadxProvider.js +57 -35
- package/dist/application/BinaryTargetResolver.js +5 -3
- package/dist/application/BrowserEvidence.js +3 -8
- package/dist/application/BrowserScenarioEvidence.js +2 -18
- package/dist/application/CapabilityInventory.js +43 -9
- package/dist/application/ClientConfigurationDocument.js +69 -25
- package/dist/application/DirectAnalysis.js +29 -14
- package/dist/application/DirectAnalysisCleanup.js +72 -0
- package/dist/application/DirectAnalysisStatus.js +4 -5
- package/dist/application/Doctor.js +15 -19
- package/dist/application/DoctorDiagnostics.js +1 -2
- package/dist/application/EnhancedTools.js +51 -6
- package/dist/application/EvidenceBundleFiles.js +8 -3
- package/dist/application/InvestigationProviders.js +9 -1
- package/dist/application/JsonFiles.js +42 -9
- package/dist/application/LinuxHopper.js +9 -6
- package/dist/application/MacHopper.js +15 -18
- package/dist/application/RealHopperAssertions.js +0 -11
- package/dist/application/ReconstructionObligationCandidates.js +1 -1
- package/dist/application/ReferenceSourceImportEntries.js +1 -1
- package/dist/application/Setup.js +8 -16
- package/dist/application/SetupHost.js +16 -27
- package/dist/application/SetupPlan.js +6 -6
- package/dist/application/Uninstall.js +81 -29
- package/dist/application/UpdateMaintenance.js +7 -5
- package/dist/application/UpdateRuntime.js +12 -12
- package/dist/application/WebScriptExportService.js +30 -4
- package/dist/application/WorkflowEvidence.js +25 -2
- package/dist/application/XrefsAddressResolution.js +45 -0
- package/dist/application/analysisView/AnalysisViewService.js +76 -0
- package/dist/application/binary/AnalysisClientCleanup.js +30 -5
- package/dist/application/binary/AnalysisProviderEvaluation.js +1 -2
- package/dist/application/binary/AnalysisProviderRegistry.js +2 -6
- package/dist/application/binary/AnalysisSnapshotCache.js +10 -8
- package/dist/application/binary/BinarySession.js +70 -29
- package/dist/application/binary/BinarySessionComposition.js +1 -3
- package/dist/application/binary/BinarySessionExecution.js +3 -5
- package/dist/application/binary/BinarySessionOpen.js +1 -1
- package/dist/application/binary/BinarySessionRecords.js +1 -1
- package/dist/application/binary/BinarySessionStatus.js +1 -6
- package/dist/application/binary/CompositeProvider.js +4 -18
- package/dist/application/binary/LazyAnalysisProvider.js +5 -5
- package/dist/application/binary/SessionProviderRouter.js +27 -135
- package/dist/application/homebrew.js +48 -0
- package/dist/application/javascript/ElectronActiveEvidence.js +9 -13
- package/dist/application/javascript/JavaScriptApplicationEvidence.js +2 -6
- package/dist/application/javascript/JavaScriptApplicationService.js +6 -1
- package/dist/application/javascript/JavaScriptArtifactAnalysis.js +5 -3
- package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +11 -9
- package/dist/application/javascript/JavaScriptArtifactGraphBundlers.js +11 -3
- package/dist/application/javascript/JavaScriptArtifactGraphContext.js +9 -0
- package/dist/application/javascript/JavaScriptArtifactGraphDocuments.js +8 -5
- package/dist/application/javascript/JavaScriptArtifactGraphFindings.js +12 -3
- package/dist/application/javascript/JavaScriptArtifactGraphStructure.js +0 -1
- package/dist/application/javascript/JavaScriptArtifactPathResolution.js +43 -16
- package/dist/application/javascript/JavaScriptArtifactReconstruction.js +46 -6
- package/dist/application/javascript/JavaScriptModuleRelationships.js +1 -1
- package/dist/application/javascript/JavaScriptRuntimeObservationService.js +3 -3
- package/dist/application/javascript/JavaScriptSemanticGraphAsyncProjection.js +2 -3
- package/dist/application/javascript/JavaScriptSemanticGraphChildProcessProjection.js +1 -2
- package/dist/application/javascript/JavaScriptSemanticGraphDataProjection.js +2 -3
- package/dist/application/javascript/JavaScriptSemanticGraphFlowProjection.js +1 -5
- package/dist/application/javascript/JavaScriptSemanticGraphObjectProjection.js +75 -46
- package/dist/application/javascript/JavaScriptSemanticGraphResourceProjection.js +2 -3
- package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +42 -19
- package/dist/application/managed/ManagedMemberComparisonService.js +2 -1
- package/dist/application/managed/ManagedNativeVerificationService.js +2 -1
- package/dist/application/process/ProcessCli.js +11 -11
- package/dist/application/process/ProcessEvidence.js +0 -1
- package/dist/artifacts/ArtifactProvider.js +39 -14
- package/dist/artifacts/ArtifactReader.js +31 -0
- package/dist/artifacts/DirectoryArtifactReader.js +2 -1
- package/dist/artifacts/MachOSliceArtifactReader.js +9 -2
- package/dist/artifacts/NativeDmgArtifactReader.js +65 -20
- package/dist/artifacts/SafeOutputTree.js +16 -2
- package/dist/artifacts/ZipArtifactReader.js +11 -4
- package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +4 -2
- package/dist/artifacts/apple/DylibResolutionReader.js +17 -7
- package/dist/artifacts/apple/KeyedArchiveReader.js +21 -3
- package/dist/artifacts/extraction/ArtifactExtraction.js +78 -21
- package/dist/artifacts/inventory/ArtifactGraphConstruction.js +67 -61
- package/dist/artifacts/inventory/ArtifactInventory.js +0 -1
- package/dist/artifacts/inventory/reader.js +3 -3
- package/dist/artifacts/inventory/scanCanonical.js +48 -24
- package/dist/artifacts/inventory/scanReader.js +5 -9
- package/dist/browser/BrowserScenarioPartialObservation.js +106 -0
- package/dist/browser/CdpBrowserProvider.js +2 -3
- package/dist/browser/CdpCaptureEventHandlers.js +2 -4
- package/dist/browser/CdpCaptureEvents.js +0 -1
- package/dist/browser/CdpCaptureValues.js +20 -0
- package/dist/browser/CdpElectronProvider.js +0 -2
- package/dist/browser/CdpElectronScriptEvents.js +2 -8
- package/dist/browser/CdpElectronScripts.js +2 -3
- package/dist/browser/CdpPageCaptureScripts.js +2 -3
- package/dist/browser/CdpSafeMetadata.js +10 -10
- package/dist/browser/PlaywrightBrowserScenarioProvider.js +59 -44
- package/dist/browser/PlaywrightElectronActiveActions.js +2 -56
- package/dist/browser/PlaywrightElectronActiveProvider.js +10 -6
- package/dist/browser/PlaywrightScenarioArtifacts.js +1 -1
- package/dist/browser/PlaywrightScenarioBrowser.js +139 -39
- package/dist/browser/PlaywrightScenarioEvents.js +1 -1
- package/dist/browser/PlaywrightScenarioSession.js +39 -22
- package/dist/browser/assets/ScriptCaptureAdapters.js +1 -1
- package/dist/browser/history/CaptureFailures.js +6 -2
- package/dist/browser/history/MitmproxyCaptureAdapter.js +4 -2
- package/dist/catalogIdentity.js +0 -1
- package/dist/cli/analysisViewCommands.js +36 -0
- package/dist/cli/artifactCommands.js +11 -12
- package/dist/cli/coreAnalysisCommands.js +3 -3
- package/dist/cli/coreBinaryCommands.js +32 -27
- package/dist/cli/coreNativeCommands.js +9 -10
- package/dist/cli/electronCommands.js +4 -4
- package/dist/cli/interactiveSetup.js +6 -6
- package/dist/cli/managedCommands.js +7 -8
- package/dist/cli/nativeCallCommands.js +1 -2
- package/dist/cli/omittableDefaults.js +50 -0
- package/dist/cli/processCommands.js +3 -2
- package/dist/cli/setupCommands.js +16 -15
- package/dist/cli/utilityCommands.js +9 -9
- package/dist/cli.js +16 -8
- package/dist/cliBrowserScenarioCommands.js +2 -2
- package/dist/cliCommandNames.js +1 -0
- package/dist/cliJsonInput.js +15 -1
- package/dist/cliOutput.js +0 -38
- package/dist/composition/auxiliaryAnalysisProviders.js +27 -23
- package/dist/composition/binary.js +9 -9
- package/dist/composition/browserScenario.js +2 -1
- package/dist/composition/directAnalysis.js +20 -13
- package/dist/composition/electronScenario.js +1 -1
- package/dist/composition/optionalObservationProviders.js +12 -7
- package/dist/config/environment.js +6 -0
- package/dist/config/ghidraStartupTimeout.js +4 -9
- package/dist/config/homeDirectory.js +12 -0
- package/dist/config/mcpResponseBudget.js +9 -1
- package/dist/config/parseConfig.js +7 -3
- package/dist/config/parsers.js +19 -22
- package/dist/contracts/analysisViewToolContracts.js +56 -0
- package/dist/contracts/applicationToolContracts.js +5 -4
- package/dist/contracts/artifactComparisonExample.js +2 -2
- package/dist/contracts/artifactToolContracts.js +1 -1
- package/dist/contracts/browserScenarioToolContracts.js +1 -1
- package/dist/contracts/browserToolContracts.js +19 -15
- package/dist/contracts/enhancedInputs.js +2 -2
- package/dist/contracts/enhancedToolContracts.js +4 -3
- package/dist/contracts/evm/evmToolContracts.js +1 -1
- package/dist/contracts/functionWorkflowToolContracts.js +1 -1
- package/dist/contracts/inputSchemaPresentation.js +90 -0
- package/dist/contracts/investigationExamples.js +4 -3
- package/dist/contracts/javascript/electronToolContracts.js +1 -1
- package/dist/contracts/javascript/javascriptApplicationWorkflowExamples.js +0 -20
- package/dist/contracts/javascript/javascriptExportShapeComparisonExample.js +245 -0
- package/dist/contracts/javascript/javascriptRuntimeObservationToolContracts.js +1 -1
- package/dist/contracts/managed/managedToolContracts.js +5 -10
- package/dist/contracts/managed/managedWorkflowToolContracts.js +1 -1
- package/dist/contracts/mobileApplicationGraphExamples.js +3 -3
- package/dist/contracts/native/binaryDiagnosticsToolContracts.js +1 -1
- package/dist/contracts/native/nativeToolContracts.js +2 -2
- package/dist/contracts/officialToolContracts.js +2 -1
- package/dist/contracts/promptContracts.js +2 -2
- package/dist/contracts/providerSelection.js +1 -1
- package/dist/contracts/sessionToolContracts.js +14 -2
- package/dist/contracts/sessionToolSchemas.js +1 -14
- package/dist/contracts/toolContracts.js +2 -0
- package/dist/contracts/toolEffects.js +1 -0
- package/dist/contracts/toolOutputSchemaGroups.js +136 -92
- package/dist/contracts/toolOutputSchemaPrimitives.js +11 -21
- package/dist/contracts/toolSchemaMetadata.js +18 -69
- package/dist/contracts/webNetworkCaptureToolContracts.js +1 -1
- package/dist/contracts/webRuntimeToolContracts.js +1 -1
- package/dist/contracts/webScriptToolContracts.js +1 -1
- package/dist/doctorRuntime.js +7 -5
- package/dist/domain/analysisErrorCore.js +3 -0
- package/dist/domain/analysisErrorPresentation.js +18 -3
- package/dist/domain/analysisErrorProjection.js +24 -5
- package/dist/domain/analysisSnapshot.js +29 -31
- package/dist/domain/analysisView/analysisView.js +243 -0
- package/dist/domain/analysisView/analysisViewCoverage.js +19 -0
- package/dist/domain/analysisView/binaryLayoutView.js +159 -0
- package/dist/domain/analysisView/javascriptApplicationView.js +238 -0
- package/dist/domain/android/androidApplication.js +1 -1
- package/dist/domain/apple/appleApplication.js +1 -1
- package/dist/domain/apple/dylibResolution.js +10 -3
- package/dist/domain/apple/interfaceBuilderGraph.js +0 -1
- package/dist/domain/apple/keyedArchive.js +26 -2
- package/dist/domain/artifactComparison.js +15 -6
- package/dist/domain/artifactGraph.js +16 -3
- package/dist/domain/artifactInventoryEvidence.js +9 -16
- package/dist/domain/artifactOperationError.js +3 -3
- package/dist/domain/artifactPartialObservation.js +1 -0
- package/dist/domain/artifactPathSyntax.js +49 -0
- package/dist/domain/binaryTarget.js +39 -13
- package/dist/domain/browserCaptureComparison.js +13 -49
- package/dist/domain/browserNetworkEvidence.js +10 -4
- package/dist/domain/browserObservation.js +0 -1
- package/dist/domain/browserObservationSchemas.js +14 -3
- package/dist/domain/browserScenario.js +0 -1
- package/dist/domain/browserScenarioCapture.js +1 -2
- package/dist/domain/browserScenarioDiff.js +0 -2
- package/dist/domain/browserScenarioDiffEvidence.js +0 -12
- package/dist/domain/browserScenarioDiffValues.js +2 -2
- package/dist/domain/browserScenarioValues.js +3 -4
- package/dist/domain/callPath.js +8 -9
- package/dist/domain/callPathSchemas.js +2 -2
- package/dist/domain/changedBehavior.js +3 -3
- package/dist/domain/completionLedgerGeneration.js +2 -1
- package/dist/domain/configurationErrors.js +12 -0
- package/dist/domain/conformancePackage.js +4 -3
- package/dist/domain/evidence.js +10 -36
- package/dist/domain/evidenceBundle.js +7 -9
- package/dist/domain/evidenceCompletionLedger.js +2 -1
- package/dist/domain/functionComparison.js +4 -5
- package/dist/domain/functionComparisonDimensions.js +120 -87
- package/dist/domain/functionComparisonNormalization.js +23 -34
- package/dist/domain/functionComparisonResults.js +1 -4
- package/dist/domain/functionComparisonSchemas.js +2 -8
- package/dist/domain/functionDossierEvidence.js +2 -37
- package/dist/domain/javascript/electronActiveObservation.js +26 -69
- package/dist/domain/javascript/electronObservation.js +14 -3
- package/dist/domain/javascript/electronStaticAnalysisBrowser.js +10 -9
- package/dist/domain/javascript/electronStaticAnalysisIpc.js +2 -1
- package/dist/domain/javascript/electronStaticAnalysisNative.js +2 -1
- package/dist/domain/javascript/javascriptApplicationEvidenceSchemas.js +2 -0
- package/dist/domain/javascript/javascriptApplicationGraph.js +26 -3
- package/dist/domain/javascript/javascriptApplicationGraphSchemas.js +9 -2
- package/dist/domain/javascript/javascriptApplicationVersionItems.js +5 -2
- package/dist/domain/javascript/javascriptApplicationVersionKeys.js +2 -1
- package/dist/{application/javascript/JavaScriptReturnShapeProjection.js → domain/javascript/javascriptExportReturnShapeProjection.js} +4 -4
- package/dist/domain/javascript/javascriptExportShapeComparison.js +7 -1
- package/dist/domain/javascript/javascriptExportShapeComparisonIdentity.js +6 -1
- package/dist/domain/javascript/javascriptExportShapeComparisonSchemas.js +29 -1
- package/dist/domain/javascript/javascriptExportShapeSelection.js +5 -5
- package/dist/domain/javascript/javascriptExportShapeVariants.js +67 -14
- package/dist/domain/javascript/javascriptFeatureSeed.js +20 -0
- package/dist/domain/javascript/javascriptFeatureTraversal.js +0 -1
- package/dist/domain/javascript/javascriptNativeHandoff.js +1 -1
- package/dist/domain/javascript/javascriptRuntimeLoadState.js +0 -1
- package/dist/domain/javascript/javascriptRuntimeObservation.js +10 -2
- package/dist/domain/javascript/javascriptRuntimeReconciliationMatching.js +1 -1
- package/dist/domain/javascript/javascriptRuntimeReconciliationParsing.js +3 -2
- package/dist/domain/javascript/javascriptRuntimeStaticCandidates.js +0 -1
- package/dist/domain/javascript/javascriptSemanticAnalysis.js +9 -3
- package/dist/domain/javascript/javascriptSemanticAsyncEffects.js +2 -1
- package/dist/domain/javascript/javascriptSemanticCalls.js +2 -1
- package/dist/domain/javascript/javascriptSemanticChildProcesses.js +2 -1
- package/dist/domain/javascript/javascriptSemanticDataEffects.js +1 -1
- package/dist/domain/javascript/javascriptSemanticGraph.js +88 -46
- package/dist/domain/javascript/javascriptSemanticMemberMutations.js +77 -20
- package/dist/domain/javascript/javascriptSemanticMutationValues.js +21 -27
- package/dist/domain/javascript/javascriptSemanticObjects.js +83 -42
- package/dist/domain/javascript/javascriptSemanticPrimitives.js +1 -12
- package/dist/domain/javascript/javascriptSemanticProjection.js +2 -3
- package/dist/domain/javascript/javascriptSemanticPromises.js +2 -1
- package/dist/domain/javascript/javascriptSemanticResourceLimits.js +1 -1
- package/dist/domain/javascript/javascriptSemanticResources.js +1 -1
- package/dist/domain/javascript/javascriptSemanticReturns.js +32 -17
- package/dist/domain/javascript/javascriptSemanticSlots.js +72 -0
- package/dist/domain/javascript/javascriptSemanticValues.js +47 -54
- package/dist/domain/javascript/javascriptSourceMapPaths.js +104 -0
- package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +2 -1
- package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +0 -1
- package/dist/domain/javascript/sourceToBundleComparison.js +12 -3
- package/dist/domain/javascript/sourceToBundleSignals.js +47 -19
- package/dist/domain/localPath.js +1 -1
- package/dist/domain/managed/managedArtifact.js +6 -4
- package/dist/domain/managed/managedMemberComparison.js +2 -9
- package/dist/domain/managed/managedNativeVerification.js +0 -2
- package/dist/domain/managed/managedNativeVerificationMatch.js +9 -3
- package/dist/domain/native/binaryLayout.js +2 -3
- package/dist/domain/native/nativeApiBoundary.js +1 -1
- package/dist/domain/native/nativeCallObservation.js +5 -3
- package/dist/domain/native/nativeInstruction.js +7 -0
- package/dist/domain/native/recordedCrash.js +2 -3
- package/dist/domain/offsetDateTime.js +17 -0
- package/dist/domain/process/processCapture.js +13 -12
- package/dist/domain/process/processCaptureCoverage.js +67 -0
- package/dist/domain/process/processCaptureExample.js +2 -1
- package/dist/domain/process/processCaptureParsing.js +1 -34
- package/dist/domain/process/processCaptureValidation.js +81 -13
- package/dist/domain/process/processComparison.js +41 -22
- package/dist/domain/process/processObservation.js +10 -2
- package/dist/domain/process/processScenario.js +24 -2
- package/dist/domain/process/processTraceComparison.js +0 -2
- package/dist/domain/process/processTraceDimensionProjection.js +1 -1
- package/dist/domain/process/processTraceEvaluation.js +15 -11
- package/dist/domain/process/processTraceSpecification.js +3 -4
- package/dist/domain/providerAdapterError.js +2 -0
- package/dist/domain/reconstructionCoverage.js +5 -2
- package/dist/domain/reconstructionObligationLedgerSchemas.js +2 -1
- package/dist/domain/reconstructionReadinessSchemas.js +2 -1
- package/dist/domain/reconstructionVerification.js +3 -3
- package/dist/domain/reconstructionVerificationSchemas.js +2 -1
- package/dist/domain/referenceSourceGraph.js +20 -21
- package/dist/domain/staticRuntimeCorrelation.js +2 -2
- package/dist/domain/stringPatterns.js +6 -0
- package/dist/domain/swiftSymbolClassification.js +61 -0
- package/dist/domain/symbolAnalysis.js +66 -18
- package/dist/domain/webCaptureDiff.js +0 -1
- package/dist/domain/webCaptureDiffSchemas.js +6 -3
- package/dist/domain/webEventListeners.js +3 -2
- package/dist/domain/webExecution.js +3 -2
- package/dist/domain/webRuntime.js +0 -2
- package/dist/domain/webScriptExport.js +1 -1
- package/dist/dotnet/ManagedArtifactInspector.js +2 -19
- package/dist/dotnet/ManagedMemberInspector.js +12 -18
- package/dist/dotnet/ManagedMemberInspectorCore.js +47 -44
- package/dist/dotnet/ManagedMemberRows.js +75 -62
- package/dist/dotnet/ManagedMetadataInventory.js +16 -22
- package/dist/dotnet/ManagedMethodBodyReader.js +4 -0
- package/dist/dotnet/ManagedNativeBoundaryHelpers.js +109 -94
- package/dist/dotnet/ManagedNativeBoundaryInspector.js +12 -21
- package/dist/dotnet/ManagedReaderFailure.js +16 -0
- package/dist/dotnet/ManagedStaticProvider.js +3 -5
- package/dist/evaluation/AgentEvaluationFixtures.js +250 -0
- package/dist/evaluation/AgentEvaluationReport.js +28 -0
- package/dist/evaluation/CodexAgentEval.js +12 -8
- package/dist/evaluation/KnownAnswerEvaluation.js +281 -0
- package/dist/evm/EvmoleInterfaceProvider.js +2 -1
- package/dist/firmware/FirmwareCommand.js +9 -5
- package/dist/firmware/FirmwareProvider.js +4 -4
- package/dist/generatedPackageMetadata.js +2 -2
- package/dist/ghidra/GhidraAnalysisProfile.js +3 -6
- package/dist/ghidra/GhidraClient.js +91 -32
- package/dist/ghidra/GhidraClientStartup.js +0 -2
- package/dist/ghidra/GhidraDoctor.js +6 -5
- package/dist/ghidra/GhidraFunctionValues.js +3 -5
- package/dist/ghidra/GhidraInstallation.js +40 -12
- package/dist/ghidra/GhidraJavaLaunch.js +6 -2
- package/dist/ghidra/GhidraLauncher.js +15 -7
- package/dist/ghidra/GhidraProvider.js +6 -2
- package/dist/ghidra/GhidraProviderCapabilities.js +6 -0
- package/dist/ghidra/GhidraProviderClient.js +13 -3
- package/dist/ghidra/GhidraSessionError.js +2 -0
- package/dist/ghidra/GhidraSessionRoot.js +39 -0
- package/dist/ghidra/extensions/GhidraExtensions.js +17 -10
- package/dist/ghidra/extensions/nativeaot/NativeAotAdapter.js +8 -2
- package/dist/hopper/BridgeLauncher.js +34 -45
- package/dist/hopper/HopperAnalysisProfile.js +3 -8
- package/dist/hopper/HopperCleanup.js +56 -27
- package/dist/hopper/HopperClient.js +86 -65
- package/dist/hopper/HopperMachOImage.js +3 -2
- package/dist/hopper/HopperProvider.js +16 -18
- package/dist/hopper/HopperRegexSearch.js +3 -6
- package/dist/hopper/HopperTargetLease.js +132 -49
- package/dist/hopper/LinuxPrivateDisplayProbe.js +6 -0
- package/dist/ida/IdaConfiguration.js +8 -3
- package/dist/ida/IdaInput.js +1 -7
- package/dist/ida/IdaMcpConnection.js +8 -4
- package/dist/ida/IdaOperationRunner.js +3 -3
- package/dist/ida/IdaProvider.js +8 -12
- package/dist/ida/IdaSessionClient.js +20 -18
- package/dist/ida/IdaWorkspace.js +12 -13
- package/dist/inspector/V8InspectorCaptureProjection.js +1 -1
- package/dist/inspector/V8InspectorProvider.js +38 -28
- package/dist/javascript/recovery/WakaruCommand.js +7 -2
- package/dist/javascript/recovery/WakaruExecution.js +5 -2
- package/dist/main/shutdown.js +11 -3
- package/dist/main/startup.js +9 -2
- package/dist/main/transport.js +22 -2
- package/dist/main.js +11 -18
- package/dist/native/AppleMachoSelection.js +16 -6
- package/dist/native/CommandRunner.js +9 -7
- package/dist/native/LldbCallTracer.js +8 -2
- package/dist/native/NativeMacOSProvider.js +25 -15
- package/dist/native/NativeUiHelperRuntime.js +11 -2
- package/dist/native/NativeUiObservation.js +2 -2
- package/dist/native/pwntools/PwntoolsDecoder.js +2 -1
- package/dist/process/DarwinProcessRunTokenReader.js +16 -2
- package/dist/process/ExecFileOutput.js +88 -6
- package/dist/process/PrivateRuntimeRoot.js +10 -5
- package/dist/process/ProcessOwnership.js +1 -4
- package/dist/process/ProcessOwnershipObservation.js +11 -5
- package/dist/process/ProviderProcess.js +1 -3
- package/dist/process/capture/FilesystemSnapshot.js +50 -13
- package/dist/process/capture/ProcessCaptureError.js +13 -0
- package/dist/process/capture/ProcessCaptureLifecycle.js +158 -70
- package/dist/process/capture/ProcessFilesystemEffects.js +33 -3
- package/dist/process/capture/ProcessHarness.js +21 -25
- package/dist/process/capture/ProcessNormalization.js +20 -2
- package/dist/process/capture/ProcessSampling.js +25 -2
- package/dist/process/capture/TerminalRenderer.js +14 -0
- package/dist/process/snapshotEnvironment.js +14 -0
- package/dist/server/EvidenceMcpServer.js +25 -14
- package/dist/server/createServer.js +49 -36
- package/dist/server/mcpClientMetadata.js +12 -5
- package/dist/server/promptCompletion.js +3 -8
- package/dist/server/registerAnalysisViewTool.js +15 -0
- package/dist/server/registerAndroidTools.js +2 -3
- package/dist/server/registerApplicationTools/compareExportShapes.js +4 -5
- package/dist/server/registerApplicationTools/compareSourceToBundle.js +4 -5
- package/dist/server/registerApplicationTools/compareVersions.js +4 -5
- package/dist/server/registerApplicationTools/coverage.js +1 -2
- package/dist/server/registerApplicationTools/helpers.js +1 -2
- package/dist/server/registerApplicationTools/obligationLedger.js +4 -5
- package/dist/server/registerApplicationTools/projectMobileApplicationGraph.js +3 -4
- package/dist/server/registerApplicationTools/traceFeature.js +4 -5
- package/dist/server/registerApplicationTools/traceSemantics.js +4 -5
- package/dist/server/registerArtifactComparisonTool.js +4 -5
- package/dist/server/registerBinaryDiagnosticsTools.js +2 -3
- package/dist/server/registerBrowserScenarioTool.js +3 -4
- package/dist/server/registerBrowserTools.js +13 -16
- package/dist/server/registerBundleComparisonTool.js +5 -6
- package/dist/server/registerCloseLifecycleTool.js +2 -3
- package/dist/server/registerElectronTools.js +10 -13
- package/dist/server/registerEnhancedTools.js +23 -23
- package/dist/server/registerEvidenceTools.js +3 -4
- package/dist/server/registerEvmTools.js +2 -3
- package/dist/server/registerFirmwareTools.js +2 -3
- package/dist/server/registerFunctionComparisonTool.js +7 -8
- package/dist/server/registerInvestigationTools.js +14 -15
- package/dist/server/registerJavaScriptRecoveryTool.js +2 -3
- package/dist/server/registerJavaScriptRuntimeObservationTools.js +6 -6
- package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +5 -6
- package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +4 -5
- package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +6 -7
- package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +6 -7
- package/dist/server/registerOfficialTools.js +4 -19
- package/dist/server/registerProcessComparisonTool.js +8 -8
- package/dist/server/registerRecordedCrashTools.js +2 -3
- package/dist/server/registerSessionRecordTools.js +15 -19
- package/dist/server/registerSessionStatusTool.js +3 -4
- package/dist/server/registerSessionTools.js +12 -18
- package/dist/server/registerWebModuleTool.js +2 -3
- package/dist/server/registerWebNetworkCaptureTool.js +2 -3
- package/dist/server/registerWebRuntimeTools.js +4 -5
- package/dist/server/registerWebScriptTool.js +2 -3
- package/dist/server/registerWebSourceLocationTool.js +2 -3
- package/dist/server/toolResult.js +66 -94
- package/dist/server/toolResultEncoding.js +11 -10
- package/dist/windows/WindowsNativeLoader.js +1 -0
- package/dist/windows/WindowsOwnedProcess.js +60 -15
- package/dist/windows/WindowsPrivateRuntime.js +7 -8
- package/native/windows/README.md +3 -1
- package/native/windows/build/manifest.json +2 -2
- package/native/windows/build/rea-windows-x64.node +0 -0
- package/package.json +39 -30
- package/scripts/rea.mjs +3 -6
- package/skills/reverse-engineer-anything/SKILL.md +9 -8
- package/skills/reverse-engineer-anything/references/android-applications.md +6 -3
- package/skills/reverse-engineer-anything/references/evidence-workflows.md +8 -4
- package/skills/reverse-engineer-anything/references/javascript-applications.md +16 -6
- package/skills/reverse-engineer-anything/references/native-and-artifacts.md +9 -0
- package/dist/config.js +0 -1
- package/dist/contracts/browserCaptureToolInputSchema.js +0 -43
- package/dist/contracts/process/processCaptureExample.js +0 -2
- package/dist/contracts/toolOutputSchemas.js +0 -2
- package/dist/main/reload.js +0 -12
- package/dist/main/state.js +0 -3
- package/dist/server/sessionToolPolicies.js +0 -2
|
@@ -9,8 +9,8 @@ import { nativeInstructionSchema, nativeCallTargetsSchema, } from "../domain/nat
|
|
|
9
9
|
import { jsonValueSchema } from "../domain/jsonValue.js";
|
|
10
10
|
import { residualUnknownSchema } from "../domain/residualUnknown.js";
|
|
11
11
|
import { evidenceBundleSchema } from "../domain/evidenceBundle.js";
|
|
12
|
-
import { processCaptureComparisonSchema
|
|
13
|
-
import { analysisBookmarkSchema, functionInstructionWindowSchema, referenceEdgeSchema, unresolvedCallSchema, analysisStringSchema, } from "../domain/hopperValues.js";
|
|
12
|
+
import { processCaptureComparisonSchema } from "../domain/process/processComparison.js";
|
|
13
|
+
import { analysisBookmarkSchema, functionInstructionWindowSchema, referenceEdgeSchema, unresolvedCallSchema, analysisStringSchema, procedureIdentitySchema, } from "../domain/hopperValues.js";
|
|
14
14
|
import { nativeApiInspectionResultSchema } from "../domain/native/nativeApiBoundary.js";
|
|
15
15
|
import { demangleSwiftSchema, inspectMachoSchema, inspectPlistSchema, inspectSignatureSchema, listArchitecturesSchema, } from "../domain/native/nativeInspection.js";
|
|
16
16
|
import { artifactExtractionResultSchema } from "../domain/artifactGraph.js";
|
|
@@ -21,20 +21,21 @@ import { keyedArchiveResultSchema } from "../domain/apple/keyedArchive.js";
|
|
|
21
21
|
import { appleAssetCatalogResultSchema } from "../domain/apple/appleAssetCatalog.js";
|
|
22
22
|
import { managedArtifactInspectionSchema, managedMemberInspectionSchema, managedNativeBoundaryInspectionSchema, } from "../domain/managed/managedArtifact.js";
|
|
23
23
|
import { managedMemberComparisonResultSchema } from "../domain/managed/managedMemberComparison.js";
|
|
24
|
-
import { managedNativeVerificationResultSchema } from "../domain/managed/
|
|
24
|
+
import { managedNativeVerificationResultSchema } from "../domain/managed/managedNativeVerificationSchemas.js";
|
|
25
25
|
import { managedReconstructionImportResultSchema } from "../domain/managed/managedReconstruction.js";
|
|
26
26
|
import { managedApplicationGraphResultSchema } from "../domain/managed/managedApplicationGraph.js";
|
|
27
27
|
import { artifactComparisonResultSchema } from "../domain/artifactComparison.js";
|
|
28
|
-
import { functionComparisonResultSchema } from "../domain/
|
|
28
|
+
import { functionComparisonResultSchema } from "../domain/functionComparisonSchemas.js";
|
|
29
29
|
import { bundleComparisonResultSchema } from "../domain/bundleComparison.js";
|
|
30
30
|
import { changedBehaviorResultSchema } from "../domain/changedBehavior.js";
|
|
31
|
-
import { callPathResultSchema } from "../domain/
|
|
31
|
+
import { callPathResultSchema } from "../domain/callPathSchemas.js";
|
|
32
32
|
import { staticRuntimeCorrelationResultSchema } from "../domain/staticRuntimeCorrelation.js";
|
|
33
|
-
import { reconstructionVerificationResultSchema } from "../domain/
|
|
33
|
+
import { reconstructionVerificationResultSchema } from "../domain/reconstructionVerificationSchemas.js";
|
|
34
34
|
import { analysisErrorProjectionSchema } from "./errorSchemas.js";
|
|
35
35
|
import { nativeDispatchMetadataResultSchema } from "../domain/native/objcSwiftMetadata.js";
|
|
36
36
|
import { nativeInvestigationTraceSchema } from "../domain/native/nativeInvestigationGraph.js";
|
|
37
|
-
import { addressList, addressedValue, addressedEntry, containingProcedureResolution, functionDossierOutput, graphNode, lifecycleResultOf, nullableText,
|
|
37
|
+
import { addressList, addressedValue, addressedEntry, containingProcedureResolution, functionDossierOutput, graphNode, lifecycleResultOf, nullableText, procedureInfoOutput, evidenceResultOf, segmentOutput, sessionProvider, symbolDiscoveryOutput, targetFormatSchema, targetKindSchema, } from "./toolOutputSchemaPrimitives.js";
|
|
38
|
+
import { processCaptureSchema } from "../domain/process/processCapture.js";
|
|
38
39
|
const contextFacetSchema = z.discriminatedUnion("state", [
|
|
39
40
|
z.object({ state: z.literal("available"), value: jsonValueSchema }),
|
|
40
41
|
z.object({
|
|
@@ -56,40 +57,40 @@ const bookmarkFacetSchema = z.discriminatedUnion("state", [
|
|
|
56
57
|
]);
|
|
57
58
|
/** Exact structured-content schemas shared by direct analysis providers. */
|
|
58
59
|
export const officialOutputSchemas = {
|
|
59
|
-
annotate_native_function:
|
|
60
|
-
inspect_native_load_image:
|
|
61
|
-
inspect_native_data_type:
|
|
62
|
-
inspect_native_instruction:
|
|
63
|
-
resolve_native_call_targets:
|
|
64
|
-
address_name:
|
|
65
|
-
comment:
|
|
66
|
-
current_address:
|
|
67
|
-
current_procedure:
|
|
68
|
-
current_document:
|
|
69
|
-
goto_address:
|
|
70
|
-
inline_comment:
|
|
71
|
-
list_bookmarks:
|
|
72
|
-
list_documents:
|
|
73
|
-
list_names:
|
|
74
|
-
list_procedures:
|
|
60
|
+
annotate_native_function: evidenceResultOf(nativeFunctionAnnotationsSchema),
|
|
61
|
+
inspect_native_load_image: evidenceResultOf(nativeLoadImageSchema),
|
|
62
|
+
inspect_native_data_type: evidenceResultOf(nativeDataTypeSchema),
|
|
63
|
+
inspect_native_instruction: evidenceResultOf(nativeInstructionSchema),
|
|
64
|
+
resolve_native_call_targets: evidenceResultOf(nativeCallTargetsSchema),
|
|
65
|
+
address_name: evidenceResultOf(nullableText),
|
|
66
|
+
comment: evidenceResultOf(nullableText),
|
|
67
|
+
current_address: evidenceResultOf(z.string()),
|
|
68
|
+
current_procedure: evidenceResultOf(z.string()),
|
|
69
|
+
current_document: evidenceResultOf(z.string()),
|
|
70
|
+
goto_address: evidenceResultOf(z.string()),
|
|
71
|
+
inline_comment: evidenceResultOf(nullableText),
|
|
72
|
+
list_bookmarks: evidenceResultOf(z.array(analysisBookmarkSchema)),
|
|
73
|
+
list_documents: evidenceResultOf(z.array(z.string())),
|
|
74
|
+
list_names: evidenceResultOf(z.array(addressedValue)),
|
|
75
|
+
list_procedures: evidenceResultOf(z.array(addressedValue)),
|
|
75
76
|
list_segments: segmentOutput,
|
|
76
|
-
list_strings:
|
|
77
|
-
next_address:
|
|
78
|
-
prev_address:
|
|
79
|
-
procedure_address:
|
|
80
|
-
procedure_assembly:
|
|
81
|
-
procedure_callees:
|
|
82
|
-
procedure_callers:
|
|
77
|
+
list_strings: evidenceResultOf(z.array(analysisStringSchema)),
|
|
78
|
+
next_address: evidenceResultOf(z.string()),
|
|
79
|
+
prev_address: evidenceResultOf(z.string()),
|
|
80
|
+
procedure_address: evidenceResultOf(z.string()),
|
|
81
|
+
procedure_assembly: evidenceResultOf(z.string()),
|
|
82
|
+
procedure_callees: evidenceResultOf(addressList),
|
|
83
|
+
procedure_callers: evidenceResultOf(addressList),
|
|
83
84
|
procedure_info: procedureInfoOutput,
|
|
84
|
-
read_function_instructions:
|
|
85
|
-
read_bytes:
|
|
85
|
+
read_function_instructions: evidenceResultOf(functionInstructionWindowSchema),
|
|
86
|
+
read_bytes: evidenceResultOf(z.object({
|
|
86
87
|
address: z.string(),
|
|
87
88
|
requested_bytes: z.number().int().min(1),
|
|
88
89
|
returned_bytes: z.number().int().min(0),
|
|
89
90
|
bytes_hex: z.string().regex(/^(?:[a-f0-9]{2})*$/u),
|
|
90
91
|
complete: z.boolean(),
|
|
91
92
|
})),
|
|
92
|
-
address_to_file_offset:
|
|
93
|
+
address_to_file_offset: evidenceResultOf(z.object({
|
|
93
94
|
address: z.string(),
|
|
94
95
|
file_offset: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
|
|
95
96
|
provider_file_offset: z
|
|
@@ -111,26 +112,26 @@ export const officialOutputSchemas = {
|
|
|
111
112
|
.exactOptional()
|
|
112
113
|
.describe("Observed original executable path used to verify the file mapping."),
|
|
113
114
|
})),
|
|
114
|
-
procedure_references:
|
|
115
|
-
procedure:
|
|
115
|
+
procedure_references: evidenceResultOf(z.object({
|
|
116
|
+
procedure: procedureIdentitySchema,
|
|
116
117
|
direction: z.enum(["incoming", "outgoing"]),
|
|
117
118
|
reference_kinds_available: z.boolean().optional(),
|
|
118
119
|
unresolved_calls: z.array(unresolvedCallSchema).default([]),
|
|
119
120
|
references: z.array(referenceEdgeSchema),
|
|
120
121
|
})),
|
|
121
|
-
procedure_pseudo_code:
|
|
122
|
-
resolve_containing_procedure:
|
|
123
|
-
search_procedures:
|
|
124
|
-
search_strings:
|
|
125
|
-
set_address_name:
|
|
126
|
-
set_addresses_names:
|
|
127
|
-
set_bookmark:
|
|
128
|
-
set_comment:
|
|
129
|
-
set_inline_comment:
|
|
130
|
-
unset_bookmark:
|
|
131
|
-
xrefs:
|
|
122
|
+
procedure_pseudo_code: evidenceResultOf(nullableText),
|
|
123
|
+
resolve_containing_procedure: evidenceResultOf(containingProcedureResolution),
|
|
124
|
+
search_procedures: evidenceResultOf(z.array(z.object({ address: z.string(), value: z.string() }))),
|
|
125
|
+
search_strings: evidenceResultOf(z.array(analysisStringSchema)),
|
|
126
|
+
set_address_name: evidenceResultOf(z.boolean()),
|
|
127
|
+
set_addresses_names: evidenceResultOf(z.record(z.string(), z.boolean())),
|
|
128
|
+
set_bookmark: evidenceResultOf(z.boolean()),
|
|
129
|
+
set_comment: evidenceResultOf(z.boolean()),
|
|
130
|
+
set_inline_comment: evidenceResultOf(z.boolean()),
|
|
131
|
+
unset_bookmark: evidenceResultOf(z.boolean()),
|
|
132
|
+
xrefs: evidenceResultOf(addressList),
|
|
132
133
|
};
|
|
133
|
-
const literalTraceOutput =
|
|
134
|
+
const literalTraceOutput = evidenceResultOf(z.object({
|
|
134
135
|
query: z.string(),
|
|
135
136
|
search_mode: z.literal("literal"),
|
|
136
137
|
matches: z.array(z.object({
|
|
@@ -146,7 +147,7 @@ const literalTraceOutput = resultOf(z.object({
|
|
|
146
147
|
truncated: z.boolean(),
|
|
147
148
|
residual_unknowns: z.array(z.string()),
|
|
148
149
|
}));
|
|
149
|
-
const callPathTraceOutput =
|
|
150
|
+
const callPathTraceOutput = evidenceResultOf(z.object({
|
|
150
151
|
start: z.string(),
|
|
151
152
|
goal: z.string().nullable(),
|
|
152
153
|
direction: z.enum(["forward", "backward"]),
|
|
@@ -172,22 +173,44 @@ const callPathTraceOutput = resultOf(z.object({
|
|
|
172
173
|
residual_unknowns: z.array(z.string()),
|
|
173
174
|
limitations: z.array(z.string()),
|
|
174
175
|
}));
|
|
176
|
+
/** Identity facts attached to one requested batch selector. */
|
|
177
|
+
const batchProcedureIdentity = z.discriminatedUnion("status", [
|
|
178
|
+
z.object({
|
|
179
|
+
status: z.literal("resolved"),
|
|
180
|
+
address: z.string().min(1).describe("Observed canonical procedure entry."),
|
|
181
|
+
name: z
|
|
182
|
+
.string()
|
|
183
|
+
.nullable()
|
|
184
|
+
.describe("Provider's entry label, or null when unavailable."),
|
|
185
|
+
name_error: analysisErrorProjectionSchema.optional(),
|
|
186
|
+
}),
|
|
187
|
+
z.object({
|
|
188
|
+
status: z.literal("unknown"),
|
|
189
|
+
error: analysisErrorProjectionSchema,
|
|
190
|
+
}),
|
|
191
|
+
]);
|
|
175
192
|
/** Exact structured-content schemas for composed analysis workflows. */
|
|
176
193
|
export const enhancedOutputSchemas = {
|
|
177
|
-
inspect_native_dispatch_metadata:
|
|
178
|
-
trace_native_values:
|
|
179
|
-
trace_native_ui_action:
|
|
194
|
+
inspect_native_dispatch_metadata: evidenceResultOf(nativeDispatchMetadataResultSchema),
|
|
195
|
+
trace_native_values: evidenceResultOf(nativeValueTraceSchema),
|
|
196
|
+
trace_native_ui_action: evidenceResultOf(nativeInvestigationTraceSchema),
|
|
180
197
|
get_objc_classes: symbolDiscoveryOutput("classes"),
|
|
181
198
|
get_objc_protocols: symbolDiscoveryOutput("protocols"),
|
|
182
|
-
batch_decompile:
|
|
199
|
+
batch_decompile: evidenceResultOf(z.object({
|
|
183
200
|
items: z.array(z.discriminatedUnion("status", [
|
|
184
201
|
z.object({
|
|
185
|
-
address: z
|
|
202
|
+
address: z
|
|
203
|
+
.string()
|
|
204
|
+
.describe("Original caller-selected symbol or address."),
|
|
205
|
+
procedure: batchProcedureIdentity,
|
|
186
206
|
status: z.literal("ok"),
|
|
187
207
|
pseudocode: z.string().min(1),
|
|
188
208
|
}),
|
|
189
209
|
z.object({
|
|
190
|
-
address: z
|
|
210
|
+
address: z
|
|
211
|
+
.string()
|
|
212
|
+
.describe("Original caller-selected symbol or address."),
|
|
213
|
+
procedure: batchProcedureIdentity,
|
|
191
214
|
status: z.literal("error"),
|
|
192
215
|
error: analysisErrorProjectionSchema,
|
|
193
216
|
}),
|
|
@@ -196,15 +219,23 @@ export const enhancedOutputSchemas = {
|
|
|
196
219
|
succeeded: z.number().int().min(0),
|
|
197
220
|
failed: z.number().int().min(0),
|
|
198
221
|
})),
|
|
199
|
-
get_call_graph:
|
|
200
|
-
analyze_swift_types:
|
|
222
|
+
get_call_graph: evidenceResultOf(z.record(z.string(), z.array(graphNode))),
|
|
223
|
+
analyze_swift_types: evidenceResultOf(z.object({
|
|
201
224
|
total: z.number().int().min(0),
|
|
202
225
|
categories: z.record(z.string(), z.object({
|
|
203
226
|
count: z.number().int().min(0),
|
|
204
|
-
items: z.array(addressedEntry
|
|
227
|
+
items: z.array(addressedEntry.extend({
|
|
228
|
+
mangled_names: z.array(z.string()),
|
|
229
|
+
})),
|
|
230
|
+
})),
|
|
231
|
+
unclassified: z.array(addressedEntry.extend({
|
|
232
|
+
mangled_names: z.array(z.string()),
|
|
233
|
+
reason: z.enum(["category_not_decoded", "conflicting_categories"]),
|
|
205
234
|
})),
|
|
235
|
+
limitations: z.array(z.string()),
|
|
236
|
+
symbol_inventory_error: analysisErrorProjectionSchema.exactOptional(),
|
|
206
237
|
})),
|
|
207
|
-
find_xrefs_to_name:
|
|
238
|
+
find_xrefs_to_name: evidenceResultOf(z.discriminatedUnion("status", [
|
|
208
239
|
z.object({
|
|
209
240
|
status: z.literal("resolved"),
|
|
210
241
|
name: z.string(),
|
|
@@ -217,7 +248,7 @@ export const enhancedOutputSchemas = {
|
|
|
217
248
|
reason: z.literal("name_not_found"),
|
|
218
249
|
}),
|
|
219
250
|
])),
|
|
220
|
-
binary_overview:
|
|
251
|
+
binary_overview: evidenceResultOf(z.object({
|
|
221
252
|
document: z.string(),
|
|
222
253
|
segments: z.array(z.object({
|
|
223
254
|
name: z.string(),
|
|
@@ -230,42 +261,42 @@ export const enhancedOutputSchemas = {
|
|
|
230
261
|
string_count: z.number().int().min(0),
|
|
231
262
|
})),
|
|
232
263
|
analyze_function: functionDossierOutput,
|
|
233
|
-
inspect_native_api:
|
|
264
|
+
inspect_native_api: evidenceResultOf(nativeApiInspectionResultSchema),
|
|
234
265
|
trace_feature: literalTraceOutput,
|
|
235
266
|
trace_call_path: callPathTraceOutput,
|
|
236
267
|
};
|
|
237
268
|
/** Exact Evidence schemas for provider-neutral native inspection. */
|
|
238
269
|
export const nativeOutputSchemas = {
|
|
239
|
-
observe_native_ui:
|
|
240
|
-
capture_native_ui_scenario:
|
|
241
|
-
observe_native_calls:
|
|
242
|
-
inspect_macho:
|
|
243
|
-
inspect_signature:
|
|
244
|
-
inspect_plist:
|
|
245
|
-
list_architectures:
|
|
246
|
-
demangle_swift:
|
|
270
|
+
observe_native_ui: evidenceResultOf(nativeUiResultSchema),
|
|
271
|
+
capture_native_ui_scenario: evidenceResultOf(nativeUiResultSchema),
|
|
272
|
+
observe_native_calls: evidenceResultOf(nativeCallObservationResultSchema),
|
|
273
|
+
inspect_macho: evidenceResultOf(inspectMachoSchema),
|
|
274
|
+
inspect_signature: evidenceResultOf(inspectSignatureSchema),
|
|
275
|
+
inspect_plist: evidenceResultOf(inspectPlistSchema),
|
|
276
|
+
list_architectures: evidenceResultOf(listArchitecturesSchema),
|
|
277
|
+
demangle_swift: evidenceResultOf(demangleSwiftSchema),
|
|
247
278
|
};
|
|
248
279
|
/** Exact Evidence schemas for provider-neutral artifact graph operations. */
|
|
249
280
|
export const artifactOutputSchemas = {
|
|
250
|
-
inspect_artifact:
|
|
251
|
-
extract_artifact:
|
|
252
|
-
decode_interface_builder:
|
|
253
|
-
inspect_keyed_archive:
|
|
254
|
-
inspect_asset_catalog:
|
|
255
|
-
trace_dylib_resolution:
|
|
281
|
+
inspect_artifact: evidenceResultOf(artifactInspectionResultSchema),
|
|
282
|
+
extract_artifact: evidenceResultOf(artifactExtractionResultSchema),
|
|
283
|
+
decode_interface_builder: evidenceResultOf(interfaceBuilderAnalysisSchema),
|
|
284
|
+
inspect_keyed_archive: evidenceResultOf(keyedArchiveResultSchema),
|
|
285
|
+
inspect_asset_catalog: evidenceResultOf(appleAssetCatalogResultSchema),
|
|
286
|
+
trace_dylib_resolution: evidenceResultOf(dylibResolutionResultSchema),
|
|
256
287
|
};
|
|
257
288
|
/** Exact Evidence schema for execution-free managed static analysis. */
|
|
258
289
|
export const managedOutputSchemas = {
|
|
259
|
-
inspect_managed_artifact:
|
|
260
|
-
inspect_managed_members:
|
|
261
|
-
inspect_managed_native_boundaries:
|
|
290
|
+
inspect_managed_artifact: evidenceResultOf(managedArtifactInspectionSchema),
|
|
291
|
+
inspect_managed_members: evidenceResultOf(managedMemberInspectionSchema),
|
|
292
|
+
inspect_managed_native_boundaries: evidenceResultOf(managedNativeBoundaryInspectionSchema),
|
|
262
293
|
};
|
|
263
294
|
/** Exact Evidence schema for provider-neutral managed workflows. */
|
|
264
295
|
export const managedWorkflowOutputSchemas = {
|
|
265
|
-
compare_managed_members:
|
|
266
|
-
verify_managed_native_boundaries:
|
|
267
|
-
import_managed_reconstruction:
|
|
268
|
-
project_managed_application_graph:
|
|
296
|
+
compare_managed_members: evidenceResultOf(managedMemberComparisonResultSchema),
|
|
297
|
+
verify_managed_native_boundaries: evidenceResultOf(managedNativeVerificationResultSchema),
|
|
298
|
+
import_managed_reconstruction: evidenceResultOf(managedReconstructionImportResultSchema),
|
|
299
|
+
project_managed_application_graph: evidenceResultOf(managedApplicationGraphResultSchema),
|
|
269
300
|
};
|
|
270
301
|
/** Exact structured-content schemas for target lifecycle operations. */
|
|
271
302
|
export const sessionOutputSchemas = {
|
|
@@ -273,7 +304,6 @@ export const sessionOutputSchemas = {
|
|
|
273
304
|
path: z.string(),
|
|
274
305
|
format: targetFormatSchema,
|
|
275
306
|
kind: targetKindSchema,
|
|
276
|
-
loaderArgs: z.array(z.string()),
|
|
277
307
|
sha256: z.string().regex(/^[a-f0-9]{64}$/u),
|
|
278
308
|
architecture: z.enum(["x86", "x86_64", "arm", "arm64"]).nullable(),
|
|
279
309
|
})),
|
|
@@ -282,7 +312,21 @@ export const sessionOutputSchemas = {
|
|
|
282
312
|
z.object({
|
|
283
313
|
path: z.string(),
|
|
284
314
|
bytes: z.number().int().min(0),
|
|
285
|
-
|
|
315
|
+
primitive_entries: z
|
|
316
|
+
.number()
|
|
317
|
+
.int()
|
|
318
|
+
.min(0)
|
|
319
|
+
.describe("Retained eligible primitive query bindings."),
|
|
320
|
+
workflow_entries: z
|
|
321
|
+
.number()
|
|
322
|
+
.int()
|
|
323
|
+
.min(0)
|
|
324
|
+
.describe("Retained eligible composed workflow bindings."),
|
|
325
|
+
evidence_records: z
|
|
326
|
+
.number()
|
|
327
|
+
.int()
|
|
328
|
+
.min(0)
|
|
329
|
+
.describe("All retained Evidence records, including observations without replay bindings."),
|
|
286
330
|
}),
|
|
287
331
|
])),
|
|
288
332
|
binary_session: lifecycleResultOf(z.union([
|
|
@@ -326,15 +370,15 @@ export const sessionOutputSchemas = {
|
|
|
326
370
|
unknowns_added: z.number().int().min(0),
|
|
327
371
|
total: z.number().int().min(0),
|
|
328
372
|
})),
|
|
329
|
-
capture_process_scenario:
|
|
330
|
-
compare_process_captures:
|
|
331
|
-
compare_artifacts:
|
|
332
|
-
compare_functions:
|
|
333
|
-
compare_bundles:
|
|
334
|
-
find_changed_behavior:
|
|
335
|
-
build_call_path:
|
|
336
|
-
correlate_static_and_runtime:
|
|
337
|
-
verify_reconstruction:
|
|
373
|
+
capture_process_scenario: evidenceResultOf(processCaptureSchema),
|
|
374
|
+
compare_process_captures: evidenceResultOf(processCaptureComparisonSchema),
|
|
375
|
+
compare_artifacts: evidenceResultOf(artifactComparisonResultSchema),
|
|
376
|
+
compare_functions: evidenceResultOf(functionComparisonResultSchema),
|
|
377
|
+
compare_bundles: evidenceResultOf(bundleComparisonResultSchema),
|
|
378
|
+
find_changed_behavior: evidenceResultOf(changedBehaviorResultSchema),
|
|
379
|
+
build_call_path: evidenceResultOf(callPathResultSchema),
|
|
380
|
+
correlate_static_and_runtime: evidenceResultOf(staticRuntimeCorrelationResultSchema),
|
|
381
|
+
verify_reconstruction: evidenceResultOf(reconstructionVerificationResultSchema),
|
|
338
382
|
list_unknowns: lifecycleResultOf(z.object({
|
|
339
383
|
items: z.array(residualUnknownSchema),
|
|
340
384
|
total: z.number().int().min(0),
|
|
@@ -1,21 +1,15 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { procedureClassificationSchema, procedureIdentitySchema, localVariableSchema, functionDossierSchema, functionBodySchema, } from "../domain/hopperValues.js";
|
|
3
3
|
import { analysisProfileSchema } from "../domain/analysisProfile.js";
|
|
4
|
-
import {
|
|
4
|
+
import { evidenceSchema, validateAnalysisProfileProvider, } from "../domain/evidence.js";
|
|
5
5
|
import { jsonValueSchema } from "../domain/jsonValue.js";
|
|
6
6
|
import { PROVIDER_REJECTION_CODES, } from "./providerSelection.js";
|
|
7
7
|
import { PROVIDER_FAILURE_STAGES, PROVIDER_OPERATION_STATES, PROVIDER_RETRY_ACTIONS, } from "../domain/providerOperationHealth.js";
|
|
8
8
|
import { analysisErrorProjectionSchema } from "./errorSchemas.js";
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
export const evidenceResultOf = (schema) => z.strictObject({
|
|
14
|
-
result: schema,
|
|
15
|
-
evidence_id: prefixedDigestSchema("ev"),
|
|
16
|
-
evidence: inlineEvidenceRecordSchema,
|
|
17
|
-
});
|
|
18
|
-
const resultOf = evidenceResultOf;
|
|
9
|
+
/** Specialize the single normalized result inside a complete Evidence record. */
|
|
10
|
+
export const evidenceResultOf = (schema) => z
|
|
11
|
+
.strictObject({ ...evidenceSchema.shape, normalized_result: schema })
|
|
12
|
+
.superRefine(validateAnalysisProfileProvider);
|
|
19
13
|
/** Wrap a lifecycle result while preserving its exact schema type. */
|
|
20
14
|
export const lifecycleResultOf = (schema) => z.object({ result: schema });
|
|
21
15
|
/** Resolve a required named output schema or reject contract drift. */
|
|
@@ -271,8 +265,6 @@ export const toolAvailability = z.discriminatedUnion("available", [
|
|
|
271
265
|
]);
|
|
272
266
|
export const sessionProvider = z
|
|
273
267
|
.object({
|
|
274
|
-
provider: providerIdentity,
|
|
275
|
-
providers: z.array(providerIdentity),
|
|
276
268
|
capabilities: z.array(providerCapability),
|
|
277
269
|
analysis_run: analysisRun,
|
|
278
270
|
analysis_activity: analysisActivity,
|
|
@@ -343,13 +335,11 @@ export const addressedEntry = z.object({
|
|
|
343
335
|
address: z.string(),
|
|
344
336
|
name: z.string(),
|
|
345
337
|
});
|
|
346
|
-
export const procedureIdentity = procedureIdentitySchema;
|
|
347
|
-
const localVariable = localVariableSchema;
|
|
348
338
|
export const containingProcedureResolution = z.discriminatedUnion("found", [
|
|
349
339
|
z.object({
|
|
350
340
|
query_address: z.string(),
|
|
351
341
|
found: z.literal(true),
|
|
352
|
-
procedure:
|
|
342
|
+
procedure: procedureIdentitySchema,
|
|
353
343
|
}),
|
|
354
344
|
z.object({
|
|
355
345
|
query_address: z.string(),
|
|
@@ -407,21 +397,21 @@ const memoryRegionOutput = z.object({
|
|
|
407
397
|
initialized: z.boolean().optional(),
|
|
408
398
|
overlay: z.boolean().optional(),
|
|
409
399
|
});
|
|
410
|
-
export const segmentOutput =
|
|
411
|
-
export const procedureInfoOutput =
|
|
400
|
+
export const segmentOutput = evidenceResultOf(z.array(memoryRegionOutput.extend({ sections: z.array(memoryRegionOutput) })));
|
|
401
|
+
export const procedureInfoOutput = evidenceResultOf(z.object({
|
|
412
402
|
name: z.string(),
|
|
413
403
|
entrypoint: z.string(),
|
|
414
404
|
basicblock_count: z.number().int().min(0),
|
|
415
405
|
length: z.number().min(0),
|
|
416
406
|
signature: nullableText,
|
|
417
|
-
locals: z.array(
|
|
407
|
+
locals: z.array(localVariableSchema),
|
|
418
408
|
classification: procedureClassificationSchema.nullable().default(null),
|
|
419
409
|
body: functionBodySchema.default({
|
|
420
410
|
available: false,
|
|
421
411
|
reason: "The provider did not report complete function body ranges.",
|
|
422
412
|
}),
|
|
423
413
|
}));
|
|
424
|
-
export const symbolDiscoveryOutput = (property) =>
|
|
414
|
+
export const symbolDiscoveryOutput = (property) => evidenceResultOf(z.object({
|
|
425
415
|
count: z.number().int().min(0),
|
|
426
416
|
[property]: z.array(addressedEntry),
|
|
427
417
|
}));
|
|
@@ -437,4 +427,4 @@ export const graphNode = z.discriminatedUnion("status", [
|
|
|
437
427
|
error: analysisErrorProjectionSchema,
|
|
438
428
|
}),
|
|
439
429
|
]);
|
|
440
|
-
export const functionDossierOutput =
|
|
430
|
+
export const functionDossierOutput = evidenceResultOf(functionDossierSchema);
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
+
import { presentInputJsonSchema } from "./inputSchemaPresentation.js";
|
|
2
3
|
const PROPERTY_DESCRIPTIONS = {
|
|
3
4
|
addresses: "Ordered provider-normalized procedure addresses to analyze.",
|
|
4
5
|
after: "The later or right-hand observation to compare.",
|
|
@@ -38,12 +39,21 @@ const PROPERTY_DESCRIPTIONS = {
|
|
|
38
39
|
unknown_id: "Exact residual-unknown identifier.",
|
|
39
40
|
};
|
|
40
41
|
/** Attach caller guidance to a canonical schema for the SDK wire projection. */
|
|
41
|
-
export const toolInputSchemaWithMetadata = (contract) => withAdvertisedJsonSchema(contract.inputSchema, "input", (project) => (options) =>
|
|
42
|
-
|
|
43
|
-
|
|
42
|
+
export const toolInputSchemaWithMetadata = (contract) => withAdvertisedJsonSchema(contract.inputSchema, "input", (project) => (options) => {
|
|
43
|
+
const shared = project({
|
|
44
|
+
...options,
|
|
45
|
+
libraryOptions: { reused: "ref", ...options.libraryOptions },
|
|
46
|
+
});
|
|
47
|
+
return {
|
|
48
|
+
...presentInputJsonSchema(shared, fallbackPropertyDescription),
|
|
49
|
+
examples: contract.examples.map(({ input }) => input),
|
|
50
|
+
};
|
|
51
|
+
});
|
|
52
|
+
/** Share repeated output definitions without changing canonical validation. */
|
|
53
|
+
export const toolOutputSchemaWithMetadata = (contract) => withAdvertisedJsonSchema(contract.outputSchema, "output", (project) => (options) => project({
|
|
54
|
+
...options,
|
|
55
|
+
libraryOptions: { reused: "ref", ...options.libraryOptions },
|
|
44
56
|
}));
|
|
45
|
-
/** Advertise a canonical output schema without reconverting it per listing. */
|
|
46
|
-
export const toolOutputSchemaWithMetadata = (contract) => withAdvertisedJsonSchema(contract.outputSchema, "output");
|
|
47
57
|
const withAdvertisedJsonSchema = (canonical, io, advertise = (project) => project) => {
|
|
48
58
|
// Zod's input projection drops root metadata when a descendant transforms.
|
|
49
59
|
// Preserve the parser and let the SDK own conversion of everything else.
|
|
@@ -79,70 +89,10 @@ const memoizeByTarget = (project) => {
|
|
|
79
89
|
return projected;
|
|
80
90
|
};
|
|
81
91
|
};
|
|
82
|
-
/** Keep MCP tool roots object-shaped for clients that reject root unions. */
|
|
83
|
-
const flattenRootUnion = (value) => {
|
|
84
|
-
if (!Array.isArray(value.anyOf))
|
|
85
|
-
return value;
|
|
86
|
-
const branches = value.anyOf.filter(isObject);
|
|
87
|
-
if (branches.length === 0 || branches.length !== value.anyOf.length)
|
|
88
|
-
return value;
|
|
89
|
-
const properties = {};
|
|
90
|
-
for (const branch of branches) {
|
|
91
|
-
if (!isObject(branch.properties))
|
|
92
|
-
return value;
|
|
93
|
-
for (const [name, schema] of Object.entries(branch.properties)) {
|
|
94
|
-
const previous = properties[name];
|
|
95
|
-
if (previous === undefined)
|
|
96
|
-
properties[name] = schema;
|
|
97
|
-
else if (JSON.stringify(previous) !== JSON.stringify(schema))
|
|
98
|
-
properties[name] = {
|
|
99
|
-
anyOf: [previous, schema],
|
|
100
|
-
description: fallbackPropertyDescription(name),
|
|
101
|
-
};
|
|
102
|
-
}
|
|
103
|
-
}
|
|
104
|
-
// The canonical Zod parser still enforces branch validation at invocation.
|
|
105
|
-
const { anyOf: _anyOf, required: _required, ...root } = value;
|
|
106
|
-
const requiredByBranch = branches.map((branch) => Array.isArray(branch.required)
|
|
107
|
-
? branch.required.filter((item) => typeof item === "string")
|
|
108
|
-
: []);
|
|
109
|
-
const required = requiredByBranch.reduce((common, current) => common.filter((name) => current.includes(name)));
|
|
110
|
-
const minProperties = Math.max(typeof root.minProperties === "number" ? root.minProperties : 0, Math.min(...requiredByBranch.map((names) => names.length)));
|
|
111
|
-
return {
|
|
112
|
-
...root,
|
|
113
|
-
type: "object",
|
|
114
|
-
properties,
|
|
115
|
-
...(minProperties > 0 ? { minProperties } : {}),
|
|
116
|
-
...(required.length > 0 ? { required } : {}),
|
|
117
|
-
...(branches.every((branch) => branch.additionalProperties === false)
|
|
118
|
-
? { additionalProperties: false }
|
|
119
|
-
: {}),
|
|
120
|
-
};
|
|
121
|
-
};
|
|
122
|
-
const describeProperties = (value) => Object.fromEntries(Object.entries(value).map(([key, child]) => {
|
|
123
|
-
if (key !== "properties" || !isObject(child))
|
|
124
|
-
return [key, describeValue(child)];
|
|
125
|
-
return [
|
|
126
|
-
key,
|
|
127
|
-
Object.fromEntries(Object.entries(child).map(([property, propertySchema]) => [
|
|
128
|
-
property,
|
|
129
|
-
isObject(propertySchema) &&
|
|
130
|
-
typeof propertySchema.description !== "string"
|
|
131
|
-
? {
|
|
132
|
-
...describeProperties(propertySchema),
|
|
133
|
-
description: fallbackPropertyDescription(property),
|
|
134
|
-
}
|
|
135
|
-
: describeValue(propertySchema),
|
|
136
|
-
])),
|
|
137
|
-
];
|
|
138
|
-
}));
|
|
139
|
-
const describeValue = (value) => {
|
|
140
|
-
if (Array.isArray(value))
|
|
141
|
-
return value.map(describeValue);
|
|
142
|
-
return isObject(value) ? describeProperties(value) : value;
|
|
143
|
-
};
|
|
144
92
|
const fallbackPropertyDescription = (property) => {
|
|
145
|
-
const explicit = PROPERTY_DESCRIPTIONS
|
|
93
|
+
const explicit = Object.hasOwn(PROPERTY_DESCRIPTIONS, property)
|
|
94
|
+
? PROPERTY_DESCRIPTIONS[property]
|
|
95
|
+
: undefined;
|
|
146
96
|
if (explicit !== undefined)
|
|
147
97
|
return explicit;
|
|
148
98
|
const words = property.replaceAll("_", " ");
|
|
@@ -170,4 +120,3 @@ const fallbackPropertyDescription = (property) => {
|
|
|
170
120
|
return `Whether ${words}.`;
|
|
171
121
|
return `Value for ${words}.`;
|
|
172
122
|
};
|
|
173
|
-
const isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { inspectWebNetworkCaptureInputSchema, webNetworkCaptureSchema, } from "../domain/webNetworkCapture.js";
|
|
2
2
|
import { toolContractMetadata } from "./toolEffects.js";
|
|
3
|
-
import { evidenceResultOf } from "./
|
|
3
|
+
import { evidenceResultOf } from "./toolOutputSchemaPrimitives.js";
|
|
4
4
|
/** Historical inspection is distinct from live browser capture and runtime authority. */
|
|
5
5
|
export const WEB_NETWORK_CAPTURE_TOOL_CONTRACTS = [
|
|
6
6
|
{
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { toolContractMetadata } from "./toolEffects.js";
|
|
2
|
-
import { evidenceResultOf } from "./
|
|
2
|
+
import { evidenceResultOf } from "./toolOutputSchemaPrimitives.js";
|
|
3
3
|
import { observeWebExecutionInputSchema, webExecutionSchema, } from "../domain/webExecution.js";
|
|
4
4
|
import { inspectWebEventListenersInputSchema, webEventListenersSchema, } from "../domain/webEventListeners.js";
|
|
5
5
|
/** Native website runtime primitives distinguish instrumentation from listener inspection. */
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { exportWebScriptsInputSchema, webScriptExportResultSchema, } from "../domain/webScriptExport.js";
|
|
2
2
|
import { webModuleTraceInputSchema, webModuleTraceResultSchema, } from "../domain/webModuleTrace.js";
|
|
3
3
|
import { toolContractMetadata } from "./toolEffects.js";
|
|
4
|
-
import { evidenceResultOf } from "./
|
|
4
|
+
import { evidenceResultOf } from "./toolOutputSchemaPrimitives.js";
|
|
5
5
|
import { webSourceLocationInputSchema, webSourceLocationResultSchema, } from "../domain/webSourceLocation.js";
|
|
6
6
|
/** Local captured-script publication contracts shared by CLI and MCP. */
|
|
7
7
|
export const WEB_SCRIPT_TOOL_CONTRACTS = [
|
package/dist/doctorRuntime.js
CHANGED
|
@@ -4,17 +4,19 @@ import { inspectSystemGhidraProvider } from "./ghidra/GhidraDoctor.js";
|
|
|
4
4
|
import { inspectIdaRegistration } from "./ida/IdaDoctor.js";
|
|
5
5
|
import { selectLinuxPrivateDisplayStrategy } from "./hopper/LinuxPrivateDisplayProbe.js";
|
|
6
6
|
/** Compose provider diagnostics at the outer CLI adapter boundary. */
|
|
7
|
-
export const createSystemDoctorHost = () => systemDoctorHost({
|
|
7
|
+
export const createSystemDoctorHost = (environment = process.env) => systemDoctorHost({
|
|
8
|
+
environment,
|
|
8
9
|
providerInspections: async () => [
|
|
9
|
-
await inspectSystemGhidraProvider(),
|
|
10
|
-
inspectIdaRegistration(
|
|
10
|
+
await inspectSystemGhidraProvider(environment),
|
|
11
|
+
inspectIdaRegistration(environment.REA_IDA_MCP_CONFIG),
|
|
11
12
|
],
|
|
12
|
-
linuxDemoRuntimeCheck: inspectLinuxPrivateDisplay,
|
|
13
|
+
linuxDemoRuntimeCheck: () => inspectLinuxPrivateDisplay(environment),
|
|
13
14
|
});
|
|
14
15
|
const HOPPER_DEMO_HELPER_PATH = fileURLToPath(new URL("../scripts/hopper-demo-x11.py", import.meta.url));
|
|
15
|
-
const inspectLinuxPrivateDisplay = async () => {
|
|
16
|
+
const inspectLinuxPrivateDisplay = async (environment) => {
|
|
16
17
|
const selection = await selectLinuxPrivateDisplayStrategy({
|
|
17
18
|
helperPath: HOPPER_DEMO_HELPER_PATH,
|
|
19
|
+
environment,
|
|
18
20
|
});
|
|
19
21
|
const value = selection.diagnostic;
|
|
20
22
|
const detail = [
|
|
@@ -5,11 +5,14 @@ export class AnalysisUnsupportedTargetError extends AnalysisError {
|
|
|
5
5
|
path;
|
|
6
6
|
reason;
|
|
7
7
|
_tag = "AnalysisUnsupportedTargetError";
|
|
8
|
+
/** Refusal-specific recovery, when the producer knows an available workflow. */
|
|
9
|
+
remediationAction;
|
|
8
10
|
constructor(operation, path, reason, options) {
|
|
9
11
|
super(`Unsupported target for ${operation} at ${path}: ${reason}`, options);
|
|
10
12
|
this.operation = operation;
|
|
11
13
|
this.path = path;
|
|
12
14
|
this.reason = reason;
|
|
15
|
+
this.remediationAction = options?.remediationAction;
|
|
13
16
|
}
|
|
14
17
|
}
|
|
15
18
|
/** An analysis or transport resource failure, distinct from malformed input or unsupported coverage. */
|