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.
Files changed (343) hide show
  1. package/README.md +23 -17
  2. package/bridge/android/ReaJadxBridge.java +14 -5
  3. package/bridge/ghidra/ReaGhidraBridge.java +173 -47
  4. package/bridge/hopper_bridge.py +310 -128
  5. package/bridge/mitmproxy/capture.py +0 -2
  6. package/bridge/native/rea_lldb_tracer.py +630 -94
  7. package/bridge/process/ProcessRunTokenReader.swift +39 -5
  8. package/bridge/pwntools/recorded_crash_impl.py +4 -0
  9. package/dist/android/JadxConfiguration.js +196 -33
  10. package/dist/android/JadxMcpTransport.js +4 -0
  11. package/dist/android/JadxProtocol.js +6 -0
  12. package/dist/android/JadxProvider.js +19 -2
  13. package/dist/android/JadxSession.js +23 -4
  14. package/dist/application/AnalysisContextQueries.js +8 -35
  15. package/dist/application/AnalysisDocument.js +32 -0
  16. package/dist/application/AppBundleExecutable.js +67 -21
  17. package/dist/application/CallPathTracing.js +19 -3
  18. package/dist/application/CapabilityInventory.js +6 -3
  19. package/dist/application/ClientConfigurationDocument.js +871 -6
  20. package/dist/application/ClientRegistrationIdentity.js +26 -5
  21. package/dist/application/ClientRegistrationStatus.js +29 -14
  22. package/dist/application/DirectAnalysis.js +27 -37
  23. package/dist/application/Doctor.js +4 -2
  24. package/dist/application/DoctorScope.js +25 -13
  25. package/dist/application/EnhancedLiteralTracing.js +22 -25
  26. package/dist/application/EnhancedTools.js +13 -11
  27. package/dist/application/EvidenceBundleFiles.js +23 -11
  28. package/dist/application/FunctionAnalysisEvidence.js +2 -3
  29. package/dist/application/InventoryProjectionEvidence.js +4 -3
  30. package/dist/application/InvestigationProviders.js +3 -2
  31. package/dist/application/JsonFiles.js +50 -28
  32. package/dist/application/ProcedureAddressResolution.js +11 -0
  33. package/dist/application/ReconstructionCoverageService.js +7 -4
  34. package/dist/application/ReconstructionObligationLedgerService.js +4 -3
  35. package/dist/application/Setup.js +13 -1
  36. package/dist/application/SetupClientConfiguration.js +10 -15
  37. package/dist/application/SetupHost.js +5 -2
  38. package/dist/application/SetupPlan.js +5 -3
  39. package/dist/application/SupportedClients.js +34 -1
  40. package/dist/application/Uninstall.js +4 -3
  41. package/dist/application/Update.js +18 -3
  42. package/dist/application/UpdateRuntime.js +46 -25
  43. package/dist/application/WebModuleTraceService.js +4 -2
  44. package/dist/application/WebNetworkCaptureService.js +4 -2
  45. package/dist/application/WebRuntimeService.js +5 -3
  46. package/dist/application/WebScriptExportService.js +2 -2
  47. package/dist/application/WebSourceLocationService.js +4 -2
  48. package/dist/application/WorkflowEvidence.js +82 -0
  49. package/dist/application/binary/AnalysisProviderEvaluation.js +21 -5
  50. package/dist/application/binary/AnalysisProviderRegistry.js +2 -0
  51. package/dist/application/binary/AnalysisSnapshotCache.js +3 -6
  52. package/dist/application/binary/BinarySession.js +95 -68
  53. package/dist/application/binary/BinarySessionOpen.js +3 -3
  54. package/dist/application/binary/BinarySessionRecords.js +25 -3
  55. package/dist/application/binary/BinarySessionStatus.js +17 -1
  56. package/dist/application/binary/CompositeProvider.js +13 -0
  57. package/dist/application/binary/LazyAnalysisProvider.js +3 -0
  58. package/dist/application/binaryDiagnostics/BinaryLayoutService.js +4 -2
  59. package/dist/application/binaryDiagnostics/RecordedCrashService.js +4 -2
  60. package/dist/application/evm/EvmInterfaceService.js +4 -2
  61. package/dist/application/investigation/EvidenceLedger.js +21 -7
  62. package/dist/application/investigation/InvestigationRecords.js +8 -0
  63. package/dist/application/javascript/JavaScriptAnalysisControl.js +34 -0
  64. package/dist/application/javascript/JavaScriptApplicationEvidence.js +24 -3
  65. package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
  66. package/dist/application/javascript/JavaScriptApplicationService.js +22 -15
  67. package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
  68. package/dist/application/javascript/JavaScriptArtifactAnalysis.js +5 -4
  69. package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +39 -7
  70. package/dist/application/javascript/JavaScriptArtifactPathResolution.js +6 -3
  71. package/dist/application/javascript/JavaScriptArtifactReconstruction.js +11 -3
  72. package/dist/application/javascript/JavaScriptModuleRelationships.js +37 -8
  73. package/dist/application/javascript/JavaScriptRecoveryService.js +4 -2
  74. package/dist/application/javascript/JavaScriptRuntimeObservationService.js +3 -1
  75. package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +3 -3
  76. package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +63 -61
  77. package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +23 -1
  78. package/dist/application/managed/ManagedApplicationGraphService.js +4 -3
  79. package/dist/application/managed/ManagedMemberComparisonService.js +7 -4
  80. package/dist/application/managed/ManagedNativeVerificationService.js +4 -3
  81. package/dist/application/managed/ManagedReconstructionService.js +4 -3
  82. package/dist/application/process/ProcessCli.js +14 -6
  83. package/dist/application/process/ProcessEvidence.js +4 -3
  84. package/dist/application/workflowInputError.js +18 -0
  85. package/dist/artifacts/ArtifactProvider.js +12 -2
  86. package/dist/artifacts/MachOSliceArtifactReader.js +98 -14
  87. package/dist/artifacts/NativeDmgArtifactReader.js +13 -6
  88. package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +22 -3
  89. package/dist/artifacts/apple/InterfaceBuilderAnalysis.js +176 -56
  90. package/dist/artifacts/apple/InterfaceBuilderDecodeBudget.js +195 -0
  91. package/dist/artifacts/apple/KeyedArchiveReader.js +36 -22
  92. package/dist/artifacts/apple/MachoLoadCommandReader.js +92 -31
  93. package/dist/artifacts/apple/NibArchive.js +81 -14
  94. package/dist/artifacts/apple/NibViewHierarchy.js +10 -3
  95. package/dist/artifacts/apple/PlistNumberLiterals.js +164 -0
  96. package/dist/artifacts/inventory/ArtifactGraphConstruction.js +13 -8
  97. package/dist/artifacts/inventory/scanCanonical.js +11 -14
  98. package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
  99. package/dist/browser/CdpCaptureCompleteness.js +2 -0
  100. package/dist/browser/CdpCaptureEventHandlers.js +76 -11
  101. package/dist/browser/CdpCaptureEventTypes.js +5 -1
  102. package/dist/browser/CdpCaptureEvents.js +25 -0
  103. package/dist/browser/CdpConnection.js +30 -11
  104. package/dist/browser/CdpOptionalCommand.js +2 -3
  105. package/dist/browser/CdpPageCapture.js +23 -1
  106. package/dist/browser/PlaywrightElectronActiveActions.js +32 -23
  107. package/dist/browser/PlaywrightElectronActiveProjection.js +141 -0
  108. package/dist/browser/PlaywrightElectronActiveProvider.js +123 -124
  109. package/dist/browser/WebSourceMapFetcher.js +426 -72
  110. package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
  111. package/dist/browser/history/CaptureFailures.js +37 -1
  112. package/dist/browser/history/CaptureRelease.js +5 -0
  113. package/dist/browser/history/HarCaptureAdapter.js +3 -3
  114. package/dist/browser/history/HarJson.js +3 -2
  115. package/dist/browser/history/HistoricalCaptureDecoder.js +4 -2
  116. package/dist/cli/analysisSelector.js +23 -0
  117. package/dist/cli/applicationCommands.js +2 -3
  118. package/dist/cli/coreBinaryCommands.js +70 -12
  119. package/dist/cli/electronCommands.js +7 -6
  120. package/dist/cli/javascriptApplicationAnalysis.js +7 -3
  121. package/dist/cli/jsonOutput.js +4 -99
  122. package/dist/cli/nativeCallCommands.js +2 -3
  123. package/dist/cli/webRuntimeCommands.js +8 -8
  124. package/dist/cli.js +2 -1
  125. package/dist/cliCommandNames.js +0 -1
  126. package/dist/cliJsonInput.js +9 -4
  127. package/dist/config/environment.js +4 -0
  128. package/dist/config/ghidraStartupTimeout.js +17 -0
  129. package/dist/config/mcpResponseBudget.js +22 -0
  130. package/dist/config/parseConfig.js +2 -1
  131. package/dist/contracts/enhancedInputs.js +5 -3
  132. package/dist/contracts/enhancedToolContracts.js +3 -3
  133. package/dist/contracts/hopperMemoryContracts.js +2 -5
  134. package/dist/contracts/javascript/electronToolContracts.js +1 -1
  135. package/dist/contracts/managed/managedToolContracts.js +2 -4
  136. package/dist/contracts/native/nativeToolContracts.js +4 -2
  137. package/dist/contracts/officialToolContracts.js +14 -15
  138. package/dist/contracts/promptContracts.js +3 -3
  139. package/dist/contracts/sessionLifecycleInputs.js +3 -7
  140. package/dist/contracts/sessionStatusContract.js +2 -4
  141. package/dist/contracts/sessionToolContracts.js +4 -6
  142. package/dist/contracts/sessionToolSchemas.js +2 -5
  143. package/dist/contracts/toolContractExamples.js +0 -1
  144. package/dist/contracts/toolContractHelpers.js +4 -1
  145. package/dist/contracts/toolEffects.js +0 -1
  146. package/dist/contracts/toolOutputSchemaGroups.js +28 -27
  147. package/dist/contracts/toolOutputSchemaPrimitives.js +18 -0
  148. package/dist/contracts/toolSchemaMetadata.js +69 -10
  149. package/dist/contracts/webNetworkCaptureToolContracts.js +1 -1
  150. package/dist/domain/analysisErrorBase.js +8 -3
  151. package/dist/domain/analysisErrorCore.js +3 -1
  152. package/dist/domain/analysisErrorPresentation.js +72 -17
  153. package/dist/domain/analysisErrorProjection.js +106 -27
  154. package/dist/domain/android/androidAnalysis.js +2 -4
  155. package/dist/domain/android/androidApplication.js +17 -9
  156. package/dist/domain/apple/appleApplication.js +41 -14
  157. package/dist/domain/apple/dyldEnvironment.js +73 -0
  158. package/dist/domain/apple/dylibResolution.js +120 -9
  159. package/dist/domain/apple/dylibResolutionFindings.js +9 -7
  160. package/dist/domain/apple/interfaceBuilderGraph.js +25 -13
  161. package/dist/domain/apple/interfaceBuilderKeyedArchive.js +13 -3
  162. package/dist/domain/apple/keyedArchive.js +9 -1
  163. package/dist/domain/apple/machoContainer.js +54 -0
  164. package/dist/domain/apple/plistNumbers.js +76 -0
  165. package/dist/domain/artifactIdentity.js +29 -0
  166. package/dist/domain/artifactInventoryEvidence.js +19 -24
  167. package/dist/domain/bridgeCandidateProjection.js +71 -0
  168. package/dist/domain/browserCompleteness.js +1 -0
  169. package/dist/domain/browserObservationError.js +24 -5
  170. package/dist/domain/browserScenarioValues.js +2 -6
  171. package/dist/domain/bundleComparison.js +3 -2
  172. package/dist/domain/canonicalJsonDigestSteps.js +133 -0
  173. package/dist/domain/canonicalOrdering.js +9 -5
  174. package/dist/domain/changedBehavior.js +6 -6
  175. package/dist/domain/comparisonSourceEvidence.js +40 -0
  176. package/dist/domain/configurationErrors.js +1 -1
  177. package/dist/domain/evidence.js +64 -9
  178. package/dist/domain/evidenceBundle.js +42 -1
  179. package/dist/domain/evidenceErrors.js +12 -1
  180. package/dist/domain/explicitSensitiveFailure.js +17 -1
  181. package/dist/domain/firmware/firmwareAnalysis.js +6 -7
  182. package/dist/domain/hopperErrors.js +23 -2
  183. package/dist/domain/hopperValues.js +51 -8
  184. package/dist/domain/immutableJson.js +114 -0
  185. package/dist/domain/inputIssueProjection.js +3 -0
  186. package/dist/domain/javascript/electronActiveObservation.js +30 -4
  187. package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
  188. package/dist/domain/javascript/javascriptApplicationAnalysis.js +71 -23
  189. package/dist/domain/javascript/javascriptApplicationGraph.js +13 -0
  190. package/dist/domain/javascript/javascriptAstValues.js +20 -0
  191. package/dist/domain/javascript/javascriptRecovery.js +3 -8
  192. package/dist/domain/javascript/javascriptSemanticAnalysis.js +97 -2
  193. package/dist/domain/javascript/javascriptSemanticCoverage.js +6 -5
  194. package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +9 -17
  195. package/dist/domain/javascript/javascriptSemanticDataEffects.js +22 -5
  196. package/dist/domain/javascript/javascriptSemanticGraph.js +13 -0
  197. package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +1 -0
  198. package/dist/domain/javascript/javascriptSemanticPrimitives.js +25 -17
  199. package/dist/domain/javascript/javascriptSemanticQuerySchemas.js +8 -4
  200. package/dist/domain/javascript/javascriptSemanticResourceLimits.js +77 -0
  201. package/dist/domain/javascript/javascriptSemanticValues.js +83 -11
  202. package/dist/domain/javascript/javascriptSourceParser.js +6 -2
  203. package/dist/domain/javascript/javascriptStaticAnalysis.js +22 -17
  204. package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +5 -3
  205. package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +14 -4
  206. package/dist/domain/javascript/javascriptStaticAnalysisFindings.js +66 -7
  207. package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +28 -16
  208. package/dist/domain/javascript/javascriptStaticAnalysisState.js +3 -2
  209. package/dist/domain/jsonSerialization.js +109 -0
  210. package/dist/domain/jsonValue.js +90 -6
  211. package/dist/domain/localPath.js +6 -0
  212. package/dist/domain/managed/managedApplicationGraph.js +10 -10
  213. package/dist/domain/managed/managedInspectionEvidence.js +16 -0
  214. package/dist/domain/managed/managedMemberComparisonMatch.js +5 -9
  215. package/dist/domain/managed/managedNativeVerification.js +3 -9
  216. package/dist/domain/native/fileOffsetPartialObservation.js +1 -0
  217. package/dist/domain/native/nativeCallObservation.js +33 -11
  218. package/dist/domain/native/nativeCallPartialObservation.js +33 -0
  219. package/dist/domain/process/processCapture.js +8 -4
  220. package/dist/domain/process/processComparison.js +38 -4
  221. package/dist/domain/process/processScenario.js +11 -10
  222. package/dist/domain/propertyListKeys.js +1 -1
  223. package/dist/domain/propertyListXmlText.js +19 -0
  224. package/dist/domain/providerAdapterError.js +1 -1
  225. package/dist/domain/providerOperationHealth.js +54 -0
  226. package/dist/domain/reconstructionVerification.js +6 -43
  227. package/dist/domain/reconstructionVerificationSchemas.js +2 -2
  228. package/dist/domain/staticRuntimeCorrelation.js +6 -43
  229. package/dist/domain/webBundleAnalysis.js +20 -8
  230. package/dist/domain/webBundleAnalyzerInspection.js +13 -8
  231. package/dist/domain/webBundleAnalyzerResult.js +41 -2
  232. package/dist/domain/webRuntime.js +19 -5
  233. package/dist/domain/webSourceLocation.js +1 -0
  234. package/dist/firmware/FirmwareFiles.js +1 -1
  235. package/dist/generatedPackageMetadata.js +1 -1
  236. package/dist/ghidra/GhidraAnalysisProfile.js +5 -0
  237. package/dist/ghidra/GhidraClient.js +47 -14
  238. package/dist/ghidra/GhidraDiagnostics.js +7 -7
  239. package/dist/ghidra/GhidraFunctionValues.js +10 -7
  240. package/dist/ghidra/GhidraInstallation.js +18 -21
  241. package/dist/ghidra/GhidraInventoryValues.js +14 -4
  242. package/dist/ghidra/GhidraJavaLaunch.js +62 -0
  243. package/dist/ghidra/GhidraLauncher.js +33 -16
  244. package/dist/ghidra/GhidraProviderCapabilities.js +14 -2
  245. package/dist/ghidra/GhidraProviderClient.js +23 -12
  246. package/dist/ghidra/GhidraSessionError.js +11 -7
  247. package/dist/ghidra/GhidraTargetSnapshot.js +47 -12
  248. package/dist/ghidra/GhidraTransport.js +20 -0
  249. package/dist/hopper/BridgeLauncher.js +31 -11
  250. package/dist/hopper/HopperAnalysisProfile.js +62 -4
  251. package/dist/hopper/HopperCleanup.js +15 -3
  252. package/dist/hopper/HopperClient.js +222 -14
  253. package/dist/hopper/HopperFileOffset.js +237 -0
  254. package/dist/hopper/HopperMachOImage.js +196 -0
  255. package/dist/hopper/HopperOperationStage.js +6 -0
  256. package/dist/hopper/HopperProvider.js +63 -9
  257. package/dist/hopper/HopperProviderCapabilities.js +19 -1
  258. package/dist/hopper/HopperRegexSearch.js +137 -0
  259. package/dist/hopper/HopperRegexWorker.js +27 -0
  260. package/dist/hopper/HopperRequestQueue.js +68 -19
  261. package/dist/hopper/HopperTargetLease.js +3 -2
  262. package/dist/inspector/JavaScriptRuntimeScope.js +9 -1
  263. package/dist/inspector/V8InspectorCaptureProjection.js +8 -3
  264. package/dist/inspector/V8InspectorProvider.js +47 -11
  265. package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
  266. package/dist/javascript/sourceMaps/SourceMapCommand.js +16 -0
  267. package/dist/javascript/sourceMaps/SourceMapFormat.js +79 -31
  268. package/dist/javascript/sourceMaps/TraceSourceMap.js +14 -28
  269. package/dist/mcpDoctor.js +62 -2
  270. package/dist/native/AppleDispatchCoverage.js +47 -6
  271. package/dist/native/AppleDispatchDecodeFacts.js +6 -0
  272. package/dist/native/AppleDispatchMetadata.js +6 -3
  273. package/dist/native/AppleMachoFixups.js +48 -24
  274. package/dist/native/AppleMachoSelection.js +32 -16
  275. package/dist/native/AppleObjcCategories.js +6 -2
  276. package/dist/native/AppleObjcDispatchFacets.js +5 -2
  277. package/dist/native/AppleObjcProperties.js +2 -1
  278. package/dist/native/AppleSwiftDispatchFacets.js +27 -21
  279. package/dist/native/AppleSwiftVtables.js +21 -15
  280. package/dist/native/CommandRunner.js +81 -84
  281. package/dist/native/LldbCallTracer.js +365 -102
  282. package/dist/native/LldbRetainedObservations.js +178 -0
  283. package/dist/native/NativeCallObservation.js +62 -3
  284. package/dist/native/NativeMacOSProvider.js +98 -17
  285. package/dist/native/SignatureTargetBinding.js +155 -0
  286. package/dist/native/parsers/lipo.js +71 -1
  287. package/dist/native/pwndbg/PwndbgCoreContext.js +25 -5
  288. package/dist/native/pwntools/RecordedCrashStructureBindings.js +2 -0
  289. package/dist/process/DarwinProcessRunTokenReader.js +8 -9
  290. package/dist/process/ExecFileOutput.js +20 -0
  291. package/dist/process/OwnedCommand.js +7 -2
  292. package/dist/process/ProcessOwnership.js +203 -53
  293. package/dist/process/ProcessOwnershipObservation.js +49 -4
  294. package/dist/process/ProviderProcess.js +38 -7
  295. package/dist/process/capture/ProcessCaptureError.js +2 -2
  296. package/dist/process/capture/ProcessCaptureLifecycle.js +100 -34
  297. package/dist/server/EvidenceMcpServer.js +146 -0
  298. package/dist/server/createServer.js +15 -8
  299. package/dist/server/registerAndroidTools.js +2 -4
  300. package/dist/server/registerApplicationTools/helpers.js +2 -4
  301. package/dist/server/registerArtifactComparisonTool.js +11 -7
  302. package/dist/server/registerBinaryDiagnosticsTools.js +2 -4
  303. package/dist/server/registerBrowserScenarioTool.js +2 -4
  304. package/dist/server/registerBrowserTools.js +2 -4
  305. package/dist/server/registerBundleComparisonTool.js +2 -3
  306. package/dist/server/registerCloseLifecycleTool.js +8 -18
  307. package/dist/server/registerElectronTools.js +2 -4
  308. package/dist/server/registerEnhancedTools.js +18 -59
  309. package/dist/server/registerEvidenceTools.js +2 -4
  310. package/dist/server/registerEvmTools.js +2 -4
  311. package/dist/server/registerFirmwareTools.js +2 -4
  312. package/dist/server/registerFunctionComparisonTool.js +10 -6
  313. package/dist/server/registerInvestigationTools.js +7 -7
  314. package/dist/server/registerJavaScriptRecoveryTool.js +2 -4
  315. package/dist/server/registerJavaScriptRuntimeObservationTools.js +2 -4
  316. package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +2 -4
  317. package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +2 -4
  318. package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +2 -4
  319. package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +2 -4
  320. package/dist/server/registerOfficialTools.js +2 -4
  321. package/dist/server/registerProcessComparisonTool.js +71 -45
  322. package/dist/server/registerRecordedCrashTools.js +2 -4
  323. package/dist/server/registerSessionRecordTools.js +5 -6
  324. package/dist/server/registerSessionStatusTool.js +17 -3
  325. package/dist/server/registerSessionTools.js +11 -3
  326. package/dist/server/registerWebModuleTool.js +2 -4
  327. package/dist/server/registerWebNetworkCaptureTool.js +2 -4
  328. package/dist/server/registerWebRuntimeTools.js +3 -7
  329. package/dist/server/registerWebScriptTool.js +2 -4
  330. package/dist/server/registerWebSourceLocationTool.js +2 -4
  331. package/dist/server/runDerivedOperation.js +15 -3
  332. package/dist/server/sessionAvailabilityPolicy.js +0 -1
  333. package/dist/server/toolRegistrationOptions.js +2 -2
  334. package/dist/server/toolResult.js +62 -10
  335. package/dist/server/toolResultEncoding.js +33 -0
  336. package/install.sh +1 -1
  337. package/native/windows/build/manifest.json +1 -1
  338. package/package.json +8 -3
  339. package/scripts/electron-active-hook-boundaries.cjs +18 -20
  340. package/scripts/electron-active-hook.cjs +241 -37
  341. package/skills/reverse-engineer-anything/SKILL.md +11 -3
  342. package/skills/reverse-engineer-anything/references/javascript-applications.md +8 -1
  343. 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 { projectInputIssues } from "../domain/inputIssueProjection.js";
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(new AnalysisInputError(OPERATION, { cause: parsed.error }, projectInputIssues(parsed.error.issues, rawInput)));
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
- return ok(rejectedProfile(candidate, status, resolved.error.message, {
27
- error_tag: resolved.error._tag,
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 EvidenceIntegrityError("Analysis snapshot profile_mismatch: target, provider, or analysis profile does not match the active binary"));
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
- #calls = new Set();
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
- const previous = this.#active;
207
- this.#active = undefined;
208
- await this.#drainCalls();
209
- const closed = previous === undefined
210
- ? ok(null)
211
- : await closeAnalysisClient(previous.client, previous.route.identity.id, {
212
- ...(options.progress === undefined
213
- ? {}
214
- : { progress: options.progress }),
215
- ...(options.retainProviderDocuments === true
216
- ? { retainDocument: true }
217
- : {}),
218
- });
219
- this.clearSessionRecords();
220
- this.#clearRuntimeAvailability();
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
- async execute(name, arguments_, options) {
251
- const transitioned = await this.#waitForTransition(name, options?.signal);
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
- this.#calls.add(call);
273
- try {
274
- const result = await call;
275
- const profiled = bindExecutionTarget(commitExecutionProfile(name, result, profile), name, active.target);
276
- this.#observeRuntimeAvailability(name, profiled);
277
- if (profiled.ok &&
278
- cacheable &&
279
- profile !== undefined &&
280
- name !== "decode_interface_builder" &&
281
- name !== "inspect_asset_catalog" &&
282
- name !== "inspect_keyed_archive" &&
283
- name !== "trace_dylib_resolution") {
284
- const evidence = createEvidence(profiled.value.subject ?? active.target, profiled.value.provider, {
285
- operation: name,
286
- parameters: arguments_,
287
- result: profiled.value.result,
288
- analysisProfile: profile,
289
- rawResult: profiled.value.rawResult,
290
- limitations: profiled.value.limitations,
291
- locations: profiled.value.locations,
292
- });
293
- const recorded = this.recordEvidence(evidence);
294
- if (!recorded.ok)
295
- return recorded;
296
- this.recordSnapshot({
297
- target: active.target,
298
- profile,
299
- operation: name,
300
- parameters: arguments_,
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
- finally {
310
- this.#calls.delete(call);
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
- const result = this.#transition.then(operation, operation);
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 this.#transition;
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
- this.#transition.then(() => {
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 EvidenceIntegrityError("Analysis snapshot profile_mismatch: target, provider, or analysis profile does not match the requested binary");
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 EvidenceIntegrityError("Analysis snapshot profile_mismatch: staged target, provider, or analysis profile does not match");
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 EvidenceIntegrityError("Analysis snapshot profile_mismatch: the active target has no concrete analysis profile"));
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 { projectInputIssues } from "../../domain/inputIssueProjection.js";
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(new AnalysisInputError(OPERATION, { cause: input.error }, projectInputIssues(input.error.issues, rawInput)));
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
  {