rea-agents 6.1.0 → 6.3.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 (573) hide show
  1. package/README.md +24 -24
  2. package/bridge/ghidra/ReaGhidraBridge.java +32 -4
  3. package/bridge/hopper_bridge.py +8 -1
  4. package/dist/android/JadxConfiguration.js +87 -7
  5. package/dist/android/JadxMcpTransport.js +14 -2
  6. package/dist/android/JadxProvider.js +64 -36
  7. package/dist/android/JadxSession.js +51 -9
  8. package/dist/application/BinaryTargetResolver.js +68 -20
  9. package/dist/application/BrowserEvidence.js +3 -8
  10. package/dist/application/BrowserScenarioEvidence.js +4 -20
  11. package/dist/application/CapabilityInventory.js +43 -9
  12. package/dist/application/ClientConfigurationDocument.js +97 -25
  13. package/dist/application/ClientRegistrationStatus.js +19 -6
  14. package/dist/application/DirectAnalysis.js +41 -20
  15. package/dist/application/DirectAnalysisCleanup.js +71 -0
  16. package/dist/application/DirectAnalysisStatus.js +3 -7
  17. package/dist/application/Doctor.js +40 -53
  18. package/dist/application/DoctorDiagnostics.js +2 -3
  19. package/dist/application/EnhancedTools.js +51 -6
  20. package/dist/application/EvidenceBundleFiles.js +8 -3
  21. package/dist/application/InvestigationProviders.js +13 -5
  22. package/dist/application/JsonFiles.js +56 -23
  23. package/dist/application/LinuxHopper.js +11 -7
  24. package/dist/application/MacHopper.js +15 -18
  25. package/dist/application/RealHopperAssertions.js +0 -11
  26. package/dist/application/ReconstructionObligationCandidates.js +10 -3
  27. package/dist/application/ReconstructionObligationLedgerProjection.js +3 -1
  28. package/dist/application/ReferenceSourceImportEntries.js +1 -1
  29. package/dist/application/RegularFileRead.js +17 -0
  30. package/dist/application/Setup.js +26 -23
  31. package/dist/application/SetupClientConfiguration.js +18 -7
  32. package/dist/application/SetupHost.js +20 -29
  33. package/dist/application/SetupPlan.js +24 -20
  34. package/dist/application/SetupSkill.js +57 -8
  35. package/dist/application/SupportedClients.js +43 -0
  36. package/dist/application/Uninstall.js +98 -30
  37. package/dist/application/UpdateMaintenance.js +13 -7
  38. package/dist/application/UpdateRuntime.js +12 -12
  39. package/dist/application/Utf8JsonInput.js +64 -0
  40. package/dist/application/WebScriptExportService.js +38 -5
  41. package/dist/application/WorkflowEvidence.js +25 -2
  42. package/dist/application/XrefsAddressResolution.js +45 -0
  43. package/dist/application/analysisView/AnalysisViewService.js +76 -0
  44. package/dist/application/android/AndroidAnalysisService.js +1 -1
  45. package/dist/application/binary/AnalysisClientCleanup.js +30 -5
  46. package/dist/application/binary/AnalysisProviderEvaluation.js +1 -2
  47. package/dist/application/binary/AnalysisProviderRegistry.js +2 -6
  48. package/dist/application/binary/AnalysisSnapshotCache.js +13 -10
  49. package/dist/application/binary/BinarySession.js +86 -29
  50. package/dist/application/binary/BinarySessionComposition.js +1 -3
  51. package/dist/application/binary/BinarySessionExecution.js +3 -5
  52. package/dist/application/binary/BinarySessionOpen.js +10 -2
  53. package/dist/application/binary/BinarySessionRecords.js +1 -1
  54. package/dist/application/binary/BinarySessionStatus.js +1 -6
  55. package/dist/application/binary/CompositeProvider.js +4 -18
  56. package/dist/application/binary/LazyAnalysisProvider.js +5 -5
  57. package/dist/application/binary/SessionProviderRouter.js +27 -135
  58. package/dist/application/homebrew.js +48 -0
  59. package/dist/application/javascript/ElectronActiveEvidence.js +10 -14
  60. package/dist/application/javascript/ElectronBoundaryAnalysis.js +2 -2
  61. package/dist/application/javascript/ElectronBoundaryGraphNative.js +5 -1
  62. package/dist/application/javascript/JavaScriptApplicationEvidence.js +3 -6
  63. package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +107 -46
  64. package/dist/application/javascript/JavaScriptApplicationService.js +7 -1
  65. package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +59 -45
  66. package/dist/application/javascript/JavaScriptArtifactAnalysis.js +5 -9
  67. package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +19 -27
  68. package/dist/application/javascript/JavaScriptArtifactGraphBundlers.js +11 -3
  69. package/dist/application/javascript/JavaScriptArtifactGraphContext.js +9 -0
  70. package/dist/application/javascript/JavaScriptArtifactGraphDocuments.js +8 -5
  71. package/dist/application/javascript/JavaScriptArtifactGraphFindings.js +46 -29
  72. package/dist/application/javascript/JavaScriptArtifactGraphStructure.js +0 -1
  73. package/dist/application/javascript/JavaScriptArtifactPathResolution.js +86 -27
  74. package/dist/application/javascript/JavaScriptArtifactReconstruction.js +52 -9
  75. package/dist/application/javascript/JavaScriptArtifactReconstructionInput.js +1 -0
  76. package/dist/application/javascript/JavaScriptJsonModules.js +2 -2
  77. package/dist/application/javascript/JavaScriptModuleRelationships.js +6 -18
  78. package/dist/application/javascript/JavaScriptRuntimeObservationService.js +3 -3
  79. package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +11 -27
  80. package/dist/application/javascript/JavaScriptSemanticGraphAsyncProjection.js +4 -5
  81. package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +8 -6
  82. package/dist/application/javascript/JavaScriptSemanticGraphChildProcessProjection.js +2 -3
  83. package/dist/application/javascript/JavaScriptSemanticGraphConstruction.js +7 -5
  84. package/dist/application/javascript/JavaScriptSemanticGraphDataProjection.js +3 -4
  85. package/dist/application/javascript/JavaScriptSemanticGraphEvidence.js +1 -1
  86. package/dist/application/javascript/JavaScriptSemanticGraphFingerprintProjection.js +2 -2
  87. package/dist/application/javascript/JavaScriptSemanticGraphFlowProjection.js +3 -7
  88. package/dist/application/javascript/JavaScriptSemanticGraphObjectProjection.js +76 -47
  89. package/dist/application/javascript/JavaScriptSemanticGraphProjection.js +4 -4
  90. package/dist/application/javascript/JavaScriptSemanticGraphResourceProjection.js +3 -4
  91. package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +51 -25
  92. package/dist/application/javascript/JavaScriptSemanticTraceService.js +15 -10
  93. package/dist/application/managed/ManagedMemberComparisonService.js +2 -1
  94. package/dist/application/managed/ManagedNativeVerificationService.js +2 -1
  95. package/dist/application/native/NativeCallRoutes.js +2 -4
  96. package/dist/application/process/ProcessCli.js +11 -11
  97. package/dist/application/process/ProcessEvidence.js +0 -1
  98. package/dist/artifacts/ArtifactProvider.js +53 -30
  99. package/dist/artifacts/ArtifactProviderMetadata.js +1 -4
  100. package/dist/artifacts/ArtifactReader.js +31 -0
  101. package/dist/artifacts/AsarArtifactReader.js +81 -17
  102. package/dist/artifacts/DirectoryArtifactReader.js +2 -1
  103. package/dist/artifacts/MachOSliceArtifactReader.js +9 -2
  104. package/dist/artifacts/NativeDmgArtifactReader.js +207 -77
  105. package/dist/artifacts/NativeDmgOwnership.js +109 -0
  106. package/dist/artifacts/SafeOutputTree.js +16 -2
  107. package/dist/artifacts/ZipArtifactReader.js +11 -4
  108. package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +4 -2
  109. package/dist/artifacts/apple/DylibResolutionReader.js +17 -7
  110. package/dist/artifacts/apple/KeyedArchiveReader.js +68 -42
  111. package/dist/artifacts/apple/MachoLoadCommandReader.js +36 -6
  112. package/dist/artifacts/extraction/ArtifactExtraction.js +104 -29
  113. package/dist/artifacts/inventory/ArtifactGraphConstruction.js +71 -66
  114. package/dist/artifacts/inventory/ArtifactInventory.js +0 -1
  115. package/dist/artifacts/inventory/classify.js +33 -14
  116. package/dist/artifacts/inventory/hashStableRootArtifact.js +37 -0
  117. package/dist/artifacts/inventory/reader.js +3 -3
  118. package/dist/artifacts/inventory/scanCanonical.js +64 -34
  119. package/dist/artifacts/inventory/scanReader.js +12 -20
  120. package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +65 -27
  121. package/dist/browser/BrowserScenarioPartialObservation.js +106 -0
  122. package/dist/browser/CdpBrowserProvider.js +6 -6
  123. package/dist/browser/CdpCaptureEventHandlers.js +2 -4
  124. package/dist/browser/CdpCaptureEvents.js +0 -1
  125. package/dist/browser/CdpCaptureStorageFingerprints.js +3 -3
  126. package/dist/browser/CdpCaptureValues.js +20 -0
  127. package/dist/browser/CdpElectronInspection.js +2 -2
  128. package/dist/browser/CdpElectronProvider.js +4 -5
  129. package/dist/browser/CdpElectronScriptEvents.js +2 -8
  130. package/dist/browser/CdpElectronScripts.js +4 -5
  131. package/dist/browser/CdpPageCaptureScripts.js +2 -3
  132. package/dist/browser/CdpSafeMetadata.js +10 -10
  133. package/dist/browser/CdpWebMcpDiscovery.js +16 -13
  134. package/dist/browser/PlaywrightBrowserScenarioProvider.js +64 -49
  135. package/dist/browser/PlaywrightElectronActiveActions.js +2 -56
  136. package/dist/browser/PlaywrightElectronActiveProvider.js +10 -6
  137. package/dist/browser/PlaywrightScenarioArtifacts.js +1 -1
  138. package/dist/browser/PlaywrightScenarioBrowser.js +269 -66
  139. package/dist/browser/PlaywrightScenarioEvents.js +1 -1
  140. package/dist/browser/PlaywrightScenarioSession.js +41 -32
  141. package/dist/browser/WebSourceMapFetcher.js +32 -6
  142. package/dist/browser/assets/ScenarioScriptCapture.js +8 -12
  143. package/dist/browser/assets/ScriptCaptureAdapters.js +1 -1
  144. package/dist/browser/history/CaptureFailures.js +6 -2
  145. package/dist/browser/history/MitmproxyCaptureAdapter.js +4 -2
  146. package/dist/catalogIdentity.js +0 -1
  147. package/dist/cli/analysisViewCommands.js +36 -0
  148. package/dist/cli/artifactCommands.js +11 -12
  149. package/dist/cli/coreAnalysisCommands.js +3 -3
  150. package/dist/cli/coreBinaryCommands.js +37 -28
  151. package/dist/cli/coreNativeCommands.js +9 -10
  152. package/dist/cli/electronCommands.js +12 -13
  153. package/dist/cli/interactiveSetup.js +6 -6
  154. package/dist/cli/javascriptApplicationAnalysis.js +2 -12
  155. package/dist/cli/jsonOutput.js +3 -2
  156. package/dist/cli/managedCommands.js +7 -8
  157. package/dist/cli/nativeCallCommands.js +1 -2
  158. package/dist/cli/omittableDefaults.js +50 -0
  159. package/dist/cli/processCommands.js +3 -2
  160. package/dist/cli/setupCommands.js +16 -15
  161. package/dist/cli/streamedJsonOutput.js +83 -4
  162. package/dist/cli/utilityCommands.js +10 -12
  163. package/dist/cli.js +19 -8
  164. package/dist/cliBrowserScenarioCommands.js +2 -2
  165. package/dist/cliCommandNames.js +1 -0
  166. package/dist/cliJsonFile.js +179 -0
  167. package/dist/cliJsonInput.js +60 -33
  168. package/dist/cliObservationOptions.js +4 -0
  169. package/dist/cliOutput.js +0 -38
  170. package/dist/composition/auxiliaryAnalysisProviders.js +30 -25
  171. package/dist/composition/binary.js +9 -9
  172. package/dist/composition/browserScenario.js +2 -1
  173. package/dist/composition/directAnalysis.js +20 -14
  174. package/dist/composition/electronScenario.js +1 -1
  175. package/dist/composition/optionalObservationProviders.js +12 -7
  176. package/dist/config/environment.js +6 -0
  177. package/dist/config/ghidraStartupTimeout.js +4 -9
  178. package/dist/config/homeDirectory.js +12 -0
  179. package/dist/config/mcpResponseBudget.js +9 -1
  180. package/dist/config/parseConfig.js +7 -3
  181. package/dist/config/parsers.js +19 -22
  182. package/dist/contracts/analysisViewToolContracts.js +56 -0
  183. package/dist/contracts/applicationToolContracts.js +5 -4
  184. package/dist/contracts/artifactComparisonExample.js +7 -7
  185. package/dist/contracts/artifactToolContracts.js +1 -1
  186. package/dist/contracts/browserScenarioToolContracts.js +1 -1
  187. package/dist/contracts/browserToolContracts.js +19 -15
  188. package/dist/contracts/enhancedInputs.js +2 -2
  189. package/dist/contracts/enhancedToolContracts.js +4 -3
  190. package/dist/contracts/errorSchemas.js +3 -1
  191. package/dist/contracts/evm/evmToolContracts.js +1 -1
  192. package/dist/contracts/functionComparisonExample.js +8 -0
  193. package/dist/contracts/functionWorkflowToolContracts.js +1 -1
  194. package/dist/contracts/inputSchemaPresentation.js +181 -0
  195. package/dist/contracts/investigationExamples.js +4 -3
  196. package/dist/contracts/javascript/electronToolContracts.js +3 -2
  197. package/dist/contracts/javascript/javascriptApplicationWorkflowExamples.js +3 -22
  198. package/dist/contracts/javascript/javascriptExportShapeComparisonExample.js +248 -0
  199. package/dist/contracts/javascript/javascriptRuntimeObservationToolContracts.js +1 -1
  200. package/dist/contracts/javascript/javascriptRuntimeReconciliationExample.js +8 -7
  201. package/dist/contracts/managed/managedToolContracts.js +8 -12
  202. package/dist/contracts/managed/managedWorkflowToolContracts.js +1 -1
  203. package/dist/contracts/mobileApplicationGraphExamples.js +8 -8
  204. package/dist/contracts/native/binaryDiagnosticsToolContracts.js +1 -1
  205. package/dist/contracts/native/nativeToolContracts.js +2 -2
  206. package/dist/contracts/officialToolContracts.js +2 -1
  207. package/dist/contracts/promptContracts.js +2 -2
  208. package/dist/contracts/providerSelection.js +1 -1
  209. package/dist/contracts/sessionLifecycleInputs.js +4 -3
  210. package/dist/contracts/sessionStatusContract.js +3 -2
  211. package/dist/contracts/sessionToolContracts.js +17 -4
  212. package/dist/contracts/sessionToolSchemas.js +4 -16
  213. package/dist/contracts/toolContracts.js +2 -0
  214. package/dist/contracts/toolEffects.js +1 -0
  215. package/dist/contracts/toolOutputSchemaGroups.js +138 -94
  216. package/dist/contracts/toolOutputSchemaPrimitives.js +13 -26
  217. package/dist/contracts/toolSchemaMetadata.js +18 -69
  218. package/dist/contracts/webNetworkCaptureToolContracts.js +1 -1
  219. package/dist/contracts/webRuntimeToolContracts.js +1 -1
  220. package/dist/contracts/webScriptToolContracts.js +1 -1
  221. package/dist/doctorRuntime.js +7 -5
  222. package/dist/domain/analysisErrorBase.js +5 -0
  223. package/dist/domain/analysisErrorCore.js +3 -0
  224. package/dist/domain/analysisErrorPresentation.js +22 -5
  225. package/dist/domain/analysisErrorProjection.js +24 -5
  226. package/dist/domain/analysisSnapshot.js +31 -31
  227. package/dist/domain/analysisView/analysisView.js +241 -0
  228. package/dist/domain/analysisView/analysisViewCoverage.js +19 -0
  229. package/dist/domain/analysisView/binaryLayoutView.js +159 -0
  230. package/dist/domain/analysisView/javascriptApplicationView.js +238 -0
  231. package/dist/domain/android/androidApplication.js +1 -1
  232. package/dist/domain/android/androidPartialObservation.js +36 -0
  233. package/dist/domain/apple/appleApplication.js +1 -1
  234. package/dist/domain/apple/dylibResolution.js +10 -3
  235. package/dist/domain/apple/interfaceBuilderGraph.js +0 -1
  236. package/dist/domain/apple/keyedArchive.js +26 -2
  237. package/dist/domain/artifactComparison.js +15 -6
  238. package/dist/domain/artifactGraph.js +17 -4
  239. package/dist/domain/artifactIdentity.js +8 -8
  240. package/dist/domain/artifactInspection.js +8 -8
  241. package/dist/domain/artifactInventoryEvidence.js +9 -16
  242. package/dist/domain/artifactOperationError.js +3 -3
  243. package/dist/domain/artifactPartialObservation.js +1 -0
  244. package/dist/domain/artifactPathSyntax.js +49 -0
  245. package/dist/domain/binaryTarget.js +39 -13
  246. package/dist/domain/browserCaptureComparison.js +13 -49
  247. package/dist/domain/browserCompleteness.js +3 -2
  248. package/dist/domain/browserNetworkEvidence.js +10 -4
  249. package/dist/domain/browserObservation.js +0 -1
  250. package/dist/domain/browserObservationSchemas.js +14 -3
  251. package/dist/domain/browserScenario.js +0 -1
  252. package/dist/domain/browserScenarioCapture.js +1 -2
  253. package/dist/domain/browserScenarioCaptureValues.js +2 -2
  254. package/dist/domain/browserScenarioDiff.js +0 -2
  255. package/dist/domain/browserScenarioDiffEvidence.js +0 -12
  256. package/dist/domain/browserScenarioDiffValues.js +2 -2
  257. package/dist/domain/browserScenarioNormalization.js +3 -3
  258. package/dist/domain/browserScenarioValues.js +6 -6
  259. package/dist/domain/callPath.js +15 -18
  260. package/dist/domain/callPathSchemas.js +2 -2
  261. package/dist/domain/canonicalDigest.js +7 -1
  262. package/dist/domain/canonicalOrdering.js +1 -13
  263. package/dist/domain/changedBehavior.js +5 -6
  264. package/dist/domain/comparisonSemantics.js +0 -5
  265. package/dist/domain/completionLedgerGeneration.js +2 -1
  266. package/dist/domain/configurationErrors.js +12 -0
  267. package/dist/domain/conformancePackage.js +4 -3
  268. package/dist/domain/digests.js +0 -3
  269. package/dist/domain/evidence.js +19 -40
  270. package/dist/domain/evidenceBundle.js +58 -42
  271. package/dist/domain/evidenceCompletionLedger.js +2 -1
  272. package/dist/domain/firmware/firmwareAnalysis.js +4 -3
  273. package/dist/domain/functionComparison.js +6 -6
  274. package/dist/domain/functionComparisonDimensions.js +120 -87
  275. package/dist/domain/functionComparisonNormalization.js +26 -36
  276. package/dist/domain/functionComparisonResults.js +3 -6
  277. package/dist/domain/functionComparisonSchemas.js +2 -8
  278. package/dist/domain/functionDossierEvidence.js +4 -38
  279. package/dist/domain/hopperValues.js +11 -15
  280. package/dist/domain/javascript/electronActiveObservation.js +29 -71
  281. package/dist/domain/javascript/electronObservation.js +14 -3
  282. package/dist/domain/javascript/electronStaticAnalysisBrowser.js +12 -11
  283. package/dist/domain/javascript/electronStaticAnalysisIpc.js +11 -2
  284. package/dist/domain/javascript/electronStaticAnalysisNative.js +7 -4
  285. package/dist/domain/javascript/electronStaticAnalysisValues.js +8 -4
  286. package/dist/domain/javascript/javascriptApplicationAnalysis.js +3 -1
  287. package/dist/domain/javascript/javascriptApplicationChangeGraph.js +12 -8
  288. package/dist/domain/javascript/javascriptApplicationEvidenceSchemas.js +6 -0
  289. package/dist/domain/javascript/javascriptApplicationGraph.js +41 -16
  290. package/dist/domain/javascript/javascriptApplicationGraphSchemas.js +9 -2
  291. package/dist/domain/javascript/javascriptApplicationVersionComparison.js +4 -4
  292. package/dist/domain/javascript/javascriptApplicationVersionComparisonSchemas.js +37 -22
  293. package/dist/domain/javascript/javascriptApplicationVersionItems.js +50 -36
  294. package/dist/domain/javascript/javascriptApplicationVersionKeys.js +9 -8
  295. package/dist/domain/javascript/javascriptAstFingerprint.js +2 -2
  296. package/dist/domain/javascript/javascriptAstValues.js +22 -0
  297. package/dist/{application/javascript/JavaScriptReturnShapeProjection.js → domain/javascript/javascriptExportReturnShapeProjection.js} +4 -4
  298. package/dist/domain/javascript/javascriptExportShapeComparison.js +10 -3
  299. package/dist/domain/javascript/javascriptExportShapeComparisonIdentity.js +6 -1
  300. package/dist/domain/javascript/javascriptExportShapeComparisonSchemas.js +58 -22
  301. package/dist/domain/javascript/javascriptExportShapeSelection.js +7 -7
  302. package/dist/domain/javascript/javascriptExportShapeVariants.js +70 -16
  303. package/dist/domain/javascript/javascriptFeatureSeed.js +25 -3
  304. package/dist/domain/javascript/javascriptFeatureTrace.js +7 -6
  305. package/dist/domain/javascript/javascriptFeatureTraceSchemas.js +17 -9
  306. package/dist/domain/javascript/javascriptFeatureTraversal.js +4 -5
  307. package/dist/domain/javascript/javascriptNativeHandoff.js +7 -7
  308. package/dist/domain/javascript/javascriptRuntimeLoadState.js +0 -1
  309. package/dist/domain/javascript/javascriptRuntimeObservation.js +18 -7
  310. package/dist/domain/javascript/javascriptRuntimeReconciliation.js +12 -6
  311. package/dist/domain/javascript/javascriptRuntimeReconciliationActive.js +9 -8
  312. package/dist/domain/javascript/javascriptRuntimeReconciliationCaptureParsing.js +212 -0
  313. package/dist/domain/javascript/javascriptRuntimeReconciliationGraph.js +5 -4
  314. package/dist/domain/javascript/javascriptRuntimeReconciliationInputValidation.js +28 -0
  315. package/dist/domain/javascript/javascriptRuntimeReconciliationMatching.js +6 -6
  316. package/dist/domain/javascript/javascriptRuntimeReconciliationParsing.js +12 -222
  317. package/dist/domain/javascript/javascriptRuntimeReconciliationResult.js +2 -2
  318. package/dist/domain/javascript/javascriptRuntimeReconciliationRuntime.js +15 -4
  319. package/dist/domain/javascript/javascriptRuntimeReconciliationSchemas.js +2 -2
  320. package/dist/domain/javascript/javascriptRuntimeStaticCandidates.js +7 -7
  321. package/dist/domain/javascript/javascriptSemanticAnalysis.js +209 -11
  322. package/dist/domain/javascript/javascriptSemanticAsyncEffects.js +2 -1
  323. package/dist/domain/javascript/javascriptSemanticCallResolution.js +9 -7
  324. package/dist/domain/javascript/javascriptSemanticCalls.js +2 -1
  325. package/dist/domain/javascript/javascriptSemanticChildProcesses.js +4 -3
  326. package/dist/domain/javascript/javascriptSemanticCoverage.js +20 -0
  327. package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +7 -9
  328. package/dist/domain/javascript/javascriptSemanticDataEffects.js +4 -11
  329. package/dist/domain/javascript/javascriptSemanticFingerprints.js +2 -2
  330. package/dist/domain/javascript/javascriptSemanticGraph.js +220 -71
  331. package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +19 -1
  332. package/dist/domain/javascript/javascriptSemanticIr.js +0 -4
  333. package/dist/domain/javascript/javascriptSemanticIterationSources.js +106 -0
  334. package/dist/domain/javascript/javascriptSemanticMemberMutations.js +515 -74
  335. package/dist/domain/javascript/javascriptSemanticMutationInitializers.js +190 -0
  336. package/dist/domain/javascript/javascriptSemanticMutationValues.js +44 -36
  337. package/dist/domain/javascript/javascriptSemanticObjects.js +79 -42
  338. package/dist/domain/javascript/javascriptSemanticPrimitives.js +8 -14
  339. package/dist/domain/javascript/javascriptSemanticProjection.js +21 -16
  340. package/dist/domain/javascript/javascriptSemanticPromises.js +16 -21
  341. package/dist/domain/javascript/javascriptSemanticPropertyPaths.js +23 -0
  342. package/dist/domain/javascript/javascriptSemanticProvenance.js +3 -3
  343. package/dist/domain/javascript/javascriptSemanticQuery.js +8 -2
  344. package/dist/domain/javascript/javascriptSemanticQueryIdentity.js +3 -2
  345. package/dist/domain/javascript/javascriptSemanticQuerySchemas.js +8 -9
  346. package/dist/domain/javascript/javascriptSemanticRequireOrigin.js +16 -10
  347. package/dist/domain/javascript/javascriptSemanticResourceLimits.js +1 -1
  348. package/dist/domain/javascript/javascriptSemanticResources.js +1 -1
  349. package/dist/domain/javascript/javascriptSemanticReturns.js +55 -44
  350. package/dist/domain/javascript/javascriptSemanticSlots.js +72 -0
  351. package/dist/domain/javascript/javascriptSemanticTraversal.js +6 -1
  352. package/dist/domain/javascript/javascriptSemanticValues.js +180 -76
  353. package/dist/domain/javascript/javascriptSourceMapPaths.js +114 -0
  354. package/dist/domain/javascript/javascriptSourceParser.js +34 -9
  355. package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +5 -6
  356. package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +2 -1
  357. package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +26 -16
  358. package/dist/domain/javascript/sourceToBundleComparison.js +19 -8
  359. package/dist/domain/javascript/sourceToBundleSignals.js +53 -25
  360. package/dist/domain/jsonSerialization.js +109 -55
  361. package/dist/domain/jsonShape.js +46 -19
  362. package/dist/domain/localPath.js +10 -4
  363. package/dist/domain/managed/managedApplicationGraph.js +10 -6
  364. package/dist/domain/managed/managedApplicationGraphNodes.js +82 -57
  365. package/dist/domain/managed/managedArtifact.js +6 -4
  366. package/dist/domain/managed/managedMemberComparison.js +2 -9
  367. package/dist/domain/managed/managedMemberComparisonMatch.js +6 -7
  368. package/dist/domain/managed/managedNativeVerification.js +0 -2
  369. package/dist/domain/managed/managedNativeVerificationMatch.js +9 -3
  370. package/dist/domain/native/binaryLayout.js +2 -3
  371. package/dist/domain/native/nativeApiBoundary.js +1 -1
  372. package/dist/domain/native/nativeCallObservation.js +3 -3
  373. package/dist/domain/native/nativeInstruction.js +7 -0
  374. package/dist/domain/native/nativeValueFlow.js +5 -11
  375. package/dist/domain/native/objcSwiftMetadata.js +15 -17
  376. package/dist/domain/native/recordedCrash.js +2 -3
  377. package/dist/domain/offsetDateTime.js +17 -0
  378. package/dist/domain/process/processCapture.js +22 -20
  379. package/dist/domain/process/processCaptureCoverage.js +70 -0
  380. package/dist/domain/process/processCaptureExample.js +45 -1
  381. package/dist/domain/process/processCaptureParsing.js +1 -34
  382. package/dist/domain/process/processCaptureValidation.js +82 -13
  383. package/dist/domain/process/processComparison.js +39 -43
  384. package/dist/domain/process/processObservation.js +10 -2
  385. package/dist/domain/process/processScenario.js +24 -2
  386. package/dist/domain/process/processTraceComparison.js +0 -2
  387. package/dist/domain/process/processTraceDimensionProjection.js +1 -1
  388. package/dist/domain/process/processTraceEvaluation.js +19 -15
  389. package/dist/domain/process/processTraceSpecification.js +4 -7
  390. package/dist/domain/providerAdapterError.js +2 -0
  391. package/dist/domain/providerCleanupError.js +6 -2
  392. package/dist/domain/reconstructionCoverage.js +7 -3
  393. package/dist/domain/reconstructionObligationLedgerSchemas.js +2 -1
  394. package/dist/domain/reconstructionReadinessSchemas.js +2 -1
  395. package/dist/domain/reconstructionUnknowns.js +4 -3
  396. package/dist/domain/reconstructionVerification.js +6 -5
  397. package/dist/domain/reconstructionVerificationSchemas.js +2 -1
  398. package/dist/domain/referenceSourceGraph.js +27 -28
  399. package/dist/domain/referenceSourceImportParsing.js +34 -45
  400. package/dist/domain/residualUnknown.js +3 -2
  401. package/dist/domain/staticRuntimeCorrelation.js +4 -3
  402. package/dist/domain/stringPatterns.js +6 -0
  403. package/dist/domain/swiftSymbolClassification.js +66 -0
  404. package/dist/domain/symbolAnalysis.js +83 -20
  405. package/dist/domain/unicodeCodePointOrder.js +6 -0
  406. package/dist/domain/webBundleAnalyzerInspection.js +9 -1
  407. package/dist/domain/webCaptureDiff.js +71 -30
  408. package/dist/domain/webCaptureDiffSchemas.js +8 -11
  409. package/dist/domain/webEventListeners.js +3 -2
  410. package/dist/domain/webExecution.js +3 -2
  411. package/dist/domain/webInventory.js +3 -2
  412. package/dist/domain/webMcpDiscovery.js +4 -3
  413. package/dist/domain/webRuntime.js +0 -2
  414. package/dist/domain/webScriptExport.js +2 -2
  415. package/dist/dotnet/ManagedArtifactInspector.js +2 -19
  416. package/dist/dotnet/ManagedMemberInspector.js +12 -18
  417. package/dist/dotnet/ManagedMemberInspectorCore.js +47 -44
  418. package/dist/dotnet/ManagedMemberInstructionDecoder.js +1 -2
  419. package/dist/dotnet/ManagedMemberRows.js +75 -62
  420. package/dist/dotnet/ManagedMetadataInventory.js +16 -22
  421. package/dist/dotnet/ManagedMethodBodyReader.js +4 -0
  422. package/dist/dotnet/ManagedNativeBoundaryHelpers.js +109 -94
  423. package/dist/dotnet/ManagedNativeBoundaryInspector.js +12 -21
  424. package/dist/dotnet/ManagedReaderFailure.js +16 -0
  425. package/dist/dotnet/ManagedStaticProvider.js +13 -12
  426. package/dist/dotnet/ManagedStaticProviderMetadata.js +1 -4
  427. package/dist/evaluation/AgentEvaluationFixtures.js +250 -0
  428. package/dist/evaluation/AgentEvaluationReport.js +28 -0
  429. package/dist/evaluation/CodexAgentEval.js +12 -8
  430. package/dist/evaluation/KnownAnswerEvaluation.js +281 -0
  431. package/dist/evm/EvmoleInterfaceProvider.js +2 -1
  432. package/dist/filesystem/RegularFile.js +41 -0
  433. package/dist/firmware/FirmwareCommand.js +9 -5
  434. package/dist/firmware/FirmwareProvider.js +4 -4
  435. package/dist/generatedPackageMetadata.js +2 -2
  436. package/dist/ghidra/GhidraAnalysisProfile.js +3 -6
  437. package/dist/ghidra/GhidraClient.js +105 -36
  438. package/dist/ghidra/GhidraClientStartup.js +0 -2
  439. package/dist/ghidra/GhidraDoctor.js +6 -5
  440. package/dist/ghidra/GhidraFunctionValues.js +3 -5
  441. package/dist/ghidra/GhidraInstallation.js +151 -22
  442. package/dist/ghidra/GhidraJavaLaunch.js +6 -2
  443. package/dist/ghidra/GhidraLauncher.js +58 -26
  444. package/dist/ghidra/GhidraProvider.js +6 -2
  445. package/dist/ghidra/GhidraProviderCapabilities.js +6 -0
  446. package/dist/ghidra/GhidraProviderClient.js +13 -3
  447. package/dist/ghidra/GhidraSessionError.js +2 -0
  448. package/dist/ghidra/GhidraSessionRoot.js +39 -0
  449. package/dist/ghidra/extensions/GhidraExtensions.js +17 -10
  450. package/dist/ghidra/extensions/nativeaot/NativeAotAdapter.js +8 -2
  451. package/dist/hopper/BridgeLauncher.js +34 -45
  452. package/dist/hopper/HopperAnalysisProfile.js +3 -8
  453. package/dist/hopper/HopperCleanup.js +56 -27
  454. package/dist/hopper/HopperClient.js +86 -65
  455. package/dist/hopper/HopperMachOImage.js +3 -2
  456. package/dist/hopper/HopperProvider.js +16 -18
  457. package/dist/hopper/HopperRegexSearch.js +3 -6
  458. package/dist/hopper/HopperTargetLease.js +132 -49
  459. package/dist/hopper/LinuxPrivateDisplayProbe.js +6 -0
  460. package/dist/ida/IdaConfiguration.js +8 -3
  461. package/dist/ida/IdaInput.js +1 -7
  462. package/dist/ida/IdaMcpConnection.js +8 -4
  463. package/dist/ida/IdaOperationRunner.js +5 -3
  464. package/dist/ida/IdaProvider.js +8 -12
  465. package/dist/ida/IdaSessionClient.js +24 -20
  466. package/dist/ida/IdaWorkspace.js +12 -13
  467. package/dist/inspector/JavaScriptRuntimeScope.js +9 -5
  468. package/dist/inspector/V8InspectorCaptureProjection.js +47 -14
  469. package/dist/inspector/V8InspectorProvider.js +97 -35
  470. package/dist/javascript/recovery/WakaruCommand.js +7 -2
  471. package/dist/javascript/recovery/WakaruExecution.js +5 -2
  472. package/dist/main/shutdown.js +81 -29
  473. package/dist/main/startup.js +9 -2
  474. package/dist/main/transport.js +23 -3
  475. package/dist/main.js +11 -18
  476. package/dist/native/AppleMachoSelection.js +16 -6
  477. package/dist/native/AppleObjcDispatchFacets.js +3 -3
  478. package/dist/native/AppleObjcProperties.js +17 -7
  479. package/dist/native/CommandRunner.js +9 -7
  480. package/dist/native/LldbCallTracer.js +249 -77
  481. package/dist/native/NativeMacOSProvider.js +32 -17
  482. package/dist/native/NativeMacOSProviderMetadata.js +1 -2
  483. package/dist/native/NativeUiHelperRuntime.js +11 -2
  484. package/dist/native/NativeUiObservation.js +2 -2
  485. package/dist/native/pwntools/PwntoolsDecoder.js +2 -1
  486. package/dist/process/DarwinProcessRunTokenReader.js +16 -2
  487. package/dist/process/ExecFileOutput.js +88 -6
  488. package/dist/process/PrivateRuntimeRoot.js +10 -5
  489. package/dist/process/ProcessOwnership.js +1 -4
  490. package/dist/process/ProcessOwnershipObservation.js +18 -16
  491. package/dist/process/ProviderProcess.js +1 -3
  492. package/dist/process/capture/FilesystemSnapshot.js +131 -24
  493. package/dist/process/capture/ProcessCaptureError.js +13 -0
  494. package/dist/process/capture/ProcessCaptureLifecycle.js +148 -74
  495. package/dist/process/capture/ProcessFilesystemEffects.js +51 -6
  496. package/dist/process/capture/ProcessHarness.js +16 -33
  497. package/dist/process/capture/ProcessNormalization.js +20 -2
  498. package/dist/process/capture/ProcessSampling.js +25 -2
  499. package/dist/process/capture/TerminalRenderer.js +14 -0
  500. package/dist/process/snapshotEnvironment.js +14 -0
  501. package/dist/server/EvidenceMcpServer.js +25 -14
  502. package/dist/server/analysisAdmission.js +8 -0
  503. package/dist/server/createServer.js +71 -59
  504. package/dist/server/mcpClientMetadata.js +12 -5
  505. package/dist/server/promptCompletion.js +3 -8
  506. package/dist/server/registerAnalysisViewTool.js +15 -0
  507. package/dist/server/registerAndroidTools.js +2 -3
  508. package/dist/server/registerApplicationTools/compareExportShapes.js +6 -6
  509. package/dist/server/registerApplicationTools/compareSourceToBundle.js +4 -5
  510. package/dist/server/registerApplicationTools/compareVersions.js +4 -5
  511. package/dist/server/registerApplicationTools/coverage.js +1 -2
  512. package/dist/server/registerApplicationTools/helpers.js +4 -4
  513. package/dist/server/registerApplicationTools/obligationLedger.js +4 -5
  514. package/dist/server/registerApplicationTools/projectMobileApplicationGraph.js +3 -4
  515. package/dist/server/registerApplicationTools/traceFeature.js +4 -5
  516. package/dist/server/registerApplicationTools/traceSemantics.js +4 -5
  517. package/dist/server/registerArtifactComparisonTool.js +4 -5
  518. package/dist/server/registerArtifactTools.js +2 -2
  519. package/dist/server/registerBinaryDiagnosticsTools.js +2 -3
  520. package/dist/server/registerBrowserScenarioTool.js +3 -4
  521. package/dist/server/registerBrowserTools.js +13 -16
  522. package/dist/server/registerBundleComparisonTool.js +5 -6
  523. package/dist/server/registerCloseLifecycleTool.js +8 -7
  524. package/dist/server/registerElectronTools.js +10 -13
  525. package/dist/server/registerEnhancedTools.js +82 -77
  526. package/dist/server/registerEvidenceTools.js +54 -47
  527. package/dist/server/registerEvmTools.js +2 -3
  528. package/dist/server/registerFirmwareTools.js +2 -3
  529. package/dist/server/registerFunctionComparisonTool.js +7 -8
  530. package/dist/server/registerInvestigationTools.js +14 -15
  531. package/dist/server/registerJavaScriptRecoveryTool.js +2 -3
  532. package/dist/server/registerJavaScriptRuntimeObservationTools.js +6 -6
  533. package/dist/server/registerManagedTools.js +7 -4
  534. package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +5 -6
  535. package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +4 -5
  536. package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +6 -7
  537. package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +6 -7
  538. package/dist/server/registerOfficialTools.js +32 -41
  539. package/dist/server/registerProcessComparisonTool.js +8 -8
  540. package/dist/server/registerRecordedCrashTools.js +2 -3
  541. package/dist/server/registerSessionRecordTools.js +15 -19
  542. package/dist/server/registerSessionStatusTool.js +3 -4
  543. package/dist/server/registerSessionTools.js +19 -19
  544. package/dist/server/registerWebModuleTool.js +2 -3
  545. package/dist/server/registerWebNetworkCaptureTool.js +2 -3
  546. package/dist/server/registerWebRuntimeTools.js +4 -5
  547. package/dist/server/registerWebScriptTool.js +2 -3
  548. package/dist/server/registerWebSourceLocationTool.js +2 -3
  549. package/dist/server/toolResult.js +66 -94
  550. package/dist/server/toolResultEncoding.js +11 -10
  551. package/dist/windows/WindowsNativeLoader.js +1 -0
  552. package/dist/windows/WindowsOwnedProcess.js +60 -15
  553. package/dist/windows/WindowsPrivateRuntime.js +7 -8
  554. package/native/windows/README.md +3 -1
  555. package/native/windows/build/manifest.json +2 -2
  556. package/native/windows/build/rea-windows-x64.node +0 -0
  557. package/package.json +42 -30
  558. package/scripts/rea.mjs +3 -6
  559. package/skills/reverse-engineer-anything/SKILL.md +14 -13
  560. package/skills/reverse-engineer-anything/references/android-applications.md +6 -3
  561. package/skills/reverse-engineer-anything/references/evidence-workflows.md +8 -4
  562. package/skills/reverse-engineer-anything/references/javascript-applications.md +16 -6
  563. package/skills/reverse-engineer-anything/references/native-and-artifacts.md +18 -0
  564. package/dist/artifacts/inventory/policy.js +0 -2
  565. package/dist/config.js +0 -1
  566. package/dist/contracts/browserCaptureToolInputSchema.js +0 -43
  567. package/dist/contracts/process/processCaptureExample.js +0 -2
  568. package/dist/contracts/toolOutputSchemas.js +0 -2
  569. package/dist/domain/managed/managedApplicationGraphNodeCoverage.js +0 -6
  570. package/dist/main/reload.js +0 -12
  571. package/dist/main/state.js +0 -3
  572. package/dist/server/registerNativeTools.js +0 -6
  573. package/dist/server/sessionToolPolicies.js +0 -2
@@ -1,6 +1,6 @@
1
1
  import { managedArtifactInspectionSchema, } from "../domain/managed/managedArtifact.js";
2
2
  import { readManagedPeLayout, } from "./ManagedPeReader.js";
3
- import { managedTableRowCounts, readManagedMetadataInventory, } from "./ManagedMetadataInventory.js";
3
+ import { managedTableRowCounts, readManagedMetadataInventory, readManagedResourceDirectory, } from "./ManagedMetadataInventory.js";
4
4
  import { readManagedMetadataLayout, } from "./ManagedMetadataLayout.js";
5
5
  import { ManagedReaderFailure } from "./ManagedReaderFailure.js";
6
6
  const flagNames = (flags) => {
@@ -228,23 +228,6 @@ const partialMetadataResult = ({ target, bytes, layout, issue, }) => ({
228
228
  "CLI metadata could not be read because the PE/CLI structure is malformed or unsupported.",
229
229
  ],
230
230
  });
231
- const mapResources = (bytes, layout, issues) => {
232
- const resources = layout.cli?.resources;
233
- if (resources === undefined || (resources.rva === 0 && resources.size === 0))
234
- return null;
235
- try {
236
- return {
237
- offset: layout.rvaToOffset(resources.rva, resources.size, "cli.resources"),
238
- size: resources.size,
239
- };
240
- }
241
- catch (cause) {
242
- if (!(cause instanceof ManagedReaderFailure))
243
- throw cause;
244
- issues.push(cause.issue);
245
- return null;
246
- }
247
- };
248
231
  /** Inspect PE/CLI identity directly from local bytes without CLR loading. */
249
232
  export const inspectManagedArtifactBytes = (bytes, target) => {
250
233
  const layout = readManagedPeLayout(bytes);
@@ -267,7 +250,7 @@ export const inspectManagedArtifactBytes = (bytes, target) => {
267
250
  }));
268
251
  }
269
252
  const resourceIssues = [];
270
- const resourceDirectory = mapResources(bytes, layout, resourceIssues);
253
+ const resourceDirectory = readManagedResourceDirectory(layout, resourceIssues);
271
254
  const inventory = readManagedMetadataInventory(bytes, metadata, resourceDirectory);
272
255
  const issues = [...resourceIssues, ...inventory.issues];
273
256
  const limitations = [
@@ -1,8 +1,8 @@
1
1
  import { managedMemberInspectionSchema, } from "../domain/managed/managedArtifact.js";
2
2
  import { readManagedPeLayout, } from "./ManagedPeReader.js";
3
- import { managedTableRowCounts, readManagedMetadataInventory, } from "./ManagedMetadataInventory.js";
3
+ import { readManagedResourceDirectory, managedTableRowCounts, readManagedMetadataInventory, } from "./ManagedMetadataInventory.js";
4
4
  import { readManagedMetadataLayout } from "./ManagedMetadataLayout.js";
5
- import { ManagedReaderFailure } from "./ManagedReaderFailure.js";
5
+ import { ManagedReaderFailure, uniqueManagedParseIssues, } from "./ManagedReaderFailure.js";
6
6
  import { parseTypes, typeRanges } from "./ManagedMemberInspectorCore.js";
7
7
  import { edges, parseFields, parseMemberRefs, parseMethods, } from "./ManagedMemberRows.js";
8
8
  const unavailable = (target, bytes, issue) => managedMemberInspectionSchema.parse({
@@ -39,23 +39,13 @@ const unavailable = (target, bytes, issue) => managedMemberInspectionSchema.pars
39
39
  : "The CLI metadata could not be admitted; managed member inspection is unavailable.",
40
40
  ],
41
41
  });
42
- const resourceDirectory = (pe) => {
43
- if (pe.cli === null ||
44
- pe.cli.resources.rva === 0 ||
45
- pe.cli.resources.size === 0)
46
- return null;
47
- return {
48
- offset: pe.rvaToOffset(pe.cli.resources.rva, pe.cli.resources.size, "cli.resources"),
49
- size: pe.cli.resources.size,
50
- };
51
- };
52
- const readMemberInventory = (bytes, pe) => {
42
+ const readMemberInventory = (bytes, pe, issues) => {
53
43
  const cli = pe.cli;
54
44
  if (cli === null)
55
45
  throw new TypeError("Managed inventory requires CLI metadata");
56
46
  const rootOffset = pe.rvaToOffset(cli.metadata.rva, cli.metadata.size, "cli.metadata");
57
47
  const layout = readManagedMetadataLayout(bytes, rootOffset, cli.metadata.size);
58
- const inventory = readManagedMetadataInventory(bytes, layout, resourceDirectory(pe));
48
+ const inventory = readManagedMetadataInventory(bytes, layout, readManagedResourceDirectory(pe, issues));
59
49
  return { layout, inventory };
60
50
  };
61
51
  /** Inspect metadata members and method bodies without loading target code. */
@@ -65,9 +55,9 @@ export const inspectManagedMembersBytes = (bytes, target) => {
65
55
  return unavailable(target, bytes, pe.cliIssue);
66
56
  const issues = [];
67
57
  try {
68
- const { layout, inventory } = readMemberInventory(bytes, pe);
58
+ const { layout, inventory } = readMemberInventory(bytes, pe, issues);
69
59
  issues.push(...inventory.issues);
70
- const ranges = typeRanges(bytes, layout);
60
+ const ranges = typeRanges(bytes, layout, issues);
71
61
  const parsedTypes = parseTypes(bytes, layout, ranges);
72
62
  issues.push(...parsedTypes.issues);
73
63
  const fields = parseFields(bytes, layout, ranges);
@@ -79,7 +69,11 @@ export const inspectManagedMembersBytes = (bytes, target) => {
79
69
  pe,
80
70
  ranges,
81
71
  });
82
- const coverageIssues = issues;
72
+ issues.push(...fields.issues, ...methods.issues);
73
+ const coverageIssues = uniqueManagedParseIssues(issues);
74
+ const incompleteMembers = [...fields.fields, ...memberRefs.refs, ...methods.methods].some((member) => member.signature.parse_status !== "decoded") ||
75
+ methods.methods.some((method) => method.body.status === "partial" ||
76
+ method.body.status === "malformed");
83
77
  const related = edges(methods.methods, methods.core, fields.core, memberRefs.core);
84
78
  return managedMemberInspectionSchema.parse({
85
79
  artifact: {
@@ -106,7 +100,7 @@ export const inspectManagedMembersBytes = (bytes, target) => {
106
100
  call_edges: related.callEdges,
107
101
  field_accesses: related.fieldAccesses,
108
102
  coverage: {
109
- state: coverageIssues.length === 0 ? "complete" : "partial",
103
+ state: issues.length === 0 && !incompleteMembers ? "complete" : "partial",
110
104
  issues: coverageIssues,
111
105
  },
112
106
  limitations: [
@@ -1,4 +1,4 @@
1
- import { managedFailure, ManagedReaderFailure, } from "./ManagedReaderFailure.js";
1
+ import { managedFailure, ManagedReaderFailure, readManagedValue, } from "./ManagedReaderFailure.js";
2
2
  import {} from "./ManagedMetadataLayout.js";
3
3
  import { metadataRowCursor, metadataCodedToken, metadataCodedTokenInvalidReason, metadataToken, readMetadataString, sha256Bytes, } from "./ManagedMetadataHeaps.js";
4
4
  const rowRange = (table, start, nextStart) => {
@@ -11,13 +11,14 @@ const rowRange = (table, start, nextStart) => {
11
11
  return { first: start, last: end - 1, count: end - start };
12
12
  };
13
13
  const fullName = (namespace, name) => namespace.length === 0 ? name : `${namespace}.${name}`;
14
- const readTypeRange = (bytes, layout, row) => {
14
+ const readTypeRange = (bytes, layout, row, issues) => {
15
15
  const methods = layout.table(6);
16
16
  const fields = layout.table(4);
17
17
  const cursor = metadataRowCursor(bytes, layout, 2, row);
18
18
  cursor.readUInt32();
19
- const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
20
- const namespace = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
19
+ const nameIndex = cursor.readIndex(layout.stringIndexSize);
20
+ const namespaceIndex = cursor.readIndex(layout.stringIndexSize);
21
+ const declaredName = readManagedValue(() => fullName(readMetadataString(bytes, layout, namespaceIndex, layout.strings.size), readMetadataString(bytes, layout, nameIndex, layout.strings.size)), issues) ?? null;
21
22
  cursor.readIndex(layout.codedIndexSize("TypeDefOrRef"));
22
23
  const fieldStart = cursor.readIndex(layout.tableIndexSize(4));
23
24
  const methodStart = cursor.readIndex(layout.tableIndexSize(6));
@@ -35,18 +36,18 @@ const readTypeRange = (bytes, layout, row) => {
35
36
  }
36
37
  return {
37
38
  token: metadataToken(2, row),
38
- fullName: fullName(namespace, name),
39
+ fullName: declaredName,
39
40
  fieldStart,
40
41
  fieldEnd: nextField,
41
42
  methodStart,
42
43
  methodEnd: nextMethod,
43
44
  };
44
45
  };
45
- export const typeRanges = (bytes, layout) => {
46
+ export const typeRanges = (bytes, layout, issues) => {
46
47
  const typeTable = layout.table(2);
47
48
  const ranges = [];
48
49
  for (let row = 1; row <= (typeTable?.rowCount ?? 0); row += 1)
49
- ranges.push(readTypeRange(bytes, layout, row));
50
+ ranges.push(readTypeRange(bytes, layout, row, issues));
50
51
  return ranges;
51
52
  };
52
53
  export const declaringType = (ranges, table, row) => {
@@ -99,44 +100,46 @@ export const parseTypes = (bytes, layout, ranges) => {
99
100
  const items = [];
100
101
  const issues = [];
101
102
  for (let row = 1; row <= (typeTable?.rowCount ?? 0); row += 1) {
102
- const cursor = metadataRowCursor(bytes, layout, 2, row);
103
- const flags = cursor.readUInt32();
104
- const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
105
- const namespace = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
106
- const extendsOffset = cursor.offset;
107
- const extendsRaw = cursor.readIndex(layout.codedIndexSize("TypeDefOrRef"));
108
- const fieldStart = cursor.readIndex(layout.tableIndexSize(4));
109
- const methodStart = cursor.readIndex(layout.tableIndexSize(6));
110
- const nextRange = ranges[row] ?? null;
111
- const fieldRange = rowRange(fields, fieldStart, nextRange?.fieldStart ?? 0);
112
- const methodRange = rowRange(methods, methodStart, nextRange?.methodStart ?? 0);
113
- const extendsReason = metadataCodedTokenInvalidReason(extendsRaw, 2, [2, 1, 27], layout.rowCounts);
114
- if (extendsReason !== null)
115
- issues.push({
116
- code: "invalid-row",
117
- scope: `metadata.TypeDef:${metadataToken(2, row)}`,
118
- offset: extendsOffset,
119
- detail: `TypeDef Extends coded index 0x${extendsRaw.toString(16)} is invalid: ${extendsReason}`,
103
+ readManagedValue(() => {
104
+ const cursor = metadataRowCursor(bytes, layout, 2, row);
105
+ const flags = cursor.readUInt32();
106
+ const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
107
+ const namespace = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
108
+ const extendsOffset = cursor.offset;
109
+ const extendsRaw = cursor.readIndex(layout.codedIndexSize("TypeDefOrRef"));
110
+ const fieldStart = cursor.readIndex(layout.tableIndexSize(4));
111
+ const methodStart = cursor.readIndex(layout.tableIndexSize(6));
112
+ const nextRange = ranges[row] ?? null;
113
+ const fieldRange = rowRange(fields, fieldStart, nextRange?.fieldStart ?? 0);
114
+ const methodRange = rowRange(methods, methodStart, nextRange?.methodStart ?? 0);
115
+ const extendsReason = metadataCodedTokenInvalidReason(extendsRaw, 2, [2, 1, 27], layout.rowCounts);
116
+ if (extendsReason !== null)
117
+ issues.push({
118
+ code: "invalid-row",
119
+ scope: `metadata.TypeDef:${metadataToken(2, row)}`,
120
+ offset: extendsOffset,
121
+ detail: `TypeDef Extends coded index 0x${extendsRaw.toString(16)} is invalid: ${extendsReason}`,
122
+ });
123
+ items.push({
124
+ token: metadataToken(2, row),
125
+ row_offset: cursor.start,
126
+ namespace,
127
+ name,
128
+ full_name: fullName(namespace, name),
129
+ flags,
130
+ extends_token: metadataCodedToken(extendsRaw, 2, [2, 1, 27], layout.rowCounts),
131
+ field_list: {
132
+ first_row: fieldRange.first,
133
+ last_row: fieldRange.last,
134
+ count: fieldRange.count,
135
+ },
136
+ method_list: {
137
+ first_row: methodRange.first,
138
+ last_row: methodRange.last,
139
+ count: methodRange.count,
140
+ },
120
141
  });
121
- items.push({
122
- token: metadataToken(2, row),
123
- row_offset: cursor.start,
124
- namespace,
125
- name,
126
- full_name: fullName(namespace, name),
127
- flags,
128
- extends_token: metadataCodedToken(extendsRaw, 2, [2, 1, 27], layout.rowCounts),
129
- field_list: {
130
- first_row: fieldRange.first,
131
- last_row: fieldRange.last,
132
- count: fieldRange.count,
133
- },
134
- method_list: {
135
- first_row: methodRange.first,
136
- last_row: methodRange.last,
137
- count: methodRange.count,
138
- },
139
- });
142
+ }, issues);
140
143
  }
141
144
  return { types: items, issues };
142
145
  };
@@ -1,4 +1,3 @@
1
- const opcode = (code) => OPCODES.get(code);
2
1
  const PREFIX_OPCODES = new Set([
3
2
  "unaligned.",
4
3
  "volatile.",
@@ -361,7 +360,7 @@ export const decodeInstructions = (il) => {
361
360
  const first = il.readUInt8(offset);
362
361
  offset += 1;
363
362
  const code = first === 0xfe ? 0xfe00 + il.readUInt8(offset++) : first;
364
- const descriptor = opcode(code);
363
+ const descriptor = OPCODES.get(code);
365
364
  if (descriptor === undefined) {
366
365
  issue = `Unsupported CIL opcode 0x${code.toString(16)} at IL offset ${String(start)}`;
367
366
  break;
@@ -1,30 +1,34 @@
1
1
  import { createDeclaringTypeLookup, signature, } from "./ManagedMemberInspectorCore.js";
2
2
  import { metadataToken, metadataRowCursor, metadataCodedToken, metadataCodedTokenInvalidReason, readMetadataBlob, readMetadataString, } from "./ManagedMetadataHeaps.js";
3
+ import { readManagedValue } from "./ManagedReaderFailure.js";
3
4
  import { methodBody } from "./ManagedMethodBodyReader.js";
4
5
  export const parseFields = (bytes, layout, ranges) => {
5
6
  const fields = [];
6
7
  const core = new Map();
8
+ const issues = [];
7
9
  const table = layout.table(4);
8
10
  const declaringType = createDeclaringTypeLookup(ranges, "field");
9
11
  for (let row = 1; row <= (table?.rowCount ?? 0); row += 1) {
10
- const cursor = metadataRowCursor(bytes, layout, 4, row);
11
- const flags = cursor.readUInt16();
12
- const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
13
- const sig = readMetadataBlob(bytes, layout, cursor.readIndex(layout.blobIndexSize), layout.blob.size);
14
- const declared = declaringType(row);
15
- const token = metadataToken(4, row);
16
- fields.push({
17
- token,
18
- row_offset: cursor.start,
19
- declaring_type_token: declared?.token ?? null,
20
- declaring_type: declared?.fullName ?? null,
21
- name,
22
- flags,
23
- signature: signature(sig),
24
- });
25
- core.set(token, { token, name });
12
+ readManagedValue(() => {
13
+ const cursor = metadataRowCursor(bytes, layout, 4, row);
14
+ const flags = cursor.readUInt16();
15
+ const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
16
+ const sig = readMetadataBlob(bytes, layout, cursor.readIndex(layout.blobIndexSize), layout.blob.size);
17
+ const declared = declaringType(row);
18
+ const token = metadataToken(4, row);
19
+ fields.push({
20
+ token,
21
+ row_offset: cursor.start,
22
+ declaring_type_token: declared?.token ?? null,
23
+ declaring_type: declared?.fullName ?? null,
24
+ name,
25
+ flags,
26
+ signature: signature(sig),
27
+ });
28
+ core.set(token, { token, name });
29
+ }, issues);
26
30
  }
27
- return { fields, core };
31
+ return { fields, core, issues };
28
32
  };
29
33
  export const parseMemberRefs = (bytes, layout) => {
30
34
  const refs = [];
@@ -32,62 +36,71 @@ export const parseMemberRefs = (bytes, layout) => {
32
36
  const issues = [];
33
37
  const table = layout.table(10);
34
38
  for (let row = 1; row <= (table?.rowCount ?? 0); row += 1) {
35
- const cursor = metadataRowCursor(bytes, layout, 10, row);
36
- const parentRaw = cursor.readIndex(layout.codedIndexSize("MemberRefParent"));
37
- const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
38
- const sig = readMetadataBlob(bytes, layout, cursor.readIndex(layout.blobIndexSize), layout.blob.size);
39
- const token = metadataToken(10, row);
40
- const parentReason = metadataCodedTokenInvalidReason(parentRaw, 3, [2, 1, 26, 6, 27], layout.rowCounts);
41
- if (parentReason !== null || parentRaw === 0)
42
- issues.push({
43
- code: "invalid-row",
44
- scope: `metadata.MemberRef:${token}`,
45
- offset: cursor.start,
46
- detail: parentReason === null
47
- ? "MemberRef parent coded index 0x0 is null, but the Class column must reference a row"
48
- : `MemberRef parent coded index 0x${parentRaw.toString(16)} is invalid: ${parentReason}`,
39
+ readManagedValue(() => {
40
+ const cursor = metadataRowCursor(bytes, layout, 10, row);
41
+ const parentRaw = cursor.readIndex(layout.codedIndexSize("MemberRefParent"));
42
+ const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
43
+ const sig = readMetadataBlob(bytes, layout, cursor.readIndex(layout.blobIndexSize), layout.blob.size);
44
+ const token = metadataToken(10, row);
45
+ const parentReason = metadataCodedTokenInvalidReason(parentRaw, 3, [2, 1, 26, 6, 27], layout.rowCounts);
46
+ if (parentReason !== null || parentRaw === 0)
47
+ issues.push({
48
+ code: "invalid-row",
49
+ scope: `metadata.MemberRef:${token}`,
50
+ offset: cursor.start,
51
+ detail: parentReason === null
52
+ ? "MemberRef parent coded index 0x0 is null, but the Class column must reference a row"
53
+ : `MemberRef parent coded index 0x${parentRaw.toString(16)} is invalid: ${parentReason}`,
54
+ });
55
+ refs.push({
56
+ token,
57
+ row_offset: cursor.start,
58
+ parent_token: metadataCodedToken(parentRaw, 3, [2, 1, 26, 6, 27], layout.rowCounts),
59
+ name,
60
+ signature: signature(sig),
49
61
  });
50
- refs.push({
51
- token,
52
- row_offset: cursor.start,
53
- parent_token: metadataCodedToken(parentRaw, 3, [2, 1, 26, 6, 27], layout.rowCounts),
54
- name,
55
- signature: signature(sig),
56
- });
57
- core.set(token, { token, name });
62
+ core.set(token, { token, name });
63
+ }, issues);
58
64
  }
59
65
  return { refs, core, issues };
60
66
  };
61
67
  export const parseMethods = ({ bytes, layout, pe, ranges, }) => {
62
68
  const methods = [];
63
69
  const core = new Map();
70
+ const issues = [];
64
71
  const table = layout.table(6);
65
72
  const declaringType = createDeclaringTypeLookup(ranges, "method");
66
73
  for (let row = 1; row <= (table?.rowCount ?? 0); row += 1) {
67
- const cursor = metadataRowCursor(bytes, layout, 6, row);
68
- const rva = cursor.readUInt32();
69
- const implFlags = cursor.readUInt16();
70
- const flags = cursor.readUInt16();
71
- const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
72
- const sig = readMetadataBlob(bytes, layout, cursor.readIndex(layout.blobIndexSize), layout.blob.size);
73
- cursor.readIndex(layout.tableIndexSize(8));
74
- const declared = declaringType(row);
75
- const token = metadataToken(6, row);
76
- methods.push({
77
- token,
78
- row_offset: cursor.start,
79
- declaring_type_token: declared?.token ?? null,
80
- declaring_type: declared?.fullName ?? null,
81
- name,
82
- rva,
83
- impl_flags: implFlags,
84
- flags,
85
- signature: signature(sig),
86
- body: methodBody(bytes, pe, rva, { implFlags, flags }),
87
- });
88
- core.set(token, { token, name, declaringType: declared?.fullName ?? null });
74
+ readManagedValue(() => {
75
+ const cursor = metadataRowCursor(bytes, layout, 6, row);
76
+ const rva = cursor.readUInt32();
77
+ const implFlags = cursor.readUInt16();
78
+ const flags = cursor.readUInt16();
79
+ const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), layout.strings.size);
80
+ const sig = readMetadataBlob(bytes, layout, cursor.readIndex(layout.blobIndexSize), layout.blob.size);
81
+ cursor.readIndex(layout.tableIndexSize(8));
82
+ const declared = declaringType(row);
83
+ const token = metadataToken(6, row);
84
+ methods.push({
85
+ token,
86
+ row_offset: cursor.start,
87
+ declaring_type_token: declared?.token ?? null,
88
+ declaring_type: declared?.fullName ?? null,
89
+ name,
90
+ rva,
91
+ impl_flags: implFlags,
92
+ flags,
93
+ signature: signature(sig),
94
+ body: methodBody(bytes, pe, rva, { implFlags, flags }),
95
+ });
96
+ core.set(token, {
97
+ token,
98
+ name,
99
+ declaringType: declared?.fullName ?? null,
100
+ });
101
+ }, issues);
89
102
  }
90
- return { methods, core };
103
+ return { methods, core, issues };
91
104
  };
92
105
  const targetKind = (token) => token.startsWith("0x06")
93
106
  ? "method-def"
@@ -1,17 +1,16 @@
1
1
  import { METADATA_TABLE_NAMES, } from "./ManagedMetadataLayout.js";
2
2
  import { readAssembly, readAssemblyReference, readCustomAttribute, readModule, readResource, } from "./ManagedMetadataInventoryRows.js";
3
3
  import { metadataToken } from "./ManagedMetadataHeaps.js";
4
- import { ManagedReaderFailure } from "./ManagedReaderFailure.js";
5
- const safeRead = (operation, issues) => {
6
- try {
7
- return operation();
8
- }
9
- catch (cause) {
10
- if (!(cause instanceof ManagedReaderFailure))
11
- throw cause;
12
- issues.push(cause.issue);
13
- return undefined;
14
- }
4
+ import { readManagedValue, uniqueManagedParseIssues, } from "./ManagedReaderFailure.js";
5
+ /** Map optional embedded resources without discarding admitted CLI metadata. */
6
+ export const readManagedResourceDirectory = (pe, issues) => {
7
+ const resources = pe.cli?.resources;
8
+ if (resources === undefined || (resources.rva === 0 && resources.size === 0))
9
+ return null;
10
+ return (readManagedValue(() => ({
11
+ offset: pe.rvaToOffset(resources.rva, resources.size, "cli.resources"),
12
+ size: resources.size,
13
+ }), issues) ?? null);
15
14
  };
16
15
  const readRows = (descriptor, read) => {
17
16
  const total = descriptor?.rowCount ?? 0;
@@ -23,9 +22,6 @@ const readRows = (descriptor, read) => {
23
22
  }
24
23
  return items;
25
24
  };
26
- const uniqueIssues = (issues) => [
27
- ...new Map(issues.map((issue) => [JSON.stringify(issue), issue])).values(),
28
- ];
29
25
  const heapExtent = (layout) => Math.max(layout.strings.size, layout.blob.size);
30
26
  const validateIdentityTableCounts = (layout, issues) => {
31
27
  const moduleRows = layout.table(0)?.rowCount ?? 0;
@@ -46,13 +42,13 @@ const validateIdentityTableCounts = (layout, issues) => {
46
42
  });
47
43
  };
48
44
  const readReferences = (bytes, layout, issues) => {
49
- const references = readRows(layout.table(35), (row) => safeRead(() => readAssemblyReference(bytes, layout, row, heapExtent(layout)), issues));
45
+ const references = readRows(layout.table(35), (row) => readManagedValue(() => readAssemblyReference(bytes, layout, row, heapExtent(layout)), issues));
50
46
  return {
51
47
  references,
52
48
  referenceNames: [...new Set(references.map(({ name }) => name))].sort(),
53
49
  };
54
50
  };
55
- const readResources = ({ bytes, layout, resourceDirectory, issues, }) => readRows(layout.table(40), (row) => safeRead(() => readResource({
51
+ const readResources = ({ bytes, layout, resourceDirectory, issues, }) => readRows(layout.table(40), (row) => readManagedValue(() => readResource({
56
52
  bytes,
57
53
  layout,
58
54
  row,
@@ -60,7 +56,7 @@ const readResources = ({ bytes, layout, resourceDirectory, issues, }) => readRow
60
56
  issues,
61
57
  }), issues));
62
58
  const readAttributes = (bytes, layout, issues) => {
63
- const attributes = readRows(layout.table(12), (row) => safeRead(() => readCustomAttribute(bytes, layout, row, heapExtent(layout)), issues));
59
+ const attributes = readRows(layout.table(12), (row) => readManagedValue(() => readCustomAttribute(bytes, layout, row, heapExtent(layout)), issues));
64
60
  const targetFrameworks = new Set();
65
61
  for (const attribute of attributes) {
66
62
  if (attribute.parent_token === metadataToken(32, 1) &&
@@ -75,10 +71,8 @@ const readAttributes = (bytes, layout, issues) => {
75
71
  export const readManagedMetadataInventory = (bytes, layout, resourceDirectory) => {
76
72
  const issues = [];
77
73
  validateIdentityTableCounts(layout, issues);
78
- const module = safeRead(() => readModule(bytes, layout, heapExtent(layout)), issues) ??
79
- null;
80
- const assembly = safeRead(() => readAssembly(bytes, layout, heapExtent(layout)), issues) ??
81
- null;
74
+ const module = readManagedValue(() => readModule(bytes, layout, heapExtent(layout)), issues) ?? null;
75
+ const assembly = readManagedValue(() => readAssembly(bytes, layout, heapExtent(layout)), issues) ?? null;
82
76
  const { references, referenceNames } = readReferences(bytes, layout, issues);
83
77
  const resources = readResources({
84
78
  bytes,
@@ -95,7 +89,7 @@ export const readManagedMetadataInventory = (bytes, layout, resourceDirectory) =
95
89
  references,
96
90
  resources,
97
91
  attributes,
98
- issues: uniqueIssues(issues),
92
+ issues: uniqueManagedParseIssues(issues),
99
93
  };
100
94
  };
101
95
  /** Stable table-name/count projection for caller-visible coverage. */
@@ -1,6 +1,7 @@
1
1
  import { decodeInstructions, parseExceptionRegions, } from "./ManagedMemberInstructionDecoder.js";
2
2
  import { validateExceptionRegionRanges } from "./ManagedExceptionRegionValidation.js";
3
3
  import { sha256Bytes } from "./ManagedMetadataHeaps.js";
4
+ import { ManagedReaderFailure } from "./ManagedReaderFailure.js";
4
5
  const bodyStatus = (decodedIssue, truncatedInstructions, exceptionRegions) => {
5
6
  if (decodedIssue !== null || exceptionRegions?.status === "malformed")
6
7
  return "malformed";
@@ -114,6 +115,9 @@ export const methodBody = (bytes, pe, rva, implementation = {
114
115
  };
115
116
  }
116
117
  catch (cause) {
118
+ if (!(cause instanceof ManagedReaderFailure) &&
119
+ !(cause instanceof RangeError))
120
+ throw cause;
117
121
  return emptyMethodBody(rva, "malformed", cause instanceof Error ? cause.message : "Method body parse failed");
118
122
  }
119
123
  };