rea-agents 6.1.0 → 6.2.0

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