rea-agents 6.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 (343) hide show
  1. package/README.md +23 -17
  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 +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 +196 -33
  10. package/dist/android/JadxMcpTransport.js +4 -0
  11. package/dist/android/JadxProtocol.js +6 -0
  12. package/dist/android/JadxProvider.js +19 -2
  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/CallPathTracing.js +19 -3
  18. package/dist/application/CapabilityInventory.js +6 -3
  19. package/dist/application/ClientConfigurationDocument.js +871 -6
  20. package/dist/application/ClientRegistrationIdentity.js +26 -5
  21. package/dist/application/ClientRegistrationStatus.js +29 -14
  22. package/dist/application/DirectAnalysis.js +27 -37
  23. package/dist/application/Doctor.js +4 -2
  24. package/dist/application/DoctorScope.js +25 -13
  25. package/dist/application/EnhancedLiteralTracing.js +22 -25
  26. package/dist/application/EnhancedTools.js +13 -11
  27. package/dist/application/EvidenceBundleFiles.js +23 -11
  28. package/dist/application/FunctionAnalysisEvidence.js +2 -3
  29. package/dist/application/InventoryProjectionEvidence.js +4 -3
  30. package/dist/application/InvestigationProviders.js +3 -2
  31. package/dist/application/JsonFiles.js +50 -28
  32. package/dist/application/ProcedureAddressResolution.js +11 -0
  33. package/dist/application/ReconstructionCoverageService.js +7 -4
  34. package/dist/application/ReconstructionObligationLedgerService.js +4 -3
  35. package/dist/application/Setup.js +13 -1
  36. package/dist/application/SetupClientConfiguration.js +10 -15
  37. package/dist/application/SetupHost.js +5 -2
  38. package/dist/application/SetupPlan.js +5 -3
  39. package/dist/application/SupportedClients.js +34 -1
  40. package/dist/application/Uninstall.js +4 -3
  41. package/dist/application/Update.js +18 -3
  42. package/dist/application/UpdateRuntime.js +46 -25
  43. package/dist/application/WebModuleTraceService.js +4 -2
  44. package/dist/application/WebNetworkCaptureService.js +4 -2
  45. package/dist/application/WebRuntimeService.js +5 -3
  46. package/dist/application/WebScriptExportService.js +2 -2
  47. package/dist/application/WebSourceLocationService.js +4 -2
  48. package/dist/application/WorkflowEvidence.js +82 -0
  49. package/dist/application/binary/AnalysisProviderEvaluation.js +21 -5
  50. package/dist/application/binary/AnalysisProviderRegistry.js +2 -0
  51. package/dist/application/binary/AnalysisSnapshotCache.js +3 -6
  52. package/dist/application/binary/BinarySession.js +95 -68
  53. package/dist/application/binary/BinarySessionOpen.js +3 -3
  54. package/dist/application/binary/BinarySessionRecords.js +25 -3
  55. package/dist/application/binary/BinarySessionStatus.js +17 -1
  56. package/dist/application/binary/CompositeProvider.js +13 -0
  57. package/dist/application/binary/LazyAnalysisProvider.js +3 -0
  58. package/dist/application/binaryDiagnostics/BinaryLayoutService.js +4 -2
  59. package/dist/application/binaryDiagnostics/RecordedCrashService.js +4 -2
  60. package/dist/application/evm/EvmInterfaceService.js +4 -2
  61. package/dist/application/investigation/EvidenceLedger.js +21 -7
  62. package/dist/application/investigation/InvestigationRecords.js +8 -0
  63. package/dist/application/javascript/JavaScriptAnalysisControl.js +34 -0
  64. package/dist/application/javascript/JavaScriptApplicationEvidence.js +24 -3
  65. package/dist/application/javascript/JavaScriptApplicationEvidenceGraph.js +19 -2
  66. package/dist/application/javascript/JavaScriptApplicationService.js +22 -15
  67. package/dist/application/javascript/JavaScriptApplicationWorkflowService.js +5 -5
  68. package/dist/application/javascript/JavaScriptArtifactAnalysis.js +5 -4
  69. package/dist/application/javascript/JavaScriptArtifactGraphBuilder.js +39 -7
  70. package/dist/application/javascript/JavaScriptArtifactPathResolution.js +6 -3
  71. package/dist/application/javascript/JavaScriptArtifactReconstruction.js +11 -3
  72. package/dist/application/javascript/JavaScriptModuleRelationships.js +37 -8
  73. package/dist/application/javascript/JavaScriptRecoveryService.js +4 -2
  74. package/dist/application/javascript/JavaScriptRuntimeObservationService.js +3 -1
  75. package/dist/application/javascript/JavaScriptRuntimeReconciliationService.js +3 -3
  76. package/dist/application/javascript/JavaScriptSemanticGraphBuilder.js +63 -61
  77. package/dist/application/javascript/JavaScriptSemanticGraphValueProjection.js +23 -1
  78. package/dist/application/managed/ManagedApplicationGraphService.js +4 -3
  79. package/dist/application/managed/ManagedMemberComparisonService.js +7 -4
  80. package/dist/application/managed/ManagedNativeVerificationService.js +4 -3
  81. package/dist/application/managed/ManagedReconstructionService.js +4 -3
  82. package/dist/application/process/ProcessCli.js +14 -6
  83. package/dist/application/process/ProcessEvidence.js +4 -3
  84. package/dist/application/workflowInputError.js +18 -0
  85. package/dist/artifacts/ArtifactProvider.js +12 -2
  86. package/dist/artifacts/MachOSliceArtifactReader.js +98 -14
  87. package/dist/artifacts/NativeDmgArtifactReader.js +13 -6
  88. package/dist/artifacts/apple/AppleAssetCatalogAnalysis.js +22 -3
  89. package/dist/artifacts/apple/InterfaceBuilderAnalysis.js +176 -56
  90. package/dist/artifacts/apple/InterfaceBuilderDecodeBudget.js +195 -0
  91. package/dist/artifacts/apple/KeyedArchiveReader.js +36 -22
  92. package/dist/artifacts/apple/MachoLoadCommandReader.js +92 -31
  93. package/dist/artifacts/apple/NibArchive.js +81 -14
  94. package/dist/artifacts/apple/NibViewHierarchy.js +10 -3
  95. package/dist/artifacts/apple/PlistNumberLiterals.js +164 -0
  96. package/dist/artifacts/inventory/ArtifactGraphConstruction.js +13 -8
  97. package/dist/artifacts/inventory/scanCanonical.js +11 -14
  98. package/dist/artifacts/javascript/JavaScriptArtifactFiles.js +6 -2
  99. package/dist/browser/CdpCaptureCompleteness.js +2 -0
  100. package/dist/browser/CdpCaptureEventHandlers.js +76 -11
  101. package/dist/browser/CdpCaptureEventTypes.js +5 -1
  102. package/dist/browser/CdpCaptureEvents.js +25 -0
  103. package/dist/browser/CdpConnection.js +30 -11
  104. package/dist/browser/CdpOptionalCommand.js +2 -3
  105. package/dist/browser/CdpPageCapture.js +23 -1
  106. package/dist/browser/PlaywrightElectronActiveActions.js +32 -23
  107. package/dist/browser/PlaywrightElectronActiveProjection.js +141 -0
  108. package/dist/browser/PlaywrightElectronActiveProvider.js +123 -124
  109. package/dist/browser/WebSourceMapFetcher.js +426 -72
  110. package/dist/browser/assets/LocalWebScriptArtifacts.js +2 -2
  111. package/dist/browser/history/CaptureFailures.js +37 -1
  112. package/dist/browser/history/CaptureRelease.js +5 -0
  113. package/dist/browser/history/HarCaptureAdapter.js +3 -3
  114. package/dist/browser/history/HarJson.js +3 -2
  115. package/dist/browser/history/HistoricalCaptureDecoder.js +4 -2
  116. package/dist/cli/analysisSelector.js +23 -0
  117. package/dist/cli/applicationCommands.js +2 -3
  118. package/dist/cli/coreBinaryCommands.js +70 -12
  119. package/dist/cli/electronCommands.js +7 -6
  120. package/dist/cli/javascriptApplicationAnalysis.js +7 -3
  121. package/dist/cli/jsonOutput.js +4 -99
  122. package/dist/cli/nativeCallCommands.js +2 -3
  123. package/dist/cli/webRuntimeCommands.js +8 -8
  124. package/dist/cli.js +2 -1
  125. package/dist/cliCommandNames.js +0 -1
  126. package/dist/cliJsonInput.js +9 -4
  127. package/dist/config/environment.js +4 -0
  128. package/dist/config/ghidraStartupTimeout.js +17 -0
  129. package/dist/config/mcpResponseBudget.js +22 -0
  130. package/dist/config/parseConfig.js +2 -1
  131. package/dist/contracts/enhancedInputs.js +5 -3
  132. package/dist/contracts/enhancedToolContracts.js +3 -3
  133. package/dist/contracts/hopperMemoryContracts.js +2 -5
  134. package/dist/contracts/javascript/electronToolContracts.js +1 -1
  135. package/dist/contracts/managed/managedToolContracts.js +2 -4
  136. package/dist/contracts/native/nativeToolContracts.js +4 -2
  137. package/dist/contracts/officialToolContracts.js +14 -15
  138. package/dist/contracts/promptContracts.js +3 -3
  139. package/dist/contracts/sessionLifecycleInputs.js +3 -7
  140. package/dist/contracts/sessionStatusContract.js +2 -4
  141. package/dist/contracts/sessionToolContracts.js +4 -6
  142. package/dist/contracts/sessionToolSchemas.js +2 -5
  143. package/dist/contracts/toolContractExamples.js +0 -1
  144. package/dist/contracts/toolContractHelpers.js +4 -1
  145. package/dist/contracts/toolEffects.js +0 -1
  146. package/dist/contracts/toolOutputSchemaGroups.js +28 -27
  147. package/dist/contracts/toolOutputSchemaPrimitives.js +18 -0
  148. package/dist/contracts/toolSchemaMetadata.js +69 -10
  149. package/dist/contracts/webNetworkCaptureToolContracts.js +1 -1
  150. package/dist/domain/analysisErrorBase.js +8 -3
  151. package/dist/domain/analysisErrorCore.js +3 -1
  152. package/dist/domain/analysisErrorPresentation.js +72 -17
  153. package/dist/domain/analysisErrorProjection.js +106 -27
  154. package/dist/domain/android/androidAnalysis.js +2 -4
  155. package/dist/domain/android/androidApplication.js +17 -9
  156. package/dist/domain/apple/appleApplication.js +41 -14
  157. package/dist/domain/apple/dyldEnvironment.js +73 -0
  158. package/dist/domain/apple/dylibResolution.js +120 -9
  159. package/dist/domain/apple/dylibResolutionFindings.js +9 -7
  160. package/dist/domain/apple/interfaceBuilderGraph.js +25 -13
  161. package/dist/domain/apple/interfaceBuilderKeyedArchive.js +13 -3
  162. package/dist/domain/apple/keyedArchive.js +9 -1
  163. package/dist/domain/apple/machoContainer.js +54 -0
  164. package/dist/domain/apple/plistNumbers.js +76 -0
  165. package/dist/domain/artifactIdentity.js +29 -0
  166. package/dist/domain/artifactInventoryEvidence.js +19 -24
  167. package/dist/domain/bridgeCandidateProjection.js +71 -0
  168. package/dist/domain/browserCompleteness.js +1 -0
  169. package/dist/domain/browserObservationError.js +24 -5
  170. package/dist/domain/browserScenarioValues.js +2 -6
  171. package/dist/domain/bundleComparison.js +3 -2
  172. package/dist/domain/canonicalJsonDigestSteps.js +133 -0
  173. package/dist/domain/canonicalOrdering.js +9 -5
  174. package/dist/domain/changedBehavior.js +6 -6
  175. package/dist/domain/comparisonSourceEvidence.js +40 -0
  176. package/dist/domain/configurationErrors.js +1 -1
  177. package/dist/domain/evidence.js +64 -9
  178. package/dist/domain/evidenceBundle.js +42 -1
  179. package/dist/domain/evidenceErrors.js +12 -1
  180. package/dist/domain/explicitSensitiveFailure.js +17 -1
  181. package/dist/domain/firmware/firmwareAnalysis.js +6 -7
  182. package/dist/domain/hopperErrors.js +23 -2
  183. package/dist/domain/hopperValues.js +51 -8
  184. package/dist/domain/immutableJson.js +114 -0
  185. package/dist/domain/inputIssueProjection.js +3 -0
  186. package/dist/domain/javascript/electronActiveObservation.js +30 -4
  187. package/dist/domain/javascript/electronStaticAnalysisValues.js +6 -12
  188. package/dist/domain/javascript/javascriptApplicationAnalysis.js +71 -23
  189. package/dist/domain/javascript/javascriptApplicationGraph.js +13 -0
  190. package/dist/domain/javascript/javascriptAstValues.js +20 -0
  191. package/dist/domain/javascript/javascriptRecovery.js +3 -8
  192. package/dist/domain/javascript/javascriptSemanticAnalysis.js +97 -2
  193. package/dist/domain/javascript/javascriptSemanticCoverage.js +6 -5
  194. package/dist/domain/javascript/javascriptSemanticDataEffectHelpers.js +9 -17
  195. package/dist/domain/javascript/javascriptSemanticDataEffects.js +22 -5
  196. package/dist/domain/javascript/javascriptSemanticGraph.js +13 -0
  197. package/dist/domain/javascript/javascriptSemanticGraphSchemas.js +1 -0
  198. package/dist/domain/javascript/javascriptSemanticPrimitives.js +25 -17
  199. package/dist/domain/javascript/javascriptSemanticQuerySchemas.js +8 -4
  200. package/dist/domain/javascript/javascriptSemanticResourceLimits.js +77 -0
  201. package/dist/domain/javascript/javascriptSemanticValues.js +83 -11
  202. package/dist/domain/javascript/javascriptSourceParser.js +6 -2
  203. package/dist/domain/javascript/javascriptStaticAnalysis.js +22 -17
  204. package/dist/domain/javascript/javascriptStaticAnalysisBundler.js +5 -3
  205. package/dist/domain/javascript/javascriptStaticAnalysisCalls.js +14 -4
  206. package/dist/domain/javascript/javascriptStaticAnalysisFindings.js +66 -7
  207. package/dist/domain/javascript/javascriptStaticAnalysisHelpers.js +28 -16
  208. package/dist/domain/javascript/javascriptStaticAnalysisState.js +3 -2
  209. package/dist/domain/jsonSerialization.js +109 -0
  210. package/dist/domain/jsonValue.js +90 -6
  211. package/dist/domain/localPath.js +6 -0
  212. package/dist/domain/managed/managedApplicationGraph.js +10 -10
  213. package/dist/domain/managed/managedInspectionEvidence.js +16 -0
  214. package/dist/domain/managed/managedMemberComparisonMatch.js +5 -9
  215. package/dist/domain/managed/managedNativeVerification.js +3 -9
  216. package/dist/domain/native/fileOffsetPartialObservation.js +1 -0
  217. package/dist/domain/native/nativeCallObservation.js +33 -11
  218. package/dist/domain/native/nativeCallPartialObservation.js +33 -0
  219. package/dist/domain/process/processCapture.js +8 -4
  220. package/dist/domain/process/processComparison.js +38 -4
  221. package/dist/domain/process/processScenario.js +11 -10
  222. package/dist/domain/propertyListKeys.js +1 -1
  223. package/dist/domain/propertyListXmlText.js +19 -0
  224. package/dist/domain/providerAdapterError.js +1 -1
  225. package/dist/domain/providerOperationHealth.js +54 -0
  226. package/dist/domain/reconstructionVerification.js +6 -43
  227. package/dist/domain/reconstructionVerificationSchemas.js +2 -2
  228. package/dist/domain/staticRuntimeCorrelation.js +6 -43
  229. package/dist/domain/webBundleAnalysis.js +20 -8
  230. package/dist/domain/webBundleAnalyzerInspection.js +13 -8
  231. package/dist/domain/webBundleAnalyzerResult.js +41 -2
  232. package/dist/domain/webRuntime.js +19 -5
  233. package/dist/domain/webSourceLocation.js +1 -0
  234. package/dist/firmware/FirmwareFiles.js +1 -1
  235. package/dist/generatedPackageMetadata.js +1 -1
  236. package/dist/ghidra/GhidraAnalysisProfile.js +5 -0
  237. package/dist/ghidra/GhidraClient.js +47 -14
  238. package/dist/ghidra/GhidraDiagnostics.js +7 -7
  239. package/dist/ghidra/GhidraFunctionValues.js +10 -7
  240. package/dist/ghidra/GhidraInstallation.js +18 -21
  241. package/dist/ghidra/GhidraInventoryValues.js +14 -4
  242. package/dist/ghidra/GhidraJavaLaunch.js +62 -0
  243. package/dist/ghidra/GhidraLauncher.js +33 -16
  244. package/dist/ghidra/GhidraProviderCapabilities.js +14 -2
  245. package/dist/ghidra/GhidraProviderClient.js +23 -12
  246. package/dist/ghidra/GhidraSessionError.js +11 -7
  247. package/dist/ghidra/GhidraTargetSnapshot.js +47 -12
  248. package/dist/ghidra/GhidraTransport.js +20 -0
  249. package/dist/hopper/BridgeLauncher.js +31 -11
  250. package/dist/hopper/HopperAnalysisProfile.js +62 -4
  251. package/dist/hopper/HopperCleanup.js +15 -3
  252. package/dist/hopper/HopperClient.js +222 -14
  253. package/dist/hopper/HopperFileOffset.js +237 -0
  254. package/dist/hopper/HopperMachOImage.js +196 -0
  255. package/dist/hopper/HopperOperationStage.js +6 -0
  256. package/dist/hopper/HopperProvider.js +63 -9
  257. package/dist/hopper/HopperProviderCapabilities.js +19 -1
  258. package/dist/hopper/HopperRegexSearch.js +137 -0
  259. package/dist/hopper/HopperRegexWorker.js +27 -0
  260. package/dist/hopper/HopperRequestQueue.js +68 -19
  261. package/dist/hopper/HopperTargetLease.js +3 -2
  262. package/dist/inspector/JavaScriptRuntimeScope.js +9 -1
  263. package/dist/inspector/V8InspectorCaptureProjection.js +8 -3
  264. package/dist/inspector/V8InspectorProvider.js +47 -11
  265. package/dist/javascript/sourceMaps/DecodedSourceMap.js +47 -0
  266. package/dist/javascript/sourceMaps/SourceMapCommand.js +16 -0
  267. package/dist/javascript/sourceMaps/SourceMapFormat.js +79 -31
  268. package/dist/javascript/sourceMaps/TraceSourceMap.js +14 -28
  269. package/dist/mcpDoctor.js +62 -2
  270. package/dist/native/AppleDispatchCoverage.js +47 -6
  271. package/dist/native/AppleDispatchDecodeFacts.js +6 -0
  272. package/dist/native/AppleDispatchMetadata.js +6 -3
  273. package/dist/native/AppleMachoFixups.js +48 -24
  274. package/dist/native/AppleMachoSelection.js +32 -16
  275. package/dist/native/AppleObjcCategories.js +6 -2
  276. package/dist/native/AppleObjcDispatchFacets.js +5 -2
  277. package/dist/native/AppleObjcProperties.js +2 -1
  278. package/dist/native/AppleSwiftDispatchFacets.js +27 -21
  279. package/dist/native/AppleSwiftVtables.js +21 -15
  280. package/dist/native/CommandRunner.js +81 -84
  281. package/dist/native/LldbCallTracer.js +365 -102
  282. package/dist/native/LldbRetainedObservations.js +178 -0
  283. package/dist/native/NativeCallObservation.js +62 -3
  284. package/dist/native/NativeMacOSProvider.js +98 -17
  285. package/dist/native/SignatureTargetBinding.js +155 -0
  286. package/dist/native/parsers/lipo.js +71 -1
  287. package/dist/native/pwndbg/PwndbgCoreContext.js +25 -5
  288. package/dist/native/pwntools/RecordedCrashStructureBindings.js +2 -0
  289. package/dist/process/DarwinProcessRunTokenReader.js +8 -9
  290. package/dist/process/ExecFileOutput.js +20 -0
  291. package/dist/process/OwnedCommand.js +7 -2
  292. package/dist/process/ProcessOwnership.js +203 -53
  293. package/dist/process/ProcessOwnershipObservation.js +49 -4
  294. package/dist/process/ProviderProcess.js +38 -7
  295. package/dist/process/capture/ProcessCaptureError.js +2 -2
  296. package/dist/process/capture/ProcessCaptureLifecycle.js +100 -34
  297. package/dist/server/EvidenceMcpServer.js +146 -0
  298. package/dist/server/createServer.js +15 -8
  299. package/dist/server/registerAndroidTools.js +2 -4
  300. package/dist/server/registerApplicationTools/helpers.js +2 -4
  301. package/dist/server/registerArtifactComparisonTool.js +11 -7
  302. package/dist/server/registerBinaryDiagnosticsTools.js +2 -4
  303. package/dist/server/registerBrowserScenarioTool.js +2 -4
  304. package/dist/server/registerBrowserTools.js +2 -4
  305. package/dist/server/registerBundleComparisonTool.js +2 -3
  306. package/dist/server/registerCloseLifecycleTool.js +8 -18
  307. package/dist/server/registerElectronTools.js +2 -4
  308. package/dist/server/registerEnhancedTools.js +18 -59
  309. package/dist/server/registerEvidenceTools.js +2 -4
  310. package/dist/server/registerEvmTools.js +2 -4
  311. package/dist/server/registerFirmwareTools.js +2 -4
  312. package/dist/server/registerFunctionComparisonTool.js +10 -6
  313. package/dist/server/registerInvestigationTools.js +7 -7
  314. package/dist/server/registerJavaScriptRecoveryTool.js +2 -4
  315. package/dist/server/registerJavaScriptRuntimeObservationTools.js +2 -4
  316. package/dist/server/registerManagedWorkflowTools/compareManagedMembers.js +2 -4
  317. package/dist/server/registerManagedWorkflowTools/importManagedReconstruction.js +2 -4
  318. package/dist/server/registerManagedWorkflowTools/projectManagedApplicationGraph.js +2 -4
  319. package/dist/server/registerManagedWorkflowTools/verifyManagedNativeBoundaries.js +2 -4
  320. package/dist/server/registerOfficialTools.js +2 -4
  321. package/dist/server/registerProcessComparisonTool.js +71 -45
  322. package/dist/server/registerRecordedCrashTools.js +2 -4
  323. package/dist/server/registerSessionRecordTools.js +5 -6
  324. package/dist/server/registerSessionStatusTool.js +17 -3
  325. package/dist/server/registerSessionTools.js +11 -3
  326. package/dist/server/registerWebModuleTool.js +2 -4
  327. package/dist/server/registerWebNetworkCaptureTool.js +2 -4
  328. package/dist/server/registerWebRuntimeTools.js +3 -7
  329. package/dist/server/registerWebScriptTool.js +2 -4
  330. package/dist/server/registerWebSourceLocationTool.js +2 -4
  331. package/dist/server/runDerivedOperation.js +15 -3
  332. package/dist/server/sessionAvailabilityPolicy.js +0 -1
  333. package/dist/server/toolRegistrationOptions.js +2 -2
  334. package/dist/server/toolResult.js +62 -10
  335. package/dist/server/toolResultEncoding.js +33 -0
  336. package/install.sh +1 -1
  337. package/native/windows/build/manifest.json +1 -1
  338. package/package.json +8 -3
  339. package/scripts/electron-active-hook-boundaries.cjs +18 -20
  340. package/scripts/electron-active-hook.cjs +241 -37
  341. package/skills/reverse-engineer-anything/SKILL.md +11 -3
  342. package/skills/reverse-engineer-anything/references/javascript-applications.md +8 -1
  343. package/dist/ghidra/GhidraDefaults.js +0 -2
@@ -1,9 +1,93 @@
1
1
  import { z } from "zod";
2
- /** JSON-safe value shared by domain, application, and adapter boundaries. */
3
- export const jsonValueSchema = z.json();
4
- // Every JSON value satisfies `{}`. Advertise that instead of Zod's
5
- // self-referential `$defs` projection, which MCP clients and model APIs that
6
- // reject recursive JSON Schemas refuse. Runtime parsing still admits only JSON.
2
+ import { isImmutableJsonSnapshot } from "./immutableJson.js";
3
+ /** Maximum JSON nesting accepted before recursive result cloning. */
4
+ export const MAX_JSON_DEPTH = 1000;
5
+ const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
6
+ const recordShape = z.record(z.string(), z.unknown());
7
+ const immutableValidation = new WeakMap();
8
+ /** Validate JSON meaning and nesting without cloning a trusted immutable value. */
9
+ export const jsonValueValidationIssue = (root) => {
10
+ const steps = jsonValueValidationSteps(root);
11
+ for (;;) {
12
+ const step = steps.next();
13
+ if (step.done)
14
+ return step.value;
15
+ }
16
+ };
17
+ /** Validate JSON in bounded steps; cache only authenticated immutable roots. */
18
+ export function* jsonValueValidationSteps(root) {
19
+ const immutable = typeof root === "object" && root !== null && isImmutableJsonSnapshot(root)
20
+ ? root
21
+ : undefined;
22
+ if (immutable !== undefined && immutableValidation.has(immutable))
23
+ return immutableValidation.get(immutable);
24
+ const finish = (issue) => {
25
+ if (immutable !== undefined)
26
+ immutableValidation.set(immutable, issue);
27
+ return issue;
28
+ };
29
+ const pending = [
30
+ { value: root, depth: 0 },
31
+ ];
32
+ let examined = 0;
33
+ while (pending.length > 0) {
34
+ if (examined++ === 4096) {
35
+ examined = 0;
36
+ yield;
37
+ }
38
+ const item = pending.pop();
39
+ if (item === undefined)
40
+ break;
41
+ if (item.depth > MAX_JSON_DEPTH)
42
+ return finish(`JSON value exceeds maximum nesting depth of ${MAX_JSON_DEPTH}`);
43
+ const value = item.value;
44
+ if (value === null ||
45
+ typeof value === "string" ||
46
+ typeof value === "boolean")
47
+ continue;
48
+ if (typeof value === "number") {
49
+ if (!Number.isFinite(value))
50
+ return finish("JSON numbers must be finite");
51
+ }
52
+ else if (Array.isArray(value)) {
53
+ for (const child of value)
54
+ pending.push({ value: child, depth: item.depth + 1 });
55
+ }
56
+ else if (isRecord(value) && recordShape.safeParse(value).success) {
57
+ // Inspect every own member, including keys Zod's record parser skips.
58
+ for (const child of Object.values(value))
59
+ pending.push({ value: child, depth: item.depth + 1 });
60
+ }
61
+ else
62
+ return finish("Invalid JSON value");
63
+ }
64
+ return finish(undefined);
65
+ }
66
+ const preserveJsonValue = (value) => {
67
+ if (Array.isArray(value))
68
+ return value.map(preserveJsonValue);
69
+ if (value !== null && typeof value === "object")
70
+ return Object.fromEntries(Object.entries(value).map(([key, child]) => [
71
+ key,
72
+ preserveJsonValue(child),
73
+ ]));
74
+ return value;
75
+ };
76
+ const validatedJsonValue = z.custom((value) => jsonValueValidationIssue(value) === undefined, {
77
+ error: (issue) => jsonValueValidationIssue(issue.input) ?? "Invalid JSON value",
78
+ });
79
+ // Keep both stages nonrecursive in public and Standard Schema projections.
80
+ validatedJsonValue._zod.toJSONSchema = () => ({});
81
+ /** Parse bounded JSON and retain all own data members without prototype setters. */
82
+ export const jsonValueSchema = z
83
+ .unknown()
84
+ .nonoptional()
85
+ .pipe(validatedJsonValue)
86
+ .transform(preserveJsonValue);
7
87
  jsonValueSchema._zod.toJSONSchema = () => ({});
88
+ const objectValidation = z.custom(isRecord, "Expected JSON object");
89
+ const objectProjection = () => ({ type: "object", additionalProperties: {} });
90
+ objectValidation._zod.toJSONSchema = objectProjection;
8
91
  /** JSON object boundary for caller-visible parameter maps. */
9
- export const jsonObjectSchema = z.record(z.string(), jsonValueSchema);
92
+ export const jsonObjectSchema = jsonValueSchema.pipe(objectValidation);
93
+ jsonObjectSchema._zod.toJSONSchema = objectProjection;
@@ -1,4 +1,10 @@
1
1
  import { isAbsolute, relative, sep } from "node:path";
2
+ import { z } from "zod";
3
+ /** Preserve selected filesystem names while rejecting OS-invalid NUL bytes. */
4
+ export const localPathStringSchema = z
5
+ .string()
6
+ .min(1)
7
+ .regex(/^[^\0]*$/u, "Local filesystem paths cannot contain NUL");
2
8
  /** True when the value is an absolute filesystem path on the host platform. */
3
9
  export const isAbsoluteLocalPath = (value) => isAbsolute(value);
4
10
  /** Test lexical containment on the host platform; callers must resolve symlinks first. */
@@ -1,13 +1,14 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import canonicalize from "canonicalize";
3
3
  import { z } from "zod";
4
- import { evidenceSchema, parseEvidence } from "../evidence.js";
4
+ import { evidenceSchema } from "../evidence.js";
5
5
  import { createJavaScriptApplicationGraph, javascriptApplicationGraphSchema, } from "../javascript/javascriptApplicationGraph.js";
6
6
  import { managedArtifactInspectionSchema, managedMemberInspectionSchema, managedNativeBoundaryInspectionSchema, } from "./managedArtifact.js";
7
7
  import { assessManagedGraphOmissions, managedGraphEvidenceCoverage, managedGraphResultCoverage, } from "./managedApplicationGraphCoverage.js";
8
8
  import { addArtifactNode, addArtifactIdentityNodes, addBoundaryNodes, addMemberNodes, } from "./managedApplicationGraphNodes.js";
9
9
  import { digestSchema } from "../digests.js";
10
10
  import { prefixedDigestSchema } from "../digests.js";
11
+ import { parseManagedInspectionEvidence } from "./managedInspectionEvidence.js";
11
12
  const evidenceIdSchema = prefixedDigestSchema("ev");
12
13
  const textSchema = z.string().min(1);
13
14
  /** Authenticated managed Evidence records projected into the application graph. */
@@ -121,20 +122,14 @@ export const projectManagedApplicationGraph = (input) => {
121
122
  const parseManagedInputs = (input) => ({
122
123
  artifact: input.managed_artifact === undefined
123
124
  ? null
124
- : parseManagedEvidence(input.managed_artifact, "inspect_managed_artifact", managedArtifactInspectionSchema),
125
+ : parseManagedInspectionEvidence(input.managed_artifact, "inspect_managed_artifact", managedArtifactInspectionSchema),
125
126
  members: input.managed_members === undefined
126
127
  ? null
127
- : parseManagedEvidence(input.managed_members, "inspect_managed_members", managedMemberInspectionSchema),
128
+ : parseManagedInspectionEvidence(input.managed_members, "inspect_managed_members", managedMemberInspectionSchema),
128
129
  boundaries: input.managed_native_boundaries === undefined
129
130
  ? null
130
- : parseManagedEvidence(input.managed_native_boundaries, "inspect_managed_native_boundaries", managedNativeBoundaryInspectionSchema),
131
+ : parseManagedInspectionEvidence(input.managed_native_boundaries, "inspect_managed_native_boundaries", managedNativeBoundaryInspectionSchema),
131
132
  });
132
- const parseManagedEvidence = (rawEvidence, operation, schema) => {
133
- const evidence = parseEvidence(rawEvidence);
134
- if (evidence.operation !== operation)
135
- throw new TypeError(`Evidence operation is not ${operation}`);
136
- return { evidence, result: schema.parse(evidence.normalized_result) };
137
- };
138
133
  const chooseArtifact = (parsed) => {
139
134
  const result = parsed.artifact?.result ??
140
135
  parsed.members?.result ??
@@ -164,6 +159,11 @@ const projectionLimitations = (parsed, omissions) => [
164
159
  "Managed member Evidence was not supplied; type, method, and field nodes are absent.",
165
160
  ]
166
161
  : []),
162
+ ...(parsed.artifact === null
163
+ ? [
164
+ "Managed artifact Evidence was not supplied; assembly identity observations are absent.",
165
+ ]
166
+ : []),
167
167
  ...(parsed.boundaries === null
168
168
  ? [
169
169
  "Managed native-boundary Evidence was not supplied; P/Invoke and native-implementation nodes are absent.",
@@ -0,0 +1,16 @@
1
+ import { parseEvidence } from "../evidence.js";
2
+ /**
3
+ * Parse managed inspection Evidence and bind its artifact to any available subject.
4
+ * A null subject remains valid and means there is no digest to cross-check.
5
+ */
6
+ export const parseManagedInspectionEvidence = (rawEvidence, operation, schema) => {
7
+ const evidence = parseEvidence(rawEvidence);
8
+ if (evidence.operation !== operation)
9
+ throw new TypeError(`Evidence operation is not ${operation}`);
10
+ const result = schema.parse(evidence.normalized_result);
11
+ const artifactSha256 = result.artifact.sha256;
12
+ const subjectSha256 = evidence.subject?.digest.sha256;
13
+ if (subjectSha256 !== undefined && artifactSha256 !== subjectSha256)
14
+ throw new TypeError(`Managed Evidence ${operation} (${evidence.evidence_id}) subject SHA-256 ${subjectSha256} does not match normalized artifact SHA-256 ${artifactSha256}`);
15
+ return { evidence, result };
16
+ };
@@ -1,7 +1,7 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import canonicalize from "canonicalize";
3
- import { parseEvidence } from "../evidence.js";
4
3
  import { managedMemberInspectionSchema, } from "./managedArtifact.js";
4
+ import { parseManagedInspectionEvidence } from "./managedInspectionEvidence.js";
5
5
  export const sha256 = (value) => {
6
6
  const serialized = canonicalize(value);
7
7
  if (serialized === undefined)
@@ -10,9 +10,7 @@ export const sha256 = (value) => {
10
10
  };
11
11
  const keyMethod = (item) => ({
12
12
  item,
13
- exactKey: item.signature.parse_status === "decoded" &&
14
- item.body.status === "present" &&
15
- item.body.normalized_il_sha256 !== null
13
+ exactKey: item.body.status === "present" && item.body.normalized_il_sha256 !== null
16
14
  ? stableKey([
17
15
  "method-exact",
18
16
  item.signature.raw_sha256,
@@ -173,11 +171,9 @@ export const keyMembers = (left, right) => ({
173
171
  fieldMatches: matchFields(left.result.fields.map(keyField), right.result.fields.map(keyField)),
174
172
  });
175
173
  export const parseManagedMemberEvidence = (evidence) => {
176
- const parsed = parseEvidence(evidence);
177
- if (parsed.operation !== "inspect_managed_members")
178
- throw new TypeError("Evidence operation is not inspect_managed_members");
174
+ const parsed = parseManagedInspectionEvidence(evidence, "inspect_managed_members", managedMemberInspectionSchema);
179
175
  return {
180
- evidenceId: parsed.evidence_id,
181
- result: managedMemberInspectionSchema.parse(parsed.normalized_result),
176
+ evidenceId: parsed.evidence.evidence_id,
177
+ result: parsed.result,
182
178
  };
183
179
  };
@@ -1,7 +1,7 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import canonicalize from "canonicalize";
3
- import { parseEvidence } from "../evidence.js";
4
3
  import { managedNativeBoundaryInspectionSchema, } from "./managedArtifact.js";
4
+ import { parseManagedInspectionEvidence } from "./managedInspectionEvidence.js";
5
5
  import { managedNativeVerificationResultSchema, } from "./managedNativeVerificationSchemas.js";
6
6
  import { buildVerificationResult, collectNativeSymbols, verifyPinvoke, } from "./managedNativeVerificationMatch.js";
7
7
  export { managedNativeVerificationInputSchema, } from "./managedNativeVerificationSchemas.js";
@@ -12,16 +12,10 @@ const sha256 = (value) => {
12
12
  throw new TypeError("Managed/native verification canonicalization failed");
13
13
  return createHash("sha256").update(serialized).digest("hex");
14
14
  };
15
- const managedBoundaryFromInput = (input) => {
16
- const managedEvidence = parseEvidence(input.managed_boundaries);
17
- if (managedEvidence.operation !== "inspect_managed_native_boundaries")
18
- throw new TypeError("Evidence operation is not inspect_managed_native_boundaries");
19
- return managedNativeBoundaryInspectionSchema.parse(managedEvidence.normalized_result);
20
- };
15
+ const parseManagedBoundary = (input) => parseManagedInspectionEvidence(input.managed_boundaries, "inspect_managed_native_boundaries", managedNativeBoundaryInspectionSchema);
21
16
  /** Verify managed P/Invoke declarations against authenticated native Evidence. */
22
17
  export const verifyManagedNativeBoundaries = (input) => {
23
- const managed = managedBoundaryFromInput(input);
24
- const managedEvidence = parseEvidence(input.managed_boundaries);
18
+ const { evidence: managedEvidence, result: managed } = parseManagedBoundary(input);
25
19
  const native = collectNativeSymbols(input.native_observations);
26
20
  const verifiedPinvokes = managed.pinvoke_imports.map((item) => verifyPinvoke({
27
21
  item,
@@ -0,0 +1 @@
1
+ export {};
@@ -1,14 +1,16 @@
1
1
  import { z } from "zod";
2
+ import { localPathStringSchema } from "../localPath.js";
2
3
  const hexSchema = z.string().regex(/^0x[0-9a-f]+$/u);
3
- /** Objective-C class names and selectors never contain spaces or brackets. */
4
- const objcName = z
4
+ const nativeString = z
5
5
  .string()
6
+ .regex(/^[^\0]*$/u, "Native launch and breakpoint strings cannot contain NUL");
7
+ /** Objective-C class names and selectors never contain spaces or brackets. */
8
+ const objcName = nativeString
6
9
  .min(1)
7
10
  .regex(/^[^\s[\]]+$/u, "Use the bare name without spaces or brackets");
8
11
  const functionBreakpoint = {
9
12
  kind: z.literal("function"),
10
- name: z
11
- .string()
13
+ name: nativeString
12
14
  .min(1)
13
15
  .describe("Exact symbol name, such as `open`, a C++ or mangled Swift symbol, or `-[NSString length]`."),
14
16
  };
@@ -20,8 +22,7 @@ const objcMethodBreakpoint = {
20
22
  export const nativeCallBreakpointSchema = z.discriminatedUnion("kind", [
21
23
  z.strictObject({
22
24
  ...functionBreakpoint,
23
- module: z
24
- .string()
25
+ module: nativeString
25
26
  .min(1)
26
27
  .optional()
27
28
  .describe("Image file name that defines the symbol, such as `libsystem_kernel.dylib`; omit to match every image."),
@@ -40,7 +41,7 @@ export const nativeCallBreakpointSchema = z.discriminatedUnion("kind", [
40
41
  */
41
42
  export const nativeCallObservationInputSchema = z.strictObject({
42
43
  breakpoints: z.array(nativeCallBreakpointSchema).min(1),
43
- arguments: z.array(z.string()).default([]),
44
+ arguments: z.array(nativeString).default([]),
44
45
  environment: z
45
46
  .record(z
46
47
  .string()
@@ -48,7 +49,7 @@ export const nativeCallObservationInputSchema = z.strictObject({
48
49
  .regex(/^[^=\0]+$/u, "Environment names cannot contain '=' or NUL"), z.string().regex(/^[^\0]*$/u, "Environment values cannot contain NUL"))
49
50
  .default({})
50
51
  .describe("Overrides on top of the environment REA runs with."),
51
- working_directory: z.string().min(1).optional(),
52
+ working_directory: localPathStringSchema.optional(),
52
53
  duration_ms: z
53
54
  .number()
54
55
  .int()
@@ -100,10 +101,13 @@ export const nativeCallEventSchema = z.strictObject({
100
101
  registers: z.array(z.strictObject({ name: z.string(), value: hexSchema })),
101
102
  backtrace: z.array(nativeCodeLocationSchema),
102
103
  });
103
- const capturedOutputSchema = z.strictObject({
104
+ /** Retained native output with explicit stream completeness and byte counts. */
105
+ export const nativeCapturedOutputSchema = z.strictObject({
104
106
  text: z.string(),
107
+ /** Bytes observed by the bridge, not a total when complete is false. */
105
108
  bytes: z.number().int().nonnegative(),
106
109
  truncated: z.boolean(),
110
+ complete: z.boolean(),
107
111
  });
108
112
  /** Observed calls, the process lifecycle, and breakpoint resolution. */
109
113
  export const nativeCallObservationResultSchema = z.strictObject({
@@ -112,7 +116,21 @@ export const nativeCallObservationResultSchema = z.strictObject({
112
116
  sha256: z.string().regex(/^[0-9a-f]{64}$/u),
113
117
  architecture: z.string(),
114
118
  arguments: z.array(z.string()),
119
+ environment: z.record(z.string(), z.string()),
115
120
  working_directory: z.string().nullable(),
121
+ launch_identity: z.strictObject({
122
+ /** A pathname hash does not verify the bytes mapped into the process. */
123
+ loaded_image_sha256: z.null(),
124
+ file_device: z.string().nullable(),
125
+ file_inode: z.string().nullable(),
126
+ selected_file_sha256: z
127
+ .string()
128
+ .regex(/^[0-9a-f]{64}$/u)
129
+ .nullable(),
130
+ module_path: z.string().nullable(),
131
+ module_uuid: z.string().nullable(),
132
+ stable: z.boolean(),
133
+ }),
116
134
  }),
117
135
  debugger: z.strictObject({
118
136
  path: z.string(),
@@ -126,14 +144,15 @@ export const nativeCallObservationResultSchema = z.strictObject({
126
144
  "duration-elapsed",
127
145
  "event-limit",
128
146
  "stop-limit",
147
+ "resource-limit",
129
148
  ]),
130
149
  exit_status: z.number().int().nullable(),
131
150
  exit_description: z.string().nullable(),
132
151
  /** REA confirmed the process is gone when observation ended. */
133
152
  terminated: z.boolean(),
134
153
  elapsed_ms: z.number().nonnegative(),
135
- stdout: capturedOutputSchema,
136
- stderr: capturedOutputSchema,
154
+ stdout: nativeCapturedOutputSchema,
155
+ stderr: nativeCapturedOutputSchema,
137
156
  /** Signal and exception stops LLDB reported; the process continued past each. */
138
157
  other_stops: z.array(z.string()),
139
158
  }),
@@ -157,6 +176,9 @@ export const nativeCallObservationResultSchema = z.strictObject({
157
176
  coverage: z.strictObject({
158
177
  status: z.enum(["complete", "partial"]),
159
178
  event_limit_reached: z.boolean(),
179
+ resource_limit_reached: z.boolean(),
180
+ /** Aggregate breakpoint-location metadata exhausted its retained-byte budget. */
181
+ breakpoint_locations_truncated: z.boolean().optional(),
160
182
  /** Requests that matched no code in any image loaded while observing. */
161
183
  unresolved_breakpoints: z.array(z.number().int().nonnegative()),
162
184
  }),
@@ -0,0 +1,33 @@
1
+ import { z } from "zod";
2
+ import { nativeCallEventSchema, nativeCapturedOutputSchema, } from "./nativeCallObservation.js";
3
+ /** Native call evidence retained when observation fails before a full result. */
4
+ export const nativeCallPartialObservationSchema = z.strictObject({
5
+ kind: z.literal("native-call-observation"),
6
+ target: z.strictObject({
7
+ path: z.string(),
8
+ sha256: z.string().regex(/^[0-9a-f]{64}$/u),
9
+ architecture: z.string(),
10
+ arguments: z.array(z.string()),
11
+ environment: z.record(z.string(), z.string()),
12
+ working_directory: z.string().nullable(),
13
+ }),
14
+ process: z.strictObject({
15
+ pid: z.number().int().positive().nullable(),
16
+ stdout: nativeCapturedOutputSchema.nullable(),
17
+ stderr: nativeCapturedOutputSchema.nullable(),
18
+ other_stops: z.array(z.string()),
19
+ }),
20
+ debugger: z.strictObject({ version: z.string().nullable() }),
21
+ events: z.array(nativeCallEventSchema),
22
+ coverage: z.strictObject({
23
+ status: z.literal("partial"),
24
+ reason: z.enum([
25
+ "cancelled",
26
+ "timeout",
27
+ "tracer-failure",
28
+ "capture-failure",
29
+ "cleanup-failure",
30
+ ]),
31
+ }),
32
+ limitations: z.array(z.string()),
33
+ });
@@ -73,6 +73,7 @@ const processSettlementSchema = z.discriminatedUnion("state", [
73
73
  cleanup_outcome: z.enum(["cleaned", "failed"]),
74
74
  }),
75
75
  ]);
76
+ const unverifiedCleanupProcessesSchema = z.array(z.strictObject({ pid: z.number().int().positive(), reason: z.string() }));
76
77
  const processCaptureShapeSchema = z.strictObject({
77
78
  manifest: z.strictObject({
78
79
  rea_version: z.string().min(1),
@@ -189,11 +190,13 @@ const processCaptureShapeSchema = z.strictObject({
189
190
  cleanup: z.object({
190
191
  owned_process_group: z.literal("verified"),
191
192
  temporary_root: z.literal("removed"),
193
+ unverified_processes: unverifiedCleanupProcessesSchema.optional(),
192
194
  }),
193
195
  });
194
196
  const processCleanupResourceSchema = z.strictObject({
195
197
  state: z.enum(["cleaned", "failed", "unverified", "not_required"]),
196
198
  reason: z.string().nullable(),
199
+ unverified_processes: unverifiedCleanupProcessesSchema.optional(),
197
200
  });
198
201
  const partialObservationFieldSchema = (value) => z.discriminatedUnion("state", [
199
202
  z.strictObject({ state: z.literal("available"), value }),
@@ -244,18 +247,19 @@ const completedCaptureObservationSchema = z.strictObject({
244
247
  const incompleteCaptureObservationSchema = z.strictObject({
245
248
  observations: incompleteProcessCaptureObservationsSchema,
246
249
  });
247
- /** Validated, non-comparable process observations attached to cleanup errors. */
250
+ /** Validated, non-comparable process observations attached to execution or cleanup errors. */
248
251
  export const partialProcessCaptureObservationSchema = z
249
252
  .union([
250
253
  completedCaptureObservationSchema.extend(partialObservationMetadataSchema.shape),
251
254
  incompleteCaptureObservationSchema.extend(partialObservationMetadataSchema.shape),
252
255
  ])
253
256
  .superRefine((partial, context) => {
254
- if (!Object.values(partial.cleanup).some(({ state }) => state === "failed" || state === "unverified"))
257
+ const cleanupIncomplete = Object.values(partial.cleanup).some(({ state }) => state === "failed" || state === "unverified");
258
+ if (!cleanupIncomplete && partial.execution_failure === null)
255
259
  context.addIssue({
256
260
  code: "custom",
257
- path: ["cleanup"],
258
- message: "partial observations require incomplete resource cleanup",
261
+ path: ["execution_failure"],
262
+ message: "partial observations require incomplete cleanup or an execution failure",
259
263
  });
260
264
  if ("observations" in partial) {
261
265
  const { observations } = partial;
@@ -1,8 +1,10 @@
1
1
  import canonicalize from "canonicalize";
2
2
  import { z } from "zod";
3
+ import { AnalysisInputError } from "../analysisErrorCore.js";
3
4
  import { jsonValueSchema } from "../jsonValue.js";
4
5
  import { compareProcessTraces, processTraceOutcomesDiffer, processTraceComparisonResultSchema, } from "./processTraceComparison.js";
5
6
  import { dimensionsForTraceSources, traceCoversObservedDimension, } from "./processTraceDimensionProjection.js";
7
+ const OPERATION = "compare_process_captures";
6
8
  /** Comparison classification that never equates incomplete evidence. */
7
9
  export const comparisonStatusSchema = z.enum([
8
10
  "unchanged",
@@ -152,15 +154,47 @@ const chooseFirstDivergence = (candidates) => {
152
154
  };
153
155
  const assertComparable = (left, right, options) => {
154
156
  if (left.manifest.comparison_contract_sha256 !==
155
- right.manifest.comparison_contract_sha256)
156
- throw new TypeError("Process captures have incompatible comparison contracts");
157
+ right.manifest.comparison_contract_sha256) {
158
+ const fields = differingContractFields(left.manifest.comparison_contract, right.manifest.comparison_contract);
159
+ throw new AnalysisInputError(OPERATION, undefined, [
160
+ {
161
+ path: ["right"],
162
+ reason: "invalid_value",
163
+ message: `Process captures have incompatible comparison contracts${fields.length === 0 ? "" : `; these scenario fields differ: ${fields.join(", ")}`}. Capture both scenarios with the same values for these fields, then compare them.`,
164
+ expected: fields,
165
+ },
166
+ ]);
167
+ }
157
168
  if (options.maxCaptureAgeMs === undefined)
158
169
  return;
159
170
  const maxCaptureAgeMs = options.maxCaptureAgeMs;
160
171
  const now = (options.now ?? Date.now)();
161
- if ([left, right].some(({ manifest }) => now - Date.parse(manifest.completed_at) > maxCaptureAgeMs))
162
- throw new TypeError("Process capture exceeds max_capture_age_ms");
172
+ const stale = [
173
+ ["left", left],
174
+ ["right", right],
175
+ ].flatMap(([side, { manifest }]) => {
176
+ const age = now - Date.parse(manifest.completed_at);
177
+ return age > maxCaptureAgeMs
178
+ ? [
179
+ `${side} completed at ${manifest.completed_at} (${String(age)} ms ago)`,
180
+ ]
181
+ : [];
182
+ });
183
+ if (stale.length > 0)
184
+ throw new AnalysisInputError(OPERATION, undefined, [
185
+ {
186
+ path: ["max_capture_age_ms"],
187
+ reason: "out_of_range",
188
+ message: `Process capture exceeds max_capture_age_ms ${String(maxCaptureAgeMs)}: ${stale.join("; ")}. Recapture the stale scenario or raise max_capture_age_ms.`,
189
+ },
190
+ ]);
163
191
  };
192
+ /** Name top-level contract fields whose canonical values differ. */
193
+ const differingContractFields = (left, right) => [...new Set([...Object.keys(left), ...Object.keys(right)])]
194
+ .filter((field) => !Object.hasOwn(left, field) ||
195
+ !Object.hasOwn(right, field) ||
196
+ canonicalize(left[field]) !== canonicalize(right[field]))
197
+ .sort();
164
198
  const truncatedComparison = () => ({
165
199
  status: "truncated",
166
200
  terminal: "truncated",
@@ -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];
@@ -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;