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/README.md CHANGED
@@ -8,11 +8,11 @@ browser.
8
8
 
9
9
  An app is plugins: agents that answer with tools and talk to each other and to people, conversations
10
10
  in shared spaces, memory, skills and routines, a usage ledger, people's computers, sign-in and
11
- connected accounts, a developer API, WhatsApp. Each is a plain object built from the same few
12
- primitives (collections, Actions, Processors, Views, resources and adapters), and the runtime knows
13
- nothing else. Everything durable is an event, a document, an edge, a vector or a blob, written by
14
- one owner to one store (memory, SQLite or PostgreSQL), so every change is on the record and every
15
- screen follows it live: in a terminal, in a browser, or in an agent's prompt.
11
+ connected accounts, a developer API, WhatsApp, phone calls. Each is a plain object built from the
12
+ same few primitives (collections, Actions, Processors, Views, resources and adapters), and the
13
+ runtime knows nothing else. Everything durable is an event, a document, an edge, a vector or a blob,
14
+ written by one owner to one store (memory, SQLite or PostgreSQL), so every change is on the record
15
+ and every screen follows it live: in a terminal, in a browser, or in an agent's prompt.
16
16
 
17
17
  ## Install
18
18
 
@@ -22,10 +22,10 @@ bun add copilotz # Bun
22
22
  deno add jsr:@copilotz/copilotz # Deno (or `deno add npm:copilotz`)
23
23
  ```
24
24
 
25
- On Deno, name it `copilotz` in `deno.json` (`"copilotz": "jsr:@copilotz/copilotz@^1.0.0-rc.2"`), and
26
- the imports below are the same everywhere. Some pieces need a package of their own, installed beside
27
- it: `esbuild` to bundle the web host on Node, `@electric-sql/pglite` for PostgreSQL in the process,
28
- and `@types/react` for the front ends' types.
25
+ On Deno, name it `copilotz` in `deno.json` (`"copilotz": "jsr:@copilotz/copilotz@^1.0.0-rc.21"`),
26
+ and the imports below are the same everywhere. Some pieces need a package of their own, installed
27
+ beside it: `esbuild` to bundle the web host on Node, `@electric-sql/pglite` for PostgreSQL in the
28
+ process, and `@types/react` for the front ends' types.
29
29
 
30
30
  ## A first app
31
31
 
@@ -98,12 +98,13 @@ The package's entry points, the same names on npm (`copilotz/…`) and JSR (`@co
98
98
  | `copilotz/stores/latency` | `withLatency(store, ms)`: a store with round trips, to measure |
99
99
  | `copilotz/blobs/files` | `fileBlobs({ dir })`: blobs as files |
100
100
  | `copilotz/blobs/http` | `httpBlobs({ url, headers })`: blobs in a bucket (S3, GCS, R2…) |
101
+ | `copilotz/blobs/gcs` | `gcsBlobs({ bucket, prefix })`: blobs in a Google Cloud Storage bucket, as the instance's service account |
101
102
  | `copilotz/plugins/models` | `models`: llm, embeddings, transcription, the models.dev catalog |
102
- | `copilotz/plugins/agents` | `chat`, `history`, `memory`, `memoryExtraction`, `team`, `skills`, `routines`, `tool` |
103
- | `copilotz/plugins/agents/web` | their web front ends: `chatWeb`, `teamWeb`, `memoryWeb`, `skillsWeb`, `routinesWeb` |
103
+ | `copilotz/plugins/agents` | `chat`, `history`, `memory`, `memoryExtraction`, `team`, `skills`, `routines`, `tiers`, `openapi`, `tool` |
104
+ | `copilotz/plugins/agents/web` | their web front ends: `chatWeb`, `teamWeb`, `memoryWeb`, `skillsWeb`, `routinesWeb`, `tiersWeb` |
104
105
  | `copilotz/plugins/agents/terminal` | their terminal front ends: `chatTerminal`, `memoryTerminal` |
105
- | `copilotz/plugins/access` | `access` (`spaces`, `identity`), `accounts`, `directory`, `googleSignIn` |
106
- | `copilotz/plugins/access/web` | `spacesWeb`, `accountsWeb` |
106
+ | `copilotz/plugins/access` | `access` (`spaces`, `identity`, `contacts`), `accounts`, `directory`, `googleSignIn` |
107
+ | `copilotz/plugins/access/web` | `spacesWeb`, `accountsWeb`, `contactsWeb` |
107
108
  | `copilotz/plugins/access/terminal` | `accessTerminal` |
108
109
  | `copilotz/plugins/billing` | `usage`: the ledger |
109
110
  | `copilotz/plugins/billing/web` | `usageWeb` |
@@ -112,14 +113,14 @@ The package's entry points, the same names on npm (`copilotz/…`) and JSR (`@co
112
113
  | `copilotz/plugins/compute/web` | `computersWeb` |
113
114
  | `copilotz/plugins/compute/terminal` | `computersTerminal` |
114
115
  | `copilotz/plugins/compute/downloads` | `computerDownloads`: the computer program's release, served by the app (Node) |
115
- | `copilotz/plugins/interfaces` | `terminalPlugin` (the terminal's data), `api`, `whatsapp` |
116
+ | `copilotz/plugins/interfaces` | `terminalPlugin` (the terminal's data), `api`, `whatsapp`, `voice`, `mcp`, `maintenance` |
116
117
  | `copilotz/plugins/interfaces/web` | `webShell` (the web's root View), `apiWeb`, `whatsappWeb` |
117
118
  | `copilotz/plugins/interfaces/terminal` | `terminalShell`: the terminal's root View |
118
119
  | `copilotz/web` | the web host in the browser (`web`), and its toolkit (`Button`, `Markdown`…) |
119
- | `copilotz/web/server` | its server half: `webServer`, `socket` |
120
+ | `copilotz/web/server` | its server half: `webServer`, `socket`; `routeHost` (the app's routes alone) |
120
121
  | `copilotz/web/tickets` | `createTickets`: sessions traded for one-time tickets |
121
122
  | `copilotz/web/theme` | `themeOf(plugins)`: the app's theme, for the page's first paint |
122
- | `copilotz/web/node` | `bundle` (the browser's code, with esbuild), `serve`, `listen` (HTTP, sockets) |
123
+ | `copilotz/web/node` | `bundle` (the browser's code, with esbuild), `serve`, `serveRoutes`, `listen` (HTTP, sockets) |
123
124
  | `copilotz/orgs` | `orgsHost`: many orgs behind one address, each a runtime of its own |
124
125
  | `copilotz/terminal` | the terminal host: `terminal({ runtime, me })`, and its toolkit |
125
126
  | `copilotz/exporters` | `otlp`, `exposition`: metrics out, the OpenTelemetry way |
@@ -193,6 +194,48 @@ each socket to the runtime of the org its request is for:
193
194
  `listen({ fetch: host.serve, hypervisor: (request) => host.openRuntime(request)?.hypervisor })`
194
195
  (`examples/web-node/orgs.ts`).
195
196
 
197
+ ### Without the web app
198
+
199
+ An app people use on WhatsApp or on the phone needs no page: `serveRoutes` serves its plugins'
200
+ routes alone (`routes` resources: Meta's webhook, Twilio's), `GET /health` for whatever watches it,
201
+ and 404 for anything else. Nobody signs in there: a route's Action is called as a visitor, and its
202
+ `allow` decides (a webhook checks the request's signature, then acts for the person it's from with
203
+ `ctx.as`). Deno and Bun run it too.
204
+
205
+ ```ts
206
+ import { createRuntime } from "copilotz";
207
+ import { serveRoutes } from "copilotz/web/node";
208
+
209
+ const runtime = await createRuntime({ store, plugins });
210
+ const server = await serveRoutes({ runtime, hostname: "0.0.0.0", port: 8080 });
211
+ // A deploy's SIGTERM: stop listening, give running turns a while, close the runtime.
212
+ process.once("SIGTERM", () => server.close({ drain: 8_000 }));
213
+ ```
214
+
215
+ A `serve` route may take a WebSocket of its own (a voice call's relay): `host.upgrade()` accepts the
216
+ request's upgrade, and the route answers with the response it gives. It can refuse first (`403`,
217
+ before any handshake). The socket is a browser's `WebSocket` as far as `onmessage`, `send` and
218
+ `close` go; the listener (`serveRoutes`, or the web host's `serve`) takes it.
219
+
220
+ ```ts
221
+ routes: {
222
+ relay: {
223
+ path: "/voice/relay",
224
+ serve: (request, host) => {
225
+ if (!signed(request)) return new Response("Forbidden", { status: 403 });
226
+ const { socket, response } = host.upgrade();
227
+ socket.onmessage = async (event) => socket.send(await answer(host.runtime, event.data));
228
+ return response;
229
+ },
230
+ },
231
+ },
232
+ ```
233
+
234
+ A runtime that declares the `socket` transport (remote executors) still takes its sockets at
235
+ `/oxian`. `routeHost(runtime)` (`copilotz/web/server`) is the same as a fetch handler, for another
236
+ listener; a route's socket needs Oxian's (`copilotz/web/node`'s). The example is
237
+ `examples/web-node/routes.ts`.
238
+
196
239
  ## Installing a computer
197
240
 
198
241
  People's computers run the computer program (`plugins/compute/computers/program/`), a single
@@ -204,7 +247,7 @@ and an app serves it from there by default:
204
247
  import { computerDownloads } from "copilotz/plugins/compute/downloads";
205
248
 
206
249
  plugins: [...plugins, await computerDownloads()], // this Copilotz's release
207
- plugins: [...plugins, await computerDownloads({ dir: "dist/computer/1.0.0-rc.2" })], // its own: /computer/download/
250
+ plugins: [...plugins, await computerDownloads({ dir: "dist/computer/1.0.0-rc.21" })], // its own: /computer/download/
208
251
  plugins: [...plugins, await computerDownloads({ url: "https://downloads.example.com/computer/" })], // or elsewhere
209
252
  ```
210
253
 
@@ -303,11 +346,23 @@ name, never by importing its code.
303
346
  **`agents/`**: conversations and the agents in them.
304
347
 
305
348
  - **`chat`**: threads, messages, and agents
306
- (`{ instructions, model, effort?, maxTokens?, temperature?, tools? }`) that answer with tools,
307
- calling models through `llm`. A reasoning model's thinking (its provider state) is kept on the
308
- agent's tool steps and goes back to that model while its turn goes on.
349
+ (`{ instructions, model, effort?, maxTokens?, temperature?, tools?, history? }`) that answer with
350
+ tools, calling models through `llm`. A reasoning model's thinking (its provider state) is kept on
351
+ the agent's tool steps and goes back to that model while its turn goes on.
309
352
  - **Several agents** take turns in parallel. With `send_message` an agent messages another agent
310
353
  or a person, and waits for the replies before it continues.
354
+ - **History by age:** an agent with `history: { maxAge: 4 * 3_600_000 }` (ms) is sent only the
355
+ last four hours of a conversation, back from its newest message (summaries too, with `history`);
356
+ what's older stays in the chat. The start moves in steps of a tenth of `maxAge`, so prompts keep
357
+ hitting the provider's cache ([design](design/views.md#history-as-views)).
358
+ - **A tool call runs once:** before a step's tools run, the step's calls are written (an
359
+ `intent`), and what each returns as soon as it does. A retried turn (it failed after its tools
360
+ ran, its executor died, the runtime restarted) goes on with those calls instead of asking its
361
+ model again: a call that returned isn't run again, and one cut short runs again as itself, with
362
+ the same `ctx.callId` and `ctx.retry` true. Pass `callId` to an outside API as the idempotency
363
+ key, or call recorded Actions (they answer from the log), and a payment behind a tool is made
364
+ once. A turn that ends without its step (failed for good, stopped) keeps it, saying which calls
365
+ never returned, so people and its later turns know what happened.
311
366
  - **Subthreads are forks:** whoever works in one sees the conversation up to the message it hangs
312
367
  from, through every level, without anything being copied. A new thread starts from its first
313
368
  message and records the thread it came from.
@@ -326,6 +381,16 @@ name, never by importing its code.
326
381
  the `transcribe` model alias), and agents read the transcript. If it fails nothing is sent
327
382
  (`transcription_failed`); `transcribe: false` sends audio as it is. A voice message may say
328
383
  nothing else; its file carries `voice` (duration, peaks) for its player.
384
+ - **In spaces:** chat declares its own `shared` entries (threads, messages with labels, files,
385
+ what's being written), so an app with the access plugin needn't. A chat's messages, files and
386
+ live writing are part of it (`part: "thread"`): shared on its own (with a contact), its parts
387
+ come with it. `chat.open` opens an empty chat in a space; `chat.say` has an agent say a fixed
388
+ message there without a turn (trusted code only: a payment confirmed), which goes out like any
389
+ of its answers.
390
+ - **After an answer:** a medium that can (WhatsApp) shows features' additions
391
+ (`resources.additions.<name> = { order?, agents? }` and an `addition:<name>` View there), each
392
+ once per chat per key, recorded in `shown`; the model is told what went (`[then shown: …]`). A
393
+ message tapped from a button carries `tap: { id, title, key }`, and agents read the id.
329
394
  - **`history`** keeps chat history from outgrowing the prompt
330
395
  (`resources: { history: { summarizer: "openai/gpt-5.4-mini" } }`): every message stays whole, a
331
396
  cheap model writes a line for each and merges pairs up a binary tree, and an agent gets recent
@@ -354,6 +419,23 @@ name, never by importing its code.
354
419
  - **`routines`**: a message sent to an agent on a schedule, in a space ("every weekday at 9:00, ask
355
420
  @researcher for the news"), as whoever made it, reaching only what they reach; each run's chat and
356
421
  outcome are kept. Agents make them from a conversation too (`schedule_routine`).
422
+ - **`tiers`**: which models the app's agents think with, named by what the work needs (Everyday,
423
+ Expert…): the app declares each tier's model for each agent; an org chooses one, a space can
424
+ choose another, and either can pick a model for one agent, the tier's list kept behind it. Kept by
425
+ name, so retuning a tier moves everyone on it; while an org hasn't chosen, its plan's tier
426
+ applies. Each tier shows what a typical reply comes to at the org's prices.
427
+ - **`openapi`**: an HTTP API's operations, from its OpenAPI 3 spec, as Actions and tools:
428
+ `openapi({ name: "trips", spec })` is a plugin with, for each operation, a recorded Action
429
+ (`trips.getTrip`: a turn tried again gets the call it already made back, not a second one) and a
430
+ tool calling it (`trips_getTrip`), which agents get by listing it in their `tools`. A tool's input
431
+ is one object: the path, query, header and cookie parameters beside the JSON body's properties
432
+ (refs followed; 3.0's `nullable` converted; read-only properties left out; two inputs of one name
433
+ fail). Its settings are a resource (`resources.openapi.trips`: `baseUrl`, `headers` static or a
434
+ hook per call, `query`, `timeout`, `maxBytes`), so a deployment says where and as whom. A failed
435
+ call says `HTTP <status>: <what the API said>` and carries its status. Files in a response (an
436
+ image as base64 or a data URL, in the fields `files` names, or a response that is one) become
437
+ files of the conversation, and the agent gets a reference instead (`maxFileBytes`, `fileTypes`). A
438
+ tool of your own is `{ ...trips.tools.getTrip, run }`.
357
439
 
358
440
  **`access/`**: who can see and do what (see [design/access.md](design/access.md)).
359
441
 
@@ -364,6 +446,12 @@ name, never by importing its code.
364
446
  it's one; a new space has the app's default agents. An answer drawn from a space not everyone in
365
447
  the conversation can see shows only to those who see both, marked, until someone shares it.
366
448
  - **`identity`**: people, sessions and keys, and who a secret proves.
449
+ - **`contacts`**: people outside the org who talk to its agents (a WhatsApp customer). A contact is
450
+ its own kind of actor (`{ kind: "contact", id }`), never a person: every Action and query stays
451
+ shut to it unless it says otherwise (`peopleOrContacts`, as `chat.send` does). Its chat lives in
452
+ the line's space and is shared with it on its own: it reaches that chat, what's said and filed
453
+ there, and nothing else; the space's people reach it as any chat there, and the agent working for
454
+ the contact reaches exactly that chat. Agents are told whom they're talking with.
367
455
  - **`googleSignIn`**: sign-in with a Google ID token (the `google` resource names your client).
368
456
  - **`accounts`**: outside accounts a person connects once, for their agents to use: first their
369
457
  ChatGPT plan, as a model provider, instead of the app's API key. Tokens are a private field only
@@ -382,9 +470,15 @@ name, never by importing its code.
382
470
  billing; billing builds on models. An app records its own uses with `usage.record`.
383
471
  - **Rated as recorded,** so a record keeps what applied. Cost comes from `resources.cost` (the
384
472
  app's rates: negotiated, a subscription at 0, compute by the second), else from the catalog's
385
- prices; price comes from `resources.price` only (rates of its own, or a `markup` on cost). Rates
386
- are keyed by subject, then `provider/*`, then the catalog, then `*`, and dated lists apply each
387
- rate from its `since`. A use nothing prices is kept and flagged `unpriced`.
473
+ prices (each kind of token at its own: input, cache reads and writes, output, reasoning). The
474
+ price is the cost, a margin of 0, unless `resources.price` says otherwise: rates of its own, or
475
+ a gross margin on the cost (`{ "*": { margin: 0.2 }, "cloud/*": { margin: 0.9 } }`: 0.9 is ten
476
+ times the cost). Rates are keyed by subject, then `provider/*`, then the catalog, then `*`, and
477
+ dated lists apply each rate from its `since`, so a new margin applies from its date on. Each
478
+ record keeps its cost and price by part too, and what caching saved. A use nothing prices is
479
+ kept and flagged `unpriced`.
480
+ - **People see prices** (what they're charged); costs, and so margins, only platform staff and the
481
+ system.
388
482
  - **Totals** by any field or tag, summed by the store (`aggregate`) over indexed fields (time,
389
483
  meter, subject, thread; more from the app:
390
484
  `collections: { usage: { indexes: [["tags.tenant", "at"]] } }`):
@@ -398,8 +492,19 @@ name, never by importing its code.
398
492
  from an older day. `schedules: { "usage.close": null }` turns them off.
399
493
  - **Re-rating** (`usage.rerate`) never changes a record: it appends adjustments, dated when made,
400
494
  and totals follow.
401
- - **On the web** (`usageWeb`): an org's Usage page, day by day and against the period before, by
402
- person, agent and model; owners and admins see everyone's, anyone else their own.
495
+ - **Categories:** each meter is one (`llm`, `embeddings` and `transcription` are agents',
496
+ `computer` computers', `app` apps'; any other its own); totals group and filter by `category`,
497
+ and rollups serve it. Rollups keep `tags.space` too; days rolled up in another shape are closed
498
+ again, and read from records until then.
499
+ - **Across an org:** `usage.org` (totals, naming what they're grouped by as the caller reaches it)
500
+ and `usage.activity` (agents' turns, computers' sessions, apps' days and conversations' upkeep,
501
+ newest first): owners and admins see everyone's, anyone else their own. What a tag points to is
502
+ named by the plugin that owns it, in the `usageNames` resource kind
503
+ (`{ tag: "tags.app", collection: "app", field: "name" }`); a tag nobody names shows as its id.
504
+ - **On the web** (`usageWeb`): an org's Usage page: the billing month's spend against the budget
505
+ and credits left (from the credits plugin, when it's there) and the same point last month; a
506
+ daily chart and a ranked list by kind, space, person, agent or model, whose rows filter the
507
+ page; and activity. Staff see cost and margin in place.
403
508
 
404
509
  **`compute/`**: **`computers`**, machines people connect (the computer program in
405
510
  `computers/program/`, a worker of the plugin's `computer` kind) and their desks, one per space
@@ -420,7 +525,42 @@ filled by the front ends through resources).
420
525
  server-sent events, as that person, in that space only.
421
526
  - **`whatsapp`**: people talk to their agents from WhatsApp, through Meta's Cloud API. A space's
422
527
  managers connect a number; a person links their phone with a code; what they send becomes their
423
- messages, and what agents say to them goes back, a long answer in several messages.
528
+ messages, and what agents say to them goes back, a long answer in several messages. It's a medium
529
+ for Views (renderer `whatsapp`, parts built with its toolkit: text, buttons, a list, a carousel,
530
+ an image, a document, each checked against Meta's limits): after an answer, features show more
531
+ (`additions`: a carousel of trips, buttons to pay), once per chat per key, the answer's text in
532
+ the same message when there's room, a fallback when Meta refuses one; taps come back with their
533
+ ids. Pictures and files go as public links, signed links to the app's routes or files (the `links`
534
+ resource, `{ origin, secret }`; the runtime's `signLink`, `verifyLink`), or uploads. Opened to
535
+ anyone (`whatsapp.set`, or declared in the app's settings: `whatsapp.lines`), a number is a
536
+ customer line: a stranger who writes is a contact, in a chat of their own in the number's space,
537
+ answered by its agent, and a chat quiet for the number's `gap` (12 hours) is over: their next
538
+ message starts a new one.
539
+ - **`voice`**: people call the app's phone number and talk to its agents, through Twilio's
540
+ ConversationRelay (Twilio hears them and speaks; the app gets and sends text). The app declares
541
+ its lines (`voice.lines`: the space, Twilio's account and auth token, the app's public address,
542
+ the agent, language, voice, greeting and limits); Twilio's webhook is checked against its
543
+ signature, a call is taken within its caller's limits and the line's (calls at once, a day: else
544
+ busy, nothing spent) and opens the line's socket with a one-time ticket. A caller is a contact in
545
+ a chat of their own, the same one when they call back only if Twilio verified their number; what
546
+ the agent writes for them is said as it writes it (a medium for Views: renderer `voice`), a caller
547
+ speaking over it cuts it there (the agent is told what was heard), a failed or slow answer says a
548
+ short line in the line's language, and silence, a call too long or too many prompts, or the
549
+ agent's `end_call` end it. Managers block a caller (`voice.block`). Its socket needs a host that
550
+ takes a route's socket (`serveRoutes`).
551
+ - **`mcp`**: models outside the app (ChatGPT, Claude, any MCP client) call its tools. A line the app
552
+ declares (`mcp.lines.<name>`: its space, the tools it lists, each with its `tool:<name>` View, how
553
+ each is shown, who calls, its limits) is an MCP server at `POST /mcp/<name>`: Streamable HTTP,
554
+ JSON-RPC 2.0, no session, MCP 2026-07-28 and the versions with a handshake. Each conversation
555
+ (ChatGPT's `openai/session`, or a `chat` handle the app gives a client that names none) is a
556
+ contact in a chat of its own in the line's space, its ids an HMAC with the `links` secret. A call
557
+ runs the tool through chat's runner as that contact, is written there as a step, and answers what
558
+ the app's agents read of it (only public errors say their words); a request sent again to a tool
559
+ that changes things is answered from the first, and the line's limits (calls at once, a minute,
560
+ new conversations an hour, by conversation, user, caller's address and in all) refuse the rest.
561
+ - **`maintenance`**: HTTP for an app's operators when they can't reach its database, with one key:
562
+ read SQL, the collections' operations through the owner, raw SQL writes inside it, blobs by id
563
+ (see [Maintenance](#maintenance)).
424
564
 
425
565
  **Metrics** (`copilotz/exporters`): what the runtime and plugins do, measured. There's no plugin to
426
566
  add: each plugin instruments itself.
@@ -494,7 +634,163 @@ one conformance suite (`stores/tests/`). [`stores/README.md`](stores/README.md)
494
634
  and lists exactly which parts of the MongoDB collection API they support, and how. A PostgreSQL
495
635
  store holds one tenant (an org): many share a schema, each kept apart by the store itself, and an
496
636
  org's rows copy elsewhere unchanged (`copyTenant`). Blobs (strings over 16 KiB, files people send)
497
- live in the store by default, or as files (`fileBlobs`) or in a bucket (`httpBlobs`).
637
+ live in the store by default, or as files (`fileBlobs`), in a bucket (`httpBlobs`), or in Google
638
+ Cloud Storage (`gcsBlobs`).
639
+
640
+ ## Maintenance
641
+
642
+ When an app's operators can't reach its database (a client's network that keeps their database user
643
+ out), the `maintenance` plugin (`copilotz/plugins/interfaces`) answers for it over HTTP, under
644
+ `/maintenance/`, with a key the app gives it:
645
+ `resources: { maintenance: { key: process.env.MAINTENANCE_KEY } }`. It's the one place an app runs
646
+ SQL of its own: plugin code never does.
647
+
648
+ ```sh
649
+ curl https://app.example.com/maintenance/sql -H "authorization: Bearer $KEY" \
650
+ -d '{"sql": "SELECT _id, text FROM message WHERE thread = $1", "params": ["t1"]}'
651
+ ```
652
+
653
+ | Endpoint | What it does |
654
+ | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
655
+ | `GET /maintenance/` | What's here: whether the store runs SQL, the collections, the limits |
656
+ | `POST /maintenance/sql` | `{ sql, params?, limit?, timeout? }`: one read-only statement: `{ rows, count, truncated, ms }` |
657
+ | `POST /maintenance/sql/write` | `{ sql, params?, limit?, timeout? }`: one that writes, in the owner: `{ changed, rows, event }` |
658
+ | `POST /maintenance/collections/<collection>/<op>` | `insertOne` `{ doc }`… `deleteMany` `{ filter }`, and `find`, `findOne`, `countDocuments`, `aggregate` |
659
+ | `POST /maintenance/queries/<collection>.<name>` | A collection's named query (`booking.stats`), the body its params: `{ result, ms }` |
660
+ | `GET /maintenance/blobs/<sha256-…>` | A blob's bytes and type, as a download |
661
+
662
+ - **Keys:** `key`, or several in `keys` while one rotates (add the new, move clients, drop the old).
663
+ Each is at least 32 random characters: a short one, or one plainly not random, stops the app from
664
+ starting. Every request shows one (`Authorization: Bearer <key>`), compared in constant time;
665
+ without a key configured, every request is unauthorized, the same answer as a wrong key.
666
+ - **Who:** a request acts as the maintenance actor
667
+ (`{ kind: "maintenance", id: "maintenance", by }`, `by` from `X-Maintenance-By`, as said). Its
668
+ Actions let only it call them, and run as the system on the record (`ctx.as()`): no rule keeps it
669
+ from a document, and every event says `via` it. Writes take an `Idempotency-Key`: sent again, one
670
+ answers what it did the first time.
671
+ - **On record twice:** before it runs, each request writes a line (`log`, by default JSON on
672
+ standard output, which Cloud Run keeps): who, what (a statement's SHA-256, its params' count; an
673
+ operation, a query, a blob), which key, when. A SQL write also records a `maintenance.sql` event
674
+ in the same commit. The line is the record the key's holder can't rewrite.
675
+ - **Limits:** `limit` rows (1,000), `timeout` ms (30 s) and `bytes` of rows in an answer (8 MB; past
676
+ it the rows are cut, and `truncated` says so). A request may ask for less. A pipeline stops at the
677
+ limit too.
678
+ - **Operations go through the owner's write path:** checked against the collection's schema,
679
+ recorded as its events, cached and heard by Processors like any write. Prefer them. Named queries
680
+ run as the system does them (`runtime.query` with no actor), and check their own params.
681
+ - **Read SQL** is one statement (a `;` outside its strings and comments ends it; PostgreSQL's line
682
+ comments end at a CR too, and maintenance reads strings with `standard_conforming_strings` on) in
683
+ a read-only transaction, always rolled back, stopped at its limit and cut off at its timeout.
684
+ - **Raw SQL writes run inside the owner** (`runtime.maintenance.write`, see `runtime/maintain.ts`),
685
+ for what operations can't do: alone among its writes (those running end first, the next wait for
686
+ it), in a transaction fenced by its epoch, so an owner that lost the store can't run one, with its
687
+ `maintenance.sql` event in the same commit (the statement, its params, the rows it changed in any
688
+ table, who). It bypasses schemas and per-document events, so the owner then forgets what it
689
+ derived from documents: its cache empties, observed Views run again, and the clock reads the
690
+ timers again. A statement that ends or nests its transaction (`COMMIT`, `SAVEPOINT`…) or changes
691
+ its connection (`SET`, `PREPARE`, `LISTEN`, SQLite's `ATTACH`, `PRAGMA`…) doesn't run, and in
692
+ PostgreSQL neither does one that reaches past the statement: `ALTER ROLE` (a role may set its own
693
+ password and settings, which outlive the key), `DO` (a block runs statements nothing reads first)
694
+ and `LOCK` (it would hold the store's tables against the app's own writes). A write still holds
695
+ the row locks it takes (the rows an `UPDATE` changes) until it commits: app writes to those rows
696
+ wait, at most its `timeout`, and with at most 2 maintenance statements at once. One that changes
697
+ the store's own state (`meta`: the fencing epoch, Processors' positions), or what the role holds
698
+ (a large object, a setting), or, in SQLite, leaves a temporary object, is rolled back. The record
699
+ keeps a password literal as `PASSWORD '***'`.
700
+ - **Nothing outlives its statement:** on a PostgreSQL server each statement runs on a connection of
701
+ its own, closed after, so what it sets on its session (a setting, a session lock, a prepared
702
+ statement) goes with it; and it goes over the extended protocol, where the server refuses a second
703
+ statement whatever the check said. PGlite has one session: it forgets what maintenance left there
704
+ (`DISCARD ALL`). A SQLite read runs apart, in a process of this runtime of its own on a read-only
705
+ connection, killed at its timeout: a statement that never ends doesn't hold the app, a core or the
706
+ WAL. The process is `deno`, `node` or `bun` itself (never a compiled app, which would be the app
707
+ again), with an empty environment, and on Deno and Node allowed to read the database's files and
708
+ nothing else; on Deno it's started only with permission to run already granted, so nothing ever
709
+ asks mid-request. Where none can start (a database opened another way, `:memory:`, a compiled app,
710
+ no permission), reads run on the store's reading connection, one at a time, with no timeout, a
711
+ pragma only from those that only read: the store says so once, with why, and each such answer says
712
+ `inline: true`. SQLite writes name the store's tables in `main`, so nothing temporary stands in
713
+ for them. Each store runs at most 2 maintenance statements at once
714
+ (`maintenance: { connections }`): another answers busy (503).
715
+ - **Where:** SQL needs a SQL store. On a PostgreSQL server only as a role of its own (below), never
716
+ in a schema other tenants share; PGlite, in the app's process, runs it as its one session where it
717
+ reaches no other schema. An orgs host's orgs don't get the plugin at all (one key would reach
718
+ every org). Operations, named queries and blobs work everywhere, the memory store too, and need no
719
+ role.
720
+
721
+ ### A role of its own
722
+
723
+ On a PostgreSQL server, raw SQL runs only as a role of its own, named by the store:
724
+ `postgresStore({ url, schema, maintenance: { url: process.env.MAINTENANCE_DATABASE_URL } })`.
725
+ Without one it's refused. The store's role owns the tables, may stop the app's connections and is
726
+ whatever the deployment made it (a superuser, even): nothing that runs at a key's word should be it.
727
+
728
+ Before each statement, on the connection that runs it, and again after a write in its transaction,
729
+ maintenance checks that the role holds exactly what the SQL below grants, and refuses it otherwise
730
+ (rolling a write back), saying what's more: an attribute beyond `LOGIN` (superuser, `CREATEROLE`…);
731
+ membership in any role at all, predefined (`pg_*`) or not, and whatever its `INHERIT` or `SET`
732
+ options (a member could `SET ROLE` to it); settings of its own (`ALTER ROLE … SET`); anything it
733
+ owns, a large object too (what it makes for its own session, a temporary table, goes with its
734
+ connection); anything granted to it outside the store's schema and database; `CREATE` on any schema
735
+ (`public` too) or on the database; any privilege on a table or a column of another schema; on the
736
+ store's own tables, anything beyond the grants below (no `TRIGGER`, `TRUNCATE` or `REFERENCES`; on
737
+ `events` only `INSERT`); a large object it may read (`lo_compat_privileges`, or one granted to
738
+ `PUBLIC`); a `SECURITY DEFINER` function it may run (one runs as its owner); `dblink` or
739
+ `postgres_fdw` in the database; and a trigger on the store's tables, which the store never makes.
740
+ The checks name every catalog they read as `pg_catalog`'s, after setting the search path back to it,
741
+ so nothing a statement made stands in for them.
742
+
743
+ Prefer a role with no password at all, signed in by the platform: Cloud SQL's IAM database
744
+ authentication, or a client certificate. A password is a second key, valid for as long as nobody
745
+ changes it. On Cloud SQL, with a service account of its own for maintenance:
746
+
747
+ ```sh
748
+ gcloud sql users create maintenance@PROJECT.iam --instance=INSTANCE --type=cloud_iam_service_account
749
+ gcloud projects add-iam-policy-binding PROJECT \
750
+ --member=serviceAccount:maintenance@PROJECT.iam.gserviceaccount.com \
751
+ --role=roles/cloudsql.instanceUser # and roles/cloudsql.client, to connect
752
+ # The app reaches it through the Cloud SQL Auth Proxy, which signs it in (no password):
753
+ # cloud-sql-proxy --auto-iam-authn --impersonate-service-account=maintenance@PROJECT.iam.gserviceaccount.com \
754
+ # --port 5433 PROJECT:REGION:INSTANCE
755
+ # MAINTENANCE_DATABASE_URL=postgres://maintenance%40PROJECT.iam@127.0.0.1:5433/DATABASE
756
+ ```
757
+
758
+ Cloud SQL makes such a role a member of its own marker role (`cloudsqliamserviceaccount`, or
759
+ `cloudsqliamuser` for a person): that one membership is allowed, without ADMIN OPTION. Every IAM
760
+ user is a member of the marker too, so the marker may hold nothing at all: grant it nothing, not
761
+ even the grants below (maintenance refuses a marker that holds anything). Then the grants below,
762
+ naming `"maintenance@PROJECT.iam"`.
763
+
764
+ Elsewhere, as the store's role (the schema's owner), with the schema made (the app has started
765
+ once), and as a role that may create roles for the first line:
766
+
767
+ ```sql
768
+ -- LOGIN and nothing else; never grant it a role. (On Cloud SQL with IAM, gcloud makes it.)
769
+ CREATE ROLE copilotz_maintenance LOGIN PASSWORD '…' NOINHERIT;
770
+ GRANT USAGE ON SCHEMA copilotz TO copilotz_maintenance;
771
+ -- Reading everything there, the collections' views too, now and later.
772
+ GRANT SELECT ON ALL TABLES IN SCHEMA copilotz TO copilotz_maintenance;
773
+ ALTER DEFAULT PRIVILEGES IN SCHEMA copilotz GRANT SELECT ON TABLES TO copilotz_maintenance;
774
+ -- Changing documents, edges, vectors and blobs.
775
+ GRANT INSERT, UPDATE, DELETE ON copilotz.nodes, copilotz.edges, copilotz.vectors, copilotz.blobs
776
+ TO copilotz_maintenance;
777
+ -- Appending to the log (its own audit events), never changing it.
778
+ GRANT INSERT ON copilotz.events TO copilotz_maintenance;
779
+ -- Holding the fence while it writes (FOR SHARE needs it); a statement that changes meta is rolled back.
780
+ GRANT UPDATE (value) ON copilotz.meta TO copilotz_maintenance;
781
+ -- PostgreSQL 14 and earlier let everyone create in public.
782
+ REVOKE CREATE ON SCHEMA public FROM PUBLIC;
783
+ ```
784
+
785
+ Replace `copilotz` with the store's schema. `PUBLIC` keeps `CONNECT` on the database, `TEMPORARY`,
786
+ and `USAGE` on `public`; those are allowed. A `SECURITY DEFINER` function can be run by everyone
787
+ (`PUBLIC`) unless revoked: find them, and revoke it from each (or maintenance refuses, naming them):
788
+
789
+ ```sql
790
+ SELECT p.oid::regprocedure FROM pg_proc p WHERE p.prosecdef
791
+ AND p.pronamespace NOT IN ('pg_catalog'::regnamespace, 'information_schema'::regnamespace);
792
+ REVOKE EXECUTE ON FUNCTION some_schema.some_function(…) FROM PUBLIC;
793
+ ```
498
794
 
499
795
  ## The example app
500
796
 
@@ -533,7 +829,7 @@ connects a computer to it; `/approve once|thread|always|no` answers what agents
533
829
 
534
830
  Inside the chat: `/new`, `/threads`, `/open <n>`, `/history`, `/memories`, `/usage [all]`,
535
831
  `/metrics [name]` (with `OTEL_EXPORTER_OTLP_ENDPOINT` set, metrics also go to that collector),
536
- `/prompt [agent]`, `/fork`, `/retry`, `/events [n]`, `/stats`, `/sql <query>` (SQLite only),
832
+ `/prompt [agent]`, `/fork`, `/retry`, `/events [n]`, `/stats`, `/sql <query>` (a SQL store),
537
833
  `/quit`. Every turn prints its time, its database round trips, the jobs sent to executors and the
538
834
  calls they made back to the owner.
539
835
 
@@ -575,6 +871,14 @@ The log records what happened, with no bookkeeping tables beside it:
575
871
  completion is the only extra commit.
576
872
  - `started` records the call's own `startedAt`; `completed` and `failed` record its duration in
577
873
  `ms`. An event's `at` is its commit time. An action opts out with `record: false`.
874
+ - **Private fields** (`private: ["buyer", "passengers"]` on an Action, dot paths as a
875
+ collection's): its calls are recorded without them, in `started`'s input and `completed`'s
876
+ result alike, so personal data a call is given stays out of the log while the call is still
877
+ recorded and retried. Its `inputHash` (and a nested call's id) still covers the whole input: a
878
+ retry with the same input finds the call, and a changed one is a new call. That hash is in the
879
+ log: whoever knows the rest of an input could check a guess of a field easy to guess alone (a
880
+ CPF) against it. A result that had any is kept whole in `sys.results`, with the completion
881
+ (`private: true` there), so a retry answers with all of it.
578
882
  - **Retries.** The log is the receipt store; no other table holds them.
579
883
  - `runtime.call(action, input, { id })` makes a call retryable. If that id already completed, the
580
884
  call returns its recorded result without running; if it's still running, the call joins it;
@@ -592,6 +896,10 @@ The log records what happened, with no bookkeeping tables beside it:
592
896
  - **Processor deliveries:** every failed attempt records `processor.retried`
593
897
  `{ attempt, after, error }` before the next one. After the last attempt, `processor.failed`
594
898
  `{ attempts, error }` is the dead letter.
899
+ - **Closing:** `runtime.close()` starts no more deliveries or timer occurrences, and gives the
900
+ running ones `drain` ms to finish (`close({ drain })`, 5 s by default); what's still running
901
+ then stops where it is. A delivery that didn't finish keeps its Processor's cursor before its
902
+ event, so the next owner delivers it again, with `retry`: a deploy never drops one.
595
903
  - **Outside effects (payments, emails, outside APIs):** write the intent first, call out with its
596
904
  id as the idempotency key, then write the result. The intent's commit carries the call's start,
597
905
  so the attempt is on record before anything leaves the system.
@@ -602,7 +910,12 @@ The log records what happened, with no bookkeeping tables beside it:
602
910
  any event back to the request that started it.
603
911
  - **Blobs.** Strings over 16 KiB (configurable) are stored once, named by the hash of their content
604
912
  (`sha256-…`). Documents and events hold `{ $blob, size, type }` in their place. The owner moves
605
- values out on write and back in on read, so plugin code never sees a reference.
913
+ values out on write and back in on read, so plugin code never sees a reference. Only the owner
914
+ makes them: a `$blob` key anywhere in what plugin code writes, or in what an Action is called
915
+ with, is refused (`invalid`), and so is any part of an update's field path that starts with `$` or
916
+ is `__proto__` (an aggregate's `$group` names no `$…` field either). A path ends at a reference as
917
+ at a string. On read, only an exact reference (those three keys, a `sha256-<64 hex>` id) loads a
918
+ blob; any other object is data. Blob stores take no other id.
606
919
 
607
920
  ## Schedules
608
921
 
@@ -658,6 +971,8 @@ changed, a limited result lost a member, or an existing document newly matched a
658
971
  differs between stores); reads inside a transaction, which see the transaction's own writes.
659
972
  - **Freshness:** a read that raced a commit to its collection doesn't fill the cache, and a
660
973
  transaction's changes reach the cache only once committed, before its events go out.
974
+ - **Maintenance SQL** (see [Maintenance](#maintenance)) changes what the cache can't follow: the
975
+ owner empties it after one commits, and a read in flight across that fills nothing.
661
976
 
662
977
  `runtime/tests/cache.test.ts` checks every cached query against a direct store read after each of
663
978
  900 random writes, on every store. `createRuntime({ cache: false })` turns the cache off; `stats()`
@@ -754,8 +1069,8 @@ Copilotz runs on Node (first), Deno and Bun, and is built for Cloudflare Workers
754
1069
  beside the runtime, which declares the `socket` transport). A browser reads a collection directly
755
1070
  only when a rule speaks for it; anything else, through queries that let its person. Writes are
756
1071
  Actions. Plugins answer their own HTTP through the `routes` resource (a webhook, an OAuth
757
- callback, an API, a download), and files people sent are served at `/files/<id>` to whoever may
758
- read them, with ranges.
1072
+ callback, an API, a download, a socket of their own), and files people sent are served at
1073
+ `/files/<id>` to whoever may read them, with ranges.
759
1074
  - **The design system** (`design/views.md`, "The design system"): the web host owns a token
760
1075
  vocabulary (shadcn's names) and its defaults, which are Copilotz's look (navy, the logo's cyan and
761
1076
  blue, Manrope and Space Grotesk, its logo and icon), and an app rebrands with a `theme` resource
@@ -800,7 +1115,8 @@ Copilotz runs on Node (first), Deno and Bun, and is built for Cloudflare Workers
800
1115
  system, which no rule restricts; its events say `via` whom.
801
1116
  - Remote executors prove the deployment key, compared in constant time.
802
1117
  - **Private fields** (`private: ["token"]` on a collection): what an actor's queries and Views
803
- read comes without them; Actions and Processors acting for them still read them.
1118
+ read comes without them; Actions and Processors acting for them still read them. No event holds
1119
+ them, on any store, and none holds an Action's (`private: ["buyer"]`) either.
804
1120
  - **Processors:** per-key ordering, a durable cursor, at-least-once delivery, made idempotent by
805
1121
  deterministic ids. A `where` MongoDB filter on event data keeps unwanted events from being
806
1122
  dispatched at all.
@@ -821,18 +1137,18 @@ runtime/ the engine and its ports (Store, Blobs, Exporter, Transport, Clo
821
1137
  executor, ops, wire, collection, mongo, the in-memory store; tests/
822
1138
  stores/ where the runtime keeps things: the Store port's implementations (memory, sql/
823
1139
  sqlite and postgres with a shared translation, the latency wrapper) and Blobs'
824
- (blobs/files, blobs/http); tests/ (conformance)
1140
+ (blobs/files, blobs/http, blobs/gcs); tests/ (conformance)
825
1141
  exporters/ where measurements go: the Exporter port's implementations (OTLP, Prometheus)
826
1142
  plugins/ the features, by theme
827
1143
  models/ one plugin: llm, embeddings, transcription; shared/ (providers, model choice,
828
1144
  models.dev catalog)
829
- agents/ chat, history, memory, team, skills, routines
1145
+ agents/ chat, history, memory, team, skills, routines, tiers
830
1146
  billing/ usage (the ledger)
831
1147
  access/ spaces (members, reach, rules), identity, Google sign-in, connected accounts, the
832
1148
  directory of orgs
833
1149
  compute/ computers: desks per space, agents' tools, approvals; program/, the computer program
834
1150
  interfaces/ terminal (where each person is, the shell View), web (the web shell), the developer
835
- API and WhatsApp; features'
1151
+ API, WhatsApp, voice (phone calls), MCP and maintenance; features'
836
1152
  own front ends live with them (chat/terminal.ts, chat/web.tsx…), gathered by theme
837
1153
  hosts/ the media the app is used through: terminal (the Ink host and its toolkit); web
838
1154
  (the React host in the browser: theme/, the tokens and their defaults, Copilotz's
@@ -26,7 +26,24 @@
26
26
  * `{ suspended?, name? }`; `POST …/<id>/move` `{ schema }` (its rows to
27
27
  * another schema); `GET …/<id>/export` (its rows, as SQL); `POST
28
28
  * …/<id>/delete` `{ confirm: <its name> }`. The app does the rows'
29
- * part (`operations`). Staff enter any org with `/orgs/enter`.
29
+ * part (`operations`). Staff enter any org with `/orgs/enter` `{ org, staff:
30
+ * true }`, their own too; without it, they go into theirs as its people. Gift codes:
31
+ * `GET /console/codes`; `POST /console/codes` `{ amount, expires?, until?,
32
+ * note? }` (the code, shown this once); `POST /console/codes/revoke` `{ id }`.
33
+ * - Hosts orgs claimed (`claimHost` in an org's `directory` resource: a
34
+ * preview's `<id>-preview.copilotz.app`, an app's): with the app's own
35
+ * hosts named (`hosts`), a request to any other host is the org's that
36
+ * claimed it, answered by its runtime's routes by host alone (never its
37
+ * page or socket); a host nobody claimed is a 404. Which org a host is
38
+ * kept a minute, forgotten here as soon as an org claims or releases it.
39
+ * - `GET /__copilotz/hosts/resolve?host=<h>`: whose a host is, `{ org,
40
+ * target? }` (or 404), for the app's front only (it carries `front`'s
41
+ * secret): the front sends a host with a target (an app's service)
42
+ * straight there.
43
+ *
44
+ * Behind a front (a Cloudflare worker), `front: { secret }`: a request
45
+ * carrying the secret (`x-copilotz-front`) is for the host it forwards
46
+ * (`x-forwarded-host`); any other's forwarded headers are ignored.
30
47
  *
31
48
  * The app says how to open an org: its store (at the org's placement, as
32
49
  * its tenant), its plugins with the host's `here` (the org's name, and how
@@ -43,7 +60,13 @@ export type OrgInfo = {
43
60
  schema: string;
44
61
  };
45
62
  };
46
- export type OrgsHostOptions = Pick<WebServerOptions, "title" | "theme" | "google" | "dev" | "assets"> & {
63
+ export type OrgsHostOptions = Pick<WebServerOptions, "title" | "theme" | "google" | "dev" | "assets" | "front"> & {
64
+ /**
65
+ * The app's own hosts (`compass.copilotz.com`; patterns as routes' are,
66
+ * `*.run.app`): a request to any other is for a host an org claimed.
67
+ * Unset, every host is the app's, and claims route nothing.
68
+ */
69
+ hosts?: string[];
47
70
  /** The directory's runtime: identity, a sign-in method, and the directory plugin. */
48
71
  directory: Runtime;
49
72
  /**
@@ -77,6 +100,9 @@ export type OrgsHost = {
77
100
  serve(request: Request): Promise<Response>;
78
101
  openRuntime(request: Request): Runtime | undefined;
79
102
  runtime(org: string): Promise<Runtime | undefined>;
80
- close(): Promise<void>;
103
+ /** Closes every open org, each giving its running work `drain` ms (see `Runtime.close`). */
104
+ close(options?: {
105
+ drain?: number;
106
+ }): Promise<void>;
81
107
  };
82
108
  export declare function orgsHost(options: OrgsHostOptions): OrgsHost;