rea-agents 6.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 +23 -17
- 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 +0 -2
- package/bridge/native/rea_lldb_tracer.py +630 -94
- package/bridge/process/ProcessRunTokenReader.swift +39 -5
- package/bridge/pwntools/recorded_crash_impl.py +4 -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 +19 -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 +6 -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 +27 -37
- 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 +23 -11
- 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/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/WebNetworkCaptureService.js +4 -2
- package/dist/application/WebRuntimeService.js +5 -3
- package/dist/application/WebScriptExportService.js +2 -2
- package/dist/application/WebSourceLocationService.js +4 -2
- 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 +3 -6
- package/dist/application/binary/BinarySession.js +95 -68
- package/dist/application/binary/BinarySessionOpen.js +3 -3
- package/dist/application/binary/BinarySessionRecords.js +25 -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/BinaryLayoutService.js +4 -2
- package/dist/application/binaryDiagnostics/RecordedCrashService.js +4 -2
- package/dist/application/evm/EvmInterfaceService.js +4 -2
- 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 +24 -3
- package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
- package/dist/application/javascript/JavaScriptApplicationService.js +22 -15
- package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
- package/dist/application/javascript/JavaScriptArtifactAnalysis.js +5 -4
- package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +39 -7
- package/dist/application/javascript/JavaScriptArtifactPathResolution.js +6 -3
- package/dist/application/javascript/JavaScriptArtifactReconstruction.js +11 -3
- 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/JavaScriptSemanticGraphBuilder.js +63 -61
- package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +23 -1
- 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/process/ProcessCli.js +14 -6
- package/dist/application/process/ProcessEvidence.js +4 -3
- package/dist/application/workflowInputError.js +18 -0
- package/dist/artifacts/ArtifactProvider.js +12 -2
- package/dist/artifacts/MachOSliceArtifactReader.js +98 -14
- package/dist/artifacts/NativeDmgArtifactReader.js +13 -6
- package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +22 -3
- 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 +92 -31
- 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/artifacts/inventory/ArtifactGraphConstruction.js +13 -8
- package/dist/artifacts/inventory/scanCanonical.js +11 -14
- package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
- package/dist/browser/CdpCaptureCompleteness.js +2 -0
- package/dist/browser/CdpCaptureEventHandlers.js +76 -11
- package/dist/browser/CdpCaptureEventTypes.js +5 -1
- package/dist/browser/CdpCaptureEvents.js +25 -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 +123 -124
- package/dist/browser/WebSourceMapFetcher.js +426 -72
- package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
- package/dist/browser/history/CaptureFailures.js +37 -1
- package/dist/browser/history/CaptureRelease.js +5 -0
- package/dist/browser/history/HarCaptureAdapter.js +3 -3
- package/dist/browser/history/HarJson.js +3 -2
- package/dist/browser/history/HistoricalCaptureDecoder.js +4 -2
- package/dist/cli/analysisSelector.js +23 -0
- package/dist/cli/applicationCommands.js +2 -3
- package/dist/cli/coreBinaryCommands.js +70 -12
- package/dist/cli/electronCommands.js +7 -6
- package/dist/cli/javascriptApplicationAnalysis.js +7 -3
- package/dist/cli/jsonOutput.js +4 -99
- package/dist/cli/nativeCallCommands.js +2 -3
- package/dist/cli/webRuntimeCommands.js +8 -8
- package/dist/cli.js +2 -1
- package/dist/cliCommandNames.js +0 -1
- package/dist/cliJsonInput.js +9 -4
- 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/enhancedInputs.js +5 -3
- package/dist/contracts/enhancedToolContracts.js +3 -3
- package/dist/contracts/hopperMemoryContracts.js +2 -5
- package/dist/contracts/javascript/electronToolContracts.js +1 -1
- package/dist/contracts/managed/managedToolContracts.js +2 -4
- package/dist/contracts/native/nativeToolContracts.js +4 -2
- package/dist/contracts/officialToolContracts.js +14 -15
- package/dist/contracts/promptContracts.js +3 -3
- package/dist/contracts/sessionLifecycleInputs.js +3 -7
- package/dist/contracts/sessionStatusContract.js +2 -4
- package/dist/contracts/sessionToolContracts.js +4 -6
- package/dist/contracts/sessionToolSchemas.js +2 -5
- package/dist/contracts/toolContractExamples.js +0 -1
- package/dist/contracts/toolContractHelpers.js +4 -1
- package/dist/contracts/toolEffects.js +0 -1
- package/dist/contracts/toolOutputSchemaGroups.js +28 -27
- package/dist/contracts/toolOutputSchemaPrimitives.js +18 -0
- package/dist/contracts/toolSchemaMetadata.js +69 -10
- package/dist/contracts/webNetworkCaptureToolContracts.js +1 -1
- package/dist/domain/analysisErrorBase.js +8 -3
- package/dist/domain/analysisErrorCore.js +3 -1
- package/dist/domain/analysisErrorPresentation.js +72 -17
- package/dist/domain/analysisErrorProjection.js +106 -27
- 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/dylibResolution.js +120 -9
- package/dist/domain/apple/dylibResolutionFindings.js +9 -7
- 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/bridgeCandidateProjection.js +71 -0
- package/dist/domain/browserCompleteness.js +1 -0
- package/dist/domain/browserObservationError.js +24 -5
- package/dist/domain/browserScenarioValues.js +2 -6
- package/dist/domain/bundleComparison.js +3 -2
- package/dist/domain/canonicalJsonDigestSteps.js +133 -0
- package/dist/domain/canonicalOrdering.js +9 -5
- package/dist/domain/changedBehavior.js +6 -6
- package/dist/domain/comparisonSourceEvidence.js +40 -0
- package/dist/domain/configurationErrors.js +1 -1
- package/dist/domain/evidence.js +64 -9
- package/dist/domain/evidenceBundle.js +42 -1
- package/dist/domain/evidenceErrors.js +12 -1
- package/dist/domain/explicitSensitiveFailure.js +17 -1
- package/dist/domain/firmware/firmwareAnalysis.js +6 -7
- 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 +30 -4
- package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
- 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/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 +13 -0
- 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 +90 -6
- package/dist/domain/localPath.js +6 -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/fileOffsetPartialObservation.js +1 -0
- package/dist/domain/native/nativeCallObservation.js +33 -11
- package/dist/domain/native/nativeCallPartialObservation.js +33 -0
- package/dist/domain/process/processCapture.js +8 -4
- package/dist/domain/process/processComparison.js +38 -4
- package/dist/domain/process/processScenario.js +11 -10
- 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/reconstructionVerification.js +6 -43
- package/dist/domain/reconstructionVerificationSchemas.js +2 -2
- package/dist/domain/staticRuntimeCorrelation.js +6 -43
- package/dist/domain/webBundleAnalysis.js +20 -8
- package/dist/domain/webBundleAnalyzerInspection.js +13 -8
- package/dist/domain/webBundleAnalyzerResult.js +41 -2
- package/dist/domain/webRuntime.js +19 -5
- package/dist/domain/webSourceLocation.js +1 -0
- package/dist/firmware/FirmwareFiles.js +1 -1
- package/dist/generatedPackageMetadata.js +1 -1
- 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 +33 -16
- package/dist/ghidra/GhidraProviderCapabilities.js +14 -2
- 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 +31 -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/inspector/JavaScriptRuntimeScope.js +9 -1
- package/dist/inspector/V8InspectorCaptureProjection.js +8 -3
- package/dist/inspector/V8InspectorProvider.js +47 -11
- package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
- package/dist/javascript/sourceMaps/SourceMapCommand.js +16 -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 +81 -84
- package/dist/native/LldbCallTracer.js +365 -102
- package/dist/native/LldbRetainedObservations.js +178 -0
- package/dist/native/NativeCallObservation.js +62 -3
- package/dist/native/NativeMacOSProvider.js +98 -17
- package/dist/native/SignatureTargetBinding.js +155 -0
- package/dist/native/parsers/lipo.js +71 -1
- package/dist/native/pwndbg/PwndbgCoreContext.js +25 -5
- package/dist/native/pwntools/RecordedCrashStructureBindings.js +2 -0
- package/dist/process/DarwinProcessRunTokenReader.js +8 -9
- package/dist/process/ExecFileOutput.js +20 -0
- package/dist/process/OwnedCommand.js +7 -2
- package/dist/process/ProcessOwnership.js +203 -53
- package/dist/process/ProcessOwnershipObservation.js +49 -4
- package/dist/process/ProviderProcess.js +38 -7
- package/dist/process/capture/ProcessCaptureError.js +2 -2
- package/dist/process/capture/ProcessCaptureLifecycle.js +100 -34
- package/dist/server/EvidenceMcpServer.js +146 -0
- package/dist/server/createServer.js +15 -8
- 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 +2 -4
- 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 +2 -4
- package/dist/server/registerEvmTools.js +2 -4
- 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 +71 -45
- package/dist/server/registerRecordedCrashTools.js +2 -4
- package/dist/server/registerSessionRecordTools.js +5 -6
- package/dist/server/registerSessionStatusTool.js +17 -3
- package/dist/server/registerSessionTools.js +11 -3
- package/dist/server/registerWebModuleTool.js +2 -4
- package/dist/server/registerWebNetworkCaptureTool.js +2 -4
- 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 +0 -1
- package/dist/server/toolRegistrationOptions.js +2 -2
- package/dist/server/toolResult.js +62 -10
- package/dist/server/toolResultEncoding.js +33 -0
- package/install.sh +1 -1
- package/native/windows/build/manifest.json +1 -1
- package/package.json +8 -3
- package/scripts/electron-active-hook-boundaries.cjs +18 -20
- package/scripts/electron-active-hook.cjs +241 -37
- package/skills/reverse-engineer-anything/SKILL.md +11 -3
- package/skills/reverse-engineer-anything/references/javascript-applications.md +8 -1
- package/dist/ghidra/GhidraDefaults.js +0 -2
|
@@ -3,7 +3,7 @@ import { isAbsolute } from "node:path";
|
|
|
3
3
|
import { z } from "zod";
|
|
4
4
|
import { AnalysisCancelledError, AnalysisInputError, AnalysisOutputError, } from "../domain/analysisErrorCore.js";
|
|
5
5
|
import { createEvidence } from "../domain/evidence.js";
|
|
6
|
-
import {
|
|
6
|
+
import { analysisInputErrorFromIssues } from "../domain/inputIssueProjection.js";
|
|
7
7
|
import { jsonObjectSchema } from "../domain/jsonValue.js";
|
|
8
8
|
import { err, ok } from "../domain/result.js";
|
|
9
9
|
import { selectedWebScriptArtifactsSchema, webArtifactFileSchema, } from "../domain/webScriptArtifacts.js";
|
|
@@ -41,7 +41,9 @@ export class WebSourceLocationService {
|
|
|
41
41
|
return err(new AnalysisCancelledError(OPERATION));
|
|
42
42
|
const parsed = webSourceLocationInputSchema.safeParse(rawInput);
|
|
43
43
|
if (!parsed.success)
|
|
44
|
-
return err(
|
|
44
|
+
return err(analysisInputErrorFromIssues(OPERATION, parsed.error.issues, rawInput, {
|
|
45
|
+
cause: parsed.error,
|
|
46
|
+
}));
|
|
45
47
|
const input = parsed.data;
|
|
46
48
|
const admitted = admitContext(input);
|
|
47
49
|
if (!admitted.ok)
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { REA_WORKFLOW_PROVIDER, workflowAnalysisProfile, } from "./InvestigationProviders.js";
|
|
2
|
+
import { analysisProfileSchema, committedProviderSchema, } from "../domain/analysisProfile.js";
|
|
3
|
+
import { createEvidence } from "../domain/evidence.js";
|
|
4
|
+
import { UnknownRegistryError } from "../domain/unknownRegistryError.js";
|
|
5
|
+
/** Build the shared Evidence record for a successful composed binary workflow. */
|
|
6
|
+
export const createWorkflowEvidence = (input) => createEvidence(input.target, REA_WORKFLOW_PROVIDER, {
|
|
7
|
+
operation: input.operation,
|
|
8
|
+
parameters: input.parameters,
|
|
9
|
+
result: input.result,
|
|
10
|
+
...(input.upstreamProfile === undefined
|
|
11
|
+
? {}
|
|
12
|
+
: {
|
|
13
|
+
analysisProfile: workflowAnalysisProfile(input.upstreamProfile, input.operation),
|
|
14
|
+
}),
|
|
15
|
+
confidence: "derived",
|
|
16
|
+
limitations: ["Derived by an REA composed workflow."],
|
|
17
|
+
});
|
|
18
|
+
/** Convert workflow Evidence into its exact replay binding, when it has a profile. */
|
|
19
|
+
export const workflowSnapshotRecord = (evidence, operation) => {
|
|
20
|
+
if (!("analysis_profile" in evidence))
|
|
21
|
+
return undefined;
|
|
22
|
+
return {
|
|
23
|
+
operation,
|
|
24
|
+
parameters: evidence.parameters,
|
|
25
|
+
execution: {
|
|
26
|
+
result: evidence.normalized_result,
|
|
27
|
+
rawResult: evidence.raw_result,
|
|
28
|
+
provider: committedProviderSchema.parse(evidence.provider),
|
|
29
|
+
analysisProfile: analysisProfileSchema.parse(evidence.analysis_profile),
|
|
30
|
+
limitations: evidence.limitations,
|
|
31
|
+
locations: evidence.locations,
|
|
32
|
+
subject: evidence.subject === null
|
|
33
|
+
? null
|
|
34
|
+
: {
|
|
35
|
+
path: evidence.subject.local_path,
|
|
36
|
+
sha256: evidence.subject.digest.sha256,
|
|
37
|
+
format: evidence.subject.format,
|
|
38
|
+
...(evidence.subject.architecture === null
|
|
39
|
+
? {}
|
|
40
|
+
: { architecture: evidence.subject.architecture }),
|
|
41
|
+
},
|
|
42
|
+
},
|
|
43
|
+
};
|
|
44
|
+
};
|
|
45
|
+
/** Retain residual workflow questions using the shared investigation policy. */
|
|
46
|
+
export const recordWorkflowUnknowns = ({ name, result, evidenceId, recordUnknown, }) => {
|
|
47
|
+
if (!["trace_feature", "trace_call_path", "inspect_native_api"].includes(name) ||
|
|
48
|
+
recordUnknown === undefined ||
|
|
49
|
+
typeof result !== "object" ||
|
|
50
|
+
result === null ||
|
|
51
|
+
Array.isArray(result) ||
|
|
52
|
+
!Array.isArray(result.residual_unknowns))
|
|
53
|
+
return { ok: true, value: null };
|
|
54
|
+
for (const question of result.residual_unknowns) {
|
|
55
|
+
if (typeof question !== "string")
|
|
56
|
+
continue;
|
|
57
|
+
const recorded = recordUnknown({
|
|
58
|
+
question,
|
|
59
|
+
severity: "medium",
|
|
60
|
+
domain: name === "inspect_native_api" ? "native-api" : "control-flow",
|
|
61
|
+
supporting_evidence_ids: [evidenceId],
|
|
62
|
+
contradicting_evidence_ids: [],
|
|
63
|
+
required_authority: "shipped-artifact",
|
|
64
|
+
required_confidence: "observed",
|
|
65
|
+
required_environment: null,
|
|
66
|
+
recommended_probes: [
|
|
67
|
+
{
|
|
68
|
+
operation: name,
|
|
69
|
+
rationale: name === "inspect_native_api"
|
|
70
|
+
? "Confirm the unsupported boundary with a capable provider or ABI probe."
|
|
71
|
+
: "Continue with a focused query or another available provider.",
|
|
72
|
+
},
|
|
73
|
+
],
|
|
74
|
+
relationships: [],
|
|
75
|
+
});
|
|
76
|
+
if (!recorded.ok &&
|
|
77
|
+
!(recorded.error instanceof UnknownRegistryError &&
|
|
78
|
+
recorded.error.reason === "already-exists"))
|
|
79
|
+
return recorded;
|
|
80
|
+
}
|
|
81
|
+
return { ok: true, value: null };
|
|
82
|
+
};
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { analysisProfileSchema, } from "../../domain/analysisProfile.js";
|
|
2
|
-
import { AnalysisCancelledError } from "../../domain/analysisErrorCore.js";
|
|
2
|
+
import { AnalysisCancelledError, AnalysisUnsupportedTargetError, } from "../../domain/analysisErrorCore.js";
|
|
3
3
|
import { jsonObjectSchema } from "../../domain/jsonValue.js";
|
|
4
4
|
import { err, ok } from "../../domain/result.js";
|
|
5
5
|
import { ABORTED, waitForAbortable } from "./AbortablePromise.js";
|
|
@@ -22,10 +22,26 @@ export const evaluateAnalysisProviderCandidate = async (candidate, status, targe
|
|
|
22
22
|
return err(new AnalysisCancelledError("open_binary"));
|
|
23
23
|
if (!resolved.ok && resolved.error instanceof AnalysisCancelledError)
|
|
24
24
|
return err(resolved.error);
|
|
25
|
-
if (!resolved.ok)
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
25
|
+
if (!resolved.ok) {
|
|
26
|
+
const error = resolved.error;
|
|
27
|
+
const rejection = error instanceof AnalysisUnsupportedTargetError
|
|
28
|
+
? {
|
|
29
|
+
candidate,
|
|
30
|
+
status: {
|
|
31
|
+
...status,
|
|
32
|
+
targetSupport: {
|
|
33
|
+
status: "unsupported",
|
|
34
|
+
code: "target_format_unsupported",
|
|
35
|
+
reason: error.reason,
|
|
36
|
+
diagnostics: { path: error.path, error_tag: error._tag },
|
|
37
|
+
},
|
|
38
|
+
},
|
|
39
|
+
}
|
|
40
|
+
: rejectedProfile(candidate, status, error.message, {
|
|
41
|
+
error_tag: error._tag,
|
|
42
|
+
});
|
|
43
|
+
return ok({ ...rejection, profileError: error });
|
|
44
|
+
}
|
|
29
45
|
try {
|
|
30
46
|
if (resolved.value.profile === null)
|
|
31
47
|
return ok(rejectedProfile(candidate, status, "Provider version or analysis profile could not be resolved"));
|
|
@@ -114,6 +114,8 @@ export class AnalysisProviderRegistry {
|
|
|
114
114
|
if (!evaluation.ok)
|
|
115
115
|
return evaluation;
|
|
116
116
|
const evaluated = evaluation.value;
|
|
117
|
+
if (evaluated.profileError !== undefined)
|
|
118
|
+
return err(evaluated.profileError);
|
|
117
119
|
const statuses = replaceCandidate(baseline, evaluated.status);
|
|
118
120
|
if (evaluated.profile === undefined ||
|
|
119
121
|
evaluated.compatibility === undefined)
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { EvidenceIntegrityError } from "../../domain/evidenceErrors.js";
|
|
1
|
+
import { EvidenceIntegrityError, AnalysisSnapshotMismatchError, } from "../../domain/evidenceErrors.js";
|
|
2
2
|
import { NoBinaryOpenError } from "../../domain/configurationErrors.js";
|
|
3
3
|
import {} from "../../domain/analysisErrorBase.js";
|
|
4
4
|
import { err, ok } from "../../domain/result.js";
|
|
@@ -11,7 +11,6 @@ const STATEFUL_OPERATIONS = new Set([
|
|
|
11
11
|
"current_document",
|
|
12
12
|
"goto_address",
|
|
13
13
|
"list_documents",
|
|
14
|
-
"set_current_document",
|
|
15
14
|
]);
|
|
16
15
|
const CURSOR_DEFAULT_OPERATIONS = new Set([
|
|
17
16
|
"address_name",
|
|
@@ -21,9 +20,7 @@ const CURSOR_DEFAULT_OPERATIONS = new Set([
|
|
|
21
20
|
"prev_address",
|
|
22
21
|
"xrefs",
|
|
23
22
|
]);
|
|
24
|
-
const DOCUMENT_SCOPED_OPERATIONS = new Set(OFFICIAL_TOOL_CONTRACTS.map(({ name }) => name).filter((name) => name !== "current_document" &&
|
|
25
|
-
name !== "list_documents" &&
|
|
26
|
-
name !== "set_current_document"));
|
|
23
|
+
const DOCUMENT_SCOPED_OPERATIONS = new Set(OFFICIAL_TOOL_CONTRACTS.map(({ name }) => name).filter((name) => name !== "current_document" && name !== "list_documents"));
|
|
27
24
|
/** Maximum duplicated result bindings retained across direct and workflow queries. */
|
|
28
25
|
export const SNAPSHOT_CACHE_ENTRY_CEILING = 10_000;
|
|
29
26
|
/** Whether an operation is immutable and independent of provider UI state. */
|
|
@@ -120,7 +117,7 @@ export class AnalysisSnapshotCache {
|
|
|
120
117
|
if (active !== undefined &&
|
|
121
118
|
(!snapshotMatchesTarget(validated.target, active.target) ||
|
|
122
119
|
!snapshotMatchesProfile(validated.binding, active.profile)))
|
|
123
|
-
return err(new
|
|
120
|
+
return err(new AnalysisSnapshotMismatchError("Analysis snapshot profile_mismatch: target, provider, or analysis profile does not match the active binary"));
|
|
124
121
|
const importedEvidence = mergeEvidence(validated.evidence_bundle);
|
|
125
122
|
return importedEvidence.ok ? ok(this.stage(validated)) : importedEvidence;
|
|
126
123
|
}
|
|
@@ -6,6 +6,7 @@ import { err, ok } from "../../domain/result.js";
|
|
|
6
6
|
import { createEvidence } from "../../domain/evidence.js";
|
|
7
7
|
import { OFFICIAL_TOOL_CONTRACTS } from "../../contracts/officialToolContracts.js";
|
|
8
8
|
import { ENHANCED_TOOL_CONTRACTS } from "../../contracts/enhancedToolContracts.js";
|
|
9
|
+
import { writeAnalysisSnapshot } from "./AnalysisSnapshotFiles.js";
|
|
9
10
|
import { SessionProviderRouter, } from "./SessionProviderRouter.js";
|
|
10
11
|
import { InvestigationRecords } from "../investigation/InvestigationRecords.js";
|
|
11
12
|
import { BinarySessionRecords } from "./BinarySessionRecords.js";
|
|
@@ -25,7 +26,8 @@ const ENHANCED_OPERATIONS = new Set(ENHANCED_TOOL_CONTRACTS.map(({ name }) => na
|
|
|
25
26
|
export class BinarySession extends BinarySessionRecords {
|
|
26
27
|
#active;
|
|
27
28
|
#transition = Promise.resolve();
|
|
28
|
-
#
|
|
29
|
+
#transitionGeneration = 0;
|
|
30
|
+
#calls = new Map();
|
|
29
31
|
#providerRouter;
|
|
30
32
|
#runtimeUnavailability = new Map();
|
|
31
33
|
#availabilityListeners = new Set();
|
|
@@ -125,7 +127,7 @@ export class BinarySession extends BinarySessionRecords {
|
|
|
125
127
|
})), options);
|
|
126
128
|
}
|
|
127
129
|
#open(resolve, options) {
|
|
128
|
-
return this.#serialize(async () => {
|
|
130
|
+
return this.#serialize(async (admittedThrough) => {
|
|
129
131
|
if (isAborted(options.signal))
|
|
130
132
|
return err(new AnalysisCancelledError("open_binary"));
|
|
131
133
|
const resolved = await resolve();
|
|
@@ -139,16 +141,17 @@ export class BinarySession extends BinarySessionRecords {
|
|
|
139
141
|
const sameProfile = activeProfile === null || activeProfile === undefined
|
|
140
142
|
? profile === null
|
|
141
143
|
: profile !== null && analysisProfilesEqual(activeProfile, profile);
|
|
144
|
+
await this.#drainCalls(admittedThrough);
|
|
145
|
+
if (isAborted(options.signal))
|
|
146
|
+
return err(new AnalysisCancelledError("open_binary"));
|
|
142
147
|
if (sameTarget && sameProfile) {
|
|
143
148
|
if (options.snapshot !== undefined) {
|
|
144
149
|
const imported = this.importAnalysisSnapshot(options.snapshot);
|
|
145
150
|
if (!imported.ok)
|
|
146
151
|
return imported;
|
|
147
152
|
}
|
|
148
|
-
this.resetSnapshotInvalidation();
|
|
149
153
|
return ok(target);
|
|
150
154
|
}
|
|
151
|
-
await this.#drainCalls();
|
|
152
155
|
const previous = this.#active;
|
|
153
156
|
this.#active = undefined;
|
|
154
157
|
if (previous !== undefined) {
|
|
@@ -181,6 +184,7 @@ export class BinarySession extends BinarySessionRecords {
|
|
|
181
184
|
runId,
|
|
182
185
|
};
|
|
183
186
|
this.#clearRuntimeAvailability();
|
|
187
|
+
this.resetSnapshotInvalidation();
|
|
184
188
|
if (options.snapshot === undefined) {
|
|
185
189
|
if (profile === null)
|
|
186
190
|
this.clearSnapshot();
|
|
@@ -196,31 +200,49 @@ export class BinarySession extends BinarySessionRecords {
|
|
|
196
200
|
return imported;
|
|
197
201
|
}
|
|
198
202
|
}
|
|
199
|
-
this.resetSnapshotInvalidation();
|
|
200
203
|
return ok(target);
|
|
201
204
|
});
|
|
202
205
|
}
|
|
203
206
|
/** Close the active target, if any. */
|
|
204
207
|
close(options = {}) {
|
|
205
|
-
return this.#serialize(async () => {
|
|
206
|
-
|
|
207
|
-
this.#
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
this.#
|
|
221
|
-
return closed
|
|
208
|
+
return this.#serialize(async (admittedThrough) => {
|
|
209
|
+
await this.#drainCalls(admittedThrough);
|
|
210
|
+
return this.#closeActive(options);
|
|
211
|
+
});
|
|
212
|
+
}
|
|
213
|
+
/** Drain earlier requests, save an immutable snapshot, and close under one lifecycle lock. */
|
|
214
|
+
closeWithSnapshot(path, overwrite, options = {}) {
|
|
215
|
+
return this.#serialize(async (admittedThrough) => {
|
|
216
|
+
await this.#drainCalls(admittedThrough);
|
|
217
|
+
const snapshot = this.exportAnalysisSnapshot();
|
|
218
|
+
if (!snapshot.ok)
|
|
219
|
+
return snapshot;
|
|
220
|
+
const written = await writeAnalysisSnapshot(snapshot.value, path, overwrite);
|
|
221
|
+
if (!written.ok)
|
|
222
|
+
return written;
|
|
223
|
+
const closed = await this.#closeActive(options);
|
|
224
|
+
return closed.ok
|
|
225
|
+
? ok({ ...written.value, entries: snapshot.value.entries.length })
|
|
226
|
+
: closed;
|
|
222
227
|
});
|
|
223
228
|
}
|
|
229
|
+
async #closeActive(options) {
|
|
230
|
+
const previous = this.#active;
|
|
231
|
+
this.#active = undefined;
|
|
232
|
+
const closed = previous === undefined
|
|
233
|
+
? ok(null)
|
|
234
|
+
: await closeAnalysisClient(previous.client, previous.route.identity.id, {
|
|
235
|
+
...(options.progress === undefined
|
|
236
|
+
? {}
|
|
237
|
+
: { progress: options.progress }),
|
|
238
|
+
...(options.retainProviderDocuments === true
|
|
239
|
+
? { retainDocument: true }
|
|
240
|
+
: {}),
|
|
241
|
+
});
|
|
242
|
+
this.clearSessionRecords();
|
|
243
|
+
this.#clearRuntimeAvailability();
|
|
244
|
+
return closed;
|
|
245
|
+
}
|
|
224
246
|
/** Describe the active binary session. */
|
|
225
247
|
status() {
|
|
226
248
|
return binarySessionStatus({
|
|
@@ -231,6 +253,7 @@ export class BinarySession extends BinarySessionRecords {
|
|
|
231
253
|
runId: this.#active?.runId,
|
|
232
254
|
runtimeLineageSnapshots: this.#active?.client.runtimeLineageSnapshots?.() ?? [],
|
|
233
255
|
requestActivitySnapshots: this.#active?.client.requestActivitySnapshots?.() ?? [],
|
|
256
|
+
providerOperationHealth: this.#active?.client.operationHealthSnapshot?.() ?? null,
|
|
234
257
|
});
|
|
235
258
|
}
|
|
236
259
|
/** Return the immutable artifact identity captured before its provider started. */
|
|
@@ -247,8 +270,14 @@ export class BinarySession extends BinarySessionRecords {
|
|
|
247
270
|
* Calls may overlap, but a pending target transition prevents new calls from
|
|
248
271
|
* entering until the transition has settled.
|
|
249
272
|
*/
|
|
250
|
-
|
|
251
|
-
const
|
|
273
|
+
execute(name, arguments_, options) {
|
|
274
|
+
const generation = this.#transitionGeneration;
|
|
275
|
+
const call = this.#execute(name, arguments_, options, this.#transition);
|
|
276
|
+
this.#calls.set(call, generation);
|
|
277
|
+
return call.finally(() => this.#calls.delete(call));
|
|
278
|
+
}
|
|
279
|
+
async #execute(name, arguments_, options, transition) {
|
|
280
|
+
const transitioned = await this.#waitForTransition(name, options?.signal, transition);
|
|
252
281
|
if (!transitioned.ok)
|
|
253
282
|
return transitioned;
|
|
254
283
|
const prepared = prepareSessionExecution({
|
|
@@ -269,46 +298,40 @@ export class BinarySession extends BinarySessionRecords {
|
|
|
269
298
|
if (cached !== undefined)
|
|
270
299
|
return ok(cached);
|
|
271
300
|
const call = active.client.execute(name, arguments_, options);
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
name
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
execution: profiled.value,
|
|
302
|
-
});
|
|
303
|
-
}
|
|
304
|
-
else if (profiled.ok && capability?.effects.mutatesArtifact === true) {
|
|
305
|
-
this.invalidateSnapshot();
|
|
306
|
-
}
|
|
307
|
-
return profiled;
|
|
301
|
+
const result = await call;
|
|
302
|
+
const profiled = bindExecutionTarget(commitExecutionProfile(name, result, profile), name, active.target);
|
|
303
|
+
this.#observeRuntimeAvailability(name, profiled);
|
|
304
|
+
if (profiled.ok &&
|
|
305
|
+
cacheable &&
|
|
306
|
+
profile !== undefined &&
|
|
307
|
+
name !== "decode_interface_builder" &&
|
|
308
|
+
name !== "inspect_asset_catalog" &&
|
|
309
|
+
name !== "inspect_keyed_archive" &&
|
|
310
|
+
name !== "trace_dylib_resolution") {
|
|
311
|
+
const evidence = createEvidence(profiled.value.subject ?? active.target, profiled.value.provider, {
|
|
312
|
+
operation: name,
|
|
313
|
+
parameters: arguments_,
|
|
314
|
+
result: profiled.value.result,
|
|
315
|
+
analysisProfile: profile,
|
|
316
|
+
rawResult: profiled.value.rawResult,
|
|
317
|
+
limitations: profiled.value.limitations,
|
|
318
|
+
locations: profiled.value.locations,
|
|
319
|
+
});
|
|
320
|
+
const recorded = this.recordEvidence(evidence);
|
|
321
|
+
if (!recorded.ok)
|
|
322
|
+
return recorded;
|
|
323
|
+
this.recordSnapshot({
|
|
324
|
+
target: active.target,
|
|
325
|
+
profile,
|
|
326
|
+
operation: name,
|
|
327
|
+
parameters: arguments_,
|
|
328
|
+
execution: profiled.value,
|
|
329
|
+
});
|
|
308
330
|
}
|
|
309
|
-
|
|
310
|
-
this
|
|
331
|
+
else if (profiled.ok && capability?.effects.mutatesArtifact === true) {
|
|
332
|
+
this.invalidateSnapshot();
|
|
311
333
|
}
|
|
334
|
+
return profiled;
|
|
312
335
|
}
|
|
313
336
|
#observeRuntimeAvailability(operation, result) {
|
|
314
337
|
if (result.ok) {
|
|
@@ -374,12 +397,16 @@ export class BinarySession extends BinarySessionRecords {
|
|
|
374
397
|
return this.#active?.route ?? this.#providerRouter.initialRoute();
|
|
375
398
|
}
|
|
376
399
|
#serialize(operation) {
|
|
377
|
-
|
|
400
|
+
// Later calls wait for this transition and must not be included in its drain.
|
|
401
|
+
const admittedThrough = this.#transitionGeneration++;
|
|
402
|
+
const result = this.#transition.then(() => operation(admittedThrough), () => operation(admittedThrough));
|
|
378
403
|
this.#transition = result.then(() => undefined, () => undefined);
|
|
379
404
|
return result;
|
|
380
405
|
}
|
|
381
|
-
async #drainCalls() {
|
|
382
|
-
await Promise.allSettled(this.#calls
|
|
406
|
+
async #drainCalls(admittedThrough) {
|
|
407
|
+
await Promise.allSettled([...this.#calls]
|
|
408
|
+
.filter(([, generation]) => generation <= admittedThrough)
|
|
409
|
+
.map(([call]) => call));
|
|
383
410
|
}
|
|
384
411
|
async #restore(previous) {
|
|
385
412
|
if (previous === undefined)
|
|
@@ -399,11 +426,11 @@ export class BinarySession extends BinarySessionRecords {
|
|
|
399
426
|
else
|
|
400
427
|
await client.close();
|
|
401
428
|
}
|
|
402
|
-
async #waitForTransition(operation, signal) {
|
|
429
|
+
async #waitForTransition(operation, signal, transition) {
|
|
403
430
|
if (signal?.aborted === true)
|
|
404
431
|
return err(new AnalysisCancelledError(operation));
|
|
405
432
|
if (signal === undefined) {
|
|
406
|
-
await
|
|
433
|
+
await transition;
|
|
407
434
|
return ok(undefined);
|
|
408
435
|
}
|
|
409
436
|
return new Promise((resolve) => {
|
|
@@ -411,7 +438,7 @@ export class BinarySession extends BinarySessionRecords {
|
|
|
411
438
|
resolve(err(new AnalysisCancelledError(operation)));
|
|
412
439
|
};
|
|
413
440
|
signal.addEventListener("abort", onAbort, { once: true });
|
|
414
|
-
|
|
441
|
+
transition.then(() => {
|
|
415
442
|
signal.removeEventListener("abort", onAbort);
|
|
416
443
|
resolve(signal.aborted
|
|
417
444
|
? err(new AnalysisCancelledError(operation))
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { snapshotMatchesBinding, snapshotMatchesTarget, snapshotTarget, } from "../../domain/analysisSnapshot.js";
|
|
2
2
|
import { parseBinaryTarget } from "../BinaryTargetResolver.js";
|
|
3
3
|
import {} from "../../domain/binaryTarget.js";
|
|
4
|
-
import { EvidenceIntegrityError } from "../../domain/evidenceErrors.js";
|
|
4
|
+
import { EvidenceIntegrityError, AnalysisSnapshotMismatchError, } from "../../domain/evidenceErrors.js";
|
|
5
5
|
import {} from "../../domain/analysisErrorBase.js";
|
|
6
6
|
import { err } from "../../domain/result.js";
|
|
7
7
|
import { SessionProviderRouter } from "./SessionProviderRouter.js";
|
|
@@ -47,8 +47,8 @@ export const validateResolvedSessionTarget = (input) => {
|
|
|
47
47
|
const validateSnapshot = ({ snapshot, target, profile, current, stagedSnapshotMatches, }) => {
|
|
48
48
|
if (snapshot !== undefined &&
|
|
49
49
|
(profile === null || !snapshotMatchesBinding(snapshot, target, profile)))
|
|
50
|
-
return new
|
|
50
|
+
return new AnalysisSnapshotMismatchError("Analysis snapshot profile_mismatch: target, provider, or analysis profile does not match the requested binary");
|
|
51
51
|
if (current === undefined && !stagedSnapshotMatches(target, profile))
|
|
52
|
-
return new
|
|
52
|
+
return new AnalysisSnapshotMismatchError("Analysis snapshot profile_mismatch: staged target, provider, or analysis profile does not match");
|
|
53
53
|
return undefined;
|
|
54
54
|
};
|
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
import { evidenceBundleForTarget } from "../../domain/evidenceBundle.js";
|
|
2
|
-
import { EvidenceIntegrityError } from "../../domain/evidenceErrors.js";
|
|
2
|
+
import { EvidenceIntegrityError, AnalysisSnapshotMismatchError, } from "../../domain/evidenceErrors.js";
|
|
3
3
|
import {} from "../../domain/analysisErrorBase.js";
|
|
4
4
|
import {} from "../../domain/unknownRegistryError.js";
|
|
5
5
|
import { err, ok } from "../../domain/result.js";
|
|
6
6
|
import { AnalysisSnapshotCache } from "./AnalysisSnapshotCache.js";
|
|
7
7
|
import { InvestigationRecords } from "../investigation/InvestigationRecords.js";
|
|
8
|
+
const SNAPSHOT_MUTATION_RECOVERY = "Export session observations through export_evidence_bundle if needed. Close the active target without saving a snapshot, then reopen it before importing or saving a snapshot.";
|
|
8
9
|
/** Binary snapshot owner and compatibility facade for composed investigation records. */
|
|
9
10
|
export class BinarySessionRecords {
|
|
10
11
|
#records;
|
|
@@ -31,9 +32,17 @@ export class BinarySessionRecords {
|
|
|
31
32
|
evidenceById(evidenceId) {
|
|
32
33
|
return this.#records.evidenceById(evidenceId);
|
|
33
34
|
}
|
|
35
|
+
/** Borrow immutable investigation Evidence without copying a complete graph. */
|
|
36
|
+
evidenceForAnalysis(evidenceId) {
|
|
37
|
+
return this.#records.evidenceForAnalysis(evidenceId);
|
|
38
|
+
}
|
|
34
39
|
exportEvidenceBundle() {
|
|
35
40
|
return this.#records.exportEvidenceBundle();
|
|
36
41
|
}
|
|
42
|
+
/** Borrow a sealed bundle for complete serialization without cloning retained graphs. */
|
|
43
|
+
evidenceBundleForSerialization() {
|
|
44
|
+
return this.#records.evidenceBundleForSerialization();
|
|
45
|
+
}
|
|
37
46
|
importEvidenceBundle(bundle) {
|
|
38
47
|
const imported = this.#records.mergeEvidenceBundle(bundle);
|
|
39
48
|
if (!imported.ok)
|
|
@@ -47,7 +56,9 @@ export class BinarySessionRecords {
|
|
|
47
56
|
exportAnalysisSnapshot() {
|
|
48
57
|
const active = this.activeAnalysisBinding();
|
|
49
58
|
if (this.#snapshotInvalidated)
|
|
50
|
-
return err(new EvidenceIntegrityError("Analysis snapshots are unavailable after analysis metadata mutations"
|
|
59
|
+
return err(new EvidenceIntegrityError("Analysis snapshots are unavailable after analysis metadata mutations", {
|
|
60
|
+
userMessage: `Analysis snapshots are unavailable after analysis metadata mutations. ${SNAPSHOT_MUTATION_RECOVERY}`,
|
|
61
|
+
}));
|
|
51
62
|
const target = active?.target;
|
|
52
63
|
const profile = active?.profile ?? undefined;
|
|
53
64
|
if (target !== undefined && profile === undefined)
|
|
@@ -58,8 +69,12 @@ export class BinarySessionRecords {
|
|
|
58
69
|
}
|
|
59
70
|
importAnalysisSnapshot(snapshot) {
|
|
60
71
|
const active = this.activeAnalysisBinding();
|
|
72
|
+
if (active !== undefined && this.#snapshotInvalidated)
|
|
73
|
+
return err(new EvidenceIntegrityError("Analysis snapshots cannot be imported after analysis metadata mutations", {
|
|
74
|
+
userMessage: `Analysis snapshots cannot be imported after analysis metadata mutations. ${SNAPSHOT_MUTATION_RECOVERY}`,
|
|
75
|
+
}));
|
|
61
76
|
if (active?.profile === null)
|
|
62
|
-
return err(new
|
|
77
|
+
return err(new AnalysisSnapshotMismatchError("Analysis snapshot profile_mismatch: the active target has no concrete analysis profile"));
|
|
63
78
|
const imported = this.#snapshot.import(snapshot, active === undefined
|
|
64
79
|
? undefined
|
|
65
80
|
: { target: active.target, profile: active.profile }, (bundle) => {
|
|
@@ -78,9 +93,13 @@ export class BinarySessionRecords {
|
|
|
78
93
|
this.#emitSnapshotChanged();
|
|
79
94
|
}
|
|
80
95
|
lookupSnapshot(target, profile, operation, parameters) {
|
|
96
|
+
if (this.#snapshotInvalidated)
|
|
97
|
+
return undefined;
|
|
81
98
|
return this.#snapshot.lookup(target, profile, operation, parameters);
|
|
82
99
|
}
|
|
83
100
|
recordSnapshot(input) {
|
|
101
|
+
if (this.#snapshotInvalidated)
|
|
102
|
+
return;
|
|
84
103
|
this.#snapshot.record(input);
|
|
85
104
|
this.#emitSnapshotChanged();
|
|
86
105
|
}
|
|
@@ -89,6 +108,8 @@ export class BinarySessionRecords {
|
|
|
89
108
|
const active = this.activeAnalysisBinding();
|
|
90
109
|
if (active === undefined || active.profile === null)
|
|
91
110
|
return err(new EvidenceIntegrityError("Workflow snapshot entries require an active concrete provider profile"));
|
|
111
|
+
if (this.#snapshotInvalidated)
|
|
112
|
+
return ok(null);
|
|
92
113
|
try {
|
|
93
114
|
this.#snapshot.recordWorkflow({
|
|
94
115
|
target: active.target,
|
|
@@ -112,6 +133,7 @@ export class BinarySessionRecords {
|
|
|
112
133
|
resetSnapshotInvalidation() {
|
|
113
134
|
if (!this.#snapshotInvalidated)
|
|
114
135
|
return;
|
|
136
|
+
this.#snapshot.clear();
|
|
115
137
|
this.#snapshotInvalidated = false;
|
|
116
138
|
this.#emitSnapshotChanged();
|
|
117
139
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/** Project internal provider routing state into the caller-visible session status. */
|
|
2
|
-
export const binarySessionStatus = ({ target, route, router, runtimeUnavailability, runId, runtimeLineageSnapshots, requestActivitySnapshots, }) => {
|
|
2
|
+
export const binarySessionStatus = ({ target, route, router, runtimeUnavailability, runId, runtimeLineageSnapshots, requestActivitySnapshots, providerOperationHealth, }) => {
|
|
3
3
|
const configuredProvider = router.configuredIdentity();
|
|
4
4
|
const provider = providerSummary(configuredProvider);
|
|
5
5
|
const providers = router.providerIdentities(route).map(providerSummary);
|
|
@@ -50,6 +50,7 @@ export const binarySessionStatus = ({ target, route, router, runtimeUnavailabili
|
|
|
50
50
|
process_lineage: processLineageStatus(runtimeLineageSnapshots),
|
|
51
51
|
},
|
|
52
52
|
analysis_activity: requestActivityStatus(requestActivitySnapshots),
|
|
53
|
+
provider_operation_health: providerOperationHealthStatus(providerOperationHealth),
|
|
53
54
|
};
|
|
54
55
|
return target === undefined
|
|
55
56
|
? { open: false, ...common }
|
|
@@ -137,3 +138,18 @@ const capabilityStatus = (descriptor) => ({
|
|
|
137
138
|
},
|
|
138
139
|
limitations: [...descriptor.limitations],
|
|
139
140
|
});
|
|
141
|
+
const providerOperationHealthStatus = (health) => {
|
|
142
|
+
if (health === undefined || health === null)
|
|
143
|
+
return null;
|
|
144
|
+
return {
|
|
145
|
+
state: health.state,
|
|
146
|
+
stage: health.stage,
|
|
147
|
+
retry_action: health.retryAction,
|
|
148
|
+
exit_code: health.exitCode,
|
|
149
|
+
requests: health.requests.map((request) => ({
|
|
150
|
+
request_id: request.requestId,
|
|
151
|
+
operation: request.operation,
|
|
152
|
+
stage: request.stage,
|
|
153
|
+
})),
|
|
154
|
+
};
|
|
155
|
+
};
|
|
@@ -88,6 +88,19 @@ export class CompositeProvider {
|
|
|
88
88
|
requestActivitySnapshots: () => [...clients.values()]
|
|
89
89
|
.flatMap((client) => client.requestActivitySnapshots?.() ?? [])
|
|
90
90
|
.sort((left, right) => left.provider.id.localeCompare(right.provider.id)),
|
|
91
|
+
operationHealthSnapshot: () => {
|
|
92
|
+
for (const client of clients.values()) {
|
|
93
|
+
const snapshot = client.operationHealthSnapshot?.();
|
|
94
|
+
if (snapshot !== undefined && snapshot.state !== "idle")
|
|
95
|
+
return snapshot;
|
|
96
|
+
}
|
|
97
|
+
for (const client of clients.values()) {
|
|
98
|
+
const snapshot = client.operationHealthSnapshot?.();
|
|
99
|
+
if (snapshot !== undefined)
|
|
100
|
+
return snapshot;
|
|
101
|
+
}
|
|
102
|
+
return undefined;
|
|
103
|
+
},
|
|
91
104
|
closeWithOutcome,
|
|
92
105
|
close: async () => {
|
|
93
106
|
await closeWithOutcome();
|
|
@@ -74,6 +74,9 @@ class LazyAnalysisClient {
|
|
|
74
74
|
requestActivitySnapshots() {
|
|
75
75
|
return this.#client?.requestActivitySnapshots?.() ?? [];
|
|
76
76
|
}
|
|
77
|
+
operationHealthSnapshot() {
|
|
78
|
+
return this.#client?.operationHealthSnapshot?.();
|
|
79
|
+
}
|
|
77
80
|
async close() {
|
|
78
81
|
this.#closed = true;
|
|
79
82
|
if (this.#loading === undefined)
|
|
@@ -2,7 +2,7 @@ import { isAbsolute } from "node:path";
|
|
|
2
2
|
import { AnalysisCancelledError, AnalysisInputError, AnalysisOutputError, } from "../../domain/analysisErrorCore.js";
|
|
3
3
|
import { createEvidence } from "../../domain/evidence.js";
|
|
4
4
|
import { inspectBinaryLayoutInputSchema, binaryLayoutSchema, } from "../../domain/native/binaryLayout.js";
|
|
5
|
-
import {
|
|
5
|
+
import { analysisInputErrorFromIssues } from "../../domain/inputIssueProjection.js";
|
|
6
6
|
import { err, ok } from "../../domain/result.js";
|
|
7
7
|
const OPERATION = "inspect_binary_layout";
|
|
8
8
|
/** Shared CLI/MCP validation and Evidence composition for offline layout inspection. */
|
|
@@ -17,7 +17,9 @@ export class BinaryLayoutService {
|
|
|
17
17
|
return err(new AnalysisCancelledError(OPERATION));
|
|
18
18
|
const input = inspectBinaryLayoutInputSchema.safeParse(rawInput);
|
|
19
19
|
if (!input.success)
|
|
20
|
-
return err(
|
|
20
|
+
return err(analysisInputErrorFromIssues(OPERATION, input.error.issues, rawInput, {
|
|
21
|
+
cause: input.error,
|
|
22
|
+
}));
|
|
21
23
|
if (!isAbsolute(input.data.path))
|
|
22
24
|
return err(new AnalysisInputError(OPERATION, undefined, [
|
|
23
25
|
{
|