rea-agents 5.0.0 → 6.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (507) hide show
  1. package/README.md +168 -655
  2. package/bridge/android/ReaJadxBridge.java +14 -5
  3. package/bridge/ghidra/ReaGhidraBridge.java +173 -47
  4. package/bridge/hopper_bridge.py +310 -128
  5. package/bridge/mitmproxy/capture.py +208 -0
  6. package/bridge/native/rea_lldb_tracer.py +839 -0
  7. package/bridge/process/ProcessRunTokenReader.swift +297 -0
  8. package/bridge/process/ProcessRunTokenReaderMain.swift +35 -0
  9. package/bridge/pwndbg/core_context.py +101 -0
  10. package/bridge/pwndbg/launch.py +39 -0
  11. package/bridge/pwndbg/launch_impl.py +34 -0
  12. package/bridge/pwntools/decoder_runtime.py +59 -0
  13. package/bridge/pwntools/layout.py +39 -0
  14. package/bridge/pwntools/layout_impl.py +309 -0
  15. package/bridge/pwntools/recorded_crash.py +39 -0
  16. package/bridge/pwntools/recorded_crash_impl.py +147 -0
  17. package/dist/android/JadxConfiguration.js +196 -33
  18. package/dist/android/JadxMcpTransport.js +4 -0
  19. package/dist/android/JadxProtocol.js +6 -0
  20. package/dist/android/JadxProvider.js +20 -2
  21. package/dist/android/JadxSession.js +23 -4
  22. package/dist/application/AnalysisContextQueries.js +8 -35
  23. package/dist/application/AnalysisDocument.js +32 -0
  24. package/dist/application/AppBundleExecutable.js +67 -21
  25. package/dist/application/CallPathTracing.js +19 -3
  26. package/dist/application/CapabilityInventory.js +27 -3
  27. package/dist/application/ClientConfigurationDocument.js +871 -6
  28. package/dist/application/ClientRegistrationIdentity.js +26 -5
  29. package/dist/application/ClientRegistrationStatus.js +29 -14
  30. package/dist/application/DirectAnalysis.js +97 -33
  31. package/dist/application/Doctor.js +4 -2
  32. package/dist/application/DoctorScope.js +25 -13
  33. package/dist/application/EnhancedLiteralTracing.js +22 -25
  34. package/dist/application/EnhancedTools.js +13 -11
  35. package/dist/application/EvidenceBundleFiles.js +24 -12
  36. package/dist/application/FunctionAnalysisEvidence.js +2 -3
  37. package/dist/application/InventoryProjectionEvidence.js +4 -3
  38. package/dist/application/InvestigationProviders.js +3 -2
  39. package/dist/application/JsonFiles.js +50 -28
  40. package/dist/application/ProcedureAddressResolution.js +11 -0
  41. package/dist/application/ReconstructionCoverageService.js +7 -4
  42. package/dist/application/ReconstructionObligationCandidates.js +5 -1
  43. package/dist/application/ReconstructionObligationLedgerService.js +4 -3
  44. package/dist/application/Setup.js +13 -1
  45. package/dist/application/SetupClientConfiguration.js +10 -15
  46. package/dist/application/SetupHost.js +5 -2
  47. package/dist/application/SetupPlan.js +5 -3
  48. package/dist/application/SupportedClients.js +34 -1
  49. package/dist/application/Uninstall.js +4 -3
  50. package/dist/application/Update.js +18 -3
  51. package/dist/application/UpdateRuntime.js +46 -25
  52. package/dist/application/WebModuleTraceService.js +4 -2
  53. package/dist/application/WebNetworkCapturePort.js +1 -0
  54. package/dist/application/WebNetworkCaptureService.js +134 -0
  55. package/dist/application/WebRuntimeService.js +5 -3
  56. package/dist/application/WebScriptExportService.js +2 -2
  57. package/dist/application/WebSourceLocationService.js +4 -2
  58. package/dist/application/WindowsCapabilities.js +1 -1
  59. package/dist/application/WorkflowEvidence.js +82 -0
  60. package/dist/application/binary/AnalysisProviderEvaluation.js +21 -5
  61. package/dist/application/binary/AnalysisProviderRegistry.js +2 -0
  62. package/dist/application/binary/AnalysisSnapshotCache.js +52 -12
  63. package/dist/application/binary/BinarySession.js +131 -76
  64. package/dist/application/binary/BinarySessionOpen.js +19 -6
  65. package/dist/application/binary/BinarySessionRecords.js +45 -3
  66. package/dist/application/binary/BinarySessionStatus.js +17 -1
  67. package/dist/application/binary/CompositeProvider.js +13 -0
  68. package/dist/application/binary/LazyAnalysisProvider.js +3 -0
  69. package/dist/application/binaryDiagnostics/BinaryLayoutPort.js +1 -0
  70. package/dist/application/binaryDiagnostics/BinaryLayoutService.js +59 -0
  71. package/dist/application/binaryDiagnostics/RecordedCrashPort.js +1 -0
  72. package/dist/application/binaryDiagnostics/RecordedCrashService.js +62 -0
  73. package/dist/application/evm/EvmInterfacePort.js +1 -0
  74. package/dist/application/evm/EvmInterfaceService.js +64 -0
  75. package/dist/application/investigation/EvidenceLedger.js +21 -7
  76. package/dist/application/investigation/InvestigationRecords.js +8 -0
  77. package/dist/application/javascript/JavaScriptAnalysisControl.js +34 -0
  78. package/dist/application/javascript/JavaScriptApplicationEvidence.js +25 -5
  79. package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
  80. package/dist/application/javascript/JavaScriptApplicationService.js +34 -14
  81. package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
  82. package/dist/application/javascript/JavaScriptArtifactAnalysis.js +47 -27
  83. package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +39 -7
  84. package/dist/application/javascript/JavaScriptArtifactGraphDocuments.js +26 -2
  85. package/dist/application/javascript/JavaScriptArtifactPathResolution.js +80 -27
  86. package/dist/application/javascript/JavaScriptArtifactReconstruction.js +33 -12
  87. package/dist/application/javascript/JavaScriptModuleRelationships.js +37 -8
  88. package/dist/application/javascript/JavaScriptRecoveryService.js +4 -2
  89. package/dist/application/javascript/JavaScriptRuntimeObservationService.js +3 -1
  90. package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +3 -3
  91. package/dist/application/javascript/JavaScriptSemanticGraphAsyncProjection.js +7 -7
  92. package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +149 -72
  93. package/dist/application/javascript/JavaScriptSemanticGraphChildProcessProjection.js +14 -15
  94. package/dist/application/javascript/JavaScriptSemanticGraphConstruction.js +41 -1
  95. package/dist/application/javascript/JavaScriptSemanticGraphDataProjection.js +7 -7
  96. package/dist/application/javascript/JavaScriptSemanticGraphFlowProjection.js +5 -9
  97. package/dist/application/javascript/JavaScriptSemanticGraphObjectProjection.js +3 -3
  98. package/dist/application/javascript/JavaScriptSemanticGraphProjection.js +118 -12
  99. package/dist/application/javascript/JavaScriptSemanticGraphResourceProjection.js +3 -3
  100. package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +27 -5
  101. package/dist/application/managed/ManagedApplicationGraphService.js +4 -3
  102. package/dist/application/managed/ManagedMemberComparisonService.js +7 -4
  103. package/dist/application/managed/ManagedNativeVerificationService.js +4 -3
  104. package/dist/application/managed/ManagedReconstructionService.js +4 -3
  105. package/dist/application/{ProcessCli.js → process/ProcessCli.js} +23 -15
  106. package/dist/application/{ProcessEvidence.js → process/ProcessEvidence.js} +8 -7
  107. package/dist/application/workflowInputError.js +18 -0
  108. package/dist/artifacts/ArtifactProvider.js +42 -5
  109. package/dist/artifacts/ArtifactProviderMetadata.js +2 -1
  110. package/dist/artifacts/MachOSliceArtifactReader.js +98 -14
  111. package/dist/artifacts/NativeDmgArtifactReader.js +13 -6
  112. package/dist/artifacts/ZipArtifactReader.js +3 -0
  113. package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +22 -3
  114. package/dist/artifacts/apple/DylibResolutionReader.js +259 -0
  115. package/dist/artifacts/apple/InterfaceBuilderAnalysis.js +176 -56
  116. package/dist/artifacts/apple/InterfaceBuilderDecodeBudget.js +195 -0
  117. package/dist/artifacts/apple/KeyedArchiveReader.js +36 -22
  118. package/dist/artifacts/apple/MachoLoadCommandReader.js +355 -0
  119. package/dist/artifacts/apple/NibArchive.js +81 -14
  120. package/dist/artifacts/apple/NibViewHierarchy.js +10 -3
  121. package/dist/artifacts/apple/PlistNumberLiterals.js +164 -0
  122. package/dist/{application → artifacts/extraction}/ArtifactExtraction.js +10 -10
  123. package/dist/{application → artifacts/inventory}/ArtifactGraphConstruction.js +16 -11
  124. package/dist/{application → artifacts/inventory}/ArtifactInventory.js +4 -4
  125. package/dist/{application/ArtifactInventory → artifacts/inventory}/classify.js +2 -2
  126. package/dist/{application/ArtifactInventory → artifacts/inventory}/reader.js +5 -5
  127. package/dist/{application/ArtifactInventory → artifacts/inventory}/scanCanonical.js +14 -17
  128. package/dist/{application/ArtifactInventory → artifacts/inventory}/scanReader.js +5 -5
  129. package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
  130. package/dist/artifacts/readStableArtifact.js +20 -4
  131. package/dist/browser/CdpCaptureCompleteness.js +2 -0
  132. package/dist/browser/CdpCaptureEventHandlers.js +165 -12
  133. package/dist/browser/CdpCaptureEventTypes.js +5 -1
  134. package/dist/browser/CdpCaptureEvents.js +34 -0
  135. package/dist/browser/CdpConnection.js +30 -11
  136. package/dist/browser/CdpOptionalCommand.js +2 -3
  137. package/dist/browser/CdpPageCapture.js +23 -1
  138. package/dist/browser/PlaywrightElectronActiveActions.js +32 -23
  139. package/dist/browser/PlaywrightElectronActiveProjection.js +141 -0
  140. package/dist/browser/PlaywrightElectronActiveProvider.js +130 -122
  141. package/dist/browser/WebSourceMapFetcher.js +426 -72
  142. package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
  143. package/dist/browser/history/CaptureFailures.js +137 -0
  144. package/dist/browser/history/CaptureFormatError.js +10 -0
  145. package/dist/browser/history/CaptureRedaction.js +65 -0
  146. package/dist/browser/history/CaptureRelease.js +17 -0
  147. package/dist/browser/history/HarCapture.js +165 -0
  148. package/dist/browser/history/HarCaptureAdapter.js +20 -0
  149. package/dist/browser/history/HarCaptureProcess.js +57 -0
  150. package/dist/browser/history/HarJson.js +92 -0
  151. package/dist/browser/history/HarSchema.js +72 -0
  152. package/dist/browser/history/HistoricalCaptureDecoder.js +188 -0
  153. package/dist/browser/history/HistoricalCaptureFormatAdapter.js +1 -0
  154. package/dist/browser/history/MitmproxyCaptureAdapter.js +42 -0
  155. package/dist/cli/analysisSelector.js +23 -0
  156. package/dist/cli/applicationCommands.js +2 -3
  157. package/dist/cli/artifactCommands.js +26 -1
  158. package/dist/cli/binaryDiagnosticsCommands.js +39 -0
  159. package/dist/cli/coreAnalysisCommands.js +2 -2
  160. package/dist/cli/coreBinaryCommands.js +78 -20
  161. package/dist/cli/electronCommands.js +21 -13
  162. package/dist/cli/evmCommands.js +24 -0
  163. package/dist/cli/firmwareCommands.js +6 -3
  164. package/dist/cli/javascriptApplicationAnalysis.js +20 -3
  165. package/dist/cli/jsonOutput.js +38 -0
  166. package/dist/cli/nativeCallCommands.js +34 -0
  167. package/dist/cli/processCommands.js +1 -1
  168. package/dist/cli/streamedJsonOutput.js +56 -0
  169. package/dist/cli/utilityCommands.js +2 -0
  170. package/dist/cli/webNetworkCaptureCommands.js +40 -0
  171. package/dist/cli/webRuntimeCommands.js +8 -8
  172. package/dist/cli.js +11 -4
  173. package/dist/cliBrowserScenarioCommands.js +2 -2
  174. package/dist/cliCommandNames.js +6 -1
  175. package/dist/cliJsonInput.js +35 -1
  176. package/dist/cliOutput.js +21 -6
  177. package/dist/composition/binaryDiagnostics.js +8 -0
  178. package/dist/composition/evm.js +4 -0
  179. package/dist/composition/webNetworkCaptures.js +6 -0
  180. package/dist/config/environment.js +4 -0
  181. package/dist/config/ghidraStartupTimeout.js +17 -0
  182. package/dist/config/mcpResponseBudget.js +22 -0
  183. package/dist/config/parseConfig.js +2 -1
  184. package/dist/contracts/artifactToolContracts.js +6 -0
  185. package/dist/contracts/browserCaptureToolInputSchema.js +43 -0
  186. package/dist/contracts/browserToolContracts.js +4 -3
  187. package/dist/contracts/enhancedInputs.js +5 -3
  188. package/dist/contracts/enhancedToolContracts.js +3 -3
  189. package/dist/contracts/errorSchemas.js +8 -1
  190. package/dist/contracts/evm/evmToolContracts.js +20 -0
  191. package/dist/contracts/hopperMemoryContracts.js +2 -5
  192. package/dist/contracts/investigationExamples.js +2 -2
  193. package/dist/contracts/javascript/electronToolContracts.js +1 -1
  194. package/dist/contracts/managed/managedToolContracts.js +8 -6
  195. package/dist/contracts/native/binaryDiagnosticsToolContracts.js +42 -0
  196. package/dist/contracts/native/nativeToolContracts.js +21 -3
  197. package/dist/contracts/officialToolContracts.js +26 -24
  198. package/dist/contracts/process/processCaptureExample.js +2 -0
  199. package/dist/contracts/promptContracts.js +3 -3
  200. package/dist/contracts/sessionLifecycleInputs.js +18 -5
  201. package/dist/contracts/sessionStatusContract.js +8 -2
  202. package/dist/contracts/sessionToolContracts.js +8 -3
  203. package/dist/contracts/sessionToolSchemas.js +8 -4
  204. package/dist/contracts/toolContractExamples.js +1 -2
  205. package/dist/contracts/toolContractHelpers.js +4 -1
  206. package/dist/contracts/toolContracts.js +6 -0
  207. package/dist/contracts/toolEffects.js +30 -1
  208. package/dist/contracts/toolOutputSchemaGroups.js +33 -28
  209. package/dist/contracts/toolOutputSchemaPrimitives.js +19 -1
  210. package/dist/contracts/toolSchemaMetadata.js +69 -10
  211. package/dist/contracts/webNetworkCaptureToolContracts.js +24 -0
  212. package/dist/domain/analysisErrorBase.js +22 -2
  213. package/dist/domain/analysisErrorCore.js +61 -5
  214. package/dist/domain/analysisErrorPresentation.js +95 -12
  215. package/dist/domain/analysisErrorProjection.js +148 -19
  216. package/dist/domain/analysisSnapshot.js +166 -2
  217. package/dist/domain/android/androidAnalysis.js +2 -4
  218. package/dist/domain/android/androidApplication.js +17 -9
  219. package/dist/domain/apple/appleApplication.js +41 -14
  220. package/dist/domain/apple/dyldEnvironment.js +73 -0
  221. package/dist/domain/apple/dyldPaths.js +81 -0
  222. package/dist/domain/apple/dylibResolution.js +478 -0
  223. package/dist/domain/apple/dylibResolutionFindings.js +77 -0
  224. package/dist/domain/apple/interfaceBuilderGraph.js +25 -13
  225. package/dist/domain/apple/interfaceBuilderKeyedArchive.js +13 -3
  226. package/dist/domain/apple/keyedArchive.js +9 -1
  227. package/dist/domain/apple/machoContainer.js +54 -0
  228. package/dist/domain/apple/plistNumbers.js +76 -0
  229. package/dist/domain/artifactIdentity.js +29 -0
  230. package/dist/domain/artifactInventoryEvidence.js +19 -24
  231. package/dist/domain/artifactPathSyntax.js +1 -1
  232. package/dist/domain/bridgeCandidateProjection.js +71 -0
  233. package/dist/domain/browserCompleteness.js +1 -0
  234. package/dist/domain/browserObservation.js +1 -1
  235. package/dist/domain/browserObservationError.js +24 -5
  236. package/dist/domain/browserObservationSchemas.js +13 -0
  237. package/dist/domain/browserScenarioValues.js +5 -2
  238. package/dist/domain/bundleComparison.js +3 -2
  239. package/dist/domain/callPathSchemas.js +1 -1
  240. package/dist/domain/canonicalDigest.js +13 -1
  241. package/dist/domain/canonicalJsonDigestSteps.js +133 -0
  242. package/dist/domain/canonicalOrdering.js +9 -5
  243. package/dist/domain/changedBehavior.js +9 -9
  244. package/dist/domain/comparisonSourceEvidence.js +40 -0
  245. package/dist/domain/comparisonStatus.js +2 -30
  246. package/dist/domain/configurationErrors.js +1 -1
  247. package/dist/domain/conformanceTrustGate.js +0 -16
  248. package/dist/domain/evidence.js +78 -11
  249. package/dist/domain/evidenceBundle.js +42 -1
  250. package/dist/domain/evidenceErrors.js +12 -1
  251. package/dist/domain/evm/evmInterface.js +63 -0
  252. package/dist/domain/explicitSensitiveFailure.js +108 -0
  253. package/dist/domain/explicitSensitiveValues.js +10 -0
  254. package/dist/domain/firmware/firmwareAnalysis.js +10 -4
  255. package/dist/domain/hopperErrors.js +23 -2
  256. package/dist/domain/hopperValues.js +51 -8
  257. package/dist/domain/immutableJson.js +114 -0
  258. package/dist/domain/inputIssueProjection.js +3 -0
  259. package/dist/domain/javascript/electronActiveObservation.js +37 -6
  260. package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
  261. package/dist/domain/javascript/htmlArtifactReferences.js +40 -0
  262. package/dist/domain/javascript/javascriptApplicationAnalysis.js +71 -23
  263. package/dist/domain/javascript/javascriptApplicationGraph.js +13 -0
  264. package/dist/domain/javascript/javascriptAstValues.js +20 -0
  265. package/dist/domain/javascript/javascriptExportShapeComparison.js +21 -5
  266. package/dist/domain/javascript/javascriptExportShapeVariants.js +0 -10
  267. package/dist/domain/javascript/javascriptRecovery.js +3 -8
  268. package/dist/domain/javascript/javascriptSemanticAnalysis.js +97 -2
  269. package/dist/domain/javascript/javascriptSemanticCoverage.js +6 -5
  270. package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +9 -17
  271. package/dist/domain/javascript/javascriptSemanticDataEffects.js +22 -5
  272. package/dist/domain/javascript/javascriptSemanticGraph.js +34 -5
  273. package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +1 -0
  274. package/dist/domain/javascript/javascriptSemanticPrimitives.js +25 -17
  275. package/dist/domain/javascript/javascriptSemanticQuerySchemas.js +8 -4
  276. package/dist/domain/javascript/javascriptSemanticResourceLimits.js +77 -0
  277. package/dist/domain/javascript/javascriptSemanticValues.js +83 -11
  278. package/dist/domain/javascript/javascriptSourceParser.js +6 -2
  279. package/dist/domain/javascript/javascriptStaticAnalysis.js +22 -17
  280. package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +5 -3
  281. package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +14 -4
  282. package/dist/domain/javascript/javascriptStaticAnalysisFindings.js +66 -7
  283. package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +28 -16
  284. package/dist/domain/javascript/javascriptStaticAnalysisState.js +3 -2
  285. package/dist/domain/jsonSerialization.js +109 -0
  286. package/dist/domain/jsonValue.js +91 -3
  287. package/dist/domain/localPath.js +8 -0
  288. package/dist/domain/managed/managedApplicationGraph.js +10 -10
  289. package/dist/domain/managed/managedInspectionEvidence.js +16 -0
  290. package/dist/domain/managed/managedMemberComparisonMatch.js +5 -9
  291. package/dist/domain/managed/managedNativeVerification.js +3 -9
  292. package/dist/domain/native/binaryLayout.js +357 -0
  293. package/dist/domain/native/fileOffsetPartialObservation.js +1 -0
  294. package/dist/domain/native/nativeCallObservation.js +186 -0
  295. package/dist/domain/native/nativeCallPartialObservation.js +33 -0
  296. package/dist/domain/native/objcSwiftMetadata.js +0 -39
  297. package/dist/domain/native/recordedCrash.js +266 -0
  298. package/dist/domain/native/recordedCrashNoteCoverage.js +73 -0
  299. package/dist/domain/{processCapture.js → process/processCapture.js} +143 -2
  300. package/dist/domain/{processCaptureExample.js → process/processCaptureExample.js} +5 -0
  301. package/dist/domain/process/processCaptureParsing.js +54 -0
  302. package/dist/domain/{processCaptureValidation.js → process/processCaptureValidation.js} +18 -2
  303. package/dist/domain/{processComparison.js → process/processComparison.js} +39 -5
  304. package/dist/domain/{processObservation.js → process/processObservation.js} +1 -1
  305. package/dist/domain/{processScenario.js → process/processScenario.js} +11 -10
  306. package/dist/domain/{processTraceSpecification.js → process/processTraceSpecification.js} +1 -1
  307. package/dist/domain/propertyListKeys.js +1 -1
  308. package/dist/domain/propertyListXmlText.js +19 -0
  309. package/dist/domain/providerAdapterError.js +1 -1
  310. package/dist/domain/providerOperationHealth.js +54 -0
  311. package/dist/domain/providerSelectionError.js +4 -2
  312. package/dist/domain/reconstructionVerification.js +9 -46
  313. package/dist/domain/reconstructionVerificationSchemas.js +3 -3
  314. package/dist/domain/residualUnknown.js +3 -2
  315. package/dist/domain/staticRuntimeCorrelation.js +9 -46
  316. package/dist/domain/webBundleAnalysis.js +20 -8
  317. package/dist/domain/webBundleAnalyzerInspection.js +13 -8
  318. package/dist/domain/webBundleAnalyzerResult.js +41 -2
  319. package/dist/domain/webCaptureDiff.js +1 -0
  320. package/dist/domain/webNetworkCapture.js +118 -0
  321. package/dist/domain/webNetworkCaptureCoordinates.js +58 -0
  322. package/dist/domain/webRuntime.js +19 -5
  323. package/dist/domain/webSourceLocation.js +1 -0
  324. package/dist/dotnet/ManagedExceptionRegionValidation.js +41 -0
  325. package/dist/dotnet/ManagedMemberInspector.js +4 -2
  326. package/dist/dotnet/ManagedMemberInspectorCore.js +38 -32
  327. package/dist/dotnet/ManagedMemberInstructionDecoder.js +23 -7
  328. package/dist/dotnet/ManagedMemberRows.js +14 -3
  329. package/dist/dotnet/ManagedMetadataHeaps.js +20 -2
  330. package/dist/dotnet/ManagedMetadataInventory.js +38 -28
  331. package/dist/dotnet/ManagedMetadataInventoryRows.js +24 -10
  332. package/dist/dotnet/ManagedMethodBodyReader.js +7 -1
  333. package/dist/dotnet/ManagedNativeBoundaryHelpers.js +15 -3
  334. package/dist/dotnet/ManagedNativeBoundaryInspector.js +3 -1
  335. package/dist/dotnet/ManagedPeReader.js +11 -0
  336. package/dist/evm/EvmBytecodeCarrier.js +21 -0
  337. package/dist/evm/EvmWorkerLimits.js +40 -0
  338. package/dist/evm/EvmoleFailures.js +126 -0
  339. package/dist/evm/EvmoleInterfaceAdapter.js +53 -0
  340. package/dist/evm/EvmoleInterfaceProvider.js +273 -0
  341. package/dist/evm/EvmoleInterfaceWorker.js +87 -0
  342. package/dist/evm/EvmoleRelease.js +16 -0
  343. package/dist/firmware/FirmwareCommand.js +1 -0
  344. package/dist/firmware/FirmwareFiles.js +1 -1
  345. package/dist/generatedPackageMetadata.js +2 -2
  346. package/dist/ghidra/GhidraAnalysisProfile.js +5 -0
  347. package/dist/ghidra/GhidraClient.js +47 -14
  348. package/dist/ghidra/GhidraDiagnostics.js +7 -7
  349. package/dist/ghidra/GhidraFunctionValues.js +10 -7
  350. package/dist/ghidra/GhidraInstallation.js +18 -21
  351. package/dist/ghidra/GhidraInventoryValues.js +14 -4
  352. package/dist/ghidra/GhidraJavaLaunch.js +62 -0
  353. package/dist/ghidra/GhidraLauncher.js +34 -16
  354. package/dist/ghidra/GhidraProvider.js +2 -2
  355. package/dist/ghidra/GhidraProviderCapabilities.js +15 -3
  356. package/dist/ghidra/GhidraProviderClient.js +23 -12
  357. package/dist/ghidra/GhidraSessionError.js +11 -7
  358. package/dist/ghidra/GhidraTargetSnapshot.js +47 -12
  359. package/dist/ghidra/GhidraTransport.js +20 -0
  360. package/dist/hopper/BridgeLauncher.js +33 -11
  361. package/dist/hopper/HopperAnalysisProfile.js +62 -4
  362. package/dist/hopper/HopperCleanup.js +15 -3
  363. package/dist/hopper/HopperClient.js +222 -14
  364. package/dist/hopper/HopperFileOffset.js +237 -0
  365. package/dist/hopper/HopperMachOImage.js +196 -0
  366. package/dist/hopper/HopperOperationStage.js +6 -0
  367. package/dist/hopper/HopperProvider.js +63 -9
  368. package/dist/hopper/HopperProviderCapabilities.js +19 -1
  369. package/dist/hopper/HopperRegexSearch.js +137 -0
  370. package/dist/hopper/HopperRegexWorker.js +27 -0
  371. package/dist/hopper/HopperRequestQueue.js +68 -19
  372. package/dist/hopper/HopperTargetLease.js +3 -2
  373. package/dist/hopper/LinuxPrivateDisplayProbe.js +4 -2
  374. package/dist/inspector/JavaScriptRuntimeScope.js +9 -1
  375. package/dist/inspector/V8InspectorCaptureProjection.js +8 -3
  376. package/dist/inspector/V8InspectorProvider.js +47 -11
  377. package/dist/javascript/recovery/WakaruCommand.js +3 -0
  378. package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
  379. package/dist/javascript/sourceMaps/SourceMapCommand.js +17 -0
  380. package/dist/javascript/sourceMaps/SourceMapFormat.js +79 -31
  381. package/dist/javascript/sourceMaps/TraceSourceMap.js +14 -28
  382. package/dist/mcpDoctor.js +62 -2
  383. package/dist/native/AppleDispatchCoverage.js +47 -6
  384. package/dist/native/AppleDispatchDecodeFacts.js +6 -0
  385. package/dist/native/AppleDispatchMetadata.js +6 -3
  386. package/dist/native/AppleMachoFixups.js +48 -24
  387. package/dist/native/AppleMachoSelection.js +32 -16
  388. package/dist/native/AppleObjcCategories.js +6 -2
  389. package/dist/native/AppleObjcDispatchFacets.js +5 -2
  390. package/dist/native/AppleObjcProperties.js +2 -1
  391. package/dist/native/AppleSwiftDispatchFacets.js +27 -21
  392. package/dist/native/AppleSwiftVtables.js +21 -15
  393. package/dist/native/CommandRunner.js +82 -84
  394. package/dist/native/LldbCallTracer.js +541 -0
  395. package/dist/native/LldbRetainedObservations.js +178 -0
  396. package/dist/native/NativeCallObservation.js +194 -0
  397. package/dist/native/NativeMacOSProvider.js +117 -20
  398. package/dist/native/NativeMacOSProviderMetadata.js +8 -3
  399. package/dist/native/SignatureTargetBinding.js +155 -0
  400. package/dist/native/parsers/lipo.js +71 -1
  401. package/dist/native/pwndbg/PwndbgCoreContext.js +180 -0
  402. package/dist/native/pwntools/PwntoolsDecoder.js +203 -0
  403. package/dist/native/pwntools/PwntoolsFailures.js +180 -0
  404. package/dist/native/pwntools/PwntoolsLayoutProvider.js +36 -0
  405. package/dist/native/pwntools/PwntoolsRecordedCrashProvider.js +75 -0
  406. package/dist/native/pwntools/PwntoolsRelease.js +19 -0
  407. package/dist/native/pwntools/PwntoolsResourceLimits.js +76 -0
  408. package/dist/native/pwntools/RecordedCrashSourceBindings.js +46 -0
  409. package/dist/native/pwntools/RecordedCrashStructureBindings.js +103 -0
  410. package/dist/process/DarwinProcessRunTokenReader.js +293 -0
  411. package/dist/process/ExecFileOutput.js +20 -0
  412. package/dist/process/OwnedCommand.js +118 -0
  413. package/dist/process/ProcessOwnership.js +431 -51
  414. package/dist/process/ProcessOwnershipObservation.js +209 -27
  415. package/dist/process/ProviderProcess.js +68 -10
  416. package/dist/{application → process/capture}/ProcessCaptureCapability.js +15 -0
  417. package/dist/{application → process/capture}/ProcessCaptureError.js +18 -2
  418. package/dist/process/capture/ProcessCaptureLifecycle.js +681 -0
  419. package/dist/{application → process/capture}/ProcessHarness.js +195 -29
  420. package/dist/{application → process/capture}/ProcessSampling.js +2 -2
  421. package/dist/server/EvidenceMcpServer.js +146 -0
  422. package/dist/server/createServer.js +37 -8
  423. package/dist/server/promptCompletion.js +10 -3
  424. package/dist/server/registerAndroidTools.js +2 -4
  425. package/dist/server/registerApplicationTools/helpers.js +2 -4
  426. package/dist/server/registerArtifactComparisonTool.js +11 -7
  427. package/dist/server/registerBinaryDiagnosticsTools.js +15 -0
  428. package/dist/server/registerBrowserScenarioTool.js +2 -4
  429. package/dist/server/registerBrowserTools.js +2 -4
  430. package/dist/server/registerBundleComparisonTool.js +2 -3
  431. package/dist/server/registerCloseLifecycleTool.js +8 -18
  432. package/dist/server/registerElectronTools.js +2 -4
  433. package/dist/server/registerEnhancedTools.js +18 -59
  434. package/dist/server/registerEvidenceTools.js +3 -5
  435. package/dist/server/registerEvmTools.js +15 -0
  436. package/dist/server/registerFirmwareTools.js +2 -4
  437. package/dist/server/registerFunctionComparisonTool.js +10 -6
  438. package/dist/server/registerInvestigationTools.js +7 -7
  439. package/dist/server/registerJavaScriptRecoveryTool.js +2 -4
  440. package/dist/server/registerJavaScriptRuntimeObservationTools.js +2 -4
  441. package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +2 -4
  442. package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +2 -4
  443. package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +2 -4
  444. package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +2 -4
  445. package/dist/server/registerOfficialTools.js +2 -4
  446. package/dist/server/registerProcessComparisonTool.js +72 -46
  447. package/dist/server/registerRecordedCrashTools.js +15 -0
  448. package/dist/server/registerSessionRecordTools.js +5 -6
  449. package/dist/server/registerSessionStatusTool.js +17 -3
  450. package/dist/server/registerSessionTools.js +13 -5
  451. package/dist/server/registerWebModuleTool.js +2 -4
  452. package/dist/server/registerWebNetworkCaptureTool.js +26 -0
  453. package/dist/server/registerWebRuntimeTools.js +3 -7
  454. package/dist/server/registerWebScriptTool.js +2 -4
  455. package/dist/server/registerWebSourceLocationTool.js +2 -4
  456. package/dist/server/runDerivedOperation.js +15 -3
  457. package/dist/server/sessionAvailabilityPolicy.js +3 -1
  458. package/dist/server/sessionToolPolicies.js +1 -1
  459. package/dist/server/toolRegistrationOptions.js +2 -2
  460. package/dist/server/toolResult.js +63 -11
  461. package/dist/server/toolResultEncoding.js +33 -0
  462. package/install.sh +1 -1
  463. package/native/windows/build/manifest.json +2 -2
  464. package/native/windows/build/rea-windows-x64.node +0 -0
  465. package/package.json +42 -9
  466. package/scripts/electron-active-hook-boundaries.cjs +18 -20
  467. package/scripts/electron-active-hook.cjs +241 -37
  468. package/scripts/rea.mjs +11 -3
  469. package/skills/reverse-engineer-anything/SKILL.md +32 -4
  470. package/skills/reverse-engineer-anything/references/javascript-applications.md +8 -1
  471. package/skills/reverse-engineer-anything/references/native-and-artifacts.md +29 -0
  472. package/third_party/README.md +60 -0
  473. package/third_party/evmole/LICENSE +21 -0
  474. package/third_party/evmole/README.md +22 -0
  475. package/third_party/pwndbg/LICENSE.md +21 -0
  476. package/third_party/pwndbg/README.md +23 -0
  477. package/third_party/pwntools/README.md +40 -0
  478. package/dist/application/AuthorizedArtifactInventory.js +0 -7
  479. package/dist/application/ProcessCaptureLifecycle.js +0 -299
  480. package/dist/application/StoreFileLock.js +0 -124
  481. package/dist/contracts/processCaptureExample.js +0 -2
  482. package/dist/domain/bytecodeProvider.js +0 -178
  483. package/dist/domain/customProtocolCapture.js +0 -137
  484. package/dist/domain/eventProcessTree.js +0 -225
  485. package/dist/domain/mobileApplicationInvestigation.js +0 -159
  486. package/dist/domain/packageAnalysis.js +0 -123
  487. package/dist/domain/peInspection.js +0 -197
  488. package/dist/domain/processCaptureParsing.js +0 -21
  489. package/dist/domain/protocolCapture.js +0 -217
  490. package/dist/domain/runtimeIdentification.js +0 -212
  491. package/dist/generatedMcpToolCatalog.js +0 -37
  492. package/dist/ghidra/GhidraDefaults.js +0 -2
  493. /package/dist/application/{ArtifactExtractionDestination.js → artifacts/ArtifactExtractionDestination.js} +0 -0
  494. /package/dist/{application/ArtifactInventory → artifacts/inventory}/policy.js +0 -0
  495. /package/dist/{application/ArtifactInventory → artifacts/inventory}/types.js +0 -0
  496. /package/dist/domain/{processEvidenceProvider.js → process/processEvidenceProvider.js} +0 -0
  497. /package/dist/domain/{processTraceComparison.js → process/processTraceComparison.js} +0 -0
  498. /package/dist/domain/{processTraceDimensionProjection.js → process/processTraceDimensionProjection.js} +0 -0
  499. /package/dist/domain/{processTraceEvaluation.js → process/processTraceEvaluation.js} +0 -0
  500. /package/dist/{application → process/capture}/FilesystemSnapshot.js +0 -0
  501. /package/dist/{application → process/capture}/ProcessCaptureEnvironment.js +0 -0
  502. /package/dist/{application → process/capture}/ProcessCaptureJournal.js +0 -0
  503. /package/dist/{application → process/capture}/ProcessFilesystemEffects.js +0 -0
  504. /package/dist/{application → process/capture}/ProcessNormalization.js +0 -0
  505. /package/dist/{application → process/capture}/ProcessScenarioRuntimeValidation.js +0 -0
  506. /package/dist/{application → process/capture}/ProcessTimer.js +0 -0
  507. /package/dist/{application → process/capture}/TerminalRenderer.js +0 -0
@@ -1,5 +1,5 @@
1
1
  import { z } from "zod";
2
- import { jsonValueSchema } from "./jsonValue.js";
2
+ import { jsonValueSchema } from "../jsonValue.js";
3
3
  /** Process-capture observation families shared by live drivers and trace assertions. */
4
4
  export const processObservationSourceSchema = z.enum([
5
5
  "terminal_raw",
@@ -68,7 +68,7 @@ export const processComparisonContract = (scenario) => ({
68
68
  * Defaults are part of the evidence contract and must remain deterministic.
69
69
  */
70
70
  export const processScenarioSchema = z
71
- .object({
71
+ .strictObject({
72
72
  executable: childProcessString.min(1),
73
73
  arguments: z.array(childProcessString).default([]),
74
74
  working_directory: childProcessString.default("."),
@@ -77,7 +77,7 @@ export const processScenarioSchema = z
77
77
  .array(childProcessString.min(1))
78
78
  .default([]),
79
79
  terminal: z
80
- .object({
80
+ .strictObject({
81
81
  columns: z.number().int().min(1).max(65_535).default(80),
82
82
  rows: z.number().int().min(1).max(65_535).default(24),
83
83
  scrollback: z.number().int().min(0).default(1_000),
@@ -85,19 +85,19 @@ export const processScenarioSchema = z
85
85
  .default({ columns: 80, rows: 24, scrollback: 1_000 }),
86
86
  events: z
87
87
  .array(z.discriminatedUnion("type", [
88
- z.object({
88
+ z.strictObject({
89
89
  ...timedEventBase,
90
90
  type: z.literal("input"),
91
91
  data: z.string(),
92
92
  sensitive: z.boolean().default(false),
93
93
  }),
94
- z.object({
94
+ z.strictObject({
95
95
  ...timedEventBase,
96
96
  type: z.literal("resize"),
97
97
  columns: z.number().int().min(1).max(65_535),
98
98
  rows: z.number().int().min(1).max(65_535),
99
99
  }),
100
- z.object({
100
+ z.strictObject({
101
101
  ...timedEventBase,
102
102
  type: z.literal("signal"),
103
103
  signal: z.enum(["SIGINT", "SIGTERM", "SIGKILL"]),
@@ -108,7 +108,7 @@ export const processScenarioSchema = z
108
108
  idle_timeout_ms: positiveBudget.default(30_000),
109
109
  settle_ms: z.number().int().safe().nonnegative().default(100),
110
110
  limits: z
111
- .object({
111
+ .strictObject({
112
112
  output_bytes: positiveBudget.default(1_000_000),
113
113
  files: positiveBudget.default(10_000),
114
114
  file_bytes: positiveBudget.default(10_000_000),
@@ -124,14 +124,16 @@ export const processScenarioSchema = z
124
124
  filesystem_depth: 16,
125
125
  }),
126
126
  normalization: z
127
- .object({
127
+ .strictObject({
128
128
  paths: z.boolean().default(false),
129
129
  pids: z.boolean().default(true),
130
130
  ports: z.boolean().default(true),
131
131
  time_bucket_ms: positiveBudget.default(10),
132
132
  patterns: z
133
- .array(z.object({
134
- pattern: z.string(),
133
+ .array(z.strictObject({
134
+ pattern: z
135
+ .string()
136
+ .describe("Literal text to replace in captured output; not a regular expression."),
135
137
  replacement: z.string(),
136
138
  }))
137
139
  .default([]),
@@ -144,7 +146,6 @@ export const processScenarioSchema = z
144
146
  patterns: [],
145
147
  }),
146
148
  })
147
- .strict()
148
149
  .superRefine((scenario, context) => {
149
150
  for (let index = 1; index < scenario.events.length; index += 1) {
150
151
  const event = scenario.events[index];
@@ -1,6 +1,6 @@
1
1
  import canonicalize from "canonicalize";
2
2
  import { z } from "zod";
3
- import { jsonValueSchema } from "./jsonValue.js";
3
+ import { jsonValueSchema } from "../jsonValue.js";
4
4
  import { comparableProcessObservationPayload, processObservationSourceSchema, } from "./processObservation.js";
5
5
  const identifierSchema = z.string().regex(/^[A-Za-z][A-Za-z0-9._-]*$/u);
6
6
  /** Process observation families admitted by a declared trace specification. */
@@ -39,7 +39,7 @@ const XML_ENTITIES = {
39
39
  * Unicode stays as written: comments and CDATA may hold such text literally,
40
40
  * and the XML decoder rejects it anywhere else.
41
41
  */
42
- const decodeXmlText = (text) => text.replace(/&(?:#x([\da-f]+)|#(\d+)|([a-z]+));/giu, (entity, hex, decimal, name) => {
42
+ export const decodeXmlText = (text) => text.replace(/&(?:#x([\da-f]+)|#(\d+)|([a-z]+));/giu, (entity, hex, decimal, name) => {
43
43
  const codePoint = hex !== undefined
44
44
  ? parseInt(hex, 16)
45
45
  : decimal !== undefined
@@ -0,0 +1,19 @@
1
+ /** Decode BOM-aware XML plist text with fatal byte validation. */
2
+ export const decodeXmlPlistText = (bytes) => {
3
+ const encoding = bytes[0] === 0xff && bytes[1] === 0xfe
4
+ ? "utf-16le"
5
+ : bytes[0] === 0xfe && bytes[1] === 0xff
6
+ ? "utf-16be"
7
+ : "utf-8";
8
+ const text = new TextDecoder(encoding, { fatal: true }).decode(bytes);
9
+ const declaration = /^<\?xml\s[^?]*\bencoding\s*=\s*["']([^"']+)["']/u.exec(text)?.[1];
10
+ const declared = declaration?.toLowerCase();
11
+ if (declared !== undefined &&
12
+ !["utf-8", "utf-16", "utf-16le", "utf-16be"].includes(declared))
13
+ throw new TypeError(`Unsupported XML encoding declaration: ${declaration}. Supported encodings are UTF-8 and BOM-marked UTF-16 in either byte order.`);
14
+ if (declared !== undefined &&
15
+ declared !== encoding &&
16
+ !(encoding !== "utf-8" && declared === "utf-16"))
17
+ throw new TypeError("XML encoding declaration disagrees with its bytes");
18
+ return text;
19
+ };
@@ -1,4 +1,4 @@
1
- import { AnalysisError } from "./analysisErrorBase.js";
1
+ import { AnalysisError, } from "./analysisErrorBase.js";
2
2
  /** A provider adapter failed outside its more precise typed variants. */
3
3
  export class ProviderAdapterError extends AnalysisError {
4
4
  providerId;
@@ -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
+ };
@@ -1,4 +1,4 @@
1
- import { AnalysisError } from "./analysisErrorBase.js";
1
+ import { AnalysisError, } from "./analysisErrorBase.js";
2
2
  /** No configured provider can satisfy a requested operation or target binding. */
3
3
  export class ProviderSelectionError extends AnalysisError {
4
4
  _tag = "ProviderSelectionError";
@@ -10,7 +10,9 @@ export class ProviderSelectionError extends AnalysisError {
10
10
  userMessage;
11
11
  constructor(options) {
12
12
  const operation = options.operation ?? "open_binary";
13
- super(providerSelectionDiagnostic(options));
13
+ super(providerSelectionDiagnostic(options), options.capturedOutput === undefined
14
+ ? undefined
15
+ : { capturedOutput: options.capturedOutput });
14
16
  this.operation = operation;
15
17
  this.reason = options.reason;
16
18
  this.requestedProviderId = options.requestedProviderId;
@@ -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
10
  import { functionComparisonResultSchema } from "./functionComparison.js";
10
- import { PROCESS_PROVIDER, isProcessEvidenceProvider, } from "./processEvidenceProvider.js";
11
+ import { PROCESS_PROVIDER, isProcessEvidenceProvider, } from "./process/processEvidenceProvider.js";
11
12
  import { functionDossierSchema } from "./hopperValues.js";
12
- import { deriveProcessComparisonStatus, PROCESS_COMPARISON_DIMENSIONS, processCaptureComparisonSchema, processCaptureSchema, } from "./processCapture.js";
13
+ import { deriveProcessComparisonStatus, PROCESS_COMPARISON_DIMENSIONS, processCaptureComparisonSchema, parseProcessCapture, } from "./process/processCapture.js";
13
14
  import { reconstructionClaimResultSchema, reconstructionSpecificationSchema, reconstructionVerificationResultSchema, } from "./reconstructionVerificationSchemas.js";
14
15
  import { reconstructionClaimUnknowns, reconstructionProbes, reconstructionUnknownHeads, } from "./reconstructionUnknowns.js";
15
- const evidenceIdSchema = prefixedDigestSchema("ev");
16
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) => {
@@ -125,7 +122,7 @@ const validateSourceKinds = (claim, sources) => {
125
122
  throw new TypeError("Comparison source Evidence has an unexpected observation type");
126
123
  for (const source of sources) {
127
124
  if (claim.kind === "behavioral")
128
- processCaptureSchema.parse(source.normalized_result);
125
+ parseProcessCapture(source.normalized_result);
129
126
  else if (claim.kind === "structural-function")
130
127
  functionDossierSchema.parse(source.normalized_result);
131
128
  else
@@ -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,7 +1,7 @@
1
1
  import { z } from "zod";
2
2
  import { digestSchema } from "./../domain/digests.js";
3
3
  import { prefixedDigestSchema } from "./../domain/digests.js";
4
- import { PROCESS_COMPARISON_DIMENSIONS } from "./processComparison.js";
4
+ import { PROCESS_COMPARISON_DIMENSIONS } from "./process/processComparison.js";
5
5
  const evidenceIdSchema = prefixedDigestSchema("ev");
6
6
  const unknownIdSchema = prefixedDigestSchema("unk");
7
7
  const claimIdSchema = z.string().regex(/^[A-Za-z][A-Za-z0-9._-]*$/u);
@@ -80,7 +80,7 @@ export const reconstructionClaimResultSchema = z.object({
80
80
  comparison_evidence_id: evidenceIdSchema,
81
81
  left_evidence_ids: z.array(evidenceIdSchema).min(1),
82
82
  right_evidence_ids: z.array(evidenceIdSchema).min(1),
83
- evidence_links: z.array(evidenceIdSchema).min(3),
83
+ evidence_links: z.array(evidenceIdSchema).min(2),
84
84
  unknown_ids: z.array(unknownIdSchema),
85
85
  limitations: z.array(z.string()),
86
86
  });
@@ -106,7 +106,7 @@ export const reconstructionVerificationResultSchema = z
106
106
  claim_ids: z.array(claimIdSchema).min(1),
107
107
  unknown_ids: z.array(unknownIdSchema),
108
108
  })),
109
- evidence_links: z.array(evidenceIdSchema).min(3),
109
+ evidence_links: z.array(evidenceIdSchema).min(2),
110
110
  limitations: z.array(z.string()),
111
111
  })
112
112
  .superRefine((result, context) => {
@@ -147,9 +147,10 @@ export const recordUnknownInputSchema = residualUnknownObjectSchema
147
147
  .extend({
148
148
  supporting_evidence_ids: z.array(evidenceIdSchema).default([]),
149
149
  contradicting_evidence_ids: z.array(evidenceIdSchema).default([]),
150
- });
150
+ })
151
+ .strict();
151
152
  /** Explicit optimistic-concurrency update command for one unknown. */
152
- export const updateUnknownInputSchema = z.object({
153
+ export const updateUnknownInputSchema = z.strictObject({
153
154
  unknown_id: unknownIdSchema,
154
155
  expected_revision: z.number().int().min(1),
155
156
  status: residualUnknownObjectSchema.shape.status,
@@ -3,11 +3,12 @@ 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
8
  import { functionComparisonResultSchema } from "./functionComparison.js";
8
- import { PROCESS_PROVIDER, isProcessEvidenceProvider, } from "./processEvidenceProvider.js";
9
- import { comparisonStatusSchema, processCaptureComparisonSchema, } from "./processCapture.js";
10
- import { PROCESS_COMPARISON_DIMENSIONS } from "./processComparison.js";
9
+ import { PROCESS_PROVIDER, isProcessEvidenceProvider, } from "./process/processEvidenceProvider.js";
10
+ import { comparisonStatusSchema, processCaptureComparisonSchema, } from "./process/processCapture.js";
11
+ import { PROCESS_COMPARISON_DIMENSIONS } from "./process/processComparison.js";
11
12
  import { prefixedDigestSchema } from "./../domain/digests.js";
12
13
  const evidenceIdSchema = prefixedDigestSchema("ev");
13
14
  const functionDimensionSchema = z.enum([
@@ -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";
@@ -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) => {
@@ -3,10 +3,16 @@ export const buildWebBundleAnalysis = (inspection, sourceScripts, sourceMaps, ac
3
3
  const unavailable = inspection.scripts.items
4
4
  .filter((script) => !script.source.included)
5
5
  .map(({ script_key }) => script_key);
6
+ const omittedScripts = captureBudgetOmission(inspection, "scripts");
7
+ const omittedSourceMaps = sourceMaps.status === "not_requested"
8
+ ? undefined
9
+ : captureBudgetOmission(inspection, "source_maps");
6
10
  const sourceMapIncomplete = sourceMaps.status === "partial" || sourceMaps.status === "unavailable";
7
11
  const partial = accumulator.parseFailures > 0 ||
8
12
  unavailable.length > 0 ||
9
- sourceMapIncomplete;
13
+ sourceMapIncomplete ||
14
+ omittedScripts !== undefined ||
15
+ omittedSourceMaps !== undefined;
10
16
  return webBundleAnalysisSchema.parse({
11
17
  capture: buildCaptureObservation(inspection, sourceScripts),
12
18
  observations: {
@@ -25,6 +31,8 @@ export const buildWebBundleAnalysis = (inspection, sourceScripts, sourceMaps, ac
25
31
  unavailable,
26
32
  parseFailures: accumulator.parseFailures,
27
33
  sourceMaps,
34
+ omittedScripts,
35
+ omittedSourceMaps,
28
36
  }),
29
37
  completeness: buildCompleteness({
30
38
  partial,
@@ -58,6 +66,15 @@ const chunkNode = (script) => {
58
66
  };
59
67
  };
60
68
  const buildUnknowns = (input) => [
69
+ ...(input.omittedScripts === undefined
70
+ ? []
71
+ : [
72
+ {
73
+ dimension: "script_inventory",
74
+ reason: captureBudgetReason("script records", input.omittedScripts),
75
+ affected_script_keys: [],
76
+ },
77
+ ]),
61
78
  ...(input.unavailable.length === 0
62
79
  ? []
63
80
  : [
@@ -76,13 +93,23 @@ const buildUnknowns = (input) => [
76
93
  affected_script_keys: input.sourceScripts.map(({ script_key }) => script_key),
77
94
  },
78
95
  ]),
96
+ ...(input.omittedSourceMaps === undefined
97
+ ? []
98
+ : [
99
+ {
100
+ dimension: "source_maps",
101
+ reason: captureBudgetReason("source-map declarations", input.omittedSourceMaps),
102
+ affected_script_keys: [],
103
+ },
104
+ ]),
79
105
  ...(input.sourceMaps.status === "not_requested" ||
80
106
  input.sourceMaps.status === "included"
81
107
  ? []
82
108
  : [
83
109
  {
84
110
  dimension: "source_maps",
85
- reason: "One or more requested source maps were unavailable or incomplete",
111
+ reason: input.sourceMaps.limitation ??
112
+ "One or more requested source maps were unavailable or incomplete",
86
113
  affected_script_keys: input.sourceMaps.items
87
114
  .filter(({ status }) => status !== "included")
88
115
  .map(({ script_key }) => script_key)
@@ -90,6 +117,18 @@ const buildUnknowns = (input) => [
90
117
  },
91
118
  ]),
92
119
  ];
120
+ const captureBudgetOmission = (inspection, section) => {
121
+ const exclusions = inspection.completeness.excluded.filter((exclusion) => exclusion.section === section &&
122
+ exclusion.reason === "resource_budget_exhausted");
123
+ if (exclusions.length === 0)
124
+ return undefined;
125
+ if (exclusions.some(({ count }) => count === null))
126
+ return null;
127
+ return exclusions.reduce((sum, { count }) => sum + (count ?? 0), 0);
128
+ };
129
+ const captureBudgetReason = (label, count) => count === null
130
+ ? `Capture omitted an unknown number of ${label} because its resource budget was exhausted.`
131
+ : `Capture omitted ${String(count)} ${label} because its resource budget was exhausted.`;
93
132
  const buildCompleteness = (input) => ({
94
133
  status: input.partial ? "partial" : "complete",
95
134
  parsed_scripts: input.parsedScripts,
@@ -118,6 +118,7 @@ const networkMap = (inspection) => {
118
118
  status: request.status,
119
119
  mime_type: request.mime_type,
120
120
  encoded_data_length: request.encoded_data_length,
121
+ redirects: (request.redirects ?? []).map(({ request_timestamp: _requestTimestamp, redirect_event_timestamp: _redirectEventTimestamp, ...redirect }) => redirect),
121
122
  initiator: request.initiator,
122
123
  body_shapes: request.body_shapes,
123
124
  });