rea-agents 5.0.0 → 6.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +168 -655
- package/bridge/android/ReaJadxBridge.java +14 -5
- package/bridge/ghidra/ReaGhidraBridge.java +173 -47
- package/bridge/hopper_bridge.py +310 -128
- package/bridge/mitmproxy/capture.py +208 -0
- package/bridge/native/rea_lldb_tracer.py +839 -0
- package/bridge/process/ProcessRunTokenReader.swift +297 -0
- package/bridge/process/ProcessRunTokenReaderMain.swift +35 -0
- package/bridge/pwndbg/core_context.py +101 -0
- package/bridge/pwndbg/launch.py +39 -0
- package/bridge/pwndbg/launch_impl.py +34 -0
- package/bridge/pwntools/decoder_runtime.py +59 -0
- package/bridge/pwntools/layout.py +39 -0
- package/bridge/pwntools/layout_impl.py +309 -0
- package/bridge/pwntools/recorded_crash.py +39 -0
- package/bridge/pwntools/recorded_crash_impl.py +147 -0
- package/dist/android/JadxConfiguration.js +196 -33
- package/dist/android/JadxMcpTransport.js +4 -0
- package/dist/android/JadxProtocol.js +6 -0
- package/dist/android/JadxProvider.js +20 -2
- package/dist/android/JadxSession.js +23 -4
- package/dist/application/AnalysisContextQueries.js +8 -35
- package/dist/application/AnalysisDocument.js +32 -0
- package/dist/application/AppBundleExecutable.js +67 -21
- package/dist/application/CallPathTracing.js +19 -3
- package/dist/application/CapabilityInventory.js +27 -3
- package/dist/application/ClientConfigurationDocument.js +871 -6
- package/dist/application/ClientRegistrationIdentity.js +26 -5
- package/dist/application/ClientRegistrationStatus.js +29 -14
- package/dist/application/DirectAnalysis.js +97 -33
- package/dist/application/Doctor.js +4 -2
- package/dist/application/DoctorScope.js +25 -13
- package/dist/application/EnhancedLiteralTracing.js +22 -25
- package/dist/application/EnhancedTools.js +13 -11
- package/dist/application/EvidenceBundleFiles.js +24 -12
- package/dist/application/FunctionAnalysisEvidence.js +2 -3
- package/dist/application/InventoryProjectionEvidence.js +4 -3
- package/dist/application/InvestigationProviders.js +3 -2
- package/dist/application/JsonFiles.js +50 -28
- package/dist/application/ProcedureAddressResolution.js +11 -0
- package/dist/application/ReconstructionCoverageService.js +7 -4
- package/dist/application/ReconstructionObligationCandidates.js +5 -1
- package/dist/application/ReconstructionObligationLedgerService.js +4 -3
- package/dist/application/Setup.js +13 -1
- package/dist/application/SetupClientConfiguration.js +10 -15
- package/dist/application/SetupHost.js +5 -2
- package/dist/application/SetupPlan.js +5 -3
- package/dist/application/SupportedClients.js +34 -1
- package/dist/application/Uninstall.js +4 -3
- package/dist/application/Update.js +18 -3
- package/dist/application/UpdateRuntime.js +46 -25
- package/dist/application/WebModuleTraceService.js +4 -2
- package/dist/application/WebNetworkCapturePort.js +1 -0
- package/dist/application/WebNetworkCaptureService.js +134 -0
- package/dist/application/WebRuntimeService.js +5 -3
- package/dist/application/WebScriptExportService.js +2 -2
- package/dist/application/WebSourceLocationService.js +4 -2
- package/dist/application/WindowsCapabilities.js +1 -1
- package/dist/application/WorkflowEvidence.js +82 -0
- package/dist/application/binary/AnalysisProviderEvaluation.js +21 -5
- package/dist/application/binary/AnalysisProviderRegistry.js +2 -0
- package/dist/application/binary/AnalysisSnapshotCache.js +52 -12
- package/dist/application/binary/BinarySession.js +131 -76
- package/dist/application/binary/BinarySessionOpen.js +19 -6
- package/dist/application/binary/BinarySessionRecords.js +45 -3
- package/dist/application/binary/BinarySessionStatus.js +17 -1
- package/dist/application/binary/CompositeProvider.js +13 -0
- package/dist/application/binary/LazyAnalysisProvider.js +3 -0
- package/dist/application/binaryDiagnostics/BinaryLayoutPort.js +1 -0
- package/dist/application/binaryDiagnostics/BinaryLayoutService.js +59 -0
- package/dist/application/binaryDiagnostics/RecordedCrashPort.js +1 -0
- package/dist/application/binaryDiagnostics/RecordedCrashService.js +62 -0
- package/dist/application/evm/EvmInterfacePort.js +1 -0
- package/dist/application/evm/EvmInterfaceService.js +64 -0
- package/dist/application/investigation/EvidenceLedger.js +21 -7
- package/dist/application/investigation/InvestigationRecords.js +8 -0
- package/dist/application/javascript/JavaScriptAnalysisControl.js +34 -0
- package/dist/application/javascript/JavaScriptApplicationEvidence.js +25 -5
- package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
- package/dist/application/javascript/JavaScriptApplicationService.js +34 -14
- package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
- package/dist/application/javascript/JavaScriptArtifactAnalysis.js +47 -27
- package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +39 -7
- package/dist/application/javascript/JavaScriptArtifactGraphDocuments.js +26 -2
- package/dist/application/javascript/JavaScriptArtifactPathResolution.js +80 -27
- package/dist/application/javascript/JavaScriptArtifactReconstruction.js +33 -12
- package/dist/application/javascript/JavaScriptModuleRelationships.js +37 -8
- package/dist/application/javascript/JavaScriptRecoveryService.js +4 -2
- package/dist/application/javascript/JavaScriptRuntimeObservationService.js +3 -1
- package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +3 -3
- package/dist/application/javascript/JavaScriptSemanticGraphAsyncProjection.js +7 -7
- package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +149 -72
- package/dist/application/javascript/JavaScriptSemanticGraphChildProcessProjection.js +14 -15
- package/dist/application/javascript/JavaScriptSemanticGraphConstruction.js +41 -1
- package/dist/application/javascript/JavaScriptSemanticGraphDataProjection.js +7 -7
- package/dist/application/javascript/JavaScriptSemanticGraphFlowProjection.js +5 -9
- package/dist/application/javascript/JavaScriptSemanticGraphObjectProjection.js +3 -3
- package/dist/application/javascript/JavaScriptSemanticGraphProjection.js +118 -12
- package/dist/application/javascript/JavaScriptSemanticGraphResourceProjection.js +3 -3
- package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +27 -5
- package/dist/application/managed/ManagedApplicationGraphService.js +4 -3
- package/dist/application/managed/ManagedMemberComparisonService.js +7 -4
- package/dist/application/managed/ManagedNativeVerificationService.js +4 -3
- package/dist/application/managed/ManagedReconstructionService.js +4 -3
- package/dist/application/{ProcessCli.js → process/ProcessCli.js} +23 -15
- package/dist/application/{ProcessEvidence.js → process/ProcessEvidence.js} +8 -7
- package/dist/application/workflowInputError.js +18 -0
- package/dist/artifacts/ArtifactProvider.js +42 -5
- package/dist/artifacts/ArtifactProviderMetadata.js +2 -1
- package/dist/artifacts/MachOSliceArtifactReader.js +98 -14
- package/dist/artifacts/NativeDmgArtifactReader.js +13 -6
- package/dist/artifacts/ZipArtifactReader.js +3 -0
- package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +22 -3
- package/dist/artifacts/apple/DylibResolutionReader.js +259 -0
- package/dist/artifacts/apple/InterfaceBuilderAnalysis.js +176 -56
- package/dist/artifacts/apple/InterfaceBuilderDecodeBudget.js +195 -0
- package/dist/artifacts/apple/KeyedArchiveReader.js +36 -22
- package/dist/artifacts/apple/MachoLoadCommandReader.js +355 -0
- package/dist/artifacts/apple/NibArchive.js +81 -14
- package/dist/artifacts/apple/NibViewHierarchy.js +10 -3
- package/dist/artifacts/apple/PlistNumberLiterals.js +164 -0
- package/dist/{application → artifacts/extraction}/ArtifactExtraction.js +10 -10
- package/dist/{application → artifacts/inventory}/ArtifactGraphConstruction.js +16 -11
- package/dist/{application → artifacts/inventory}/ArtifactInventory.js +4 -4
- package/dist/{application/ArtifactInventory → artifacts/inventory}/classify.js +2 -2
- package/dist/{application/ArtifactInventory → artifacts/inventory}/reader.js +5 -5
- package/dist/{application/ArtifactInventory → artifacts/inventory}/scanCanonical.js +14 -17
- package/dist/{application/ArtifactInventory → artifacts/inventory}/scanReader.js +5 -5
- package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
- package/dist/artifacts/readStableArtifact.js +20 -4
- package/dist/browser/CdpCaptureCompleteness.js +2 -0
- package/dist/browser/CdpCaptureEventHandlers.js +165 -12
- package/dist/browser/CdpCaptureEventTypes.js +5 -1
- package/dist/browser/CdpCaptureEvents.js +34 -0
- package/dist/browser/CdpConnection.js +30 -11
- package/dist/browser/CdpOptionalCommand.js +2 -3
- package/dist/browser/CdpPageCapture.js +23 -1
- package/dist/browser/PlaywrightElectronActiveActions.js +32 -23
- package/dist/browser/PlaywrightElectronActiveProjection.js +141 -0
- package/dist/browser/PlaywrightElectronActiveProvider.js +130 -122
- package/dist/browser/WebSourceMapFetcher.js +426 -72
- package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
- package/dist/browser/history/CaptureFailures.js +137 -0
- package/dist/browser/history/CaptureFormatError.js +10 -0
- package/dist/browser/history/CaptureRedaction.js +65 -0
- package/dist/browser/history/CaptureRelease.js +17 -0
- package/dist/browser/history/HarCapture.js +165 -0
- package/dist/browser/history/HarCaptureAdapter.js +20 -0
- package/dist/browser/history/HarCaptureProcess.js +57 -0
- package/dist/browser/history/HarJson.js +92 -0
- package/dist/browser/history/HarSchema.js +72 -0
- package/dist/browser/history/HistoricalCaptureDecoder.js +188 -0
- package/dist/browser/history/HistoricalCaptureFormatAdapter.js +1 -0
- package/dist/browser/history/MitmproxyCaptureAdapter.js +42 -0
- package/dist/cli/analysisSelector.js +23 -0
- package/dist/cli/applicationCommands.js +2 -3
- package/dist/cli/artifactCommands.js +26 -1
- package/dist/cli/binaryDiagnosticsCommands.js +39 -0
- package/dist/cli/coreAnalysisCommands.js +2 -2
- package/dist/cli/coreBinaryCommands.js +78 -20
- package/dist/cli/electronCommands.js +21 -13
- package/dist/cli/evmCommands.js +24 -0
- package/dist/cli/firmwareCommands.js +6 -3
- package/dist/cli/javascriptApplicationAnalysis.js +20 -3
- package/dist/cli/jsonOutput.js +38 -0
- package/dist/cli/nativeCallCommands.js +34 -0
- package/dist/cli/processCommands.js +1 -1
- package/dist/cli/streamedJsonOutput.js +56 -0
- package/dist/cli/utilityCommands.js +2 -0
- package/dist/cli/webNetworkCaptureCommands.js +40 -0
- package/dist/cli/webRuntimeCommands.js +8 -8
- package/dist/cli.js +11 -4
- package/dist/cliBrowserScenarioCommands.js +2 -2
- package/dist/cliCommandNames.js +6 -1
- package/dist/cliJsonInput.js +35 -1
- package/dist/cliOutput.js +21 -6
- package/dist/composition/binaryDiagnostics.js +8 -0
- package/dist/composition/evm.js +4 -0
- package/dist/composition/webNetworkCaptures.js +6 -0
- package/dist/config/environment.js +4 -0
- package/dist/config/ghidraStartupTimeout.js +17 -0
- package/dist/config/mcpResponseBudget.js +22 -0
- package/dist/config/parseConfig.js +2 -1
- package/dist/contracts/artifactToolContracts.js +6 -0
- package/dist/contracts/browserCaptureToolInputSchema.js +43 -0
- package/dist/contracts/browserToolContracts.js +4 -3
- package/dist/contracts/enhancedInputs.js +5 -3
- package/dist/contracts/enhancedToolContracts.js +3 -3
- package/dist/contracts/errorSchemas.js +8 -1
- package/dist/contracts/evm/evmToolContracts.js +20 -0
- package/dist/contracts/hopperMemoryContracts.js +2 -5
- package/dist/contracts/investigationExamples.js +2 -2
- package/dist/contracts/javascript/electronToolContracts.js +1 -1
- package/dist/contracts/managed/managedToolContracts.js +8 -6
- package/dist/contracts/native/binaryDiagnosticsToolContracts.js +42 -0
- package/dist/contracts/native/nativeToolContracts.js +21 -3
- package/dist/contracts/officialToolContracts.js +26 -24
- package/dist/contracts/process/processCaptureExample.js +2 -0
- package/dist/contracts/promptContracts.js +3 -3
- package/dist/contracts/sessionLifecycleInputs.js +18 -5
- package/dist/contracts/sessionStatusContract.js +8 -2
- package/dist/contracts/sessionToolContracts.js +8 -3
- package/dist/contracts/sessionToolSchemas.js +8 -4
- package/dist/contracts/toolContractExamples.js +1 -2
- package/dist/contracts/toolContractHelpers.js +4 -1
- package/dist/contracts/toolContracts.js +6 -0
- package/dist/contracts/toolEffects.js +30 -1
- package/dist/contracts/toolOutputSchemaGroups.js +33 -28
- package/dist/contracts/toolOutputSchemaPrimitives.js +19 -1
- package/dist/contracts/toolSchemaMetadata.js +69 -10
- package/dist/contracts/webNetworkCaptureToolContracts.js +24 -0
- package/dist/domain/analysisErrorBase.js +22 -2
- package/dist/domain/analysisErrorCore.js +61 -5
- package/dist/domain/analysisErrorPresentation.js +95 -12
- package/dist/domain/analysisErrorProjection.js +148 -19
- package/dist/domain/analysisSnapshot.js +166 -2
- package/dist/domain/android/androidAnalysis.js +2 -4
- package/dist/domain/android/androidApplication.js +17 -9
- package/dist/domain/apple/appleApplication.js +41 -14
- package/dist/domain/apple/dyldEnvironment.js +73 -0
- package/dist/domain/apple/dyldPaths.js +81 -0
- package/dist/domain/apple/dylibResolution.js +478 -0
- package/dist/domain/apple/dylibResolutionFindings.js +77 -0
- package/dist/domain/apple/interfaceBuilderGraph.js +25 -13
- package/dist/domain/apple/interfaceBuilderKeyedArchive.js +13 -3
- package/dist/domain/apple/keyedArchive.js +9 -1
- package/dist/domain/apple/machoContainer.js +54 -0
- package/dist/domain/apple/plistNumbers.js +76 -0
- package/dist/domain/artifactIdentity.js +29 -0
- package/dist/domain/artifactInventoryEvidence.js +19 -24
- package/dist/domain/artifactPathSyntax.js +1 -1
- package/dist/domain/bridgeCandidateProjection.js +71 -0
- package/dist/domain/browserCompleteness.js +1 -0
- package/dist/domain/browserObservation.js +1 -1
- package/dist/domain/browserObservationError.js +24 -5
- package/dist/domain/browserObservationSchemas.js +13 -0
- package/dist/domain/browserScenarioValues.js +5 -2
- package/dist/domain/bundleComparison.js +3 -2
- package/dist/domain/callPathSchemas.js +1 -1
- package/dist/domain/canonicalDigest.js +13 -1
- package/dist/domain/canonicalJsonDigestSteps.js +133 -0
- package/dist/domain/canonicalOrdering.js +9 -5
- package/dist/domain/changedBehavior.js +9 -9
- package/dist/domain/comparisonSourceEvidence.js +40 -0
- package/dist/domain/comparisonStatus.js +2 -30
- package/dist/domain/configurationErrors.js +1 -1
- package/dist/domain/conformanceTrustGate.js +0 -16
- package/dist/domain/evidence.js +78 -11
- package/dist/domain/evidenceBundle.js +42 -1
- package/dist/domain/evidenceErrors.js +12 -1
- package/dist/domain/evm/evmInterface.js +63 -0
- package/dist/domain/explicitSensitiveFailure.js +108 -0
- package/dist/domain/explicitSensitiveValues.js +10 -0
- package/dist/domain/firmware/firmwareAnalysis.js +10 -4
- package/dist/domain/hopperErrors.js +23 -2
- package/dist/domain/hopperValues.js +51 -8
- package/dist/domain/immutableJson.js +114 -0
- package/dist/domain/inputIssueProjection.js +3 -0
- package/dist/domain/javascript/electronActiveObservation.js +37 -6
- package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
- package/dist/domain/javascript/htmlArtifactReferences.js +40 -0
- package/dist/domain/javascript/javascriptApplicationAnalysis.js +71 -23
- package/dist/domain/javascript/javascriptApplicationGraph.js +13 -0
- package/dist/domain/javascript/javascriptAstValues.js +20 -0
- package/dist/domain/javascript/javascriptExportShapeComparison.js +21 -5
- package/dist/domain/javascript/javascriptExportShapeVariants.js +0 -10
- package/dist/domain/javascript/javascriptRecovery.js +3 -8
- package/dist/domain/javascript/javascriptSemanticAnalysis.js +97 -2
- package/dist/domain/javascript/javascriptSemanticCoverage.js +6 -5
- package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +9 -17
- package/dist/domain/javascript/javascriptSemanticDataEffects.js +22 -5
- package/dist/domain/javascript/javascriptSemanticGraph.js +34 -5
- package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +1 -0
- package/dist/domain/javascript/javascriptSemanticPrimitives.js +25 -17
- package/dist/domain/javascript/javascriptSemanticQuerySchemas.js +8 -4
- package/dist/domain/javascript/javascriptSemanticResourceLimits.js +77 -0
- package/dist/domain/javascript/javascriptSemanticValues.js +83 -11
- package/dist/domain/javascript/javascriptSourceParser.js +6 -2
- package/dist/domain/javascript/javascriptStaticAnalysis.js +22 -17
- package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +5 -3
- package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +14 -4
- package/dist/domain/javascript/javascriptStaticAnalysisFindings.js +66 -7
- package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +28 -16
- package/dist/domain/javascript/javascriptStaticAnalysisState.js +3 -2
- package/dist/domain/jsonSerialization.js +109 -0
- package/dist/domain/jsonValue.js +91 -3
- package/dist/domain/localPath.js +8 -0
- package/dist/domain/managed/managedApplicationGraph.js +10 -10
- package/dist/domain/managed/managedInspectionEvidence.js +16 -0
- package/dist/domain/managed/managedMemberComparisonMatch.js +5 -9
- package/dist/domain/managed/managedNativeVerification.js +3 -9
- package/dist/domain/native/binaryLayout.js +357 -0
- package/dist/domain/native/fileOffsetPartialObservation.js +1 -0
- package/dist/domain/native/nativeCallObservation.js +186 -0
- package/dist/domain/native/nativeCallPartialObservation.js +33 -0
- package/dist/domain/native/objcSwiftMetadata.js +0 -39
- package/dist/domain/native/recordedCrash.js +266 -0
- package/dist/domain/native/recordedCrashNoteCoverage.js +73 -0
- package/dist/domain/{processCapture.js → process/processCapture.js} +143 -2
- package/dist/domain/{processCaptureExample.js → process/processCaptureExample.js} +5 -0
- package/dist/domain/process/processCaptureParsing.js +54 -0
- package/dist/domain/{processCaptureValidation.js → process/processCaptureValidation.js} +18 -2
- package/dist/domain/{processComparison.js → process/processComparison.js} +39 -5
- package/dist/domain/{processObservation.js → process/processObservation.js} +1 -1
- package/dist/domain/{processScenario.js → process/processScenario.js} +11 -10
- package/dist/domain/{processTraceSpecification.js → process/processTraceSpecification.js} +1 -1
- package/dist/domain/propertyListKeys.js +1 -1
- package/dist/domain/propertyListXmlText.js +19 -0
- package/dist/domain/providerAdapterError.js +1 -1
- package/dist/domain/providerOperationHealth.js +54 -0
- package/dist/domain/providerSelectionError.js +4 -2
- package/dist/domain/reconstructionVerification.js +9 -46
- package/dist/domain/reconstructionVerificationSchemas.js +3 -3
- package/dist/domain/residualUnknown.js +3 -2
- package/dist/domain/staticRuntimeCorrelation.js +9 -46
- package/dist/domain/webBundleAnalysis.js +20 -8
- package/dist/domain/webBundleAnalyzerInspection.js +13 -8
- package/dist/domain/webBundleAnalyzerResult.js +41 -2
- package/dist/domain/webCaptureDiff.js +1 -0
- package/dist/domain/webNetworkCapture.js +118 -0
- package/dist/domain/webNetworkCaptureCoordinates.js +58 -0
- package/dist/domain/webRuntime.js +19 -5
- package/dist/domain/webSourceLocation.js +1 -0
- package/dist/dotnet/ManagedExceptionRegionValidation.js +41 -0
- package/dist/dotnet/ManagedMemberInspector.js +4 -2
- package/dist/dotnet/ManagedMemberInspectorCore.js +38 -32
- package/dist/dotnet/ManagedMemberInstructionDecoder.js +23 -7
- package/dist/dotnet/ManagedMemberRows.js +14 -3
- package/dist/dotnet/ManagedMetadataHeaps.js +20 -2
- package/dist/dotnet/ManagedMetadataInventory.js +38 -28
- package/dist/dotnet/ManagedMetadataInventoryRows.js +24 -10
- package/dist/dotnet/ManagedMethodBodyReader.js +7 -1
- package/dist/dotnet/ManagedNativeBoundaryHelpers.js +15 -3
- package/dist/dotnet/ManagedNativeBoundaryInspector.js +3 -1
- package/dist/dotnet/ManagedPeReader.js +11 -0
- package/dist/evm/EvmBytecodeCarrier.js +21 -0
- package/dist/evm/EvmWorkerLimits.js +40 -0
- package/dist/evm/EvmoleFailures.js +126 -0
- package/dist/evm/EvmoleInterfaceAdapter.js +53 -0
- package/dist/evm/EvmoleInterfaceProvider.js +273 -0
- package/dist/evm/EvmoleInterfaceWorker.js +87 -0
- package/dist/evm/EvmoleRelease.js +16 -0
- package/dist/firmware/FirmwareCommand.js +1 -0
- package/dist/firmware/FirmwareFiles.js +1 -1
- package/dist/generatedPackageMetadata.js +2 -2
- package/dist/ghidra/GhidraAnalysisProfile.js +5 -0
- package/dist/ghidra/GhidraClient.js +47 -14
- package/dist/ghidra/GhidraDiagnostics.js +7 -7
- package/dist/ghidra/GhidraFunctionValues.js +10 -7
- package/dist/ghidra/GhidraInstallation.js +18 -21
- package/dist/ghidra/GhidraInventoryValues.js +14 -4
- package/dist/ghidra/GhidraJavaLaunch.js +62 -0
- package/dist/ghidra/GhidraLauncher.js +34 -16
- package/dist/ghidra/GhidraProvider.js +2 -2
- package/dist/ghidra/GhidraProviderCapabilities.js +15 -3
- package/dist/ghidra/GhidraProviderClient.js +23 -12
- package/dist/ghidra/GhidraSessionError.js +11 -7
- package/dist/ghidra/GhidraTargetSnapshot.js +47 -12
- package/dist/ghidra/GhidraTransport.js +20 -0
- package/dist/hopper/BridgeLauncher.js +33 -11
- package/dist/hopper/HopperAnalysisProfile.js +62 -4
- package/dist/hopper/HopperCleanup.js +15 -3
- package/dist/hopper/HopperClient.js +222 -14
- package/dist/hopper/HopperFileOffset.js +237 -0
- package/dist/hopper/HopperMachOImage.js +196 -0
- package/dist/hopper/HopperOperationStage.js +6 -0
- package/dist/hopper/HopperProvider.js +63 -9
- package/dist/hopper/HopperProviderCapabilities.js +19 -1
- package/dist/hopper/HopperRegexSearch.js +137 -0
- package/dist/hopper/HopperRegexWorker.js +27 -0
- package/dist/hopper/HopperRequestQueue.js +68 -19
- package/dist/hopper/HopperTargetLease.js +3 -2
- package/dist/hopper/LinuxPrivateDisplayProbe.js +4 -2
- package/dist/inspector/JavaScriptRuntimeScope.js +9 -1
- package/dist/inspector/V8InspectorCaptureProjection.js +8 -3
- package/dist/inspector/V8InspectorProvider.js +47 -11
- package/dist/javascript/recovery/WakaruCommand.js +3 -0
- package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
- package/dist/javascript/sourceMaps/SourceMapCommand.js +17 -0
- package/dist/javascript/sourceMaps/SourceMapFormat.js +79 -31
- package/dist/javascript/sourceMaps/TraceSourceMap.js +14 -28
- package/dist/mcpDoctor.js +62 -2
- package/dist/native/AppleDispatchCoverage.js +47 -6
- package/dist/native/AppleDispatchDecodeFacts.js +6 -0
- package/dist/native/AppleDispatchMetadata.js +6 -3
- package/dist/native/AppleMachoFixups.js +48 -24
- package/dist/native/AppleMachoSelection.js +32 -16
- package/dist/native/AppleObjcCategories.js +6 -2
- package/dist/native/AppleObjcDispatchFacets.js +5 -2
- package/dist/native/AppleObjcProperties.js +2 -1
- package/dist/native/AppleSwiftDispatchFacets.js +27 -21
- package/dist/native/AppleSwiftVtables.js +21 -15
- package/dist/native/CommandRunner.js +82 -84
- package/dist/native/LldbCallTracer.js +541 -0
- package/dist/native/LldbRetainedObservations.js +178 -0
- package/dist/native/NativeCallObservation.js +194 -0
- package/dist/native/NativeMacOSProvider.js +117 -20
- package/dist/native/NativeMacOSProviderMetadata.js +8 -3
- package/dist/native/SignatureTargetBinding.js +155 -0
- package/dist/native/parsers/lipo.js +71 -1
- package/dist/native/pwndbg/PwndbgCoreContext.js +180 -0
- package/dist/native/pwntools/PwntoolsDecoder.js +203 -0
- package/dist/native/pwntools/PwntoolsFailures.js +180 -0
- package/dist/native/pwntools/PwntoolsLayoutProvider.js +36 -0
- package/dist/native/pwntools/PwntoolsRecordedCrashProvider.js +75 -0
- package/dist/native/pwntools/PwntoolsRelease.js +19 -0
- package/dist/native/pwntools/PwntoolsResourceLimits.js +76 -0
- package/dist/native/pwntools/RecordedCrashSourceBindings.js +46 -0
- package/dist/native/pwntools/RecordedCrashStructureBindings.js +103 -0
- package/dist/process/DarwinProcessRunTokenReader.js +293 -0
- package/dist/process/ExecFileOutput.js +20 -0
- package/dist/process/OwnedCommand.js +118 -0
- package/dist/process/ProcessOwnership.js +431 -51
- package/dist/process/ProcessOwnershipObservation.js +209 -27
- package/dist/process/ProviderProcess.js +68 -10
- package/dist/{application → process/capture}/ProcessCaptureCapability.js +15 -0
- package/dist/{application → process/capture}/ProcessCaptureError.js +18 -2
- package/dist/process/capture/ProcessCaptureLifecycle.js +681 -0
- package/dist/{application → process/capture}/ProcessHarness.js +195 -29
- package/dist/{application → process/capture}/ProcessSampling.js +2 -2
- package/dist/server/EvidenceMcpServer.js +146 -0
- package/dist/server/createServer.js +37 -8
- package/dist/server/promptCompletion.js +10 -3
- package/dist/server/registerAndroidTools.js +2 -4
- package/dist/server/registerApplicationTools/helpers.js +2 -4
- package/dist/server/registerArtifactComparisonTool.js +11 -7
- package/dist/server/registerBinaryDiagnosticsTools.js +15 -0
- package/dist/server/registerBrowserScenarioTool.js +2 -4
- package/dist/server/registerBrowserTools.js +2 -4
- package/dist/server/registerBundleComparisonTool.js +2 -3
- package/dist/server/registerCloseLifecycleTool.js +8 -18
- package/dist/server/registerElectronTools.js +2 -4
- package/dist/server/registerEnhancedTools.js +18 -59
- package/dist/server/registerEvidenceTools.js +3 -5
- package/dist/server/registerEvmTools.js +15 -0
- package/dist/server/registerFirmwareTools.js +2 -4
- package/dist/server/registerFunctionComparisonTool.js +10 -6
- package/dist/server/registerInvestigationTools.js +7 -7
- package/dist/server/registerJavaScriptRecoveryTool.js +2 -4
- package/dist/server/registerJavaScriptRuntimeObservationTools.js +2 -4
- package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +2 -4
- package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +2 -4
- package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +2 -4
- package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +2 -4
- package/dist/server/registerOfficialTools.js +2 -4
- package/dist/server/registerProcessComparisonTool.js +72 -46
- package/dist/server/registerRecordedCrashTools.js +15 -0
- package/dist/server/registerSessionRecordTools.js +5 -6
- package/dist/server/registerSessionStatusTool.js +17 -3
- package/dist/server/registerSessionTools.js +13 -5
- package/dist/server/registerWebModuleTool.js +2 -4
- package/dist/server/registerWebNetworkCaptureTool.js +26 -0
- package/dist/server/registerWebRuntimeTools.js +3 -7
- package/dist/server/registerWebScriptTool.js +2 -4
- package/dist/server/registerWebSourceLocationTool.js +2 -4
- package/dist/server/runDerivedOperation.js +15 -3
- package/dist/server/sessionAvailabilityPolicy.js +3 -1
- package/dist/server/sessionToolPolicies.js +1 -1
- package/dist/server/toolRegistrationOptions.js +2 -2
- package/dist/server/toolResult.js +63 -11
- package/dist/server/toolResultEncoding.js +33 -0
- package/install.sh +1 -1
- package/native/windows/build/manifest.json +2 -2
- package/native/windows/build/rea-windows-x64.node +0 -0
- package/package.json +42 -9
- package/scripts/electron-active-hook-boundaries.cjs +18 -20
- package/scripts/electron-active-hook.cjs +241 -37
- package/scripts/rea.mjs +11 -3
- package/skills/reverse-engineer-anything/SKILL.md +32 -4
- package/skills/reverse-engineer-anything/references/javascript-applications.md +8 -1
- package/skills/reverse-engineer-anything/references/native-and-artifacts.md +29 -0
- package/third_party/README.md +60 -0
- package/third_party/evmole/LICENSE +21 -0
- package/third_party/evmole/README.md +22 -0
- package/third_party/pwndbg/LICENSE.md +21 -0
- package/third_party/pwndbg/README.md +23 -0
- package/third_party/pwntools/README.md +40 -0
- package/dist/application/AuthorizedArtifactInventory.js +0 -7
- package/dist/application/ProcessCaptureLifecycle.js +0 -299
- package/dist/application/StoreFileLock.js +0 -124
- package/dist/contracts/processCaptureExample.js +0 -2
- package/dist/domain/bytecodeProvider.js +0 -178
- package/dist/domain/customProtocolCapture.js +0 -137
- package/dist/domain/eventProcessTree.js +0 -225
- package/dist/domain/mobileApplicationInvestigation.js +0 -159
- package/dist/domain/packageAnalysis.js +0 -123
- package/dist/domain/peInspection.js +0 -197
- package/dist/domain/processCaptureParsing.js +0 -21
- package/dist/domain/protocolCapture.js +0 -217
- package/dist/domain/runtimeIdentification.js +0 -212
- package/dist/generatedMcpToolCatalog.js +0 -37
- package/dist/ghidra/GhidraDefaults.js +0 -2
- /package/dist/application/{ArtifactExtractionDestination.js → artifacts/ArtifactExtractionDestination.js} +0 -0
- /package/dist/{application/ArtifactInventory → artifacts/inventory}/policy.js +0 -0
- /package/dist/{application/ArtifactInventory → artifacts/inventory}/types.js +0 -0
- /package/dist/domain/{processEvidenceProvider.js → process/processEvidenceProvider.js} +0 -0
- /package/dist/domain/{processTraceComparison.js → process/processTraceComparison.js} +0 -0
- /package/dist/domain/{processTraceDimensionProjection.js → process/processTraceDimensionProjection.js} +0 -0
- /package/dist/domain/{processTraceEvaluation.js → process/processTraceEvaluation.js} +0 -0
- /package/dist/{application → process/capture}/FilesystemSnapshot.js +0 -0
- /package/dist/{application → process/capture}/ProcessCaptureEnvironment.js +0 -0
- /package/dist/{application → process/capture}/ProcessCaptureJournal.js +0 -0
- /package/dist/{application → process/capture}/ProcessFilesystemEffects.js +0 -0
- /package/dist/{application → process/capture}/ProcessNormalization.js +0 -0
- /package/dist/{application → process/capture}/ProcessScenarioRuntimeValidation.js +0 -0
- /package/dist/{application → process/capture}/ProcessTimer.js +0 -0
- /package/dist/{application → process/capture}/TerminalRenderer.js +0 -0
|
@@ -3,7 +3,7 @@ import { verifyManagedNativeBoundariesEvidence } from "../../application/managed
|
|
|
3
3
|
import { managedNativeVerificationResultSchema } from "../../domain/managed/managedNativeVerification.js";
|
|
4
4
|
import { logToolExecution } from "../toolLogging.js";
|
|
5
5
|
import { toolRegistrationOptions } from "../toolRegistrationOptions.js";
|
|
6
|
-
import { toCallToolResult } from "../toolResult.js";
|
|
6
|
+
import { toCallToolResult, toEvidenceToolResult } from "../toolResult.js";
|
|
7
7
|
import { managedWorkflowContract } from "./contract.js";
|
|
8
8
|
import { resolveManagedBoundaryEvidence, resolveNativeEvidence, } from "./evidence.js";
|
|
9
9
|
const nativeVerificationContract = managedWorkflowContract("verify_managed_native_boundaries");
|
|
@@ -57,8 +57,6 @@ export const registerVerifyManagedNativeBoundaries = (server, options) => {
|
|
|
57
57
|
relationships: [],
|
|
58
58
|
})
|
|
59
59
|
: options.recordEvidence?.(result.value);
|
|
60
|
-
|
|
61
|
-
return toCallToolResult(output, nativeVerificationContract);
|
|
62
|
-
return toCallToolResult(result, nativeVerificationContract);
|
|
60
|
+
return toEvidenceToolResult(result.value, nativeVerificationContract, output);
|
|
63
61
|
});
|
|
64
62
|
};
|
|
@@ -5,7 +5,7 @@ import { jsonObjectSchema, jsonValueSchema, } from "../domain/jsonValue.js";
|
|
|
5
5
|
import { mcpProgressReporter } from "./mcpProgress.js";
|
|
6
6
|
import { logToolExecution } from "./toolLogging.js";
|
|
7
7
|
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
|
|
8
|
-
import { toCallToolResult } from "./toolResult.js";
|
|
8
|
+
import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
|
|
9
9
|
/** Register direct bridge proxies, preserving MCP cancellation and typed errors. */
|
|
10
10
|
export const registerOfficialTools = (server, analysis, options) => {
|
|
11
11
|
for (const contract of OFFICIAL_TOOL_CONTRACTS) {
|
|
@@ -40,9 +40,7 @@ const registerOfficialTool = (server, analysis, contract, registration) => {
|
|
|
40
40
|
locations: result.value.locations,
|
|
41
41
|
});
|
|
42
42
|
const recorded = registration.recordEvidence?.(evidence);
|
|
43
|
-
|
|
44
|
-
return toCallToolResult(recorded, contract);
|
|
45
|
-
return toCallToolResult({ ok: true, value: evidence }, contract);
|
|
43
|
+
return toEvidenceToolResult(evidence, contract, recorded);
|
|
46
44
|
});
|
|
47
45
|
};
|
|
48
46
|
const runOfficialOperation = async (analysis, contract, arguments_, execution) => {
|
|
@@ -1,61 +1,83 @@
|
|
|
1
1
|
import { toolContract } from "../contracts/toolContracts.js";
|
|
2
|
+
import { AnalysisInputError } from "../domain/analysisErrorCore.js";
|
|
3
|
+
import {} from "../domain/analysisErrorBase.js";
|
|
4
|
+
import { describeValidationFailure } from "../domain/evidenceBundle.js";
|
|
2
5
|
import { EvidenceIntegrityError } from "../domain/evidenceErrors.js";
|
|
3
6
|
import { createEvidence, parseEvidence, } from "../domain/evidence.js";
|
|
4
7
|
import { jsonValueSchema } from "../domain/jsonValue.js";
|
|
5
|
-
import { compareProcessCaptures, parseProcessCapture, } from "../domain/processCapture.js";
|
|
6
|
-
import { err } from "../domain/result.js";
|
|
8
|
+
import { compareProcessCaptures, parseProcessCapture, } from "../domain/process/processCapture.js";
|
|
9
|
+
import { err, ok } from "../domain/result.js";
|
|
7
10
|
import { recordDerivedEvidence } from "./recordDerivedEvidence.js";
|
|
8
11
|
import { recordSessionEvidenceSources } from "./sessionEvidence.js";
|
|
9
12
|
import { runDerivedOperation } from "./runDerivedOperation.js";
|
|
10
13
|
import { PROCESS_PROVIDER } from "./sessionToolPolicies.js";
|
|
11
14
|
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
|
|
12
|
-
import { toCallToolResult } from "./toolResult.js";
|
|
15
|
+
import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
|
|
13
16
|
const PROCESS_CAPTURE_EVIDENCE = {
|
|
14
17
|
operation: "capture_process_scenario",
|
|
15
18
|
predicate: "rea.process-capture",
|
|
16
19
|
};
|
|
17
20
|
const sourceLocations = (left, right) => [...(left ?? []), ...(right ?? [])];
|
|
21
|
+
/**
|
|
22
|
+
* Parse one side and name the failed constraint: tampered Evidence, Evidence
|
|
23
|
+
* from another workflow, or an invalid capture result.
|
|
24
|
+
*/
|
|
25
|
+
const parseCaptureSide = (operation, side, value) => {
|
|
26
|
+
let record;
|
|
27
|
+
try {
|
|
28
|
+
record = parseEvidence(value);
|
|
29
|
+
}
|
|
30
|
+
catch (cause) {
|
|
31
|
+
return err(new EvidenceIntegrityError(`${side} Evidence failed validation`, {
|
|
32
|
+
cause,
|
|
33
|
+
userMessage: `The ${side} Evidence failed validation (${describeValidationFailure(cause)}). Supply unmodified capture Evidence from capture_process_scenario.`,
|
|
34
|
+
}));
|
|
35
|
+
}
|
|
36
|
+
if (record.operation !== PROCESS_CAPTURE_EVIDENCE.operation ||
|
|
37
|
+
record.predicate_type !== PROCESS_CAPTURE_EVIDENCE.predicate)
|
|
38
|
+
return err(new AnalysisInputError(operation, undefined, [
|
|
39
|
+
{
|
|
40
|
+
path: [side],
|
|
41
|
+
reason: "invalid_value",
|
|
42
|
+
message: `Expected process capture Evidence (operation ${PROCESS_CAPTURE_EVIDENCE.operation}, predicate ${PROCESS_CAPTURE_EVIDENCE.predicate}); the ${side} Evidence has operation ${record.operation} and predicate ${record.predicate_type}.`,
|
|
43
|
+
},
|
|
44
|
+
]));
|
|
45
|
+
try {
|
|
46
|
+
return ok({
|
|
47
|
+
record,
|
|
48
|
+
capture: parseProcessCapture(record.normalized_result),
|
|
49
|
+
});
|
|
50
|
+
}
|
|
51
|
+
catch (cause) {
|
|
52
|
+
return err(new EvidenceIntegrityError(`${side} process capture failed validation`, {
|
|
53
|
+
cause,
|
|
54
|
+
userMessage: `The ${side} Evidence has an invalid process capture result (${describeValidationFailure(cause)}). Recreate the capture with capture_process_scenario.`,
|
|
55
|
+
}));
|
|
56
|
+
}
|
|
57
|
+
};
|
|
18
58
|
/** Register deterministic process-capture comparison and contradiction tracking. */
|
|
19
59
|
export const registerProcessComparisonTool = (server, session, contract, now = Date.now) => {
|
|
20
60
|
server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
const computed = await runDerivedOperation(context, contract.name, () => compareProcessCaptures(leftCapture, rightCapture, {
|
|
42
|
-
...(input.max_capture_age_ms === undefined
|
|
43
|
-
? {}
|
|
44
|
-
: { maxCaptureAgeMs: input.max_capture_age_ms }),
|
|
45
|
-
...(input.trace_spec === undefined
|
|
46
|
-
? {}
|
|
47
|
-
: { traceSpecification: input.trace_spec }),
|
|
48
|
-
now,
|
|
49
|
-
}));
|
|
50
|
-
if (!computed.ok)
|
|
51
|
-
return toCallToolResult(computed, contract);
|
|
52
|
-
comparison = computed.value;
|
|
53
|
-
}
|
|
54
|
-
catch (cause) {
|
|
55
|
-
return toCallToolResult(err(new EvidenceIntegrityError(cause instanceof Error
|
|
56
|
-
? cause.message
|
|
57
|
-
: "Invalid process capture")), contract);
|
|
58
|
-
}
|
|
61
|
+
const left = parseCaptureSide(contract.name, "left", input.left);
|
|
62
|
+
if (!left.ok)
|
|
63
|
+
return toCallToolResult(left, contract);
|
|
64
|
+
const right = parseCaptureSide(contract.name, "right", input.right);
|
|
65
|
+
if (!right.ok)
|
|
66
|
+
return toCallToolResult(right, contract);
|
|
67
|
+
const { record: leftRecord, capture: leftCapture } = left.value;
|
|
68
|
+
const { record: rightRecord, capture: rightCapture } = right.value;
|
|
69
|
+
const computed = await runDerivedOperation(context, contract.name, () => compareProcessCaptures(leftCapture, rightCapture, {
|
|
70
|
+
...(input.max_capture_age_ms === undefined
|
|
71
|
+
? {}
|
|
72
|
+
: { maxCaptureAgeMs: input.max_capture_age_ms }),
|
|
73
|
+
...(input.trace_spec === undefined
|
|
74
|
+
? {}
|
|
75
|
+
: { traceSpecification: input.trace_spec }),
|
|
76
|
+
now,
|
|
77
|
+
}));
|
|
78
|
+
if (!computed.ok)
|
|
79
|
+
return toCallToolResult(computed, contract);
|
|
80
|
+
const comparison = computed.value;
|
|
59
81
|
const evidence = createEvidence(undefined, PROCESS_PROVIDER, {
|
|
60
82
|
predicateType: "rea.process-comparison",
|
|
61
83
|
operation: contract.name,
|
|
@@ -78,11 +100,11 @@ export const registerProcessComparisonTool = (server, session, contract, now = D
|
|
|
78
100
|
const recordedSources = recordSessionEvidenceSources((evidence) => session.recordEvidence(evidence), [leftRecord, rightRecord]);
|
|
79
101
|
if (!recordedSources.ok)
|
|
80
102
|
return toCallToolResult(recordedSources, contract);
|
|
81
|
-
return
|
|
103
|
+
return toEvidenceToolResult(evidence, contract, recordDerivedEvidence(session, evidence, comparisonUnknownInput({
|
|
82
104
|
left_evidence_id: leftRecord.evidence_id,
|
|
83
105
|
right_evidence_id: rightRecord.evidence_id,
|
|
84
106
|
comparison_evidence_id: evidence.evidence_id,
|
|
85
|
-
}, comparison))
|
|
107
|
+
}, comparison)));
|
|
86
108
|
});
|
|
87
109
|
};
|
|
88
110
|
const comparisonUnknownInput = (parsed, comparison) => {
|
|
@@ -98,14 +120,18 @@ const comparisonUnknownInput = (parsed, comparison) => {
|
|
|
98
120
|
.filter(([, status]) => status !== "unchanged")
|
|
99
121
|
.map(([scope]) => scope)
|
|
100
122
|
.join(", ");
|
|
123
|
+
const contradictory = comparison.status === "changed" &&
|
|
124
|
+
parsed.left_evidence_id !== parsed.right_evidence_id;
|
|
101
125
|
// Unknown identity uses the question, not its supporting records. Bind the
|
|
102
126
|
// question to this comparison so distinct capture pairs and policies coexist.
|
|
103
127
|
return {
|
|
104
|
-
question:
|
|
128
|
+
question: `${contradictory ? "Process captures disagree" : `Process comparison is ${comparison.status}`} across: ${differingScopes} (comparison ${parsed.comparison_evidence_id})`,
|
|
105
129
|
severity: "high",
|
|
106
130
|
domain: "process-comparison",
|
|
107
|
-
supporting_evidence_ids:
|
|
108
|
-
|
|
131
|
+
supporting_evidence_ids: contradictory
|
|
132
|
+
? [parsed.left_evidence_id]
|
|
133
|
+
: [...new Set([parsed.left_evidence_id, parsed.right_evidence_id])],
|
|
134
|
+
contradicting_evidence_ids: contradictory ? [parsed.right_evidence_id] : [],
|
|
109
135
|
required_authority: "controlled-replay",
|
|
110
136
|
required_confidence: "observed",
|
|
111
137
|
required_environment: null,
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { toolContract } from "../contracts/toolContracts.js";
|
|
2
|
+
import { logToolExecution } from "./toolLogging.js";
|
|
3
|
+
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
|
|
4
|
+
import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
|
|
5
|
+
/** Bind recorded crash inspection to its named contract and session Evidence owner. */
|
|
6
|
+
export const registerRecordedCrashTools = (server, service, logger, recordEvidence) => {
|
|
7
|
+
const contract = toolContract("inspect_recorded_crash");
|
|
8
|
+
server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
|
|
9
|
+
const result = await logToolExecution(logger, contract.name, () => service.inspect(input, { signal: context.mcpReq.signal }));
|
|
10
|
+
if (!result.ok)
|
|
11
|
+
return toCallToolResult(result, contract);
|
|
12
|
+
const recorded = recordEvidence?.(result.value);
|
|
13
|
+
return toEvidenceToolResult(result.value, contract, recorded);
|
|
14
|
+
});
|
|
15
|
+
};
|
|
@@ -11,7 +11,7 @@ export const registerEvidenceTools = (registration) => {
|
|
|
11
11
|
};
|
|
12
12
|
const registerExportEvidenceTool = ({ server, session, exportContract, }) => {
|
|
13
13
|
server.registerTool(exportContract.name, toolRegistrationOptions(exportContract), async (input) => {
|
|
14
|
-
const bundle = session
|
|
14
|
+
const bundle = bundleForSerialization(session);
|
|
15
15
|
const written = await writeEvidenceBundle(bundle, input.path, input.overwrite);
|
|
16
16
|
return written.ok
|
|
17
17
|
? toCallToolResult(ok({
|
|
@@ -24,7 +24,7 @@ const registerExportEvidenceTool = ({ server, session, exportContract, }) => {
|
|
|
24
24
|
});
|
|
25
25
|
};
|
|
26
26
|
const registerSnapshotEvidenceTool = ({ server, session, snapshotContract, }) => {
|
|
27
|
-
server.registerTool(snapshotContract.name, toolRegistrationOptions(snapshotContract), () => toCallToolResult(ok(session
|
|
27
|
+
server.registerTool(snapshotContract.name, toolRegistrationOptions(snapshotContract), () => toCallToolResult(ok(bundleForSerialization(session)), snapshotContract));
|
|
28
28
|
};
|
|
29
29
|
const registerImportEvidenceTool = ({ server, session, importContract, }) => {
|
|
30
30
|
server.registerTool(importContract.name, toolRegistrationOptions(importContract), async (input) => {
|
|
@@ -32,19 +32,18 @@ const registerImportEvidenceTool = ({ server, session, importContract, }) => {
|
|
|
32
32
|
const loaded = await readEvidenceBundle(path);
|
|
33
33
|
if (!loaded.ok)
|
|
34
34
|
return toCallToolResult(loaded, importContract);
|
|
35
|
-
const retainedUnknownRevisions = new Set(session
|
|
36
|
-
.exportEvidenceBundle()
|
|
37
|
-
.unknowns.map((unknown) => unknownRevisionKey(unknown)));
|
|
35
|
+
const retainedUnknownRevisions = new Set(bundleForSerialization(session).unknowns.map((unknown) => unknownRevisionKey(unknown)));
|
|
38
36
|
const imported = session.importEvidenceBundle(loaded.value);
|
|
39
37
|
return imported.ok
|
|
40
38
|
? toCallToolResult(ok({
|
|
41
39
|
imported: imported.value,
|
|
42
40
|
unknowns_added: loaded.value.unknowns.filter((unknown) => !retainedUnknownRevisions.has(unknownRevisionKey(unknown))).length,
|
|
43
|
-
total: session
|
|
41
|
+
total: bundleForSerialization(session).records.length,
|
|
44
42
|
}), importContract)
|
|
45
43
|
: toCallToolResult(imported, importContract);
|
|
46
44
|
});
|
|
47
45
|
};
|
|
46
|
+
const bundleForSerialization = (session) => session.evidenceBundleForSerialization?.() ?? session.exportEvidenceBundle();
|
|
48
47
|
const unknownRevisionKey = (unknown) => `${unknown.unknown_id}:${String(unknown.revision)}`;
|
|
49
48
|
/** Register residual-unknown query and mutation tools. */
|
|
50
49
|
const registerListUnknownsTool = ({ server, session, }) => {
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { AnalysisCancelledError } from "../domain/analysisErrorCore.js";
|
|
1
2
|
import { buildCapabilityInventory } from "../application/CapabilityInventory.js";
|
|
2
3
|
import { toolContract } from "../contracts/toolContracts.js";
|
|
3
4
|
import { jsonObjectSchema } from "../domain/jsonValue.js";
|
|
@@ -5,14 +6,27 @@ import { createServerIdentity } from "../serverIdentity.js";
|
|
|
5
6
|
import { mcpClientMetadata } from "./mcpClientMetadata.js";
|
|
6
7
|
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
|
|
7
8
|
import { toCallToolResult } from "./toolResult.js";
|
|
9
|
+
import { err } from "../domain/result.js";
|
|
8
10
|
/** Register the read-only provider and target status operation. */
|
|
9
11
|
export const registerSessionStatusTool = (options) => {
|
|
10
|
-
const { server, session, contract, startedAt, availabilityPolicy } = options;
|
|
11
|
-
server.registerTool(contract.name, toolRegistrationOptions(contract), (input, context) => {
|
|
12
|
+
const { server, session, contract, startedAt, availabilityPolicy, androidAnalysisAvailability, } = options;
|
|
13
|
+
server.registerTool(contract.name, toolRegistrationOptions(contract), async (input, context) => {
|
|
12
14
|
const { client, clientFeatures, protocolVersion } = mcpClientMetadata(context);
|
|
15
|
+
let androidAvailability;
|
|
16
|
+
try {
|
|
17
|
+
androidAvailability = await androidAnalysisAvailability(context.mcpReq.signal);
|
|
18
|
+
}
|
|
19
|
+
catch (cause) {
|
|
20
|
+
if (!context.mcpReq.signal.aborted)
|
|
21
|
+
throw cause;
|
|
22
|
+
return toCallToolResult(err(new AnalysisCancelledError("binary_session")), contract);
|
|
23
|
+
}
|
|
13
24
|
const status = session.status();
|
|
14
25
|
const statusObject = jsonObjectSchema.parse(status);
|
|
15
|
-
const toolAvailability = buildCapabilityInventory(status,
|
|
26
|
+
const toolAvailability = buildCapabilityInventory(status, {
|
|
27
|
+
...availabilityPolicy(),
|
|
28
|
+
androidAnalysisAvailability: androidAvailability,
|
|
29
|
+
}, clientFeatures);
|
|
16
30
|
const serverIdentity = createServerIdentity({
|
|
17
31
|
startedAt,
|
|
18
32
|
expected: {
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { getNavigationContext, inspectAddressContext, } from "../application/AnalysisContextQueries.js";
|
|
3
3
|
import { readAnalysisSnapshot } from "../application/binary/AnalysisSnapshotFiles.js";
|
|
4
|
-
import { createProcessCaptureEvidence } from "../application/ProcessEvidence.js";
|
|
5
|
-
import { captureProcessScenario } from "../
|
|
4
|
+
import { createProcessCaptureEvidence } from "../application/process/ProcessEvidence.js";
|
|
5
|
+
import { captureProcessScenario } from "../process/capture/ProcessHarness.js";
|
|
6
6
|
import { toolContract } from "../contracts/toolContracts.js";
|
|
7
7
|
import { UnknownRegistryError } from "../domain/unknownRegistryError.js";
|
|
8
8
|
import {} from "../domain/analysisErrorBase.js";
|
|
@@ -19,7 +19,7 @@ import { registerSessionStatusTool } from "./registerSessionStatusTool.js";
|
|
|
19
19
|
import { sessionAvailabilityPolicy, } from "./sessionAvailabilityPolicy.js";
|
|
20
20
|
import { logToolExecution } from "./toolLogging.js";
|
|
21
21
|
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
|
|
22
|
-
import { toCallToolResult } from "./toolResult.js";
|
|
22
|
+
import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
|
|
23
23
|
const recordProcessResidualUnknowns = (session, evidence, residuals) => {
|
|
24
24
|
for (const residual of residuals) {
|
|
25
25
|
const unknown = session.recordUnknown({
|
|
@@ -73,11 +73,11 @@ const registerProcessTools = ({ server, session, logger, captureContract, }) =>
|
|
|
73
73
|
const unknowns = recordProcessResidualUnknowns(session, evidence, captured.value.residual_unknowns);
|
|
74
74
|
if (!unknowns.ok)
|
|
75
75
|
return toCallToolResult(unknowns, captureContract);
|
|
76
|
-
return
|
|
76
|
+
return toEvidenceToolResult(evidence, captureContract, recorded);
|
|
77
77
|
});
|
|
78
78
|
};
|
|
79
79
|
const registerLifecycleTools = (registration) => {
|
|
80
|
-
const { server, session, statusContract, startedAt, availabilityPolicy } = registration;
|
|
80
|
+
const { server, session, statusContract, startedAt, availabilityPolicy, androidAnalysisAvailability, } = registration;
|
|
81
81
|
registerOpenLifecycleTool(registration);
|
|
82
82
|
registerCloseLifecycleTool(registration);
|
|
83
83
|
registerSessionStatusTool({
|
|
@@ -86,6 +86,7 @@ const registerLifecycleTools = (registration) => {
|
|
|
86
86
|
contract: statusContract,
|
|
87
87
|
startedAt,
|
|
88
88
|
availabilityPolicy,
|
|
89
|
+
androidAnalysisAvailability,
|
|
89
90
|
});
|
|
90
91
|
};
|
|
91
92
|
const registerOpenLifecycleTool = ({ server, session, logger, openContract, }) => {
|
|
@@ -153,6 +154,7 @@ export const registerSessionTools = (server, session, logger, options = {}) => {
|
|
|
153
154
|
statusContract,
|
|
154
155
|
startedAt: options.startedAt ?? new Date().toISOString(),
|
|
155
156
|
availabilityPolicy: sessionAvailabilityPolicy(options.availabilityPolicy, {}),
|
|
157
|
+
androidAnalysisAvailability: options.androidAnalysisAvailability ?? missingAndroidAvailability,
|
|
156
158
|
});
|
|
157
159
|
registerEvidenceTools({
|
|
158
160
|
server,
|
|
@@ -175,3 +177,9 @@ export const registerSessionTools = (server, session, logger, options = {}) => {
|
|
|
175
177
|
registerUnknownTools({ server, session });
|
|
176
178
|
registerContextTools(server, session);
|
|
177
179
|
};
|
|
180
|
+
const missingAndroidAvailability = async () => ({
|
|
181
|
+
status: "unavailable",
|
|
182
|
+
code: "not_configured",
|
|
183
|
+
reason: "Set REA_JADX_MCP_JAR to a caller-supplied jadx-headless-mcp 0.7.1 JAR and provide a full JDK on Linux or macOS.",
|
|
184
|
+
diagnostics: { configured: false },
|
|
185
|
+
});
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { toolContract } from "../contracts/toolContracts.js";
|
|
2
2
|
import { logToolExecution } from "./toolLogging.js";
|
|
3
3
|
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
|
|
4
|
-
import { toCallToolResult } from "./toolResult.js";
|
|
4
|
+
import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
|
|
5
5
|
/** Bind the module relationship workflow to its exact canonical contract. */
|
|
6
6
|
export const registerWebModuleTool = (server, service, logger, recordEvidence) => {
|
|
7
7
|
const contract = toolContract("trace_web_module_imports");
|
|
@@ -10,8 +10,6 @@ export const registerWebModuleTool = (server, service, logger, recordEvidence) =
|
|
|
10
10
|
if (!result.ok)
|
|
11
11
|
return toCallToolResult(result, contract);
|
|
12
12
|
const recorded = recordEvidence?.(result.value);
|
|
13
|
-
return
|
|
14
|
-
? toCallToolResult(recorded, contract)
|
|
15
|
-
: toCallToolResult(result, contract);
|
|
13
|
+
return toEvidenceToolResult(result.value, contract, recorded);
|
|
16
14
|
});
|
|
17
15
|
};
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { toolContract } from "../contracts/toolContracts.js";
|
|
2
|
+
import { logToolExecution } from "./toolLogging.js";
|
|
3
|
+
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
|
|
4
|
+
import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
|
|
5
|
+
/** Bind historical inspection to its named contract and caller-owned Evidence writer. */
|
|
6
|
+
export const registerWebNetworkCaptureTool = (server, service, logger, recordEvidence) => {
|
|
7
|
+
const contract = toolContract("inspect_web_network_capture");
|
|
8
|
+
const registration = toolRegistrationOptions(contract);
|
|
9
|
+
// Keep the exact advertised contract; the shared service validates raw input
|
|
10
|
+
// before effects so caller-declared sensitivity also covers invalid arguments.
|
|
11
|
+
// SDK pre-validation otherwise emits unprojected issue paths as plain text.
|
|
12
|
+
const inputSchema = {
|
|
13
|
+
"~standard": {
|
|
14
|
+
...registration.inputSchema["~standard"],
|
|
15
|
+
vendor: "rea-application",
|
|
16
|
+
validate: (value) => ({ value }),
|
|
17
|
+
},
|
|
18
|
+
};
|
|
19
|
+
server.registerTool(contract.name, { ...registration, inputSchema }, async (input, context) => {
|
|
20
|
+
const result = await logToolExecution(logger, contract.name, () => service.inspect(input, { signal: context.mcpReq.signal }));
|
|
21
|
+
if (!result.ok)
|
|
22
|
+
return toCallToolResult(result, contract);
|
|
23
|
+
const recorded = recordEvidence?.(result.value);
|
|
24
|
+
return toEvidenceToolResult(result.value, contract, recorded);
|
|
25
|
+
});
|
|
26
|
+
};
|
|
@@ -2,7 +2,7 @@ import { toolContract } from "../contracts/toolContracts.js";
|
|
|
2
2
|
import { mcpProgressReporter } from "./mcpProgress.js";
|
|
3
3
|
import { logToolExecution } from "./toolLogging.js";
|
|
4
4
|
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
|
|
5
|
-
import { toCallToolResult } from "./toolResult.js";
|
|
5
|
+
import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
|
|
6
6
|
/** Bind distinct runtime operations to named contracts and the session's Evidence owner. */
|
|
7
7
|
export const registerWebRuntimeTools = (server, service, logger, recordEvidence) => {
|
|
8
8
|
const execution = toolContract("observe_web_execution");
|
|
@@ -15,17 +15,13 @@ export const registerWebRuntimeTools = (server, service, logger, recordEvidence)
|
|
|
15
15
|
if (!result.ok)
|
|
16
16
|
return toCallToolResult(result, execution);
|
|
17
17
|
const recorded = recordEvidence?.(result.value);
|
|
18
|
-
return
|
|
19
|
-
? toCallToolResult(recorded, execution)
|
|
20
|
-
: toCallToolResult(result, execution);
|
|
18
|
+
return toEvidenceToolResult(result.value, execution, recorded);
|
|
21
19
|
});
|
|
22
20
|
server.registerTool(listeners.name, toolRegistrationOptions(listeners), async (input, context) => {
|
|
23
21
|
const result = await logToolExecution(logger, listeners.name, () => service.inspect(input, { signal: context.mcpReq.signal }));
|
|
24
22
|
if (!result.ok)
|
|
25
23
|
return toCallToolResult(result, listeners);
|
|
26
24
|
const recorded = recordEvidence?.(result.value);
|
|
27
|
-
return
|
|
28
|
-
? toCallToolResult(recorded, listeners)
|
|
29
|
-
: toCallToolResult(result, listeners);
|
|
25
|
+
return toEvidenceToolResult(result.value, listeners, recorded);
|
|
30
26
|
});
|
|
31
27
|
};
|
|
@@ -2,7 +2,7 @@ import { exportWebScriptsValidated } from "../application/WebScriptExportService
|
|
|
2
2
|
import { toolContract } from "../contracts/toolContracts.js";
|
|
3
3
|
import { logToolExecution } from "./toolLogging.js";
|
|
4
4
|
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
|
|
5
|
-
import { toCallToolResult } from "./toolResult.js";
|
|
5
|
+
import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
|
|
6
6
|
/** Register local script export without requiring a live browser provider. */
|
|
7
7
|
export const registerWebScriptTool = (server, options) => {
|
|
8
8
|
const contract = toolContract("export_web_scripts");
|
|
@@ -11,8 +11,6 @@ export const registerWebScriptTool = (server, options) => {
|
|
|
11
11
|
if (!result.ok)
|
|
12
12
|
return toCallToolResult(result, contract);
|
|
13
13
|
const recorded = options.recordEvidence?.(result.value);
|
|
14
|
-
return
|
|
15
|
-
? toCallToolResult(recorded, contract)
|
|
16
|
-
: toCallToolResult(result, contract);
|
|
14
|
+
return toEvidenceToolResult(result.value, contract, recorded);
|
|
17
15
|
});
|
|
18
16
|
};
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { toolContract } from "../contracts/toolContracts.js";
|
|
2
2
|
import { logToolExecution } from "./toolLogging.js";
|
|
3
3
|
import { toolRegistrationOptions } from "./toolRegistrationOptions.js";
|
|
4
|
-
import { toCallToolResult } from "./toolResult.js";
|
|
4
|
+
import { toCallToolResult, toEvidenceToolResult } from "./toolResult.js";
|
|
5
5
|
/** Bind source point tracing to its exact named contract and session Evidence owner. */
|
|
6
6
|
export const registerWebSourceLocationTool = (server, service, logger, recordEvidence) => {
|
|
7
7
|
const contract = toolContract("trace_web_source_location");
|
|
@@ -10,8 +10,6 @@ export const registerWebSourceLocationTool = (server, service, logger, recordEvi
|
|
|
10
10
|
if (!result.ok)
|
|
11
11
|
return toCallToolResult(result, contract);
|
|
12
12
|
const recorded = recordEvidence?.(result.value);
|
|
13
|
-
return
|
|
14
|
-
? toCallToolResult(recorded, contract)
|
|
15
|
-
: toCallToolResult(result, contract);
|
|
13
|
+
return toEvidenceToolResult(result.value, contract, recorded);
|
|
16
14
|
});
|
|
17
15
|
};
|
|
@@ -1,5 +1,8 @@
|
|
|
1
1
|
import { setImmediate } from "node:timers/promises";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { AnalysisError } from "../domain/analysisErrorBase.js";
|
|
2
4
|
import { AnalysisCancelledError, AnalysisInputError, } from "../domain/analysisErrorCore.js";
|
|
5
|
+
import { describeValidationFailure } from "../domain/evidenceBundle.js";
|
|
3
6
|
import { err, ok } from "../domain/result.js";
|
|
4
7
|
import { mcpProgressReporter } from "./mcpProgress.js";
|
|
5
8
|
/** Run synchronous derived work with transport yields and a publication guard. */
|
|
@@ -19,9 +22,18 @@ export const runDerivedOperation = async (context, operation, compute) => {
|
|
|
19
22
|
value = compute();
|
|
20
23
|
}
|
|
21
24
|
catch (cause) {
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
+
// Typed causes already name the failed constraint; keep their issues.
|
|
26
|
+
if (cause instanceof AnalysisError)
|
|
27
|
+
return err(cause);
|
|
28
|
+
return err(new AnalysisInputError(operation, { cause }, cause instanceof TypeError || cause instanceof z.ZodError
|
|
29
|
+
? [
|
|
30
|
+
{
|
|
31
|
+
path: [],
|
|
32
|
+
reason: "invalid_value",
|
|
33
|
+
message: describeValidationFailure(cause),
|
|
34
|
+
},
|
|
35
|
+
]
|
|
36
|
+
: []));
|
|
25
37
|
}
|
|
26
38
|
await progress.report({
|
|
27
39
|
phase: "compute",
|
|
@@ -3,10 +3,12 @@ import { platform } from "node:process";
|
|
|
3
3
|
export const sessionAvailabilityPolicy = (configured, defaults) => {
|
|
4
4
|
const policy = configured ??
|
|
5
5
|
(() => ({
|
|
6
|
+
evmInterfaceEnabled: defaults.optionalFeatures?.evmInterfaceEnabled ?? false,
|
|
6
7
|
processCaptureEnabled: platform !== "win32",
|
|
8
|
+
recordedCrashEnabled: defaults.optionalFeatures?.recordedCrashEnabled ?? false,
|
|
9
|
+
binaryLayoutEnabled: defaults.optionalFeatures?.binaryLayoutEnabled ?? false,
|
|
7
10
|
firmwareInspectionEnabled: defaults.optionalFeatures?.firmwareInspectionEnabled ?? false,
|
|
8
11
|
firmwareExtractionEnabled: defaults.optionalFeatures?.firmwareExtractionEnabled ?? false,
|
|
9
|
-
androidAnalysisEnabled: defaults.optionalFeatures?.androidAnalysisEnabled ?? false,
|
|
10
12
|
javascriptRecoveryEnabled: defaults.optionalFeatures?.javascriptRecoveryEnabled ?? false,
|
|
11
13
|
webModuleResolutionEnabled: defaults.optionalFeatures?.webModuleResolutionEnabled ?? false,
|
|
12
14
|
browserObservationEnabled: defaults.optionalFeatures?.browserObservationEnabled ?? false,
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { PROCESS_PROVIDER } from "../application/ProcessEvidence.js";
|
|
1
|
+
export { PROCESS_PROVIDER } from "../application/process/ProcessEvidence.js";
|
|
2
2
|
export { ARTIFACT_COMPARISON_PROVIDER, BUNDLE_COMPARISON_PROVIDER, CALL_PATH_PROVIDER, CHANGED_BEHAVIOR_PROVIDER, FUNCTION_COMPARISON_PROVIDER, RECONSTRUCTION_PROVIDER, STATIC_RUNTIME_PROVIDER, } from "../application/InvestigationProviders.js";
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import { toolInputSchemaWithMetadata } from "../contracts/toolSchemaMetadata.js";
|
|
1
|
+
import { toolInputSchemaWithMetadata, toolOutputSchemaWithMetadata, } from "../contracts/toolSchemaMetadata.js";
|
|
2
2
|
/** Project the canonical Zod contracts directly into SDK registration. */
|
|
3
3
|
export const toolRegistrationOptions = (contract) => ({
|
|
4
4
|
title: contract.title,
|
|
5
5
|
description: contract.description,
|
|
6
6
|
inputSchema: toolInputSchemaWithMetadata(contract),
|
|
7
|
-
outputSchema: contract
|
|
7
|
+
outputSchema: toolOutputSchemaWithMetadata(contract),
|
|
8
8
|
annotations: contract.annotations,
|
|
9
9
|
});
|
|
@@ -1,38 +1,90 @@
|
|
|
1
|
+
import { STDIO_DEFAULT_MAX_BUFFER_SIZE } from "@modelcontextprotocol/server";
|
|
1
2
|
import { projectAnalysisError } from "../domain/analysisErrorProjection.js";
|
|
2
3
|
import {} from "../domain/analysisErrorBase.js";
|
|
4
|
+
import { AnalysisResourceConstraintError } from "../domain/analysisErrorCore.js";
|
|
5
|
+
import { parseMcpResponseBudget } from "../config/mcpResponseBudget.js";
|
|
6
|
+
import { encodeToolResult, MCP_RESULT_BUDGET_BYTES, MCP_RESULT_STRING_LIMIT, } from "./toolResultEncoding.js";
|
|
3
7
|
/**
|
|
4
8
|
* Serialize an application result as MCP text and structured content.
|
|
5
9
|
* Shared error projection preserves actionable local diagnostics while omitting
|
|
6
|
-
* raw
|
|
10
|
+
* raw cause objects; explicitly retained bounded command output stays visible.
|
|
7
11
|
*/
|
|
8
|
-
export const toCallToolResult = (result, contract) => result.ok
|
|
9
|
-
|
|
12
|
+
export const toCallToolResult = (result, contract, context) => result.ok
|
|
13
|
+
? successResult(result.value, contract, context)
|
|
14
|
+
: toErrorToolResult(result.error);
|
|
15
|
+
/** Deliver Evidence using the producer's explicit recording acknowledgment. */
|
|
16
|
+
export const toEvidenceToolResult = (evidence, contract, recorded) => recorded !== undefined && !recorded.ok
|
|
17
|
+
? toErrorToolResult(recorded.error)
|
|
18
|
+
: toCallToolResult({ ok: true, value: evidence }, contract, recorded === undefined
|
|
19
|
+
? undefined
|
|
20
|
+
: { retainedEvidenceId: evidence.evidence_id });
|
|
21
|
+
/** Project an error without allocating oversized repeated MCP text. */
|
|
22
|
+
export const toErrorToolResult = (error) => {
|
|
10
23
|
const projected = projectAnalysisError(error);
|
|
11
24
|
const structuredContent = { error: projected };
|
|
25
|
+
const configured = parseMcpResponseBudget(process.env.REA_MCP_MAX_RESPONSE_BYTES);
|
|
26
|
+
const budget = configured.ok && configured.value !== undefined
|
|
27
|
+
? configured.value - 1024
|
|
28
|
+
: MCP_RESULT_BUDGET_BYTES;
|
|
29
|
+
const encoded = encodeToolResult(structuredContent, budget);
|
|
30
|
+
// The session-bound transport retains an oversized projected error before
|
|
31
|
+
// replacing it with a recoverable delivery constraint. Avoid allocating its
|
|
32
|
+
// repeated text representation before that boundary has acknowledged it.
|
|
12
33
|
return {
|
|
13
|
-
content: [
|
|
14
|
-
{
|
|
15
|
-
type: "text",
|
|
16
|
-
text: JSON.stringify(structuredContent),
|
|
17
|
-
},
|
|
18
|
-
],
|
|
34
|
+
content: encoded.ok ? [{ type: "text", text: encoded.text }] : [],
|
|
19
35
|
structuredContent,
|
|
20
36
|
isError: true,
|
|
21
37
|
};
|
|
22
38
|
};
|
|
23
|
-
const successResult = (value, contract) => {
|
|
39
|
+
const successResult = (value, contract, context) => {
|
|
24
40
|
const candidate = projectEvidence(value) ??
|
|
25
41
|
(contract.kind === "session" ? { result: value } : value);
|
|
42
|
+
const configured = parseMcpResponseBudget(process.env.REA_MCP_MAX_RESPONSE_BYTES);
|
|
43
|
+
if (!configured.ok)
|
|
44
|
+
return toErrorToolResult(configured.error);
|
|
45
|
+
const budget = configured.value === undefined
|
|
46
|
+
? MCP_RESULT_BUDGET_BYTES
|
|
47
|
+
: configured.value - 1024;
|
|
48
|
+
const encoded = encodeToolResult(candidate, budget);
|
|
49
|
+
if (!encoded.ok)
|
|
50
|
+
return toErrorToolResult(new AnalysisResourceConstraintError(contract.name, "transport", encoded.constraint === "string-length"
|
|
51
|
+
? "The operation completed, but its complete MCP response exceeds Node's single-string representation limit. Export retained evidence to consume the complete analysis, or use complete CLI JSON output."
|
|
52
|
+
: "The operation completed, but its complete MCP response exceeds the stdio response budget. The analysis result was not truncated; export retained evidence to consume it, or use complete CLI JSON output.", {
|
|
53
|
+
boundary: "mcp-response",
|
|
54
|
+
default_receive_buffer_bytes: STDIO_DEFAULT_MAX_BUFFER_SIZE,
|
|
55
|
+
result_budget_bytes: budget,
|
|
56
|
+
max_string_code_units: MCP_RESULT_STRING_LIMIT,
|
|
57
|
+
response_bytes_at_least: encoded.bytesAtLeast,
|
|
58
|
+
response_code_units_at_least: encoded.codeUnitsAtLeast,
|
|
59
|
+
constraint: encoded.constraint,
|
|
60
|
+
...evidenceRecovery(value, context?.retainedEvidenceId),
|
|
61
|
+
}));
|
|
26
62
|
return {
|
|
27
63
|
content: [
|
|
28
64
|
{
|
|
29
65
|
type: "text",
|
|
30
|
-
text:
|
|
66
|
+
text: encoded.text,
|
|
31
67
|
},
|
|
32
68
|
],
|
|
33
69
|
structuredContent: candidate,
|
|
34
70
|
};
|
|
35
71
|
};
|
|
72
|
+
const evidenceRecovery = (value, retainedEvidenceId) => {
|
|
73
|
+
const projected = projectEvidence(value);
|
|
74
|
+
if (projected === undefined ||
|
|
75
|
+
typeof projected !== "object" ||
|
|
76
|
+
projected === null ||
|
|
77
|
+
Array.isArray(projected))
|
|
78
|
+
return {};
|
|
79
|
+
if (projected.evidence_id !== retainedEvidenceId)
|
|
80
|
+
return { evidence_id: projected.evidence_id ?? null };
|
|
81
|
+
return {
|
|
82
|
+
evidence_reference: {
|
|
83
|
+
kind: "retained-evidence",
|
|
84
|
+
evidence_id: projected.evidence_id ?? null,
|
|
85
|
+
},
|
|
86
|
+
};
|
|
87
|
+
};
|
|
36
88
|
const projectEvidence = (value) => {
|
|
37
89
|
if (typeof value !== "object" ||
|
|
38
90
|
value === null ||
|