rea-agents 1.7.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (333) hide show
  1. package/README.md +112 -59
  2. package/bridge/ghidra/ReaGhidraBridge.java +96 -11
  3. package/dist/application/ArtifactExtraction.js +1 -1
  4. package/dist/application/ArtifactInventory/classify.js +42 -0
  5. package/dist/application/ArtifactInventory/hash.js +43 -0
  6. package/dist/application/ArtifactInventory/reader.js +41 -0
  7. package/dist/application/ArtifactInventory/scanCanonical.js +155 -0
  8. package/dist/application/ArtifactInventory/scanReader.js +124 -0
  9. package/dist/application/ArtifactInventory/types.js +10 -0
  10. package/dist/application/ArtifactInventory.js +9 -351
  11. package/dist/application/AuthorizedArtifactInventory.js +2 -2
  12. package/dist/application/BinarySession.js +47 -270
  13. package/dist/application/BinarySessionExecution.js +28 -0
  14. package/dist/application/BinarySessionOpen.js +39 -0
  15. package/dist/application/BinarySessionRecords.js +149 -0
  16. package/dist/application/BinarySessionStatus.js +75 -0
  17. package/dist/application/CapabilityInventory.js +42 -2
  18. package/dist/application/ClientRegistrationStatus.js +1 -1
  19. package/dist/application/CrossVersionInventory.js +8 -2
  20. package/dist/application/CrossVersionInvestigation.js +11 -29
  21. package/dist/application/CrossVersionInvestigationCollections.js +23 -0
  22. package/dist/application/DirectAnalysis.js +47 -44
  23. package/dist/application/Doctor.js +165 -197
  24. package/dist/application/DoctorDiagnostics.js +180 -0
  25. package/dist/application/ElectronBoundaryAnalysis.js +112 -0
  26. package/dist/application/ElectronBoundaryGraph.js +9 -0
  27. package/dist/application/ElectronBoundaryGraphContext.js +62 -0
  28. package/dist/application/ElectronBoundaryGraphIpc.js +242 -0
  29. package/dist/application/ElectronBoundaryGraphNative.js +86 -0
  30. package/dist/application/ElectronBoundaryGraphWindows.js +223 -0
  31. package/dist/application/EnhancedToolPagination.js +22 -0
  32. package/dist/application/EnhancedToolTypes.js +4 -0
  33. package/dist/application/EnhancedTools.js +58 -50
  34. package/dist/application/InstrumentedJavaScriptReplayHost.js +36 -0
  35. package/dist/application/InvestigationProviders.js +30 -0
  36. package/dist/application/InvestigationWorkspaceStore.js +24 -10
  37. package/dist/application/JavaScriptApplicationEvidence.js +26 -0
  38. package/dist/application/JavaScriptApplicationEvidenceGraph.js +89 -0
  39. package/dist/application/JavaScriptApplicationService.js +74 -0
  40. package/dist/application/JavaScriptApplicationWorkflowEvidence.js +29 -0
  41. package/dist/application/JavaScriptApplicationWorkflowService.js +90 -0
  42. package/dist/application/JavaScriptArtifactAnalysis.js +52 -7
  43. package/dist/application/JavaScriptArtifactFiles.js +6 -2
  44. package/dist/application/JavaScriptArtifactGraphBuilder.js +82 -17
  45. package/dist/application/JavaScriptArtifactGraphBundlers.js +225 -0
  46. package/dist/application/JavaScriptArtifactGraphContext.js +37 -36
  47. package/dist/application/JavaScriptArtifactGraphDocuments.js +27 -4
  48. package/dist/application/JavaScriptArtifactGraphEvidence.js +24 -14
  49. package/dist/application/JavaScriptArtifactGraphFindings.js +54 -8
  50. package/dist/application/JavaScriptArtifactGraphStructure.js +29 -101
  51. package/dist/application/JavaScriptArtifactPathResolution.js +269 -0
  52. package/dist/application/JavaScriptArtifactReconstruction.js +4 -1
  53. package/dist/application/JavaScriptArtifactReconstructionInput.js +2 -83
  54. package/dist/application/JavaScriptJsonModules.js +39 -0
  55. package/dist/application/JavaScriptModuleRelationships.js +262 -0
  56. package/dist/application/JavaScriptReplayPermission.js +16 -0
  57. package/dist/application/JavaScriptReplayPlanning.js +201 -0
  58. package/dist/application/JavaScriptReplayService.js +292 -0
  59. package/dist/application/JavaScriptRuntimeReconciliationEvidence.js +25 -0
  60. package/dist/application/JavaScriptRuntimeReconciliationService.js +27 -0
  61. package/dist/application/LinuxHopper.js +10 -0
  62. package/dist/application/MacHopper.js +22 -11
  63. package/dist/application/ManagedApplicationGraphService.js +55 -0
  64. package/dist/application/ManagedMemberComparisonService.js +122 -0
  65. package/dist/application/ManagedNativeVerificationService.js +39 -0
  66. package/dist/application/ManagedReconstructionService.js +58 -0
  67. package/dist/application/ManagedRuntimeCorrelationService.js +103 -0
  68. package/dist/application/NodeRuntimeCharacterizationService.js +196 -0
  69. package/dist/application/PermissionAuthority.js +106 -63
  70. package/dist/application/ProcessCaptureCapability.js +1 -1
  71. package/dist/application/ProcessCapturePermission.js +13 -0
  72. package/dist/application/ProcessCli.js +2 -12
  73. package/dist/application/ProcessHarness.js +1 -1
  74. package/dist/application/ProcessSampling.js +15 -11
  75. package/dist/application/ProjectPermissionStore.js +49 -9
  76. package/dist/application/RealHopperAssertions.js +76 -0
  77. package/dist/application/ReconstructionCoverageService.js +69 -0
  78. package/dist/application/ReconstructionCoverageWorkspaceStore.js +31 -0
  79. package/dist/application/RuntimeExecutableDiagnostics.js +172 -0
  80. package/dist/application/Setup.js +147 -259
  81. package/dist/application/SetupClientConfiguration.js +220 -0
  82. package/dist/application/SetupClients.js +24 -2
  83. package/dist/application/SetupPlan.js +123 -12
  84. package/dist/application/SetupSkill.js +26 -12
  85. package/dist/application/SupportedClients.js +1 -0
  86. package/dist/application/Uninstall.js +6 -3
  87. package/dist/application/WindowsCapabilities.js +86 -0
  88. package/dist/application/runtime.js +2 -0
  89. package/dist/artifacts/AsarArtifactReader.js +11 -0
  90. package/dist/browser/BrowserProcessStartup.js +88 -0
  91. package/dist/browser/CdpCaptureDocuments.js +12 -8
  92. package/dist/browser/CdpCaptureEventBodyShapes.js +75 -0
  93. package/dist/browser/CdpCaptureEventHandlers.js +336 -0
  94. package/dist/browser/CdpCaptureEventHelpers.js +71 -0
  95. package/dist/browser/CdpCaptureEventState.js +1 -0
  96. package/dist/browser/CdpCaptureEventTypes.js +1 -0
  97. package/dist/browser/CdpCaptureEvents.js +46 -464
  98. package/dist/browser/CdpElectronInspection.js +106 -162
  99. package/dist/browser/CdpElectronProvider.js +5 -1
  100. package/dist/browser/CdpElectronScriptEvents.js +69 -0
  101. package/dist/browser/CdpElectronScripts.js +94 -0
  102. package/dist/browser/CdpElectronWorkers.js +56 -0
  103. package/dist/browser/CdpObservationSession.js +51 -8
  104. package/dist/browser/CdpPageCapture.js +12 -129
  105. package/dist/browser/CdpPageCaptureScripts.js +97 -0
  106. package/dist/browser/CdpPageCaptureWorkers.js +46 -0
  107. package/dist/browser/CdpWebMcpDiscovery.js +38 -14
  108. package/dist/browser/PngVisualDiff.js +9 -2
  109. package/dist/catalogIdentity.js +8 -1
  110. package/dist/cli/artifactCommands.js +82 -0
  111. package/dist/cli/coreAnalysisCommands.js +232 -0
  112. package/dist/cli/managedCommands.js +397 -0
  113. package/dist/cli/managedProjectGraphCommand.js +24 -0
  114. package/dist/cli/options.js +9 -0
  115. package/dist/cli/setupCommands.js +108 -0
  116. package/dist/cli/types.js +1 -0
  117. package/dist/cli/utilityCommands.js +122 -0
  118. package/dist/cli.js +13 -383
  119. package/dist/cliApplicationCommands.js +176 -0
  120. package/dist/cliBrowserAdvancedCommands.js +73 -16
  121. package/dist/cliBrowserCommands.js +39 -115
  122. package/dist/cliCommandNames.js +17 -0
  123. package/dist/cliElectronCommands.js +100 -27
  124. package/dist/cliEvidenceCommands.js +13 -2
  125. package/dist/cliInvestigationCommands.js +53 -10
  126. package/dist/cliJsonInput.js +54 -0
  127. package/dist/cliObservationOptions.js +137 -0
  128. package/dist/cliPolicyCommands.js +80 -46
  129. package/dist/cliSetup.js +289 -0
  130. package/dist/config/environment.js +107 -0
  131. package/dist/config/parseConfig.js +228 -0
  132. package/dist/config/parsers.js +68 -0
  133. package/dist/config/permissions.js +30 -0
  134. package/dist/config/types.js +1 -0
  135. package/dist/config.js +1 -292
  136. package/dist/contracts/applicationToolContracts.js +225 -0
  137. package/dist/contracts/artifactToolContracts.js +5 -9
  138. package/dist/contracts/browserToolContracts.js +14 -62
  139. package/dist/contracts/electronToolContracts.js +45 -19
  140. package/dist/contracts/errorSchemas.js +1 -0
  141. package/dist/contracts/investigationExamples.js +0 -6
  142. package/dist/contracts/javascriptApplicationWorkflowExamples.js +46 -0
  143. package/dist/contracts/javascriptRuntimeReconciliationExample.js +208 -0
  144. package/dist/contracts/managedToolContracts.js +153 -0
  145. package/dist/contracts/managedWorkflowExamples.js +346 -0
  146. package/dist/contracts/managedWorkflowToolContracts.js +203 -0
  147. package/dist/contracts/nativeToolContracts.js +2 -6
  148. package/dist/contracts/promptContracts.js +18 -2
  149. package/dist/contracts/providerSelection.js +2 -0
  150. package/dist/contracts/toolContractExamples.js +10 -25
  151. package/dist/contracts/toolContracts.js +49 -47
  152. package/dist/contracts/toolEffects.js +174 -0
  153. package/dist/contracts/toolOutputSchemaGroups.js +232 -0
  154. package/dist/contracts/toolOutputSchemaPrimitives.js +327 -0
  155. package/dist/contracts/toolOutputSchemas.js +2 -535
  156. package/dist/doctorRuntime.js +42 -1
  157. package/dist/domain/analysisErrorPresentation.js +234 -0
  158. package/dist/domain/analysisErrorProjection.js +284 -0
  159. package/dist/domain/artifactComparison.js +37 -19
  160. package/dist/domain/binaryTarget.js +87 -37
  161. package/dist/domain/browserObservation.js +1 -282
  162. package/dist/domain/browserObservationSchemas.js +286 -0
  163. package/dist/domain/bundleComparison.js +4 -4
  164. package/dist/domain/electronObservation.js +13 -0
  165. package/dist/domain/electronStaticAnalysis.js +9 -0
  166. package/dist/domain/electronStaticAnalysisBrowser.js +206 -0
  167. package/dist/domain/electronStaticAnalysisIpc.js +171 -0
  168. package/dist/domain/electronStaticAnalysisNative.js +164 -0
  169. package/dist/domain/electronStaticAnalysisTypes.js +1 -0
  170. package/dist/domain/electronStaticAnalysisValues.js +103 -0
  171. package/dist/domain/errors.js +32 -448
  172. package/dist/domain/functionComparison.js +4 -165
  173. package/dist/domain/functionComparisonDimensions.js +164 -0
  174. package/dist/domain/functionComparisonSchemas.js +3 -8
  175. package/dist/domain/inputIssueProjection.js +52 -0
  176. package/dist/domain/javascriptApplicationAnalysis.js +155 -0
  177. package/dist/domain/javascriptApplicationChangeGraph.js +231 -0
  178. package/dist/domain/javascriptApplicationEvidenceSchemas.js +18 -0
  179. package/dist/domain/javascriptApplicationGraph.js +2 -1
  180. package/dist/domain/javascriptApplicationGraphSchemas.js +7 -0
  181. package/dist/domain/javascriptApplicationVersionComparison.js +116 -0
  182. package/dist/domain/javascriptApplicationVersionComparisonSchemas.js +139 -0
  183. package/dist/domain/javascriptApplicationVersionItems.js +233 -0
  184. package/dist/domain/javascriptApplicationVersionKeys.js +170 -0
  185. package/dist/domain/javascriptExportInstrumentation.js +97 -0
  186. package/dist/domain/javascriptFeatureSeed.js +140 -0
  187. package/dist/domain/javascriptFeatureTrace.js +232 -0
  188. package/dist/domain/javascriptFeatureTraceSchemas.js +136 -0
  189. package/dist/domain/javascriptFeatureTraversal.js +100 -0
  190. package/dist/domain/javascriptNativeHandoff.js +85 -0
  191. package/dist/domain/javascriptReplay.js +361 -0
  192. package/dist/domain/javascriptRuntimeLoadState.js +106 -0
  193. package/dist/domain/javascriptRuntimeReconciliation.js +42 -0
  194. package/dist/domain/javascriptRuntimeReconciliationGraph.js +169 -0
  195. package/dist/domain/javascriptRuntimeReconciliationMatching.js +247 -0
  196. package/dist/domain/javascriptRuntimeReconciliationParsing.js +160 -0
  197. package/dist/domain/javascriptRuntimeReconciliationResult.js +119 -0
  198. package/dist/domain/javascriptRuntimeReconciliationRuntime.js +316 -0
  199. package/dist/domain/javascriptRuntimeReconciliationSchemas.js +245 -0
  200. package/dist/domain/javascriptRuntimeStaticCandidates.js +193 -0
  201. package/dist/domain/javascriptSemanticAnalysis.js +386 -0
  202. package/dist/domain/javascriptSemanticIr.js +30 -0
  203. package/dist/domain/javascriptSemanticProjection.js +366 -0
  204. package/dist/domain/javascriptSemanticState.js +40 -0
  205. package/dist/domain/javascriptSemanticTraversal.js +22 -0
  206. package/dist/domain/javascriptSemanticValues.js +352 -0
  207. package/dist/domain/javascriptStaticAnalysis.js +26 -254
  208. package/dist/domain/javascriptStaticAnalysisBundler.js +209 -0
  209. package/dist/domain/javascriptStaticAnalysisCalls.js +180 -0
  210. package/dist/domain/javascriptStaticAnalysisFindings.js +39 -0
  211. package/dist/domain/javascriptStaticAnalysisHelpers.js +81 -2
  212. package/dist/domain/javascriptStaticAnalysisState.js +6 -0
  213. package/dist/domain/knownPageCoverage.js +21 -0
  214. package/dist/domain/managedApplicationGraph.js +206 -0
  215. package/dist/domain/managedApplicationGraphCoverage.js +170 -0
  216. package/dist/domain/managedApplicationGraphNodeCoverage.js +6 -0
  217. package/dist/domain/managedApplicationGraphNodes.js +336 -0
  218. package/dist/domain/managedArtifact.js +452 -0
  219. package/dist/domain/managedMemberComparison.js +211 -0
  220. package/dist/domain/managedMemberComparisonCoverage.js +72 -0
  221. package/dist/domain/managedMemberComparisonMatch.js +356 -0
  222. package/dist/domain/managedNativeVerification.js +46 -0
  223. package/dist/domain/managedNativeVerificationMatch.js +272 -0
  224. package/dist/domain/managedNativeVerificationSchemas.js +141 -0
  225. package/dist/domain/managedReconstruction.js +196 -0
  226. package/dist/domain/managedRuntimeCorrelation.js +184 -0
  227. package/dist/domain/nodeRuntimeCharacterization.js +66 -0
  228. package/dist/domain/permissionPolicy.js +2 -0
  229. package/dist/domain/reconstructionCoverage.js +387 -0
  230. package/dist/domain/reconstructionCoverageEvaluation.js +212 -0
  231. package/dist/domain/reconstructionVerificationSchemas.js +9 -3
  232. package/dist/domain/runtimeCharacterization.js +85 -0
  233. package/dist/domain/webBundleAnalyzer.js +3 -409
  234. package/dist/domain/webBundleAnalyzerAst.js +77 -0
  235. package/dist/domain/webBundleAnalyzerInspection.js +307 -0
  236. package/dist/domain/webBundleAnalyzerResult.js +120 -0
  237. package/dist/dotnet/ManagedArtifactInspector.js +339 -0
  238. package/dist/dotnet/ManagedMemberInspector.js +153 -0
  239. package/dist/dotnet/ManagedMemberInspectorCore.js +297 -0
  240. package/dist/dotnet/ManagedMemberInstructionDecoder.js +427 -0
  241. package/dist/dotnet/ManagedMemberRows.js +120 -0
  242. package/dist/dotnet/ManagedMetadataHeaps.js +131 -0
  243. package/dist/dotnet/ManagedMetadataInventory.js +104 -0
  244. package/dist/dotnet/ManagedMetadataInventoryRows.js +292 -0
  245. package/dist/dotnet/ManagedMetadataLayout.js +259 -0
  246. package/dist/dotnet/ManagedMetadataRowSizes.js +54 -0
  247. package/dist/dotnet/ManagedMethodBodyReader.js +143 -0
  248. package/dist/dotnet/ManagedNativeBoundaryHelpers.js +311 -0
  249. package/dist/dotnet/ManagedNativeBoundaryInspector.js +143 -0
  250. package/dist/dotnet/ManagedPeReader.js +188 -0
  251. package/dist/dotnet/ManagedReaderFailure.js +10 -0
  252. package/dist/dotnet/ManagedStaticProvider.js +203 -0
  253. package/dist/generatedPackageMetadata.js +2 -2
  254. package/dist/ghidra/GhidraClient.js +76 -91
  255. package/dist/ghidra/GhidraClientStartup.js +29 -0
  256. package/dist/ghidra/GhidraClientWire.js +34 -0
  257. package/dist/ghidra/GhidraDefaults.js +1 -1
  258. package/dist/ghidra/GhidraDiagnostics.js +6 -1
  259. package/dist/ghidra/GhidraInstallation.js +20 -15
  260. package/dist/ghidra/GhidraLauncher.js +93 -29
  261. package/dist/ghidra/GhidraProvider.js +67 -161
  262. package/dist/ghidra/GhidraProviderCapabilities.js +173 -0
  263. package/dist/ghidra/GhidraSessionValues.js +2 -0
  264. package/dist/ghidra/GhidraSocketConnection.js +44 -7
  265. package/dist/ghidra/GhidraTargetSnapshot.js +30 -0
  266. package/dist/ghidra/GhidraTransport.js +71 -0
  267. package/dist/identity.js +3 -2
  268. package/dist/main/messages.js +5 -0
  269. package/dist/main/reload.js +49 -0
  270. package/dist/main/shutdown.js +25 -0
  271. package/dist/main/startup.js +14 -0
  272. package/dist/main/state.js +26 -0
  273. package/dist/main/transport.js +61 -0
  274. package/dist/main/types.js +1 -0
  275. package/dist/main.js +35 -132
  276. package/dist/process/PrivateRuntimeRoot.js +3 -2
  277. package/dist/process/ProcessOwnership.js +35 -0
  278. package/dist/process/ProviderProcess.js +2 -0
  279. package/dist/replay/JavaScriptReplayWorker.js +300 -0
  280. package/dist/replay/LinuxJavaScriptReplayRunner.js +217 -0
  281. package/dist/replay/LinuxJavaScriptReplaySandbox.js +140 -0
  282. package/dist/replay/LinuxRuntimeClosure.js +46 -0
  283. package/dist/replay/LinuxSeccompPolicy.js +40 -0
  284. package/dist/replay/ReplayOutcome.js +95 -0
  285. package/dist/replay/ReplayProcessLifecycle.js +71 -0
  286. package/dist/replay/ReplayWorkerProtocol.js +55 -0
  287. package/dist/replay/SystemJavaScriptReplayHost.js +182 -0
  288. package/dist/server/ProcessCaptureElicitation.js +157 -0
  289. package/dist/server/createServer.js +158 -41
  290. package/dist/server/registerApplicationTools/characterization.js +57 -0
  291. package/dist/server/registerApplicationTools/compareVersions.js +34 -0
  292. package/dist/server/registerApplicationTools/controlledReplay.js +38 -0
  293. package/dist/server/registerApplicationTools/coverage.js +84 -0
  294. package/dist/server/registerApplicationTools/helpers.js +42 -0
  295. package/dist/server/registerApplicationTools/traceFeature.js +26 -0
  296. package/dist/server/registerApplicationTools/types.js +1 -0
  297. package/dist/server/registerApplicationTools.js +13 -0
  298. package/dist/server/registerArtifactComparisonTool.js +16 -9
  299. package/dist/server/registerBrowserTools.js +61 -60
  300. package/dist/server/registerBundleComparisonTool.js +17 -20
  301. package/dist/server/registerElectronTools.js +39 -12
  302. package/dist/server/registerEnhancedTools.js +52 -15
  303. package/dist/server/registerEvidenceResources.js +54 -0
  304. package/dist/server/registerEvidenceTools.js +5 -1
  305. package/dist/server/registerFunctionComparisonTool.js +14 -7
  306. package/dist/server/registerInvestigationTools/helpers.js +74 -0
  307. package/dist/server/registerInvestigationTools/types.js +1 -0
  308. package/dist/server/registerInvestigationTools.js +103 -132
  309. package/dist/server/registerManagedTools.js +6 -0
  310. package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +65 -0
  311. package/dist/server/registerManagedWorkflowTools/contract.js +8 -0
  312. package/dist/server/registerManagedWorkflowTools/evidence.js +43 -0
  313. package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +39 -0
  314. package/dist/server/registerManagedWorkflowTools/planManagedRuntimeCorrelation.js +39 -0
  315. package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +52 -0
  316. package/dist/server/registerManagedWorkflowTools/types.js +1 -0
  317. package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +75 -0
  318. package/dist/server/registerManagedWorkflowTools.js +13 -0
  319. package/dist/server/registerOfficialTools.js +81 -67
  320. package/dist/server/registerProcessComparisonTool.js +25 -47
  321. package/dist/server/registerSessionRecordTools.js +137 -0
  322. package/dist/server/registerSessionStatusTool.js +9 -8
  323. package/dist/server/registerSessionTools.js +77 -216
  324. package/dist/server/sessionAvailabilityPolicy.js +10 -0
  325. package/dist/server/sessionEvidence.js +14 -19
  326. package/dist/server/toolInputValidation.js +77 -0
  327. package/dist/server/toolRegistrationOptions.js +177 -2
  328. package/dist/server/toolResult.js +30 -17
  329. package/package.json +21 -14
  330. package/scripts/rea.mjs +1 -1
  331. package/skills/{rea-analysis → reverse-engineer-anything}/SKILL.md +75 -6
  332. package/scripts/prepare-node-pty.mjs +0 -35
  333. package/scripts/rebuild-native.mjs +0 -22
@@ -0,0 +1,54 @@
1
+ import { managedFailure } from "./ManagedReaderFailure.js";
2
+ const ROW_SIZE_FACTORIES = [
3
+ ({ stringSize: s, guidSize: g }) => 2 + s + g * 3,
4
+ ({ codedSize: c, stringSize: s }) => c("ResolutionScope") + s * 2,
5
+ ({ tableSize: t, codedSize: c, stringSize: s }) => 4 + s * 2 + c("TypeDefOrRef") + t(4) + t(6),
6
+ ({ tableSize: t }) => t(4),
7
+ ({ stringSize: s, blobSize: b }) => 2 + s + b,
8
+ ({ tableSize: t }) => t(6),
9
+ ({ tableSize: t, stringSize: s, blobSize: b }) => 8 + s + b + t(8),
10
+ ({ tableSize: t }) => t(8),
11
+ ({ stringSize: s }) => 4 + s,
12
+ ({ tableSize: t, codedSize: c }) => t(2) + c("TypeDefOrRef"),
13
+ ({ codedSize: c, stringSize: s, blobSize: b }) => c("MemberRefParent") + s + b,
14
+ ({ codedSize: c, blobSize: b }) => 2 + c("HasConstant") + b,
15
+ ({ codedSize: c, blobSize: b }) => c("HasCustomAttribute") + c("CustomAttributeType") + b,
16
+ ({ codedSize: c, blobSize: b }) => c("HasFieldMarshal") + b,
17
+ ({ codedSize: c, blobSize: b }) => 2 + c("HasDeclSecurity") + b,
18
+ ({ tableSize: t }) => 6 + t(2),
19
+ ({ tableSize: t }) => 4 + t(4),
20
+ ({ blobSize: b }) => b,
21
+ ({ tableSize: t }) => t(2) + t(20),
22
+ ({ tableSize: t }) => t(20),
23
+ ({ stringSize: s, codedSize: c }) => 2 + s + c("TypeDefOrRef"),
24
+ ({ tableSize: t }) => t(2) + t(23),
25
+ ({ tableSize: t }) => t(23),
26
+ ({ stringSize: s, blobSize: b }) => 2 + s + b,
27
+ ({ tableSize: t, codedSize: c }) => 2 + t(6) + c("HasSemantics"),
28
+ ({ tableSize: t, codedSize: c }) => t(2) + c("MethodDefOrRef") * 2,
29
+ ({ stringSize: s }) => s,
30
+ ({ blobSize: b }) => b,
31
+ ({ tableSize: t, codedSize: c, stringSize: s }) => 2 + c("MemberForwarded") + s + t(26),
32
+ ({ tableSize: t }) => 4 + t(4),
33
+ () => 8,
34
+ () => 4,
35
+ ({ blobSize: b, stringSize: s }) => 16 + b + s * 2,
36
+ () => 4,
37
+ () => 12,
38
+ ({ blobSize: b, stringSize: s }) => 12 + b * 2 + s * 2,
39
+ ({ tableSize: t }) => 4 + t(35),
40
+ ({ tableSize: t }) => 12 + t(35),
41
+ ({ stringSize: s, blobSize: b }) => 4 + s + b,
42
+ ({ stringSize: s, codedSize: c }) => 8 + s * 2 + c("Implementation"),
43
+ ({ stringSize: s, codedSize: c }) => 8 + s + c("Implementation"),
44
+ ({ tableSize: t }) => t(2) * 2,
45
+ ({ stringSize: s, codedSize: c }) => 4 + c("TypeOrMethodDef") + s,
46
+ ({ codedSize: c, blobSize: b }) => c("MethodDefOrRef") + b,
47
+ ({ tableSize: t, codedSize: c }) => t(42) + c("TypeDefOrRef"),
48
+ ];
49
+ export const computeRowSize = (table, context) => {
50
+ const factory = ROW_SIZE_FACTORIES[table];
51
+ if (factory === undefined)
52
+ throw managedFailure("invalid-tables", "metadata.tables", `Metadata table ${String(table)} is unsupported`);
53
+ return factory(context);
54
+ };
@@ -0,0 +1,143 @@
1
+ import { decodeInstructions, parseExceptionRegions, } from "./ManagedMemberInstructionDecoder.js";
2
+ import { sha256Bytes } from "./ManagedMetadataHeaps.js";
3
+ const readMethodBodyHeader = (bytes, offset) => {
4
+ const first = bytes.readUInt8(offset);
5
+ if ((first & 3) === 2)
6
+ return {
7
+ format: "tiny",
8
+ size: 1,
9
+ flags: 0,
10
+ maxStack: 8,
11
+ ilSize: first >> 2,
12
+ localSig: 0,
13
+ };
14
+ if ((first & 3) !== 3)
15
+ throw new RangeError("Unsupported method body header");
16
+ if (offset > bytes.length - 12)
17
+ throw new RangeError("Fat method body header leaves artifact");
18
+ const flagsAndSize = bytes.readUInt16LE(offset);
19
+ const headerDwords = flagsAndSize >>> 12;
20
+ if (headerDwords < 3)
21
+ throw new RangeError("Fat method body header is smaller than 12 bytes");
22
+ const size = headerDwords * 4;
23
+ if (offset > bytes.length - size)
24
+ throw new RangeError("Method body header leaves artifact");
25
+ return {
26
+ format: "fat",
27
+ size,
28
+ flags: flagsAndSize & 0x0fff,
29
+ maxStack: bytes.readUInt16LE(offset + 2),
30
+ ilSize: bytes.readUInt32LE(offset + 4),
31
+ localSig: bytes.readUInt32LE(offset + 8),
32
+ };
33
+ };
34
+ export const methodBody = (bytes, pe, rva, limits) => {
35
+ if (rva === 0)
36
+ return emptyMethodBody(rva, "absent", null);
37
+ try {
38
+ const offset = pe.rvaToOffset(rva, 1, "method.body");
39
+ const header = readMethodBodyHeader(bytes, offset);
40
+ if (header.ilSize > limits.maxMethodBodyBytes)
41
+ return oversizedMethodBody(header, rva, offset, limits);
42
+ const ilOffset = offset + header.size;
43
+ if (ilOffset > bytes.length - header.ilSize)
44
+ throw new RangeError("Method IL bytes leave artifact");
45
+ const il = bytes.subarray(ilOffset, ilOffset + header.ilSize);
46
+ const decoded = decodeInstructions(il, limits.maxMethodInstructions);
47
+ const opcodeCounts = {};
48
+ for (const instruction of decoded.parsed)
49
+ opcodeCounts[instruction.opcode] =
50
+ (opcodeCounts[instruction.opcode] ?? 0) + 1;
51
+ const anchors = decoded.parsed
52
+ .map((instruction, index) => ({ instruction, index }))
53
+ .filter(({ instruction }) => instruction.operandKind !== "none")
54
+ .slice(0, limits.instructionAnchorLimit)
55
+ .map(({ instruction }) => ({
56
+ il_offset: instruction.offset,
57
+ opcode: instruction.opcode,
58
+ operand_kind: instruction.operandKind,
59
+ operand: instruction.operand,
60
+ }));
61
+ const normalized = Buffer.from(JSON.stringify(decoded.parsed.map(({ opcode, operandKind, operand }) => [
62
+ opcode,
63
+ operandKind,
64
+ operand,
65
+ ])), "utf8");
66
+ const methodEnd = ilOffset + header.ilSize;
67
+ const sectionOffset = (methodEnd + 3) & ~3;
68
+ const status = decoded.issue !== null
69
+ ? "malformed"
70
+ : decoded.truncated > 0
71
+ ? "partial"
72
+ : "present";
73
+ return {
74
+ status,
75
+ header_format: header.format,
76
+ rva,
77
+ file_offset: offset,
78
+ max_stack: header.maxStack,
79
+ init_locals: (header.flags & 0x10) !== 0,
80
+ local_var_sig_token: header.localSig === 0
81
+ ? null
82
+ : `0x${header.localSig.toString(16).padStart(8, "0")}`,
83
+ il_size: header.ilSize,
84
+ il_sha256: sha256Bytes(il),
85
+ normalized_il_sha256: status === "present" ? sha256Bytes(normalized) : null,
86
+ instruction_count: decoded.count,
87
+ decoded_instruction_count: decoded.parsed.length,
88
+ truncated_instructions: decoded.truncated,
89
+ opcode_counts: opcodeCounts,
90
+ anchors,
91
+ exception_regions: header.format === "fat" && (header.flags & 8) !== 0
92
+ ? parseExceptionRegions(bytes, sectionOffset, bytes.length)
93
+ : [],
94
+ issue: decoded.issue ??
95
+ (decoded.truncated > 0
96
+ ? `Instruction decode reached max_method_instructions ${String(limits.maxMethodInstructions)} before the end of the method body`
97
+ : null),
98
+ };
99
+ }
100
+ catch (cause) {
101
+ return emptyMethodBody(rva, "malformed", cause instanceof Error ? cause.message : "Method body parse failed");
102
+ }
103
+ };
104
+ const emptyMethodBody = (rva, status, issue) => ({
105
+ status,
106
+ header_format: status === "absent" ? "none" : "unknown",
107
+ rva,
108
+ file_offset: null,
109
+ max_stack: null,
110
+ init_locals: null,
111
+ local_var_sig_token: null,
112
+ il_size: 0,
113
+ il_sha256: null,
114
+ normalized_il_sha256: null,
115
+ instruction_count: 0,
116
+ decoded_instruction_count: 0,
117
+ truncated_instructions: 0,
118
+ opcode_counts: {},
119
+ anchors: [],
120
+ exception_regions: [],
121
+ issue,
122
+ });
123
+ const oversizedMethodBody = (header, rva, offset, limits) => ({
124
+ status: "too-large",
125
+ header_format: header.format,
126
+ rva,
127
+ file_offset: offset,
128
+ max_stack: header.maxStack,
129
+ init_locals: (header.flags & 0x10) !== 0,
130
+ local_var_sig_token: header.localSig === 0
131
+ ? null
132
+ : `0x${header.localSig.toString(16).padStart(8, "0")}`,
133
+ il_size: header.ilSize,
134
+ il_sha256: null,
135
+ normalized_il_sha256: null,
136
+ instruction_count: 0,
137
+ decoded_instruction_count: 0,
138
+ truncated_instructions: 0,
139
+ opcode_counts: {},
140
+ anchors: [],
141
+ exception_regions: [],
142
+ issue: `Method body exceeds max_method_body_bytes ${String(limits.maxMethodBodyBytes)}`,
143
+ });
@@ -0,0 +1,311 @@
1
+ import { managedNativeBoundaryInspectionSchema, } from "../domain/managedArtifact.js";
2
+ import { metadataRowOffset, } from "./ManagedMetadataLayout.js";
3
+ import { MetadataRowCursor, metadataToken, readMetadataString, } from "./ManagedMetadataHeaps.js";
4
+ import { managedTableRowCounts } from "./ManagedMetadataInventory.js";
5
+ import { managedFailure } from "./ManagedReaderFailure.js";
6
+ const rowCursor = ({ bytes, layout, table, row, }) => {
7
+ const descriptor = layout.table(table);
8
+ const start = metadataRowOffset(layout, table, row);
9
+ if (descriptor === undefined)
10
+ throw managedFailure("invalid-row", `metadata.${String(table)}`, "Metadata table is absent", start);
11
+ return new MetadataRowCursor(bytes, start, start + descriptor.rowSize, `metadata.${descriptor.name}`);
12
+ };
13
+ const codedToken = (raw, tagBits, tables) => {
14
+ const tagMask = (1 << tagBits) - 1;
15
+ const table = tables[raw & tagMask];
16
+ const row = raw >> tagBits;
17
+ if (table === undefined || row === 0)
18
+ return null;
19
+ return metadataToken(table, row);
20
+ };
21
+ const flagsHex = (value) => `0x${value.toString(16).padStart(4, "0")}`;
22
+ const page = (items, offset, limit) => {
23
+ const safeOffset = Math.min(offset, items.length);
24
+ const selected = items.slice(safeOffset, safeOffset + limit);
25
+ return {
26
+ items: selected,
27
+ offset,
28
+ limit,
29
+ total: items.length,
30
+ returned: selected.length,
31
+ dropped: Math.max(0, items.length - safeOffset - selected.length),
32
+ complete: safeOffset === 0 && selected.length === items.length,
33
+ };
34
+ };
35
+ export const parseModuleRefs = (bytes, layout, maxBytes) => {
36
+ const refs = [];
37
+ const table = layout.table(26);
38
+ for (let row = 1; row <= (table?.rowCount ?? 0); row += 1) {
39
+ const cursor = rowCursor({ bytes, layout, table: 26, row });
40
+ refs.push({
41
+ token: metadataToken(26, row),
42
+ row_offset: cursor.start,
43
+ name: readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), maxBytes),
44
+ });
45
+ }
46
+ return refs;
47
+ };
48
+ export const parseFields = (bytes, layout, maxBytes) => {
49
+ const fields = new Map();
50
+ const table = layout.table(4);
51
+ for (let row = 1; row <= (table?.rowCount ?? 0); row += 1) {
52
+ const cursor = rowCursor({ bytes, layout, table: 4, row });
53
+ const flags = cursor.readUInt16();
54
+ const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), maxBytes);
55
+ cursor.readIndex(layout.blobIndexSize);
56
+ const token = metadataToken(4, row);
57
+ fields.set(token, {
58
+ token,
59
+ rowOffset: cursor.start,
60
+ kind: "field",
61
+ name,
62
+ flags,
63
+ implFlags: null,
64
+ rva: null,
65
+ });
66
+ }
67
+ return fields;
68
+ };
69
+ export const parseMethods = (bytes, layout, maxBytes) => {
70
+ const methods = new Map();
71
+ const table = layout.table(6);
72
+ for (let row = 1; row <= (table?.rowCount ?? 0); row += 1) {
73
+ const cursor = rowCursor({ bytes, layout, table: 6, row });
74
+ const rva = cursor.readUInt32();
75
+ const implFlags = cursor.readUInt16();
76
+ const flags = cursor.readUInt16();
77
+ const name = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), maxBytes);
78
+ cursor.readIndex(layout.blobIndexSize);
79
+ cursor.readIndex(layout.tableIndexSize(8));
80
+ const token = metadataToken(6, row);
81
+ methods.set(token, {
82
+ token,
83
+ rowOffset: cursor.start,
84
+ kind: "method",
85
+ name,
86
+ flags,
87
+ implFlags,
88
+ rva,
89
+ });
90
+ }
91
+ return methods;
92
+ };
93
+ export const parseImplMaps = ({ bytes, layout, maxBytes, modules, members, }) => {
94
+ const moduleNames = new Map(modules.map((module) => [module.token, module]));
95
+ const imports = [];
96
+ const table = layout.table(28);
97
+ for (let row = 1; row <= (table?.rowCount ?? 0); row += 1) {
98
+ const cursor = rowCursor({ bytes, layout, table: 28, row });
99
+ const mappingFlags = cursor.readUInt16();
100
+ const memberToken = codedToken(cursor.readIndex(layout.codedIndexSize("MemberForwarded")), 1, [4, 6]);
101
+ const importName = readMetadataString(bytes, layout, cursor.readIndex(layout.stringIndexSize), maxBytes);
102
+ const importScopeRow = cursor.readIndex(layout.tableIndexSize(26));
103
+ const importScopeToken = importScopeRow === 0 ? null : metadataToken(26, importScopeRow);
104
+ const member = memberToken === null ? undefined : members.get(memberToken);
105
+ imports.push({
106
+ token: metadataToken(28, row),
107
+ row_offset: cursor.start,
108
+ mapping_flags: mappingFlags,
109
+ mapping_flags_hex: flagsHex(mappingFlags),
110
+ member_token: memberToken,
111
+ member_kind: member?.kind ?? "unknown",
112
+ member_name: member?.name ?? null,
113
+ import_name: importName,
114
+ import_scope_token: importScopeToken,
115
+ import_scope_name: importScopeToken === null
116
+ ? null
117
+ : (moduleNames.get(importScopeToken)?.name ?? null),
118
+ no_mangle: (mappingFlags & 0x0001) !== 0,
119
+ char_set: charSet(mappingFlags),
120
+ call_convention: callConvention(mappingFlags),
121
+ supports_last_error: (mappingFlags & 0x0040) !== 0,
122
+ best_fit: bestFit(mappingFlags),
123
+ throw_on_unmappable_char: throwOnUnmappable(mappingFlags),
124
+ verification: "managed-declaration-only",
125
+ });
126
+ }
127
+ return imports;
128
+ };
129
+ const charSet = (flags) => {
130
+ switch (flags & 0x0006) {
131
+ case 0x0000:
132
+ return "not-specified";
133
+ case 0x0002:
134
+ return "ansi";
135
+ case 0x0004:
136
+ return "unicode";
137
+ case 0x0006:
138
+ return "auto";
139
+ default:
140
+ return "unknown";
141
+ }
142
+ };
143
+ const callConvention = (flags) => {
144
+ switch (flags & 0x0700) {
145
+ case 0x0000:
146
+ return "not-specified";
147
+ case 0x0100:
148
+ return "winapi";
149
+ case 0x0200:
150
+ return "cdecl";
151
+ case 0x0300:
152
+ return "stdcall";
153
+ case 0x0400:
154
+ return "thiscall";
155
+ case 0x0500:
156
+ return "fastcall";
157
+ default:
158
+ return "unknown";
159
+ }
160
+ };
161
+ const bestFit = (flags) => {
162
+ switch (flags & 0x0030) {
163
+ case 0x0000:
164
+ return "assembly-default";
165
+ case 0x0010:
166
+ return "enabled";
167
+ case 0x0020:
168
+ return "disabled";
169
+ default:
170
+ return "unknown";
171
+ }
172
+ };
173
+ const throwOnUnmappable = (flags) => {
174
+ switch (flags & 0x3000) {
175
+ case 0x0000:
176
+ return "assembly-default";
177
+ case 0x1000:
178
+ return "enabled";
179
+ case 0x2000:
180
+ return "disabled";
181
+ default:
182
+ return "unknown";
183
+ }
184
+ };
185
+ export const nativeImplementations = (methods, pinvokeTokens) => {
186
+ const implementations = [];
187
+ for (const method of methods) {
188
+ const implFlags = method.implFlags ?? 0;
189
+ const codeType = codeTypeFor(implFlags);
190
+ const managedKind = managedKindFor(implFlags);
191
+ const pinvokeDeclared = pinvokeTokens.has(method.token) || (method.flags & 0x2000) !== 0;
192
+ if (!pinvokeDeclared && codeType === "il" && managedKind === "managed")
193
+ continue;
194
+ implementations.push({
195
+ token: method.token,
196
+ row_offset: method.rowOffset,
197
+ name: method.name,
198
+ rva: method.rva ?? 0,
199
+ flags: method.flags,
200
+ impl_flags: implFlags,
201
+ code_type: codeType,
202
+ managed_kind: managedKind,
203
+ pinvoke_declared: pinvokeDeclared,
204
+ boundary_kind: boundaryKind(pinvokeDeclared, codeType, managedKind),
205
+ body_interpretation: codeType === "il" && managedKind === "managed" && !pinvokeDeclared
206
+ ? "managed-cil"
207
+ : method.rva === 0
208
+ ? "not-file-backed"
209
+ : "native-or-runtime",
210
+ });
211
+ }
212
+ return implementations;
213
+ };
214
+ const codeTypeFor = (implFlags) => {
215
+ switch (implFlags & 0x0003) {
216
+ case 0x0000:
217
+ return "il";
218
+ case 0x0001:
219
+ return "native";
220
+ case 0x0002:
221
+ return "optil";
222
+ case 0x0003:
223
+ return "runtime";
224
+ default:
225
+ return "unknown";
226
+ }
227
+ };
228
+ const managedKindFor = (implFlags) => {
229
+ switch (implFlags & 0x0004) {
230
+ case 0x0000:
231
+ return "managed";
232
+ case 0x0004:
233
+ return "unmanaged";
234
+ default:
235
+ return "unknown";
236
+ }
237
+ };
238
+ const boundaryKind = (pinvokeDeclared, codeType, managedKind) => {
239
+ if (pinvokeDeclared)
240
+ return "pinvoke";
241
+ if (codeType === "native")
242
+ return "native-body";
243
+ if (codeType === "runtime")
244
+ return "runtime-provided";
245
+ if (managedKind === "unmanaged")
246
+ return "unmanaged-method";
247
+ return "mixed-or-unknown";
248
+ };
249
+ export const cliNative = (pe) => {
250
+ if (pe.cli === null)
251
+ return {
252
+ il_only: false,
253
+ requires_32bit: false,
254
+ strong_name_signed: false,
255
+ native_entry_point: false,
256
+ ready_to_run_signature: false,
257
+ managed_native_header_rva: 0,
258
+ managed_native_header_size: 0,
259
+ };
260
+ return {
261
+ il_only: (pe.cli.flags & 0x0000_0001) !== 0,
262
+ requires_32bit: (pe.cli.flags & 0x0000_0002) !== 0,
263
+ strong_name_signed: (pe.cli.flags & 0x0000_0008) !== 0,
264
+ native_entry_point: (pe.cli.flags & 0x0000_0010) !== 0,
265
+ ready_to_run_signature: pe.cli.readyToRunSignature,
266
+ managed_native_header_rva: pe.cli.managedNativeHeader.rva,
267
+ managed_native_header_size: pe.cli.managedNativeHeader.size,
268
+ };
269
+ };
270
+ export const buildNativeBoundaryInspection = ({ target, bytes, limits, layout, inventory, moduleRefs, imports, implementations, native, issues, }) => managedNativeBoundaryInspectionSchema.parse({
271
+ schema_version: 1,
272
+ artifact: {
273
+ path: target.path,
274
+ sha256: target.sha256,
275
+ byte_length: bytes.length,
276
+ format: "pe",
277
+ },
278
+ module: inventory.module,
279
+ metadata: {
280
+ status: issues.length === 0 ? "complete" : "partial",
281
+ version: layout.version,
282
+ table_row_counts: managedTableRowCounts(layout),
283
+ },
284
+ identity_scope: {
285
+ token_identity: "build-local",
286
+ requires_artifact_sha256: target.sha256,
287
+ requires_mvid: inventory.module?.mvid ?? null,
288
+ },
289
+ cli_native: native,
290
+ module_refs: page(moduleRefs, limits.moduleRefOffset, limits.moduleRefLimit),
291
+ pinvoke_imports: page(imports, limits.importOffset, limits.importLimit),
292
+ native_implementations: page(implementations, limits.implementationOffset, limits.implementationLimit),
293
+ summary: {
294
+ module_ref_count: moduleRefs.length,
295
+ pinvoke_import_count: imports.length,
296
+ native_implementation_count: implementations.length,
297
+ ready_to_run: native.ready_to_run_signature,
298
+ mixed_mode_or_native_header: native.managed_native_header_rva !== 0 ||
299
+ native.managed_native_header_size !== 0 ||
300
+ native.native_entry_point,
301
+ },
302
+ coverage: {
303
+ state: issues.length === 0 ? "complete" : "partial",
304
+ issues,
305
+ },
306
+ limitations: [
307
+ "P/Invoke rows prove managed import declarations only; this inspection does not verify that a native library, export, thunk, or provider-qualified function exists.",
308
+ "Managed metadata tokens are build-local coordinates and are only meaningful with the reported artifact SHA-256 and MVID.",
309
+ "ReadyToRun, NativeAOT, C++/CLI, and IL2CPP native semantics require separately selected native-provider evidence; this tool does not translate managed tokens into native addresses.",
310
+ ],
311
+ });
@@ -0,0 +1,143 @@
1
+ import { managedNativeBoundaryInspectionSchema, } from "../domain/managedArtifact.js";
2
+ import { readManagedMetadataInventory, } from "./ManagedMetadataInventory.js";
3
+ import { readManagedMetadataLayout, } from "./ManagedMetadataLayout.js";
4
+ import { readManagedPeLayout, } from "./ManagedPeReader.js";
5
+ import { ManagedReaderFailure } from "./ManagedReaderFailure.js";
6
+ import { buildNativeBoundaryInspection, cliNative, nativeImplementations, parseFields, parseImplMaps, parseMethods, parseModuleRefs, } from "./ManagedNativeBoundaryHelpers.js";
7
+ const emptyPage = () => ({
8
+ items: [],
9
+ offset: 0,
10
+ limit: 0,
11
+ total: 0,
12
+ returned: 0,
13
+ dropped: 0,
14
+ complete: true,
15
+ });
16
+ const emptyInspection = (target, bytes, classification, issues = []) => managedNativeBoundaryInspectionSchema.parse({
17
+ schema_version: 1,
18
+ artifact: {
19
+ path: target.path,
20
+ sha256: target.sha256,
21
+ byte_length: bytes.length,
22
+ format: "pe",
23
+ },
24
+ module: null,
25
+ metadata: {
26
+ status: classification === "malformed" || classification === "not-available"
27
+ ? "malformed"
28
+ : "absent",
29
+ version: null,
30
+ table_row_counts: {},
31
+ },
32
+ identity_scope: {
33
+ token_identity: "build-local",
34
+ requires_artifact_sha256: target.sha256,
35
+ requires_mvid: null,
36
+ },
37
+ cli_native: {
38
+ il_only: false,
39
+ requires_32bit: false,
40
+ strong_name_signed: false,
41
+ native_entry_point: false,
42
+ ready_to_run_signature: false,
43
+ managed_native_header_rva: 0,
44
+ managed_native_header_size: 0,
45
+ },
46
+ module_refs: emptyPage(),
47
+ pinvoke_imports: emptyPage(),
48
+ native_implementations: emptyPage(),
49
+ summary: {
50
+ module_ref_count: 0,
51
+ pinvoke_import_count: 0,
52
+ native_implementation_count: 0,
53
+ ready_to_run: false,
54
+ mixed_mode_or_native_header: false,
55
+ },
56
+ coverage: { state: classification, issues },
57
+ limitations: [
58
+ "No CLI data was admitted; native boundary declarations are unavailable.",
59
+ "Static inspection does not load or execute target code, so native export resolution is not performed.",
60
+ ],
61
+ });
62
+ const readBoundaryInventory = (bytes, pe, limits) => {
63
+ const cli = pe.cli;
64
+ const metadataOffset = pe.rvaToOffset(cli.metadata.rva, cli.metadata.size, "cli.metadata");
65
+ const layout = readManagedMetadataLayout(bytes, metadataOffset, cli.metadata.size, limits.maxTableRows);
66
+ const resourceDirectory = {
67
+ offset: pe.rvaToOffset(cli.resources.rva, cli.resources.size, "cli.resources"),
68
+ size: cli.resources.size,
69
+ };
70
+ const inventory = readManagedMetadataInventory(bytes, layout, {
71
+ referenceOffset: 0,
72
+ referenceLimit: 0,
73
+ resourceOffset: 0,
74
+ resourceLimit: 0,
75
+ attributeOffset: 0,
76
+ attributeLimit: 0,
77
+ maxHeapItemBytes: limits.maxHeapItemBytes,
78
+ }, resourceDirectory);
79
+ return { layout, inventory };
80
+ };
81
+ const metadataLimitIssue = (cli, maxBytes) => ({
82
+ code: "limit-exceeded",
83
+ scope: "cli.metadata",
84
+ offset: cli.headerOffset + 8,
85
+ detail: `CLI metadata size exceeds max_metadata_bytes ${String(maxBytes)}`,
86
+ });
87
+ /** Inspect managed/native boundary declarations from PE metadata without execution. */
88
+ export const inspectManagedNativeBoundariesBytes = (bytes, target, limits) => {
89
+ let pe;
90
+ try {
91
+ pe = readManagedPeLayout(bytes);
92
+ }
93
+ catch (cause) {
94
+ if (!(cause instanceof ManagedReaderFailure))
95
+ throw cause;
96
+ return emptyInspection(target, bytes, "malformed", [cause.issue]);
97
+ }
98
+ if (pe.cli === null)
99
+ return emptyInspection(target, bytes, pe.cliDirectoryPresent ? "malformed" : "not-managed", pe.cliIssue === null ? [] : [pe.cliIssue]);
100
+ if (pe.cli.metadata.size > limits.maxMetadataBytes)
101
+ return emptyInspection(target, bytes, "malformed", [
102
+ metadataLimitIssue(pe.cli, limits.maxMetadataBytes),
103
+ ]);
104
+ let layout;
105
+ let inventory;
106
+ try {
107
+ ({ layout, inventory } = readBoundaryInventory(bytes, pe, limits));
108
+ }
109
+ catch (cause) {
110
+ if (!(cause instanceof ManagedReaderFailure))
111
+ throw cause;
112
+ return emptyInspection(target, bytes, "malformed", [cause.issue]);
113
+ }
114
+ const moduleRefs = parseModuleRefs(bytes, layout, limits.maxHeapItemBytes);
115
+ const members = new Map([
116
+ ...parseFields(bytes, layout, limits.maxHeapItemBytes),
117
+ ...parseMethods(bytes, layout, limits.maxHeapItemBytes),
118
+ ]);
119
+ const imports = parseImplMaps({
120
+ bytes,
121
+ layout,
122
+ maxBytes: limits.maxHeapItemBytes,
123
+ modules: moduleRefs,
124
+ members,
125
+ });
126
+ const pinvokeTokens = new Set(imports
127
+ .map(({ member_token }) => member_token)
128
+ .filter((token) => token !== null));
129
+ const implementations = nativeImplementations(members.values(), pinvokeTokens);
130
+ return buildNativeBoundaryInspection({
131
+ target,
132
+ bytes,
133
+ limits,
134
+ pe,
135
+ layout,
136
+ inventory,
137
+ moduleRefs,
138
+ imports,
139
+ implementations,
140
+ native: cliNative(pe),
141
+ issues: [],
142
+ });
143
+ };