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
package/runtime/wire.js CHANGED
@@ -15,8 +15,10 @@ export const failure = (error) => ({
15
15
  ? { code: error.code }
16
16
  : {}),
17
17
  ...(error?.final === true ? { final: true } : {}),
18
+ // A message for any caller stays one from job to job (see errors.ts).
19
+ ...(error?.public === true ? { public: true } : {}),
18
20
  });
19
- export const raise = (failure) => Object.assign(new Error(failure.message), failure.code ? { code: failure.code } : {}, failure.final ? { final: true } : {});
21
+ export const raise = (failure) => Object.assign(new Error(failure.message), failure.code ? { code: failure.code } : {}, failure.final ? { final: true } : {}, failure.public ? { public: true } : {});
20
22
  /**
21
23
  * Output lines are newline-delimited JSON. Read with a reader, not `for await`:
22
24
  * Safari can't iterate a stream (this runs in browsers too).
@@ -1,11 +1,13 @@
1
1
  /**
2
2
  * Blobs as files in a directory, sharded by the first two hex digits of the
3
- * hash. Uses `node:fs`, which Node, Deno and Bun all provide.
3
+ * hash. Uses `node:fs`, which Node, Deno and Bun all provide. An id is only
4
+ * ever a blob's (`sha256-` and hex), so a path never leaves the directory.
4
5
  */
5
6
  import { mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";
7
+ import { checkBlobId } from "../../../runtime/blobs.js";
6
8
  const missing = (error) => error.code === "ENOENT";
7
9
  export function fileBlobs(options) {
8
- const path = (id) => `${options.dir}/${id.slice(7, 9)}/${id}`;
10
+ const path = (id) => `${options.dir}/${id.slice(7, 9)}/${checkBlobId(id)}`;
9
11
  return {
10
12
  async put({ id, data }) {
11
13
  const file = path(id);
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Blobs in a Google Cloud Storage bucket, through its JSON API: each blob is
3
+ * the object `<prefix>/<id>`, kept with its content type. Written once
4
+ * (`ifGenerationMatch=0`): an id is its content's hash, so an object that's
5
+ * there already is the same content, and GCS refusing to replace it (412)
6
+ * is a success.
7
+ *
8
+ * It signs in as the service account of the instance it runs on (Cloud Run,
9
+ * Compute Engine: the metadata server), keeping each token until a minute
10
+ * before it expires, one request for a new one at a time. `token()` replaces
11
+ * that (locally: `googleToken()` from `copilotz/plugins/compute` reads
12
+ * Application Default Credentials). Each try may take `timeout` ms; a request the
13
+ * network, a timeout, 429 or a 5xx breaks is tried twice more, waiting a
14
+ * little longer each time. Other 4xx fail at once. Web standards only.
15
+ *
16
+ * An id is only ever a blob's (`sha256-` and hex): never the name of another
17
+ * object in the bucket.
18
+ */
19
+ import type { Blobs } from "../../../runtime/mod.js";
20
+ export declare function gcsBlobs(options: {
21
+ /** The bucket's name. */
22
+ bucket: string;
23
+ /** A folder for the blobs: objects are `<prefix>/<id>` (default: the bucket's top). */
24
+ prefix?: string;
25
+ /** An access token, asked for each request; default: the metadata server's, kept. */
26
+ token?(): string | Promise<string>;
27
+ /** How long each try may take, in ms (default 30 s). */
28
+ timeout?: number;
29
+ fetch?: typeof fetch;
30
+ }): Blobs;
@@ -0,0 +1,106 @@
1
+ import { checkBlobId } from "../../../runtime/blobs.js";
2
+ /** GCS's JSON API. */
3
+ const API = "https://storage.googleapis.com";
4
+ /** The token of the instance's service account, on Cloud Run and Compute Engine. */
5
+ const METADATA = "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token";
6
+ /** A token is renewed this long before it expires. */
7
+ const MARGIN = 60_000;
8
+ /** Tries per request: the first, and two more. */
9
+ const TRIES = 3;
10
+ /** How long each try may take, by default. */
11
+ const TIMEOUT = 30_000;
12
+ const failed = (message, status) => Object.assign(new Error(message), status === undefined ? {} : { status });
13
+ /** What it says when GCS answers no: the status, and the start of GCS's reason. */
14
+ async function failure(response, what) {
15
+ const text = (await response.text().catch(() => "")).slice(0, 300);
16
+ return failed(`GCS, ${what}: HTTP ${response.status}${text ? ` ${text}` : ""}`, response.status);
17
+ }
18
+ /** Worth trying again: the network, a timeout, GCS busy (429) or failing (5xx). */
19
+ function transient(error) {
20
+ const { status, name } = error;
21
+ if (status !== undefined)
22
+ return status === 429 || status >= 500;
23
+ return error instanceof TypeError || name === "TimeoutError" || name === "AbortError";
24
+ }
25
+ /** Waits before try `n + 1`: about 200 ms, then 400 ms, give or take a fifth. */
26
+ const pause = (n) => new Promise((resolve) => setTimeout(resolve, 200 * 2 ** (n - 1) * (0.8 + Math.random() * 0.4)));
27
+ /** The metadata server's token, kept until a minute before it expires. */
28
+ function metadataToken(go, timeout) {
29
+ let kept;
30
+ let pending;
31
+ const fresh = async () => {
32
+ const response = await go(METADATA, {
33
+ headers: { "Metadata-Flavor": "Google" },
34
+ signal: AbortSignal.timeout(timeout),
35
+ });
36
+ if (!response.ok)
37
+ throw await failure(response, "the metadata server's token");
38
+ const body = await response.json();
39
+ return { token: body.access_token, until: Date.now() + body.expires_in * 1000 };
40
+ };
41
+ return async () => {
42
+ if (kept && kept.until - MARGIN > Date.now())
43
+ return kept.token;
44
+ pending ??= fresh().finally(() => pending = undefined);
45
+ kept = await pending;
46
+ return kept.token;
47
+ };
48
+ }
49
+ export function gcsBlobs(options) {
50
+ const go = options.fetch ?? fetch;
51
+ const timeout = options.timeout ?? TIMEOUT;
52
+ const token = options.token ?? metadataToken(go, timeout);
53
+ const bucket = encodeURIComponent(options.bucket);
54
+ const prefix = (options.prefix ?? "").replace(/^\/+|\/+$/g, "");
55
+ const name = (id) => prefix ? `${prefix}/${checkBlobId(id)}` : checkBlobId(id);
56
+ /** A request, tried again while it breaks in passing; `read` takes its answer. */
57
+ const request = async (url, init, read) => {
58
+ for (let n = 1;; n++) {
59
+ try {
60
+ const response = await go(url, {
61
+ ...init,
62
+ headers: {
63
+ ...init.headers,
64
+ authorization: `Bearer ${await token()}`,
65
+ },
66
+ signal: AbortSignal.timeout(timeout),
67
+ });
68
+ return await read(response);
69
+ }
70
+ catch (error) {
71
+ if (n >= TRIES || !transient(error))
72
+ throw error;
73
+ await pause(n);
74
+ }
75
+ }
76
+ };
77
+ return {
78
+ async put({ id, data, type }) {
79
+ const query = new URLSearchParams({
80
+ uploadType: "media",
81
+ name: name(id),
82
+ ifGenerationMatch: "0",
83
+ });
84
+ return await request(`${API}/upload/storage/v1/b/${bucket}/o?${query}`, {
85
+ method: "POST",
86
+ headers: { "content-type": type ?? "application/octet-stream" },
87
+ body: data,
88
+ }, async (response) => {
89
+ // 412: the object is there, so this content is.
90
+ if (response.ok || response.status === 412)
91
+ return void await response.body?.cancel();
92
+ throw await failure(response, `putting blob ${id}`);
93
+ });
94
+ },
95
+ async get(id) {
96
+ return await request(`${API}/storage/v1/b/${bucket}/o/${encodeURIComponent(name(id))}?alt=media`, {}, async (response) => {
97
+ if (response.status === 404)
98
+ return (await response.body?.cancel(), null);
99
+ if (!response.ok)
100
+ throw await failure(response, `getting blob ${id}`);
101
+ const type = response.headers.get("content-type");
102
+ return { data: new Uint8Array(await response.arrayBuffer()), ...(type ? { type } : {}) };
103
+ });
104
+ },
105
+ };
106
+ }
@@ -3,7 +3,7 @@
3
3
  * stores serve (S3, GCS, R2, MinIO), directly or through a signing proxy.
4
4
  * `headers` adds what a request needs (an Authorization, say), per request.
5
5
  * Content-addressed: an id that exists is the same content, so putting it
6
- * again is harmless.
6
+ * again is harmless. An id is only ever a blob's (`sha256-` and hex).
7
7
  */
8
8
  import type { Blobs } from "../../../runtime/mod.js";
9
9
  export declare function httpBlobs(options: {
@@ -1,6 +1,7 @@
1
+ import { checkBlobId } from "../../../runtime/blobs.js";
1
2
  export function httpBlobs(options) {
2
3
  const go = options.fetch ?? fetch;
3
- const at = (id) => `${options.url.replace(/\/$/, "")}/${encodeURIComponent(id)}`;
4
+ const at = (id) => `${options.url.replace(/\/$/, "")}/${encodeURIComponent(checkBlobId(id))}`;
4
5
  return {
5
6
  async put({ id, data, type }) {
6
7
  const response = await go(at(id), {
@@ -35,7 +35,11 @@ export function withLatency(store, ms) {
35
35
  : {}),
36
36
  describe: store.describe?.bind(store),
37
37
  index: store.index?.bind(store),
38
- ...("inspect" in store ? { inspect: store.inspect } : {}),
38
+ ...(store.inspect
39
+ ? {
40
+ inspect: async (...args) => (await trip(), store.inspect(...args)),
41
+ }
42
+ : {}),
39
43
  roundTrips: () => trips,
40
44
  close: () => store.close(),
41
45
  };
@@ -0,0 +1,24 @@
1
+ import { type Session } from "./layout.js";
2
+ /** A new connection for one maintenance statement: a `Session`, and `end` to close it. */
3
+ export declare function connect(url: string, trace?: (sql: string) => void): Promise<Session & {
4
+ end(): Promise<void>;
5
+ }>;
6
+ /** Refuses raw SQL on a server whose store names no maintenance role. */
7
+ export declare const noRole: () => Error & {
8
+ code: string;
9
+ public?: true;
10
+ };
11
+ /**
12
+ * Refuses maintenance SQL when the role on `db` (the session's own, the
13
+ * login's), or a Cloud SQL marker it's a member of, holds anything beyond
14
+ * the allowlist.
15
+ */
16
+ export declare function allowed(db: Session, schema: string): Promise<void>;
17
+ /**
18
+ * PGlite's check, its one session being the store's: no other schema's
19
+ * tables within reach (another store's, in this process), and no remote
20
+ * databases.
21
+ */
22
+ export declare function alone(db: Session, schema: string): Promise<void>;
23
+ /** Triggers on the store's tables: none of the store's making, so none at all. */
24
+ export declare const triggers: (schema: string) => string;
@@ -0,0 +1,258 @@
1
+ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
2
+ if (typeof path === "string" && /^\.\.?\//.test(path)) {
3
+ return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
4
+ return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
5
+ });
6
+ }
7
+ return path;
8
+ };
9
+ /**
10
+ * Maintenance SQL's connection to a PostgreSQL server, and the role it runs
11
+ * as (runtime/maintain.ts; the store's `inspect` and `execute`).
12
+ *
13
+ * - **A role of its own, required on a server**
14
+ * (`postgresStore({ maintenance: { url } })`): the store's own role owns
15
+ * the tables, may stop the app's connections, and is whatever the
16
+ * deployment made it (a superuser, even). Without one, raw SQL is
17
+ * refused; the collections' operations, named queries and blobs don't
18
+ * need it. PGlite, in this process, runs it as its one session.
19
+ * - **Exactly the grants maintenance needs, checked before every
20
+ * statement** (`allowed`), on the connection that runs it: an allowlist,
21
+ * not a list of what's refused. The role has no attribute beyond LOGIN,
22
+ * is a member of no role at all (so `SET ROLE` reaches nothing, whatever
23
+ * INHERIT says), owns nothing, may create nothing anywhere, and holds no
24
+ * privilege on any table or column outside the store's schema; inside
25
+ * it, SELECT on everything, INSERT, UPDATE and DELETE on documents,
26
+ * edges, vectors and blobs, INSERT on the log, UPDATE of meta's `value`
27
+ * (to hold the fence), and nothing more. It may run no SECURITY DEFINER
28
+ * function (one runs as its owner: revoke EXECUTE from PUBLIC), and the
29
+ * database has no `dblink` or `postgres_fdw`. The store makes no
30
+ * triggers: one on its tables means someone else did, and nothing runs.
31
+ * - **A connection of its own for each statement, closed after:** whatever
32
+ * the statement leaves on its session goes with it. It speaks `pg`
33
+ * itself, the driver Ominipg loads, so every query goes over the
34
+ * extended protocol, where the server refuses more than one statement.
35
+ * - **At most `connections` at once** (2 by default; ../shared/capped.ts).
36
+ */
37
+ import { failure } from "../../../runtime/errors.js";
38
+ import { ident } from "./layout.js";
39
+ /** Not literal, so no bundler resolves it where only PGlite is used. */
40
+ const PG = "pg";
41
+ let driver;
42
+ /** Bytes as plain `Uint8Array`s (`pg` gives Buffers, whose `toJSON` says something else). */
43
+ const plain = (row) => {
44
+ for (const [key, value] of Object.entries(row)) {
45
+ if (value instanceof Uint8Array && value.constructor !== Uint8Array) {
46
+ row[key] = new Uint8Array(value);
47
+ }
48
+ }
49
+ return row;
50
+ };
51
+ /** A new connection for one maintenance statement: a `Session`, and `end` to close it. */
52
+ export async function connect(url, trace) {
53
+ const pg = await (driver ??= import(__rewriteRelativeImportExtension(PG)).then((m) => (m.default ?? m)));
54
+ const client = new pg.Client({ connectionString: url, application_name: "copilotz maintenance" });
55
+ // A connection the server drops fails the query running on it: nothing else to say.
56
+ client.on("error", () => { });
57
+ await client.connect();
58
+ return {
59
+ async query(text, params = []) {
60
+ trace?.(text);
61
+ const { rows } = await client.query({ text, values: params, queryMode: "extended" });
62
+ return { rows: rows.map(plain) };
63
+ },
64
+ end: () => client.end().catch(() => { }),
65
+ };
66
+ }
67
+ const unsafe = (message) => failure("unsafe_role", message);
68
+ /** Refuses raw SQL on a server whose store names no maintenance role. */
69
+ export const noRole = () => unsafe("Raw SQL on a PostgreSQL server runs only as a maintenance role of its own: " +
70
+ "postgresStore({ maintenance: { url } }), set up as the README's Maintenance says. " +
71
+ "The collections' operations, named queries and blobs work without it.");
72
+ /**
73
+ * Cloud SQL's markers of an IAM database user (a role made by `gcloud sql
74
+ * users create … --type=cloud_iam_*`): such a role is a member of one. Every
75
+ * IAM user is, so a marker is held to an empty allowlist (it may hold
76
+ * nothing at all, not even on the store's schema), and the membership may
77
+ * not carry ADMIN OPTION (the role could hand the marker to anyone).
78
+ */
79
+ const MARKERS = ["cloudsqliamuser", "cloudsqliamserviceaccount", "cloudsqliamgroup"];
80
+ /**
81
+ * What role `$2` holds beyond the allowlist above, for schema `$1`, one line
82
+ * for each, none when it holds exactly that; `$3` are the roles it may be a
83
+ * member of (Cloud SQL's markers). With no schema (`''`), the allowlist is
84
+ * empty: anything at all granted to it is beyond it. Every catalog name is
85
+ * `pg_catalog`'s: after a statement, in its transaction, a temporary table
86
+ * could stand in for one.
87
+ */
88
+ const BEYOND = `
89
+ WITH me AS (
90
+ SELECT oid, rolsuper, rolcreaterole, rolcreatedb, rolreplication, rolbypassrls
91
+ FROM pg_catalog.pg_roles WHERE rolname = $2::pg_catalog.name
92
+ ), own AS (
93
+ SELECT oid FROM pg_catalog.pg_namespace WHERE nspname = $1::pg_catalog.name
94
+ ), here AS (
95
+ SELECT oid FROM pg_catalog.pg_database WHERE datname = pg_catalog.current_database()
96
+ ), catalogs AS (
97
+ SELECT oid FROM pg_catalog.pg_namespace WHERE nspname IN ('pg_catalog', 'information_schema')
98
+ ), privileges AS (
99
+ SELECT pg_catalog.unnest(ARRAY['SELECT', 'INSERT', 'UPDATE', 'DELETE', 'TRUNCATE', 'REFERENCES',
100
+ 'TRIGGER'] || CASE WHEN pg_catalog.current_setting('server_version_num')::pg_catalog.int4 >=
101
+ 170000 THEN ARRAY['MAINTAIN'] ELSE ARRAY[]::pg_catalog.text[] END) AS privilege
102
+ ), temporary AS (
103
+ SELECT oid FROM pg_catalog.pg_namespace WHERE nspname ~ '^pg_(toast_)?temp_'
104
+ ), extension AS (
105
+ SELECT objid FROM pg_catalog.pg_depend
106
+ WHERE deptype = 'e' AND classid = 'pg_catalog.pg_class'::pg_catalog.regclass
107
+ )
108
+ SELECT DISTINCT problem FROM (
109
+ SELECT 'is a superuser' AS problem FROM me WHERE rolsuper
110
+ UNION ALL SELECT 'may create roles' FROM me WHERE rolcreaterole
111
+ UNION ALL SELECT 'may create databases' FROM me WHERE rolcreatedb
112
+ UNION ALL SELECT 'may replicate' FROM me WHERE rolreplication
113
+ UNION ALL SELECT 'bypasses row security' FROM me WHERE rolbypassrls
114
+ UNION ALL SELECT 'is a member of ' || r.rolname::pg_catalog.text
115
+ FROM pg_catalog.pg_auth_members m JOIN pg_catalog.pg_roles r ON r.oid = m.roleid, me
116
+ WHERE m.member = me.oid AND r.rolname::pg_catalog.text <> ALL ($3::pg_catalog.text[])
117
+ UNION ALL SELECT 'has settings of its own (' ||
118
+ pg_catalog.array_to_string(s.setconfig, ', ') || ')'
119
+ FROM pg_catalog.pg_db_role_setting s, me WHERE s.setrole = me.oid
120
+ UNION ALL SELECT 'owns the database' FROM pg_catalog.pg_database d, me, here
121
+ WHERE d.oid = here.oid AND d.datdba = me.oid
122
+ UNION ALL SELECT 'may create schemas'
123
+ WHERE pg_catalog.has_database_privilege($2::pg_catalog.name, pg_catalog.current_database(),
124
+ 'CREATE')
125
+ UNION ALL SELECT 'owns ' || pg_catalog.pg_describe_object(d.classid, d.objid, d.objsubid)
126
+ FROM pg_catalog.pg_shdepend d, me, here
127
+ WHERE d.refclassid = 'pg_catalog.pg_authid'::pg_catalog.regclass AND d.refobjid = me.oid
128
+ AND d.deptype = 'o' AND d.dbid IN (0, here.oid)
129
+ -- What it made for this session alone goes with its connection, closed after.
130
+ AND NOT (d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass AND d.objid IN
131
+ (SELECT oid FROM pg_catalog.pg_class WHERE relnamespace IN (SELECT oid FROM temporary)))
132
+ AND NOT (d.classid = 'pg_catalog.pg_type'::pg_catalog.regclass AND d.objid IN
133
+ (SELECT oid FROM pg_catalog.pg_type WHERE typnamespace IN (SELECT oid FROM temporary)))
134
+ AND NOT (d.classid = 'pg_catalog.pg_proc'::pg_catalog.regclass AND d.objid IN
135
+ (SELECT oid FROM pg_catalog.pg_proc WHERE pronamespace IN (SELECT oid FROM temporary)))
136
+ UNION ALL SELECT 'owns a database elsewhere' FROM pg_catalog.pg_shdepend d, me, here
137
+ WHERE d.refclassid = 'pg_catalog.pg_authid'::pg_catalog.regclass AND d.refobjid = me.oid
138
+ AND d.deptype = 'o' AND d.dbid NOT IN (0, here.oid)
139
+ UNION ALL SELECT 'is granted something on ' ||
140
+ pg_catalog.pg_describe_object(d.classid, d.objid, d.objsubid)
141
+ FROM pg_catalog.pg_shdepend d, me, here
142
+ WHERE d.refclassid = 'pg_catalog.pg_authid'::pg_catalog.regclass AND d.refobjid = me.oid
143
+ AND d.deptype = 'a' AND d.dbid IN (0, here.oid) AND NOT (
144
+ (d.classid = 'pg_catalog.pg_class'::pg_catalog.regclass AND d.objid IN
145
+ (SELECT oid FROM pg_catalog.pg_class WHERE relnamespace IN (SELECT oid FROM own)))
146
+ OR (d.classid = 'pg_catalog.pg_namespace'::pg_catalog.regclass
147
+ AND d.objid IN (SELECT oid FROM own))
148
+ OR (d.classid = 'pg_catalog.pg_default_acl'::pg_catalog.regclass AND d.objid IN
149
+ (SELECT oid FROM pg_catalog.pg_default_acl WHERE defaclnamespace IN (SELECT oid FROM own)))
150
+ OR (d.classid = 'pg_catalog.pg_database'::pg_catalog.regclass
151
+ AND d.objid IN (SELECT oid FROM here) AND EXISTS (SELECT 1 FROM own)))
152
+ UNION ALL SELECT 'owns large object ' || m.oid::pg_catalog.text
153
+ FROM pg_catalog.pg_largeobject_metadata m, me WHERE m.lomowner = me.oid
154
+ UNION ALL SELECT 'may read large object ' || m.oid::pg_catalog.text
155
+ FROM pg_catalog.pg_largeobject_metadata m, me
156
+ WHERE EXISTS (SELECT 1 FROM pg_catalog.aclexplode(m.lomacl) a WHERE a.grantee IN (0, me.oid))
157
+ UNION ALL SELECT 'may read every large object (lo_compat_privileges)'
158
+ WHERE pg_catalog.current_setting('lo_compat_privileges') = 'on'
159
+ UNION ALL SELECT 'may create in schema ' || n.nspname::pg_catalog.text
160
+ FROM pg_catalog.pg_namespace n
161
+ WHERE pg_catalog.has_schema_privilege($2::pg_catalog.name, n.oid, 'CREATE')
162
+ AND n.oid NOT IN (SELECT oid FROM temporary)
163
+ UNION ALL SELECT 'may use ' || c.oid::pg_catalog.regclass::pg_catalog.text
164
+ FROM pg_catalog.pg_class c
165
+ WHERE c.relnamespace NOT IN (SELECT oid FROM own) AND c.relnamespace NOT IN
166
+ (SELECT oid FROM catalogs) AND c.relnamespace NOT IN (SELECT oid FROM temporary)
167
+ AND c.oid NOT IN (SELECT objid FROM extension) AND c.relkind IN ('r', 'p', 'v', 'm', 'f')
168
+ AND (pg_catalog.has_table_privilege($2::pg_catalog.name, c.oid,
169
+ (SELECT pg_catalog.string_agg(privilege, ', ') FROM privileges))
170
+ OR pg_catalog.has_any_column_privilege($2::pg_catalog.name, c.oid,
171
+ 'SELECT, INSERT, UPDATE, REFERENCES'))
172
+ UNION ALL SELECT 'may use sequence ' || c.oid::pg_catalog.regclass::pg_catalog.text
173
+ FROM pg_catalog.pg_class c
174
+ WHERE c.relkind = 'S' AND c.relnamespace NOT IN (SELECT oid FROM catalogs)
175
+ AND c.relnamespace NOT IN (SELECT oid FROM temporary)
176
+ AND c.oid NOT IN (SELECT objid FROM extension)
177
+ AND CASE WHEN c.relkind = 'S' THEN pg_catalog.has_sequence_privilege($2::pg_catalog.name,
178
+ c.oid, 'USAGE, SELECT, UPDATE') ELSE false END
179
+ UNION ALL SELECT 'may ' || p.privilege || ' ' || c.oid::pg_catalog.regclass::pg_catalog.text
180
+ FROM pg_catalog.pg_class c, privileges p
181
+ WHERE c.relnamespace IN (SELECT oid FROM own) AND c.relkind IN ('r', 'p', 'v', 'm', 'f')
182
+ AND p.privilege <> 'SELECT'
183
+ AND pg_catalog.has_table_privilege($2::pg_catalog.name, c.oid, p.privilege) AND NOT (
184
+ (c.relname IN ('nodes', 'edges', 'vectors', 'blobs')
185
+ AND p.privilege IN ('INSERT', 'UPDATE', 'DELETE'))
186
+ OR (c.relname = 'events' AND p.privilege = 'INSERT'))
187
+ UNION ALL SELECT 'may ' || p.privilege || ' ' || c.oid::pg_catalog.regclass::pg_catalog.text ||
188
+ '.' || a.attname::pg_catalog.text
189
+ FROM pg_catalog.pg_class c JOIN pg_catalog.pg_attribute a ON a.attrelid = c.oid,
190
+ (VALUES ('INSERT'), ('UPDATE'), ('REFERENCES')) p(privilege)
191
+ WHERE c.relnamespace IN (SELECT oid FROM own) AND c.relkind IN ('r', 'p', 'v', 'm', 'f')
192
+ AND a.attnum > 0 AND NOT a.attisdropped
193
+ AND pg_catalog.has_column_privilege($2::pg_catalog.name, c.oid, a.attnum, p.privilege)
194
+ AND NOT (
195
+ (c.relname IN ('nodes', 'edges', 'vectors', 'blobs')
196
+ AND p.privilege IN ('INSERT', 'UPDATE'))
197
+ OR (c.relname = 'events' AND p.privilege = 'INSERT')
198
+ OR (c.relname = 'meta' AND a.attname = 'value' AND p.privilege = 'UPDATE'))
199
+ UNION ALL SELECT 'may run ' || p.oid::pg_catalog.regprocedure::pg_catalog.text ||
200
+ ' as its owner (SECURITY DEFINER)'
201
+ FROM pg_catalog.pg_proc p WHERE p.prosecdef AND p.pronamespace NOT IN (SELECT oid FROM catalogs)
202
+ AND pg_catalog.has_function_privilege($2::pg_catalog.name, p.oid, 'EXECUTE')
203
+ UNION ALL SELECT 'the database has ' || extname::pg_catalog.text FROM pg_catalog.pg_extension
204
+ WHERE extname IN ('dblink', 'postgres_fdw')
205
+ UNION ALL SELECT 'a trigger the store didn''t make: ' || t.tgname::pg_catalog.text || ' on ' ||
206
+ c.relname::pg_catalog.text
207
+ FROM pg_catalog.pg_trigger t JOIN pg_catalog.pg_class c ON c.oid = t.tgrelid
208
+ WHERE c.relnamespace IN (SELECT oid FROM own) AND NOT t.tgisinternal
209
+ ) beyond ORDER BY problem`;
210
+ /**
211
+ * Refuses maintenance SQL when the role on `db` (the session's own, the
212
+ * login's), or a Cloud SQL marker it's a member of, holds anything beyond
213
+ * the allowlist.
214
+ */
215
+ export async function allowed(db, schema) {
216
+ const [{ role, markers, admin }] = (await db.query(`WITH mine AS (SELECT r.rolname::pg_catalog.text AS marker, m.admin_option FROM ` +
217
+ `pg_catalog.pg_auth_members m JOIN pg_catalog.pg_roles r ON r.oid = m.roleid WHERE ` +
218
+ `m.member = (SELECT oid FROM pg_catalog.pg_roles WHERE rolname = session_user) AND ` +
219
+ `r.rolname::pg_catalog.text = ANY ($1::pg_catalog.text[])) SELECT ` +
220
+ `session_user::pg_catalog.text AS role, (SELECT pg_catalog.array_agg(marker) FROM mine) ` +
221
+ `AS markers, (SELECT pg_catalog.array_agg(marker) FROM mine WHERE admin_option) AS admin`, [MARKERS])).rows;
222
+ const problems = (admin ?? []).map((marker) => `may grant ${marker} to others (ADMIN OPTION), and so every IAM user's reach`);
223
+ // The role holds the allowlist; a marker, every IAM user's, holds nothing at all.
224
+ for (const [who, scope, member] of [
225
+ [role, schema, MARKERS],
226
+ ...(markers ?? []).map((marker) => [marker, "", []]),
227
+ ]) {
228
+ const found = (await db.query(BEYOND, [scope, who, member])).rows;
229
+ problems.push(...found.map((row) => (who === role ? "" : `(as ${who}) `) + row.problem));
230
+ }
231
+ if (!problems.length)
232
+ return;
233
+ const shown = problems.slice(0, 8).join("; ") +
234
+ (problems.length > 8 ? `; and ${problems.length - 8} more` : "");
235
+ throw unsafe(`The maintenance role holds more than maintenance needs: it ${shown}. It must hold the ` +
236
+ `README's grants on "${schema}" and nothing else.`);
237
+ }
238
+ /**
239
+ * PGlite's check, its one session being the store's: no other schema's
240
+ * tables within reach (another store's, in this process), and no remote
241
+ * databases.
242
+ */
243
+ export async function alone(db, schema) {
244
+ const [found] = (await db.query(`SELECT (SELECT pg_catalog.array_agg(n.nspname::pg_catalog.text ORDER BY n.nspname) FROM ` +
245
+ `pg_catalog.pg_namespace n WHERE n.nspname <> $1::pg_catalog.name AND n.nspname NOT IN ` +
246
+ `('pg_catalog', 'information_schema') AND n.nspname NOT LIKE 'pg\\_%' AND EXISTS (SELECT ` +
247
+ `1 FROM pg_catalog.pg_class c WHERE c.relnamespace = n.oid AND c.relkind IN ('r', 'p', ` +
248
+ `'v', 'm', 'f'))) AS others, (SELECT pg_catalog.array_agg(extname::pg_catalog.text) FROM ` +
249
+ `pg_catalog.pg_extension WHERE extname IN ('dblink', 'postgres_fdw')) AS remote`, [schema])).rows;
250
+ const names = (value) => value ?? [];
251
+ if (names(found.others).length || names(found.remote).length) {
252
+ throw unsafe(`SQL here would reach beyond "${schema}" (${[...names(found.others), ...names(found.remote)].join(", ")}).`);
253
+ }
254
+ }
255
+ /** Triggers on the store's tables: none of the store's making, so none at all. */
256
+ export const triggers = (schema) => `(SELECT pg_catalog.count(*) FROM pg_catalog.pg_trigger t JOIN pg_catalog.pg_class c ON ` +
257
+ `c.oid = t.tgrelid WHERE c.relnamespace = ${`'${ident(schema).replaceAll("'", "''")}'`}::` +
258
+ `pg_catalog.regnamespace AND NOT t.tgisinternal)::pg_catalog.int4`;
@@ -22,8 +22,7 @@
22
22
  * PGlite has a single connection, so its reads wait for an open transaction.
23
23
  */
24
24
  import type { JSONSchema } from "../../../runtime/define.js";
25
- import { type IndexSpec, type Store } from "../../../runtime/store.js";
26
- import { type Row } from "./layout.js";
25
+ import { type IndexSpec, type Inspected, type Store } from "../../../runtime/store.js";
27
26
  import { type PostgresPool } from "./pool.js";
28
27
  export { type PostgresPool, postgresPool } from "./pool.js";
29
28
  export { copyTenant, dropTenant, exportTenant, type Location } from "./tenants.js";
@@ -37,12 +36,29 @@ export declare function postgresStore(options: {
37
36
  tenant?: string;
38
37
  /** Hears every SQL statement sent, for debugging. */
39
38
  trace?: (sql: string) => void;
39
+ /**
40
+ * Where maintenance SQL connects (`inspect`, a transaction's `execute`;
41
+ * see maintenance.ts): a role of its own, holding exactly maintenance's
42
+ * grants on this schema. A new connection for each statement, closed
43
+ * after, `connections` at most at once (2). On a server, raw SQL needs it.
44
+ */
45
+ maintenance?: {
46
+ url: string;
47
+ connections?: number;
48
+ };
40
49
  }): Promise<Store & {
41
50
  /** Exposes each collection as a SQL view of its schema's top-level fields. */
42
51
  describe(collections: Record<string, JSONSchema>): Promise<void>;
43
52
  index(collections: Record<string, IndexSpec[]>): Promise<void>;
44
- /** Runs a read-only query, for inspection tools; in a schema of its own only. */
45
- inspect(sql: string): Promise<Row[]>;
53
+ /**
54
+ * Runs one read-only statement, for inspection and maintenance tools; in
55
+ * a schema of its own only.
56
+ */
57
+ inspect(sql: string, params?: unknown[], options?: {
58
+ limit?: number;
59
+ timeout?: number;
60
+ bytes?: number;
61
+ }): Promise<Inspected>;
46
62
  /** Deletes everything this store holds, then closes: a tenant gone for good. */
47
63
  drop(): Promise<void>;
48
64
  }>;