rea-agents 6.0.0 → 6.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (611) hide show
  1. package/README.md +26 -18
  2. package/bridge/android/ReaJadxBridge.java +14 -5
  3. package/bridge/ghidra/ReaGhidraBridge.java +205 -51
  4. package/bridge/hopper_bridge.py +314 -127
  5. package/bridge/mitmproxy/capture.py +0 -2
  6. package/bridge/native/rea_lldb_tracer.py +630 -94
  7. package/bridge/process/ProcessRunTokenReader.swift +39 -5
  8. package/bridge/pwntools/recorded_crash_impl.py +4 -0
  9. package/dist/android/JadxConfiguration.js +274 -31
  10. package/dist/android/JadxMcpTransport.js +18 -2
  11. package/dist/android/JadxProtocol.js +6 -0
  12. package/dist/android/JadxProvider.js +76 -37
  13. package/dist/android/JadxSession.js +23 -4
  14. package/dist/application/AnalysisContextQueries.js +8 -35
  15. package/dist/application/AnalysisDocument.js +32 -0
  16. package/dist/application/AppBundleExecutable.js +67 -21
  17. package/dist/application/BinaryTargetResolver.js +5 -3
  18. package/dist/application/BrowserEvidence.js +3 -8
  19. package/dist/application/BrowserScenarioEvidence.js +2 -18
  20. package/dist/application/CallPathTracing.js +19 -3
  21. package/dist/application/CapabilityInventory.js +48 -11
  22. package/dist/application/ClientConfigurationDocument.js +917 -8
  23. package/dist/application/ClientRegistrationIdentity.js +26 -5
  24. package/dist/application/ClientRegistrationStatus.js +29 -14
  25. package/dist/application/DirectAnalysis.js +56 -51
  26. package/dist/application/DirectAnalysisCleanup.js +72 -0
  27. package/dist/application/DirectAnalysisStatus.js +4 -5
  28. package/dist/application/Doctor.js +19 -21
  29. package/dist/application/DoctorDiagnostics.js +1 -2
  30. package/dist/application/DoctorScope.js +25 -13
  31. package/dist/application/EnhancedLiteralTracing.js +22 -25
  32. package/dist/application/EnhancedTools.js +64 -17
  33. package/dist/application/EvidenceBundleFiles.js +30 -13
  34. package/dist/application/FunctionAnalysisEvidence.js +2 -3
  35. package/dist/application/InventoryProjectionEvidence.js +4 -3
  36. package/dist/application/InvestigationProviders.js +11 -2
  37. package/dist/application/JsonFiles.js +83 -28
  38. package/dist/application/LinuxHopper.js +9 -6
  39. package/dist/application/MacHopper.js +15 -18
  40. package/dist/application/ProcedureAddressResolution.js +11 -0
  41. package/dist/application/RealHopperAssertions.js +0 -11
  42. package/dist/application/ReconstructionCoverageService.js +7 -4
  43. package/dist/application/ReconstructionObligationCandidates.js +1 -1
  44. package/dist/application/ReconstructionObligationLedgerService.js +4 -3
  45. package/dist/application/ReferenceSourceImportEntries.js +1 -1
  46. package/dist/application/Setup.js +21 -17
  47. package/dist/application/SetupClientConfiguration.js +10 -15
  48. package/dist/application/SetupHost.js +21 -29
  49. package/dist/application/SetupPlan.js +11 -9
  50. package/dist/application/SupportedClients.js +34 -1
  51. package/dist/application/Uninstall.js +82 -29
  52. package/dist/application/Update.js +18 -3
  53. package/dist/application/UpdateMaintenance.js +7 -5
  54. package/dist/application/UpdateRuntime.js +57 -36
  55. package/dist/application/WebModuleTraceService.js +4 -2
  56. package/dist/application/WebNetworkCaptureService.js +4 -2
  57. package/dist/application/WebRuntimeService.js +5 -3
  58. package/dist/application/WebScriptExportService.js +32 -6
  59. package/dist/application/WebSourceLocationService.js +4 -2
  60. package/dist/application/WorkflowEvidence.js +105 -0
  61. package/dist/application/XrefsAddressResolution.js +45 -0
  62. package/dist/application/analysisView/AnalysisViewService.js +76 -0
  63. package/dist/application/binary/AnalysisClientCleanup.js +30 -5
  64. package/dist/application/binary/AnalysisProviderEvaluation.js +22 -7
  65. package/dist/application/binary/AnalysisProviderRegistry.js +4 -6
  66. package/dist/application/binary/AnalysisSnapshotCache.js +13 -14
  67. package/dist/application/binary/BinarySession.js +161 -93
  68. package/dist/application/binary/BinarySessionComposition.js +1 -3
  69. package/dist/application/binary/BinarySessionExecution.js +3 -5
  70. package/dist/application/binary/BinarySessionOpen.js +4 -4
  71. package/dist/application/binary/BinarySessionRecords.js +26 -4
  72. package/dist/application/binary/BinarySessionStatus.js +18 -7
  73. package/dist/application/binary/CompositeProvider.js +16 -17
  74. package/dist/application/binary/LazyAnalysisProvider.js +8 -5
  75. package/dist/application/binary/SessionProviderRouter.js +27 -135
  76. package/dist/application/binaryDiagnostics/BinaryLayoutService.js +4 -2
  77. package/dist/application/binaryDiagnostics/RecordedCrashService.js +4 -2
  78. package/dist/application/evm/EvmInterfaceService.js +4 -2
  79. package/dist/application/homebrew.js +48 -0
  80. package/dist/application/investigation/EvidenceLedger.js +21 -7
  81. package/dist/application/investigation/InvestigationRecords.js +8 -0
  82. package/dist/application/javascript/ElectronActiveEvidence.js +9 -13
  83. package/dist/application/javascript/JavaScriptAnalysisControl.js +34 -0
  84. package/dist/application/javascript/JavaScriptApplicationEvidence.js +21 -4
  85. package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
  86. package/dist/application/javascript/JavaScriptApplicationService.js +27 -15
  87. package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
  88. package/dist/application/javascript/JavaScriptArtifactAnalysis.js +10 -7
  89. package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +44 -10
  90. package/dist/application/javascript/JavaScriptArtifactGraphBundlers.js +11 -3
  91. package/dist/application/javascript/JavaScriptArtifactGraphContext.js +9 -0
  92. package/dist/application/javascript/JavaScriptArtifactGraphDocuments.js +8 -5
  93. package/dist/application/javascript/JavaScriptArtifactGraphFindings.js +12 -3
  94. package/dist/application/javascript/JavaScriptArtifactGraphStructure.js +0 -1
  95. package/dist/application/javascript/JavaScriptArtifactPathResolution.js +49 -19
  96. package/dist/application/javascript/JavaScriptArtifactReconstruction.js +56 -8
  97. package/dist/application/javascript/JavaScriptModuleRelationships.js +38 -9
  98. package/dist/application/javascript/JavaScriptRecoveryService.js +4 -2
  99. package/dist/application/javascript/JavaScriptRuntimeObservationService.js +6 -4
  100. package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +3 -3
  101. package/dist/application/javascript/JavaScriptSemanticGraphAsyncProjection.js +2 -3
  102. package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +63 -61
  103. package/dist/application/javascript/JavaScriptSemanticGraphChildProcessProjection.js +1 -2
  104. package/dist/application/javascript/JavaScriptSemanticGraphDataProjection.js +2 -3
  105. package/dist/application/javascript/JavaScriptSemanticGraphFlowProjection.js +1 -5
  106. package/dist/application/javascript/JavaScriptSemanticGraphObjectProjection.js +75 -46
  107. package/dist/application/javascript/JavaScriptSemanticGraphResourceProjection.js +2 -3
  108. package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +64 -19
  109. package/dist/application/managed/ManagedApplicationGraphService.js +4 -3
  110. package/dist/application/managed/ManagedMemberComparisonService.js +9 -5
  111. package/dist/application/managed/ManagedNativeVerificationService.js +6 -4
  112. package/dist/application/managed/ManagedReconstructionService.js +4 -3
  113. package/dist/application/process/ProcessCli.js +25 -17
  114. package/dist/application/process/ProcessEvidence.js +4 -4
  115. package/dist/application/workflowInputError.js +18 -0
  116. package/dist/artifacts/ArtifactProvider.js +48 -13
  117. package/dist/artifacts/ArtifactReader.js +31 -0
  118. package/dist/artifacts/DirectoryArtifactReader.js +2 -1
  119. package/dist/artifacts/MachOSliceArtifactReader.js +106 -15
  120. package/dist/artifacts/NativeDmgArtifactReader.js +73 -21
  121. package/dist/artifacts/SafeOutputTree.js +16 -2
  122. package/dist/artifacts/ZipArtifactReader.js +11 -4
  123. package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +26 -5
  124. package/dist/artifacts/apple/DylibResolutionReader.js +17 -7
  125. package/dist/artifacts/apple/InterfaceBuilderAnalysis.js +176 -56
  126. package/dist/artifacts/apple/InterfaceBuilderDecodeBudget.js +195 -0
  127. package/dist/artifacts/apple/KeyedArchiveReader.js +55 -23
  128. package/dist/artifacts/apple/MachoLoadCommandReader.js +92 -31
  129. package/dist/artifacts/apple/NibArchive.js +81 -14
  130. package/dist/artifacts/apple/NibViewHierarchy.js +10 -3
  131. package/dist/artifacts/apple/PlistNumberLiterals.js +164 -0
  132. package/dist/artifacts/extraction/ArtifactExtraction.js +78 -21
  133. package/dist/artifacts/inventory/ArtifactGraphConstruction.js +79 -68
  134. package/dist/artifacts/inventory/ArtifactInventory.js +0 -1
  135. package/dist/artifacts/inventory/reader.js +3 -3
  136. package/dist/artifacts/inventory/scanCanonical.js +59 -38
  137. package/dist/artifacts/inventory/scanReader.js +5 -9
  138. package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
  139. package/dist/browser/BrowserScenarioPartialObservation.js +106 -0
  140. package/dist/browser/CdpBrowserProvider.js +2 -3
  141. package/dist/browser/CdpCaptureCompleteness.js +2 -0
  142. package/dist/browser/CdpCaptureEventHandlers.js +78 -15
  143. package/dist/browser/CdpCaptureEventTypes.js +5 -1
  144. package/dist/browser/CdpCaptureEvents.js +25 -1
  145. package/dist/browser/CdpCaptureValues.js +20 -0
  146. package/dist/browser/CdpConnection.js +30 -11
  147. package/dist/browser/CdpElectronProvider.js +0 -2
  148. package/dist/browser/CdpElectronScriptEvents.js +2 -8
  149. package/dist/browser/CdpElectronScripts.js +2 -3
  150. package/dist/browser/CdpOptionalCommand.js +2 -3
  151. package/dist/browser/CdpPageCapture.js +23 -1
  152. package/dist/browser/CdpPageCaptureScripts.js +2 -3
  153. package/dist/browser/CdpSafeMetadata.js +10 -10
  154. package/dist/browser/PlaywrightBrowserScenarioProvider.js +59 -44
  155. package/dist/browser/PlaywrightElectronActiveActions.js +34 -79
  156. package/dist/browser/PlaywrightElectronActiveProjection.js +141 -0
  157. package/dist/browser/PlaywrightElectronActiveProvider.js +133 -130
  158. package/dist/browser/PlaywrightScenarioArtifacts.js +1 -1
  159. package/dist/browser/PlaywrightScenarioBrowser.js +139 -39
  160. package/dist/browser/PlaywrightScenarioEvents.js +1 -1
  161. package/dist/browser/PlaywrightScenarioSession.js +39 -22
  162. package/dist/browser/WebSourceMapFetcher.js +426 -72
  163. package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
  164. package/dist/browser/assets/ScriptCaptureAdapters.js +1 -1
  165. package/dist/browser/history/CaptureFailures.js +41 -1
  166. package/dist/browser/history/CaptureRelease.js +5 -0
  167. package/dist/browser/history/HarCaptureAdapter.js +3 -3
  168. package/dist/browser/history/HarJson.js +3 -2
  169. package/dist/browser/history/HistoricalCaptureDecoder.js +4 -2
  170. package/dist/browser/history/MitmproxyCaptureAdapter.js +4 -2
  171. package/dist/catalogIdentity.js +0 -1
  172. package/dist/cli/analysisSelector.js +23 -0
  173. package/dist/cli/analysisViewCommands.js +36 -0
  174. package/dist/cli/applicationCommands.js +2 -3
  175. package/dist/cli/artifactCommands.js +11 -12
  176. package/dist/cli/coreAnalysisCommands.js +3 -3
  177. package/dist/cli/coreBinaryCommands.js +100 -37
  178. package/dist/cli/coreNativeCommands.js +9 -10
  179. package/dist/cli/electronCommands.js +10 -9
  180. package/dist/cli/interactiveSetup.js +6 -6
  181. package/dist/cli/javascriptApplicationAnalysis.js +7 -3
  182. package/dist/cli/jsonOutput.js +4 -99
  183. package/dist/cli/managedCommands.js +7 -8
  184. package/dist/cli/nativeCallCommands.js +3 -5
  185. package/dist/cli/omittableDefaults.js +50 -0
  186. package/dist/cli/processCommands.js +3 -2
  187. package/dist/cli/setupCommands.js +16 -15
  188. package/dist/cli/utilityCommands.js +9 -9
  189. package/dist/cli/webRuntimeCommands.js +8 -8
  190. package/dist/cli.js +18 -9
  191. package/dist/cliBrowserScenarioCommands.js +2 -2
  192. package/dist/cliCommandNames.js +1 -1
  193. package/dist/cliJsonInput.js +24 -5
  194. package/dist/cliOutput.js +0 -38
  195. package/dist/composition/auxiliaryAnalysisProviders.js +27 -23
  196. package/dist/composition/binary.js +9 -9
  197. package/dist/composition/browserScenario.js +2 -1
  198. package/dist/composition/directAnalysis.js +20 -13
  199. package/dist/composition/electronScenario.js +1 -1
  200. package/dist/composition/optionalObservationProviders.js +12 -7
  201. package/dist/config/environment.js +10 -0
  202. package/dist/config/ghidraStartupTimeout.js +12 -0
  203. package/dist/config/homeDirectory.js +12 -0
  204. package/dist/config/mcpResponseBudget.js +30 -0
  205. package/dist/config/parseConfig.js +8 -3
  206. package/dist/config/parsers.js +19 -22
  207. package/dist/contracts/analysisViewToolContracts.js +56 -0
  208. package/dist/contracts/applicationToolContracts.js +5 -4
  209. package/dist/contracts/artifactComparisonExample.js +2 -2
  210. package/dist/contracts/artifactToolContracts.js +1 -1
  211. package/dist/contracts/browserScenarioToolContracts.js +1 -1
  212. package/dist/contracts/browserToolContracts.js +19 -15
  213. package/dist/contracts/enhancedInputs.js +7 -5
  214. package/dist/contracts/enhancedToolContracts.js +7 -6
  215. package/dist/contracts/evm/evmToolContracts.js +1 -1
  216. package/dist/contracts/functionWorkflowToolContracts.js +1 -1
  217. package/dist/contracts/hopperMemoryContracts.js +2 -5
  218. package/dist/contracts/inputSchemaPresentation.js +90 -0
  219. package/dist/contracts/investigationExamples.js +4 -3
  220. package/dist/contracts/javascript/electronToolContracts.js +2 -2
  221. package/dist/contracts/javascript/javascriptApplicationWorkflowExamples.js +0 -20
  222. package/dist/contracts/javascript/javascriptExportShapeComparisonExample.js +245 -0
  223. package/dist/contracts/javascript/javascriptRuntimeObservationToolContracts.js +1 -1
  224. package/dist/contracts/managed/managedToolContracts.js +7 -14
  225. package/dist/contracts/managed/managedWorkflowToolContracts.js +1 -1
  226. package/dist/contracts/mobileApplicationGraphExamples.js +3 -3
  227. package/dist/contracts/native/binaryDiagnosticsToolContracts.js +1 -1
  228. package/dist/contracts/native/nativeToolContracts.js +5 -3
  229. package/dist/contracts/officialToolContracts.js +16 -16
  230. package/dist/contracts/promptContracts.js +5 -5
  231. package/dist/contracts/providerSelection.js +1 -1
  232. package/dist/contracts/sessionLifecycleInputs.js +3 -7
  233. package/dist/contracts/sessionStatusContract.js +2 -4
  234. package/dist/contracts/sessionToolContracts.js +18 -8
  235. package/dist/contracts/sessionToolSchemas.js +3 -19
  236. package/dist/contracts/toolContractExamples.js +0 -1
  237. package/dist/contracts/toolContractHelpers.js +4 -1
  238. package/dist/contracts/toolContracts.js +2 -0
  239. package/dist/contracts/toolEffects.js +1 -1
  240. package/dist/contracts/toolOutputSchemaGroups.js +160 -115
  241. package/dist/contracts/toolOutputSchemaPrimitives.js +28 -20
  242. package/dist/contracts/toolSchemaMetadata.js +41 -33
  243. package/dist/contracts/webNetworkCaptureToolContracts.js +2 -2
  244. package/dist/contracts/webRuntimeToolContracts.js +1 -1
  245. package/dist/contracts/webScriptToolContracts.js +1 -1
  246. package/dist/doctorRuntime.js +7 -5
  247. package/dist/domain/analysisErrorBase.js +8 -3
  248. package/dist/domain/analysisErrorCore.js +6 -1
  249. package/dist/domain/analysisErrorPresentation.js +90 -20
  250. package/dist/domain/analysisErrorProjection.js +130 -32
  251. package/dist/domain/analysisSnapshot.js +29 -31
  252. package/dist/domain/analysisView/analysisView.js +243 -0
  253. package/dist/domain/analysisView/analysisViewCoverage.js +19 -0
  254. package/dist/domain/analysisView/binaryLayoutView.js +159 -0
  255. package/dist/domain/analysisView/javascriptApplicationView.js +238 -0
  256. package/dist/domain/android/androidAnalysis.js +2 -4
  257. package/dist/domain/android/androidApplication.js +18 -10
  258. package/dist/domain/apple/appleApplication.js +42 -15
  259. package/dist/domain/apple/dyldEnvironment.js +73 -0
  260. package/dist/domain/apple/dylibResolution.js +130 -12
  261. package/dist/domain/apple/dylibResolutionFindings.js +9 -7
  262. package/dist/domain/apple/interfaceBuilderGraph.js +25 -14
  263. package/dist/domain/apple/interfaceBuilderKeyedArchive.js +13 -3
  264. package/dist/domain/apple/keyedArchive.js +35 -3
  265. package/dist/domain/apple/machoContainer.js +54 -0
  266. package/dist/domain/apple/plistNumbers.js +76 -0
  267. package/dist/domain/artifactComparison.js +15 -6
  268. package/dist/domain/artifactGraph.js +16 -3
  269. package/dist/domain/artifactIdentity.js +29 -0
  270. package/dist/domain/artifactInventoryEvidence.js +28 -40
  271. package/dist/domain/artifactOperationError.js +3 -3
  272. package/dist/domain/artifactPartialObservation.js +1 -0
  273. package/dist/domain/artifactPathSyntax.js +49 -0
  274. package/dist/domain/binaryTarget.js +39 -13
  275. package/dist/domain/bridgeCandidateProjection.js +71 -0
  276. package/dist/domain/browserCaptureComparison.js +13 -49
  277. package/dist/domain/browserCompleteness.js +1 -0
  278. package/dist/domain/browserNetworkEvidence.js +10 -4
  279. package/dist/domain/browserObservation.js +0 -1
  280. package/dist/domain/browserObservationError.js +24 -5
  281. package/dist/domain/browserObservationSchemas.js +14 -3
  282. package/dist/domain/browserScenario.js +0 -1
  283. package/dist/domain/browserScenarioCapture.js +1 -2
  284. package/dist/domain/browserScenarioDiff.js +0 -2
  285. package/dist/domain/browserScenarioDiffEvidence.js +0 -12
  286. package/dist/domain/browserScenarioDiffValues.js +2 -2
  287. package/dist/domain/browserScenarioValues.js +5 -10
  288. package/dist/domain/bundleComparison.js +3 -2
  289. package/dist/domain/callPath.js +8 -9
  290. package/dist/domain/callPathSchemas.js +2 -2
  291. package/dist/domain/canonicalJsonDigestSteps.js +133 -0
  292. package/dist/domain/canonicalOrdering.js +9 -5
  293. package/dist/domain/changedBehavior.js +9 -9
  294. package/dist/domain/comparisonSourceEvidence.js +40 -0
  295. package/dist/domain/completionLedgerGeneration.js +2 -1
  296. package/dist/domain/configurationErrors.js +13 -1
  297. package/dist/domain/conformancePackage.js +4 -3
  298. package/dist/domain/evidence.js +65 -36
  299. package/dist/domain/evidenceBundle.js +47 -8
  300. package/dist/domain/evidenceCompletionLedger.js +2 -1
  301. package/dist/domain/evidenceErrors.js +12 -1
  302. package/dist/domain/explicitSensitiveFailure.js +17 -1
  303. package/dist/domain/firmware/firmwareAnalysis.js +6 -7
  304. package/dist/domain/functionComparison.js +4 -5
  305. package/dist/domain/functionComparisonDimensions.js +120 -87
  306. package/dist/domain/functionComparisonNormalization.js +23 -34
  307. package/dist/domain/functionComparisonResults.js +1 -4
  308. package/dist/domain/functionComparisonSchemas.js +2 -8
  309. package/dist/domain/functionDossierEvidence.js +2 -37
  310. package/dist/domain/hopperErrors.js +23 -2
  311. package/dist/domain/hopperValues.js +51 -8
  312. package/dist/domain/immutableJson.js +114 -0
  313. package/dist/domain/inputIssueProjection.js +3 -0
  314. package/dist/domain/javascript/electronActiveObservation.js +47 -64
  315. package/dist/domain/javascript/electronObservation.js +14 -3
  316. package/dist/domain/javascript/electronStaticAnalysisBrowser.js +10 -9
  317. package/dist/domain/javascript/electronStaticAnalysisIpc.js +2 -1
  318. package/dist/domain/javascript/electronStaticAnalysisNative.js +2 -1
  319. package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
  320. package/dist/domain/javascript/javascriptApplicationAnalysis.js +71 -23
  321. package/dist/domain/javascript/javascriptApplicationEvidenceSchemas.js +2 -0
  322. package/dist/domain/javascript/javascriptApplicationGraph.js +39 -3
  323. package/dist/domain/javascript/javascriptApplicationGraphSchemas.js +9 -2
  324. package/dist/domain/javascript/javascriptApplicationVersionItems.js +5 -2
  325. package/dist/domain/javascript/javascriptApplicationVersionKeys.js +2 -1
  326. package/dist/domain/javascript/javascriptAstValues.js +20 -0
  327. package/dist/{application/javascript/JavaScriptReturnShapeProjection.js → domain/javascript/javascriptExportReturnShapeProjection.js} +4 -4
  328. package/dist/domain/javascript/javascriptExportShapeComparison.js +7 -1
  329. package/dist/domain/javascript/javascriptExportShapeComparisonIdentity.js +6 -1
  330. package/dist/domain/javascript/javascriptExportShapeComparisonSchemas.js +29 -1
  331. package/dist/domain/javascript/javascriptExportShapeSelection.js +5 -5
  332. package/dist/domain/javascript/javascriptExportShapeVariants.js +67 -14
  333. package/dist/domain/javascript/javascriptFeatureSeed.js +20 -0
  334. package/dist/domain/javascript/javascriptFeatureTraversal.js +0 -1
  335. package/dist/domain/javascript/javascriptNativeHandoff.js +1 -1
  336. package/dist/domain/javascript/javascriptRecovery.js +3 -8
  337. package/dist/domain/javascript/javascriptRuntimeLoadState.js +0 -1
  338. package/dist/domain/javascript/javascriptRuntimeObservation.js +10 -2
  339. package/dist/domain/javascript/javascriptRuntimeReconciliationMatching.js +1 -1
  340. package/dist/domain/javascript/javascriptRuntimeReconciliationParsing.js +3 -2
  341. package/dist/domain/javascript/javascriptRuntimeStaticCandidates.js +0 -1
  342. package/dist/domain/javascript/javascriptSemanticAnalysis.js +106 -5
  343. package/dist/domain/javascript/javascriptSemanticAsyncEffects.js +2 -1
  344. package/dist/domain/javascript/javascriptSemanticCalls.js +2 -1
  345. package/dist/domain/javascript/javascriptSemanticChildProcesses.js +2 -1
  346. package/dist/domain/javascript/javascriptSemanticCoverage.js +6 -5
  347. package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +9 -17
  348. package/dist/domain/javascript/javascriptSemanticDataEffects.js +23 -6
  349. package/dist/domain/javascript/javascriptSemanticGraph.js +98 -43
  350. package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +1 -0
  351. package/dist/domain/javascript/javascriptSemanticMemberMutations.js +77 -20
  352. package/dist/domain/javascript/javascriptSemanticMutationValues.js +21 -27
  353. package/dist/domain/javascript/javascriptSemanticObjects.js +83 -42
  354. package/dist/domain/javascript/javascriptSemanticPrimitives.js +18 -21
  355. package/dist/domain/javascript/javascriptSemanticProjection.js +2 -3
  356. package/dist/domain/javascript/javascriptSemanticPromises.js +2 -1
  357. package/dist/domain/javascript/javascriptSemanticQuerySchemas.js +8 -4
  358. package/dist/domain/javascript/javascriptSemanticResourceLimits.js +77 -0
  359. package/dist/domain/javascript/javascriptSemanticResources.js +1 -1
  360. package/dist/domain/javascript/javascriptSemanticReturns.js +32 -17
  361. package/dist/domain/javascript/javascriptSemanticSlots.js +72 -0
  362. package/dist/domain/javascript/javascriptSemanticValues.js +126 -61
  363. package/dist/domain/javascript/javascriptSourceMapPaths.js +104 -0
  364. package/dist/domain/javascript/javascriptSourceParser.js +6 -2
  365. package/dist/domain/javascript/javascriptStaticAnalysis.js +22 -17
  366. package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +5 -3
  367. package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +16 -5
  368. package/dist/domain/javascript/javascriptStaticAnalysisFindings.js +66 -7
  369. package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +28 -17
  370. package/dist/domain/javascript/javascriptStaticAnalysisState.js +3 -2
  371. package/dist/domain/javascript/sourceToBundleComparison.js +12 -3
  372. package/dist/domain/javascript/sourceToBundleSignals.js +47 -19
  373. package/dist/domain/jsonSerialization.js +109 -0
  374. package/dist/domain/jsonValue.js +90 -6
  375. package/dist/domain/localPath.js +6 -0
  376. package/dist/domain/managed/managedApplicationGraph.js +10 -10
  377. package/dist/domain/managed/managedArtifact.js +6 -4
  378. package/dist/domain/managed/managedInspectionEvidence.js +16 -0
  379. package/dist/domain/managed/managedMemberComparison.js +2 -9
  380. package/dist/domain/managed/managedMemberComparisonMatch.js +5 -9
  381. package/dist/domain/managed/managedNativeVerification.js +3 -11
  382. package/dist/domain/managed/managedNativeVerificationMatch.js +9 -3
  383. package/dist/domain/native/binaryLayout.js +2 -3
  384. package/dist/domain/native/fileOffsetPartialObservation.js +1 -0
  385. package/dist/domain/native/nativeApiBoundary.js +1 -1
  386. package/dist/domain/native/nativeCallObservation.js +37 -13
  387. package/dist/domain/native/nativeCallPartialObservation.js +33 -0
  388. package/dist/domain/native/nativeInstruction.js +7 -0
  389. package/dist/domain/native/recordedCrash.js +2 -3
  390. package/dist/domain/offsetDateTime.js +17 -0
  391. package/dist/domain/process/processCapture.js +21 -16
  392. package/dist/domain/process/processCaptureCoverage.js +67 -0
  393. package/dist/domain/process/processCaptureExample.js +2 -1
  394. package/dist/domain/process/processCaptureParsing.js +1 -34
  395. package/dist/domain/process/processCaptureValidation.js +81 -13
  396. package/dist/domain/process/processComparison.js +79 -26
  397. package/dist/domain/process/processObservation.js +10 -2
  398. package/dist/domain/process/processScenario.js +35 -12
  399. package/dist/domain/process/processTraceComparison.js +0 -2
  400. package/dist/domain/process/processTraceDimensionProjection.js +1 -1
  401. package/dist/domain/process/processTraceEvaluation.js +15 -11
  402. package/dist/domain/process/processTraceSpecification.js +3 -4
  403. package/dist/domain/propertyListKeys.js +1 -1
  404. package/dist/domain/propertyListXmlText.js +19 -0
  405. package/dist/domain/providerAdapterError.js +3 -1
  406. package/dist/domain/providerOperationHealth.js +54 -0
  407. package/dist/domain/reconstructionCoverage.js +5 -2
  408. package/dist/domain/reconstructionObligationLedgerSchemas.js +2 -1
  409. package/dist/domain/reconstructionReadinessSchemas.js +2 -1
  410. package/dist/domain/reconstructionVerification.js +9 -46
  411. package/dist/domain/reconstructionVerificationSchemas.js +4 -3
  412. package/dist/domain/referenceSourceGraph.js +20 -21
  413. package/dist/domain/staticRuntimeCorrelation.js +8 -45
  414. package/dist/domain/stringPatterns.js +6 -0
  415. package/dist/domain/swiftSymbolClassification.js +61 -0
  416. package/dist/domain/symbolAnalysis.js +66 -18
  417. package/dist/domain/webBundleAnalysis.js +20 -8
  418. package/dist/domain/webBundleAnalyzerInspection.js +13 -8
  419. package/dist/domain/webBundleAnalyzerResult.js +41 -2
  420. package/dist/domain/webCaptureDiff.js +0 -1
  421. package/dist/domain/webCaptureDiffSchemas.js +6 -3
  422. package/dist/domain/webEventListeners.js +3 -2
  423. package/dist/domain/webExecution.js +3 -2
  424. package/dist/domain/webRuntime.js +19 -7
  425. package/dist/domain/webScriptExport.js +1 -1
  426. package/dist/domain/webSourceLocation.js +1 -0
  427. package/dist/dotnet/ManagedArtifactInspector.js +2 -19
  428. package/dist/dotnet/ManagedMemberInspector.js +12 -18
  429. package/dist/dotnet/ManagedMemberInspectorCore.js +47 -44
  430. package/dist/dotnet/ManagedMemberRows.js +75 -62
  431. package/dist/dotnet/ManagedMetadataInventory.js +16 -22
  432. package/dist/dotnet/ManagedMethodBodyReader.js +4 -0
  433. package/dist/dotnet/ManagedNativeBoundaryHelpers.js +109 -94
  434. package/dist/dotnet/ManagedNativeBoundaryInspector.js +12 -21
  435. package/dist/dotnet/ManagedReaderFailure.js +16 -0
  436. package/dist/dotnet/ManagedStaticProvider.js +3 -5
  437. package/dist/evaluation/AgentEvaluationFixtures.js +250 -0
  438. package/dist/evaluation/AgentEvaluationReport.js +28 -0
  439. package/dist/evaluation/CodexAgentEval.js +12 -8
  440. package/dist/evaluation/KnownAnswerEvaluation.js +281 -0
  441. package/dist/evm/EvmoleInterfaceProvider.js +2 -1
  442. package/dist/firmware/FirmwareCommand.js +9 -5
  443. package/dist/firmware/FirmwareFiles.js +1 -1
  444. package/dist/firmware/FirmwareProvider.js +4 -4
  445. package/dist/generatedPackageMetadata.js +2 -2
  446. package/dist/ghidra/GhidraAnalysisProfile.js +7 -5
  447. package/dist/ghidra/GhidraClient.js +126 -34
  448. package/dist/ghidra/GhidraClientStartup.js +0 -2
  449. package/dist/ghidra/GhidraDiagnostics.js +7 -7
  450. package/dist/ghidra/GhidraDoctor.js +6 -5
  451. package/dist/ghidra/GhidraFunctionValues.js +13 -12
  452. package/dist/ghidra/GhidraInstallation.js +58 -33
  453. package/dist/ghidra/GhidraInventoryValues.js +14 -4
  454. package/dist/ghidra/GhidraJavaLaunch.js +66 -0
  455. package/dist/ghidra/GhidraLauncher.js +47 -22
  456. package/dist/ghidra/GhidraProvider.js +6 -2
  457. package/dist/ghidra/GhidraProviderCapabilities.js +20 -2
  458. package/dist/ghidra/GhidraProviderClient.js +36 -15
  459. package/dist/ghidra/GhidraSessionError.js +13 -7
  460. package/dist/ghidra/GhidraSessionRoot.js +39 -0
  461. package/dist/ghidra/GhidraTargetSnapshot.js +47 -12
  462. package/dist/ghidra/GhidraTransport.js +20 -0
  463. package/dist/ghidra/extensions/GhidraExtensions.js +17 -10
  464. package/dist/ghidra/extensions/nativeaot/NativeAotAdapter.js +8 -2
  465. package/dist/hopper/BridgeLauncher.js +65 -56
  466. package/dist/hopper/HopperAnalysisProfile.js +65 -12
  467. package/dist/hopper/HopperCleanup.js +63 -22
  468. package/dist/hopper/HopperClient.js +288 -59
  469. package/dist/hopper/HopperFileOffset.js +237 -0
  470. package/dist/hopper/HopperMachOImage.js +197 -0
  471. package/dist/hopper/HopperOperationStage.js +6 -0
  472. package/dist/hopper/HopperProvider.js +71 -19
  473. package/dist/hopper/HopperProviderCapabilities.js +19 -1
  474. package/dist/hopper/HopperRegexSearch.js +134 -0
  475. package/dist/hopper/HopperRegexWorker.js +27 -0
  476. package/dist/hopper/HopperRequestQueue.js +68 -19
  477. package/dist/hopper/HopperTargetLease.js +133 -49
  478. package/dist/hopper/LinuxPrivateDisplayProbe.js +6 -0
  479. package/dist/ida/IdaConfiguration.js +8 -3
  480. package/dist/ida/IdaInput.js +1 -7
  481. package/dist/ida/IdaMcpConnection.js +8 -4
  482. package/dist/ida/IdaOperationRunner.js +3 -3
  483. package/dist/ida/IdaProvider.js +8 -12
  484. package/dist/ida/IdaSessionClient.js +20 -18
  485. package/dist/ida/IdaWorkspace.js +12 -13
  486. package/dist/inspector/JavaScriptRuntimeScope.js +9 -1
  487. package/dist/inspector/V8InspectorCaptureProjection.js +9 -4
  488. package/dist/inspector/V8InspectorProvider.js +82 -36
  489. package/dist/javascript/recovery/WakaruCommand.js +7 -2
  490. package/dist/javascript/recovery/WakaruExecution.js +5 -2
  491. package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
  492. package/dist/javascript/sourceMaps/SourceMapCommand.js +16 -0
  493. package/dist/javascript/sourceMaps/SourceMapFormat.js +79 -31
  494. package/dist/javascript/sourceMaps/TraceSourceMap.js +14 -28
  495. package/dist/main/shutdown.js +11 -3
  496. package/dist/main/startup.js +9 -2
  497. package/dist/main/transport.js +22 -2
  498. package/dist/main.js +11 -18
  499. package/dist/mcpDoctor.js +62 -2
  500. package/dist/native/AppleDispatchCoverage.js +47 -6
  501. package/dist/native/AppleDispatchDecodeFacts.js +6 -0
  502. package/dist/native/AppleDispatchMetadata.js +6 -3
  503. package/dist/native/AppleMachoFixups.js +48 -24
  504. package/dist/native/AppleMachoSelection.js +48 -22
  505. package/dist/native/AppleObjcCategories.js +6 -2
  506. package/dist/native/AppleObjcDispatchFacets.js +5 -2
  507. package/dist/native/AppleObjcProperties.js +2 -1
  508. package/dist/native/AppleSwiftDispatchFacets.js +27 -21
  509. package/dist/native/AppleSwiftVtables.js +21 -15
  510. package/dist/native/CommandRunner.js +87 -88
  511. package/dist/native/LldbCallTracer.js +372 -103
  512. package/dist/native/LldbRetainedObservations.js +178 -0
  513. package/dist/native/NativeCallObservation.js +62 -3
  514. package/dist/native/NativeMacOSProvider.js +122 -31
  515. package/dist/native/NativeUiHelperRuntime.js +11 -2
  516. package/dist/native/NativeUiObservation.js +2 -2
  517. package/dist/native/SignatureTargetBinding.js +155 -0
  518. package/dist/native/parsers/lipo.js +71 -1
  519. package/dist/native/pwndbg/PwndbgCoreContext.js +25 -5
  520. package/dist/native/pwntools/PwntoolsDecoder.js +2 -1
  521. package/dist/native/pwntools/RecordedCrashStructureBindings.js +2 -0
  522. package/dist/process/DarwinProcessRunTokenReader.js +23 -10
  523. package/dist/process/ExecFileOutput.js +108 -6
  524. package/dist/process/OwnedCommand.js +7 -2
  525. package/dist/process/PrivateRuntimeRoot.js +10 -5
  526. package/dist/process/ProcessOwnership.js +204 -57
  527. package/dist/process/ProcessOwnershipObservation.js +60 -9
  528. package/dist/process/ProviderProcess.js +39 -10
  529. package/dist/process/capture/FilesystemSnapshot.js +50 -13
  530. package/dist/process/capture/ProcessCaptureError.js +15 -2
  531. package/dist/process/capture/ProcessCaptureLifecycle.js +235 -81
  532. package/dist/process/capture/ProcessFilesystemEffects.js +33 -3
  533. package/dist/process/capture/ProcessHarness.js +21 -25
  534. package/dist/process/capture/ProcessNormalization.js +20 -2
  535. package/dist/process/capture/ProcessSampling.js +25 -2
  536. package/dist/process/capture/TerminalRenderer.js +14 -0
  537. package/dist/process/snapshotEnvironment.js +14 -0
  538. package/dist/server/EvidenceMcpServer.js +157 -0
  539. package/dist/server/createServer.js +61 -41
  540. package/dist/server/mcpClientMetadata.js +12 -5
  541. package/dist/server/promptCompletion.js +3 -8
  542. package/dist/server/registerAnalysisViewTool.js +15 -0
  543. package/dist/server/registerAndroidTools.js +2 -5
  544. package/dist/server/registerApplicationTools/compareExportShapes.js +4 -5
  545. package/dist/server/registerApplicationTools/compareSourceToBundle.js +4 -5
  546. package/dist/server/registerApplicationTools/compareVersions.js +4 -5
  547. package/dist/server/registerApplicationTools/coverage.js +1 -2
  548. package/dist/server/registerApplicationTools/helpers.js +1 -4
  549. package/dist/server/registerApplicationTools/obligationLedger.js +4 -5
  550. package/dist/server/registerApplicationTools/projectMobileApplicationGraph.js +3 -4
  551. package/dist/server/registerApplicationTools/traceFeature.js +4 -5
  552. package/dist/server/registerApplicationTools/traceSemantics.js +4 -5
  553. package/dist/server/registerArtifactComparisonTool.js +13 -10
  554. package/dist/server/registerBinaryDiagnosticsTools.js +2 -5
  555. package/dist/server/registerBrowserScenarioTool.js +3 -6
  556. package/dist/server/registerBrowserTools.js +13 -18
  557. package/dist/server/registerBundleComparisonTool.js +5 -7
  558. package/dist/server/registerCloseLifecycleTool.js +9 -20
  559. package/dist/server/registerElectronTools.js +10 -15
  560. package/dist/server/registerEnhancedTools.js +36 -77
  561. package/dist/server/registerEvidenceTools.js +3 -6
  562. package/dist/server/registerEvmTools.js +2 -5
  563. package/dist/server/registerFirmwareTools.js +2 -5
  564. package/dist/server/registerFunctionComparisonTool.js +15 -12
  565. package/dist/server/registerInvestigationTools.js +16 -17
  566. package/dist/server/registerJavaScriptRecoveryTool.js +2 -5
  567. package/dist/server/registerJavaScriptRuntimeObservationTools.js +6 -8
  568. package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +5 -8
  569. package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +4 -7
  570. package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +6 -9
  571. package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +6 -9
  572. package/dist/server/registerOfficialTools.js +4 -21
  573. package/dist/server/registerProcessComparisonTool.js +74 -48
  574. package/dist/server/registerRecordedCrashTools.js +2 -5
  575. package/dist/server/registerSessionRecordTools.js +19 -24
  576. package/dist/server/registerSessionStatusTool.js +19 -6
  577. package/dist/server/registerSessionTools.js +20 -18
  578. package/dist/server/registerWebModuleTool.js +2 -5
  579. package/dist/server/registerWebNetworkCaptureTool.js +2 -5
  580. package/dist/server/registerWebRuntimeTools.js +4 -9
  581. package/dist/server/registerWebScriptTool.js +2 -5
  582. package/dist/server/registerWebSourceLocationTool.js +2 -5
  583. package/dist/server/runDerivedOperation.js +15 -3
  584. package/dist/server/sessionAvailabilityPolicy.js +0 -1
  585. package/dist/server/toolRegistrationOptions.js +2 -2
  586. package/dist/server/toolResult.js +75 -51
  587. package/dist/server/toolResultEncoding.js +34 -0
  588. package/dist/windows/WindowsNativeLoader.js +1 -0
  589. package/dist/windows/WindowsOwnedProcess.js +60 -15
  590. package/dist/windows/WindowsPrivateRuntime.js +7 -8
  591. package/install.sh +1 -1
  592. package/native/windows/README.md +3 -1
  593. package/native/windows/build/manifest.json +2 -2
  594. package/native/windows/build/rea-windows-x64.node +0 -0
  595. package/package.json +44 -30
  596. package/scripts/electron-active-hook-boundaries.cjs +18 -20
  597. package/scripts/electron-active-hook.cjs +241 -37
  598. package/scripts/rea.mjs +3 -6
  599. package/skills/reverse-engineer-anything/SKILL.md +12 -3
  600. package/skills/reverse-engineer-anything/references/android-applications.md +6 -3
  601. package/skills/reverse-engineer-anything/references/evidence-workflows.md +8 -4
  602. package/skills/reverse-engineer-anything/references/javascript-applications.md +20 -3
  603. package/skills/reverse-engineer-anything/references/native-and-artifacts.md +9 -0
  604. package/dist/config.js +0 -1
  605. package/dist/contracts/browserCaptureToolInputSchema.js +0 -43
  606. package/dist/contracts/process/processCaptureExample.js +0 -2
  607. package/dist/contracts/toolOutputSchemas.js +0 -2
  608. package/dist/ghidra/GhidraDefaults.js +0 -2
  609. package/dist/main/reload.js +0 -12
  610. package/dist/main/state.js +0 -3
  611. package/dist/server/sessionToolPolicies.js +0 -2
@@ -0,0 +1,54 @@
1
+ /** Caller-visible operational state for one provider bridge. */
2
+ export const PROVIDER_OPERATION_STATES = [
3
+ "idle",
4
+ "busy",
5
+ "exited",
6
+ "unreachable",
7
+ "not_started",
8
+ "unknown",
9
+ ];
10
+ /** What the caller should do next for this provider state. */
11
+ export const PROVIDER_RETRY_ACTIONS = [
12
+ "retry",
13
+ "wait",
14
+ "restart_provider",
15
+ "unknown",
16
+ ];
17
+ /** Stage that was in progress when the provider operation failed. */
18
+ export const PROVIDER_FAILURE_STAGES = [
19
+ "launch",
20
+ "connection",
21
+ "analysis",
22
+ "decompilation",
23
+ "unknown",
24
+ ];
25
+ /**
26
+ * Choose a recovery action from the observed state.
27
+ * Startup failures keep their existing install or configuration guidance.
28
+ */
29
+ export const providerRetryAction = (state, startupFailure = false) => {
30
+ if (state === "idle")
31
+ return null;
32
+ if (startupFailure && state === "exited")
33
+ return "retry";
34
+ switch (state) {
35
+ case "busy":
36
+ return "wait";
37
+ case "exited":
38
+ case "unreachable":
39
+ return "restart_provider";
40
+ case "not_started":
41
+ return "retry";
42
+ case "unknown":
43
+ return "unknown";
44
+ }
45
+ };
46
+ /** Use one stage when every retained request agrees, otherwise unknown. */
47
+ export const sharedProviderFailureStage = (requests) => {
48
+ const first = requests[0]?.stage;
49
+ if (first === undefined)
50
+ return null;
51
+ return requests.every((request) => request.stage === first)
52
+ ? first
53
+ : "unknown";
54
+ };
@@ -5,8 +5,11 @@ import { evidenceBundleSchema, parseEvidenceBundle } from "./evidenceBundle.js";
5
5
  import { evaluateReconstructionClaims, evaluateReconstructionPackageProofs, evaluateReconstructionSurfaces, evaluateReconstructionCoverageRisks, recommendedReconstructionProbes, } from "./reconstructionCoverageEvaluation.js";
6
6
  import { digestSchema } from "./../domain/digests.js";
7
7
  import { prefixedDigestSchema } from "./../domain/digests.js";
8
+ import { offsetDateTimeSchema } from "./offsetDateTime.js";
8
9
  const evidenceIdSchema = prefixedDigestSchema("ev");
9
- const stableIdSchema = z.string().regex(/^[A-Za-z][A-Za-z0-9._:/-]{0,199}$/u);
10
+ const stableIdSchema = z
11
+ .string()
12
+ .regex(/^[A-Za-z][A-Za-z0-9._:\x2f\x2d]{0,199}$/u);
10
13
  const boundedTextSchema = z.string().trim().min(1);
11
14
  const authoritySchema = z.enum([
12
15
  "observed",
@@ -86,7 +89,7 @@ const verifierContractSchema = verifierContractBaseSchema.extend({
86
89
  const verifierResultSchema = z.strictObject({
87
90
  verifier_id: stableIdSchema,
88
91
  contract_sha256: digestSchema,
89
- observed_at: z.string().datetime({ offset: true }),
92
+ observed_at: offsetDateTimeSchema,
90
93
  status: z.enum([
91
94
  "pass",
92
95
  "fail",
@@ -1,9 +1,10 @@
1
1
  import { z } from "zod";
2
+ import { STABLE_IDENTIFIER_PATTERN } from "./stringPatterns.js";
2
3
  import { evidenceBundleSchema } from "./evidenceBundle.js";
3
4
  import { digestSchema } from "./../domain/digests.js";
4
5
  import { prefixedDigestSchema } from "./../domain/digests.js";
5
6
  const evidenceIdSchema = prefixedDigestSchema("ev");
6
- const stableIdSchema = z.string().regex(/^[A-Za-z][A-Za-z0-9._:/-]*$/u);
7
+ const stableIdSchema = z.string().regex(STABLE_IDENTIFIER_PATTERN);
7
8
  const textSchema = z.string().trim().min(1);
8
9
  export const obligationStatusSchema = z.enum([
9
10
  "unowned",
@@ -1,10 +1,11 @@
1
1
  import { z } from "zod";
2
+ import { STABLE_IDENTIFIER_PATTERN } from "./stringPatterns.js";
2
3
  import { evidenceBundleSchema } from "./evidenceBundle.js";
3
4
  import { reconstructionObligationLedgerSchema } from "./reconstructionObligationLedgerSchemas.js";
4
5
  import { digestSchema } from "./../domain/digests.js";
5
6
  import { prefixedDigestSchema } from "./../domain/digests.js";
6
7
  const evidenceIdSchema = prefixedDigestSchema("ev");
7
- const stableIdSchema = z.string().regex(/^[A-Za-z][A-Za-z0-9._:/-]*$/u);
8
+ const stableIdSchema = z.string().regex(STABLE_IDENTIFIER_PATTERN);
8
9
  const boundedTextSchema = z.string().trim().min(1);
9
10
  export const readinessStatusSchema = z.enum([
10
11
  "pass",
@@ -4,17 +4,16 @@ import { z } from "zod";
4
4
  import { artifactComparisonResultSchema } from "./artifactComparison.js";
5
5
  import { artifactInventoryResultSchema } from "./artifactGraph.js";
6
6
  import { uniqueSorted } from "./canonicalOrdering.js";
7
+ import { comparisonSourceEvidenceSides } from "./comparisonSourceEvidence.js";
7
8
  import { parseEvidence } from "./evidence.js";
8
9
  import { parseEvidenceBundle } from "./evidenceBundle.js";
9
- import { functionComparisonResultSchema } from "./functionComparison.js";
10
+ import { functionComparisonResultSchema } from "./functionComparisonSchemas.js";
10
11
  import { PROCESS_PROVIDER, isProcessEvidenceProvider, } from "./process/processEvidenceProvider.js";
11
12
  import { functionDossierSchema } from "./hopperValues.js";
12
- import { deriveProcessComparisonStatus, PROCESS_COMPARISON_DIMENSIONS, processCaptureComparisonSchema, parseProcessCapture, } from "./process/processCapture.js";
13
+ import { deriveProcessComparisonStatus, PROCESS_COMPARISON_DIMENSIONS, processCaptureComparisonSchema, } from "./process/processComparison.js";
14
+ import { parseProcessCapture } from "./process/processCaptureParsing.js";
13
15
  import { reconstructionClaimResultSchema, reconstructionSpecificationSchema, reconstructionVerificationResultSchema, } from "./reconstructionVerificationSchemas.js";
14
16
  import { reconstructionClaimUnknowns, reconstructionProbes, reconstructionUnknownHeads, } from "./reconstructionUnknowns.js";
15
- const evidenceIdSchema = prefixedDigestSchema("ev");
16
- export { reconstructionVerificationInputSchema, reconstructionVerificationResultSchema, } from "./reconstructionVerificationSchemas.js";
17
- import { prefixedDigestSchema } from "./../domain/digests.js";
18
17
  const providers = {
19
18
  behavioral: {
20
19
  operation: "compare_process_captures",
@@ -78,10 +77,8 @@ const evaluateClaim = (claim, records, heads) => {
78
77
  if (comparison === undefined)
79
78
  throw new TypeError(`Missing comparison Evidence ${claim.comparison_evidence_id}`);
80
79
  validateComparisonIdentity(claim, comparison);
81
- const sides = sourceSides(claim, comparison);
82
- const allSourceIds = [...sides.left, ...sides.right];
83
- if (new Set(allSourceIds).size !== allSourceIds.length)
84
- throw new TypeError("Comparison source Evidence must be unique and two-sided");
80
+ const sides = comparisonSourceEvidenceSides(comparison);
81
+ const allSourceIds = uniqueSorted([...sides.left, ...sides.right]);
85
82
  if (!sameSet(comparison.evidence_links, allSourceIds))
86
83
  throw new TypeError("Comparison Evidence closure disagrees with its parameters");
87
84
  const sources = allSourceIds.map((id) => {
@@ -147,42 +144,6 @@ const validateComparisonIdentity = (claim, evidence) => {
147
144
  evidence.subject !== null)
148
145
  throw new TypeError("Comparison Evidence identity or authority disagrees");
149
146
  };
150
- const sourceSides = (claim, evidence) => {
151
- const parameters = evidence.parameters;
152
- let singularSides;
153
- if (claim.kind === "behavioral" ||
154
- (claim.kind === "structural-function" &&
155
- ("left_evidence_id" in parameters || "right_evidence_id" in parameters))) {
156
- const parsed = z
157
- .object({
158
- left_evidence_id: evidenceIdSchema,
159
- right_evidence_id: evidenceIdSchema,
160
- })
161
- .passthrough()
162
- .parse(parameters);
163
- singularSides = {
164
- left: [parsed.left_evidence_id],
165
- right: [parsed.right_evidence_id],
166
- };
167
- if (claim.kind === "behavioral" ||
168
- !("left_evidence_ids" in parameters || "right_evidence_ids" in parameters))
169
- return singularSides;
170
- }
171
- const parsed = z
172
- .object({
173
- left_evidence_ids: z.array(evidenceIdSchema).min(1),
174
- right_evidence_ids: z.array(evidenceIdSchema).min(1),
175
- })
176
- .passthrough()
177
- .parse(parameters);
178
- if (singularSides !== undefined &&
179
- (parsed.left_evidence_ids.length !== 1 ||
180
- parsed.right_evidence_ids.length !== 1 ||
181
- parsed.left_evidence_ids[0] !== singularSides.left[0] ||
182
- parsed.right_evidence_ids[0] !== singularSides.right[0]))
183
- throw new TypeError("Function comparison source Evidence aliases disagree");
184
- return { left: parsed.left_evidence_ids, right: parsed.right_evidence_ids };
185
- };
186
147
  const observedStatus = (claim, evidence) => {
187
148
  if (claim.kind === "behavioral") {
188
149
  const result = processCaptureComparisonSchema.parse(evidence.normalized_result);
@@ -215,6 +176,8 @@ const validateProcessStatus = (result) => {
215
176
  const authorityLimitations = (claim, sources, sides) => {
216
177
  const requiredAuthority = claim.kind === "behavioral" ? "controlled-replay" : "shipped-artifact";
217
178
  const limitations = [];
179
+ if (sides.left.some((id) => sides.right.includes(id)))
180
+ limitations.push("A source observation appears on both comparison sides; independent original and reconstruction observations are unavailable.");
218
181
  if (sources.some((source) => source.authority !== requiredAuthority ||
219
182
  (claim.kind === "structural-function"
220
183
  ? source.confidence === "inferred"
@@ -250,5 +213,5 @@ const digest = (value) => {
250
213
  return createHash("sha256").update(encoded).digest("hex");
251
214
  };
252
215
  const count = (items, status) => items.filter((item) => item.status === status).length;
253
- const sameSet = (left, right) => left.length === right.length &&
216
+ const sameSet = (left, right) => uniqueSorted(left).length === uniqueSorted(right).length &&
254
217
  uniqueSorted(left).every((id, index) => id === uniqueSorted(right)[index]);
@@ -1,10 +1,11 @@
1
1
  import { z } from "zod";
2
+ import { IDENTIFIER_PATTERN } from "./stringPatterns.js";
2
3
  import { digestSchema } from "./../domain/digests.js";
3
4
  import { prefixedDigestSchema } from "./../domain/digests.js";
4
5
  import { PROCESS_COMPARISON_DIMENSIONS } from "./process/processComparison.js";
5
6
  const evidenceIdSchema = prefixedDigestSchema("ev");
6
7
  const unknownIdSchema = prefixedDigestSchema("unk");
7
- const claimIdSchema = z.string().regex(/^[A-Za-z][A-Za-z0-9._-]*$/u);
8
+ const claimIdSchema = z.string().regex(IDENTIFIER_PATTERN);
8
9
  const titleSchema = z.string().trim().min(1);
9
10
  const verificationStatusSchema = z.enum(["pass", "fail", "unknown"]);
10
11
  const commonClaim = {
@@ -80,7 +81,7 @@ export const reconstructionClaimResultSchema = z.object({
80
81
  comparison_evidence_id: evidenceIdSchema,
81
82
  left_evidence_ids: z.array(evidenceIdSchema).min(1),
82
83
  right_evidence_ids: z.array(evidenceIdSchema).min(1),
83
- evidence_links: z.array(evidenceIdSchema).min(3),
84
+ evidence_links: z.array(evidenceIdSchema).min(2),
84
85
  unknown_ids: z.array(unknownIdSchema),
85
86
  limitations: z.array(z.string()),
86
87
  });
@@ -106,7 +107,7 @@ export const reconstructionVerificationResultSchema = z
106
107
  claim_ids: z.array(claimIdSchema).min(1),
107
108
  unknown_ids: z.array(unknownIdSchema),
108
109
  })),
109
- evidence_links: z.array(evidenceIdSchema).min(3),
110
+ evidence_links: z.array(evidenceIdSchema).min(2),
110
111
  limitations: z.array(z.string()),
111
112
  })
112
113
  .superRefine((result, context) => {
@@ -66,26 +66,27 @@ const sourceDirectorySchema = z.strictObject({
66
66
  const symlinkTargetSchema = z
67
67
  .string()
68
68
  .min(1)
69
- .refine((target) => target === "<outside-root>" ||
70
- isPortableAbsoluteSymlinkTarget(target) ||
69
+ .refine((target) => isPortableAbsoluteSymlinkTarget(target) ||
71
70
  (!target.startsWith("/") &&
72
71
  !target.includes("\\") &&
73
72
  posix.normalize(target) === target), "Expected a normalized POSIX symlink target");
74
73
  const isPortableAbsoluteSymlinkTarget = (target) => target.startsWith("/") ||
75
74
  /^[A-Za-z]:[\\/]/u.test(target) ||
76
75
  /^\\\\[^\\/]+[\\/][^\\/]+/u.test(target);
77
- const sourceSymlinkSchema = z.strictObject({
78
- ...entryBaseShape,
79
- kind: z.literal("symlink"),
80
- target: symlinkTargetSchema,
81
- target_state: z.enum([
82
- "internal",
83
- "external",
84
- "missing",
85
- "unreadable",
86
- "unknown",
87
- ]),
88
- });
76
+ const sourceSymlinkSchema = z.union([
77
+ z.strictObject({
78
+ ...entryBaseShape,
79
+ kind: z.literal("symlink"),
80
+ target: symlinkTargetSchema,
81
+ target_state: z.enum(["internal", "external", "missing"]),
82
+ }),
83
+ z.strictObject({
84
+ ...entryBaseShape,
85
+ kind: z.literal("symlink"),
86
+ target: z.null(),
87
+ target_state: z.enum(["unreadable", "unknown"]),
88
+ }),
89
+ ]);
89
90
  const sourceEntrySchema = z.union([
90
91
  sourceFileSchema,
91
92
  sourceDirectorySchema,
@@ -152,7 +153,7 @@ const graphShape = {
152
153
  caller: z
153
154
  .string()
154
155
  .min(1)
155
- .regex(/^[\w .:@/+-]+$/u),
156
+ .regex(/^[\w .:@\x2f+\x2d]+$/u),
156
157
  }),
157
158
  limitations: z.array(boundedTextSchema),
158
159
  };
@@ -232,13 +233,11 @@ const checkSymlinks = (graph, paths, context) => {
232
233
  for (const [index, entry] of graph.entries.entries()) {
233
234
  if (entry.kind !== "symlink")
234
235
  continue;
236
+ if (entry.target === null)
237
+ continue;
235
238
  const absolute = isPortableAbsoluteSymlinkTarget(entry.target);
236
- if ((entry.target_state === "external" &&
237
- entry.target !== "<outside-root>" &&
238
- !absolute) ||
239
- (entry.target_state === "internal" &&
240
- (entry.target === "<outside-root>" || absolute)) ||
241
- (entry.target_state === "missing" && entry.target === "<outside-root>"))
239
+ if ((entry.target_state === "external" && !absolute) ||
240
+ (entry.target_state === "internal" && absolute))
242
241
  context.addIssue({
243
242
  code: "custom",
244
243
  message: "Symlink target path does not match its target state",
@@ -3,10 +3,11 @@ import canonicalize from "canonicalize";
3
3
  import { z } from "zod";
4
4
  import { artifactComparisonResultSchema } from "./artifactComparison.js";
5
5
  import { uniqueSorted } from "./canonicalOrdering.js";
6
+ import { comparisonSourceEvidenceIds } from "./comparisonSourceEvidence.js";
6
7
  import { evidenceSchema, parseEvidence } from "./evidence.js";
7
- import { functionComparisonResultSchema } from "./functionComparison.js";
8
+ import { functionComparisonResultSchema } from "./functionComparisonSchemas.js";
8
9
  import { PROCESS_PROVIDER, isProcessEvidenceProvider, } from "./process/processEvidenceProvider.js";
9
- import { comparisonStatusSchema, processCaptureComparisonSchema, } from "./process/processCapture.js";
10
+ import { comparisonStatusSchema, processCaptureComparisonSchema, } from "./process/processComparison.js";
10
11
  import { PROCESS_COMPARISON_DIMENSIONS } from "./process/processComparison.js";
11
12
  import { prefixedDigestSchema } from "./../domain/digests.js";
12
13
  const evidenceIdSchema = prefixedDigestSchema("ev");
@@ -289,52 +290,14 @@ const assertComparisonIdentity = (evidence) => {
289
290
  evidence.provider.version !== "1") ||
290
291
  evidence.confidence !== "derived" ||
291
292
  evidence.authority !== "analyst-inference" ||
292
- evidence.subject !== null ||
293
- evidence.evidence_links.length < 2 ||
294
- new Set(evidence.evidence_links).size !== evidence.evidence_links.length)
293
+ evidence.subject !== null)
295
294
  throw new TypeError("Comparison Evidence operation, predicate, provider, or citations disagree");
296
- const parameterLinks = comparisonParameterLinks(evidence);
297
- if (!sameSet(parameterLinks, evidence.evidence_links))
295
+ const expectedLinks = comparisonSourceEvidenceIds(evidence);
296
+ const actualLinks = uniqueSorted(evidence.evidence_links);
297
+ if (expectedLinks.length !== actualLinks.length ||
298
+ expectedLinks.some((id, index) => id !== actualLinks[index]))
298
299
  throw new TypeError("Comparison Evidence closure disagrees with its source parameters");
299
300
  };
300
- const comparisonParameterLinks = (evidence) => {
301
- if (evidence.operation === "compare_process_captures") {
302
- const parameters = z
303
- .object({
304
- left_evidence_id: evidenceIdSchema,
305
- right_evidence_id: evidenceIdSchema,
306
- })
307
- .passthrough()
308
- .parse(evidence.parameters);
309
- return [parameters.left_evidence_id, parameters.right_evidence_id];
310
- }
311
- const parameters = z
312
- .object({
313
- left_evidence_id: evidenceIdSchema.optional(),
314
- right_evidence_id: evidenceIdSchema.optional(),
315
- left_evidence_ids: z.array(evidenceIdSchema).min(1).optional(),
316
- right_evidence_ids: z.array(evidenceIdSchema).min(1).optional(),
317
- })
318
- .passthrough()
319
- .parse(evidence.parameters);
320
- const left = parameters.left_evidence_id === undefined
321
- ? (parameters.left_evidence_ids ?? [])
322
- : [parameters.left_evidence_id];
323
- const right = parameters.right_evidence_id === undefined
324
- ? (parameters.right_evidence_ids ?? [])
325
- : [parameters.right_evidence_id];
326
- if (left.length === 0 || right.length === 0)
327
- throw new TypeError("Comparison Evidence omitted its source parameters");
328
- return [...left, ...right];
329
- };
330
- const sameSet = (left, right) => {
331
- if (left.length !== right.length)
332
- return false;
333
- const rightSet = new Set(right);
334
- return (rightSet.size === right.length &&
335
- new Set(left).size === left.length &&
336
- left.every((item) => rightSet.has(item)));
337
- };
338
301
  const observedPattern = (staticStatus, runtimeStatus) => {
339
302
  if (staticStatus === "truncated" || runtimeStatus === "truncated")
340
303
  return "truncated";
@@ -0,0 +1,6 @@
1
+ /** Portable ASCII identifier starting with a letter. */
2
+ export const IDENTIFIER_PATTERN = /^[A-Za-z][A-Za-z0-9._\x2d]*$/u;
3
+ /** Stable evidence identifier, also admitting namespace and path separators. */
4
+ export const STABLE_IDENTIFIER_PATTERN = /^[A-Za-z][A-Za-z0-9._:\x2f\x2d]*$/u;
5
+ /** Canonical padded base64, including zero pad bits and the empty encoding. */
6
+ export const CANONICAL_BASE64_PATTERN = /^(?:[A-Za-z0-9+\x2f]{4})*(?:[A-Za-z0-9+\x2f][AQgw]==|[A-Za-z0-9+\x2f]{2}[AEIMQUYcgkosw048]=)?$/;
@@ -0,0 +1,61 @@
1
+ const LEGACY_CATEGORIES = [
2
+ ["_TtC", "classes"],
3
+ ["_TtV", "structs"],
4
+ ["_TtO", "enums"],
5
+ ["_TtP", "protocols"],
6
+ ["_TtE", "extensions"],
7
+ ];
8
+ const NOMINAL_CATEGORIES = new Map([
9
+ ["C", "classes"],
10
+ ["V", "structs"],
11
+ ["O", "enums"],
12
+ ["P", "protocols"],
13
+ ]);
14
+ /**
15
+ * Recognize Swift manglings and decode literal module/nominal contexts.
16
+ * Substitutions, generic contexts, and other encodings remain unknown.
17
+ */
18
+ export const classifySwiftSymbol = (name) => {
19
+ const prefix = /^_?(?:\$[sS]|_T0)/u.exec(name);
20
+ if (prefix === null) {
21
+ if (!name.includes("_Tt"))
22
+ return undefined;
23
+ return {
24
+ category: LEGACY_CATEGORIES.find(([prefix]) => name.startsWith(prefix))?.[1] ??
25
+ null,
26
+ };
27
+ }
28
+ const mangling = name.slice(prefix[0].length);
29
+ let offset = identifierEnd(mangling, 0);
30
+ if (offset === undefined)
31
+ return { category: null };
32
+ let category = null;
33
+ for (;;) {
34
+ const end = identifierEnd(mangling, offset);
35
+ if (end === undefined)
36
+ break;
37
+ const kind = mangling.charAt(end);
38
+ const nominal = NOMINAL_CATEGORIES.get(kind);
39
+ if (nominal === undefined) {
40
+ if (kind === "E" && category !== null)
41
+ category = "extensions";
42
+ break;
43
+ }
44
+ category = nominal;
45
+ offset = end + 1;
46
+ }
47
+ return { category };
48
+ };
49
+ const identifierEnd = (mangling, offset) => {
50
+ const lengthToken = /^[1-9][0-9]*/u.exec(mangling.slice(offset))?.[0];
51
+ if (lengthToken === undefined)
52
+ return undefined;
53
+ const start = offset + lengthToken.length;
54
+ const end = start + Number(lengthToken);
55
+ // Swift identifiers with substitutions/punycode need a fuller decoder.
56
+ if (!Number.isSafeInteger(end) ||
57
+ end > mangling.length ||
58
+ !/^[A-Za-z_][A-Za-z0-9_]*$/u.test(mangling.slice(start, end)))
59
+ return undefined;
60
+ return end;
61
+ };
@@ -1,3 +1,4 @@
1
+ import { classifySwiftSymbol, } from "./swiftSymbolClassification.js";
1
2
  /** Select and deduplicate Objective-C class labels. */
2
3
  export const discoverObjcClasses = (names, pattern) => {
3
4
  const classes = uniqueByName(names
@@ -16,33 +17,80 @@ export const discoverObjcProtocols = (names) => {
16
17
  protocols: protocols.map(toJsonEntry),
17
18
  };
18
19
  };
19
- const SWIFT_CATEGORIES = [
20
- ["classes", "_TtC"],
21
- ["structs", "_TtV"],
22
- ["enums", "_TtO"],
23
- ["protocols", "_TtP"],
24
- ["extensions", "_TtE"],
25
- ];
26
- /** Categorize deduplicated Swift mangled symbols. */
27
- export const categorizeSwiftTypes = (procedures, filter = {}) => {
28
- const groups = Object.fromEntries([...SWIFT_CATEGORIES.map(([category]) => category), "other"].map((category) => [category, []]));
20
+ /** Categorize procedure names using Swift manglings at their exact addresses. */
21
+ export const categorizeSwiftTypes = (procedures, filter = {}, symbols = []) => {
22
+ const groups = Object.fromEntries(["classes", "structs", "enums", "protocols", "extensions", "other"].map((category) => [category, []]));
23
+ const aliases = swiftAliasesByAddress(symbols);
24
+ const pattern = filter.pattern;
29
25
  const seen = new Set();
26
+ const unclassifiedNames = new Set();
27
+ const unclassified = [];
30
28
  for (const entry of procedures) {
31
- if (!entry.name.includes("_Tt") || seen.has(entry.name))
29
+ if (seen.has(entry.name))
32
30
  continue;
33
- const category = SWIFT_CATEGORIES.find(([, prefix]) => entry.name.startsWith(prefix))?.[0] ?? "other";
34
- if (filter.category !== undefined && filter.category !== category)
31
+ const mangledNames = [
32
+ ...new Set([
33
+ ...(classifySwiftSymbol(entry.name) === undefined ? [] : [entry.name]),
34
+ ...(aliases.get(entry.address) ?? []),
35
+ ]),
36
+ ];
37
+ if (mangledNames.length === 0)
35
38
  continue;
36
- if (filter.pattern !== undefined && !entry.name.includes(filter.pattern))
39
+ if (pattern !== undefined &&
40
+ ![entry.name, ...mangledNames].some((name) => name.includes(pattern)))
37
41
  continue;
38
- seen.add(entry.name);
39
- groups[category]?.push(entry);
42
+ const kinds = new Set(mangledNames.map((name) => classifySwiftSymbol(name)?.category ?? null));
43
+ const category = kinds.size === 1 ? ([...kinds][0] ?? null) : null;
44
+ const item = {
45
+ address: entry.address,
46
+ name: entry.name,
47
+ mangled_names: mangledNames,
48
+ };
49
+ if (category === null && !unclassifiedNames.has(entry.name)) {
50
+ unclassifiedNames.add(entry.name);
51
+ unclassified.push({
52
+ ...item,
53
+ reason: kinds.size > 1 && !kinds.has(null)
54
+ ? "conflicting_categories"
55
+ : "category_not_decoded",
56
+ });
57
+ }
58
+ const bucket = category ?? "other";
59
+ if (filter.category === undefined || filter.category === bucket) {
60
+ seen.add(entry.name);
61
+ groups[bucket]?.push(item);
62
+ }
40
63
  }
41
64
  const categories = Object.fromEntries(Object.entries(groups).map(([category, items]) => [
42
65
  category,
43
- { count: items.length, items: items.map(toJsonEntry) },
66
+ { count: items.length, items },
44
67
  ]));
45
- return { total: seen.size, categories };
68
+ return {
69
+ total: Object.values(groups).reduce((sum, items) => sum + items.length, 0),
70
+ categories,
71
+ unclassified,
72
+ limitations: [
73
+ "Identification uses Swift mangled procedure names or same-address symbol aliases. Demangled names without retained Swift manglings cannot be identified. Counts deduplicate procedure names, not source declarations.",
74
+ ...(unclassified.length === 0
75
+ ? []
76
+ : [
77
+ "Some Swift categories could not be established from the retained manglings. Unclassified observations remain inline regardless of the category filter.",
78
+ ]),
79
+ ],
80
+ };
81
+ };
82
+ const swiftAliasesByAddress = (symbols) => {
83
+ const aliases = new Map();
84
+ for (const { address, name } of symbols) {
85
+ if (classifySwiftSymbol(name) === undefined)
86
+ continue;
87
+ const existing = aliases.get(address);
88
+ if (existing === undefined)
89
+ aliases.set(address, [name]);
90
+ else
91
+ existing.push(name);
92
+ }
93
+ return aliases;
46
94
  };
47
95
  const uniqueByName = (entries) => {
48
96
  const seen = new Set();
@@ -88,24 +88,36 @@ export const webSourceMapsSchema = z
88
88
  requested: z.number().int().min(0),
89
89
  processed: z.number().int().min(0),
90
90
  items: z.array(sourceMapSchema),
91
+ limitation: z.string().min(1).optional(),
91
92
  })
92
93
  .superRefine((sourceMaps, context) => {
93
- if (sourceMaps.requested !== sourceMaps.processed ||
94
+ if (sourceMaps.processed > sourceMaps.requested ||
94
95
  sourceMaps.processed !== sourceMaps.items.length)
95
96
  context.addIssue({
96
97
  code: "custom",
97
98
  message: "Source-map coverage counts are inconsistent",
98
99
  });
100
+ if (sourceMaps.processed < sourceMaps.requested &&
101
+ sourceMaps.limitation === undefined)
102
+ context.addIssue({
103
+ code: "custom",
104
+ message: "Unprocessed source maps require an explicit coverage limitation",
105
+ path: ["limitation"],
106
+ });
99
107
  const statuses = sourceMaps.items.map(({ status }) => status);
100
108
  const retained = statuses.filter((status) => status === "included" || status === "partial").length;
101
- const allowedStatuses = sourceMaps.items.length === 0
102
- ? ["not_requested", "unavailable"]
103
- : retained === 0
109
+ const allowedStatuses = sourceMaps.processed < sourceMaps.requested
110
+ ? retained === 0
104
111
  ? ["unavailable"]
105
- : retained === sourceMaps.items.length &&
106
- !statuses.includes("partial")
107
- ? ["included"]
108
- : ["partial"];
112
+ : ["partial"]
113
+ : sourceMaps.items.length === 0
114
+ ? ["not_requested", "unavailable"]
115
+ : retained === 0
116
+ ? ["unavailable"]
117
+ : retained === sourceMaps.items.length &&
118
+ !statuses.includes("partial")
119
+ ? ["included"]
120
+ : ["partial"];
109
121
  if (!allowedStatuses.includes(sourceMaps.status))
110
122
  context.addIssue({
111
123
  code: "custom",
@@ -2,6 +2,7 @@ import { parse } from "@babel/parser";
2
2
  import * as t from "@babel/types";
3
3
  import { sanitizeEndpointCandidate } from "./browserObservation.js";
4
4
  import { traverseJavaScriptAst } from "./javascript/javascriptSemanticTraversal.js";
5
+ import { classifyParsedJavaScriptOpenReceivers } from "./javascript/javascriptSemanticAnalysis.js";
5
6
  import { semanticStaticPropertyName } from "./javascript/javascriptAstValues.js";
6
7
  import { calleeName, endpointArgument, stringValue, } from "./javascript/javascriptStaticAnalysisHelpers.js";
7
8
  import { location, locationFields, objectString, objectValue, resolveSpecifier, isUrlLikeModuleSpecifier, } from "./webBundleAnalyzerAst.js";
@@ -22,14 +23,15 @@ export const analyzeScript = (script, accumulator) => {
22
23
  }
23
24
  accumulator.parsedScripts += 1;
24
25
  detectVendorFingerprints(script, accumulator);
26
+ const openReceiverFacts = classifyParsedJavaScriptOpenReceivers(file);
25
27
  traverseJavaScriptAst(file, {
26
28
  enter: (node) => {
27
29
  accumulator.visitedNodes += 1;
28
- inspectNode(script, node, accumulator);
30
+ inspectNode(script, node, accumulator, openReceiverFacts);
29
31
  },
30
32
  });
31
33
  };
32
- const inspectNode = (script, node, accumulator) => {
34
+ const inspectNode = (script, node, accumulator, openReceiverFacts) => {
33
35
  if ((t.isImportDeclaration(node) || t.isExportAllDeclaration(node)) &&
34
36
  node.source !== undefined)
35
37
  addEdge({
@@ -57,10 +59,12 @@ const inspectNode = (script, node, accumulator) => {
57
59
  });
58
60
  if (t.isObjectProperty(node))
59
61
  inspectRouteProperty(script, node, accumulator);
60
- if (t.isCallExpression(node) || t.isNewExpression(node))
61
- inspectCall(script, node, accumulator);
62
+ if (t.isCallExpression(node) ||
63
+ t.isOptionalCallExpression(node) ||
64
+ t.isNewExpression(node))
65
+ inspectCall(script, node, accumulator, openReceiverFacts);
62
66
  };
63
- const inspectCall = (script, node, accumulator) => {
67
+ const inspectCall = (script, node, accumulator, openReceiverFacts) => {
64
68
  const name = calleeName(node.callee);
65
69
  const first = stringValue(node.arguments[0]);
66
70
  if ((name === "require" || name.endsWith(".require")) && first !== undefined)
@@ -95,7 +99,7 @@ const inspectCall = (script, node, accumulator) => {
95
99
  accumulator,
96
100
  });
97
101
  }
98
- const endpoint = endpointArgument(name, node.arguments, node.callee);
102
+ const endpoint = endpointArgument(name, node.arguments, node.callee, openReceiverFacts.get(node.start ?? -1));
99
103
  if (endpoint !== undefined)
100
104
  addFinding({
101
105
  collection: accumulator.endpoints,
@@ -105,8 +109,9 @@ const inspectCall = (script, node, accumulator) => {
105
109
  node,
106
110
  accumulator,
107
111
  });
108
- if (name.endsWith("modelContext.registerTool") ||
109
- name === "modelContext.registerTool")
112
+ if ((t.isCallExpression(node) || t.isNewExpression(node)) &&
113
+ (name.endsWith("modelContext.registerTool") ||
114
+ name === "modelContext.registerTool"))
110
115
  addWebMcpDeclaration(script, node, accumulator);
111
116
  };
112
117
  const inspectRouteProperty = (script, node, accumulator) => {