@wenathlan/devthink 2.0.14 → 2.0.19

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 (444) hide show
  1. package/CHANGELOG.md +60 -0
  2. package/{dist/bridge.d.ts → bridge.d.ts} +1 -1
  3. package/bridge.d.ts.map +1 -0
  4. package/bridge.js +1877 -0
  5. package/bun.d.ts.map +1 -0
  6. package/bun.js +52329 -0
  7. package/caps/background.json +712 -0
  8. package/caps/cli.json +360 -0
  9. package/caps/library.json +3611 -0
  10. package/caps/mcp.json +126 -0
  11. package/caps/pagebridge.json +377 -0
  12. package/caps/popup.json +51 -0
  13. package/caps/sidepanel.json +522 -0
  14. package/checksums.txt +142 -0
  15. package/cli.d.ts.map +1 -0
  16. package/{dist/cli.js → cli.js} +2 -2
  17. package/companion.d.ts.map +1 -0
  18. package/companion.js +389 -0
  19. package/crossbrowser.d.ts.map +1 -0
  20. package/crossbrowser.js +1191 -0
  21. package/dashdone.d.ts.map +1 -0
  22. package/dashdone.js +368 -0
  23. package/deno.d.ts.map +1 -0
  24. package/deno.js +52325 -0
  25. package/devthink.umd.js +52346 -0
  26. package/fixtures/bun.ts +7 -0
  27. package/fixtures/cjs.js +6 -0
  28. package/fixtures/deno.ts +6 -0
  29. package/fixtures/example-org-pagestate.json +22 -0
  30. package/fixtures/importers/automa-workflow.json +18 -0
  31. package/fixtures/importers/selenium-side.json +20 -0
  32. package/fixtures/importers/tabular-plan.csv +7 -0
  33. package/fixtures/importers/uivision-macro.json +10 -0
  34. package/fixtures/importers/v1-plan.json +13 -0
  35. package/fixtures/mcp-client.mjs +14 -0
  36. package/fixtures/pages/checkout.html +192 -0
  37. package/fixtures/pages/dashboard.html +110 -0
  38. package/fixtures/pages/feed.html +113 -0
  39. package/fixtures/pages/product-grid.html +150 -0
  40. package/fixtures/plans/form-inventory-plan.json +11 -0
  41. package/fixtures/plans/release-notes-plan.json +11 -0
  42. package/fixtures/recipes/agentscompete.json +11 -0
  43. package/fixtures/recipes/agentsforms.json +11 -0
  44. package/fixtures/recipes/agentsmonitor.json +11 -0
  45. package/fixtures/recipes/agentsreview.json +29 -0
  46. package/fixtures/recipes/agentswarm.json +11 -0
  47. package/fixtures/recipes/fillcalendar.json +12 -0
  48. package/fixtures/recipes/fillcheckout.json +13 -0
  49. package/fixtures/recipes/filldependentdropdowns.json +12 -0
  50. package/fixtures/recipes/fillfromcsv.json +13 -0
  51. package/fixtures/recipes/fillloginform.json +12 -0
  52. package/fixtures/recipes/fillmultistepwizard.json +13 -0
  53. package/fixtures/recipes/fillregistration.json +12 -0
  54. package/fixtures/recipes/fillsearchfilters.json +12 -0
  55. package/fixtures/recipes/filltypeahead.json +11 -0
  56. package/fixtures/recipes/monitoralerts.json +12 -0
  57. package/fixtures/recipes/monitoravailability.json +11 -0
  58. package/fixtures/recipes/monitornetworkquiet.json +12 -0
  59. package/fixtures/recipes/monitorpagechanges.json +11 -0
  60. package/fixtures/recipes/monitorpricechange.json +11 -0
  61. package/fixtures/recipes/monitorschedule.json +12 -0
  62. package/fixtures/recipes/scrapedynamicprices.json +13 -0
  63. package/fixtures/recipes/scrapeimagegallery.json +12 -0
  64. package/fixtures/recipes/scrapeinfinitefeed.json +13 -0
  65. package/fixtures/recipes/scrapenestedlists.json +12 -0
  66. package/fixtures/recipes/scrapeproductgrid.json +12 -0
  67. package/fixtures/recipes/scrapereviews.json +12 -0
  68. package/fixtures/recipes/scrapesearchresults.json +12 -0
  69. package/fixtures/recipes/scrapetablepagination.json +12 -0
  70. package/fixtures/recipes/testaccessibility.json +34 -0
  71. package/fixtures/recipes/testconsoleerrors.json +12 -0
  72. package/fixtures/recipes/testdeeplinks.json +12 -0
  73. package/fixtures/recipes/testformvalidation.json +13 -0
  74. package/fixtures/recipes/testlayoutshift.json +12 -0
  75. package/fixtures/recipes/testlinkcheck.json +12 -0
  76. package/fixtures/recipes/testloadtiming.json +12 -0
  77. package/fixtures/recipes/testvisualdiff.json +12 -0
  78. package/fixtures/workflows/changelog-digest-workflow.json +13 -0
  79. package/fixtures/workflows/form-survey-workflow.json +13 -0
  80. package/gallery.json +706 -0
  81. package/hardening.d.ts.map +1 -0
  82. package/hardening.js +188 -0
  83. package/headless.d.ts.map +1 -0
  84. package/headless.js +11522 -0
  85. package/http.d.ts.map +1 -0
  86. package/http.js +2165 -0
  87. package/index.cjs +54682 -0
  88. package/index.d.ts.map +1 -0
  89. package/index.js +52310 -0
  90. package/index.neutral.js +46343 -0
  91. package/{web/manifest.json → manifest.json} +1 -1
  92. package/mcp.d.ts.map +1 -0
  93. package/mcp.js +20515 -0
  94. package/memory.d.ts.map +1 -0
  95. package/{memory.ts → memory.js} +2310 -3834
  96. package/nativehost.template.json +10 -0
  97. package/node.cjs +54686 -0
  98. package/node.d.ts.map +1 -0
  99. package/pack.d.ts.map +1 -0
  100. package/pack.js +805 -0
  101. package/package.json +83 -176
  102. package/policy.d.ts.map +1 -0
  103. package/{policy.ts → policy.js} +4679 -5073
  104. package/progress.d.ts.map +1 -0
  105. package/progress.js +645 -0
  106. package/protocol.d.ts.map +1 -0
  107. package/protocol.js +8334 -0
  108. package/schemas/audit.schema.json +226 -0
  109. package/schemas/capability.schema.json +113 -0
  110. package/schemas/envelope.schema.json +162 -0
  111. package/schemas/memory.schema.json +51 -0
  112. package/schemas/observation.schema.json +113 -0
  113. package/schemas/plan.schema.json +208 -0
  114. package/schemas/progress.schema.json +126 -0
  115. package/schemas/proposal.schema.json +68 -0
  116. package/schemas/session.schema.json +82 -0
  117. package/schemas/tool.schema.json +94 -0
  118. package/server.d.ts.map +1 -0
  119. package/server.js +28877 -0
  120. package/umd-example.html +18 -0
  121. package/umd.d.ts.map +1 -0
  122. package/accounts.ts +0 -2087
  123. package/agent.ts +0 -2331
  124. package/antigravity.ts +0 -2139
  125. package/apifreeze.ts +0 -4146
  126. package/auth.ts +0 -642
  127. package/background.ts +0 -16837
  128. package/bridge.ts +0 -2080
  129. package/build.ts +0 -54
  130. package/bun.ts +0 -26
  131. package/capture.ts +0 -1614
  132. package/checksecrets.ts +0 -72
  133. package/cjs.ts +0 -9
  134. package/cli.ts +0 -3500
  135. package/commands.ts +0 -1101
  136. package/companion.ts +0 -450
  137. package/compatibility.ts +0 -37
  138. package/config.ts +0 -3137
  139. package/constants.ts +0 -943
  140. package/core.ts +0 -1473
  141. package/crossbrowser.ts +0 -1359
  142. package/dashdone.ts +0 -605
  143. package/data.ts +0 -943
  144. package/database.ts +0 -133
  145. package/debug.ts +0 -850
  146. package/deno.ts +0 -27
  147. package/devthink.ts +0 -707
  148. package/dist/accounts.d.ts +0 -409
  149. package/dist/agent.d.ts +0 -837
  150. package/dist/antigravity.d.ts +0 -380
  151. package/dist/apifreeze.d.ts +0 -113
  152. package/dist/auth.d.ts +0 -224
  153. package/dist/capture.d.ts +0 -595
  154. package/dist/cjs.d.ts +0 -6
  155. package/dist/commands.d.ts +0 -310
  156. package/dist/compatibility.d.ts +0 -17
  157. package/dist/config.d.ts +0 -1853
  158. package/dist/constants.d.ts +0 -637
  159. package/dist/core.d.ts +0 -361
  160. package/dist/data.d.ts +0 -330
  161. package/dist/database.d.ts +0 -24
  162. package/dist/debug.d.ts +0 -270
  163. package/dist/engine.d.ts +0 -74
  164. package/dist/environments.d.ts +0 -244
  165. package/dist/evidence.d.ts +0 -277
  166. package/dist/export.d.ts +0 -311
  167. package/dist/fingerprint.d.ts +0 -594
  168. package/dist/flow.d.ts +0 -300
  169. package/dist/gates.d.ts +0 -103
  170. package/dist/identity.d.ts +0 -51
  171. package/dist/ids.d.ts +0 -7
  172. package/dist/llm.d.ts +0 -652
  173. package/dist/models.d.ts +0 -1807
  174. package/dist/net.d.ts +0 -325
  175. package/dist/neutral.d.ts +0 -41
  176. package/dist/oauth.d.ts +0 -703
  177. package/dist/page.d.ts +0 -1166
  178. package/dist/perf.d.ts +0 -481
  179. package/dist/plan.d.ts +0 -134
  180. package/dist/project.d.ts +0 -395
  181. package/dist/providers.d.ts +0 -37
  182. package/dist/quota.d.ts +0 -453
  183. package/dist/recovery.d.ts +0 -621
  184. package/dist/request.d.ts +0 -1492
  185. package/dist/run.d.ts +0 -779
  186. package/dist/runtime.d.ts +0 -212
  187. package/dist/search.d.ts +0 -375
  188. package/dist/security.d.ts +0 -534
  189. package/dist/serve.d.ts +0 -136
  190. package/dist/session.d.ts +0 -296
  191. package/dist/storage.d.ts +0 -53
  192. package/dist/streaming.d.ts +0 -1119
  193. package/dist/swarm.d.ts +0 -328
  194. package/dist/tools.d.ts +0 -170
  195. package/dist/types.d.ts +0 -8357
  196. package/dist/utils.d.ts +0 -82
  197. package/dist/version.d.ts +0 -7
  198. package/dist/versionregistry.d.ts +0 -406
  199. package/dist/views.d.ts +0 -579
  200. package/dist/workbenchsession.d.ts +0 -69
  201. package/dist/workflow.d.ts +0 -649
  202. package/docs/readme.md +0 -92
  203. package/docs/schemas/antigravity.json +0 -192
  204. package/engine.ts +0 -1524
  205. package/environments.ts +0 -1005
  206. package/evidence.ts +0 -643
  207. package/export.ts +0 -889
  208. package/fingerprint.ts +0 -1458
  209. package/flow.ts +0 -1190
  210. package/gates.ts +0 -307
  211. package/gateway.ts +0 -34
  212. package/hardening.ts +0 -191
  213. package/headless.ts +0 -369
  214. package/http.ts +0 -2110
  215. package/identity.ts +0 -246
  216. package/ids.ts +0 -26
  217. package/index.ts +0 -369
  218. package/llm.ts +0 -2682
  219. package/mcp.ts +0 -1835
  220. package/models.ts +0 -3805
  221. package/modes.ts +0 -43
  222. package/net.ts +0 -1214
  223. package/neutral.ts +0 -362
  224. package/node.ts +0 -26
  225. package/oauth.ts +0 -2216
  226. package/offscreen.ts +0 -170
  227. package/pack.ts +0 -956
  228. package/page.ts +0 -7824
  229. package/pagebridge.ts +0 -1116
  230. package/perf.ts +0 -957
  231. package/plan.ts +0 -672
  232. package/plugin.ts +0 -76
  233. package/prisma.config.ts +0 -27
  234. package/progress.ts +0 -1308
  235. package/project.ts +0 -1291
  236. package/protocol.ts +0 -4187
  237. package/providers.ts +0 -246
  238. package/quota.ts +0 -1887
  239. package/recovery.ts +0 -2433
  240. package/request.ts +0 -4482
  241. package/run.ts +0 -2135
  242. package/runtime.ts +0 -526
  243. package/search.ts +0 -1760
  244. package/security.ts +0 -1673
  245. package/serve.ts +0 -419
  246. package/server.ts +0 -5538
  247. package/session.ts +0 -1162
  248. package/storage.ts +0 -182
  249. package/streaming.ts +0 -4101
  250. package/swarm.ts +0 -884
  251. package/sync.ts +0 -56
  252. package/tests/agentcert.test.ts +0 -128
  253. package/tests/agentfleet.test.ts +0 -214
  254. package/tests/agentreview.test.ts +0 -241
  255. package/tests/agentstream.test.ts +0 -335
  256. package/tests/agentwork.test.ts +0 -356
  257. package/tests/apifreeze.test.ts +0 -290
  258. package/tests/apimap.test.ts +0 -112
  259. package/tests/approvalgate.test.ts +0 -175
  260. package/tests/artifactmanifest.test.ts +0 -204
  261. package/tests/attentionfeed.test.ts +0 -163
  262. package/tests/backgroundruns.test.ts +0 -100
  263. package/tests/batchscheduling.test.ts +0 -131
  264. package/tests/blackboard.test.ts +0 -238
  265. package/tests/bridge.test.ts +0 -1088
  266. package/tests/browsercoverage.test.ts +0 -134
  267. package/tests/browserpolyfills.test.ts +0 -124
  268. package/tests/build.mjs +0 -1260
  269. package/tests/clientauth.test.ts +0 -223
  270. package/tests/clitools.test.ts +0 -578
  271. package/tests/confirmgates.test.ts +0 -190
  272. package/tests/containerpack.test.ts +0 -143
  273. package/tests/controlflow.test.ts +0 -2120
  274. package/tests/coordination.test.ts +0 -345
  275. package/tests/copyscreen.test.ts +0 -139
  276. package/tests/core.test.ts +0 -417
  277. package/tests/costcert.test.ts +0 -95
  278. package/tests/crossbrowser.test.ts +0 -115
  279. package/tests/cspaudit.test.ts +0 -79
  280. package/tests/dashdone.test.ts +0 -615
  281. package/tests/datagrid.test.ts +0 -137
  282. package/tests/doccheck.test.ts +0 -107
  283. package/tests/dombatch.test.ts +0 -109
  284. package/tests/emulation.test.ts +0 -282
  285. package/tests/environments.test.ts +0 -259
  286. package/tests/evidenceviews.test.ts +0 -88
  287. package/tests/exporttools.test.ts +0 -185
  288. package/tests/firefoxprep.test.ts +0 -134
  289. package/tests/flowlibrary.test.ts +0 -242
  290. package/tests/flowrun.test.ts +0 -303
  291. package/tests/forensics.test.ts +0 -439
  292. package/tests/gateway.test.ts +0 -939
  293. package/tests/headlesslib.test.ts +0 -171
  294. package/tests/httpstream.test.ts +0 -277
  295. package/tests/immutablelog.test.ts +0 -157
  296. package/tests/inboundguard.test.ts +0 -177
  297. package/tests/lazyload.test.ts +0 -72
  298. package/tests/librarymodes.test.ts +0 -623
  299. package/tests/llm.test.ts +0 -696
  300. package/tests/manifest.test.ts +0 -226
  301. package/tests/maskinputs.test.ts +0 -150
  302. package/tests/matrixverify.test.ts +0 -111
  303. package/tests/mavenpack.test.ts +0 -75
  304. package/tests/mcpserver.test.ts +0 -704
  305. package/tests/memory.test.ts +0 -4155
  306. package/tests/memorycare.test.ts +0 -230
  307. package/tests/migrateplan.test.ts +0 -349
  308. package/tests/minimization.test.ts +0 -414
  309. package/tests/modelroute.test.ts +0 -112
  310. package/tests/multiagent.test.ts +0 -440
  311. package/tests/nativebridge.test.ts +0 -807
  312. package/tests/navigation.test.ts +0 -284
  313. package/tests/nugetpack.test.ts +0 -83
  314. package/tests/orchestration.test.ts +0 -449
  315. package/tests/originpolicy.test.ts +0 -405
  316. package/tests/outputcompare.test.ts +0 -97
  317. package/tests/package.test.ts +0 -91
  318. package/tests/pagebridge.test.ts +0 -5909
  319. package/tests/pentest.test.ts +0 -75
  320. package/tests/perfrecords.test.ts +0 -257
  321. package/tests/permdiff.test.ts +0 -85
  322. package/tests/phishguard.test.ts +0 -128
  323. package/tests/pickerviews.test.ts +0 -155
  324. package/tests/pipelines.test.ts +0 -381
  325. package/tests/planlint.test.ts +0 -240
  326. package/tests/planreview.test.ts +0 -383
  327. package/tests/platformtargets.test.ts +0 -56
  328. package/tests/policy.test.ts +0 -8284
  329. package/tests/portability.test.ts +0 -96
  330. package/tests/progress.test.ts +0 -1036
  331. package/tests/promptlibrary.test.ts +0 -116
  332. package/tests/protocol.test.ts +0 -4793
  333. package/tests/publishingpipeline.test.ts +0 -314
  334. package/tests/quickactions.test.ts +0 -164
  335. package/tests/readiness.test.ts +0 -78
  336. package/tests/recipes.test.ts +0 -163
  337. package/tests/redactshots.test.ts +0 -216
  338. package/tests/registernvidiakeys.ts +0 -51
  339. package/tests/relayserve.test.ts +0 -304
  340. package/tests/releasenotes.test.ts +0 -276
  341. package/tests/resilience.test.ts +0 -467
  342. package/tests/resourceaware.test.ts +0 -187
  343. package/tests/runbudget.test.ts +0 -125
  344. package/tests/runhistory.test.ts +0 -299
  345. package/tests/runreplay.test.ts +0 -113
  346. package/tests/runresume.test.ts +0 -184
  347. package/tests/runstate.test.ts +0 -288
  348. package/tests/runtimeadapters.test.ts +0 -251
  349. package/tests/safariskeleton.test.ts +0 -115
  350. package/tests/sandboxframe.test.ts +0 -196
  351. package/tests/sbom.test.ts +0 -105
  352. package/tests/secretvault.test.ts +0 -188
  353. package/tests/selcache.test.ts +0 -111
  354. package/tests/sessioninterface.test.ts +0 -791
  355. package/tests/sessions.test.ts +0 -591
  356. package/tests/siteprefs.test.ts +0 -228
  357. package/tests/snapshotdelta.test.ts +0 -165
  358. package/tests/statusviews.test.ts +0 -237
  359. package/tests/stepmeter.test.ts +0 -200
  360. package/tests/streamparse.test.ts +0 -163
  361. package/tests/stylepruning.test.ts +0 -90
  362. package/tests/surfaces.test.ts +0 -282
  363. package/tests/sweep.test.ts +0 -78
  364. package/tests/syncbridge.test.ts +0 -164
  365. package/tests/taskqueue.test.ts +0 -206
  366. package/tests/toolcalls.test.ts +0 -336
  367. package/tests/toolcatalog.test.ts +0 -201
  368. package/tests/torture-agent.test.ts +0 -706
  369. package/tests/torture-auth.test.ts +0 -461
  370. package/tests/torture-commands.test.ts +0 -895
  371. package/tests/torture-data.test.ts +0 -923
  372. package/tests/torture-environments.test.ts +0 -285
  373. package/tests/torture-export.test.ts +0 -263
  374. package/tests/torture-http.test.ts +0 -1379
  375. package/tests/torture-llm.test.ts +0 -808
  376. package/tests/torture-memory.test.ts +0 -1084
  377. package/tests/torture-plan.test.ts +0 -829
  378. package/tests/torture-run.test.ts +0 -626
  379. package/tests/torture-session.test.ts +0 -928
  380. package/tests/torture-swarm.test.ts +0 -1245
  381. package/tests/torture-tools.test.ts +0 -964
  382. package/tests/torture-workflow.test.ts +0 -2354
  383. package/tests/tourviews.test.ts +0 -52
  384. package/tests/transparency.test.ts +0 -147
  385. package/tests/trigger.test.ts +0 -941
  386. package/tests/v1sunset.test.ts +0 -428
  387. package/tests/virtlist.test.ts +0 -94
  388. package/tests/vision.test.ts +0 -540
  389. package/tests/vsixpack.test.ts +0 -145
  390. package/tests/webapi.test.ts +0 -523
  391. package/tests/workflow.test.ts +0 -1785
  392. package/tests/workfloweditor.test.ts +0 -759
  393. package/tests/xpipack.test.ts +0 -128
  394. package/tools.ts +0 -734
  395. package/types.ts +0 -9908
  396. package/umd.ts +0 -9
  397. package/utils.ts +0 -249
  398. package/version.ts +0 -8
  399. package/versionregistry.ts +0 -1310
  400. package/views.ts +0 -2153
  401. package/vitest.config.ts +0 -12
  402. package/web/App.tsx +0 -78
  403. package/web/README.md +0 -47
  404. package/web/capacitor.config.ts +0 -46
  405. package/web/const.ts +0 -19
  406. package/web/control.shell.tsx +0 -66
  407. package/web/dashboardpage.ts +0 -554
  408. package/web/db.ts +0 -493
  409. package/web/design.html +0 -541
  410. package/web/gatewayview/Gateway.tsx +0 -345
  411. package/web/gatewayview/config.ts +0 -1042
  412. package/web/gatewayview/definition.ts +0 -174
  413. package/web/icons.ts +0 -15
  414. package/web/optionspage.ts +0 -691
  415. package/web/popup.ts +0 -1651
  416. package/web/schema.prisma +0 -176
  417. package/web/sidepanel.ts +0 -7941
  418. package/web/sitemanifest.json +0 -13
  419. package/web/terminal-ui.tsx +0 -622
  420. package/web/transparencypage.ts +0 -541
  421. package/web/vite.config.ts +0 -39
  422. package/web/workspace.ts +0 -23
  423. package/workbenchmemory.ts +0 -104
  424. package/workbenchsession.ts +0 -304
  425. package/workflow.ts +0 -4495
  426. /package/{dist/bun.d.ts → bun.d.ts} +0 -0
  427. /package/{dist/cli.d.ts → cli.d.ts} +0 -0
  428. /package/{dist/companion.d.ts → companion.d.ts} +0 -0
  429. /package/{dist/crossbrowser.d.ts → crossbrowser.d.ts} +0 -0
  430. /package/{dist/dashdone.d.ts → dashdone.d.ts} +0 -0
  431. /package/{dist/deno.d.ts → deno.d.ts} +0 -0
  432. /package/{dist/hardening.d.ts → hardening.d.ts} +0 -0
  433. /package/{dist/headless.d.ts → headless.d.ts} +0 -0
  434. /package/{dist/http.d.ts → http.d.ts} +0 -0
  435. /package/{dist/index.d.ts → index.d.ts} +0 -0
  436. /package/{dist/mcp.d.ts → mcp.d.ts} +0 -0
  437. /package/{dist/memory.d.ts → memory.d.ts} +0 -0
  438. /package/{dist/node.d.ts → node.d.ts} +0 -0
  439. /package/{dist/pack.d.ts → pack.d.ts} +0 -0
  440. /package/{dist/policy.d.ts → policy.d.ts} +0 -0
  441. /package/{dist/progress.d.ts → progress.d.ts} +0 -0
  442. /package/{dist/protocol.d.ts → protocol.d.ts} +0 -0
  443. /package/{dist/server.d.ts → server.d.ts} +0 -0
  444. /package/{dist/umd.d.ts → umd.d.ts} +0 -0
package/tests/llm.test.ts DELETED
@@ -1,696 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
- import {
3
- addusage,
4
- budgetcheck,
5
- buildrequest,
6
- calllocal,
7
- callmodel,
8
- classifyintent,
9
- draftplan,
10
- guardoutput,
11
- islocalorigin,
12
- parsecommand,
13
- parsecompletion,
14
- parseoutput,
15
- parsestream,
16
- reflectionsummary,
17
- reflectstep,
18
- replannonfail,
19
- streammodel,
20
- stripguardrails,
21
- toolbriefof,
22
- rendertoolbriefs,
23
- usagetotals,
24
- } from "../llm.js";
25
- import { buildtoolcatalog } from "../tools.js";
26
- import type { modelmessage, parseguard, plandraft, providerconfig, usagerecord } from "../types.js";
27
- import type { fetchtransport, transportresponse } from "../http.js";
28
-
29
- const now = 1_800_000_000_000;
30
- const instant = (): Promise<void> => Promise.resolve();
31
-
32
- /** Builds one provider config fixture with every value user configured. */
33
- function provider(over: Partial<providerconfig> = {}): providerconfig {
34
- return {
35
- id: "prov1",
36
- name: "The gateway",
37
- endpoint: "https://gateway.example/v1",
38
- style: "chatcompletions",
39
- models: ["model-a", "model-b"],
40
- status: "available",
41
- createdat: now,
42
- ...over,
43
- };
44
- }
45
-
46
- /** Builds one stub transport that answers every request with the canned body. */
47
- function stub(body: string, status = 200, seen: string[] = []): fetchtransport {
48
- return async (url, init): Promise<transportresponse> => {
49
- seen.push(`${init.method} ${url} ${init.body ?? ""}`);
50
- return { status, headers: { "content-type": "application/json" }, body };
51
- };
52
- }
53
-
54
- /** Wraps one model answer payload in the chat completions envelope the style parse expects. */
55
- function answer(payload: string): string {
56
- return JSON.stringify({ choices: [{ message: { role: "assistant", content: payload } }] });
57
- }
58
-
59
- /** The chat completions answer body fixture. */
60
- const chatbody = JSON.stringify({
61
- choices: [{ message: { role: "assistant", content: "the answer" } }],
62
- usage: { prompt_tokens: 10, completion_tokens: 5, total_tokens: 15 },
63
- });
64
-
65
- describe("llm request shaping", () => {
66
- it("shapes the chat completions request with the bearer header and the message envelope", () => {
67
- const shaped = buildrequest({
68
- provider: provider(),
69
- model: "model-a",
70
- messages: [
71
- { role: "system", content: "be brief" },
72
- { role: "user", content: "hello" },
73
- ],
74
- apikey: "secret",
75
- temperature: 0.2,
76
- maxtokens: 128,
77
- });
78
- expect(shaped.url).toBe("https://gateway.example/v1");
79
- expect(shaped.method).toBe("POST");
80
- expect(shaped.headers.authorization).toBe("Bearer secret");
81
- const body = JSON.parse(shaped.body) as Record<string, unknown>;
82
- expect(body.model).toBe("model-a");
83
- expect(body.temperature).toBe(0.2);
84
- expect(body.max_tokens).toBe(128);
85
- expect(body.messages).toEqual([
86
- { role: "system", content: "be brief" },
87
- { role: "user", content: "hello" },
88
- ]);
89
- });
90
-
91
- it("shapes the responses request with the instructions block and the turns", () => {
92
- const shaped = buildrequest({
93
- provider: provider({ style: "responses" }),
94
- model: "model-a",
95
- messages: [
96
- { role: "system", content: "be brief" },
97
- { role: "user", content: "hello" },
98
- { role: "assistant", content: "hi" },
99
- ],
100
- apikey: "secret",
101
- maxtokens: 64,
102
- });
103
- const body = JSON.parse(shaped.body) as Record<string, unknown>;
104
- expect(body.instructions).toBe("be brief");
105
- expect(body.max_output_tokens).toBe(64);
106
- expect(body.input).toEqual([
107
- { role: "user", content: "hello" },
108
- { role: "assistant", content: "hi" },
109
- ]);
110
- expect(shaped.headers.authorization).toBe("Bearer secret");
111
- });
112
-
113
- it("shapes the messages request with the api key header and the system block", () => {
114
- const shaped = buildrequest({
115
- provider: provider({ style: "messages" }),
116
- model: "model-a",
117
- messages: [
118
- { role: "system", content: "be brief" },
119
- { role: "user", content: "hello" },
120
- ],
121
- apikey: "secret",
122
- temperature: 1,
123
- });
124
- expect(shaped.headers["x-api-key"]).toBe("secret");
125
- const body = JSON.parse(shaped.body) as Record<string, unknown>;
126
- expect(body.system).toBe("be brief");
127
- expect(body.messages).toEqual([{ role: "user", content: "hello" }]);
128
- expect(body.temperature).toBe(1);
129
- });
130
-
131
- it("shapes the gemini request with the key in the url and the contents envelope", () => {
132
- const shaped = buildrequest({
133
- provider: provider({ endpoint: "https://gateway.example/v1/models/x:generateContent", style: "gemini" }),
134
- model: "model-a",
135
- messages: [
136
- { role: "system", content: "be brief" },
137
- { role: "user", content: "hello" },
138
- ],
139
- apikey: "secret",
140
- maxtokens: 32,
141
- });
142
- expect(shaped.url).toBe("https://gateway.example/v1/models/x:generateContent?key=secret");
143
- const body = JSON.parse(shaped.body) as Record<string, unknown>;
144
- expect(body.systemInstruction).toEqual({ parts: [{ text: "be brief" }] });
145
- expect(body.contents).toEqual([{ role: "user", parts: [{ text: "hello" }] }]);
146
- expect((body.generationConfig as Record<string, unknown>).maxOutputTokens).toBe(32);
147
- });
148
-
149
- it("merges the user configured headers over the protocol shape headers", () => {
150
- const shaped = buildrequest({
151
- provider: provider({ headers: { "x-gateway": "one", authorization: "Bearer user" } }),
152
- model: "model-a",
153
- messages: [{ role: "user", content: "hi" }],
154
- apikey: "secret",
155
- });
156
- expect(shaped.headers["x-gateway"]).toBe("one");
157
- expect(shaped.headers.authorization).toBe("Bearer user");
158
- });
159
- });
160
-
161
- describe("llm response parsing", () => {
162
- it("parses the chat completions answer with its usage", () => {
163
- const parsed = parsecompletion("chatcompletions", chatbody);
164
- expect(parsed.text).toBe("the answer");
165
- expect(parsed.usage).toEqual({ prompttokens: 10, completiontokens: 5, totaltokens: 15 });
166
- });
167
-
168
- it("parses the responses answer text and usage", () => {
169
- const body = JSON.stringify({
170
- output: [
171
- {
172
- content: [
173
- { type: "output_text", text: "part one " },
174
- { type: "output_text", text: "part two" },
175
- ],
176
- },
177
- ],
178
- usage: { input_tokens: 7, output_tokens: 3, total_tokens: 10 },
179
- });
180
- const parsed = parsecompletion("responses", body);
181
- expect(parsed.text).toBe("part one part two");
182
- expect(parsed.usage?.totaltokens).toBe(10);
183
- });
184
-
185
- it("parses the messages answer text blocks with the token counts", () => {
186
- const body = JSON.stringify({
187
- content: [
188
- { type: "text", text: "hello " },
189
- { type: "text", text: "there" },
190
- ],
191
- usage: { input_tokens: 4, output_tokens: 2 },
192
- });
193
- const parsed = parsecompletion("messages", body);
194
- expect(parsed.text).toBe("hello there");
195
- expect(parsed.usage).toEqual({ prompttokens: 4, completiontokens: 2, totaltokens: 6 });
196
- });
197
-
198
- it("parses the gemini answer candidate with its usage metadata", () => {
199
- const body = JSON.stringify({
200
- candidates: [{ content: { parts: [{ text: "gem answer" }] } }],
201
- usageMetadata: { promptTokenCount: 9, candidatesTokenCount: 2, totalTokenCount: 11 },
202
- });
203
- const parsed = parsecompletion("gemini", body);
204
- expect(parsed.text).toBe("gem answer");
205
- expect(parsed.usage?.totaltokens).toBe(11);
206
- });
207
-
208
- it("refuses malformed answers with the reason in plain language", () => {
209
- expect(parsecompletion("chatcompletions", "not json").reason).toMatch(/not json/i);
210
- expect(parsecompletion("chatcompletions", JSON.stringify({ choices: [] })).reason).toMatch(/no message content/i);
211
- expect(parsecompletion("responses", JSON.stringify({ output: [] })).reason).toMatch(/no output text/i);
212
- expect(parsecompletion("messages", JSON.stringify({ content: [] })).reason).toMatch(/no text block/i);
213
- expect(parsecompletion("gemini", JSON.stringify({ candidates: [] })).reason).toMatch(/no candidate text/i);
214
- });
215
- });
216
-
217
- describe("llm provider calls", () => {
218
- it("posts one completion through the fetch machinery and returns the parsed text and usage", async () => {
219
- const seen: string[] = [];
220
- const outcome = await callmodel({
221
- provider: provider(),
222
- model: "model-a",
223
- messages: [{ role: "user", content: "hello" }],
224
- apikey: "secret",
225
- transport: stub(chatbody, 200, seen),
226
- sleep: instant,
227
- now: () => now,
228
- });
229
- expect(outcome.text).toBe("the answer");
230
- expect(outcome.usage?.totaltokens).toBe(15);
231
- expect(seen[0]).toContain("POST https://gateway.example/v1");
232
- expect(JSON.parse((seen[0] ?? "").split(" ").slice(2).join(" ") || "{}")).toMatchObject({ model: "model-a" });
233
- });
234
-
235
- it("refuses the call when the configured auth reference has no resolved key", async () => {
236
- const authref = {
237
- name: "gateway key",
238
- origins: ["https://gateway.example"],
239
- header: "authorization",
240
- storageid: "key-store-1",
241
- configuredat: now,
242
- };
243
- await expect(
244
- callmodel({
245
- provider: provider({ authref }),
246
- model: "model-a",
247
- messages: [{ role: "user", content: "hi" }],
248
- transport: stub(chatbody),
249
- sleep: instant,
250
- now: () => now,
251
- }),
252
- ).rejects.toThrow(/resolved key/i);
253
- });
254
-
255
- it("refuses the call when page content the user has not granted would leave", async () => {
256
- await expect(
257
- callmodel({
258
- provider: provider(),
259
- model: "model-a",
260
- messages: [{ role: "user", content: "summarize" }],
261
- pagecontent: "the page text",
262
- pagegrant: false,
263
- transport: stub(chatbody),
264
- sleep: instant,
265
- now: () => now,
266
- }),
267
- ).rejects.toThrow(/has not granted/i);
268
- const granted = await callmodel({
269
- provider: provider(),
270
- model: "model-a",
271
- messages: [{ role: "user", content: "summarize" }],
272
- pagecontent: "the page text",
273
- pagegrant: true,
274
- transport: stub(chatbody),
275
- sleep: instant,
276
- now: () => now,
277
- });
278
- expect(granted.text).toBe("the answer");
279
- });
280
-
281
- it("refuses the call when the provider carries no user configured endpoint", async () => {
282
- await expect(
283
- callmodel({
284
- provider: provider({ endpoint: " " }),
285
- model: "model-a",
286
- messages: [{ role: "user", content: "hi" }],
287
- transport: stub(chatbody),
288
- sleep: instant,
289
- now: () => now,
290
- }),
291
- ).rejects.toThrow(/endpoint/i);
292
- });
293
-
294
- it("refuses the call when the answer stays malformed after the retries", async () => {
295
- await expect(
296
- callmodel({
297
- provider: provider(),
298
- model: "model-a",
299
- messages: [{ role: "user", content: "hi" }],
300
- apikey: "k",
301
- transport: stub("<html>bad gateway</html>"),
302
- sleep: instant,
303
- options: { retries: 1, backoff: 0 },
304
- now: () => now,
305
- }),
306
- ).rejects.toThrow(/not json/i);
307
- });
308
- });
309
-
310
- describe("llm local model calls", () => {
311
- it("posts to the local model endpoint with no external network", async () => {
312
- const seen: string[] = [];
313
- const outcome = await calllocal({
314
- local: { endpoint: "http://127.0.0.1:8080/v1", model: "local-model", style: "chatcompletions" },
315
- messages: [{ role: "user", content: "hi" }],
316
- transport: stub(chatbody, 200, seen),
317
- sleep: instant,
318
- now: () => now,
319
- });
320
- expect(outcome.text).toBe("the answer");
321
- expect(seen[0]).toContain("http://127.0.0.1:8080/v1");
322
- });
323
-
324
- it("refuses a local model endpoint outside the machine", async () => {
325
- await expect(
326
- calllocal({
327
- local: { endpoint: "https://remote.example/v1", model: "m", style: "chatcompletions" },
328
- messages: [{ role: "user", content: "hi" }],
329
- transport: stub(chatbody),
330
- sleep: instant,
331
- now: () => now,
332
- }),
333
- ).rejects.toThrow(/never leaves the machine/i);
334
- expect(islocalorigin("http://localhost:1234/x")).toBe(true);
335
- expect(islocalorigin("https://gateway.example/v1")).toBe(false);
336
- });
337
- });
338
-
339
- describe("llm streaming", () => {
340
- it("parses the ordered token stream of every protocol style", () => {
341
- const chat = parsestream(
342
- "chatcompletions",
343
- 'data: {"choices":[{"delta":{"content":"he"}}]}\n\ndata: {"choices":[{"delta":{"content":"llo"}}]}\n\ndata: [DONE]',
344
- );
345
- expect(chat.map((token) => token.text).join("")).toBe("hello");
346
- expect(chat[1]?.done).toBe(true);
347
- const messages = parsestream(
348
- "messages",
349
- 'data: {"type":"content_block_delta","delta":{"type":"text_delta","text":"a"}}\ndata: {"type":"content_block_delta","delta":{"type":"text_delta","text":"b"}}',
350
- );
351
- expect(messages.map((token) => token.text).join("")).toBe("ab");
352
- const responses = parsestream(
353
- "responses",
354
- 'data: {"type":"response.output_text.delta","delta":"x"}\ndata: {"type":"response.completed"}',
355
- );
356
- expect(responses.map((token) => token.text).join("")).toBe("x");
357
- const gemini = parsestream("gemini", 'data: {"candidates":[{"content":{"parts":[{"text":"g"}]}}]}');
358
- expect(gemini.map((token) => token.text).join("")).toBe("g");
359
- });
360
-
361
- it("streams one completion when the provider supports it and assembles the answer", async () => {
362
- const body =
363
- 'data: {"choices":[{"delta":{"content":"to"}}]}\ndata: {"choices":[{"delta":{"content":"ken"}}]}\ndata: [DONE]';
364
- const outcome = await streammodel({
365
- provider: provider(),
366
- model: "model-a",
367
- messages: [{ role: "user", content: "hi" }],
368
- apikey: "k",
369
- transport: stub(body),
370
- sleep: instant,
371
- now: () => now,
372
- });
373
- expect(outcome.text).toBe("token");
374
- expect(outcome.tokens).toBe(2);
375
- });
376
- });
377
-
378
- describe("llm command parsing and intents", () => {
379
- const parsebody = JSON.stringify({
380
- intent: "navigate",
381
- entities: [{ name: "url", value: "https://example.com" }],
382
- confidence: 0.9,
383
- });
384
-
385
- it("parses a natural language command across the intent kinds", async () => {
386
- for (const intent of ["navigate", "extract", "fill", "monitor", "automate", "ask"] as const) {
387
- const body = answer(JSON.stringify({ intent, entities: [], confidence: 0.8 }));
388
- const outcome = await parsecommand({
389
- provider: provider(),
390
- model: "model-a",
391
- text: "do the thing",
392
- transport: stub(body),
393
- sleep: instant,
394
- now: () => now,
395
- });
396
- expect(outcome.parse?.intent).toBe(intent);
397
- expect(outcome.parse?.confidence).toBe(0.8);
398
- expect(outcome.parse?.model).toBe("model-a");
399
- }
400
- });
401
-
402
- it("carries the extracted entities of the parsed command", async () => {
403
- const outcome = await parsecommand({
404
- provider: provider(),
405
- model: "model-a",
406
- text: "open the url",
407
- transport: stub(answer(parsebody)),
408
- sleep: instant,
409
- now: () => now,
410
- });
411
- expect(outcome.parse?.entities).toEqual([{ name: "url", value: "https://example.com" }]);
412
- expect(outcome.parse?.providerid).toBe("prov1");
413
- });
414
-
415
- it("refuses a model answer whose intent stays outside the intent kinds", async () => {
416
- const outcome = await parsecommand({
417
- provider: provider(),
418
- model: "model-a",
419
- text: "do the thing",
420
- transport: stub(answer(JSON.stringify({ intent: "vibes", entities: [], confidence: 1 }))),
421
- sleep: instant,
422
- now: () => now,
423
- });
424
- expect(outcome.parse).toBeUndefined();
425
- expect(outcome.reason).toMatch(/intent kinds/i);
426
- });
427
-
428
- it("classifies the intent deterministically with confidence thresholds and no provider", () => {
429
- const navigate = classifyintent("go to the site and open the page");
430
- expect(navigate.intent).toBe("navigate");
431
- expect(navigate.confidence).toBeGreaterThan(0.3);
432
- const extract = classifyintent("extract the table data and read the text");
433
- expect(extract.intent).toBe("extract");
434
- const ask = classifyintent("what is this page about");
435
- expect(ask.intent).toBe("ask");
436
- const unknown = classifyintent("zzz qqq vvv");
437
- expect(unknown.intent).toBe("ask");
438
- expect(unknown.confidence).toBeLessThanOrEqual(0.2);
439
- });
440
- });
441
-
442
- describe("llm plan drafting and replanning", () => {
443
- const draftbody = JSON.stringify({
444
- goal: "Read the docs page",
445
- steps: [
446
- { kind: "navigate", value: "https://docs.example", summary: "Open the docs page." },
447
- { kind: "readtext", target: "main", summary: "Read the main text." },
448
- ],
449
- openquestions: ["which section first?"],
450
- });
451
-
452
- it("drafts a plan from a goal and lints it against the action grammar", async () => {
453
- const outcome = await draftplan({
454
- provider: provider(),
455
- model: "model-a",
456
- goal: "Read the docs page",
457
- origin: "https://docs.example",
458
- transport: stub(answer(draftbody)),
459
- sleep: instant,
460
- now: () => now,
461
- });
462
- expect(outcome.draft?.steps).toHaveLength(2);
463
- expect(outcome.draft?.openquestions).toEqual(["which section first?"]);
464
- expect(outcome.draft?.lintfindings).toEqual([]);
465
- expect(outcome.draft?.state).toBe("draft");
466
- });
467
-
468
- it("records the grammar violations of a model draft before review", async () => {
469
- const body = JSON.stringify({
470
- goal: "Do things",
471
- steps: [
472
- { kind: "teleport", summary: "Teleport." },
473
- { kind: "click", summary: "Click nothing." },
474
- ],
475
- openquestions: [],
476
- });
477
- const outcome = await draftplan({
478
- provider: provider(),
479
- model: "model-a",
480
- goal: "Do things",
481
- transport: stub(answer(body)),
482
- sleep: instant,
483
- now: () => now,
484
- });
485
- expect(outcome.draft?.lintfindings.length).toBeGreaterThan(0);
486
- expect(outcome.draft?.lintfindings.join(" ")).toMatch(/grammar/);
487
- });
488
-
489
- it("replans the failed tail while the completed steps stay and the revised steps need fresh review", async () => {
490
- const draft = outcomeof(draftbody);
491
- const tailbody = JSON.stringify({ steps: [{ kind: "reload", summary: "Reload and retry." }] });
492
- const outcome = await replannonfail({
493
- provider: provider(),
494
- model: "model-a",
495
- draft,
496
- completedstepids: ["step1"],
497
- failedstepids: ["step2"],
498
- reason: "The text read timed out.",
499
- transport: stub(answer(tailbody)),
500
- sleep: instant,
501
- now: () => now,
502
- });
503
- expect(outcome.replan?.completedstepids).toEqual(["step1"]);
504
- expect(outcome.replan?.failedstepids).toEqual(["step2"]);
505
- expect(outcome.replan?.tail).toHaveLength(1);
506
- expect(outcome.replan?.tail[0]?.freshreview).toBe(true);
507
- expect(outcome.replan?.state).toBe("pending");
508
- expect(outcome.replan?.reason).toMatch(/timed out/i);
509
- });
510
-
511
- it("reflects one executed step with the running lessons feeding the next prompt", async () => {
512
- const body = JSON.stringify({
513
- outcome: "The click landed.",
514
- lesson: "The button needs a settle window.",
515
- advice: "Wait one second before the next click.",
516
- });
517
- const outcome = await reflectstep({
518
- provider: provider(),
519
- model: "model-a",
520
- runid: "run1",
521
- stepid: "step2",
522
- outcome: "The click landed.",
523
- lessons: ["The page loads slowly."],
524
- transport: stub(answer(body)),
525
- sleep: instant,
526
- now: () => now,
527
- });
528
- expect(outcome.note?.lesson).toBe("The button needs a settle window.");
529
- expect(outcome.note?.advice).toMatch(/one second/);
530
- const summary = reflectionsummary([outcome.note!]);
531
- expect(summary).toContain("settle window");
532
- });
533
- });
534
-
535
- describe("llm guardrails", () => {
536
- const guard: parseguard = {
537
- schema: { intent: { type: "string", required: true }, confidence: { type: "number" } },
538
- retries: 2,
539
- };
540
-
541
- it("strips code fences and chatter before parsing", () => {
542
- expect(stripguardrails('Sure! Here you go:\n```json\n{"intent":"navigate"}\n```\nHope that helps.')).toBe(
543
- '{"intent":"navigate"}',
544
- );
545
- expect(stripguardrails('pre chatter {"a":1} post chatter')).toBe('{"a":1}');
546
- });
547
-
548
- it("validates model text against the expected schema", () => {
549
- const valid = parseoutput({ guard, text: '{"intent":"navigate","confidence":0.9}' });
550
- expect(valid.verdict).toBe("valid");
551
- expect(valid.parsed?.intent).toBe("navigate");
552
- const wrongtype = parseoutput({ guard, text: '{"intent":5}' });
553
- expect(wrongtype.verdict).toBe("invalid");
554
- expect(wrongtype.reason).toMatch(/asks a string/i);
555
- });
556
-
557
- it("retries malformed output up to the configured attempts", () => {
558
- const outcome = guardoutput({
559
- guard,
560
- attempts: ["nope", '{"intent":"fill"}', '{"intent":"fill","confidence":0.5}'],
561
- });
562
- expect(outcome.verdict).toBe("valid");
563
- expect(outcome.attempts).toBe(2);
564
- });
565
-
566
- it("refuses the output after the retry exhaustion so nothing executes", () => {
567
- const outcome = guardoutput({ guard, attempts: ["nope", "still nope", '{"intent":9}'] });
568
- expect(outcome.verdict).toBe("invalid");
569
- expect(outcome.attempts).toBe(3);
570
- expect(outcome.reason).toMatch(/refuses the output/i);
571
- });
572
-
573
- it("refuses on the refusal markers without burning retries", () => {
574
- const outcome = guardoutput({ guard, attempts: ["I cannot comply with that request.", '{"intent":"fill"}'] });
575
- expect(outcome.verdict).toBe("refused");
576
- expect(outcome.attempts).toBe(1);
577
- expect(outcome.reason).toMatch(/refusal marker/i);
578
- });
579
-
580
- it("honors the user configured refusal markers over the defaults", () => {
581
- const outcome = parseoutput({
582
- guard: { ...guard, refusalmarkers: ["nope-city"] },
583
- text: '{"intent":"navigate","confidence":0.9}',
584
- });
585
- expect(outcome.verdict).toBe("valid");
586
- const custom = parseoutput({
587
- guard: { ...guard, refusalmarkers: ["nope-city"] },
588
- text: "nope-city, the model stays out",
589
- });
590
- expect(custom.verdict).toBe("refused");
591
- expect(custom.reason).toMatch(/nope-city/i);
592
- });
593
- });
594
-
595
- describe("llm tool briefs", () => {
596
- it("renders one tool brief in openapi style with typed parameters", () => {
597
- const tool = buildtoolcatalog()
598
- .domains.flatMap((domain) => domain.tools)
599
- .find((candidate) => candidate.name === "browser.readtext");
600
- expect(tool).toBeDefined();
601
- const brief = toolbriefof(tool!);
602
- expect(brief.tool).toBe("browser.readtext");
603
- expect(brief.parameters.some((parameter) => parameter.name === "target" && parameter.required)).toBe(true);
604
- });
605
-
606
- it("renders the tool briefs with the consent notice for model consumption", () => {
607
- const tools = buildtoolcatalog()
608
- .domains.flatMap((domain) => domain.tools)
609
- .slice(0, 3);
610
- const rendered = rendertoolbriefs(tools);
611
- expect(rendered).toContain("tools:");
612
- expect(rendered).toContain("- tool: ");
613
- expect(rendered).toContain("consent: every tool with side effects executes only the approved plan step it names");
614
- });
615
- });
616
-
617
- describe("llm usage and budgets", () => {
618
- /** Builds one usage record fixture. */
619
- function usage(over: Partial<usagerecord> = {}): usagerecord {
620
- return {
621
- id: "u1",
622
- runid: "run1",
623
- providerid: "prov1",
624
- endpoint: "https://gateway.example/v1",
625
- model: "model-a",
626
- prompttokens: 10,
627
- completiontokens: 5,
628
- totaltokens: 15,
629
- cost: 0.01,
630
- at: now,
631
- ...over,
632
- };
633
- }
634
-
635
- it("accumulates the usage per run and per step", () => {
636
- const records = addusage(
637
- addusage(addusage([], usage()), usage({ id: "u2", stepid: "s1", totaltokens: 20, cost: 0.02 })),
638
- usage({ id: "u3", runid: "run2", totaltokens: 100, cost: 0.5 }),
639
- );
640
- expect(records[0]?.id).toBe("u3");
641
- expect(usagetotals(records)).toEqual({
642
- prompttokens: 30,
643
- completiontokens: 15,
644
- totaltokens: 135,
645
- cost: 0.53,
646
- calls: 3,
647
- });
648
- expect(usagetotals(records, { runid: "run1" }).calls).toBe(2);
649
- expect(usagetotals(records, { runid: "run1", stepid: "s1" }).totaltokens).toBe(20);
650
- expect(usagetotals(records, { since: now + 1 }).calls).toBe(0);
651
- });
652
-
653
- it("halts the run and asks the user when a ceiling is reached", () => {
654
- const budget = { maxtokens: 100, maxcost: 1, currency: "usd", configuredat: now };
655
- expect(budgetcheck({ budget, totals: { totaltokens: 99, cost: 0.2 } }).allowed).toBe(true);
656
- const halted = budgetcheck({ budget, totals: { totaltokens: 100, cost: 0.2 } });
657
- expect(halted.halted).toBe(true);
658
- expect(halted.asksuser).toBe(true);
659
- expect(halted.reason).toMatch(/token ceiling/i);
660
- const costly = budgetcheck({ budget, totals: { totaltokens: 50, cost: 1 } });
661
- expect(costly.halted).toBe(true);
662
- expect(costly.reason).toMatch(/cost ceiling/i);
663
- });
664
-
665
- it("keeps an absent budget unbounded with no silent default", () => {
666
- const outcome = budgetcheck({ budget: undefined, totals: { totaltokens: 1_000_000, cost: 10_000 } });
667
- expect(outcome.allowed).toBe(true);
668
- expect(outcome.halted).toBe(false);
669
- });
670
- });
671
-
672
- /** Builds one plandraft fixture from a draft answer body. */
673
- function outcomeof(body: string): plandraft {
674
- const parsed = JSON.parse(body) as {
675
- goal: string;
676
- steps: Array<{ kind: string; target?: string; value?: string; summary: string }>;
677
- openquestions: string[];
678
- };
679
- return {
680
- id: "draft1",
681
- goal: parsed.goal,
682
- steps: parsed.steps.map((step, index) => ({
683
- id: `step${index + 1}`,
684
- kind: step.kind,
685
- ...(step.target !== undefined ? { target: step.target } : {}),
686
- ...(step.value !== undefined ? { value: step.value } : {}),
687
- summary: step.summary,
688
- })),
689
- openquestions: parsed.openquestions,
690
- providerid: "prov1",
691
- model: "model-a",
692
- state: "approved",
693
- lintfindings: [],
694
- createdat: now,
695
- };
696
- }