@lowdefy/server-dev 7.0.0 → 7.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (445) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/checkSharedCollectionIds.js +20 -9
  44. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +59 -11
  45. package/{src/routes/docs/content.js → lib/docs/dataSets/describeTargetKey.js} +10 -14
  46. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  47. package/lib/docs/dataSets/getDataStore.js +11 -3
  48. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  49. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  50. package/lib/docs/dataSets/groupDataSetByCollection.js +19 -11
  51. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  52. package/lib/docs/dataSets/openDataSession.js +36 -20
  53. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +175 -7
  54. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  55. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  56. package/lib/docs/dataSets/readDataSet.js +34 -19
  57. package/lib/docs/dataSets/readDataSet.test.mjs +57 -25
  58. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  59. package/lib/docs/dataSets/sessionDatabaseName.js +32 -0
  60. package/lib/docs/dataSets/sweepOrphanDatabases.js +7 -4
  61. package/lib/docs/dataSets/test/app/lowdefy.yaml +22 -0
  62. package/lib/docs/dataSets/test/app/tests/data/shop.yaml +4 -0
  63. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  64. package/lib/docs/devEventBus.js +7 -2
  65. package/lib/docs/devEventBus.test.mjs +12 -10
  66. package/lib/docs/devToolDefinitions.js +87 -135
  67. package/lib/docs/device/buildDeviceCommand.js +103 -0
  68. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  69. package/lib/docs/device/captureDevice.js +85 -0
  70. package/lib/docs/device/checkShownPage.js +56 -0
  71. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  72. package/lib/docs/device/deviceAction.js +74 -0
  73. package/lib/docs/device/deviceTools.test.mjs +604 -0
  74. package/lib/docs/device/findDeviceTab.js +50 -0
  75. package/lib/docs/device/findDeviceTarget.js +73 -0
  76. package/lib/docs/device/injectDevice.js +160 -0
  77. package/lib/docs/device/listDevices.js +100 -0
  78. package/lib/docs/device/listDevices.test.mjs +105 -0
  79. package/lib/docs/device/runDeviceJourney.js +68 -0
  80. package/lib/docs/device/runDeviceSteps.js +164 -0
  81. package/lib/docs/device/screenshotDevice.js +68 -0
  82. package/lib/docs/device/sendDeviceStep.js +52 -0
  83. package/lib/docs/device/startDevice.js +150 -0
  84. package/lib/docs/docs.test.mjs +44 -28
  85. package/lib/docs/docsIndex.test.mjs +1 -0
  86. package/lib/docs/findConfig.js +3 -4
  87. package/lib/docs/findPageBlock.js +35 -0
  88. package/lib/docs/findPageBlock.test.mjs +45 -0
  89. package/lib/docs/fitResponse.js +18 -17
  90. package/lib/docs/fitResponse.test.mjs +18 -0
  91. package/lib/docs/getBrowser.js +4 -4
  92. package/lib/docs/getBrowser.test.mjs +32 -16
  93. package/lib/docs/getBuildId.test.mjs +1 -0
  94. package/lib/docs/getBuildStatus.js +29 -3
  95. package/lib/docs/getBuildStatus.test.mjs +108 -12
  96. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  97. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  98. package/lib/docs/getHazards.js +4 -1
  99. package/lib/docs/getHazards.test.mjs +9 -7
  100. package/lib/docs/getOverview.js +22 -44
  101. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  102. package/lib/docs/getStaleStatus.test.mjs +1 -0
  103. package/lib/docs/inspectState.js +78 -3
  104. package/lib/docs/inspectState.test.mjs +61 -9
  105. package/lib/docs/inspectStateFromTab.js +38 -6
  106. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  107. package/lib/docs/inspectStateHeadless.js +98 -34
  108. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  109. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  110. package/lib/docs/installHeadlessShell.js +5 -2
  111. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  112. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  113. package/lib/docs/isDeepEqual.js +37 -0
  114. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  115. package/lib/docs/isPageReady.test.mjs +1 -0
  116. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  117. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  118. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  119. package/lib/docs/launchBrowser.test.mjs +8 -8
  120. package/lib/docs/listTypes.js +58 -8
  121. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  122. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  123. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  124. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  125. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  126. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  127. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  128. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  129. package/lib/docs/pollTab.js +100 -0
  130. package/lib/docs/pollTab.test.mjs +64 -0
  131. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  132. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  133. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  134. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  135. package/lib/docs/rails/findExternalBlocks.js +3 -3
  136. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  137. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  138. package/lib/docs/readJourneySession.js +1 -1
  139. package/lib/docs/reportDevToolFault.js +29 -0
  140. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  141. package/lib/docs/requestRestart.test.mjs +1 -0
  142. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  143. package/lib/docs/resolveSource.js +2 -2
  144. package/lib/docs/resolveSource.test.mjs +6 -6
  145. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  146. package/lib/docs/runCheck.test.mjs +3 -3
  147. package/lib/docs/runCheckChild.js +2 -1
  148. package/lib/docs/runEndpoint.js +23 -10
  149. package/lib/docs/runEndpoint.test.mjs +42 -37
  150. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  151. package/lib/docs/runJourney.js +21 -1
  152. package/lib/docs/runJourney.test.mjs +119 -99
  153. package/lib/docs/runJourneyDataSet.test.mjs +26 -26
  154. package/lib/docs/runJourneySteps.js +8 -29
  155. package/lib/docs/runRequest.js +6 -6
  156. package/lib/docs/runRequest.test.mjs +22 -22
  157. package/lib/docs/screenshotPage.js +6 -7
  158. package/lib/docs/screenshotPage.test.mjs +46 -46
  159. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  160. package/lib/docs/searchDocs.test.mjs +1 -0
  161. package/lib/docs/searchIcons.test.mjs +5 -5
  162. package/lib/docs/selectFinalState.test.mjs +1 -0
  163. package/lib/docs/serverErrorStore.test.mjs +4 -4
  164. package/lib/docs/setupTestFixtures.mjs +25 -0
  165. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  166. package/lib/docs/tabAvailable.js +1 -1
  167. package/lib/docs/tabChannel.js +90 -14
  168. package/lib/docs/tabChannel.test.mjs +40 -15
  169. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  170. package/lib/docs/validateStateSelection.test.mjs +1 -0
  171. package/lib/docs/validateViewport.test.mjs +1 -0
  172. package/lib/docs/waitForBuild.test.mjs +1 -0
  173. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  174. package/lib/docs/withDataSession.js +2 -2
  175. package/lib/server/applyDataSetRedirect.js +14 -5
  176. package/lib/server/applyDataSetRedirect.test.mjs +121 -15
  177. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +5 -1
  178. package/lib/server/applyDataSetRedirectWalled.test.mjs +5 -1
  179. package/lib/server/auth/getHeadlessUser.js +6 -0
  180. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  181. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  182. package/lib/server/contextMapBudget.test.mjs +3 -3
  183. package/lib/server/continueJitKeys.test.mjs +1 -0
  184. package/lib/server/createLowdefyContext.js +8 -4
  185. package/lib/server/createLowdefyContext.test.mjs +38 -35
  186. package/lib/server/getClientAddress.test.mjs +2 -2
  187. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  188. package/lib/server/importAppCode.test.mjs +2 -2
  189. package/lib/server/jitPageBuilder.js +27 -3
  190. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  191. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  192. package/lib/server/jitPageBuilder.test.mjs +4 -4
  193. package/lib/server/journeyCookies.test.mjs +1 -0
  194. package/lib/server/loadDynamicJsMap.js +10 -1
  195. package/lib/server/log/createHandleError.js +10 -5
  196. package/lib/server/log/createHandleError.test.mjs +19 -8
  197. package/lib/server/log/createLogger.test.mjs +2 -2
  198. package/lib/server/mutantDataSetWrappers.test.mjs +5 -1
  199. package/lib/server/mutants/listMutants.test.mjs +1 -0
  200. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  201. package/lib/server/mutants/operators.test.mjs +1 -0
  202. package/lib/server/pageBuildRecords.test.mjs +1 -0
  203. package/lib/server/pageCache.test.mjs +1 -0
  204. package/lib/server/pageRebuilds.test.mjs +3 -3
  205. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  206. package/lib/server/pruneJitMaps.test.mjs +1 -0
  207. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  208. package/lib/server/readInstanceRecord.test.mjs +24 -8
  209. package/lib/server/readMergedMaps.test.mjs +1 -0
  210. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  211. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  212. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  213. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  214. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  215. package/lib/server/startIdleGc.test.mjs +25 -9
  216. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  217. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  218. package/manager/getContext.mjs +11 -2
  219. package/manager/processes/checkPendingPlugins.mjs +49 -0
  220. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  221. package/manager/processes/createIdleChild.mjs +141 -0
  222. package/manager/processes/createIdleChild.test.mjs +209 -0
  223. package/manager/processes/initialBuild.mjs +4 -15
  224. package/manager/processes/initialBuild.test.mjs +8 -37
  225. package/manager/processes/lowdefyBuild.mjs +11 -7
  226. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +23 -13
  227. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  228. package/manager/processes/restartServer.test.mjs +63 -15
  229. package/manager/processes/shutdownServer.test.mjs +3 -3
  230. package/manager/processes/startFirstServer.test.mjs +23 -22
  231. package/manager/processes/startMailSink.mjs +11 -3
  232. package/manager/processes/startMailSink.test.mjs +28 -2
  233. package/manager/processes/startProxy.mjs +158 -27
  234. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  235. package/manager/processes/startProxy.test.mjs +127 -2
  236. package/manager/processes/startServer.mjs +5 -7
  237. package/manager/processes/startServer.test.mjs +10 -9
  238. package/manager/processes/syncServer.mjs +31 -4
  239. package/manager/processes/syncServer.test.mjs +71 -6
  240. package/manager/processes/waitForDevServer.test.mjs +21 -6
  241. package/manager/run.mjs +32 -8
  242. package/manager/utils/BatchChanges.mjs +1 -1
  243. package/manager/utils/BatchChanges.test.mjs +4 -4
  244. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  245. package/manager/utils/checkPairing.mjs +45 -0
  246. package/manager/utils/checkPairing.test.mjs +53 -0
  247. package/manager/utils/createBuildActivity.mjs +5 -1
  248. package/manager/utils/createBuildActivity.test.mjs +2 -2
  249. package/manager/utils/createChangeSignal.test.mjs +5 -5
  250. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  251. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  252. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  253. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  254. package/manager/utils/createGlobIgnore.mjs +45 -0
  255. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  256. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  257. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  258. package/manager/utils/createIdleGc.test.mjs +31 -15
  259. package/manager/utils/createLanPairing.mjs +34 -0
  260. package/manager/utils/createLanPairing.test.mjs +46 -0
  261. package/manager/utils/createRequestActivity.mjs +30 -3
  262. package/manager/utils/createRequestActivity.test.mjs +76 -22
  263. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  264. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  265. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  266. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  267. package/manager/utils/findSignInCode.test.mjs +33 -0
  268. package/manager/utils/formatLanPairing.mjs +32 -0
  269. package/manager/utils/formatLanPairing.test.mjs +40 -0
  270. package/manager/utils/getLanAddress.mjs +83 -0
  271. package/manager/utils/getLanAddress.test.mjs +70 -0
  272. package/manager/utils/importFresh.test.mjs +1 -0
  273. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  274. package/manager/utils/pluginTypeCache.mjs +100 -0
  275. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  276. package/manager/utils/pruneRecordings.test.mjs +1 -0
  277. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  278. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  279. package/manager/utils/readBasePath.test.mjs +1 -0
  280. package/manager/utils/readManagerVersion.test.mjs +1 -0
  281. package/manager/utils/readPluginDefinitions.mjs +6 -6
  282. package/manager/utils/renderTerminalQr.mjs +54 -0
  283. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  284. package/manager/utils/setupWatcher.mjs +19 -4
  285. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  286. package/manager/utils/waitForChildExit.test.mjs +2 -2
  287. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  288. package/manager/watchers/envWatcher.mjs +3 -0
  289. package/manager/watchers/envWatcher.test.mjs +19 -7
  290. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  291. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  292. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  293. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  294. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  295. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  296. package/manager/watchers/resolveFile.mjs +46 -0
  297. package/manager/watchers/resolveFile.test.mjs +67 -0
  298. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  299. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  300. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  301. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  302. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  303. package/package.json +50 -49
  304. package/package.original.json +50 -49
  305. package/src/app.js +83 -85
  306. package/src/html/renderDevPage.test.mjs +1 -0
  307. package/src/lib/getPathSegments.js +16 -1
  308. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  309. package/src/lib/isTabAnswer.js +32 -0
  310. package/src/lib/isTabChannelCaller.js +35 -0
  311. package/src/middleware/apiContext.js +4 -2
  312. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  313. package/src/middleware/errorHandler.js +33 -45
  314. package/src/middleware/errorHandler.test.mjs +10 -10
  315. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  316. package/src/middleware/localDevToolsOnly.js +13 -1
  317. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  318. package/src/middleware/noStore.test.mjs +1 -0
  319. package/src/middleware/staleFlag.test.mjs +1 -0
  320. package/src/middleware/stampCaller.test.mjs +1 -0
  321. package/src/routes/agentBearer.test.mjs +183 -0
  322. package/src/routes/auth.test.mjs +10 -10
  323. package/src/routes/clientError.js +21 -4
  324. package/src/routes/clientError.test.mjs +127 -0
  325. package/src/routes/devInspect.js +6 -51
  326. package/src/routes/devInspect.test.mjs +128 -3
  327. package/src/routes/devRecording.js +6 -17
  328. package/src/routes/devRecording.test.mjs +54 -3
  329. package/src/routes/docs/buildStatus.test.mjs +6 -6
  330. package/src/routes/docs/events.test.mjs +4 -4
  331. package/src/routes/docs/find.js +3 -3
  332. package/src/routes/docs/journey.test.mjs +8 -8
  333. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  334. package/src/routes/docs/loadDocsRoutes.js +70 -0
  335. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  336. package/src/routes/docs/mcp.test.mjs +5 -5
  337. package/src/routes/docs/mutants.js +7 -0
  338. package/src/routes/docs/mutants.test.mjs +20 -6
  339. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  340. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  341. package/src/routes/docs/restart.test.mjs +1 -0
  342. package/src/routes/endpoints.js +24 -0
  343. package/src/routes/endpointsLink.test.mjs +111 -0
  344. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  345. package/src/routes/jitPage.js +13 -1
  346. package/src/routes/jitPage.test.mjs +36 -11
  347. package/src/routes/mcp.js +6 -0
  348. package/src/routes/mcp.test.mjs +23 -8
  349. package/src/routes/mcpMemberToken.test.mjs +8 -8
  350. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  351. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  352. package/src/routes/mobileRoutes.test.mjs +223 -0
  353. package/src/routes/mobileSignIn.js +58 -0
  354. package/src/routes/mobileSignIn.test.mjs +59 -0
  355. package/src/routes/mobileSignInCallback.js +34 -0
  356. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  357. package/src/routes/mountDevPageRoutes.js +10 -2
  358. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  359. package/src/routes/mountMobileWellKnown.js +35 -0
  360. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  361. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  362. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  363. package/src/routes/reload.js +101 -20
  364. package/src/routes/reload.test.mjs +153 -0
  365. package/src/routes/request.js +1 -22
  366. package/src/routes/request.test.mjs +7 -24
  367. package/src/routes/requestBody.test.mjs +14 -27
  368. package/src/routes/websocket.test.mjs +2 -2
  369. package/src/routes/wellKnownFallback.test.mjs +2 -2
  370. package/src/websocket/devWebSocket.test.mjs +12 -12
  371. package/vite.config.js +13 -1
  372. package/client/feedback/FeedbackMount.jsx +0 -83
  373. package/client/feedback/FeedbackOverlay.jsx +0 -904
  374. package/client/feedback/captureTabScreenshot.js +0 -84
  375. package/client/feedback/copyToClipboard.js +0 -45
  376. package/client/feedback/drawAnnotationsSvg.js +0 -119
  377. package/client/feedback/feedbackStyles.js +0 -304
  378. package/client/feedback/pinResponsiveImages.js +0 -59
  379. package/client/feedback/sendFeedback.js +0 -39
  380. package/client/feedback/useFeedbackToggle.js +0 -70
  381. package/client/recorder/buildEngineRecord.js +0 -37
  382. package/client/recorder/buildInteractionRecord.js +0 -64
  383. package/client/recorder/buildTraceEvent.js +0 -57
  384. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  385. package/client/recorder/chunkRecords.js +0 -69
  386. package/client/recorder/chunkRecords.test.mjs +0 -59
  387. package/client/recorder/collectEventEndpoints.js +0 -40
  388. package/client/recorder/collectEventRequests.js +0 -39
  389. package/client/recorder/createPairingBuffer.js +0 -187
  390. package/client/recorder/createPasswordRedactor.js +0 -84
  391. package/client/recorder/createRecordBatcher.js +0 -54
  392. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  393. package/client/recorder/createRecordingSession.js +0 -61
  394. package/client/recorder/createRecordingSession.test.mjs +0 -72
  395. package/client/recorder/diffStateWrites.js +0 -77
  396. package/client/recorder/diffStateWrites.test.mjs +0 -66
  397. package/client/recorder/isEventCall.js +0 -30
  398. package/client/recorder/jsonType.js +0 -39
  399. package/client/recorder/sendRecords.js +0 -40
  400. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  401. package/lib/docs/checkpointPaths.js +0 -91
  402. package/lib/docs/checkpointStore.js +0 -243
  403. package/lib/docs/checkpointToMocks.js +0 -65
  404. package/lib/docs/configCheckpoints.test.mjs +0 -156
  405. package/lib/docs/createConfigCheckpoint.js +0 -92
  406. package/lib/docs/dataSets/findCollectionCollisions.js +0 -52
  407. package/lib/docs/devMockRegistry.js +0 -68
  408. package/lib/docs/enrichFeedback.js +0 -71
  409. package/lib/docs/evalOperator.js +0 -49
  410. package/lib/docs/evalOperator.test.mjs +0 -157
  411. package/lib/docs/evalOperatorHeadless.js +0 -159
  412. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  413. package/lib/docs/evalOperatorInTab.js +0 -49
  414. package/lib/docs/formatFeedback.js +0 -142
  415. package/lib/docs/formatFeedback.test.mjs +0 -252
  416. package/lib/docs/getPluginDoc.js +0 -53
  417. package/lib/docs/listConfigCheckpoints.js +0 -55
  418. package/lib/docs/loadState.js +0 -220
  419. package/lib/docs/revertConfigCheckpoint.js +0 -73
  420. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  421. package/lib/docs/scaffoldPage.js +0 -77
  422. package/lib/docs/scaffoldPage.test.mjs +0 -97
  423. package/lib/docs/snapshotState.js +0 -67
  424. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  425. package/manager/watchers/listServerSidePackages.mjs +0 -47
  426. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  427. package/src/routes/docs/checkpointsCreate.js +0 -28
  428. package/src/routes/docs/evalOperator.js +0 -70
  429. package/src/routes/docs/inspectState.js +0 -59
  430. package/src/routes/docs/loadState.js +0 -51
  431. package/src/routes/docs/pluginDoc.js +0 -33
  432. package/src/routes/docs/plugins.js +0 -23
  433. package/src/routes/docs/runEndpoint.js +0 -54
  434. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  435. package/src/routes/docs/runRequest.js +0 -53
  436. package/src/routes/docs/runRequest.test.mjs +0 -92
  437. package/src/routes/docs/schema.js +0 -37
  438. package/src/routes/docs/screenshot.js +0 -120
  439. package/src/routes/docs/screenshot.test.mjs +0 -117
  440. package/src/routes/docs/search.js +0 -40
  441. package/src/routes/docs/snapshotState.js +0 -50
  442. package/src/routes/docs/stateCheckpointsList.js +0 -26
  443. package/src/routes/docs/types.js +0 -33
  444. package/src/routes/feedback.js +0 -107
  445. package/src/routes/feedback.test.mjs +0 -204
@@ -19,6 +19,7 @@ import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
21
  import createDataSetRails from './createDataSetRails.js';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let buildDirectory;
24
25
 
@@ -20,9 +20,9 @@ import pageBlocks from '../pageBlocks.js';
20
20
  import readBuiltArtifact from './readBuiltArtifact.js';
21
21
  import readRoutineSteps from '../readRoutineSteps.js';
22
22
 
23
- // The meta.dataSet declarations a data session runs against the session's database (see
24
- // lib/server/applyDataSetRedirect.js): 'redirect' takes the session database, 'walled' reaches it
25
- // only through walled connections. Every other declaration, or none, would reach a real service or
23
+ // The meta.dataSet declarations a data session runs against the session's databases (see
24
+ // lib/server/applyDataSetRedirect.js): 'redirect' takes its target's session database, 'walled'
25
+ // reaches them only through walled connections. Every other declaration, or none, would reach a real service or
26
26
  // is refused by the gate.
27
27
  const CLICKABLE_DATA_SET_MODES = new Set(['redirect', 'walled']);
28
28
 
@@ -19,6 +19,7 @@ import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
21
  import findExternalBlocks from './findExternalBlocks.js';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let buildDirectory;
24
25
 
@@ -18,7 +18,7 @@ import fs from 'node:fs';
18
18
  import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
- import { jest } from '@jest/globals';
21
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
22
22
 
23
23
  import JourneyStepError from './JourneyStepError.js';
24
24
  import readJourneyEmailMatch from './readJourneyEmailMatch.js';
@@ -53,7 +53,7 @@ function writeMessage({ id, subject, html = null, text = null }) {
53
53
  );
54
54
  }
55
55
 
56
- const page = { waitForTimeout: jest.fn(async () => {}) };
56
+ const page = { waitForTimeout: vi.fn(async () => {}) };
57
57
 
58
58
  function read(params) {
59
59
  return readJourneyEmailMatch({
@@ -22,7 +22,7 @@ import {
22
22
  } from '@lowdefy/node-utils';
23
23
  import { type } from '@lowdefy/helpers';
24
24
 
25
- import { getConfigDirectory } from './checkpointPaths.js';
25
+ import getConfigDirectory from './getConfigDirectory.js';
26
26
  import readBuildArtifact from './readBuildArtifact.js';
27
27
 
28
28
  function describeEmpty() {
@@ -0,0 +1,29 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ // A dev tool that throws something other than the outcome it reports (a failed
18
+ // step, an app error) has a bug of its own or lost its browser. Returned as a
19
+ // bare message, that looked to an agent like a failure of its app, and nothing
20
+ // was logged. It is logged here with its stack, and the text an agent gets says
21
+ // whose fault it is and where the stack is.
22
+ function reportDevToolFault({ error, logger, tool }) {
23
+ logger.error({ err: error, event: 'dev_tool_fault', tool }, `The ${tool} dev tool failed.`);
24
+ return `${error?.name ?? 'Error'}: ${
25
+ error?.message
26
+ } (a fault in the dev server's ${tool} tool, not in the app; the dev server terminal has the stack)`;
27
+ }
28
+
29
+ export default reportDevToolFault;
@@ -0,0 +1,34 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { expect, test, vi } from 'vitest';
18
+
19
+ import reportDevToolFault from './reportDevToolFault.js';
20
+
21
+ test('reportDevToolFault logs the error with its stack and names the tool as at fault', () => {
22
+ const logger = { error: vi.fn() };
23
+ const error = new TypeError("Cannot read properties of undefined (reading 'page')");
24
+
25
+ const text = reportDevToolFault({ error, logger, tool: 'lowdefy_run_journey' });
26
+
27
+ expect(logger.error).toHaveBeenCalledWith(
28
+ { err: error, event: 'dev_tool_fault', tool: 'lowdefy_run_journey' },
29
+ 'The lowdefy_run_journey dev tool failed.'
30
+ );
31
+ expect(text).toBe(
32
+ "TypeError: Cannot read properties of undefined (reading 'page') (a fault in the dev server's lowdefy_run_journey tool, not in the app; the dev server terminal has the stack)"
33
+ );
34
+ });
@@ -17,6 +17,7 @@
17
17
  import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
+ import { afterAll, expect, test } from 'vitest';
20
21
 
21
22
  const originalCwd = process.cwd();
22
23
  const fixtureDir = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-request-restart-test-'));
@@ -17,6 +17,7 @@
17
17
  import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
+ import { afterAll, expect, test } from 'vitest';
20
21
 
21
22
  // readPagePath reads build/routes.json from process.cwd(): chdir into a fixture
22
23
  // that has one before the module loads.
@@ -18,8 +18,8 @@ import { type } from '@lowdefy/helpers';
18
18
 
19
19
  import tabAvailable from './tabAvailable.js';
20
20
 
21
- // The single tab-vs-headless decision, shared by inspectState and evalOperator
22
- // so a change to the rule lands in both. Prefers a real, already-open browser
21
+ // The tab-vs-headless decision for inspectState, for a snapshot and for an
22
+ // expression alike. Prefers a real, already-open browser
23
23
  // tab over a fresh headless one — a live tab reflects whatever a developer is
24
24
  // actually looking at (their own interactions, in-flight requests), while
25
25
  // headless always starts a clean navigation.
@@ -14,18 +14,18 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, beforeEach, expect, test } from 'vitest';
18
18
 
19
- const mockTabAvailable = jest.fn();
19
+ const mockTabAvailable = vi.fn();
20
20
 
21
- jest.unstable_mockModule('./tabAvailable.js', () => ({
21
+ vi.doMock('./tabAvailable.js', () => ({
22
22
  default: mockTabAvailable,
23
23
  }));
24
24
 
25
25
  const { default: resolveSource } = await import('./resolveSource.js');
26
26
 
27
27
  beforeEach(() => {
28
- jest.clearAllMocks();
28
+ vi.clearAllMocks();
29
29
  });
30
30
 
31
31
  test('resolveSource tries the tab when source is "tab"', () => {
@@ -80,13 +80,13 @@ test('resolveSource marks a user combined with source "tab" as invalid input', (
80
80
 
81
81
  test('resolveSource names the calling function in the invalid-input error', () => {
82
82
  const result = resolveSource({
83
- name: 'evalOperator',
83
+ name: 'screenshotPage',
84
84
  pageId: 'home',
85
85
  source: 'tab',
86
86
  user: { roles: ['admin'] },
87
87
  });
88
88
 
89
- expect(result.error).toMatch(/^evalOperator cannot apply "user"/);
89
+ expect(result.error).toMatch(/^screenshotPage cannot apply "user"/);
90
90
  });
91
91
 
92
92
  test('resolveSource treats a null user as no user', () => {
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import fs from 'node:fs';
18
- import { jest } from '@jest/globals';
18
+ import { vi, beforeEach, expect, test } from 'vitest';
19
19
  import os from 'node:os';
20
20
  import path from 'node:path';
21
21
 
@@ -33,7 +33,7 @@ const { default: buildEditedPages } = await import('./buildEditedPages.js');
33
33
  const { default: reviewPageBuilds } = await import('./reviewPageBuilds.js');
34
34
 
35
35
  // A JIT page build loads the build package's plugins on first use.
36
- jest.setTimeout(30000);
36
+ vi.setConfig({ testTimeout: 30000, hookTimeout: 30000 });
37
37
 
38
38
  const longAgo = new Date('2000-01-01T00:00:00.000Z');
39
39
  let lastSignal = 0;
@@ -13,10 +13,10 @@
13
13
  See the License for the specific language governing permissions and
14
14
  limitations under the License.
15
15
  */
16
- import { jest } from '@jest/globals';
16
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
17
17
 
18
- jest.unstable_mockModule('child_process', () => ({
19
- execFile: jest.fn(),
18
+ vi.doMock('child_process', () => ({
19
+ execFile: vi.fn(),
20
20
  }));
21
21
 
22
22
  const { execFile } = await import('child_process');
@@ -32,13 +32,14 @@ async function run() {
32
32
  server: serverDirectory,
33
33
  };
34
34
  const logger = createNodeLogger({ name: 'lowdefy_check', level: 'silent' });
35
- const [customTypesMap, customMessagesMap] = await Promise.all([
35
+ const [{ customTypesMap, customTypesMapMobile }, customMessagesMap] = await Promise.all([
36
36
  createCustomPluginTypesMap({ directories, logger }),
37
37
  createCustomPluginMessagesMap({ directories, logger }),
38
38
  ]);
39
39
  const report = await check({
40
40
  customMessagesMap,
41
41
  customTypesMap,
42
+ customTypesMapMobile,
42
43
  directories,
43
44
  logger,
44
45
  refResolver: process.env.LOWDEFY_BUILD_REF_RESOLVER,
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import { callEndpoint, getEndpointConfig, runDetachedEndpoint } from '@lowdefy/api';
18
- import { ConfigError } from '@lowdefy/errors';
18
+ import { UserError } from '@lowdefy/errors';
19
19
  import { type } from '@lowdefy/helpers';
20
20
 
21
21
  import isWriteRequestsAllowed from './isWriteRequestsAllowed.js';
@@ -31,7 +31,7 @@ import withDataSession from './withDataSession.js';
31
31
  // Never throws for outcomes an agent should reason about: refusals, a :reject
32
32
  // or :throw in the routine, and faults that escape callEndpoint (auth
33
33
  // refusals, missing connections, InternalApi endpoints) all come back as data.
34
- // Only malformed input throws, as a ConfigError.
34
+ // Only malformed input throws, as a UserError: the agent wrote it.
35
35
  //
36
36
  // system: true runs the routine through runDetachedEndpoint instead - the same
37
37
  // entry point POST /api/detached uses - so it executes as a system context
@@ -54,32 +54,32 @@ async function runEndpoint({
54
54
  honoContext,
55
55
  }) {
56
56
  if (type.isUndefined(endpointId) || !type.isString(endpointId)) {
57
- throw new ConfigError(
57
+ throw new UserError(
58
58
  `run_endpoint requires an "endpointId" string. Received ${JSON.stringify(endpointId)}.`
59
59
  );
60
60
  }
61
61
 
62
62
  if (!type.isBoolean(saveResponse)) {
63
- throw new ConfigError(
63
+ throw new UserError(
64
64
  `run_endpoint "saveResponse" must be a boolean. Received ${JSON.stringify(saveResponse)}.`
65
65
  );
66
66
  }
67
67
 
68
68
  if (!type.isNone(system) && !type.isBoolean(system)) {
69
- throw new ConfigError(
69
+ throw new UserError(
70
70
  `run_endpoint "system" must be a boolean. Received ${JSON.stringify(system)}.`
71
71
  );
72
72
  }
73
73
 
74
74
  if (system === true && !type.isNone(user)) {
75
- throw new ConfigError(
75
+ throw new UserError(
76
76
  'run_endpoint "system" cannot be combined with "user": a system run has no user (_user is undefined).'
77
77
  );
78
78
  }
79
79
 
80
80
  const caller = await resolveToolCaller({ user, data });
81
81
  if (!type.isUndefined(caller.error)) {
82
- throw new ConfigError(`run_endpoint: ${caller.error}`);
82
+ throw new UserError(`run_endpoint: ${caller.error}`);
83
83
  }
84
84
 
85
85
  const allowed = await isWriteRequestsAllowed();
@@ -141,16 +141,28 @@ async function runEndpointInContext({
141
141
  // as a refusal rather than allowed to escape.
142
142
  try {
143
143
  await getEndpointConfig(context, { endpointId });
144
- } catch {
144
+ } catch (error) {
145
+ // A miss is a ConfigError ("does not exist"), or an AuthenticationError
146
+ // when the app has auth and the tool runs signed out. Anything else is a
147
+ // fault, not a missing endpoint.
148
+ if (error.name !== 'ConfigError' && error.name !== 'AuthenticationError') {
149
+ throw error;
150
+ }
145
151
  return {
146
152
  refused: true,
147
153
  reason:
148
154
  `Endpoint "${endpointId}" was not found. ` +
149
- `See GET /lowdefy-docs/app-map for the endpoints that exist.`,
155
+ `See lowdefy_app_map for the endpoints that exist.`,
150
156
  };
151
157
  }
152
158
 
153
- context.logger.info({ event: 'agent_run_endpoint', endpointId, user, system });
159
+ // The caller's id or data set user name, never the user object an agent passed.
160
+ context.logger.info({
161
+ event: 'agent_run_endpoint',
162
+ endpointId,
163
+ user: type.isObject(user) ? user.id ?? null : user,
164
+ system,
165
+ });
154
166
 
155
167
  try {
156
168
  // callEndpoint refuses InternalApi endpoints and enforces the endpoint's
@@ -175,6 +187,7 @@ async function runEndpointInContext({
175
187
  error: {
176
188
  name: error.name,
177
189
  message: error.message,
190
+ hint: error.hint,
178
191
  source: error.source,
179
192
  configKey: error.configKey,
180
193
  },
@@ -18,52 +18,52 @@ import fs from 'node:fs';
18
18
  import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
- import { jest } from '@jest/globals';
21
+ import { vi, beforeEach, expect, test } from 'vitest';
22
22
 
23
23
  // runEndpoint reads lowdefy.yaml, builds a Lowdefy context and calls into
24
24
  // @lowdefy/api - all of which only exist in a running server directory, so mock
25
25
  // them and leave runEndpoint's own validation, gating and pass-through under
26
26
  // test.
27
- const mockCallEndpoint = jest.fn();
28
- const mockRunDetachedEndpoint = jest.fn();
29
- const mockGetEndpointConfig = jest.fn();
30
- const mockIsWriteRequestsAllowed = jest.fn();
31
- const mockCreateLowdefyContext = jest.fn();
32
- const mockLoggerInfo = jest.fn();
33
-
34
- jest.unstable_mockModule('@lowdefy/api', () => ({
27
+ const mockCallEndpoint = vi.fn();
28
+ const mockRunDetachedEndpoint = vi.fn();
29
+ const mockGetEndpointConfig = vi.fn();
30
+ const mockIsWriteRequestsAllowed = vi.fn();
31
+ const mockCreateLowdefyContext = vi.fn();
32
+ const mockLoggerInfo = vi.fn();
33
+
34
+ vi.doMock('@lowdefy/api', () => ({
35
35
  callEndpoint: mockCallEndpoint,
36
36
  getEndpointConfig: mockGetEndpointConfig,
37
37
  runDetachedEndpoint: mockRunDetachedEndpoint,
38
38
  }));
39
- jest.unstable_mockModule('./isWriteRequestsAllowed.js', () => ({
39
+ vi.doMock('./isWriteRequestsAllowed.js', () => ({
40
40
  default: mockIsWriteRequestsAllowed,
41
41
  }));
42
- jest.unstable_mockModule('../server/createLowdefyContext.js', () => ({
42
+ vi.doMock('../server/createLowdefyContext.js', () => ({
43
43
  default: mockCreateLowdefyContext,
44
44
  }));
45
45
  // A data set caller loads a data set into the dev server's memory store; both
46
46
  // are mocked so the test checks who the routine runs as and on which database.
47
- const mockReadDataSet = jest.fn();
48
- const mockOpenDataSession = jest.fn();
49
- jest.unstable_mockModule('./dataSets/readDataSet.js', () => ({ default: mockReadDataSet }));
50
- jest.unstable_mockModule('./dataSets/getDataStore.js', () => ({ default: async () => ({}) }));
51
- jest.unstable_mockModule('./dataSets/openDataSession.js', () => ({
47
+ const mockReadDataSet = vi.fn();
48
+ const mockOpenDataSession = vi.fn();
49
+ vi.doMock('./dataSets/readDataSet.js', () => ({ default: mockReadDataSet }));
50
+ vi.doMock('./dataSets/getDataStore.js', () => ({ default: async () => ({}) }));
51
+ vi.doMock('./dataSets/openDataSession.js', () => ({
52
52
  default: mockOpenDataSession,
53
53
  }));
54
- jest.unstable_mockModule('./readDevAuthMode.js', () => ({
54
+ vi.doMock('./readDevAuthMode.js', () => ({
55
55
  default: () => ({ authConfigured: true, mockUserActive: false }),
56
56
  }));
57
57
 
58
- const { ConfigError } = await import('@lowdefy/errors');
58
+ const { ConfigError, UserError } = await import('@lowdefy/errors');
59
59
  const { MAX_INLINE_RESPONSE_CHARS } = await import('./fitResponse.js');
60
60
  const { default: runEndpoint } = await import('./runEndpoint.js');
61
61
 
62
- const honoContext = { req: { path: '/lowdefy-docs/run-endpoint' } };
62
+ const honoContext = { req: { path: '/lowdefy-docs/mcp' } };
63
63
  const context = { logger: { info: mockLoggerInfo } };
64
64
 
65
65
  beforeEach(() => {
66
- jest.clearAllMocks();
66
+ vi.clearAllMocks();
67
67
  mockIsWriteRequestsAllowed.mockResolvedValue(true);
68
68
  mockCreateLowdefyContext.mockResolvedValue(context);
69
69
  mockGetEndpointConfig.mockResolvedValue({ id: 'endpoint:create_order', type: 'Api' });
@@ -81,8 +81,8 @@ beforeEach(() => {
81
81
  });
82
82
  });
83
83
 
84
- test('runEndpoint throws a ConfigError when endpointId is missing', async () => {
85
- await expect(runEndpoint({ honoContext })).rejects.toThrow(ConfigError);
84
+ test('runEndpoint throws a UserError when endpointId is missing', async () => {
85
+ await expect(runEndpoint({ honoContext })).rejects.toThrow(UserError);
86
86
  await expect(runEndpoint({ honoContext })).rejects.toThrow(
87
87
  'run_endpoint requires an "endpointId" string. Received undefined.'
88
88
  );
@@ -90,24 +90,24 @@ test('runEndpoint throws a ConfigError when endpointId is missing', async () =>
90
90
  expect(mockCreateLowdefyContext).not.toHaveBeenCalled();
91
91
  });
92
92
 
93
- test('runEndpoint throws a ConfigError when endpointId is not a string', async () => {
93
+ test('runEndpoint throws a UserError when endpointId is not a string', async () => {
94
94
  await expect(runEndpoint({ endpointId: 42, honoContext })).rejects.toThrow(
95
95
  'run_endpoint requires an "endpointId" string. Received 42.'
96
96
  );
97
97
  expect(mockCreateLowdefyContext).not.toHaveBeenCalled();
98
98
  });
99
99
 
100
- test('runEndpoint throws a ConfigError when user is neither an object nor a name', async () => {
100
+ test('runEndpoint throws a UserError when user is neither an object nor a name', async () => {
101
101
  await expect(
102
102
  runEndpoint({ endpointId: 'create_order', user: ['admin'], honoContext })
103
- ).rejects.toThrow(ConfigError);
103
+ ).rejects.toThrow(UserError);
104
104
  await expect(
105
105
  runEndpoint({ endpointId: 'create_order', user: ['admin'], honoContext })
106
106
  ).rejects.toThrow(/run_endpoint: "user" should be a user object/);
107
107
  expect(mockCreateLowdefyContext).not.toHaveBeenCalled();
108
108
  });
109
109
 
110
- test('runEndpoint throws a ConfigError for a data set user name without data', async () => {
110
+ test('runEndpoint throws a UserError for a data set user name without data', async () => {
111
111
  await expect(
112
112
  runEndpoint({ endpointId: 'create_order', user: 'member', honoContext })
113
113
  ).rejects.toThrow(
@@ -120,7 +120,7 @@ test("runEndpoint runs as a data set user, on the data set's own database", asyn
120
120
  const member = { id: 'u_member', roles: ['member'] };
121
121
  const dataSet = { name: 'crm', users: { member } };
122
122
  const session = { id: 'session1', state: 'open' };
123
- const close = jest.fn(async () => {});
123
+ const close = vi.fn(async () => {});
124
124
  mockReadDataSet.mockResolvedValue(dataSet);
125
125
  mockOpenDataSession.mockResolvedValue({ cookie: 'session1', session, close });
126
126
 
@@ -143,7 +143,7 @@ test("runEndpoint runs as a data set user, on the data set's own database", asyn
143
143
  });
144
144
 
145
145
  test('runEndpoint closes the data session when the routine throws', async () => {
146
- const close = jest.fn(async () => {});
146
+ const close = vi.fn(async () => {});
147
147
  mockReadDataSet.mockResolvedValue({ name: 'crm', users: { member: { id: 'u_member' } } });
148
148
  mockOpenDataSession.mockResolvedValue({ cookie: 'session1', session: {}, close });
149
149
  mockCallEndpoint.mockRejectedValue(new Error('boom'));
@@ -227,7 +227,7 @@ test('runEndpoint returns a not-found refusal when the endpoint does not exist',
227
227
  expect(result).toEqual({
228
228
  refused: true,
229
229
  reason:
230
- 'Endpoint "missing_endpoint" was not found. See GET /lowdefy-docs/app-map for the endpoints that exist.',
230
+ 'Endpoint "missing_endpoint" was not found. See lowdefy_app_map for the endpoints that exist.',
231
231
  });
232
232
  expect(mockGetEndpointConfig).toHaveBeenCalledWith(context, { endpointId: 'missing_endpoint' });
233
233
  expect(mockCallEndpoint).not.toHaveBeenCalled();
@@ -264,8 +264,13 @@ test('runEndpoint defaults the payload to an empty object', async () => {
264
264
  expect(mockCallEndpoint).toHaveBeenCalledWith(context, expect.objectContaining({ payload: {} }));
265
265
  });
266
266
 
267
- test('runEndpoint passes the user to createLowdefyContext and logs the run', async () => {
268
- const user = { roles: ['admin'], organization_id: 'org_1' };
267
+ test('runEndpoint passes the user to createLowdefyContext and logs only its id', async () => {
268
+ const user = {
269
+ id: 'user_1',
270
+ email: 'ada@example.com',
271
+ roles: ['admin'],
272
+ organization_id: 'org_1',
273
+ };
269
274
 
270
275
  await runEndpoint({ endpointId: 'create_order', user, honoContext });
271
276
 
@@ -273,7 +278,7 @@ test('runEndpoint passes the user to createLowdefyContext and logs the run', asy
273
278
  expect(mockLoggerInfo).toHaveBeenCalledWith({
274
279
  event: 'agent_run_endpoint',
275
280
  endpointId: 'create_order',
276
- user,
281
+ user: 'user_1',
277
282
  system: false,
278
283
  });
279
284
  });
@@ -353,7 +358,7 @@ test('runEndpoint with system: true returns faults that escape runDetachedEndpoi
353
358
  });
354
359
  });
355
360
 
356
- test('runEndpoint throws a ConfigError when system is combined with user', async () => {
361
+ test('runEndpoint throws a UserError when system is combined with user', async () => {
357
362
  await expect(
358
363
  runEndpoint({
359
364
  endpointId: 'purge_stale',
@@ -361,7 +366,7 @@ test('runEndpoint throws a ConfigError when system is combined with user', async
361
366
  user: { roles: ['admin'] },
362
367
  honoContext,
363
368
  })
364
- ).rejects.toThrow(ConfigError);
369
+ ).rejects.toThrow(UserError);
365
370
  await expect(
366
371
  runEndpoint({
367
372
  endpointId: 'purge_stale',
@@ -374,7 +379,7 @@ test('runEndpoint throws a ConfigError when system is combined with user', async
374
379
  expect(mockCreateLowdefyContext).not.toHaveBeenCalled();
375
380
  });
376
381
 
377
- test('runEndpoint throws a ConfigError when system is not a boolean', async () => {
382
+ test('runEndpoint throws a UserError when system is not a boolean', async () => {
378
383
  await expect(
379
384
  runEndpoint({ endpointId: 'purge_stale', system: 'yes', honoContext })
380
385
  ).rejects.toThrow('run_endpoint "system" must be a boolean. Received "yes".');
@@ -502,8 +507,8 @@ test('runEndpoint writes an oversized response to a file', async () => {
502
507
  }
503
508
  });
504
509
 
505
- test('runEndpoint throws a ConfigError when saveResponse is not a boolean', async () => {
510
+ test('runEndpoint throws a UserError when saveResponse is not a boolean', async () => {
506
511
  await expect(
507
512
  runEndpoint({ endpointId: 'create_order', saveResponse: 'yes', honoContext })
508
- ).rejects.toThrow(ConfigError);
513
+ ).rejects.toThrow(UserError);
509
514
  });
@@ -20,6 +20,7 @@ import {
20
20
  releaseRunBuffer,
21
21
  takeRunErrors,
22
22
  } from './runErrorBuffers.js';
23
+ import { afterEach, expect, test } from 'vitest';
23
24
 
24
25
  const run = '20261003T151200Z-p0d4rm';
25
26
  const journeyRun = { run, journey: 'tests/journeys/a.yaml#A' };
@@ -28,6 +28,7 @@ import createDataSetRails from './rails/createDataSetRails.js';
28
28
  import createJourneyAppErrors from './observe/createJourneyAppErrors.js';
29
29
  import describeDataSetResult from './dataSets/describeDataSetResult.js';
30
30
  import getDataStore from './dataSets/getDataStore.js';
31
+ import JourneyStepError from './JourneyStepError.js';
31
32
  import journeyRunRecording from './journeyRunRecording.js';
32
33
  import { getBrowser, buildPageUrl } from './getBrowser.js';
33
34
  import noBrowserError from './noBrowserError.js';
@@ -37,6 +38,7 @@ import readBuildArtifact from './readBuildArtifact.js';
37
38
  import readDevAuthMode from './readDevAuthMode.js';
38
39
  import readConnectionPlugins from './readConnectionPlugins.js';
39
40
  import readPagePath from './readPagePath.js';
41
+ import reportDevToolFault from './reportDevToolFault.js';
40
42
  import { registerRunBuffer, releaseRunBuffer } from './runErrorBuffers.js';
41
43
  import resolveJourneyDataSet from './dataSets/resolveJourneyDataSet.js';
42
44
  import runJourneySteps from './runJourneySteps.js';
@@ -46,6 +48,12 @@ import validateJourneyMail from './validateJourneyMail.js';
46
48
  import validateJourneyTimeout from './validateJourneyTimeout.js';
47
49
  import validateStateSelection from './validateStateSelection.js';
48
50
  import withBrowserSlot from './withBrowserSlot.js';
51
+ import createLogger from '../server/log/createLogger.js';
52
+
53
+ const logger = createLogger();
54
+
55
+ // Not SyntaxError: JSON.parse of the app's own artifacts or data set input throws one.
56
+ const PROGRAMMING_ERRORS = new Set(['RangeError', 'ReferenceError', 'TypeError']);
49
57
 
50
58
  // The final state is read even after a failure — it is what an agent needs to
51
59
  // write the next assertion. A page that has navigated away or crashed may not
@@ -326,7 +334,19 @@ async function runJourneyInBrowser({
326
334
  }
327
335
  return result;
328
336
  } catch (error) {
329
- return { error: `Failed to run journey at "${url}": ${error.message}` };
337
+ // A failed step, a refused input or a page that would not open is the run's
338
+ // outcome. A programming error is the journey runner's own bug, which an
339
+ // agent would otherwise read as a failure of its app.
340
+ if (error instanceof JourneyStepError || !PROGRAMMING_ERRORS.has(error?.name)) {
341
+ return { error: `Failed to run journey at "${url}": ${error.message}` };
342
+ }
343
+ return {
344
+ error: `Failed to run journey at "${url}": ${reportDevToolFault({
345
+ error,
346
+ logger,
347
+ tool: 'journey',
348
+ })}`,
349
+ };
330
350
  } finally {
331
351
  if (!type.isUndefined(journey)) {
332
352
  if (runRecording.record !== false) {