copilotz 1.0.0-rc.2 → 1.0.0-rc.21

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 (1014) hide show
  1. package/CHANGELOG.md +927 -0
  2. package/README.md +351 -35
  3. package/hosts/orgs/mod.d.ts +29 -3
  4. package/hosts/orgs/mod.js +135 -12
  5. package/hosts/web/files.d.ts +6 -2
  6. package/hosts/web/files.js +36 -3
  7. package/hosts/web/mod.d.ts +1 -1
  8. package/hosts/web/mod.js +1 -1
  9. package/hosts/web/node/mod.d.ts +1 -1
  10. package/hosts/web/node/mod.js +1 -1
  11. package/hosts/web/node/serve.d.ts +26 -0
  12. package/hosts/web/node/serve.js +27 -2
  13. package/hosts/web/orgs.d.ts +36 -0
  14. package/hosts/web/orgs.js +21 -3
  15. package/hosts/web/pwa.js +1 -1
  16. package/hosts/web/routes.d.ts +90 -6
  17. package/hosts/web/routes.js +190 -34
  18. package/hosts/web/server.d.ts +13 -2
  19. package/hosts/web/server.js +12 -4
  20. package/hosts/web/style.d.ts +1 -1
  21. package/hosts/web/style.js +10 -0
  22. package/hosts/web/toolkit/button.js +6 -0
  23. package/hosts/web/toolkit/copy-button.js +4 -0
  24. package/hosts/web/toolkit/icon-button.js +6 -0
  25. package/hosts/web/toolkit/icon.d.ts +1 -0
  26. package/hosts/web/toolkit/icon.js +2 -0
  27. package/hosts/web/toolkit/input.js +6 -0
  28. package/hosts/web/toolkit/time.js +2 -1
  29. package/package.json +10 -6
  30. package/plugins/access/accounts/actions/complete.js +2 -2
  31. package/plugins/access/accounts/actions/connect.js +2 -2
  32. package/plugins/access/accounts/actions/disconnect.js +2 -2
  33. package/plugins/access/accounts/actions/model-key.d.ts +5 -0
  34. package/plugins/access/accounts/actions/model-key.js +102 -0
  35. package/plugins/access/accounts/collections/account.d.ts +2 -2
  36. package/plugins/access/accounts/collections/account.js +1 -2
  37. package/plugins/access/accounts/collections/flow.d.ts +1 -1
  38. package/plugins/access/accounts/collections/model-key.d.ts +58 -0
  39. package/plugins/access/accounts/collections/model-key.js +17 -0
  40. package/plugins/access/accounts/mod.d.ts +5 -0
  41. package/plugins/access/accounts/mod.js +14 -1
  42. package/plugins/access/accounts/resources/models.js +2 -0
  43. package/plugins/access/accounts/shared/rules.js +1 -1
  44. package/plugins/access/accounts/shared/settings.js +2 -2
  45. package/plugins/access/contacts/actions/chat.d.ts +1 -0
  46. package/plugins/access/contacts/actions/chat.js +45 -0
  47. package/plugins/access/contacts/actions/forget.d.ts +1 -0
  48. package/plugins/access/contacts/actions/forget.js +56 -0
  49. package/plugins/access/contacts/actions/start.d.ts +1 -0
  50. package/plugins/access/contacts/actions/start.js +50 -0
  51. package/plugins/access/contacts/collections/contact.d.ts +81 -0
  52. package/plugins/access/contacts/collections/contact.js +58 -0
  53. package/plugins/access/contacts/contract.d.ts +10 -0
  54. package/plugins/access/contacts/contract.js +10 -0
  55. package/plugins/access/contacts/mod.d.ts +27 -0
  56. package/plugins/access/contacts/mod.js +49 -0
  57. package/plugins/access/contacts/views/contact.d.ts +8 -0
  58. package/plugins/access/contacts/views/contact.js +25 -0
  59. package/plugins/access/contacts/web.d.ts +7 -0
  60. package/plugins/access/contacts/web.js +11 -0
  61. package/plugins/access/directory/actions/code.d.ts +4 -0
  62. package/plugins/access/directory/actions/code.js +135 -0
  63. package/plugins/access/directory/actions/host.d.ts +2 -0
  64. package/plugins/access/directory/actions/host.js +54 -0
  65. package/plugins/access/directory/actions/invite.js +1 -2
  66. package/plugins/access/directory/actions/org.js +19 -9
  67. package/plugins/access/directory/collections/credit-code.d.ts +114 -0
  68. package/plugins/access/directory/collections/credit-code.js +28 -0
  69. package/plugins/access/directory/collections/invite.d.ts +1 -1
  70. package/plugins/access/directory/collections/org-host.d.ts +61 -0
  71. package/plugins/access/directory/collections/org-host.js +29 -0
  72. package/plugins/access/directory/collections/org.d.ts +3 -3
  73. package/plugins/access/directory/mod.d.ts +4 -1
  74. package/plugins/access/directory/mod.js +13 -2
  75. package/plugins/access/identity/actions/key.js +3 -3
  76. package/plugins/access/identity/actions/session.js +2 -2
  77. package/plugins/access/identity/collections/credential.d.ts +1 -1
  78. package/plugins/access/identity/collections/credential.js +2 -2
  79. package/plugins/access/identity/mod.js +8 -6
  80. package/plugins/access/mod.d.ts +7 -1
  81. package/plugins/access/mod.js +7 -2
  82. package/plugins/access/spaces/actions/agents.js +15 -12
  83. package/plugins/access/spaces/actions/archive.js +4 -5
  84. package/plugins/access/spaces/actions/can.js +4 -4
  85. package/plugins/access/spaces/actions/create.js +12 -3
  86. package/plugins/access/spaces/actions/invitation.js +16 -13
  87. package/plugins/access/spaces/actions/keep.d.ts +1 -0
  88. package/plugins/access/spaces/actions/keep.js +55 -0
  89. package/plugins/access/spaces/actions/leave.js +2 -2
  90. package/plugins/access/spaces/actions/member.js +46 -38
  91. package/plugins/access/spaces/actions/org.d.ts +1 -0
  92. package/plugins/access/spaces/actions/org.js +26 -17
  93. package/plugins/access/spaces/actions/personal.js +5 -2
  94. package/plugins/access/spaces/actions/rename.js +8 -5
  95. package/plugins/access/spaces/actions/request.js +8 -13
  96. package/plugins/access/spaces/actions/share.js +2 -3
  97. package/plugins/access/spaces/collections/invitation.js +2 -2
  98. package/plugins/access/spaces/collections/member.d.ts +1 -1
  99. package/plugins/access/spaces/collections/profile.d.ts +61 -0
  100. package/plugins/access/spaces/collections/profile.js +54 -0
  101. package/plugins/access/spaces/collections/request.d.ts +1 -1
  102. package/plugins/access/spaces/collections/request.js +2 -2
  103. package/plugins/access/spaces/collections/space.d.ts +9 -0
  104. package/plugins/access/spaces/collections/space.js +33 -4
  105. package/plugins/access/spaces/contract.d.ts +50 -6
  106. package/plugins/access/spaces/contract.js +3 -0
  107. package/plugins/access/spaces/mod.d.ts +12 -1
  108. package/plugins/access/spaces/mod.js +26 -3
  109. package/plugins/access/spaces/processors/profile.d.ts +7 -0
  110. package/plugins/access/spaces/processors/profile.js +10 -0
  111. package/plugins/access/spaces/resources/commands.js +14 -4
  112. package/plugins/access/spaces/resources/tools.d.ts +0 -5
  113. package/plugins/access/spaces/resources/tools.js +14 -2
  114. package/plugins/access/spaces/shared/agents.js +2 -2
  115. package/plugins/access/spaces/shared/can.d.ts +27 -0
  116. package/plugins/access/spaces/shared/can.js +51 -0
  117. package/plugins/access/spaces/shared/declared.d.ts +21 -0
  118. package/plugins/access/spaces/shared/declared.js +8 -0
  119. package/plugins/access/spaces/shared/labels.d.ts +7 -1
  120. package/plugins/access/spaces/shared/labels.js +79 -11
  121. package/plugins/access/spaces/shared/managers.js +3 -3
  122. package/plugins/access/spaces/shared/names.d.ts +70 -0
  123. package/plugins/access/spaces/shared/names.js +105 -0
  124. package/plugins/access/spaces/shared/profile.d.ts +21 -0
  125. package/plugins/access/spaces/shared/profile.js +27 -0
  126. package/plugins/access/spaces/shared/reach.d.ts +28 -4
  127. package/plugins/access/spaces/shared/reach.js +81 -14
  128. package/plugins/access/spaces/shared/rules.d.ts +10 -5
  129. package/plugins/access/spaces/shared/rules.js +39 -12
  130. package/plugins/access/spaces/shared/seat.d.ts +10 -0
  131. package/plugins/access/spaces/shared/seat.js +29 -0
  132. package/plugins/access/spaces/views/elsewhere.d.ts +2 -1
  133. package/plugins/access/spaces/views/elsewhere.js +30 -8
  134. package/plugins/access/spaces/views/web/agents.d.ts +6 -1
  135. package/plugins/access/spaces/views/web/agents.js +7 -5
  136. package/plugins/access/spaces/views/web/header.d.ts +3 -1
  137. package/plugins/access/spaces/views/web/header.js +5 -5
  138. package/plugins/access/spaces/views/web/invitation.d.ts +3 -1
  139. package/plugins/access/spaces/views/web/invitation.js +2 -2
  140. package/plugins/access/spaces/views/web/invitations.js +3 -1
  141. package/plugins/access/spaces/views/web/invited.js +3 -1
  142. package/plugins/access/spaces/views/web/inviting.js +5 -3
  143. package/plugins/access/spaces/views/web/members.d.ts +3 -1
  144. package/plugins/access/spaces/views/web/members.js +52 -19
  145. package/plugins/access/spaces/views/web/org-about.js +3 -3
  146. package/plugins/access/spaces/views/web/org-members.d.ts +1 -1
  147. package/plugins/access/spaces/views/web/org-members.js +8 -7
  148. package/plugins/access/spaces/views/web/palette.js +18 -10
  149. package/plugins/access/spaces/views/web/panel.d.ts +3 -2
  150. package/plugins/access/spaces/views/web/panel.js +33 -17
  151. package/plugins/access/spaces/views/web/pending.d.ts +3 -1
  152. package/plugins/access/spaces/views/web/pending.js +5 -5
  153. package/plugins/access/spaces/views/web/sections.d.ts +31 -0
  154. package/plugins/access/spaces/views/web/sections.js +22 -0
  155. package/plugins/access/spaces/views/web/space.d.ts +4 -2
  156. package/plugins/access/spaces/views/web/space.js +25 -9
  157. package/plugins/access/spaces/views/web/spaces.js +3 -2
  158. package/plugins/access/spaces/views/web/style.d.ts +1 -1
  159. package/plugins/access/spaces/views/web/style.js +41 -0
  160. package/plugins/access/spaces/views/web/tabs.d.ts +18 -6
  161. package/plugins/access/spaces/views/web/tabs.js +24 -8
  162. package/plugins/access/spaces/views/web/tree.d.ts +3 -1
  163. package/plugins/access/spaces/views/web/tree.js +10 -9
  164. package/plugins/access/spaces/views/web/who.d.ts +14 -5
  165. package/plugins/access/spaces/views/web/who.js +25 -10
  166. package/plugins/access/spaces/views/where.d.ts +4 -2
  167. package/plugins/access/spaces/views/where.js +18 -3
  168. package/plugins/access/spaces/web.js +19 -2
  169. package/plugins/access/web.d.ts +1 -0
  170. package/plugins/access/web.js +1 -0
  171. package/plugins/agents/chat/actions/erase.d.ts +1 -0
  172. package/plugins/agents/chat/actions/erase.js +51 -0
  173. package/plugins/agents/chat/actions/fork.js +2 -2
  174. package/plugins/agents/chat/actions/move.js +2 -2
  175. package/plugins/agents/chat/actions/open.d.ts +1 -0
  176. package/plugins/agents/chat/actions/open.js +49 -0
  177. package/plugins/agents/chat/actions/quiet.d.ts +1 -0
  178. package/plugins/agents/chat/actions/quiet.js +33 -0
  179. package/plugins/agents/chat/actions/say.d.ts +1 -0
  180. package/plugins/agents/chat/actions/say.js +82 -0
  181. package/plugins/agents/chat/actions/send.js +77 -18
  182. package/plugins/agents/chat/actions/shown.d.ts +1 -0
  183. package/plugins/agents/chat/actions/shown.js +35 -0
  184. package/plugins/agents/chat/actions/stop.js +9 -2
  185. package/plugins/agents/chat/collections/file.d.ts +2 -0
  186. package/plugins/agents/chat/collections/file.js +4 -2
  187. package/plugins/agents/chat/collections/intent.d.ts +124 -0
  188. package/plugins/agents/chat/collections/intent.js +52 -0
  189. package/plugins/agents/chat/collections/message.d.ts +223 -3
  190. package/plugins/agents/chat/collections/message.js +73 -6
  191. package/plugins/agents/chat/collections/shown.d.ts +105 -0
  192. package/plugins/agents/chat/collections/shown.js +34 -0
  193. package/plugins/agents/chat/collections/thread.d.ts +9 -0
  194. package/plugins/agents/chat/collections/thread.js +5 -3
  195. package/plugins/agents/chat/contract.d.ts +19 -8
  196. package/plugins/agents/chat/contract.js +9 -0
  197. package/plugins/agents/chat/mod.d.ts +30 -7
  198. package/plugins/agents/chat/mod.js +62 -9
  199. package/plugins/agents/chat/processors/failed.js +21 -5
  200. package/plugins/agents/chat/processors/turn.d.ts +1 -1
  201. package/plugins/agents/chat/processors/turn.js +139 -43
  202. package/plugins/agents/chat/shared/agents.d.ts +9 -0
  203. package/plugins/agents/chat/shared/delivery.d.ts +23 -3
  204. package/plugins/agents/chat/shared/delivery.js +96 -10
  205. package/plugins/agents/chat/shared/lineage.d.ts +31 -5
  206. package/plugins/agents/chat/shared/lineage.js +65 -21
  207. package/plugins/agents/chat/shared/origin.d.ts +22 -0
  208. package/plugins/agents/chat/shared/origin.js +11 -0
  209. package/plugins/agents/chat/shared/send.d.ts +3 -1
  210. package/plugins/agents/chat/shared/send.js +82 -3
  211. package/plugins/agents/chat/shared/tools.d.ts +33 -0
  212. package/plugins/agents/chat/shared/tools.js +28 -0
  213. package/plugins/agents/chat/shared/types.d.ts +105 -9
  214. package/plugins/agents/chat/shared/types.js +3 -0
  215. package/plugins/agents/chat/views/context.d.ts +4 -2
  216. package/plugins/agents/chat/views/context.js +7 -3
  217. package/plugins/agents/chat/views/history.d.ts +4 -0
  218. package/plugins/agents/chat/views/message.d.ts +8 -2
  219. package/plugins/agents/chat/views/message.js +46 -10
  220. package/plugins/agents/chat/views/participants.js +7 -1
  221. package/plugins/agents/chat/views/prompt.d.ts +3 -1
  222. package/plugins/agents/chat/views/prompt.js +66 -18
  223. package/plugins/agents/chat/views/terminal/agent-prompt.js +2 -2
  224. package/plugins/agents/chat/views/terminal/author.js +5 -1
  225. package/plugins/agents/chat/views/web/composer.d.ts +7 -2
  226. package/plugins/agents/chat/views/web/composer.js +9 -1
  227. package/plugins/agents/chat/views/web/conversation.d.ts +3 -2
  228. package/plugins/agents/chat/views/web/conversation.js +18 -5
  229. package/plugins/agents/chat/views/web/header.d.ts +2 -1
  230. package/plugins/agents/chat/views/web/header.js +1 -1
  231. package/plugins/agents/chat/views/web/held.d.ts +10 -9
  232. package/plugins/agents/chat/views/web/held.js +27 -20
  233. package/plugins/agents/chat/views/web/home.d.ts +3 -2
  234. package/plugins/agents/chat/views/web/home.js +1 -1
  235. package/plugins/agents/chat/views/web/message.d.ts +10 -1
  236. package/plugins/agents/chat/views/web/message.js +23 -5
  237. package/plugins/agents/chat/views/web/over.d.ts +9 -8
  238. package/plugins/agents/chat/views/web/over.js +10 -9
  239. package/plugins/agents/chat/views/web/style.d.ts +1 -1
  240. package/plugins/agents/chat/views/web/style.js +19 -6
  241. package/plugins/agents/chat/web.d.ts +5 -1
  242. package/plugins/agents/chat/web.js +5 -1
  243. package/plugins/agents/history/collections/outline.d.ts +74 -7
  244. package/plugins/agents/history/collections/outline.js +20 -4
  245. package/plugins/agents/history/collections/summary.d.ts +1 -1
  246. package/plugins/agents/history/mod.d.ts +14 -6
  247. package/plugins/agents/history/mod.js +16 -7
  248. package/plugins/agents/history/processors/compact.d.ts +6 -1
  249. package/plugins/agents/history/processors/compact.js +112 -43
  250. package/plugins/agents/history/processors/erase.d.ts +3 -0
  251. package/plugins/agents/history/processors/erase.js +11 -0
  252. package/plugins/agents/history/resources/tools.js +12 -3
  253. package/plugins/agents/history/shared/lines.d.ts +5 -2
  254. package/plugins/agents/history/shared/lines.js +10 -2
  255. package/plugins/agents/history/shared/settings.d.ts +5 -1
  256. package/plugins/agents/history/shared/weight.d.ts +28 -0
  257. package/plugins/agents/history/shared/weight.js +62 -0
  258. package/plugins/agents/history/views/history.d.ts +4 -1
  259. package/plugins/agents/history/views/history.js +21 -7
  260. package/plugins/agents/history/views/since.d.ts +6 -3
  261. package/plugins/agents/history/views/since.js +9 -2
  262. package/plugins/agents/memory/collections/memory.js +17 -6
  263. package/plugins/agents/memory/mod.js +4 -3
  264. package/plugins/agents/memory/processors/extract.d.ts +1 -1
  265. package/plugins/agents/memory/processors/extract.js +14 -4
  266. package/plugins/agents/memory/resources/context.d.ts +9 -1
  267. package/plugins/agents/memory/resources/context.js +7 -1
  268. package/plugins/agents/memory/resources/tools.js +12 -9
  269. package/plugins/agents/memory/shared/scope.d.ts +12 -3
  270. package/plugins/agents/memory/shared/scope.js +25 -6
  271. package/plugins/agents/memory/shared/search.d.ts +3 -1
  272. package/plugins/agents/memory/shared/search.js +18 -4
  273. package/plugins/agents/memory/shared/settings.d.ts +12 -4
  274. package/plugins/agents/memory/shared/settings.js +15 -4
  275. package/plugins/agents/memory/views/context.d.ts +4 -1
  276. package/plugins/agents/memory/views/context.js +27 -11
  277. package/plugins/agents/memory/views/memory.d.ts +1 -0
  278. package/plugins/agents/memory/views/memory.js +4 -2
  279. package/plugins/agents/memory/views/terminal/memory.d.ts +4 -1
  280. package/plugins/agents/memory/views/terminal/memory.js +7 -2
  281. package/plugins/agents/memory/views/web/card.d.ts +4 -2
  282. package/plugins/agents/memory/views/web/card.js +4 -3
  283. package/plugins/agents/memory/views/web/list.d.ts +3 -1
  284. package/plugins/agents/memory/views/web/list.js +20 -9
  285. package/plugins/agents/memory/views/web/memories.js +5 -1
  286. package/plugins/agents/memory/views/web/pick.js +8 -5
  287. package/plugins/agents/memory/web.js +9 -1
  288. package/plugins/agents/mod.d.ts +7 -3
  289. package/plugins/agents/mod.js +7 -3
  290. package/plugins/agents/openapi/actions/operation.d.ts +11 -0
  291. package/plugins/agents/openapi/actions/operation.js +86 -0
  292. package/plugins/agents/openapi/contract.d.ts +79 -0
  293. package/plugins/agents/openapi/contract.js +1 -0
  294. package/plugins/agents/openapi/mod.d.ts +5 -0
  295. package/plugins/agents/openapi/mod.js +78 -0
  296. package/plugins/agents/openapi/resources/tools.d.ts +9 -0
  297. package/plugins/agents/openapi/resources/tools.js +23 -0
  298. package/plugins/agents/openapi/shared/files.d.ts +4 -0
  299. package/plugins/agents/openapi/shared/files.js +126 -0
  300. package/plugins/agents/openapi/shared/plan.d.ts +34 -0
  301. package/plugins/agents/openapi/shared/plan.js +122 -0
  302. package/plugins/agents/openapi/shared/request.d.ts +15 -0
  303. package/plugins/agents/openapi/shared/request.js +87 -0
  304. package/plugins/agents/openapi/shared/response.d.ts +24 -0
  305. package/plugins/agents/openapi/shared/response.js +133 -0
  306. package/plugins/agents/openapi/shared/schema.d.ts +20 -0
  307. package/plugins/agents/openapi/shared/schema.js +128 -0
  308. package/plugins/agents/openapi/shared/settings.d.ts +22 -0
  309. package/plugins/agents/openapi/shared/settings.js +34 -0
  310. package/plugins/agents/openapi/shared/spec.d.ts +55 -0
  311. package/plugins/agents/openapi/shared/spec.js +99 -0
  312. package/plugins/agents/routines/actions/create.js +24 -12
  313. package/plugins/agents/routines/actions/delete.js +2 -2
  314. package/plugins/agents/routines/actions/origin.d.ts +1 -0
  315. package/plugins/agents/routines/actions/origin.js +32 -0
  316. package/plugins/agents/routines/actions/pause.js +2 -2
  317. package/plugins/agents/routines/actions/resume.js +2 -2
  318. package/plugins/agents/routines/actions/run.js +4 -4
  319. package/plugins/agents/routines/actions/update.js +18 -10
  320. package/plugins/agents/routines/collections/routine.d.ts +15 -3
  321. package/plugins/agents/routines/collections/routine.js +14 -8
  322. package/plugins/agents/routines/collections/run.d.ts +10 -1
  323. package/plugins/agents/routines/collections/run.js +2 -0
  324. package/plugins/agents/routines/contract.d.ts +7 -1
  325. package/plugins/agents/routines/mod.d.ts +10 -2
  326. package/plugins/agents/routines/mod.js +14 -2
  327. package/plugins/agents/routines/resources/tools.js +64 -13
  328. package/plugins/agents/routines/shared/fire.d.ts +5 -2
  329. package/plugins/agents/routines/shared/fire.js +30 -14
  330. package/plugins/agents/routines/shared/routines.d.ts +17 -8
  331. package/plugins/agents/routines/shared/routines.js +33 -19
  332. package/plugins/agents/routines/shared/schedule.d.ts +5 -0
  333. package/plugins/agents/routines/shared/schedule.js +12 -1
  334. package/plugins/agents/routines/views/web/form.d.ts +4 -3
  335. package/plugins/agents/routines/views/web/form.js +29 -7
  336. package/plugins/agents/routines/views/web/new.js +1 -1
  337. package/plugins/agents/routines/views/web/page.d.ts +2 -1
  338. package/plugins/agents/routines/views/web/page.js +32 -10
  339. package/plugins/agents/routines/views/web/routines.d.ts +2 -1
  340. package/plugins/agents/routines/views/web/routines.js +1 -1
  341. package/plugins/agents/routines/views/web/step.js +3 -1
  342. package/plugins/agents/routines/views/web/style.d.ts +1 -1
  343. package/plugins/agents/routines/views/web/style.js +1 -0
  344. package/plugins/agents/routines/web.js +1 -1
  345. package/plugins/agents/skills/actions/create.js +2 -2
  346. package/plugins/agents/skills/actions/delete.js +2 -2
  347. package/plugins/agents/skills/actions/update.js +2 -2
  348. package/plugins/agents/skills/collections/skill.js +4 -4
  349. package/plugins/agents/skills/shared/write.d.ts +2 -3
  350. package/plugins/agents/skills/shared/write.js +2 -1
  351. package/plugins/agents/skills/views/web/page.js +7 -3
  352. package/plugins/agents/skills/web.js +3 -1
  353. package/plugins/agents/team/actions/agent.js +5 -6
  354. package/plugins/agents/team/collections/agent.js +3 -3
  355. package/plugins/agents/team/contract.d.ts +7 -4
  356. package/plugins/agents/team/views/web/agent-fields.js +3 -4
  357. package/plugins/agents/team/views/web/model-pick.d.ts +25 -0
  358. package/plugins/agents/team/views/web/model-pick.js +39 -0
  359. package/plugins/agents/team/views/web/model-picker.d.ts +23 -0
  360. package/plugins/agents/team/views/web/model-picker.js +206 -0
  361. package/plugins/agents/team/views/web/style.d.ts +2 -2
  362. package/plugins/agents/team/views/web/style.js +52 -1
  363. package/plugins/agents/team/web.d.ts +4 -2
  364. package/plugins/agents/team/web.js +6 -2
  365. package/plugins/agents/tiers/actions/choose.d.ts +2 -0
  366. package/plugins/agents/tiers/actions/choose.js +98 -0
  367. package/plugins/agents/tiers/actions/model.d.ts +1 -0
  368. package/plugins/agents/tiers/actions/model.js +36 -0
  369. package/plugins/agents/tiers/collections/choice.d.ts +48 -0
  370. package/plugins/agents/tiers/collections/choice.js +59 -0
  371. package/plugins/agents/tiers/contract.d.ts +19 -0
  372. package/plugins/agents/tiers/contract.js +1 -0
  373. package/plugins/agents/tiers/mod.d.ts +54 -0
  374. package/plugins/agents/tiers/mod.js +92 -0
  375. package/plugins/agents/tiers/shared/shown.d.ts +87 -0
  376. package/plugins/agents/tiers/shared/shown.js +155 -0
  377. package/plugins/agents/tiers/shared/tiers.d.ts +103 -0
  378. package/plugins/agents/tiers/shared/tiers.js +129 -0
  379. package/plugins/agents/tiers/views/web/org.d.ts +38 -0
  380. package/plugins/agents/tiers/views/web/org.js +142 -0
  381. package/plugins/agents/tiers/views/web/space.d.ts +43 -0
  382. package/plugins/agents/tiers/views/web/space.js +103 -0
  383. package/plugins/agents/tiers/views/web/style.d.ts +7 -0
  384. package/plugins/agents/tiers/views/web/style.js +87 -0
  385. package/plugins/agents/tiers/views/web/words.d.ts +21 -0
  386. package/plugins/agents/tiers/views/web/words.js +49 -0
  387. package/plugins/agents/tiers/web.d.ts +18 -0
  388. package/plugins/agents/tiers/web.js +40 -0
  389. package/plugins/agents/web.d.ts +1 -0
  390. package/plugins/agents/web.js +1 -0
  391. package/plugins/billing/credits/actions/check.d.ts +5 -0
  392. package/plugins/billing/credits/actions/check.js +97 -0
  393. package/plugins/billing/credits/actions/manage.d.ts +9 -0
  394. package/plugins/billing/credits/actions/manage.js +266 -0
  395. package/plugins/billing/credits/actions/state.d.ts +2 -0
  396. package/plugins/billing/credits/actions/state.js +172 -0
  397. package/plugins/billing/credits/collections/credit.d.ts +110 -0
  398. package/plugins/billing/credits/collections/credit.js +31 -0
  399. package/plugins/billing/credits/collections/payment.d.ts +139 -0
  400. package/plugins/billing/credits/collections/payment.js +32 -0
  401. package/plugins/billing/credits/collections/plan.d.ts +428 -0
  402. package/plugins/billing/credits/collections/plan.js +97 -0
  403. package/plugins/billing/credits/collections/room.d.ts +85 -0
  404. package/plugins/billing/credits/collections/room.js +24 -0
  405. package/plugins/billing/credits/contract.d.ts +19 -0
  406. package/plugins/billing/credits/contract.js +12 -0
  407. package/plugins/billing/credits/mod.d.ts +38 -0
  408. package/plugins/billing/credits/mod.js +72 -0
  409. package/plugins/billing/credits/shared/apply.d.ts +66 -0
  410. package/plugins/billing/credits/shared/apply.js +106 -0
  411. package/plugins/billing/credits/shared/settings.d.ts +70 -0
  412. package/plugins/billing/credits/shared/settings.js +28 -0
  413. package/plugins/billing/credits/shared/standing.d.ts +71 -0
  414. package/plugins/billing/credits/shared/standing.js +235 -0
  415. package/plugins/billing/credits/shared/walk.d.ts +50 -0
  416. package/plugins/billing/credits/shared/walk.js +127 -0
  417. package/plugins/billing/credits/views/web/add.d.ts +25 -0
  418. package/plugins/billing/credits/views/web/add.js +92 -0
  419. package/plugins/billing/credits/views/web/budget.d.ts +16 -0
  420. package/plugins/billing/credits/views/web/budget.js +62 -0
  421. package/plugins/billing/credits/views/web/composer.d.ts +13 -0
  422. package/plugins/billing/credits/views/web/composer.js +64 -0
  423. package/plugins/billing/credits/views/web/history.d.ts +12 -0
  424. package/plugins/billing/credits/views/web/history.js +55 -0
  425. package/plugins/billing/credits/views/web/numbers.d.ts +256 -0
  426. package/plugins/billing/credits/views/web/numbers.js +291 -0
  427. package/plugins/billing/credits/views/web/org.d.ts +31 -0
  428. package/plugins/billing/credits/views/web/org.js +238 -0
  429. package/plugins/billing/credits/views/web/plan.d.ts +28 -0
  430. package/plugins/billing/credits/views/web/plan.js +84 -0
  431. package/plugins/billing/credits/views/web/staff.d.ts +20 -0
  432. package/plugins/billing/credits/views/web/staff.js +265 -0
  433. package/plugins/billing/credits/views/web/style.d.ts +9 -0
  434. package/plugins/billing/credits/views/web/style.js +190 -0
  435. package/plugins/billing/credits/views/web/types.d.ts +17 -0
  436. package/plugins/billing/credits/views/web/types.js +32 -0
  437. package/plugins/billing/credits/web.d.ts +12 -0
  438. package/plugins/billing/credits/web.js +33 -0
  439. package/plugins/billing/mod.d.ts +8 -3
  440. package/plugins/billing/mod.js +7 -3
  441. package/plugins/billing/stripe/actions/checkout.d.ts +4 -0
  442. package/plugins/billing/stripe/actions/checkout.js +188 -0
  443. package/plugins/billing/stripe/mod.d.ts +18 -0
  444. package/plugins/billing/stripe/mod.js +33 -0
  445. package/plugins/billing/stripe/shared/api.d.ts +14 -0
  446. package/plugins/billing/stripe/shared/api.js +42 -0
  447. package/plugins/billing/stripe/shared/events.d.ts +42 -0
  448. package/plugins/billing/stripe/shared/events.js +226 -0
  449. package/plugins/billing/stripe/shared/settings.d.ts +34 -0
  450. package/plugins/billing/stripe/shared/settings.js +10 -0
  451. package/plugins/billing/stripe/webhook.d.ts +17 -0
  452. package/plugins/billing/stripe/webhook.js +45 -0
  453. package/plugins/billing/usage/actions/activity.d.ts +84 -0
  454. package/plugins/billing/usage/actions/activity.js +310 -0
  455. package/plugins/billing/usage/actions/close.js +36 -5
  456. package/plugins/billing/usage/actions/org.d.ts +29 -1
  457. package/plugins/billing/usage/actions/org.js +32 -62
  458. package/plugins/billing/usage/actions/quote.d.ts +7 -0
  459. package/plugins/billing/usage/actions/quote.js +86 -0
  460. package/plugins/billing/usage/actions/rerate.js +23 -2
  461. package/plugins/billing/usage/collections/closed.d.ts +11 -1
  462. package/plugins/billing/usage/collections/closed.js +4 -1
  463. package/plugins/billing/usage/collections/rollup.d.ts +81 -2
  464. package/plugins/billing/usage/collections/rollup.js +16 -4
  465. package/plugins/billing/usage/collections/usage.d.ts +75 -5
  466. package/plugins/billing/usage/collections/usage.js +34 -15
  467. package/plugins/billing/usage/mod.d.ts +31 -11
  468. package/plugins/billing/usage/mod.js +41 -13
  469. package/plugins/billing/usage/resources/commands.js +1 -1
  470. package/plugins/billing/usage/shared/categories.d.ts +23 -0
  471. package/plugins/billing/usage/shared/categories.js +40 -0
  472. package/plugins/billing/usage/shared/names.d.ts +45 -0
  473. package/plugins/billing/usage/shared/names.js +60 -0
  474. package/plugins/billing/usage/shared/rate.d.ts +39 -11
  475. package/plugins/billing/usage/shared/rate.js +90 -32
  476. package/plugins/billing/usage/shared/settings.d.ts +18 -1
  477. package/plugins/billing/usage/shared/settings.js +11 -2
  478. package/plugins/billing/usage/shared/totals.d.ts +38 -8
  479. package/plugins/billing/usage/shared/totals.js +87 -22
  480. package/plugins/billing/usage/shared/use.d.ts +12 -1
  481. package/plugins/billing/usage/shared/use.js +14 -7
  482. package/plugins/billing/usage/views/terminal/totals.d.ts +6 -2
  483. package/plugins/billing/usage/views/terminal/totals.js +38 -6
  484. package/plugins/billing/usage/views/web/chart.d.ts +25 -10
  485. package/plugins/billing/usage/views/web/chart.js +67 -39
  486. package/plugins/billing/usage/views/web/numbers.d.ts +143 -48
  487. package/plugins/billing/usage/views/web/numbers.js +250 -56
  488. package/plugins/billing/usage/views/web/org.d.ts +32 -6
  489. package/plugins/billing/usage/views/web/org.js +538 -123
  490. package/plugins/billing/usage/views/web/style.d.ts +9 -5
  491. package/plugins/billing/usage/views/web/style.js +148 -65
  492. package/plugins/billing/usage/web.d.ts +8 -5
  493. package/plugins/billing/usage/web.js +8 -5
  494. package/plugins/billing/web.d.ts +3 -0
  495. package/plugins/billing/web.js +3 -0
  496. package/plugins/compute/apps/actions/build.d.ts +1 -0
  497. package/plugins/compute/apps/actions/build.js +99 -0
  498. package/plugins/compute/apps/actions/configure.d.ts +1 -0
  499. package/plugins/compute/apps/actions/configure.js +74 -0
  500. package/plugins/compute/apps/actions/list.d.ts +1 -0
  501. package/plugins/compute/apps/actions/list.js +13 -0
  502. package/plugins/compute/apps/actions/meter.d.ts +1 -0
  503. package/plugins/compute/apps/actions/meter.js +43 -0
  504. package/plugins/compute/apps/actions/publish.d.ts +1 -0
  505. package/plugins/compute/apps/actions/publish.js +41 -0
  506. package/plugins/compute/apps/actions/redeploy.d.ts +1 -0
  507. package/plugins/compute/apps/actions/redeploy.js +26 -0
  508. package/plugins/compute/apps/actions/remove.d.ts +1 -0
  509. package/plugins/compute/apps/actions/remove.js +47 -0
  510. package/plugins/compute/apps/adapters/cloudrun.d.ts +90 -0
  511. package/plugins/compute/apps/adapters/cloudrun.js +353 -0
  512. package/plugins/compute/apps/adapters/front.d.ts +24 -0
  513. package/plugins/compute/apps/adapters/front.js +131 -0
  514. package/plugins/compute/apps/adapters/local.d.ts +15 -0
  515. package/plugins/compute/apps/adapters/local.js +139 -0
  516. package/plugins/compute/apps/adapters/tar.d.ts +29 -0
  517. package/plugins/compute/apps/adapters/tar.js +178 -0
  518. package/plugins/compute/apps/collections/app.d.ts +143 -0
  519. package/plugins/compute/apps/collections/app.js +60 -0
  520. package/plugins/compute/apps/contract.d.ts +73 -0
  521. package/plugins/compute/apps/contract.js +8 -0
  522. package/plugins/compute/apps/mod.d.ts +42 -0
  523. package/plugins/compute/apps/mod.js +69 -0
  524. package/plugins/compute/apps/resources/tools.d.ts +10 -0
  525. package/plugins/compute/apps/resources/tools.js +85 -0
  526. package/plugins/compute/apps/shared/archive.d.ts +24 -0
  527. package/plugins/compute/apps/shared/archive.js +69 -0
  528. package/plugins/compute/apps/shared/claims.d.ts +28 -0
  529. package/plugins/compute/apps/shared/claims.js +18 -0
  530. package/plugins/compute/apps/shared/environment.d.ts +8 -0
  531. package/plugins/compute/apps/shared/environment.js +15 -0
  532. package/plugins/compute/apps/shared/errors.d.ts +4 -0
  533. package/plugins/compute/apps/shared/errors.js +4 -0
  534. package/plugins/compute/apps/shared/host.d.ts +19 -0
  535. package/plugins/compute/apps/shared/host.js +19 -0
  536. package/plugins/compute/apps/shared/label.d.ts +21 -0
  537. package/plugins/compute/apps/shared/label.js +51 -0
  538. package/plugins/compute/apps/shared/meter.d.ts +17 -0
  539. package/plugins/compute/apps/shared/meter.js +29 -0
  540. package/plugins/compute/apps/shared/publish.d.ts +41 -0
  541. package/plugins/compute/apps/shared/publish.js +141 -0
  542. package/plugins/compute/apps/shared/settings.d.ts +49 -0
  543. package/plugins/compute/apps/shared/settings.js +22 -0
  544. package/plugins/compute/apps/views/web/apps.d.ts +54 -0
  545. package/plugins/compute/apps/views/web/apps.js +48 -0
  546. package/plugins/compute/apps/views/web/env.d.ts +54 -0
  547. package/plugins/compute/apps/views/web/env.js +195 -0
  548. package/plugins/compute/apps/views/web/publish.d.ts +24 -0
  549. package/plugins/compute/apps/views/web/publish.js +158 -0
  550. package/plugins/compute/apps/views/web/space.d.ts +16 -0
  551. package/plugins/compute/apps/views/web/space.js +138 -0
  552. package/plugins/compute/apps/views/web/style.d.ts +7 -0
  553. package/plugins/compute/apps/views/web/style.js +155 -0
  554. package/plugins/compute/apps/web.d.ts +17 -0
  555. package/plugins/compute/apps/web.js +35 -0
  556. package/plugins/compute/cloud/actions/create.d.ts +1 -0
  557. package/plugins/compute/cloud/actions/create.js +76 -0
  558. package/plugins/compute/cloud/actions/daily.d.ts +1 -0
  559. package/plugins/compute/cloud/actions/daily.js +75 -0
  560. package/plugins/compute/cloud/actions/destroy.d.ts +1 -0
  561. package/plugins/compute/cloud/actions/destroy.js +71 -0
  562. package/plugins/compute/cloud/actions/may.d.ts +1 -0
  563. package/plugins/compute/cloud/actions/may.js +15 -0
  564. package/plugins/compute/cloud/actions/org.d.ts +1 -0
  565. package/plugins/compute/cloud/actions/org.js +21 -0
  566. package/plugins/compute/cloud/actions/pool-tick.d.ts +4 -0
  567. package/plugins/compute/cloud/actions/pool-tick.js +96 -0
  568. package/plugins/compute/cloud/actions/pool.d.ts +3 -0
  569. package/plugins/compute/cloud/actions/pool.js +98 -0
  570. package/plugins/compute/cloud/actions/release.d.ts +1 -0
  571. package/plugins/compute/cloud/actions/release.js +58 -0
  572. package/plugins/compute/cloud/actions/remote.d.ts +10 -0
  573. package/plugins/compute/cloud/actions/remote.js +24 -0
  574. package/plugins/compute/cloud/actions/tick.d.ts +1 -0
  575. package/plugins/compute/cloud/actions/tick.js +105 -0
  576. package/plugins/compute/cloud/actions/touch.d.ts +1 -0
  577. package/plugins/compute/cloud/actions/touch.js +32 -0
  578. package/plugins/compute/cloud/actions/vms.d.ts +7 -0
  579. package/plugins/compute/cloud/actions/vms.js +211 -0
  580. package/plugins/compute/cloud/actions/wake.d.ts +1 -0
  581. package/plugins/compute/cloud/actions/wake.js +153 -0
  582. package/plugins/compute/cloud/adapters/gce/index.d.ts +73 -0
  583. package/plugins/compute/cloud/adapters/gce/index.js +242 -0
  584. package/plugins/compute/cloud/adapters/local.d.ts +48 -0
  585. package/plugins/compute/cloud/adapters/local.js +188 -0
  586. package/plugins/compute/cloud/collections/cloud-computer.d.ts +109 -0
  587. package/plugins/compute/cloud/collections/cloud-computer.js +89 -0
  588. package/plugins/compute/cloud/collections/pool-vm.d.ts +79 -0
  589. package/plugins/compute/cloud/collections/pool-vm.js +36 -0
  590. package/plugins/compute/cloud/collections/pool-want.d.ts +94 -0
  591. package/plugins/compute/cloud/collections/pool-want.js +27 -0
  592. package/plugins/compute/cloud/contract.d.ts +236 -0
  593. package/plugins/compute/cloud/contract.js +67 -0
  594. package/plugins/compute/cloud/mod.d.ts +97 -0
  595. package/plugins/compute/cloud/mod.js +197 -0
  596. package/plugins/compute/cloud/processors/mark.d.ts +9 -0
  597. package/plugins/compute/cloud/processors/mark.js +13 -0
  598. package/plugins/compute/cloud/resources/tools.d.ts +3 -0
  599. package/plugins/compute/cloud/resources/tools.js +237 -0
  600. package/plugins/compute/cloud/shared/google.d.ts +75 -0
  601. package/plugins/compute/cloud/shared/google.js +218 -0
  602. package/plugins/compute/cloud/shared/host.d.ts +11 -0
  603. package/plugins/compute/cloud/shared/host.js +29 -0
  604. package/plugins/compute/cloud/shared/may.d.ts +21 -0
  605. package/plugins/compute/cloud/shared/may.js +22 -0
  606. package/plugins/compute/cloud/shared/meter.d.ts +36 -0
  607. package/plugins/compute/cloud/shared/meter.js +68 -0
  608. package/plugins/compute/cloud/shared/names.d.ts +10 -0
  609. package/plugins/compute/cloud/shared/names.js +11 -0
  610. package/plugins/compute/cloud/shared/people.d.ts +19 -0
  611. package/plugins/compute/cloud/shared/people.js +12 -0
  612. package/plugins/compute/cloud/shared/records.d.ts +31 -0
  613. package/plugins/compute/cloud/shared/records.js +18 -0
  614. package/plugins/compute/cloud/shared/settings.d.ts +70 -0
  615. package/plugins/compute/cloud/shared/settings.js +47 -0
  616. package/plugins/compute/cloud/shared/time.d.ts +21 -0
  617. package/plugins/compute/cloud/shared/time.js +33 -0
  618. package/plugins/compute/cloud/views/web/cloud.d.ts +79 -0
  619. package/plugins/compute/cloud/views/web/cloud.js +122 -0
  620. package/plugins/compute/cloud/views/web/computer.d.ts +37 -0
  621. package/plugins/compute/cloud/views/web/computer.js +195 -0
  622. package/plugins/compute/cloud/views/web/new.d.ts +27 -0
  623. package/plugins/compute/cloud/views/web/new.js +103 -0
  624. package/plugins/compute/cloud/views/web/style.d.ts +6 -0
  625. package/plugins/compute/cloud/views/web/style.js +84 -0
  626. package/plugins/compute/cloud/web.d.ts +19 -0
  627. package/plugins/compute/cloud/web.js +61 -0
  628. package/plugins/compute/computers/actions/allow-origin.d.ts +5 -0
  629. package/plugins/compute/computers/actions/allow-origin.js +48 -0
  630. package/plugins/compute/computers/actions/allowed.d.ts +1 -0
  631. package/plugins/compute/computers/actions/allowed.js +50 -0
  632. package/plugins/compute/computers/actions/approve.js +19 -10
  633. package/plugins/compute/computers/actions/code.js +4 -4
  634. package/plugins/compute/computers/actions/default.js +4 -8
  635. package/plugins/compute/computers/actions/enrollment.d.ts +1 -0
  636. package/plugins/compute/computers/actions/enrollment.js +49 -0
  637. package/plugins/compute/computers/actions/env.d.ts +3 -0
  638. package/plugins/compute/computers/actions/env.js +134 -0
  639. package/plugins/compute/computers/actions/forget-grant.d.ts +1 -0
  640. package/plugins/compute/computers/actions/forget-grant.js +16 -0
  641. package/plugins/compute/computers/actions/forget.js +2 -2
  642. package/plugins/compute/computers/actions/mark.d.ts +1 -0
  643. package/plugins/compute/computers/actions/mark.js +36 -0
  644. package/plugins/compute/computers/actions/move.js +5 -4
  645. package/plugins/compute/computers/actions/preview.d.ts +4 -0
  646. package/plugins/compute/computers/actions/preview.js +183 -0
  647. package/plugins/compute/computers/actions/provision.d.ts +1 -0
  648. package/plugins/compute/computers/actions/provision.js +51 -0
  649. package/plugins/compute/computers/actions/rename.js +2 -2
  650. package/plugins/compute/computers/actions/running.d.ts +1 -0
  651. package/plugins/compute/computers/actions/running.js +33 -0
  652. package/plugins/compute/computers/actions/scope.d.ts +1 -0
  653. package/plugins/compute/computers/actions/scope.js +61 -0
  654. package/plugins/compute/computers/actions/share.js +5 -4
  655. package/plugins/compute/computers/actions/unshare.js +5 -8
  656. package/plugins/compute/computers/actions/view.d.ts +1 -0
  657. package/plugins/compute/computers/actions/view.js +29 -0
  658. package/plugins/compute/computers/actions/work.js +41 -6
  659. package/plugins/compute/computers/collections/approval.d.ts +57 -5
  660. package/plugins/compute/computers/collections/approval.js +16 -4
  661. package/plugins/compute/computers/collections/computer.d.ts +70 -1
  662. package/plugins/compute/computers/collections/computer.js +18 -2
  663. package/plugins/compute/computers/collections/desk.d.ts +53 -0
  664. package/plugins/compute/computers/collections/desk.js +11 -3
  665. package/plugins/compute/computers/collections/env-var.d.ts +122 -0
  666. package/plugins/compute/computers/collections/env-var.js +51 -0
  667. package/plugins/compute/computers/collections/grant.d.ts +20 -3
  668. package/plugins/compute/computers/collections/grant.js +21 -5
  669. package/plugins/compute/computers/collections/preview.d.ts +111 -0
  670. package/plugins/compute/computers/collections/preview.js +58 -0
  671. package/plugins/compute/computers/contract.d.ts +18 -0
  672. package/plugins/compute/computers/contract.js +8 -0
  673. package/plugins/compute/computers/mod.d.ts +9 -1
  674. package/plugins/compute/computers/mod.js +50 -6
  675. package/plugins/compute/computers/processors/left.d.ts +8 -0
  676. package/plugins/compute/computers/processors/left.js +31 -0
  677. package/plugins/compute/computers/program/version.d.ts +1 -1
  678. package/plugins/compute/computers/program/version.js +1 -1
  679. package/plugins/compute/computers/resources/commands.js +29 -13
  680. package/plugins/compute/computers/resources/downloads.js +1 -1
  681. package/plugins/compute/computers/resources/previews.d.ts +48 -0
  682. package/plugins/compute/computers/resources/previews.js +391 -0
  683. package/plugins/compute/computers/resources/tools.d.ts +11 -5
  684. package/plugins/compute/computers/resources/tools.js +155 -22
  685. package/plugins/compute/computers/shared/ask.d.ts +7 -3
  686. package/plugins/compute/computers/shared/ask.js +36 -11
  687. package/plugins/compute/computers/shared/asks.d.ts +2 -2
  688. package/plugins/compute/computers/shared/asks.js +3 -2
  689. package/plugins/compute/computers/shared/desks.d.ts +1 -5
  690. package/plugins/compute/computers/shared/desks.js +2 -11
  691. package/plugins/compute/computers/shared/env.d.ts +20 -0
  692. package/plugins/compute/computers/shared/env.js +50 -0
  693. package/plugins/compute/computers/shared/grants.d.ts +26 -0
  694. package/plugins/compute/computers/shared/grants.js +49 -0
  695. package/plugins/compute/computers/shared/jobs.d.ts +13 -0
  696. package/plugins/compute/computers/shared/jobs.js +16 -0
  697. package/plugins/compute/computers/shared/preview-url.d.ts +5 -0
  698. package/plugins/compute/computers/shared/preview-url.js +5 -0
  699. package/plugins/compute/computers/shared/seal.d.ts +4 -0
  700. package/plugins/compute/computers/shared/seal.js +60 -0
  701. package/plugins/compute/computers/shared/settings.d.ts +32 -5
  702. package/plugins/compute/computers/shared/settings.js +12 -0
  703. package/plugins/compute/computers/shared/wake.d.ts +43 -0
  704. package/plugins/compute/computers/shared/wake.js +80 -0
  705. package/plugins/compute/computers/shared/where.d.ts +34 -7
  706. package/plugins/compute/computers/shared/where.js +81 -11
  707. package/plugins/compute/computers/shared/workloads.d.ts +50 -0
  708. package/plugins/compute/computers/shared/workloads.js +4 -0
  709. package/plugins/compute/computers/views/context.d.ts +6 -3
  710. package/plugins/compute/computers/views/context.js +85 -6
  711. package/plugins/compute/computers/views/terminal/approvals.js +3 -1
  712. package/plugins/compute/computers/views/web/add.d.ts +41 -0
  713. package/plugins/compute/computers/views/web/add.js +60 -0
  714. package/plugins/compute/computers/views/web/allowed.d.ts +16 -0
  715. package/plugins/compute/computers/views/web/allowed.js +38 -0
  716. package/plugins/compute/computers/views/web/asked.d.ts +26 -7
  717. package/plugins/compute/computers/views/web/asked.js +47 -10
  718. package/plugins/compute/computers/views/web/asks.d.ts +10 -5
  719. package/plugins/compute/computers/views/web/asks.js +38 -13
  720. package/plugins/compute/computers/views/web/calls.js +5 -2
  721. package/plugins/compute/computers/views/web/computer.d.ts +4 -1
  722. package/plugins/compute/computers/views/web/computer.js +21 -2
  723. package/plugins/compute/computers/views/web/connect.d.ts +18 -3
  724. package/plugins/compute/computers/views/web/connect.js +52 -35
  725. package/plugins/compute/computers/views/web/desks.d.ts +19 -8
  726. package/plugins/compute/computers/views/web/desks.js +67 -37
  727. package/plugins/compute/computers/views/web/env.d.ts +32 -0
  728. package/plugins/compute/computers/views/web/env.js +154 -0
  729. package/plugins/compute/computers/views/web/environment.d.ts +23 -0
  730. package/plugins/compute/computers/views/web/environment.js +47 -0
  731. package/plugins/compute/computers/views/web/jobs.d.ts +18 -6
  732. package/plugins/compute/computers/views/web/jobs.js +56 -21
  733. package/plugins/compute/computers/views/web/kinds.d.ts +102 -0
  734. package/plugins/compute/computers/views/web/kinds.js +37 -0
  735. package/plugins/compute/computers/views/web/mark.d.ts +7 -2
  736. package/plugins/compute/computers/views/web/mark.js +2 -2
  737. package/plugins/compute/computers/views/web/names.d.ts +3 -2
  738. package/plugins/compute/computers/views/web/names.js +5 -3
  739. package/plugins/compute/computers/views/web/page.d.ts +14 -2
  740. package/plugins/compute/computers/views/web/page.js +48 -26
  741. package/plugins/compute/computers/views/web/previews.d.ts +44 -0
  742. package/plugins/compute/computers/views/web/previews.js +33 -0
  743. package/plugins/compute/computers/views/web/routine-panel.d.ts +14 -0
  744. package/plugins/compute/computers/views/web/routine-panel.js +91 -0
  745. package/plugins/compute/computers/views/web/serve.d.ts +47 -0
  746. package/plugins/compute/computers/views/web/serve.js +168 -0
  747. package/plugins/compute/computers/views/web/space-tab.d.ts +4 -3
  748. package/plugins/compute/computers/views/web/space-tab.js +39 -9
  749. package/plugins/compute/computers/views/web/step.js +7 -1
  750. package/plugins/compute/computers/views/web/style.d.ts +1 -1
  751. package/plugins/compute/computers/views/web/style.js +166 -2
  752. package/plugins/compute/computers/views/web/workspace.d.ts +16 -3
  753. package/plugins/compute/computers/views/web/workspace.js +49 -6
  754. package/plugins/compute/computers/web.d.ts +17 -4
  755. package/plugins/compute/computers/web.js +32 -5
  756. package/plugins/compute/mod.d.ts +8 -1
  757. package/plugins/compute/mod.js +8 -1
  758. package/plugins/compute/web.d.ts +13 -0
  759. package/plugins/compute/web.js +13 -0
  760. package/plugins/interfaces/api/actions/create.js +2 -3
  761. package/plugins/interfaces/api/actions/revoke.js +2 -2
  762. package/plugins/interfaces/api/collections/key.d.ts +2 -2
  763. package/plugins/interfaces/api/collections/key.js +3 -3
  764. package/plugins/interfaces/api/mod.js +2 -0
  765. package/plugins/interfaces/api/processors/left.d.ts +6 -0
  766. package/plugins/interfaces/api/processors/left.js +12 -0
  767. package/plugins/interfaces/api/shared/actor.d.ts +3 -11
  768. package/plugins/interfaces/api/shared/actor.js +1 -23
  769. package/plugins/interfaces/api/shared/events.js +7 -6
  770. package/plugins/interfaces/api/shared/rules.d.ts +3 -10
  771. package/plugins/interfaces/api/shared/rules.js +8 -24
  772. package/plugins/interfaces/api/shared/server.js +1 -1
  773. package/plugins/interfaces/api/web.js +3 -1
  774. package/plugins/interfaces/maintenance/actions/read.d.ts +4 -0
  775. package/plugins/interfaces/maintenance/actions/read.js +76 -0
  776. package/plugins/interfaces/maintenance/actions/write.d.ts +4 -0
  777. package/plugins/interfaces/maintenance/actions/write.js +64 -0
  778. package/plugins/interfaces/maintenance/contract.d.ts +60 -0
  779. package/plugins/interfaces/maintenance/contract.js +2 -0
  780. package/plugins/interfaces/maintenance/mod.d.ts +52 -0
  781. package/plugins/interfaces/maintenance/mod.js +66 -0
  782. package/plugins/interfaces/maintenance/resources/routes.d.ts +71 -0
  783. package/plugins/interfaces/maintenance/resources/routes.js +457 -0
  784. package/plugins/interfaces/maintenance/shared/ops.d.ts +4 -0
  785. package/plugins/interfaces/maintenance/shared/ops.js +19 -0
  786. package/plugins/interfaces/mcp/actions/call.d.ts +11 -0
  787. package/plugins/interfaces/mcp/actions/call.js +304 -0
  788. package/plugins/interfaces/mcp/actions/prune.d.ts +1 -0
  789. package/plugins/interfaces/mcp/actions/prune.js +18 -0
  790. package/plugins/interfaces/mcp/collections/closed.d.ts +23 -0
  791. package/plugins/interfaces/mcp/collections/closed.js +17 -0
  792. package/plugins/interfaces/mcp/collections/rate.d.ts +27 -0
  793. package/plugins/interfaces/mcp/collections/rate.js +18 -0
  794. package/plugins/interfaces/mcp/collections/receipt.d.ts +46 -0
  795. package/plugins/interfaces/mcp/collections/receipt.js +46 -0
  796. package/plugins/interfaces/mcp/contract.d.ts +9 -0
  797. package/plugins/interfaces/mcp/contract.js +9 -0
  798. package/plugins/interfaces/mcp/mod.d.ts +84 -0
  799. package/plugins/interfaces/mcp/mod.js +122 -0
  800. package/plugins/interfaces/mcp/processors/closed.d.ts +13 -0
  801. package/plugins/interfaces/mcp/processors/closed.js +16 -0
  802. package/plugins/interfaces/mcp/resources/running.d.ts +21 -0
  803. package/plugins/interfaces/mcp/resources/running.js +36 -0
  804. package/plugins/interfaces/mcp/resources/server.d.ts +54 -0
  805. package/plugins/interfaces/mcp/resources/server.js +423 -0
  806. package/plugins/interfaces/mcp/resources/tools.d.ts +114 -0
  807. package/plugins/interfaces/mcp/resources/tools.js +324 -0
  808. package/plugins/interfaces/mcp/shared/caller.d.ts +45 -0
  809. package/plugins/interfaces/mcp/shared/caller.js +99 -0
  810. package/plugins/interfaces/mcp/shared/keys.d.ts +50 -0
  811. package/plugins/interfaces/mcp/shared/keys.js +53 -0
  812. package/plugins/interfaces/mcp/shared/settings.d.ts +187 -0
  813. package/plugins/interfaces/mcp/shared/settings.js +176 -0
  814. package/plugins/interfaces/mcp/views/offered.d.ts +20 -0
  815. package/plugins/interfaces/mcp/views/offered.js +20 -0
  816. package/plugins/interfaces/mod.d.ts +5 -1
  817. package/plugins/interfaces/mod.js +5 -1
  818. package/plugins/interfaces/terminal/actions/print.js +1 -1
  819. package/plugins/interfaces/terminal/actions/set.js +1 -1
  820. package/plugins/interfaces/terminal/collections/output.d.ts +1 -1
  821. package/plugins/interfaces/terminal/collections/shell.js +1 -1
  822. package/plugins/interfaces/voice/actions/block.d.ts +2 -0
  823. package/plugins/interfaces/voice/actions/block.js +74 -0
  824. package/plugins/interfaces/voice/actions/call.d.ts +19 -0
  825. package/plugins/interfaces/voice/actions/call.js +253 -0
  826. package/plugins/interfaces/voice/actions/hook.d.ts +5 -0
  827. package/plugins/interfaces/voice/actions/hook.js +225 -0
  828. package/plugins/interfaces/voice/actions/prune.d.ts +1 -0
  829. package/plugins/interfaces/voice/actions/prune.js +35 -0
  830. package/plugins/interfaces/voice/collections/blocked.d.ts +87 -0
  831. package/plugins/interfaces/voice/collections/blocked.js +34 -0
  832. package/plugins/interfaces/voice/collections/call.d.ts +279 -0
  833. package/plugins/interfaces/voice/collections/call.js +77 -0
  834. package/plugins/interfaces/voice/collections/phone.d.ts +74 -0
  835. package/plugins/interfaces/voice/collections/phone.js +26 -0
  836. package/plugins/interfaces/voice/contract.d.ts +14 -0
  837. package/plugins/interfaces/voice/contract.js +2 -0
  838. package/plugins/interfaces/voice/mod.d.ts +57 -0
  839. package/plugins/interfaces/voice/mod.js +118 -0
  840. package/plugins/interfaces/voice/processors/forget.d.ts +13 -0
  841. package/plugins/interfaces/voice/processors/forget.js +27 -0
  842. package/plugins/interfaces/voice/resources/relay.d.ts +77 -0
  843. package/plugins/interfaces/voice/resources/relay.js +428 -0
  844. package/plugins/interfaces/voice/resources/tools.d.ts +1 -0
  845. package/plugins/interfaces/voice/resources/tools.js +25 -0
  846. package/plugins/interfaces/voice/shared/caller.d.ts +27 -0
  847. package/plugins/interfaces/voice/shared/caller.js +38 -0
  848. package/plugins/interfaces/voice/shared/settings.d.ts +136 -0
  849. package/plugins/interfaces/voice/shared/settings.js +121 -0
  850. package/plugins/interfaces/voice/shared/signature.d.ts +11 -0
  851. package/plugins/interfaces/voice/shared/signature.js +34 -0
  852. package/plugins/interfaces/voice/views/call.d.ts +41 -0
  853. package/plugins/interfaces/voice/views/call.js +30 -0
  854. package/plugins/interfaces/voice/views/context.d.ts +9 -0
  855. package/plugins/interfaces/voice/views/context.js +14 -0
  856. package/plugins/interfaces/voice/views/message.d.ts +17 -0
  857. package/plugins/interfaces/voice/views/message.js +41 -0
  858. package/plugins/interfaces/web/shared/codes.d.ts +31 -0
  859. package/plugins/interfaces/web/shared/codes.js +44 -0
  860. package/plugins/interfaces/web/shared/orgs.d.ts +1 -1
  861. package/plugins/interfaces/web/shared/orgs.js +1 -1
  862. package/plugins/interfaces/web/shared/style.d.ts +1 -1
  863. package/plugins/interfaces/web/shared/style.js +3 -0
  864. package/plugins/interfaces/web/views/console-codes.d.ts +14 -0
  865. package/plugins/interfaces/web/views/console-codes.js +159 -0
  866. package/plugins/interfaces/web/views/console.d.ts +4 -2
  867. package/plugins/interfaces/web/views/console.js +24 -10
  868. package/plugins/interfaces/web/views/org.js +12 -6
  869. package/plugins/interfaces/web/views/orgs.js +13 -3
  870. package/plugins/interfaces/whatsapp/actions/connect.js +11 -10
  871. package/plugins/interfaces/whatsapp/actions/disconnect.js +6 -3
  872. package/plugins/interfaces/whatsapp/actions/hook.js +27 -11
  873. package/plugins/interfaces/whatsapp/actions/link.js +10 -13
  874. package/plugins/interfaces/whatsapp/actions/set.d.ts +8 -0
  875. package/plugins/interfaces/whatsapp/actions/set.js +121 -0
  876. package/plugins/interfaces/whatsapp/collections/blocked.d.ts +29 -0
  877. package/plugins/interfaces/whatsapp/collections/blocked.js +22 -0
  878. package/plugins/interfaces/whatsapp/collections/code.d.ts +1 -1
  879. package/plugins/interfaces/whatsapp/collections/number.d.ts +90 -4
  880. package/plugins/interfaces/whatsapp/collections/number.js +36 -4
  881. package/plugins/interfaces/whatsapp/collections/phone.d.ts +14 -4
  882. package/plugins/interfaces/whatsapp/collections/phone.js +9 -3
  883. package/plugins/interfaces/whatsapp/collections/rate.d.ts +27 -0
  884. package/plugins/interfaces/whatsapp/collections/rate.js +13 -0
  885. package/plugins/interfaces/whatsapp/collections/sent.d.ts +24 -12
  886. package/plugins/interfaces/whatsapp/collections/sent.js +11 -7
  887. package/plugins/interfaces/whatsapp/collections/thread.d.ts +14 -6
  888. package/plugins/interfaces/whatsapp/collections/thread.js +7 -5
  889. package/plugins/interfaces/whatsapp/collections/typing.d.ts +70 -0
  890. package/plugins/interfaces/whatsapp/collections/typing.js +21 -0
  891. package/plugins/interfaces/whatsapp/contract.d.ts +27 -4
  892. package/plugins/interfaces/whatsapp/contract.js +34 -1
  893. package/plugins/interfaces/whatsapp/events/undelivered.d.ts +8 -0
  894. package/plugins/interfaces/whatsapp/events/undelivered.js +17 -0
  895. package/plugins/interfaces/whatsapp/mod.d.ts +28 -2
  896. package/plugins/interfaces/whatsapp/mod.js +65 -6
  897. package/plugins/interfaces/whatsapp/processors/forget.d.ts +6 -0
  898. package/plugins/interfaces/whatsapp/processors/forget.js +11 -0
  899. package/plugins/interfaces/whatsapp/processors/receive.d.ts +17 -3
  900. package/plugins/interfaces/whatsapp/processors/receive.js +267 -91
  901. package/plugins/interfaces/whatsapp/processors/reply.d.ts +25 -5
  902. package/plugins/interfaces/whatsapp/processors/reply.js +216 -20
  903. package/plugins/interfaces/whatsapp/processors/typing.d.ts +8 -0
  904. package/plugins/interfaces/whatsapp/processors/typing.js +25 -0
  905. package/plugins/interfaces/whatsapp/shared/customers.d.ts +13 -0
  906. package/plugins/interfaces/whatsapp/shared/customers.js +16 -0
  907. package/plugins/interfaces/whatsapp/shared/graph.d.ts +31 -6
  908. package/plugins/interfaces/whatsapp/shared/graph.js +117 -10
  909. package/plugins/interfaces/whatsapp/shared/media.d.ts +23 -0
  910. package/plugins/interfaces/whatsapp/shared/media.js +46 -0
  911. package/plugins/interfaces/whatsapp/shared/number.d.ts +19 -8
  912. package/plugins/interfaces/whatsapp/shared/number.js +64 -7
  913. package/plugins/interfaces/whatsapp/shared/parts.d.ts +94 -0
  914. package/plugins/interfaces/whatsapp/shared/parts.js +184 -0
  915. package/plugins/interfaces/whatsapp/shared/payload.d.ts +27 -1
  916. package/plugins/interfaces/whatsapp/shared/payload.js +36 -1
  917. package/plugins/interfaces/whatsapp/shared/rules.d.ts +1 -3
  918. package/plugins/interfaces/whatsapp/shared/rules.js +1 -9
  919. package/plugins/interfaces/whatsapp/shared/settings.d.ts +49 -1
  920. package/plugins/interfaces/whatsapp/shared/settings.js +11 -0
  921. package/plugins/interfaces/whatsapp/views/message.d.ts +13 -0
  922. package/plugins/interfaces/whatsapp/views/message.js +13 -0
  923. package/plugins/interfaces/whatsapp/views/web/line.d.ts +24 -0
  924. package/plugins/interfaces/whatsapp/views/web/line.js +44 -0
  925. package/plugins/interfaces/whatsapp/views/web/space.d.ts +7 -5
  926. package/plugins/interfaces/whatsapp/views/web/space.js +17 -10
  927. package/plugins/interfaces/whatsapp/views/web/style.d.ts +1 -1
  928. package/plugins/interfaces/whatsapp/views/web/style.js +8 -0
  929. package/plugins/interfaces/whatsapp/web.js +8 -1
  930. package/plugins/models/actions/check.d.ts +1 -0
  931. package/plugins/models/actions/check.js +25 -0
  932. package/plugins/models/actions/offered.d.ts +34 -0
  933. package/plugins/models/actions/offered.js +186 -0
  934. package/plugins/models/adapters/llm/anthropic.d.ts +1 -1
  935. package/plugins/models/adapters/llm/anthropic.js +38 -20
  936. package/plugins/models/adapters/llm/gemini.d.ts +1 -1
  937. package/plugins/models/adapters/llm/gemini.js +7 -2
  938. package/plugins/models/adapters/llm/openai-compatible.d.ts +1 -1
  939. package/plugins/models/adapters/llm/openai-compatible.js +36 -7
  940. package/plugins/models/adapters/llm/openai.d.ts +1 -1
  941. package/plugins/models/adapters/llm/openai.js +158 -28
  942. package/plugins/models/contract.d.ts +6 -1
  943. package/plugins/models/mod.d.ts +7 -1
  944. package/plugins/models/mod.js +12 -2
  945. package/plugins/models/shared/catalog.json +9208 -8909
  946. package/plugins/models/shared/choice.d.ts +31 -0
  947. package/plugins/models/shared/choice.js +19 -3
  948. package/plugins/models/shared/generate.d.ts +3 -1
  949. package/plugins/models/shared/generate.js +91 -11
  950. package/plugins/models/shared/provider.d.ts +5 -0
  951. package/plugins/models/shared/provider.js +14 -0
  952. package/plugins/models/shared/types.d.ts +21 -2
  953. package/plugins/models/shared/types.js +10 -0
  954. package/plugins/models/shared/use.d.ts +6 -2
  955. package/plugins/models/shared/use.js +15 -5
  956. package/runtime/actor.d.ts +15 -0
  957. package/runtime/actor.js +14 -0
  958. package/runtime/aggregate.js +8 -2
  959. package/runtime/blobs.d.ts +15 -12
  960. package/runtime/blobs.js +58 -11
  961. package/runtime/cache.d.ts +6 -0
  962. package/runtime/cache.js +19 -1
  963. package/runtime/client.js +28 -5
  964. package/runtime/define.d.ts +10 -0
  965. package/runtime/errors.d.ts +36 -0
  966. package/runtime/errors.js +13 -0
  967. package/runtime/executor.js +29 -13
  968. package/runtime/links.d.ts +31 -0
  969. package/runtime/links.js +60 -0
  970. package/runtime/maintain.d.ts +88 -0
  971. package/runtime/maintain.js +120 -0
  972. package/runtime/memory.js +7 -4
  973. package/runtime/mod.d.ts +6 -2
  974. package/runtime/mod.js +5 -0
  975. package/runtime/mongo.d.ts +13 -0
  976. package/runtime/mongo.js +39 -8
  977. package/runtime/observe.d.ts +2 -0
  978. package/runtime/observe.js +14 -10
  979. package/runtime/ops.d.ts +5 -0
  980. package/runtime/ops.js +10 -1
  981. package/runtime/owner.d.ts +31 -2
  982. package/runtime/owner.js +159 -59
  983. package/runtime/presence.d.ts +18 -0
  984. package/runtime/presence.js +25 -0
  985. package/runtime/registry.d.ts +5 -0
  986. package/runtime/registry.js +18 -0
  987. package/runtime/runtime.js +9 -3
  988. package/runtime/store.d.ts +48 -1
  989. package/runtime/wire.d.ts +1 -0
  990. package/runtime/wire.js +3 -1
  991. package/stores/blobs/files/mod.js +4 -2
  992. package/stores/blobs/gcs/mod.d.ts +30 -0
  993. package/stores/blobs/gcs/mod.js +106 -0
  994. package/stores/blobs/http/mod.d.ts +1 -1
  995. package/stores/blobs/http/mod.js +2 -1
  996. package/stores/latency/mod.js +5 -1
  997. package/stores/sql/postgres/maintenance.d.ts +24 -0
  998. package/stores/sql/postgres/maintenance.js +258 -0
  999. package/stores/sql/postgres/mod.d.ts +20 -4
  1000. package/stores/sql/postgres/mod.js +363 -96
  1001. package/stores/sql/postgres/update.js +3 -1
  1002. package/stores/sql/shared/capped.d.ts +2 -0
  1003. package/stores/sql/shared/capped.js +22 -0
  1004. package/stores/sql/shared/rows.d.ts +14 -0
  1005. package/stores/sql/shared/rows.js +29 -0
  1006. package/stores/sql/shared/statement.d.ts +12 -0
  1007. package/stores/sql/shared/statement.js +244 -0
  1008. package/stores/sql/sqlite/apart.d.ts +11 -0
  1009. package/stores/sql/sqlite/apart.js +219 -0
  1010. package/stores/sql/sqlite/mod.d.ts +16 -2
  1011. package/stores/sql/sqlite/mod.js +246 -51
  1012. package/testing/mod.js +1 -1
  1013. package/plugins/compute/computers/shared/person.d.ts +0 -3
  1014. package/plugins/compute/computers/shared/person.js +0 -8
@@ -16,6 +16,14 @@ export type Cost = Prices & {
16
16
  };
17
17
  /** What the catalog knows about a model. */
18
18
  export type ModelInfo = {
19
+ /** What people call it, and when it came out (`2026-09-22`). */
20
+ name?: string;
21
+ released?: string;
22
+ /** False: it can't call tools. */
23
+ tools?: false;
24
+ /** False: it answers in something other than text (an embedder, an image model). */
25
+ chat?: false;
26
+ deprecated?: true;
19
27
  /** Its protocol and URL, where they differ from its provider's. */
20
28
  protocol?: string;
21
29
  api?: string;
@@ -42,6 +50,7 @@ export type Catalog = {
42
50
  fetched: string;
43
51
  etag: string;
44
52
  providers: Record<string, {
53
+ name?: string;
45
54
  protocol?: string;
46
55
  api?: string;
47
56
  models: Record<string, ModelInfo>;
@@ -53,6 +62,9 @@ export declare const catalog: Catalog;
53
62
  * knows: `deepseek: { apiKey }` is enough.
54
63
  */
55
64
  export type Provider = Endpoint & {
65
+ /** What people call it, where the catalog doesn't say; what to know before choosing it. */
66
+ title?: string;
67
+ note?: string;
56
68
  /** The protocol it speaks, which names each port's adapter: `openai`, `openai-compatible`, `anthropic`, `gemini`, or a plugin's own. */
57
69
  adapter?: string;
58
70
  /** The catalog provider its models are looked up in (default: its own name); false for none. */
@@ -100,6 +112,25 @@ export type Resolved = {
100
112
  tags?: Record<string, string>;
101
113
  };
102
114
  type Resources = Record<string, Record<string, unknown> | undefined>;
115
+ /**
116
+ * Where an org's own keys for providers are kept (the `modelKeys` resource:
117
+ * Actions of another plugin). With it, every provider someone can bring a key
118
+ * for can be chosen, declared or not, and its key is used on each call.
119
+ */
120
+ export type ModelKeys = {
121
+ /** `{ provider }` → the org's key, or null. Trusted code only. */
122
+ open: string;
123
+ /** `{}` → `{ provider, hint }[]`, what's kept, nothing secret. Trusted code only. */
124
+ list: string;
125
+ /** `{}` → `{ set }`: whether the person asking may change them. */
126
+ may: string;
127
+ };
128
+ /**
129
+ * Whether someone can bring a key for this catalog provider. It needs a
130
+ * protocol we speak, and an address of its own: without one, its adapter's
131
+ * default would send the key to someone else.
132
+ */
133
+ export declare function keyable(provider: string): boolean;
103
134
  /** Looks a model up in the catalog: `"provider/model"`. */
104
135
  export declare function lookup(id: string): ModelInfo | undefined;
105
136
  /**
@@ -12,8 +12,23 @@
12
12
  * cost, how its reasoning is controlled and its limits.
13
13
  */
14
14
  import catalogJson from "./catalog.json" with { type: "json" };
15
+ import { invalid } from "../../../runtime/mod.js";
15
16
  export const catalog = catalogJson;
16
- const invalid = (message) => Object.assign(new Error(message), { code: "invalid" });
17
+ /** The protocols a key can be brought for: those of the adapters every app has. */
18
+ const KEYED = ["openai", "openai-compatible", "anthropic", "gemini"];
19
+ /** Providers whose adapter has their address built in. */
20
+ const BUILT_IN = ["openai", "anthropic", "google"];
21
+ /**
22
+ * Whether someone can bring a key for this catalog provider. It needs a
23
+ * protocol we speak, and an address of its own: without one, its adapter's
24
+ * default would send the key to someone else.
25
+ */
26
+ export function keyable(provider) {
27
+ if (!Object.hasOwn(catalog.providers, provider))
28
+ return false;
29
+ const { protocol, api } = catalog.providers[provider];
30
+ return !!protocol && KEYED.includes(protocol) && (!!api || BUILT_IN.includes(provider));
31
+ }
17
32
  /** Inner settings over outer ones; `options` merge. */
18
33
  const over = (outer, inner) => {
19
34
  const merged = { ...outer, ...inner };
@@ -62,11 +77,12 @@ export function resolve(resources, ref) {
62
77
  const slash = id.indexOf("/");
63
78
  const provider = id.slice(0, slash);
64
79
  const model = id.slice(slash + 1);
65
- const declared = resources.provider?.[provider];
80
+ const declared = resources.provider?.[provider] ??
81
+ (resources.modelKeys && keyable(provider) ? {} : undefined);
66
82
  if (!declared) {
67
83
  throw invalid(`No provider "${provider}" for "${id}": declare resources.provider.${provider}`);
68
84
  }
69
- const { adapter, catalog: from, options, tags, ...endpoint } = declared;
85
+ const { adapter, catalog: from, options, tags, title: _t, note: _n, ...endpoint } = declared;
70
86
  const listed = from === false ? undefined : catalog.providers[from ?? provider];
71
87
  const entry = typeof settings.catalog === "string"
72
88
  ? settings.catalog
@@ -7,6 +7,7 @@ import { type LlmChunk, type LlmMessage, type LlmState, type LlmTool, type ToolC
7
7
  * provider's `headers` hear it), and (to meter it) where to record.
8
8
  */
9
9
  type Reach = Pick<Context, "resources" | "adapters" | "signal"> & {
10
+ as?: Context["as"];
10
11
  actor?: Actor;
11
12
  call?: ReadContext["call"];
12
13
  record?: Context["record"];
@@ -40,7 +41,8 @@ export declare function chooseModels(ctx: Pick<Context, "resources" | "adapters"
40
41
  * and when it tries next. With a list, a model that fails before writing
41
42
  * anything hands over to the next at once (the last one is tried again). A provider's thinking goes back to any of
42
43
  * its models; if one refuses another model's, the call is made again with
43
- * its own only.
44
+ * its own only. A model the org can't spend on hands over too, to one it can
45
+ * (its own key, a person's plan); with none, that's what it's told.
44
46
  */
45
47
  export declare function generate(ctx: Reach, request: Generate): AsyncGenerator<LlmChunk>;
46
48
  /** The whole answer at once. `onText` hears the text as it streams (again, after a retry). */
@@ -1,11 +1,11 @@
1
- import { adapterFor, resolve, } from "./choice.js";
1
+ import { failure, invalid } from "../../../runtime/mod.js";
2
+ import { adapterFor, keyable, resolve, } from "./choice.js";
2
3
  import { filesFor } from "./files.js";
3
4
  import { calledBy } from "./provider.js";
4
5
  import { backoff, quietly, RETRY, SILENCE, transient, wait } from "./retry.js";
5
6
  import { used } from "./use.js";
6
7
  import { measure } from "./telemetry.js";
7
8
  import { EFFORTS, } from "./types.js";
8
- const invalid = (message) => Object.assign(new Error(message), { code: "invalid" });
9
9
  /** Throws when a model can't take its settings: an effort it has no level for. */
10
10
  function checkSettings(m) {
11
11
  const { effort } = m.settings;
@@ -44,17 +44,66 @@ export function chooseModels(ctx, model) {
44
44
  const providerOf = (id) => id.slice(0, id.indexOf("/"));
45
45
  /**
46
46
  * State goes back to models of the provider that wrote it (`same`: only to
47
- * the model itself); another provider's is left out.
47
+ * the model itself; `none`: to nobody); another provider's is left out.
48
48
  */
49
49
  const stateFor = (id, same) => (message) => {
50
50
  const by = message.role === "assistant" ? message.state?.by : undefined;
51
- if (!by || (same === "model" ? by === id : providerOf(by) === providerOf(id)))
51
+ if (!by && (same !== "none" || message.role !== "assistant" || !message.state))
52
52
  return message;
53
+ if (by && same !== "none" && (same === "model" ? by === id : providerOf(by) === providerOf(id))) {
54
+ return message;
55
+ }
53
56
  const { state: _, ...rest } = message;
54
57
  return rest;
55
58
  };
56
59
  /** A provider refusing the request as given: worth one try without another model's state. */
57
60
  const refused = (error) => error.status === 400;
61
+ /**
62
+ * A refusal of the state it was sent (thinking bound to a conversation that
63
+ * has changed since: summarized, its instructions edited): worth one more try
64
+ * without any.
65
+ */
66
+ const stale = (error) => refused(error) &&
67
+ /thinking|signature|reasoning|encrypted|bound to a different/i.test(String(error.message));
68
+ /**
69
+ * A model with its org's own key for its provider, which goes before the
70
+ * app's. A provider only an org's key reaches, without one, is told so.
71
+ */
72
+ async function keyed(ctx, m) {
73
+ const keys = ctx.resources.modelKeys;
74
+ if (!keys || !keyable(m.provider))
75
+ return m;
76
+ // From a read there's no system to ask as, and so no key: only the app's.
77
+ const key = ctx.as
78
+ ? await ctx.as().call(keys.open, { provider: m.provider })
79
+ : null;
80
+ if (key) {
81
+ return {
82
+ ...m,
83
+ endpoint: { ...m.endpoint, apiKey: key },
84
+ tags: { ...m.tags, paid: "own-key" },
85
+ };
86
+ }
87
+ if (m.endpoint.apiKey || m.endpoint.headers)
88
+ return m;
89
+ throw failure("key_missing", `There's no key for ${m.provider}: this org's admins can add one.`);
90
+ }
91
+ /**
92
+ * Whether what's about to run may spend (the `spending` resource: whoever
93
+ * keeps an org's limits). Not asked from a read, for a model the app doesn't
94
+ * pay for (the org's own key, a person's subscription). Saying no is final:
95
+ * trying again won't help.
96
+ */
97
+ async function mayRun(ctx, m, request) {
98
+ const spending = ctx.resources.spending;
99
+ if (!spending?.check || !ctx.as || m.tags?.paid)
100
+ return;
101
+ const purpose = request.tags?.purpose;
102
+ const verdict = await ctx.as().call(spending.check, purpose ? { purpose } : {});
103
+ if (verdict.ok)
104
+ return;
105
+ throw Object.assign(failure(verdict.why ?? "spending", verdict.message ?? "This org can't spend right now."), { final: true });
106
+ }
58
107
  /**
59
108
  * Streams a model's answer: text, tool calls, state and usage, as they come.
60
109
  * A call that breaks (the network, nothing coming for the provider's
@@ -63,11 +112,26 @@ const refused = (error) => error.status === 400;
63
112
  * and when it tries next. With a list, a model that fails before writing
64
113
  * anything hands over to the next at once (the last one is tried again). A provider's thinking goes back to any of
65
114
  * its models; if one refuses another model's, the call is made again with
66
- * its own only.
115
+ * its own only. A model the org can't spend on hands over too, to one it can
116
+ * (its own key, a person's plan); with none, that's what it's told.
67
117
  */
68
118
  export async function* generate(ctx, request) {
69
119
  const choices = chooseModels(ctx, request.model);
70
- for (const [i, m] of choices.entries()) {
120
+ let stopped;
121
+ for (const [i, choice] of choices.entries()) {
122
+ let m;
123
+ try {
124
+ m = await keyed(ctx, choice);
125
+ await mayRun(ctx, m, request);
126
+ }
127
+ catch (error) {
128
+ if (error.final)
129
+ stopped ??= error;
130
+ // No key for this one, or no credits: the next, if there is one.
131
+ if (i === choices.length - 1)
132
+ throw stopped ?? error;
133
+ continue;
134
+ }
71
135
  const adapter = adapterFor(ctx.adapters, "llm", m);
72
136
  const { effort, maxTokens, temperature, options } = m.settings;
73
137
  // What this model reads besides text, that its adapter can send.
@@ -79,7 +143,13 @@ export async function* generate(ctx, request) {
79
143
  // A broken call is tried again, waiting longer each time, until `retry` ms have gone by.
80
144
  const { silence = SILENCE, retry = RETRY } = m.endpoint;
81
145
  const until = Date.now() + retry;
82
- const sames = borrowed ? ["provider", "model"] : ["model"];
146
+ const stated = request.messages.some((message) => message.role === "assistant" && message.state);
147
+ // Its state as it can go, then, refused, without another's, then without any.
148
+ const sames = [
149
+ ...(borrowed ? ["provider"] : []),
150
+ "model",
151
+ ...(stated ? ["none"] : []),
152
+ ];
83
153
  for (let s = 0, attempt = 0;;) {
84
154
  const same = sames[s];
85
155
  const call = measure(ctx.metrics, m, "chat");
@@ -98,7 +168,11 @@ export async function* generate(ctx, request) {
98
168
  signal: AbortSignal.any([ctx.signal, quiet.signal]),
99
169
  }), silence, quiet)) {
100
170
  if (chunk.type === "state") {
101
- yield { type: "state", state: { by: m.id, data: chunk.state.data } };
171
+ const { tokens } = chunk.state;
172
+ yield {
173
+ type: "state",
174
+ state: { by: m.id, data: chunk.state.data, ...(tokens ? { tokens } : {}) },
175
+ };
102
176
  }
103
177
  else if (chunk.type === "usage") {
104
178
  const { type: _, model: __, ...quantities } = chunk;
@@ -113,6 +187,10 @@ export async function* generate(ctx, request) {
113
187
  });
114
188
  yield { ...chunk, model: m.id };
115
189
  }
190
+ else if (chunk.type === "thinking") {
191
+ // At work, nothing written yet: the silence it ends isn't a dropped call.
192
+ yield chunk;
193
+ }
116
194
  else {
117
195
  wrote = true;
118
196
  call.first();
@@ -142,12 +220,14 @@ export async function* generate(ctx, request) {
142
220
  const out = transient(error) ? Object.assign(error, { final: true }) : error;
143
221
  if (wrote)
144
222
  throw out;
145
- if (same === "provider" && refused(error) && s + 1 < sames.length) {
223
+ const next = sames[s + 1];
224
+ if (next && (next === "model" ? refused(error) : stale(error))) {
146
225
  s++;
147
226
  continue;
148
227
  }
228
+ // The last one failed, having been stopped earlier: that's what to tell them.
149
229
  if (i === choices.length - 1)
150
- throw out;
230
+ throw stopped ?? out;
151
231
  break;
152
232
  }
153
233
  }
@@ -171,7 +251,7 @@ export async function complete(ctx, request, onText) {
171
251
  answer.toolCalls = [];
172
252
  delete answer.state;
173
253
  }
174
- else {
254
+ else if (chunk.type === "usage") {
175
255
  const { type: _, ...usage } = chunk;
176
256
  answer.usage = usage;
177
257
  }
@@ -53,6 +53,11 @@ export type Defaults = {
53
53
  /** POSTs to the provider; JSON bodies are encoded, other bodies are sent as they are. */
54
54
  export declare function post(endpoint: Endpoint, defaults: Defaults, path: string, body: unknown, signal?: AbortSignal): Promise<Response>;
55
55
  /** Server-sent events: each event's name (if any) and its data. */
56
+ /**
57
+ * Whether to say a stream is alive now (a `thinking` chunk): at most once
58
+ * every `ms`, however often its provider sends. Asked on each event.
59
+ */
60
+ export declare function alive(ms?: number): () => boolean;
56
61
  export declare function sse(body: ReadableStream<Uint8Array>): AsyncGenerator<{
57
62
  event?: string;
58
63
  data: string;
@@ -37,6 +37,20 @@ export async function post(endpoint, defaults, path, body, signal) {
37
37
  return response;
38
38
  }
39
39
  /** Server-sent events: each event's name (if any) and its data. */
40
+ /**
41
+ * Whether to say a stream is alive now (a `thinking` chunk): at most once
42
+ * every `ms`, however often its provider sends. Asked on each event.
43
+ */
44
+ export function alive(ms = 1_000) {
45
+ let last = 0;
46
+ return () => {
47
+ const now = Date.now();
48
+ if (now - last < ms)
49
+ return false;
50
+ last = now;
51
+ return true;
52
+ };
53
+ }
40
54
  export async function* sse(body) {
41
55
  let buffer = "";
42
56
  let event;
@@ -10,13 +10,16 @@ export type ToolCall = {
10
10
  };
11
11
  /**
12
12
  * What a provider needs back with its own answer in the next calls, opaque to
13
- * everyone else: Anthropic's signed thinking, Gemini's thought signatures.
13
+ * everyone else: Anthropic's signed thinking, Gemini's thought signatures,
14
+ * OpenAI's encrypted reasoning.
14
15
  * `by` is the model that wrote it (`"provider/model"`); it goes back to that
15
- * model only.
16
+ * model only. `tokens`: about what it adds to a prompt it goes back in, when
17
+ * its adapter knows (what budgets a prompt counts it as).
16
18
  */
17
19
  export type LlmState = {
18
20
  by?: string;
19
21
  data: unknown;
22
+ tokens?: number;
20
23
  };
21
24
  /**
22
25
  * A file given with a message: its name, media type and content (base64). A
@@ -50,6 +53,14 @@ export type LlmMessage = {
50
53
  text: string;
51
54
  cache?: true;
52
55
  };
56
+ /**
57
+ * A call asks for the model's next message, never for the rest of its last
58
+ * one: a conversation that ends with the model's own message goes with a
59
+ * user turn after it. Anthropic's newer models refuse an assistant message
60
+ * last ("prefill"), Gemini and some servers would carry it on; every adapter
61
+ * sends this, so every provider reads the same.
62
+ */
63
+ export declare const answerable: (messages: LlmMessage[]) => LlmMessage[];
53
64
  export type LlmTool = {
54
65
  name: string;
55
66
  description: string;
@@ -69,6 +80,14 @@ export type LlmChunk = {
69
80
  type: "usage";
70
81
  model?: string;
71
82
  } & Usage)
83
+ /**
84
+ * The model is at work with nothing to show yet (thinking, before it
85
+ * writes): its stream is alive, though silent. Adapters send it at most
86
+ * about once a second while their provider's stream goes on.
87
+ */
88
+ | {
89
+ type: "thinking";
90
+ }
72
91
  /**
73
92
  * The call broke (the network, a silent stream, the provider busy): what it
74
93
  * sent so far is void, and it's tried again in `wait` ms (its `attempt`th
@@ -1 +1,11 @@
1
+ /**
2
+ * A call asks for the model's next message, never for the rest of its last
3
+ * one: a conversation that ends with the model's own message goes with a
4
+ * user turn after it. Anthropic's newer models refuse an assistant message
5
+ * last ("prefill"), Gemini and some servers would carry it on; every adapter
6
+ * sends this, so every provider reads the same.
7
+ */
8
+ export const answerable = (messages) => messages.at(-1)?.role === "assistant"
9
+ ? [...messages, { role: "user", text: "Continue." }]
10
+ : messages;
1
11
  export const EFFORTS = ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
@@ -35,5 +35,9 @@ export type UseContext = Pick<Context, "resources"> & {
35
35
  export type UseListener = {
36
36
  used(ctx: UseContext, use: ModelUse): void | Promise<void>;
37
37
  };
38
- /** Tells every `modelUse` listener about a use. Nobody listening: nothing happens. */
39
- export declare function used(ctx: UseContext, use: ModelUse): void;
38
+ /**
39
+ * Tells every `modelUse` listener about a use, and waits for them: what one
40
+ * records has to go with the job that made the call, and a job's last write
41
+ * can be close behind. One that fails is logged; the call goes on.
42
+ */
43
+ export declare function used(ctx: UseContext, use: ModelUse): Promise<void>;
@@ -1,6 +1,16 @@
1
- /** Tells every `modelUse` listener about a use. Nobody listening: nothing happens. */
2
- export function used(ctx, use) {
3
- for (const listener of Object.values((ctx.resources.modelUse ?? {}))) {
4
- listener.used(ctx, use);
5
- }
1
+ /**
2
+ * Tells every `modelUse` listener about a use, and waits for them: what one
3
+ * records has to go with the job that made the call, and a job's last write
4
+ * can be close behind. One that fails is logged; the call goes on.
5
+ */
6
+ export async function used(ctx, use) {
7
+ const listeners = Object.values((ctx.resources.modelUse ?? {}));
8
+ await Promise.all(listeners.map(async (listener) => {
9
+ try {
10
+ await listener.used(ctx, use);
11
+ }
12
+ catch (error) {
13
+ console.error(`models: a listener failed on ${use.subject}:`, error instanceof Error ? error.message : error);
14
+ }
15
+ }));
6
16
  }
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Who an actor's work is for. An actor is someone (a person, a key's person,
3
+ * a contact), an agent working for someone (`for`), or trusted code acting
4
+ * for whoever called it (`via`, set by `ctx.as`). Everyone who needs the person
5
+ * behind an actor asks here.
6
+ *
7
+ * A contact is someone outside the org who talks to an app's agents (a
8
+ * WhatsApp customer): `{ kind: "contact", id }`. Work can be for them, but
9
+ * they are never a person: nothing that checks a person sees one.
10
+ */
11
+ import type { Actor } from "./store.js";
12
+ /** Whom work is for: the person or the contact found along `for`, then `via`, as they act. */
13
+ export declare function principalOf(actor: Actor | undefined): Actor | undefined;
14
+ /** The person whose work this is: the one acting, or the one found along `for`, then `via`. */
15
+ export declare function personOf(actor: Actor | undefined): string | undefined;
@@ -0,0 +1,14 @@
1
+ /** Whom work is for: the person or the contact found along `for`, then `via`, as they act. */
2
+ export function principalOf(actor) {
3
+ for (let a = actor, hops = 0; a && hops < 4; hops++) {
4
+ if (a.kind === "person" || a.kind === "contact")
5
+ return a;
6
+ a = (a.for ?? a.via);
7
+ }
8
+ return undefined;
9
+ }
10
+ /** The person whose work this is: the one acting, or the one found along `for`, then `via`. */
11
+ export function personOf(actor) {
12
+ const principal = principalOf(actor);
13
+ return principal?.kind === "person" ? principal.id : undefined;
14
+ }
@@ -14,7 +14,7 @@
14
14
  * strings, as MongoDB orders them; other types are left out).
15
15
  * - Groups come out ordered by `_id`, unless `$sort` says otherwise.
16
16
  */
17
- import { get, matches, sortAndPage } from "./mongo.js";
17
+ import { checkName, get, matches, sortAndPage } from "./mongo.js";
18
18
  import { check } from "./mongo.js";
19
19
  const invalid = (message) => Object.assign(new Error(message), { code: "invalid" });
20
20
  const isField = (expr) => typeof expr === "string" && expr.startsWith("$");
@@ -51,10 +51,16 @@ export function plan(pipeline) {
51
51
  const { _id, ...rest } = (arg ?? {});
52
52
  if (!("_id" in arg))
53
53
  throw invalid("$group needs an _id (null for one group)");
54
+ // The fields it names, it makes: never a `$…` one (a blob reference's `$blob`, say).
55
+ const named = ([k, e]) => {
56
+ checkName(k, `_id.${k}`);
57
+ return [k, checkExpr(e)];
58
+ };
54
59
  const key = _id !== null && typeof _id === "object" && !("$substr" in _id)
55
- ? { fields: Object.entries(_id).map(([k, e]) => [k, checkExpr(e)]) }
60
+ ? { fields: Object.entries(_id).map(named) }
56
61
  : { expr: checkExpr(_id) };
57
62
  const fields = Object.entries(rest).map(([field, acc]) => {
63
+ checkName(field);
58
64
  const [op, ...more] = Object.keys(acc ?? {});
59
65
  if (!OPERATORS.has(op) || more.length) {
60
66
  throw invalid(`Unsupported accumulator for "${field}": $sum, $count, $avg, $min, $max`);
@@ -1,11 +1,3 @@
1
- /**
2
- * Large values live once, as blobs named by the hash of their content. A
3
- * document or event holds a small reference in their place:
4
- * `{ $blob: "sha256-…", size, type }`. The owner moves large values out on
5
- * write and back in on read, so plugin code never sees a reference, and the
6
- * same content written twice (a document and its event, or two equal tool
7
- * results) is stored once.
8
- */
9
1
  export type BlobRef = {
10
2
  $blob: string;
11
3
  size: number;
@@ -13,7 +5,8 @@ export type BlobRef = {
13
5
  };
14
6
  /**
15
7
  * Where blobs live when not in the store itself (a directory, a bucket).
16
- * Content-addressed: putting an id that exists is a no-op.
8
+ * Content-addressed: putting an id that exists is a no-op. An id is only ever
9
+ * a blob's: refuse any other (`checkBlobId`) before it becomes a path or a name.
17
10
  */
18
11
  export type Blobs = {
19
12
  put(blob: {
@@ -28,15 +21,25 @@ export type Blobs = {
28
21
  };
29
22
  /** Strings larger than this many UTF-8 bytes become blobs (default 16 KiB). */
30
23
  export declare const BLOB_THRESHOLD: number;
24
+ export declare const isBlobId: (id: unknown) => id is string;
25
+ /** The id, when it is a blob's; else `invalid`. Stores check it before they look anything up. */
26
+ export declare function checkBlobId(id: unknown): string;
27
+ /** Exactly what `offload` makes: these three keys, a blob id, a numeric size and a type. */
31
28
  export declare const isBlobRef: (value: unknown) => value is BlobRef;
32
29
  export declare function blobId(data: Uint8Array): Promise<string>;
33
- /** Replaces strings over the threshold with blob references, storing each with `put`. */
30
+ /** Refuses (`invalid`) a value of plugin code's that holds an object with a `$blob` key. */
31
+ export declare function refuseBlobKeys(value: unknown): void;
32
+ /**
33
+ * Replaces strings over the threshold with blob references, storing each with `put`.
34
+ * `foreign`: the value is plugin code's, and may hold no `$blob` key (see
35
+ * `large`); otherwise it's the owner's, and its references stay as they are.
36
+ */
34
37
  export declare function offload<T>(value: T, put: (blob: {
35
38
  id: string;
36
39
  data: Uint8Array;
37
40
  type: string;
38
- }) => Promise<void>, threshold?: number): Promise<T>;
39
- /** Replaces blob references with their content. */
41
+ }) => Promise<void>, threshold?: number, foreign?: boolean): Promise<T>;
42
+ /** Replaces blob references with their content; one whose blob is gone fails (`missing_blob`). */
40
43
  export declare function hydrate<T>(value: T, get: (id: string) => Promise<{
41
44
  data: Uint8Array;
42
45
  } | null>): Promise<T>;
package/runtime/blobs.js CHANGED
@@ -5,25 +5,67 @@
5
5
  * write and back in on read, so plugin code never sees a reference, and the
6
6
  * same content written twice (a document and its event, or two equal tool
7
7
  * results) is stored once.
8
+ *
9
+ * Only the owner makes references. What plugin code writes (documents,
10
+ * updates, edges, events) and what Actions are called with may hold no
11
+ * `$blob` key at all: one there is forged, and refused. On read, only an
12
+ * exact reference is loaded (see `isBlobRef`); anything else is data.
8
13
  */
14
+ import { invalid } from "./errors.js";
9
15
  /** Strings larger than this many UTF-8 bytes become blobs (default 16 KiB). */
10
16
  export const BLOB_THRESHOLD = 16 * 1024;
11
17
  const TEXT = "text/plain; charset=utf-8";
12
18
  const encoder = new TextEncoder();
13
19
  const decoder = new TextDecoder();
14
- export const isBlobRef = (value) => typeof value === "object" && value !== null && typeof value.$blob === "string";
20
+ /** A blob's id: `sha256-` and the hex of its content's hash. Never a path or a name. */
21
+ const ID = /^sha256-[0-9a-f]{64}$/;
22
+ export const isBlobId = (id) => typeof id === "string" && ID.test(id);
23
+ /** The id, when it is a blob's; else `invalid`. Stores check it before they look anything up. */
24
+ export function checkBlobId(id) {
25
+ if (isBlobId(id))
26
+ return id;
27
+ throw invalid(`Not a blob id: ${JSON.stringify(String(id).slice(0, 80))}`);
28
+ }
29
+ /** Exactly what `offload` makes: these three keys, a blob id, a numeric size and a type. */
30
+ export const isBlobRef = (value) => {
31
+ // Most objects have no `$blob`: one look is all they cost.
32
+ if (value === null || typeof value !== "object" || !isBlobId(value.$blob)) {
33
+ return false;
34
+ }
35
+ const { size, type } = value;
36
+ return typeof size === "number" && typeof type === "string" &&
37
+ Object.keys(value).length === 3 && Object.hasOwn(value, "$blob") &&
38
+ Object.hasOwn(value, "size") && Object.hasOwn(value, "type");
39
+ };
15
40
  export async function blobId(data) {
16
41
  const hash = new Uint8Array(await crypto.subtle.digest("SHA-256", data));
17
42
  return "sha256-" + Array.from(hash, (b) => b.toString(16).padStart(2, "0")).join("");
18
43
  }
19
- /** Whether `value` holds a string that may exceed the threshold (cheap, synchronous). */
20
- function large(value, threshold) {
44
+ const forged = () => invalid("\"$blob\" is reserved for the runtime's blob references: data can't hold that key.");
45
+ /**
46
+ * Whether `value` holds a string that may exceed the threshold (cheap, synchronous).
47
+ * `foreign`: the value is plugin code's, so an object with a `$blob` key is
48
+ * refused on the way. Every object gets that look: this walk stops early
49
+ * only at a large string, and `offload` then walks each part of the value.
50
+ */
51
+ function large(value, threshold, foreign) {
21
52
  // A UTF-16 code unit is at most 3 UTF-8 bytes, so shorter strings always fit.
22
53
  if (typeof value === "string")
23
54
  return value.length * 3 > threshold;
24
- if (value === null || typeof value !== "object" || isBlobRef(value))
55
+ if (value === null || typeof value !== "object")
25
56
  return false;
26
- return (Array.isArray(value) ? value : Object.values(value)).some((v) => large(v, threshold));
57
+ if (foreign) {
58
+ if (Object.hasOwn(value, "$blob"))
59
+ throw forged();
60
+ }
61
+ else if (isBlobRef(value))
62
+ return false;
63
+ return (Array.isArray(value) ? value : Object.values(value)).some((v) => large(v, threshold, foreign));
64
+ }
65
+ /** Refuses (`invalid`) a value of plugin code's that holds an object with a `$blob` key. */
66
+ export function refuseBlobKeys(value) {
67
+ // No string is over an infinite threshold: the walk looks at everything.
68
+ large(value, Infinity, true);
27
69
  }
28
70
  function holdsRef(value) {
29
71
  if (value === null || typeof value !== "object")
@@ -32,9 +74,13 @@ function holdsRef(value) {
32
74
  return true;
33
75
  return (Array.isArray(value) ? value : Object.values(value)).some(holdsRef);
34
76
  }
35
- /** Replaces strings over the threshold with blob references, storing each with `put`. */
36
- export async function offload(value, put, threshold = BLOB_THRESHOLD) {
37
- if (!large(value, threshold))
77
+ /**
78
+ * Replaces strings over the threshold with blob references, storing each with `put`.
79
+ * `foreign`: the value is plugin code's, and may hold no `$blob` key (see
80
+ * `large`); otherwise it's the owner's, and its references stay as they are.
81
+ */
82
+ export async function offload(value, put, threshold = BLOB_THRESHOLD, foreign = false) {
83
+ if (!large(value, threshold, foreign))
38
84
  return value;
39
85
  if (typeof value === "string") {
40
86
  const data = encoder.encode(value);
@@ -45,11 +91,12 @@ export async function offload(value, put, threshold = BLOB_THRESHOLD) {
45
91
  return { $blob: id, size: data.length, type: TEXT };
46
92
  }
47
93
  const copy = (Array.isArray(value) ? [...value] : { ...value });
48
- for (const [key, item] of Object.entries(copy))
49
- copy[key] = await offload(item, put, threshold);
94
+ for (const [key, item] of Object.entries(copy)) {
95
+ copy[key] = await offload(item, put, threshold, foreign);
96
+ }
50
97
  return copy;
51
98
  }
52
- /** Replaces blob references with their content. */
99
+ /** Replaces blob references with their content; one whose blob is gone fails (`missing_blob`). */
53
100
  export async function hydrate(value, get) {
54
101
  if (!holdsRef(value))
55
102
  return value;
@@ -11,6 +11,12 @@ export declare function createCache(options?: {
11
11
  aggregate(collection: string, pipeline: unknown, load: () => Promise<Doc[]>): Promise<Doc[]>;
12
12
  /** Applies committed changes to everything cached for the collection. */
13
13
  apply(collection: string, changes: Change[]): void;
14
+ /**
15
+ * Forgets everything: for a change it can't follow (maintenance SQL,
16
+ * which may have changed any document). Reads in flight across it don't
17
+ * fill the cache; the next read of anything goes to the store.
18
+ */
19
+ clear(): void;
14
20
  stats: () => {
15
21
  hits: number;
16
22
  misses: number;