copilotz 1.0.0-rc.4 → 1.0.0-rc.42

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 (1354) hide show
  1. package/CHANGELOG.md +2372 -0
  2. package/README.md +265 -837
  3. package/hosts/terminal/contract.d.ts +1 -1
  4. package/hosts/terminal/host.js +13 -5
  5. package/hosts/web/assets.d.ts +14 -11
  6. package/hosts/web/assets.js +27 -18
  7. package/hosts/web/host-words.d.ts +1 -0
  8. package/hosts/web/host-words.js +24 -0
  9. package/hosts/web/host.d.ts +20 -4
  10. package/hosts/web/host.js +107 -31
  11. package/hosts/web/lazy.js +1 -1
  12. package/hosts/web/mod.d.ts +9 -7
  13. package/hosts/web/mod.js +14 -6
  14. package/hosts/web/node/bundle.d.ts +5 -0
  15. package/hosts/web/node/bundle.js +2 -2
  16. package/hosts/web/node/mod.d.ts +45 -19
  17. package/hosts/web/node/mod.js +45 -19
  18. package/hosts/web/node/serve.d.ts +57 -34
  19. package/hosts/web/node/serve.js +95 -28
  20. package/hosts/web/palette/palette.js +10 -10
  21. package/hosts/web/palette/sources.js +1 -1
  22. package/hosts/web/palette/words.d.ts +1 -0
  23. package/hosts/web/palette/words.js +23 -0
  24. package/hosts/web/part.js +5 -4
  25. package/hosts/web/pwa.js +1 -1
  26. package/hosts/web/server.d.ts +47 -93
  27. package/hosts/web/server.js +179 -162
  28. package/hosts/web/session.d.ts +27 -1
  29. package/hosts/web/session.js +34 -0
  30. package/hosts/web/signin-email.d.ts +56 -0
  31. package/hosts/web/signin-email.js +389 -0
  32. package/hosts/web/signin-words.d.ts +146 -0
  33. package/hosts/web/signin-words.js +167 -0
  34. package/hosts/web/signin.d.ts +26 -12
  35. package/hosts/web/signin.js +92 -56
  36. package/hosts/web/style.d.ts +1 -1
  37. package/hosts/web/style.js +10 -0
  38. package/hosts/web/surface.d.ts +20 -0
  39. package/hosts/web/surface.js +42 -0
  40. package/hosts/web/theme/css.d.ts +3 -2
  41. package/hosts/web/theme/css.js +10 -3
  42. package/hosts/web/theme/default.d.ts +1 -1
  43. package/hosts/web/theme/files/mod.d.ts +1 -1
  44. package/hosts/web/toolkit/ago.d.ts +0 -5
  45. package/hosts/web/toolkit/ago.js +17 -17
  46. package/hosts/web/toolkit/audio-player.d.ts +1 -1
  47. package/hosts/web/toolkit/audio-player.js +12 -7
  48. package/hosts/web/toolkit/button.js +6 -0
  49. package/hosts/web/toolkit/code-block.js +4 -3
  50. package/hosts/web/toolkit/copy-button.js +8 -2
  51. package/hosts/web/toolkit/detail-value.js +11 -7
  52. package/hosts/web/toolkit/dialog.js +2 -1
  53. package/hosts/web/toolkit/drawer.js +2 -1
  54. package/hosts/web/toolkit/formula.js +3 -2
  55. package/hosts/web/toolkit/humanize.d.ts +0 -12
  56. package/hosts/web/toolkit/humanize.js +2 -1
  57. package/hosts/web/toolkit/icon-button.js +6 -0
  58. package/hosts/web/toolkit/icon.d.ts +2 -0
  59. package/hosts/web/toolkit/icon.js +4 -0
  60. package/hosts/web/toolkit/inline-edit.js +2 -1
  61. package/hosts/web/toolkit/input.js +6 -0
  62. package/hosts/web/toolkit/long-text.js +2 -1
  63. package/hosts/web/toolkit/markdown/markdown.js +4 -3
  64. package/hosts/web/toolkit/terminal.js +5 -4
  65. package/hosts/web/toolkit/time.js +4 -2
  66. package/hosts/web/toolkit/words.d.ts +1 -0
  67. package/hosts/web/toolkit/words.js +60 -0
  68. package/hosts/web/update.js +2 -1
  69. package/hosts/web/widget.d.ts +31 -0
  70. package/hosts/web/widget.js +430 -0
  71. package/hosts/web/widgets.d.ts +43 -0
  72. package/hosts/web/widgets.js +118 -0
  73. package/hosts/web/words.d.ts +76 -0
  74. package/hosts/web/words.js +114 -0
  75. package/package.json +45 -13
  76. package/plugins/access/accounts/actions/callback.d.ts +0 -1
  77. package/plugins/access/accounts/actions/callback.js +20 -34
  78. package/plugins/access/accounts/actions/complete.js +2 -2
  79. package/plugins/access/accounts/actions/connect.js +2 -2
  80. package/plugins/access/accounts/actions/disconnect.js +8 -6
  81. package/plugins/access/accounts/actions/model-key.d.ts +5 -0
  82. package/plugins/access/accounts/actions/model-key.js +102 -0
  83. package/plugins/access/accounts/collections/account.d.ts +2 -2
  84. package/plugins/access/accounts/collections/account.js +2 -3
  85. package/plugins/access/accounts/collections/flow.d.ts +2 -2
  86. package/plugins/access/accounts/collections/model-key.d.ts +58 -0
  87. package/plugins/access/accounts/collections/model-key.js +17 -0
  88. package/plugins/access/accounts/contract.d.ts +1 -1
  89. package/plugins/access/accounts/mod.d.ts +7 -2
  90. package/plugins/access/accounts/mod.js +20 -5
  91. package/plugins/access/accounts/resources/models.js +2 -0
  92. package/plugins/access/accounts/routes/callback.d.ts +10 -0
  93. package/plugins/access/accounts/routes/callback.js +33 -0
  94. package/plugins/access/accounts/shared/flow.js +1 -1
  95. package/plugins/access/accounts/shared/oauth.d.ts +2 -2
  96. package/plugins/access/accounts/shared/oauth.js +2 -2
  97. package/plugins/access/accounts/shared/renew.js +4 -1
  98. package/plugins/access/accounts/shared/rules.d.ts +4 -2
  99. package/plugins/access/accounts/shared/rules.js +20 -5
  100. package/plugins/access/accounts/shared/settings.js +2 -2
  101. package/plugins/access/accounts/web.js +3 -3
  102. package/plugins/access/contacts/actions/chat.d.ts +1 -0
  103. package/plugins/access/contacts/actions/chat.js +45 -0
  104. package/plugins/access/contacts/actions/forget.d.ts +1 -0
  105. package/plugins/access/contacts/actions/forget.js +58 -0
  106. package/plugins/access/contacts/actions/start.d.ts +1 -0
  107. package/plugins/access/contacts/actions/start.js +60 -0
  108. package/plugins/access/contacts/collections/contact.d.ts +81 -0
  109. package/plugins/access/contacts/collections/contact.js +58 -0
  110. package/plugins/access/contacts/contract.d.ts +10 -0
  111. package/plugins/access/contacts/contract.js +10 -0
  112. package/plugins/access/contacts/mod.d.ts +31 -0
  113. package/plugins/access/contacts/mod.js +60 -0
  114. package/plugins/access/contacts/views/contact.d.ts +8 -0
  115. package/plugins/access/contacts/views/contact.js +26 -0
  116. package/plugins/access/contacts/web.d.ts +7 -0
  117. package/plugins/access/contacts/web.js +11 -0
  118. package/plugins/access/contract.d.ts +14 -0
  119. package/plugins/access/contract.js +12 -0
  120. package/plugins/access/dev/actions/sign-in.d.ts +1 -0
  121. package/plugins/access/dev/actions/sign-in.js +52 -0
  122. package/plugins/access/dev/mod.d.ts +17 -0
  123. package/plugins/access/dev/mod.js +32 -0
  124. package/plugins/access/dev/routes/sign-in.d.ts +8 -0
  125. package/plugins/access/dev/routes/sign-in.js +25 -0
  126. package/plugins/access/dev/shared/here.d.ts +4 -0
  127. package/plugins/access/dev/shared/here.js +32 -0
  128. package/plugins/access/dev/shared/nearby.d.ts +2 -0
  129. package/plugins/access/dev/shared/nearby.js +27 -0
  130. package/plugins/access/email/actions/import.d.ts +1 -0
  131. package/plugins/access/email/actions/import.js +54 -0
  132. package/plugins/access/email/actions/invite.d.ts +5 -0
  133. package/plugins/access/email/actions/invite.js +139 -0
  134. package/plugins/access/email/actions/prune.d.ts +1 -0
  135. package/plugins/access/email/actions/prune.js +20 -0
  136. package/plugins/access/email/actions/reset.d.ts +2 -0
  137. package/plugins/access/email/actions/reset.js +98 -0
  138. package/plugins/access/email/actions/send.d.ts +1 -0
  139. package/plugins/access/email/actions/send.js +41 -0
  140. package/plugins/access/email/actions/sign-in.d.ts +1 -0
  141. package/plugins/access/email/actions/sign-in.js +68 -0
  142. package/plugins/access/email/actions/sign-up.d.ts +4 -0
  143. package/plugins/access/email/actions/sign-up.js +105 -0
  144. package/plugins/access/email/adapters/console.d.ts +8 -0
  145. package/plugins/access/email/adapters/console.js +8 -0
  146. package/plugins/access/email/adapters/resend.d.ts +8 -0
  147. package/plugins/access/email/adapters/resend.js +29 -0
  148. package/plugins/access/email/collections/code.d.ts +118 -0
  149. package/plugins/access/email/collections/code.js +39 -0
  150. package/plugins/access/email/collections/login.d.ts +78 -0
  151. package/plugins/access/email/collections/login.js +28 -0
  152. package/plugins/access/email/collections/rate.d.ts +51 -0
  153. package/plugins/access/email/collections/rate.js +14 -0
  154. package/plugins/access/email/contract.d.ts +94 -0
  155. package/plugins/access/email/contract.js +7 -0
  156. package/plugins/access/email/mod.d.ts +63 -0
  157. package/plugins/access/email/mod.js +145 -0
  158. package/plugins/access/email/resources/messages.d.ts +9 -0
  159. package/plugins/access/email/resources/messages.js +55 -0
  160. package/plugins/access/email/routes/sign-in.d.ts +30 -0
  161. package/plugins/access/email/routes/sign-in.js +107 -0
  162. package/plugins/access/email/shared/codes.d.ts +41 -0
  163. package/plugins/access/email/shared/codes.js +90 -0
  164. package/plugins/access/email/shared/inputs.d.ts +32 -0
  165. package/plugins/access/email/shared/inputs.js +41 -0
  166. package/plugins/access/email/shared/limits.d.ts +31 -0
  167. package/plugins/access/email/shared/limits.js +56 -0
  168. package/plugins/access/email/shared/mail.d.ts +11 -0
  169. package/plugins/access/email/shared/mail.js +13 -0
  170. package/plugins/access/email/shared/password.d.ts +36 -0
  171. package/plugins/access/email/shared/password.js +85 -0
  172. package/plugins/access/email/shared/people.d.ts +34 -0
  173. package/plugins/access/email/shared/people.js +54 -0
  174. package/plugins/access/email/shared/settings.d.ts +29 -0
  175. package/plugins/access/email/shared/settings.js +39 -0
  176. package/plugins/access/google/actions/sign-in.js +5 -2
  177. package/plugins/access/google/adapters/keys.d.ts +4 -4
  178. package/plugins/access/google/adapters/keys.js +2 -2
  179. package/plugins/access/google/mod.d.ts +4 -2
  180. package/plugins/access/google/mod.js +6 -2
  181. package/plugins/access/google/routes/sign-in.d.ts +12 -0
  182. package/plugins/access/google/routes/sign-in.js +36 -0
  183. package/plugins/access/identity/actions/person.d.ts +7 -0
  184. package/plugins/access/identity/actions/person.js +38 -2
  185. package/plugins/access/identity/actions/session.js +10 -6
  186. package/plugins/access/identity/collections/credential.d.ts +9 -19
  187. package/plugins/access/identity/collections/credential.js +9 -24
  188. package/plugins/access/identity/collections/person.d.ts +9 -0
  189. package/plugins/access/identity/collections/person.js +2 -0
  190. package/plugins/access/identity/contract.d.ts +16 -2
  191. package/plugins/access/identity/contract.js +18 -1
  192. package/plugins/access/identity/mod.d.ts +16 -7
  193. package/plugins/access/identity/mod.js +43 -18
  194. package/plugins/access/identity/routes/session.d.ts +17 -0
  195. package/plugins/access/identity/routes/session.js +35 -0
  196. package/plugins/access/mod.d.ts +24 -6
  197. package/plugins/access/mod.js +9 -3
  198. package/plugins/access/spaces/actions/agents.js +15 -12
  199. package/plugins/access/spaces/actions/archive.js +4 -5
  200. package/plugins/access/spaces/actions/can.js +6 -6
  201. package/plugins/access/spaces/actions/create.js +17 -5
  202. package/plugins/access/spaces/actions/invitation.js +16 -13
  203. package/plugins/access/spaces/actions/keep.d.ts +1 -0
  204. package/plugins/access/spaces/actions/keep.js +55 -0
  205. package/plugins/access/spaces/actions/leave.js +2 -2
  206. package/plugins/access/spaces/actions/member.js +53 -39
  207. package/plugins/access/spaces/actions/org.d.ts +3 -2
  208. package/plugins/access/spaces/actions/org.js +26 -17
  209. package/plugins/access/spaces/actions/personal.js +12 -5
  210. package/plugins/access/spaces/actions/rename.js +8 -5
  211. package/plugins/access/spaces/actions/request.js +8 -13
  212. package/plugins/access/spaces/actions/share.js +2 -3
  213. package/plugins/access/spaces/collections/invitation.js +7 -5
  214. package/plugins/access/spaces/collections/member.d.ts +1 -1
  215. package/plugins/access/spaces/collections/profile.d.ts +61 -0
  216. package/plugins/access/spaces/collections/profile.js +54 -0
  217. package/plugins/access/spaces/collections/request.d.ts +1 -1
  218. package/plugins/access/spaces/collections/request.js +2 -2
  219. package/plugins/access/spaces/collections/space.d.ts +10 -1
  220. package/plugins/access/spaces/collections/space.js +34 -4
  221. package/plugins/access/spaces/contract.d.ts +65 -7
  222. package/plugins/access/spaces/contract.js +3 -0
  223. package/plugins/access/spaces/mod.d.ts +14 -2
  224. package/plugins/access/spaces/mod.js +30 -6
  225. package/plugins/access/spaces/processors/profile.d.ts +7 -0
  226. package/plugins/access/spaces/processors/profile.js +10 -0
  227. package/plugins/access/spaces/resources/commands.js +15 -5
  228. package/plugins/access/spaces/resources/tools.d.ts +0 -5
  229. package/plugins/access/spaces/resources/tools.js +14 -2
  230. package/plugins/access/spaces/shared/agents.js +2 -2
  231. package/plugins/access/spaces/shared/can.d.ts +27 -0
  232. package/plugins/access/spaces/shared/can.js +51 -0
  233. package/plugins/access/spaces/shared/declared.d.ts +21 -0
  234. package/plugins/access/spaces/shared/declared.js +8 -0
  235. package/plugins/access/spaces/shared/labels.d.ts +17 -1
  236. package/plugins/access/spaces/shared/labels.js +87 -12
  237. package/plugins/access/spaces/shared/managers.js +3 -3
  238. package/plugins/access/spaces/shared/names.d.ts +70 -0
  239. package/plugins/access/spaces/shared/names.js +105 -0
  240. package/plugins/access/spaces/shared/personal.d.ts +3 -2
  241. package/plugins/access/spaces/shared/personal.js +5 -3
  242. package/plugins/access/spaces/shared/profile.d.ts +21 -0
  243. package/plugins/access/spaces/shared/profile.js +27 -0
  244. package/plugins/access/spaces/shared/reach.d.ts +81 -9
  245. package/plugins/access/spaces/shared/reach.js +227 -24
  246. package/plugins/access/spaces/shared/rules.d.ts +26 -8
  247. package/plugins/access/spaces/shared/rules.js +124 -18
  248. package/plugins/access/spaces/shared/seat.d.ts +10 -0
  249. package/plugins/access/spaces/shared/seat.js +32 -0
  250. package/plugins/access/spaces/terminal.js +1 -1
  251. package/plugins/access/spaces/views/elsewhere.d.ts +9 -4
  252. package/plugins/access/spaces/views/elsewhere.js +32 -8
  253. package/plugins/access/spaces/views/web/agents.d.ts +6 -1
  254. package/plugins/access/spaces/views/web/agents.js +21 -21
  255. package/plugins/access/spaces/views/web/header.d.ts +3 -1
  256. package/plugins/access/spaces/views/web/header.js +26 -25
  257. package/plugins/access/spaces/views/web/invitation.d.ts +3 -1
  258. package/plugins/access/spaces/views/web/invitation.js +13 -10
  259. package/plugins/access/spaces/views/web/invitations.js +5 -2
  260. package/plugins/access/spaces/views/web/invite-dialog.d.ts +2 -2
  261. package/plugins/access/spaces/views/web/invite-dialog.js +6 -5
  262. package/plugins/access/spaces/views/web/invite.js +6 -5
  263. package/plugins/access/spaces/views/web/invited.js +4 -1
  264. package/plugins/access/spaces/views/web/inviting.js +11 -6
  265. package/plugins/access/spaces/views/web/members.d.ts +4 -1
  266. package/plugins/access/spaces/views/web/members.js +65 -23
  267. package/plugins/access/spaces/views/web/new-space.js +4 -3
  268. package/plugins/access/spaces/views/web/not-here.js +12 -16
  269. package/plugins/access/spaces/views/web/org-about.js +21 -18
  270. package/plugins/access/spaces/views/web/org-members.d.ts +1 -1
  271. package/plugins/access/spaces/views/web/org-members.js +34 -27
  272. package/plugins/access/spaces/views/web/palette.js +44 -33
  273. package/plugins/access/spaces/views/web/panel.d.ts +3 -2
  274. package/plugins/access/spaces/views/web/panel.js +36 -19
  275. package/plugins/access/spaces/views/web/pending.d.ts +3 -1
  276. package/plugins/access/spaces/views/web/pending.js +10 -7
  277. package/plugins/access/spaces/views/web/pick.js +10 -6
  278. package/plugins/access/spaces/views/web/sections.d.ts +31 -0
  279. package/plugins/access/spaces/views/web/sections.js +23 -0
  280. package/plugins/access/spaces/views/web/settings.js +26 -29
  281. package/plugins/access/spaces/views/web/space.d.ts +4 -2
  282. package/plugins/access/spaces/views/web/space.js +31 -14
  283. package/plugins/access/spaces/views/web/spaces.js +3 -2
  284. package/plugins/access/spaces/views/web/steps.js +19 -20
  285. package/plugins/access/spaces/views/web/style.d.ts +1 -1
  286. package/plugins/access/spaces/views/web/style.js +41 -0
  287. package/plugins/access/spaces/views/web/tabs.d.ts +18 -6
  288. package/plugins/access/spaces/views/web/tabs.js +26 -9
  289. package/plugins/access/spaces/views/web/tree.d.ts +7 -1
  290. package/plugins/access/spaces/views/web/tree.js +29 -21
  291. package/plugins/access/spaces/views/web/who.d.ts +38 -22
  292. package/plugins/access/spaces/views/web/who.js +80 -28
  293. package/plugins/access/spaces/views/web/words.d.ts +1 -0
  294. package/plugins/access/spaces/views/web/words.js +286 -0
  295. package/plugins/access/spaces/views/where.d.ts +4 -2
  296. package/plugins/access/spaces/views/where.js +18 -3
  297. package/plugins/access/spaces/web.js +64 -19
  298. package/plugins/access/web.d.ts +1 -0
  299. package/plugins/access/web.js +1 -0
  300. package/plugins/agents/chat/actions/attach.d.ts +3 -0
  301. package/plugins/agents/chat/actions/attach.js +92 -0
  302. package/plugins/agents/chat/actions/erase.d.ts +1 -0
  303. package/plugins/agents/chat/actions/erase.js +51 -0
  304. package/plugins/agents/chat/actions/fork.js +2 -2
  305. package/plugins/agents/chat/actions/import.d.ts +1 -0
  306. package/plugins/agents/chat/actions/import.js +244 -0
  307. package/plugins/agents/chat/actions/move.js +2 -2
  308. package/plugins/agents/chat/actions/open.d.ts +1 -0
  309. package/plugins/agents/chat/actions/open.js +49 -0
  310. package/plugins/agents/chat/actions/prune.d.ts +3 -0
  311. package/plugins/agents/chat/actions/prune.js +20 -0
  312. package/plugins/agents/chat/actions/quiet.d.ts +1 -0
  313. package/plugins/agents/chat/actions/quiet.js +33 -0
  314. package/plugins/agents/chat/actions/say.d.ts +1 -0
  315. package/plugins/agents/chat/actions/say.js +165 -0
  316. package/plugins/agents/chat/actions/send.d.ts +10 -0
  317. package/plugins/agents/chat/actions/send.js +240 -68
  318. package/plugins/agents/chat/actions/shown.d.ts +1 -0
  319. package/plugins/agents/chat/actions/shown.js +35 -0
  320. package/plugins/agents/chat/actions/stop.js +9 -2
  321. package/plugins/agents/chat/collections/file.d.ts +80 -3
  322. package/plugins/agents/chat/collections/file.js +65 -7
  323. package/plugins/agents/chat/collections/intent.d.ts +183 -0
  324. package/plugins/agents/chat/collections/intent.js +73 -0
  325. package/plugins/agents/chat/collections/live.d.ts +13 -2
  326. package/plugins/agents/chat/collections/live.js +11 -1
  327. package/plugins/agents/chat/collections/message.d.ts +227 -7
  328. package/plugins/agents/chat/collections/message.js +73 -6
  329. package/plugins/agents/chat/collections/shown.d.ts +105 -0
  330. package/plugins/agents/chat/collections/shown.js +34 -0
  331. package/plugins/agents/chat/collections/thread.d.ts +10 -1
  332. package/plugins/agents/chat/collections/thread.js +6 -4
  333. package/plugins/agents/chat/collections/wait.d.ts +14 -5
  334. package/plugins/agents/chat/collections/wait.js +4 -2
  335. package/plugins/agents/chat/contract.d.ts +27 -9
  336. package/plugins/agents/chat/contract.js +15 -0
  337. package/plugins/agents/chat/mod.d.ts +55 -8
  338. package/plugins/agents/chat/mod.js +141 -17
  339. package/plugins/agents/chat/processors/failed.js +30 -6
  340. package/plugins/agents/chat/processors/turn.d.ts +1 -1
  341. package/plugins/agents/chat/processors/turn.js +222 -53
  342. package/plugins/agents/chat/resources/commands.js +11 -2
  343. package/plugins/agents/chat/resources/tools.d.ts +3 -0
  344. package/plugins/agents/chat/resources/tools.js +112 -0
  345. package/plugins/agents/chat/routes/files.d.ts +39 -0
  346. package/plugins/agents/chat/routes/files.js +169 -0
  347. package/plugins/agents/chat/shared/agents.d.ts +17 -2
  348. package/plugins/agents/chat/shared/agents.js +22 -4
  349. package/plugins/agents/chat/shared/contact-send.d.ts +32 -0
  350. package/plugins/agents/chat/shared/contact-send.js +18 -0
  351. package/plugins/agents/chat/shared/delivery.d.ts +24 -4
  352. package/plugins/agents/chat/shared/delivery.js +99 -10
  353. package/plugins/agents/chat/shared/lineage.d.ts +31 -5
  354. package/plugins/agents/chat/shared/lineage.js +65 -21
  355. package/plugins/agents/chat/shared/live.d.ts +4 -2
  356. package/plugins/agents/chat/shared/live.js +2 -1
  357. package/plugins/agents/chat/shared/origin.d.ts +22 -0
  358. package/plugins/agents/chat/shared/origin.js +11 -0
  359. package/plugins/agents/chat/shared/send.d.ts +3 -1
  360. package/plugins/agents/chat/shared/send.js +160 -3
  361. package/plugins/agents/chat/shared/tools.d.ts +33 -0
  362. package/plugins/agents/chat/shared/tools.js +28 -0
  363. package/plugins/agents/chat/shared/types.d.ts +146 -10
  364. package/plugins/agents/chat/shared/types.js +3 -0
  365. package/plugins/agents/chat/shared/where.d.ts +20 -0
  366. package/plugins/agents/chat/shared/where.js +18 -0
  367. package/plugins/agents/chat/terminal.js +6 -6
  368. package/plugins/agents/chat/views/context.d.ts +4 -2
  369. package/plugins/agents/chat/views/context.js +7 -3
  370. package/plugins/agents/chat/views/history.d.ts +4 -0
  371. package/plugins/agents/chat/views/history.js +1 -1
  372. package/plugins/agents/chat/views/message.d.ts +8 -2
  373. package/plugins/agents/chat/views/message.js +55 -15
  374. package/plugins/agents/chat/views/participants.js +7 -1
  375. package/plugins/agents/chat/views/prompt.d.ts +3 -1
  376. package/plugins/agents/chat/views/prompt.js +66 -18
  377. package/plugins/agents/chat/views/terminal/agent-prompt.js +2 -2
  378. package/plugins/agents/chat/views/terminal/author.js +5 -1
  379. package/plugins/agents/chat/views/terminal/conversation.js +2 -2
  380. package/plugins/agents/chat/views/web/attach.d.ts +9 -3
  381. package/plugins/agents/chat/views/web/attach.js +17 -6
  382. package/plugins/agents/chat/views/web/chats.js +9 -6
  383. package/plugins/agents/chat/views/web/composer.d.ts +20 -4
  384. package/plugins/agents/chat/views/web/composer.js +64 -28
  385. package/plugins/agents/chat/views/web/conversation.d.ts +3 -2
  386. package/plugins/agents/chat/views/web/conversation.js +32 -15
  387. package/plugins/agents/chat/views/web/download.js +2 -1
  388. package/plugins/agents/chat/views/web/header.d.ts +2 -1
  389. package/plugins/agents/chat/views/web/header.js +8 -7
  390. package/plugins/agents/chat/views/web/held.d.ts +10 -9
  391. package/plugins/agents/chat/views/web/held.js +27 -20
  392. package/plugins/agents/chat/views/web/home.d.ts +3 -2
  393. package/plugins/agents/chat/views/web/home.js +13 -17
  394. package/plugins/agents/chat/views/web/listed.js +9 -7
  395. package/plugins/agents/chat/views/web/live.js +7 -6
  396. package/plugins/agents/chat/views/web/message.d.ts +12 -2
  397. package/plugins/agents/chat/views/web/message.js +45 -14
  398. package/plugins/agents/chat/views/web/missing.js +2 -1
  399. package/plugins/agents/chat/views/web/move.js +4 -3
  400. package/plugins/agents/chat/views/web/new-thread.js +2 -1
  401. package/plugins/agents/chat/views/web/over.d.ts +13 -9
  402. package/plugins/agents/chat/views/web/over.js +18 -10
  403. package/plugins/agents/chat/views/web/palette.js +20 -14
  404. package/plugins/agents/chat/views/web/picture.js +2 -1
  405. package/plugins/agents/chat/views/web/queued.js +3 -3
  406. package/plugins/agents/chat/views/web/recent.js +4 -3
  407. package/plugins/agents/chat/views/web/record.js +10 -12
  408. package/plugins/agents/chat/views/web/recorder.js +10 -9
  409. package/plugins/agents/chat/views/web/retrying.js +5 -4
  410. package/plugins/agents/chat/views/web/steps.js +8 -5
  411. package/plugins/agents/chat/views/web/style.d.ts +1 -1
  412. package/plugins/agents/chat/views/web/style.js +19 -6
  413. package/plugins/agents/chat/views/web/transcript.js +3 -2
  414. package/plugins/agents/chat/views/web/voice-failed.js +2 -1
  415. package/plugins/agents/chat/views/web/voice-note.js +2 -1
  416. package/plugins/agents/chat/views/web/who.js +4 -1
  417. package/plugins/agents/chat/views/web/words.d.ts +1 -0
  418. package/plugins/agents/chat/views/web/words.js +199 -0
  419. package/plugins/agents/chat/web.d.ts +5 -1
  420. package/plugins/agents/chat/web.js +14 -10
  421. package/plugins/agents/contract.d.ts +12 -0
  422. package/plugins/agents/contract.js +12 -0
  423. package/plugins/agents/history/collections/outline.d.ts +102 -9
  424. package/plugins/agents/history/collections/outline.js +26 -4
  425. package/plugins/agents/history/collections/summary.d.ts +15 -3
  426. package/plugins/agents/history/collections/summary.js +6 -1
  427. package/plugins/agents/history/mod.d.ts +21 -9
  428. package/plugins/agents/history/mod.js +26 -13
  429. package/plugins/agents/history/processors/compact.d.ts +7 -1
  430. package/plugins/agents/history/processors/compact.js +235 -81
  431. package/plugins/agents/history/processors/erase.d.ts +3 -0
  432. package/plugins/agents/history/processors/erase.js +11 -0
  433. package/plugins/agents/history/resources/tools.js +37 -16
  434. package/plugins/agents/history/shared/lines.d.ts +19 -4
  435. package/plugins/agents/history/shared/lines.js +36 -3
  436. package/plugins/agents/history/shared/settings.d.ts +5 -1
  437. package/plugins/agents/history/shared/summarized.d.ts +3 -0
  438. package/plugins/agents/history/shared/summarized.js +3 -1
  439. package/plugins/agents/history/shared/weight.d.ts +28 -0
  440. package/plugins/agents/history/shared/weight.js +62 -0
  441. package/plugins/agents/history/views/history.d.ts +6 -3
  442. package/plugins/agents/history/views/history.js +41 -14
  443. package/plugins/agents/history/views/since.d.ts +6 -3
  444. package/plugins/agents/history/views/since.js +10 -2
  445. package/plugins/agents/history/views/summary.d.ts +4 -1
  446. package/plugins/agents/history/views/summary.js +5 -2
  447. package/plugins/agents/memory/actions/import.d.ts +1 -0
  448. package/plugins/agents/memory/actions/import.js +88 -0
  449. package/plugins/agents/memory/collections/memory.d.ts +1 -1
  450. package/plugins/agents/memory/collections/memory.js +32 -6
  451. package/plugins/agents/memory/mod.d.ts +21 -8
  452. package/plugins/agents/memory/mod.js +40 -13
  453. package/plugins/agents/memory/processors/extract.d.ts +11 -2
  454. package/plugins/agents/memory/processors/extract.js +86 -18
  455. package/plugins/agents/memory/resources/commands.js +1 -1
  456. package/plugins/agents/memory/resources/context.d.ts +12 -1
  457. package/plugins/agents/memory/resources/context.js +10 -2
  458. package/plugins/agents/memory/resources/tools.js +76 -16
  459. package/plugins/agents/memory/shared/scope.d.ts +35 -6
  460. package/plugins/agents/memory/shared/scope.js +84 -19
  461. package/plugins/agents/memory/shared/search.d.ts +5 -2
  462. package/plugins/agents/memory/shared/search.js +40 -14
  463. package/plugins/agents/memory/shared/settings.d.ts +17 -4
  464. package/plugins/agents/memory/shared/settings.js +15 -4
  465. package/plugins/agents/memory/terminal.js +1 -1
  466. package/plugins/agents/memory/views/context.d.ts +4 -7
  467. package/plugins/agents/memory/views/context.js +92 -44
  468. package/plugins/agents/memory/views/memory.d.ts +1 -0
  469. package/plugins/agents/memory/views/memory.js +4 -2
  470. package/plugins/agents/memory/views/terminal/memory.d.ts +4 -1
  471. package/plugins/agents/memory/views/terminal/memory.js +7 -2
  472. package/plugins/agents/memory/views/web/card.d.ts +4 -2
  473. package/plugins/agents/memory/views/web/card.js +12 -8
  474. package/plugins/agents/memory/views/web/list.d.ts +3 -1
  475. package/plugins/agents/memory/views/web/list.js +30 -18
  476. package/plugins/agents/memory/views/web/memories.js +9 -4
  477. package/plugins/agents/memory/views/web/move.js +4 -3
  478. package/plugins/agents/memory/views/web/palette.js +8 -5
  479. package/plugins/agents/memory/views/web/pick.js +15 -10
  480. package/plugins/agents/memory/views/web/words.d.ts +1 -0
  481. package/plugins/agents/memory/views/web/words.js +48 -0
  482. package/plugins/agents/memory/web.js +12 -4
  483. package/plugins/agents/mod.d.ts +9 -5
  484. package/plugins/agents/mod.js +9 -5
  485. package/plugins/agents/openapi/actions/operation.d.ts +11 -0
  486. package/plugins/agents/openapi/actions/operation.js +86 -0
  487. package/plugins/agents/openapi/contract.d.ts +77 -0
  488. package/plugins/agents/openapi/mod.d.ts +5 -0
  489. package/plugins/agents/openapi/mod.js +75 -0
  490. package/plugins/agents/openapi/resources/tools.d.ts +9 -0
  491. package/plugins/agents/openapi/resources/tools.js +23 -0
  492. package/plugins/agents/openapi/shared/files.d.ts +4 -0
  493. package/plugins/agents/openapi/shared/files.js +128 -0
  494. package/plugins/agents/openapi/shared/plan.d.ts +34 -0
  495. package/plugins/agents/openapi/shared/plan.js +122 -0
  496. package/plugins/agents/openapi/shared/request.d.ts +15 -0
  497. package/plugins/agents/openapi/shared/request.js +87 -0
  498. package/plugins/agents/openapi/shared/response.d.ts +24 -0
  499. package/plugins/agents/openapi/shared/response.js +133 -0
  500. package/plugins/agents/openapi/shared/schema.d.ts +20 -0
  501. package/plugins/agents/openapi/shared/schema.js +128 -0
  502. package/plugins/agents/openapi/shared/settings.d.ts +22 -0
  503. package/plugins/agents/openapi/shared/settings.js +34 -0
  504. package/plugins/agents/openapi/shared/spec.d.ts +55 -0
  505. package/plugins/agents/openapi/shared/spec.js +99 -0
  506. package/plugins/agents/routines/actions/create.js +24 -12
  507. package/plugins/agents/routines/actions/delete.js +2 -2
  508. package/plugins/agents/routines/actions/origin.d.ts +1 -0
  509. package/plugins/agents/routines/actions/origin.js +32 -0
  510. package/plugins/agents/routines/actions/pause.js +2 -2
  511. package/plugins/agents/routines/actions/resume.js +2 -2
  512. package/plugins/agents/routines/actions/run.js +4 -4
  513. package/plugins/agents/routines/actions/update.js +18 -10
  514. package/plugins/agents/routines/collections/routine.d.ts +18 -6
  515. package/plugins/agents/routines/collections/routine.js +14 -8
  516. package/plugins/agents/routines/collections/run.d.ts +10 -1
  517. package/plugins/agents/routines/collections/run.js +2 -0
  518. package/plugins/agents/routines/contract.d.ts +7 -1
  519. package/plugins/agents/routines/mod.d.ts +10 -2
  520. package/plugins/agents/routines/mod.js +23 -3
  521. package/plugins/agents/routines/resources/tools.js +100 -29
  522. package/plugins/agents/routines/shared/fire.d.ts +7 -2
  523. package/plugins/agents/routines/shared/fire.js +33 -15
  524. package/plugins/agents/routines/shared/routines.d.ts +17 -8
  525. package/plugins/agents/routines/shared/routines.js +33 -19
  526. package/plugins/agents/routines/shared/schedule.d.ts +5 -0
  527. package/plugins/agents/routines/shared/schedule.js +12 -1
  528. package/plugins/agents/routines/views/web/form.d.ts +4 -3
  529. package/plugins/agents/routines/views/web/form.js +29 -7
  530. package/plugins/agents/routines/views/web/new.js +1 -1
  531. package/plugins/agents/routines/views/web/page.d.ts +2 -1
  532. package/plugins/agents/routines/views/web/page.js +32 -10
  533. package/plugins/agents/routines/views/web/routines.d.ts +2 -1
  534. package/plugins/agents/routines/views/web/routines.js +1 -1
  535. package/plugins/agents/routines/views/web/step.js +3 -1
  536. package/plugins/agents/routines/views/web/style.d.ts +1 -1
  537. package/plugins/agents/routines/views/web/style.js +1 -0
  538. package/plugins/agents/routines/web.js +6 -6
  539. package/plugins/agents/skills/actions/create.js +2 -2
  540. package/plugins/agents/skills/actions/delete.js +2 -2
  541. package/plugins/agents/skills/actions/update.js +2 -2
  542. package/plugins/agents/skills/collections/skill.d.ts +1 -1
  543. package/plugins/agents/skills/collections/skill.js +4 -4
  544. package/plugins/agents/skills/mod.js +14 -5
  545. package/plugins/agents/skills/resources/tools.js +1 -1
  546. package/plugins/agents/skills/shared/skills.d.ts +2 -2
  547. package/plugins/agents/skills/shared/skills.js +3 -6
  548. package/plugins/agents/skills/shared/write.d.ts +2 -3
  549. package/plugins/agents/skills/shared/write.js +2 -1
  550. package/plugins/agents/skills/views/context.d.ts +8 -4
  551. package/plugins/agents/skills/views/context.js +9 -4
  552. package/plugins/agents/skills/views/web/page.js +7 -3
  553. package/plugins/agents/skills/web.js +8 -6
  554. package/plugins/agents/web.d.ts +0 -1
  555. package/plugins/agents/web.js +0 -1
  556. package/plugins/agents/webtools/adapters/duckduckgo.d.ts +21 -0
  557. package/plugins/agents/webtools/adapters/duckduckgo.js +168 -0
  558. package/plugins/agents/webtools/adapters/fake.d.ts +3 -0
  559. package/plugins/agents/webtools/adapters/fake.js +8 -0
  560. package/plugins/agents/webtools/adapters/serper.d.ts +2 -0
  561. package/plugins/agents/webtools/adapters/serper.js +30 -0
  562. package/plugins/agents/webtools/contract.d.ts +72 -0
  563. package/plugins/agents/webtools/contract.js +1 -0
  564. package/plugins/agents/webtools/mod.d.ts +55 -0
  565. package/plugins/agents/webtools/mod.js +75 -0
  566. package/plugins/agents/webtools/resources/tools.d.ts +2 -0
  567. package/plugins/agents/webtools/resources/tools.js +82 -0
  568. package/plugins/agents/webtools/shared/address.d.ts +9 -0
  569. package/plugins/agents/webtools/shared/address.js +112 -0
  570. package/plugins/agents/webtools/shared/read.d.ts +11 -0
  571. package/plugins/agents/webtools/shared/read.js +129 -0
  572. package/plugins/agents/webtools/shared/search.d.ts +15 -0
  573. package/plugins/agents/webtools/shared/search.js +54 -0
  574. package/plugins/agents/webtools/shared/settings.d.ts +20 -0
  575. package/plugins/agents/webtools/shared/settings.js +21 -0
  576. package/plugins/agents/webtools/shared/text.d.ts +15 -0
  577. package/plugins/agents/webtools/shared/text.js +88 -0
  578. package/plugins/billing/mod.d.ts +4 -1
  579. package/plugins/billing/mod.js +4 -1
  580. package/plugins/billing/usage/actions/activity.d.ts +84 -0
  581. package/plugins/billing/usage/actions/activity.js +310 -0
  582. package/plugins/billing/usage/actions/close.js +16 -4
  583. package/plugins/billing/usage/actions/org.d.ts +29 -1
  584. package/plugins/billing/usage/actions/org.js +24 -67
  585. package/plugins/billing/usage/actions/quote.d.ts +7 -0
  586. package/plugins/billing/usage/actions/quote.js +86 -0
  587. package/plugins/billing/usage/actions/rerate.js +1 -0
  588. package/plugins/billing/usage/collections/closed.d.ts +11 -1
  589. package/plugins/billing/usage/collections/closed.js +4 -1
  590. package/plugins/billing/usage/collections/rollup.d.ts +4 -4
  591. package/plugins/billing/usage/collections/rollup.js +8 -4
  592. package/plugins/billing/usage/collections/usage.d.ts +7 -6
  593. package/plugins/billing/usage/collections/usage.js +16 -12
  594. package/plugins/billing/usage/mod.d.ts +22 -7
  595. package/plugins/billing/usage/mod.js +32 -9
  596. package/plugins/billing/usage/shared/categories.d.ts +24 -0
  597. package/plugins/billing/usage/shared/categories.js +40 -0
  598. package/plugins/billing/usage/shared/names.d.ts +45 -0
  599. package/plugins/billing/usage/shared/names.js +60 -0
  600. package/plugins/billing/usage/shared/rate.d.ts +10 -3
  601. package/plugins/billing/usage/shared/rate.js +18 -3
  602. package/plugins/billing/usage/shared/settings.d.ts +18 -1
  603. package/plugins/billing/usage/shared/settings.js +11 -2
  604. package/plugins/billing/usage/shared/totals.d.ts +19 -5
  605. package/plugins/billing/usage/shared/totals.js +45 -10
  606. package/plugins/billing/usage/shared/use.d.ts +1 -2
  607. package/plugins/billing/usage/shared/use.js +6 -8
  608. package/plugins/billing/usage/terminal.js +1 -1
  609. package/plugins/billing/usage/views/web/chart.d.ts +25 -12
  610. package/plugins/billing/usage/views/web/chart.js +72 -61
  611. package/plugins/billing/usage/views/web/numbers.d.ts +77 -53
  612. package/plugins/billing/usage/views/web/numbers.js +221 -84
  613. package/plugins/billing/usage/views/web/org.d.ts +122 -12
  614. package/plugins/billing/usage/views/web/org.js +571 -222
  615. package/plugins/billing/usage/views/web/style.d.ts +9 -8
  616. package/plugins/billing/usage/views/web/style.js +147 -141
  617. package/plugins/billing/usage/views/web/words.d.ts +1 -0
  618. package/plugins/billing/usage/views/web/words.js +173 -0
  619. package/plugins/billing/usage/web.d.ts +8 -6
  620. package/plugins/billing/usage/web.js +9 -7
  621. package/plugins/billing/web.d.ts +2 -0
  622. package/plugins/billing/web.js +2 -0
  623. package/plugins/compute/apps/actions/build.d.ts +1 -0
  624. package/plugins/compute/apps/actions/build.js +99 -0
  625. package/plugins/compute/apps/actions/configure.d.ts +1 -0
  626. package/plugins/compute/apps/actions/configure.js +74 -0
  627. package/plugins/compute/apps/actions/list.d.ts +1 -0
  628. package/plugins/compute/apps/actions/list.js +13 -0
  629. package/plugins/compute/apps/actions/meter.d.ts +1 -0
  630. package/plugins/compute/apps/actions/meter.js +43 -0
  631. package/plugins/compute/apps/actions/publish.d.ts +1 -0
  632. package/plugins/compute/apps/actions/publish.js +41 -0
  633. package/plugins/compute/apps/actions/redeploy.d.ts +1 -0
  634. package/plugins/compute/apps/actions/redeploy.js +26 -0
  635. package/plugins/compute/apps/actions/remove.d.ts +1 -0
  636. package/plugins/compute/apps/actions/remove.js +47 -0
  637. package/plugins/compute/apps/adapters/cloudrun.d.ts +90 -0
  638. package/plugins/compute/apps/adapters/cloudrun.js +353 -0
  639. package/plugins/compute/apps/adapters/front.d.ts +24 -0
  640. package/plugins/compute/apps/adapters/front.js +131 -0
  641. package/plugins/compute/apps/adapters/local.d.ts +15 -0
  642. package/plugins/compute/apps/adapters/local.js +139 -0
  643. package/plugins/compute/apps/adapters/tar.d.ts +29 -0
  644. package/plugins/compute/apps/adapters/tar.js +178 -0
  645. package/plugins/compute/apps/collections/app.d.ts +143 -0
  646. package/plugins/compute/apps/collections/app.js +60 -0
  647. package/plugins/compute/apps/contract.d.ts +73 -0
  648. package/plugins/compute/apps/contract.js +8 -0
  649. package/plugins/compute/apps/mod.d.ts +42 -0
  650. package/plugins/compute/apps/mod.js +76 -0
  651. package/plugins/compute/apps/resources/tools.d.ts +10 -0
  652. package/plugins/compute/apps/resources/tools.js +85 -0
  653. package/plugins/compute/apps/shared/archive.d.ts +24 -0
  654. package/plugins/compute/apps/shared/archive.js +69 -0
  655. package/plugins/compute/apps/shared/claims.d.ts +28 -0
  656. package/plugins/compute/apps/shared/claims.js +18 -0
  657. package/plugins/compute/apps/shared/environment.d.ts +8 -0
  658. package/plugins/compute/apps/shared/environment.js +15 -0
  659. package/plugins/compute/apps/shared/errors.d.ts +4 -0
  660. package/plugins/compute/apps/shared/errors.js +4 -0
  661. package/plugins/compute/apps/shared/host.d.ts +19 -0
  662. package/plugins/compute/apps/shared/host.js +19 -0
  663. package/plugins/compute/apps/shared/label.d.ts +21 -0
  664. package/plugins/compute/apps/shared/label.js +51 -0
  665. package/plugins/compute/apps/shared/meter.d.ts +17 -0
  666. package/plugins/compute/apps/shared/meter.js +29 -0
  667. package/plugins/compute/apps/shared/publish.d.ts +41 -0
  668. package/plugins/compute/apps/shared/publish.js +141 -0
  669. package/plugins/compute/apps/shared/settings.d.ts +49 -0
  670. package/plugins/compute/apps/shared/settings.js +22 -0
  671. package/plugins/compute/apps/views/web/apps.d.ts +54 -0
  672. package/plugins/compute/apps/views/web/apps.js +48 -0
  673. package/plugins/compute/apps/views/web/env.d.ts +54 -0
  674. package/plugins/compute/apps/views/web/env.js +195 -0
  675. package/plugins/compute/apps/views/web/publish.d.ts +24 -0
  676. package/plugins/compute/apps/views/web/publish.js +158 -0
  677. package/plugins/compute/apps/views/web/space.d.ts +16 -0
  678. package/plugins/compute/apps/views/web/space.js +138 -0
  679. package/plugins/compute/apps/views/web/style.d.ts +7 -0
  680. package/plugins/compute/apps/views/web/style.js +155 -0
  681. package/plugins/compute/apps/web.d.ts +17 -0
  682. package/plugins/compute/apps/web.js +35 -0
  683. package/plugins/compute/cloud/actions/create.d.ts +1 -0
  684. package/plugins/compute/cloud/actions/create.js +79 -0
  685. package/plugins/compute/cloud/actions/daily.d.ts +1 -0
  686. package/plugins/compute/cloud/actions/daily.js +75 -0
  687. package/plugins/compute/cloud/actions/destroy.d.ts +1 -0
  688. package/plugins/compute/cloud/actions/destroy.js +71 -0
  689. package/plugins/compute/cloud/actions/may.d.ts +1 -0
  690. package/plugins/compute/cloud/actions/may.js +15 -0
  691. package/plugins/compute/cloud/actions/org.d.ts +1 -0
  692. package/plugins/compute/cloud/actions/org.js +21 -0
  693. package/plugins/compute/cloud/actions/pool-tick.d.ts +4 -0
  694. package/plugins/compute/cloud/actions/pool-tick.js +96 -0
  695. package/plugins/compute/cloud/actions/pool.d.ts +3 -0
  696. package/plugins/compute/cloud/actions/pool.js +100 -0
  697. package/plugins/compute/cloud/actions/release.d.ts +1 -0
  698. package/plugins/compute/cloud/actions/release.js +58 -0
  699. package/plugins/compute/cloud/actions/remote.d.ts +10 -0
  700. package/plugins/compute/cloud/actions/remote.js +26 -0
  701. package/plugins/compute/cloud/actions/tick.d.ts +1 -0
  702. package/plugins/compute/cloud/actions/tick.js +105 -0
  703. package/plugins/compute/cloud/actions/touch.d.ts +1 -0
  704. package/plugins/compute/cloud/actions/touch.js +32 -0
  705. package/plugins/compute/cloud/actions/vms.d.ts +7 -0
  706. package/plugins/compute/cloud/actions/vms.js +213 -0
  707. package/plugins/compute/cloud/actions/wake.d.ts +1 -0
  708. package/plugins/compute/cloud/actions/wake.js +153 -0
  709. package/plugins/compute/cloud/adapters/gce/index.d.ts +73 -0
  710. package/plugins/compute/cloud/adapters/gce/index.js +242 -0
  711. package/plugins/compute/cloud/adapters/local.d.ts +48 -0
  712. package/plugins/compute/cloud/adapters/local.js +188 -0
  713. package/plugins/compute/cloud/collections/cloud-computer.d.ts +109 -0
  714. package/plugins/compute/cloud/collections/cloud-computer.js +89 -0
  715. package/plugins/compute/cloud/collections/pool-vm.d.ts +79 -0
  716. package/plugins/compute/cloud/collections/pool-vm.js +36 -0
  717. package/plugins/compute/cloud/collections/pool-want.d.ts +94 -0
  718. package/plugins/compute/cloud/collections/pool-want.js +27 -0
  719. package/plugins/compute/cloud/contract.d.ts +242 -0
  720. package/plugins/compute/cloud/contract.js +73 -0
  721. package/plugins/compute/cloud/mod.d.ts +97 -0
  722. package/plugins/compute/cloud/mod.js +209 -0
  723. package/plugins/compute/cloud/processors/mark.d.ts +9 -0
  724. package/plugins/compute/cloud/processors/mark.js +13 -0
  725. package/plugins/compute/cloud/resources/tools.d.ts +3 -0
  726. package/plugins/compute/cloud/resources/tools.js +238 -0
  727. package/plugins/compute/cloud/shared/google.d.ts +75 -0
  728. package/plugins/compute/cloud/shared/google.js +218 -0
  729. package/plugins/compute/cloud/shared/host.d.ts +11 -0
  730. package/plugins/compute/cloud/shared/host.js +29 -0
  731. package/plugins/compute/cloud/shared/may.d.ts +21 -0
  732. package/plugins/compute/cloud/shared/may.js +22 -0
  733. package/plugins/compute/cloud/shared/meter.d.ts +36 -0
  734. package/plugins/compute/cloud/shared/meter.js +68 -0
  735. package/plugins/compute/cloud/shared/names.d.ts +10 -0
  736. package/plugins/compute/cloud/shared/names.js +11 -0
  737. package/plugins/compute/cloud/shared/people.d.ts +19 -0
  738. package/plugins/compute/cloud/shared/people.js +12 -0
  739. package/plugins/compute/cloud/shared/records.d.ts +31 -0
  740. package/plugins/compute/cloud/shared/records.js +18 -0
  741. package/plugins/compute/cloud/shared/settings.d.ts +70 -0
  742. package/plugins/compute/cloud/shared/settings.js +47 -0
  743. package/plugins/compute/cloud/shared/time.d.ts +21 -0
  744. package/plugins/compute/cloud/shared/time.js +33 -0
  745. package/plugins/compute/cloud/views/web/cloud.d.ts +79 -0
  746. package/plugins/compute/cloud/views/web/cloud.js +122 -0
  747. package/plugins/compute/cloud/views/web/computer.d.ts +37 -0
  748. package/plugins/compute/cloud/views/web/computer.js +195 -0
  749. package/plugins/compute/cloud/views/web/new.d.ts +27 -0
  750. package/plugins/compute/cloud/views/web/new.js +103 -0
  751. package/plugins/compute/cloud/views/web/style.d.ts +6 -0
  752. package/plugins/compute/cloud/views/web/style.js +84 -0
  753. package/plugins/compute/cloud/web.d.ts +19 -0
  754. package/plugins/compute/cloud/web.js +61 -0
  755. package/plugins/compute/computers/actions/admit.js +2 -0
  756. package/plugins/compute/computers/actions/allow-origin.d.ts +5 -0
  757. package/plugins/compute/computers/actions/allow-origin.js +48 -0
  758. package/plugins/compute/computers/actions/allowed.d.ts +1 -0
  759. package/plugins/compute/computers/actions/allowed.js +50 -0
  760. package/plugins/compute/computers/actions/approve.js +48 -10
  761. package/plugins/compute/computers/actions/code.js +6 -4
  762. package/plugins/compute/computers/actions/default.js +4 -8
  763. package/plugins/compute/computers/actions/enrollment.d.ts +1 -0
  764. package/plugins/compute/computers/actions/enrollment.js +51 -0
  765. package/plugins/compute/computers/actions/env.d.ts +3 -0
  766. package/plugins/compute/computers/actions/env.js +137 -0
  767. package/plugins/compute/computers/actions/forget-grant.d.ts +1 -0
  768. package/plugins/compute/computers/actions/forget-grant.js +16 -0
  769. package/plugins/compute/computers/actions/forget.js +15 -3
  770. package/plugins/compute/computers/actions/mark.d.ts +1 -0
  771. package/plugins/compute/computers/actions/mark.js +36 -0
  772. package/plugins/compute/computers/actions/move.js +5 -4
  773. package/plugins/compute/computers/actions/preview.d.ts +4 -0
  774. package/plugins/compute/computers/actions/preview.js +183 -0
  775. package/plugins/compute/computers/actions/provision.d.ts +1 -0
  776. package/plugins/compute/computers/actions/provision.js +51 -0
  777. package/plugins/compute/computers/actions/rename.js +2 -2
  778. package/plugins/compute/computers/actions/running.d.ts +1 -0
  779. package/plugins/compute/computers/actions/running.js +33 -0
  780. package/plugins/compute/computers/actions/scope.d.ts +1 -0
  781. package/plugins/compute/computers/actions/scope.js +61 -0
  782. package/plugins/compute/computers/actions/share.js +5 -4
  783. package/plugins/compute/computers/actions/unshare.js +5 -8
  784. package/plugins/compute/computers/actions/view.d.ts +1 -0
  785. package/plugins/compute/computers/actions/view.js +29 -0
  786. package/plugins/compute/computers/actions/work.js +44 -6
  787. package/plugins/compute/computers/collections/approval.d.ts +83 -7
  788. package/plugins/compute/computers/collections/approval.js +25 -5
  789. package/plugins/compute/computers/collections/computer.d.ts +69 -0
  790. package/plugins/compute/computers/collections/computer.js +18 -2
  791. package/plugins/compute/computers/collections/desk.d.ts +54 -1
  792. package/plugins/compute/computers/collections/desk.js +12 -4
  793. package/plugins/compute/computers/collections/enrollment.d.ts +1 -1
  794. package/plugins/compute/computers/collections/env-var.d.ts +122 -0
  795. package/plugins/compute/computers/collections/env-var.js +51 -0
  796. package/plugins/compute/computers/collections/grant.d.ts +21 -4
  797. package/plugins/compute/computers/collections/grant.js +21 -5
  798. package/plugins/compute/computers/collections/preview.d.ts +111 -0
  799. package/plugins/compute/computers/collections/preview.js +58 -0
  800. package/plugins/compute/computers/contract.d.ts +18 -0
  801. package/plugins/compute/computers/contract.js +8 -0
  802. package/plugins/compute/computers/mod.d.ts +10 -1
  803. package/plugins/compute/computers/mod.js +62 -8
  804. package/plugins/compute/computers/processors/left.d.ts +8 -0
  805. package/plugins/compute/computers/processors/left.js +31 -0
  806. package/plugins/compute/computers/program/version.d.ts +1 -1
  807. package/plugins/compute/computers/program/version.js +1 -1
  808. package/plugins/compute/computers/resources/commands.js +29 -13
  809. package/plugins/compute/computers/resources/downloads.js +11 -13
  810. package/plugins/compute/computers/resources/previews.d.ts +29 -0
  811. package/plugins/compute/computers/resources/previews.js +408 -0
  812. package/plugins/compute/computers/resources/tools.d.ts +11 -5
  813. package/plugins/compute/computers/resources/tools.js +153 -22
  814. package/plugins/compute/computers/shared/ask.d.ts +17 -5
  815. package/plugins/compute/computers/shared/ask.js +89 -14
  816. package/plugins/compute/computers/shared/asks.d.ts +2 -2
  817. package/plugins/compute/computers/shared/asks.js +3 -2
  818. package/plugins/compute/computers/shared/desks.d.ts +1 -5
  819. package/plugins/compute/computers/shared/desks.js +2 -11
  820. package/plugins/compute/computers/shared/env.d.ts +20 -0
  821. package/plugins/compute/computers/shared/env.js +50 -0
  822. package/plugins/compute/computers/shared/grants.d.ts +32 -0
  823. package/plugins/compute/computers/shared/grants.js +66 -0
  824. package/plugins/compute/computers/shared/jobs.d.ts +13 -0
  825. package/plugins/compute/computers/shared/jobs.js +16 -0
  826. package/plugins/compute/computers/shared/preview-url.d.ts +5 -0
  827. package/plugins/compute/computers/shared/preview-url.js +5 -0
  828. package/plugins/compute/computers/shared/seal.d.ts +4 -0
  829. package/plugins/compute/computers/shared/seal.js +60 -0
  830. package/plugins/compute/computers/shared/settings.d.ts +32 -5
  831. package/plugins/compute/computers/shared/settings.js +12 -0
  832. package/plugins/compute/computers/shared/wake.d.ts +43 -0
  833. package/plugins/compute/computers/shared/wake.js +78 -0
  834. package/plugins/compute/computers/shared/where.d.ts +34 -7
  835. package/plugins/compute/computers/shared/where.js +86 -17
  836. package/plugins/compute/computers/shared/workloads.d.ts +50 -0
  837. package/plugins/compute/computers/shared/workloads.js +4 -0
  838. package/plugins/compute/computers/terminal.js +1 -1
  839. package/plugins/compute/computers/views/context.d.ts +7 -6
  840. package/plugins/compute/computers/views/context.js +121 -42
  841. package/plugins/compute/computers/views/terminal/approvals.js +3 -1
  842. package/plugins/compute/computers/views/web/add.d.ts +41 -0
  843. package/plugins/compute/computers/views/web/add.js +60 -0
  844. package/plugins/compute/computers/views/web/allowed.d.ts +16 -0
  845. package/plugins/compute/computers/views/web/allowed.js +38 -0
  846. package/plugins/compute/computers/views/web/asked.d.ts +26 -7
  847. package/plugins/compute/computers/views/web/asked.js +47 -10
  848. package/plugins/compute/computers/views/web/asks.d.ts +14 -8
  849. package/plugins/compute/computers/views/web/asks.js +46 -18
  850. package/plugins/compute/computers/views/web/calls.js +5 -2
  851. package/plugins/compute/computers/views/web/computer.d.ts +4 -1
  852. package/plugins/compute/computers/views/web/computer.js +21 -2
  853. package/plugins/compute/computers/views/web/connect.d.ts +18 -3
  854. package/plugins/compute/computers/views/web/connect.js +52 -35
  855. package/plugins/compute/computers/views/web/desks.d.ts +19 -8
  856. package/plugins/compute/computers/views/web/desks.js +67 -37
  857. package/plugins/compute/computers/views/web/env.d.ts +32 -0
  858. package/plugins/compute/computers/views/web/env.js +154 -0
  859. package/plugins/compute/computers/views/web/environment.d.ts +23 -0
  860. package/plugins/compute/computers/views/web/environment.js +47 -0
  861. package/plugins/compute/computers/views/web/jobs.d.ts +18 -6
  862. package/plugins/compute/computers/views/web/jobs.js +56 -21
  863. package/plugins/compute/computers/views/web/kinds.d.ts +102 -0
  864. package/plugins/compute/computers/views/web/kinds.js +37 -0
  865. package/plugins/compute/computers/views/web/mark.d.ts +7 -2
  866. package/plugins/compute/computers/views/web/mark.js +2 -2
  867. package/plugins/compute/computers/views/web/names.d.ts +3 -2
  868. package/plugins/compute/computers/views/web/names.js +5 -3
  869. package/plugins/compute/computers/views/web/page.d.ts +14 -2
  870. package/plugins/compute/computers/views/web/page.js +48 -26
  871. package/plugins/compute/computers/views/web/previews.d.ts +44 -0
  872. package/plugins/compute/computers/views/web/previews.js +33 -0
  873. package/plugins/compute/computers/views/web/routine-panel.d.ts +14 -0
  874. package/plugins/compute/computers/views/web/routine-panel.js +91 -0
  875. package/plugins/compute/computers/views/web/serve.d.ts +47 -0
  876. package/plugins/compute/computers/views/web/serve.js +168 -0
  877. package/plugins/compute/computers/views/web/space-tab.d.ts +4 -3
  878. package/plugins/compute/computers/views/web/space-tab.js +39 -9
  879. package/plugins/compute/computers/views/web/step.js +7 -1
  880. package/plugins/compute/computers/views/web/style.d.ts +1 -1
  881. package/plugins/compute/computers/views/web/style.js +166 -2
  882. package/plugins/compute/computers/views/web/workspace.d.ts +16 -3
  883. package/plugins/compute/computers/views/web/workspace.js +49 -6
  884. package/plugins/compute/computers/web.d.ts +17 -4
  885. package/plugins/compute/computers/web.js +38 -11
  886. package/plugins/compute/contract.d.ts +9 -0
  887. package/plugins/compute/contract.js +9 -0
  888. package/plugins/compute/mod.d.ts +8 -1
  889. package/plugins/compute/mod.js +8 -1
  890. package/plugins/compute/web.d.ts +13 -0
  891. package/plugins/compute/web.js +13 -0
  892. package/plugins/interfaces/api/actions/create.js +51 -26
  893. package/plugins/interfaces/api/actions/revoke.js +19 -9
  894. package/plugins/interfaces/api/collections/key.d.ts +127 -54
  895. package/plugins/interfaces/api/collections/key.js +41 -38
  896. package/plugins/interfaces/api/contract.d.ts +11 -11
  897. package/plugins/interfaces/api/contract.js +1 -1
  898. package/plugins/interfaces/api/mod.d.ts +18 -13
  899. package/plugins/interfaces/api/mod.js +24 -15
  900. package/plugins/interfaces/api/processors/left.d.ts +7 -0
  901. package/plugins/interfaces/api/processors/left.js +19 -0
  902. package/plugins/interfaces/api/resources/presets.d.ts +3 -2
  903. package/plugins/interfaces/api/resources/presets.js +6 -4
  904. package/plugins/interfaces/api/shared/actor.d.ts +23 -16
  905. package/plugins/interfaces/api/shared/actor.js +32 -22
  906. package/plugins/interfaces/api/shared/end.d.ts +9 -0
  907. package/plugins/interfaces/api/shared/end.js +10 -0
  908. package/plugins/interfaces/api/shared/rules.d.ts +7 -11
  909. package/plugins/interfaces/api/shared/rules.js +20 -24
  910. package/plugins/interfaces/api/views/web/create.d.ts +7 -5
  911. package/plugins/interfaces/api/views/web/create.js +38 -33
  912. package/plugins/interfaces/api/views/web/keys.d.ts +21 -4
  913. package/plugins/interfaces/api/views/web/keys.js +22 -19
  914. package/plugins/interfaces/api/views/web/members.d.ts +13 -0
  915. package/plugins/interfaces/api/views/web/members.js +35 -0
  916. package/plugins/interfaces/api/views/web/reference.d.ts +6 -6
  917. package/plugins/interfaces/api/views/web/reference.js +17 -7
  918. package/plugins/interfaces/api/views/web/snippet.d.ts +18 -13
  919. package/plugins/interfaces/api/views/web/snippet.js +27 -16
  920. package/plugins/interfaces/api/views/web/style.d.ts +4 -3
  921. package/plugins/interfaces/api/views/web/style.js +31 -2
  922. package/plugins/interfaces/api/web.d.ts +5 -4
  923. package/plugins/interfaces/api/web.js +11 -6
  924. package/plugins/interfaces/contract.d.ts +16 -0
  925. package/plugins/interfaces/contract.js +14 -0
  926. package/plugins/interfaces/maintenance/actions/read.d.ts +4 -0
  927. package/plugins/interfaces/maintenance/actions/read.js +76 -0
  928. package/plugins/interfaces/maintenance/actions/write.d.ts +4 -0
  929. package/plugins/interfaces/maintenance/actions/write.js +64 -0
  930. package/plugins/interfaces/maintenance/contract.d.ts +60 -0
  931. package/plugins/interfaces/maintenance/contract.js +2 -0
  932. package/plugins/interfaces/maintenance/mod.d.ts +54 -0
  933. package/plugins/interfaces/maintenance/mod.js +66 -0
  934. package/plugins/interfaces/maintenance/resources/routes.d.ts +61 -0
  935. package/plugins/interfaces/maintenance/resources/routes.js +452 -0
  936. package/plugins/interfaces/maintenance/shared/ops.d.ts +4 -0
  937. package/plugins/interfaces/maintenance/shared/ops.js +19 -0
  938. package/plugins/interfaces/mcp/actions/call.d.ts +15 -0
  939. package/plugins/interfaces/mcp/actions/call.js +413 -0
  940. package/plugins/interfaces/mcp/actions/conversation.d.ts +1 -0
  941. package/plugins/interfaces/mcp/actions/conversation.js +49 -0
  942. package/plugins/interfaces/mcp/actions/prune.d.ts +1 -0
  943. package/plugins/interfaces/mcp/actions/prune.js +20 -0
  944. package/plugins/interfaces/mcp/collections/closed.d.ts +23 -0
  945. package/plugins/interfaces/mcp/collections/closed.js +17 -0
  946. package/plugins/interfaces/mcp/collections/opening.d.ts +24 -0
  947. package/plugins/interfaces/mcp/collections/opening.js +28 -0
  948. package/plugins/interfaces/mcp/collections/rate.d.ts +27 -0
  949. package/plugins/interfaces/mcp/collections/rate.js +18 -0
  950. package/plugins/interfaces/mcp/collections/receipt.d.ts +46 -0
  951. package/plugins/interfaces/mcp/collections/receipt.js +46 -0
  952. package/plugins/interfaces/mcp/contract.d.ts +8 -0
  953. package/plugins/interfaces/mcp/contract.js +8 -0
  954. package/plugins/interfaces/mcp/mod.d.ts +114 -0
  955. package/plugins/interfaces/mcp/mod.js +163 -0
  956. package/plugins/interfaces/mcp/processors/closed.d.ts +13 -0
  957. package/plugins/interfaces/mcp/processors/closed.js +16 -0
  958. package/plugins/interfaces/mcp/resources/running.d.ts +21 -0
  959. package/plugins/interfaces/mcp/resources/running.js +36 -0
  960. package/plugins/interfaces/mcp/resources/server.d.ts +56 -0
  961. package/plugins/interfaces/mcp/resources/server.js +611 -0
  962. package/plugins/interfaces/mcp/resources/tools.d.ts +183 -0
  963. package/plugins/interfaces/mcp/resources/tools.js +429 -0
  964. package/plugins/interfaces/mcp/resources/widgets.d.ts +161 -0
  965. package/plugins/interfaces/mcp/resources/widgets.js +247 -0
  966. package/plugins/interfaces/mcp/shared/keys.d.ts +56 -0
  967. package/plugins/interfaces/mcp/shared/keys.js +99 -0
  968. package/plugins/interfaces/mcp/shared/settings.d.ts +205 -0
  969. package/plugins/interfaces/mcp/shared/settings.js +193 -0
  970. package/plugins/interfaces/mcp/views/offered.d.ts +19 -0
  971. package/plugins/interfaces/mcp/views/offered.js +20 -0
  972. package/plugins/interfaces/mod.d.ts +6 -1
  973. package/plugins/interfaces/mod.js +6 -1
  974. package/plugins/interfaces/terminal/actions/print.js +1 -1
  975. package/plugins/interfaces/terminal/actions/set.js +1 -1
  976. package/plugins/interfaces/terminal/collections/output.d.ts +1 -1
  977. package/plugins/interfaces/terminal/collections/shell.js +1 -1
  978. package/plugins/interfaces/terminal/terminal.js +3 -3
  979. package/plugins/interfaces/terminal/views/shell.js +8 -3
  980. package/plugins/interfaces/voice/actions/block.d.ts +2 -0
  981. package/plugins/interfaces/voice/actions/block.js +74 -0
  982. package/plugins/interfaces/voice/actions/call.d.ts +19 -0
  983. package/plugins/interfaces/voice/actions/call.js +253 -0
  984. package/plugins/interfaces/voice/actions/prune.d.ts +1 -0
  985. package/plugins/interfaces/voice/actions/prune.js +43 -0
  986. package/plugins/interfaces/voice/actions/ring.d.ts +6 -0
  987. package/plugins/interfaces/voice/actions/ring.js +165 -0
  988. package/plugins/interfaces/voice/collections/blocked.d.ts +87 -0
  989. package/plugins/interfaces/voice/collections/blocked.js +34 -0
  990. package/plugins/interfaces/voice/collections/call.d.ts +279 -0
  991. package/plugins/interfaces/voice/collections/call.js +77 -0
  992. package/plugins/{access/directory/collections/membership.d.ts → interfaces/voice/collections/phone.d.ts} +24 -22
  993. package/plugins/interfaces/voice/collections/phone.js +26 -0
  994. package/plugins/interfaces/voice/contract.d.ts +14 -0
  995. package/plugins/interfaces/voice/contract.js +2 -0
  996. package/plugins/interfaces/voice/mod.d.ts +56 -0
  997. package/plugins/interfaces/voice/mod.js +124 -0
  998. package/plugins/interfaces/voice/processors/forget.d.ts +13 -0
  999. package/plugins/interfaces/voice/processors/forget.js +27 -0
  1000. package/plugins/interfaces/voice/resources/tools.d.ts +1 -0
  1001. package/plugins/interfaces/voice/resources/tools.js +27 -0
  1002. package/plugins/interfaces/voice/routes/hook.d.ts +21 -0
  1003. package/plugins/interfaces/voice/routes/hook.js +114 -0
  1004. package/plugins/interfaces/voice/routes/relay.d.ts +20 -0
  1005. package/plugins/interfaces/voice/routes/relay.js +488 -0
  1006. package/plugins/interfaces/voice/shared/caller.d.ts +27 -0
  1007. package/plugins/interfaces/voice/shared/caller.js +38 -0
  1008. package/plugins/interfaces/voice/shared/settings.d.ts +128 -0
  1009. package/plugins/interfaces/voice/shared/settings.js +115 -0
  1010. package/plugins/interfaces/voice/shared/signature.d.ts +11 -0
  1011. package/plugins/interfaces/voice/shared/signature.js +34 -0
  1012. package/plugins/interfaces/voice/views/call.d.ts +48 -0
  1013. package/plugins/interfaces/voice/views/call.js +42 -0
  1014. package/plugins/interfaces/voice/views/context.d.ts +9 -0
  1015. package/plugins/interfaces/voice/views/context.js +14 -0
  1016. package/plugins/interfaces/voice/views/message.d.ts +17 -0
  1017. package/plugins/interfaces/voice/views/message.js +41 -0
  1018. package/plugins/interfaces/web/actions/arrive.d.ts +1 -0
  1019. package/plugins/interfaces/web/actions/arrive.js +104 -0
  1020. package/plugins/interfaces/web/actions/prune.d.ts +1 -0
  1021. package/plugins/interfaces/web/actions/prune.js +51 -0
  1022. package/plugins/interfaces/web/actions/sending.d.ts +1 -0
  1023. package/plugins/interfaces/web/actions/sending.js +226 -0
  1024. package/plugins/interfaces/web/actions/spent.d.ts +2 -0
  1025. package/plugins/interfaces/web/actions/spent.js +59 -0
  1026. package/plugins/interfaces/web/collections/rate.d.ts +122 -0
  1027. package/plugins/interfaces/web/collections/rate.js +37 -0
  1028. package/plugins/interfaces/web/collections/visitor.d.ts +110 -0
  1029. package/plugins/interfaces/web/collections/visitor.js +69 -0
  1030. package/plugins/interfaces/web/contract.d.ts +14 -5
  1031. package/plugins/interfaces/web/contract.js +3 -1
  1032. package/plugins/interfaces/web/lines.d.ts +35 -0
  1033. package/plugins/interfaces/web/lines.js +83 -0
  1034. package/plugins/interfaces/web/mod.d.ts +16 -14
  1035. package/plugins/interfaces/web/mod.js +17 -19
  1036. package/plugins/interfaces/web/processors/forget.d.ts +10 -0
  1037. package/plugins/interfaces/web/processors/forget.js +14 -0
  1038. package/plugins/interfaces/web/resources/spend.d.ts +2 -0
  1039. package/plugins/interfaces/web/resources/spend.js +68 -0
  1040. package/plugins/interfaces/web/routes/arrive.d.ts +20 -0
  1041. package/plugins/interfaces/web/routes/arrive.js +92 -0
  1042. package/plugins/interfaces/web/shared/budget.d.ts +65 -0
  1043. package/plugins/interfaces/web/shared/budget.js +134 -0
  1044. package/plugins/interfaces/web/shared/lines.d.ts +147 -0
  1045. package/plugins/interfaces/web/shared/lines.js +147 -0
  1046. package/plugins/interfaces/web/shared/orgs.d.ts +64 -63
  1047. package/plugins/interfaces/web/shared/orgs.js +40 -42
  1048. package/plugins/interfaces/web/shared/panel.d.ts +0 -5
  1049. package/plugins/interfaces/web/shared/panel.js +5 -1
  1050. package/plugins/interfaces/web/shared/secret.d.ts +33 -0
  1051. package/plugins/interfaces/web/shared/secret.js +86 -0
  1052. package/plugins/interfaces/web/shared/standing.js +4 -3
  1053. package/plugins/interfaces/web/shared/style.d.ts +4 -4
  1054. package/plugins/interfaces/web/shared/style.js +11 -190
  1055. package/plugins/interfaces/web/views/default.d.ts +2 -2
  1056. package/plugins/interfaces/web/views/default.js +5 -3
  1057. package/plugins/interfaces/web/views/frame.d.ts +18 -6
  1058. package/plugins/interfaces/web/views/frame.js +31 -35
  1059. package/plugins/interfaces/web/views/me.d.ts +16 -16
  1060. package/plugins/interfaces/web/views/me.js +83 -31
  1061. package/plugins/interfaces/web/views/panel.js +3 -2
  1062. package/plugins/interfaces/web/views/shell.d.ts +3 -1
  1063. package/plugins/interfaces/web/views/shell.js +23 -3
  1064. package/plugins/interfaces/web/views/words.d.ts +1 -0
  1065. package/plugins/interfaces/web/views/words.js +54 -0
  1066. package/plugins/interfaces/whatsapp/actions/connect.js +13 -12
  1067. package/plugins/interfaces/whatsapp/actions/disconnect.js +6 -3
  1068. package/plugins/interfaces/whatsapp/actions/hook.d.ts +8 -1
  1069. package/plugins/interfaces/whatsapp/actions/hook.js +97 -60
  1070. package/plugins/interfaces/whatsapp/actions/link.js +12 -15
  1071. package/plugins/interfaces/whatsapp/actions/set.d.ts +8 -0
  1072. package/plugins/interfaces/whatsapp/actions/set.js +121 -0
  1073. package/plugins/interfaces/whatsapp/collections/blocked.d.ts +29 -0
  1074. package/plugins/interfaces/whatsapp/collections/blocked.js +22 -0
  1075. package/plugins/interfaces/whatsapp/collections/code.d.ts +1 -1
  1076. package/plugins/interfaces/whatsapp/collections/number.d.ts +90 -4
  1077. package/plugins/interfaces/whatsapp/collections/number.js +36 -4
  1078. package/plugins/interfaces/whatsapp/collections/phone.d.ts +16 -6
  1079. package/plugins/interfaces/whatsapp/collections/phone.js +9 -3
  1080. package/plugins/interfaces/whatsapp/collections/rate.d.ts +27 -0
  1081. package/plugins/interfaces/whatsapp/collections/rate.js +13 -0
  1082. package/plugins/interfaces/whatsapp/collections/sent.d.ts +24 -12
  1083. package/plugins/interfaces/whatsapp/collections/sent.js +11 -7
  1084. package/plugins/interfaces/whatsapp/collections/thread.d.ts +14 -6
  1085. package/plugins/interfaces/whatsapp/collections/thread.js +7 -5
  1086. package/plugins/interfaces/whatsapp/collections/typing.d.ts +70 -0
  1087. package/plugins/interfaces/whatsapp/collections/typing.js +21 -0
  1088. package/plugins/interfaces/whatsapp/contract.d.ts +27 -4
  1089. package/plugins/interfaces/whatsapp/contract.js +34 -1
  1090. package/plugins/interfaces/whatsapp/events/undelivered.d.ts +8 -0
  1091. package/plugins/interfaces/whatsapp/events/undelivered.js +17 -0
  1092. package/plugins/interfaces/whatsapp/mod.d.ts +34 -6
  1093. package/plugins/interfaces/whatsapp/mod.js +77 -13
  1094. package/plugins/interfaces/whatsapp/processors/forget.d.ts +6 -0
  1095. package/plugins/interfaces/whatsapp/processors/forget.js +11 -0
  1096. package/plugins/interfaces/whatsapp/processors/receive.d.ts +19 -4
  1097. package/plugins/interfaces/whatsapp/processors/receive.js +277 -97
  1098. package/plugins/interfaces/whatsapp/processors/reply.d.ts +25 -5
  1099. package/plugins/interfaces/whatsapp/processors/reply.js +216 -20
  1100. package/plugins/interfaces/whatsapp/processors/typing.d.ts +8 -0
  1101. package/plugins/interfaces/whatsapp/processors/typing.js +25 -0
  1102. package/plugins/interfaces/whatsapp/routes/hook.d.ts +16 -0
  1103. package/plugins/interfaces/whatsapp/routes/hook.js +52 -0
  1104. package/plugins/interfaces/whatsapp/shared/customers.d.ts +13 -0
  1105. package/plugins/interfaces/whatsapp/shared/customers.js +16 -0
  1106. package/plugins/interfaces/whatsapp/shared/graph.d.ts +33 -7
  1107. package/plugins/interfaces/whatsapp/shared/graph.js +121 -12
  1108. package/plugins/interfaces/whatsapp/shared/media.d.ts +24 -0
  1109. package/plugins/interfaces/whatsapp/shared/media.js +49 -0
  1110. package/plugins/interfaces/whatsapp/shared/number.d.ts +19 -8
  1111. package/plugins/interfaces/whatsapp/shared/number.js +65 -8
  1112. package/plugins/interfaces/whatsapp/shared/parts.d.ts +94 -0
  1113. package/plugins/interfaces/whatsapp/shared/parts.js +184 -0
  1114. package/plugins/interfaces/whatsapp/shared/payload.d.ts +27 -1
  1115. package/plugins/interfaces/whatsapp/shared/payload.js +36 -1
  1116. package/plugins/interfaces/whatsapp/shared/rules.d.ts +4 -4
  1117. package/plugins/interfaces/whatsapp/shared/rules.js +6 -9
  1118. package/plugins/interfaces/whatsapp/shared/settings.d.ts +47 -13
  1119. package/plugins/interfaces/whatsapp/shared/settings.js +8 -9
  1120. package/plugins/interfaces/whatsapp/views/message.d.ts +13 -0
  1121. package/plugins/interfaces/whatsapp/views/message.js +13 -0
  1122. package/plugins/interfaces/whatsapp/views/web/line.d.ts +24 -0
  1123. package/plugins/interfaces/whatsapp/views/web/line.js +44 -0
  1124. package/plugins/interfaces/whatsapp/views/web/space.d.ts +7 -5
  1125. package/plugins/interfaces/whatsapp/views/web/space.js +17 -10
  1126. package/plugins/interfaces/whatsapp/views/web/style.d.ts +1 -1
  1127. package/plugins/interfaces/whatsapp/views/web/style.js +8 -0
  1128. package/plugins/interfaces/whatsapp/web.js +10 -3
  1129. package/plugins/models/actions/check.d.ts +1 -0
  1130. package/plugins/models/actions/check.js +29 -1
  1131. package/plugins/models/actions/image.d.ts +1 -0
  1132. package/plugins/models/actions/image.js +46 -0
  1133. package/plugins/models/actions/offered.d.ts +34 -0
  1134. package/plugins/models/actions/offered.js +186 -0
  1135. package/plugins/models/adapters/image/fake.d.ts +6 -0
  1136. package/plugins/models/adapters/image/fake.js +8 -0
  1137. package/plugins/models/adapters/image/gemini.d.ts +2 -0
  1138. package/plugins/models/adapters/image/gemini.js +111 -0
  1139. package/plugins/models/adapters/image/openai.d.ts +2 -0
  1140. package/plugins/models/adapters/image/openai.js +69 -0
  1141. package/plugins/models/adapters/llm/anthropic.d.ts +1 -1
  1142. package/plugins/models/adapters/llm/anthropic.js +38 -20
  1143. package/plugins/models/adapters/llm/gemini.d.ts +1 -1
  1144. package/plugins/models/adapters/llm/gemini.js +7 -2
  1145. package/plugins/models/adapters/llm/openai-compatible.d.ts +1 -1
  1146. package/plugins/models/adapters/llm/openai-compatible.js +26 -3
  1147. package/plugins/models/adapters/llm/openai.d.ts +1 -1
  1148. package/plugins/models/adapters/llm/openai.js +158 -28
  1149. package/plugins/models/collections/image.d.ts +96 -0
  1150. package/plugins/models/collections/image.js +27 -0
  1151. package/plugins/models/contract.d.ts +20 -5
  1152. package/plugins/models/contract.js +2 -1
  1153. package/plugins/models/mod.d.ts +26 -5
  1154. package/plugins/models/mod.js +42 -6
  1155. package/plugins/models/resources/providers.d.ts +2 -2
  1156. package/plugins/models/resources/providers.js +2 -2
  1157. package/plugins/models/shared/catalog.json +9208 -8909
  1158. package/plugins/models/shared/choice.d.ts +31 -0
  1159. package/plugins/models/shared/choice.js +19 -3
  1160. package/plugins/models/shared/generate.d.ts +3 -1
  1161. package/plugins/models/shared/generate.js +52 -11
  1162. package/plugins/models/shared/image.d.ts +110 -0
  1163. package/plugins/models/shared/image.js +171 -0
  1164. package/plugins/models/shared/provider.d.ts +5 -0
  1165. package/plugins/models/shared/provider.js +14 -0
  1166. package/plugins/models/shared/retry.d.ts +9 -2
  1167. package/plugins/models/shared/retry.js +26 -2
  1168. package/plugins/models/shared/telemetry.d.ts +4 -2
  1169. package/plugins/models/shared/transcribe.js +7 -1
  1170. package/plugins/models/shared/types.d.ts +21 -2
  1171. package/plugins/models/shared/types.js +10 -0
  1172. package/plugins/models/shared/use.d.ts +41 -6
  1173. package/plugins/models/shared/use.js +84 -4
  1174. package/runtime/actor.d.ts +106 -0
  1175. package/runtime/actor.js +93 -0
  1176. package/runtime/address.d.ts +11 -0
  1177. package/runtime/address.js +48 -0
  1178. package/runtime/aggregate.js +8 -2
  1179. package/runtime/api.d.ts +49 -0
  1180. package/runtime/api.js +670 -0
  1181. package/runtime/blobs.d.ts +15 -12
  1182. package/runtime/blobs.js +58 -11
  1183. package/runtime/body.d.ts +16 -0
  1184. package/runtime/body.js +57 -0
  1185. package/runtime/browsers.d.ts +181 -24
  1186. package/runtime/browsers.js +358 -39
  1187. package/runtime/cache.d.ts +6 -0
  1188. package/runtime/cache.js +44 -6
  1189. package/runtime/caller.d.ts +126 -0
  1190. package/runtime/caller.js +226 -0
  1191. package/runtime/client.d.ts +163 -12
  1192. package/runtime/client.js +369 -53
  1193. package/runtime/collection.d.ts +2 -0
  1194. package/runtime/collection.js +2 -1
  1195. package/runtime/cookies.d.ts +72 -0
  1196. package/runtime/cookies.js +125 -0
  1197. package/runtime/define.d.ts +181 -25
  1198. package/runtime/describe.d.ts +315 -0
  1199. package/runtime/describe.js +590 -0
  1200. package/runtime/errors.d.ts +46 -0
  1201. package/runtime/errors.js +26 -0
  1202. package/runtime/executor.d.ts +2 -0
  1203. package/runtime/executor.js +78 -26
  1204. package/runtime/expiring.d.ts +23 -0
  1205. package/runtime/expiring.js +64 -0
  1206. package/runtime/fetch.d.ts +99 -0
  1207. package/runtime/fetch.js +415 -0
  1208. package/runtime/kept.d.ts +22 -0
  1209. package/runtime/kept.js +128 -0
  1210. package/runtime/links.d.ts +54 -0
  1211. package/runtime/links.js +98 -0
  1212. package/runtime/maintain.d.ts +88 -0
  1213. package/runtime/maintain.js +120 -0
  1214. package/runtime/memory.js +109 -19
  1215. package/runtime/mod.d.ts +15 -3
  1216. package/runtime/mod.js +13 -0
  1217. package/runtime/mongo.d.ts +46 -4
  1218. package/runtime/mongo.js +152 -8
  1219. package/runtime/observe.d.ts +10 -3
  1220. package/runtime/observe.js +119 -41
  1221. package/runtime/ops.d.ts +22 -1
  1222. package/runtime/ops.js +113 -1
  1223. package/runtime/owner.d.ts +98 -21
  1224. package/runtime/owner.js +667 -131
  1225. package/runtime/presence.d.ts +18 -0
  1226. package/runtime/presence.js +25 -0
  1227. package/runtime/reads.d.ts +5 -3
  1228. package/runtime/reads.js +16 -7
  1229. package/runtime/registry.d.ts +20 -3
  1230. package/runtime/registry.js +49 -6
  1231. package/runtime/rest.d.ts +10 -0
  1232. package/runtime/rest.js +247 -0
  1233. package/runtime/routes.d.ts +51 -0
  1234. package/runtime/routes.js +79 -0
  1235. package/runtime/runtime.d.ts +9 -5
  1236. package/runtime/runtime.js +19 -10
  1237. package/runtime/runtimes.d.ts +43 -0
  1238. package/runtime/runtimes.js +86 -0
  1239. package/runtime/site.d.ts +47 -0
  1240. package/runtime/site.js +170 -0
  1241. package/runtime/store.d.ts +61 -2
  1242. package/runtime/tickets.d.ts +15 -0
  1243. package/runtime/tickets.js +65 -0
  1244. package/runtime/timers.js +2 -0
  1245. package/runtime/views.d.ts +2 -4
  1246. package/runtime/views.js +9 -11
  1247. package/runtime/wire.d.ts +13 -2
  1248. package/runtime/wire.js +20 -2
  1249. package/stores/blobs/files/mod.js +4 -2
  1250. package/stores/blobs/gcs/mod.d.ts +30 -0
  1251. package/stores/blobs/gcs/mod.js +106 -0
  1252. package/stores/blobs/http/mod.d.ts +1 -1
  1253. package/stores/blobs/http/mod.js +2 -1
  1254. package/stores/latency/mod.js +5 -1
  1255. package/stores/sql/postgres/lease.d.ts +55 -0
  1256. package/stores/sql/postgres/lease.js +102 -0
  1257. package/stores/sql/postgres/maintenance.d.ts +31 -0
  1258. package/stores/sql/postgres/maintenance.js +325 -0
  1259. package/stores/sql/postgres/mod.d.ts +29 -4
  1260. package/stores/sql/postgres/mod.js +377 -96
  1261. package/stores/sql/postgres/update.js +3 -1
  1262. package/stores/sql/shared/capped.d.ts +2 -0
  1263. package/stores/sql/shared/capped.js +22 -0
  1264. package/stores/sql/shared/rows.d.ts +14 -0
  1265. package/stores/sql/shared/rows.js +29 -0
  1266. package/stores/sql/shared/statement.d.ts +12 -0
  1267. package/stores/sql/shared/statement.js +244 -0
  1268. package/stores/sql/sqlite/apart.d.ts +11 -0
  1269. package/stores/sql/sqlite/apart.js +219 -0
  1270. package/stores/sql/sqlite/mod.d.ts +16 -2
  1271. package/stores/sql/sqlite/mod.js +246 -51
  1272. package/testing/mod.d.ts +28 -0
  1273. package/testing/mod.js +57 -2
  1274. package/testing/words.d.ts +18 -0
  1275. package/testing/words.js +60 -0
  1276. package/hosts/orgs/mod.d.ts +0 -82
  1277. package/hosts/orgs/mod.js +0 -519
  1278. package/hosts/web/files.d.ts +0 -24
  1279. package/hosts/web/files.js +0 -83
  1280. package/hosts/web/orgs.d.ts +0 -112
  1281. package/hosts/web/orgs.js +0 -225
  1282. package/hosts/web/routes.d.ts +0 -89
  1283. package/hosts/web/routes.js +0 -132
  1284. package/hosts/web/tickets.d.ts +0 -20
  1285. package/hosts/web/tickets.js +0 -21
  1286. package/plugins/access/directory/actions/invite.d.ts +0 -5
  1287. package/plugins/access/directory/actions/invite.js +0 -130
  1288. package/plugins/access/directory/actions/org.d.ts +0 -11
  1289. package/plugins/access/directory/actions/org.js +0 -279
  1290. package/plugins/access/directory/collections/invite.d.ts +0 -81
  1291. package/plugins/access/directory/collections/invite.js +0 -20
  1292. package/plugins/access/directory/collections/membership.js +0 -22
  1293. package/plugins/access/directory/collections/org.d.ts +0 -141
  1294. package/plugins/access/directory/collections/org.js +0 -36
  1295. package/plugins/access/directory/collections/staff.d.ts +0 -42
  1296. package/plugins/access/directory/collections/staff.js +0 -12
  1297. package/plugins/access/directory/mod.d.ts +0 -21
  1298. package/plugins/access/directory/mod.js +0 -45
  1299. package/plugins/access/directory/shared/settings.d.ts +0 -21
  1300. package/plugins/access/directory/shared/settings.js +0 -16
  1301. package/plugins/access/identity/actions/key.d.ts +0 -2
  1302. package/plugins/access/identity/actions/key.js +0 -48
  1303. package/plugins/agents/team/actions/agent.d.ts +0 -4
  1304. package/plugins/agents/team/actions/agent.js +0 -180
  1305. package/plugins/agents/team/actions/define.d.ts +0 -1
  1306. package/plugins/agents/team/actions/define.js +0 -27
  1307. package/plugins/agents/team/collections/agent.d.ts +0 -132
  1308. package/plugins/agents/team/collections/agent.js +0 -75
  1309. package/plugins/agents/team/contract.d.ts +0 -7
  1310. package/plugins/agents/team/mod.d.ts +0 -21
  1311. package/plugins/agents/team/mod.js +0 -42
  1312. package/plugins/agents/team/shared/definition.d.ts +0 -3
  1313. package/plugins/agents/team/shared/definition.js +0 -10
  1314. package/plugins/agents/team/views/web/agent-add.d.ts +0 -14
  1315. package/plugins/agents/team/views/web/agent-add.js +0 -47
  1316. package/plugins/agents/team/views/web/agent-fields.d.ts +0 -33
  1317. package/plugins/agents/team/views/web/agent-fields.js +0 -84
  1318. package/plugins/agents/team/views/web/agent-known.d.ts +0 -22
  1319. package/plugins/agents/team/views/web/agent-known.js +0 -60
  1320. package/plugins/agents/team/views/web/agent-new.d.ts +0 -24
  1321. package/plugins/agents/team/views/web/agent-new.js +0 -124
  1322. package/plugins/agents/team/views/web/agent-palette.d.ts +0 -19
  1323. package/plugins/agents/team/views/web/agent-palette.js +0 -200
  1324. package/plugins/agents/team/views/web/agent-steps.d.ts +0 -23
  1325. package/plugins/agents/team/views/web/agent-steps.js +0 -52
  1326. package/plugins/agents/team/views/web/agent.d.ts +0 -17
  1327. package/plugins/agents/team/views/web/agent.js +0 -247
  1328. package/plugins/agents/team/views/web/agents.d.ts +0 -48
  1329. package/plugins/agents/team/views/web/agents.js +0 -55
  1330. package/plugins/agents/team/views/web/places.d.ts +0 -24
  1331. package/plugins/agents/team/views/web/places.js +0 -15
  1332. package/plugins/agents/team/views/web/style.d.ts +0 -9
  1333. package/plugins/agents/team/views/web/style.js +0 -195
  1334. package/plugins/agents/team/web.d.ts +0 -20
  1335. package/plugins/agents/team/web.js +0 -37
  1336. package/plugins/compute/computers/shared/person.d.ts +0 -3
  1337. package/plugins/compute/computers/shared/person.js +0 -8
  1338. package/plugins/interfaces/api/shared/events.d.ts +0 -26
  1339. package/plugins/interfaces/api/shared/events.js +0 -142
  1340. package/plugins/interfaces/api/shared/http.d.ts +0 -28
  1341. package/plugins/interfaces/api/shared/http.js +0 -93
  1342. package/plugins/interfaces/api/shared/reference.d.ts +0 -48
  1343. package/plugins/interfaces/api/shared/reference.js +0 -37
  1344. package/plugins/interfaces/api/shared/server.d.ts +0 -34
  1345. package/plugins/interfaces/api/shared/server.js +0 -177
  1346. package/plugins/interfaces/web/views/console.d.ts +0 -13
  1347. package/plugins/interfaces/web/views/console.js +0 -212
  1348. package/plugins/interfaces/web/views/org.d.ts +0 -12
  1349. package/plugins/interfaces/web/views/org.js +0 -54
  1350. package/plugins/interfaces/web/views/orgs.d.ts +0 -44
  1351. package/plugins/interfaces/web/views/orgs.js +0 -256
  1352. package/plugins/interfaces/whatsapp/shared/http.d.ts +0 -47
  1353. package/plugins/interfaces/whatsapp/shared/http.js +0 -22
  1354. /package/plugins/agents/{team → openapi}/contract.js +0 -0
package/CHANGELOG.md CHANGED
@@ -1,3 +1,2375 @@
1
+ ## 1.0.0-rc.42 — 2026-11-11
2
+
3
+ (rc.41 was tagged but never published: a test failed on Node. This is it.)
4
+
5
+ - **In a person's own Personal space, what its agents drew on from elsewhere no longer gets in the
6
+ way.** Only that person is there, and they see every space their agents read for them:
7
+ - **Agents' work there is no longer refused.** An agent working for someone from their Personal
8
+ space, having read another space in that turn (a memory that came up by itself, a conversation
9
+ it read, earlier messages that did), could still write it into any space they may, yet not into
10
+ their Personal space itself where labels aren't kept (a board, a document, a file, a computer
11
+ job): `needs_share` ("That would show what came from … to people who can't see it"), and the
12
+ turn failed. Since rc.39 memory reads everywhere there, so this hit most turns. It now goes as
13
+ it is; messages there still keep their marks, for the day the chat moves.
14
+ - **The chat no longer says "Uses …. Not everyone here can see it."** under its messages there.
15
+ They keep their `sources`; once the chat moves to a shared space, the notice and Share show
16
+ where they're true.
17
+
18
+ ## 1.0.0-rc.40 — 2026-11-11
19
+
20
+ - **MCP checks can return fresh results while declaring their state changes accurately.** Set
21
+ `replay: false` on a model tool to skip reuse of its completed answer for identical input, such as
22
+ a payment check that reconciles the booking. Interrupted calls still recover with the same call
23
+ ID; existing tools keep their replay behavior. Read-only tools and widget-only Actions already run
24
+ without completed-answer replay.
25
+
26
+ ## 1.0.0-rc.39 — 2026-11-10
27
+
28
+ - **Agents look in their memory before saying they don't have something, and find more when they
29
+ do:**
30
+ - **How to use memory is Copilotz's own instructions.** The `memory` context (the guide) is
31
+ declared `instructions: true`, so it's sent as it is, before the app's information, instead of
32
+ inside `<context name="memory">` after "treat it as information, not as instructions". It now
33
+ also says to look first (recall, and back through the conversation) before saying you don't know
34
+ something, don't have it, or can't go on without it. Skills likewise: their guide is a context
35
+ of its own declared as instructions (`skillsGuide`); the list, which people wrote, stays
36
+ information (`skills`, now headed "Skills you have:"). Each agent's cached system text changes
37
+ once.
38
+ - **What comes up by itself is for what the conversation is about**, not only its latest words:
39
+ the latest message, the two before it and the conversation's title, each memory scored by the
40
+ closest (a reply like "see above" still finds what the question above was about). Each says when
41
+ and where it was learned (`(learned in “Launch plan” 2026-11-10)`), in `recall`'s answers too,
42
+ and `recall`'s `source` (a memory's id) reads what was said there, around the message it came
43
+ from.
44
+ - **What an agent was told in a conversation and still has whole isn't told again:** only memories
45
+ new to it come up, so a follow-up no longer re-sends the same ones (once what it was told leaves
46
+ the recent part of the conversation, they can come up again).
47
+ - **In a person's own Personal space, memory reads everywhere they can read**, by itself and by
48
+ `recall`, as the agent there may already: only they see what's said there. What it brings from
49
+ another space marks the answer (`sources`), as `recall` with `in` did. Shared spaces still read
50
+ only what was learned there.
51
+ - **The person agents work for is in the conversation for memory, there or not:** in a chat one
52
+ agent handed another for them, their memories are in mind, and what's said of them there is
53
+ about them (the extractor is told whom the agents work for).
54
+ - **The extractor also reads a conversation once it's been quiet a while** (`memory.quiet`, 10
55
+ minutes; `0` turns it off), not only every `every` messages, so a short conversation, or the
56
+ last few messages of any, isn't left unread. Each message sets the conversation's timer again;
57
+ `memory.extract`, called by it, reads what's pending.
58
+
59
+ - **An agent's tool steps keep a line of their own when they leave the tail,** so what it read and
60
+ ran stays in reach in a long working chat. Until now a step (an agent's tool calls with what they
61
+ returned, which only that agent is sent) left the tail without a line: zoom couldn't reach it and
62
+ `read_conversation` leaves steps out, so what an agent learned from a tool and didn't repeat in a
63
+ reply was gone for it. Now each step that leaves is a line in a tree of its agent's own in that
64
+ thread: written as the thread's are (one as it is when short, else by the summarizer from the
65
+ step's start and end), merged in pairs, within the outline's budget, and committed with the
66
+ thread's lines, so a prompt's start still changes once a cut. Only that agent is sent its lines,
67
+ among the thread's by when they were written (`s12+4|…`), and `zoom` opens them the same way
68
+ (`zoom("s12", 4)`), down to the step whole; another agent's are no line of its own to open.
69
+ `summary` documents of a step's tree say whose (`agent`), and the `outline` keeps each agent's
70
+ lines (`steps`). Steps that left before this have no line.
71
+
72
+ ## 1.0.0-rc.38 — 2026-11-10
73
+
74
+ - **MCP 2026-07-28 cacheable results, widget read schemas, cross-origin MCP lines, and
75
+ `/.well-known/`:**
76
+ - `resources/list`, `resources/templates/list` and `resources/read` now include `ttlMs` and
77
+ `cacheScope` on MCP `2026-07-28` (`CacheableResult`), and handshake versions (`2025-11-25` and
78
+ earlier) omit them on `tools/list` and resource results where `CacheableResult` does not exist.
79
+ - Widget tool inputs (`_reads` and `copilotz_read`'s `reads`) now declare their `items` object
80
+ schema so strict MCP clients accept `tools/list` when widgets are enabled.
81
+ - Stateless routes (`Route.crossOrigin`) enforce their own `Origin` rules without reading session
82
+ cookies, so an MCP line's `origins` (including `"*"`) answers browser preflights (`OPTIONS`) and
83
+ cross-origin `POST`s with CORS headers while keeping no-browser-origin (`403`) as the default.
84
+ - `webPage`'s `/*` catch-all leaves `/.well-known/*` as `404` when no plugin serves a route there,
85
+ instead of answering discovery probes with the HTML page.
86
+ - **A person's next message answers the question an agent waits on them for,** as the web says it
87
+ does ("Waiting on your answer: your next message replies"). `chat.send` finds it when a message
88
+ names none (`replyTo`): the newest question to its sender in that chat that an agent still waits
89
+ on; else one asked of them elsewhere by an agent whose turn waits in that chat, so what they tell
90
+ it there resumes that turn instead of starting a second one beside it. Never for a message sent
91
+ for them (`via`: a routine's), nor to an agent it doesn't go to (`to`, `@mentions`). Until now
92
+ only WhatsApp found it (its own lookup is gone; a quoted message still names what it answers): on
93
+ the web, an answer in the chat an agent opened to ask went to nobody, and the asking turn, with
94
+ whatever waited on it (an answer to hand back to another space), never resumed.
95
+
96
+ ## 1.0.0-rc.37 — 2026-11-10
97
+
98
+ **Upgrading.** The web shell says nine new words, which an app in another language gives under
99
+ `shell.<key>` (its words test names any it lacks): `yourName` ("Your name"), `addYourName` ("Add
100
+ your name"), `nameAbout` ("How people and agents here see you."), `nameLabel` ("Name"), `nameEmpty`
101
+ ("Leave it empty to go by your email."), `nameNotSaved` ("Your name wasn't saved. {reason}"),
102
+ `nameTryAgain` ("Your name wasn't saved. Try again in a moment."), `cancel` ("Cancel") and `save`
103
+ ("Save").
104
+
105
+ - **A person names themselves** (`person.rename` `{ name }`, identity's). Only a person, for
106
+ themselves, in person: never a contact, a key, an agent or a routine, and there's no one else to
107
+ name. The name is one line (spaces, tabs and breaks in a row are one space), trimmed, 80
108
+ characters at most (said plainly past that); empty, it's cleared, and they have none. It's what
109
+ everyone sees of them: their menu, home's greeting, the people beside them in a space, agents'
110
+ prompts (the spaces plugin's profile follows it, else their email's name, as before).
111
+ - **Sign-ins keep the name a person chose,** or their having none: Google's sign-in, email's, and
112
+ the system's `person.set` (a directory's handoff into an org) no longer set it back. Until a
113
+ person chooses (their record's `named`: when they last did), sign-ins keep their name current as
114
+ before.
115
+ - **The person's menu opens with their name,** "Your name" ("Add your name" with none), in a dialog:
116
+ the field holds it, selected, so typing replaces it; Enter saves; a live preview shows how they'll
117
+ appear; while it saves the field waits; a refusal is said under it and the dialog stays. So the
118
+ menu is always a menu now, with or without front ends' entries.
119
+ - **The new name shows at once, everywhere, without reloading:** in this tab and their others. The
120
+ web host keeps the page's viewer as the person's own record says (it watches it: their name and
121
+ email), and draws again when it changes; Views read it as before (`ctx.viewer.label`).
122
+ - **No name, no id:** with none, the menu shows the person's email (`ctx.viewer.email`, new, from
123
+ identity's `/me`), and home greets them plainly ("Good morning"). An app whose ids aren't names
124
+ (`01JD3X…`) showed the id in both.
125
+
126
+ ## 1.0.0-rc.36 — 2026-11-10
127
+
128
+ **Upgrading.** Chat has two tools of its own, `list_conversations` and `read_conversation`, for the
129
+ agents that list them in their `tools`. An app that made its own tools under those names drops them
130
+ and lists chat's, which do the same and take a space. A Personal space's agents now write elsewhere
131
+ for their person without labels from there (below): an app that relied on that refusal says so in
132
+ its own rules.
133
+
134
+ - **Agents work under the authority of whoever asked** ([design](design/work.md), "Authority"). In a
135
+ person's own Personal space, where only they read the answers, their agents reach every space they
136
+ do, and now act there too. That makes the Personal chat a chief of staff:
137
+ - **Tools take a space** (`in`, its id, which the `elsewhere` context lists): `list_conversations`
138
+ and `read_conversation` (new, chat's own), boards (`list_boards`, `read_board`, `create_board`,
139
+ `create_card`, `update_card`, `move_card`), documents (`list_documents`, `read_document`,
140
+ `write_document`, `append_document`, `edit_document`), routines (`schedule_routine`,
141
+ `list_routines`, `cancel_routine`: a routine kept elsewhere starts a new conversation there each
142
+ run) and `recall`, as before. From a shared space they work only there and in what it draws on,
143
+ and say so (`workIn`, in the agents' contract, for apps' tools).
144
+ - **`send_message` takes `thread`:** a conversation that's there already, in this space or any
145
+ other the person can write in. Who answers there gets it (`to`, or the conversation's own
146
+ agent), it says where it came from, and the answer comes back, as a hand-over's does.
147
+ - **What they write elsewhere is the person's:** work for someone from their own Personal space
148
+ takes no labels from there (`labels.write`, `ownPersonal`). Before, everything an agent wrote
149
+ from Personal into a space others see was refused (`needs_share`), even a card the person asked
150
+ for. What's written in the Personal space itself keeps its marks (its conversation may move),
151
+ and labels guard shared spaces and contacts' chats as before.
152
+
153
+ ## 1.0.0-rc.35 — 2026-11-09
154
+
155
+ **Fixed: a retried call's nested calls.** A call run again under its id (a retry after a failure or
156
+ a stop) looked up its own nested recorded calls without its actor. In a person's or contact's job
157
+ the runtime then refused the lookup ("This job can't act as that"), and the retry failed. It now
158
+ asks as whom the call works for. This affected any person or contact Action retried after it made a
159
+ nested recorded call, and retried Processor deliveries; it has been so since the authority checks.
160
+
161
+ The MCP line's tests now wait for what they assert rather than for fixed times (they flaked on macOS
162
+ runners). Nothing to do when upgrading from rc.34.
163
+
164
+ ## 1.0.0-rc.34 — 2026-11-09
165
+
166
+ rc.33, released whole. rc.33's publish stopped before npm: packing its tarballs, npm took `dist/npm`
167
+ for a GitHub repository. JSR has `@copilotz/copilotz@1.0.0-rc.33`, and nothing else has rc.33. This
168
+ release is rc.33's code, with the publish workflow's paths starting with `./`. Upgrading from rc.32
169
+ is as rc.33 says, below, with each version 1.0.0-rc.34.
170
+
171
+ ## 1.0.0-rc.33 — 2026-11-09
172
+
173
+ **Upgrading.** Copilotz's product plugins are packages of their own, released with it at its version
174
+ ([design](design/plugins.md)). Their names (collections, Actions, events, Views, routes, resources)
175
+ are as they were, so an app's data stays as it is: only its imports change.
176
+
177
+ - `copilotz/plugins/work` → `@copilotz/work`, and `copilotz/plugins/work/web` →
178
+ `@copilotz/work/web`.
179
+ - `copilotz/plugins/access`'s `directory` (with `Operations`, `OrgInfo`…) → `@copilotz/directory`;
180
+ the directory's browser half in `copilotz/plugins/access/web` (`useOrgs`, `enterOrg`,
181
+ `refreshOrgs`…) → `@copilotz/directory/web` (or `@copilotz/directory/contract`).
182
+ - `copilotz/plugins/billing`'s `credits`, `stripe` and `stripeWebhook` → `@copilotz/billing`, and
183
+ `creditsWeb` → `@copilotz/billing/web`. `usage` stays in `copilotz/plugins/billing`.
184
+ - `copilotz/plugins/agents`'s `team` and `tiers` → `@copilotz/team`, and `teamWeb`, `tiersWeb` →
185
+ `@copilotz/team/web`.
186
+ - An app serving many orgs adds `directoryWeb` (from `@copilotz/directory/web`) to its page: the web
187
+ shell has no org switcher, org page or console of its own any more. Their words keep their keys
188
+ (`shell.<key>`).
189
+ - On Deno, name each in the import map at Copilotz's version
190
+ (`"@copilotz/work": "jsr:@copilotz/work@<version>"`); on npm, install it beside `copilotz` at the
191
+ same version, or, until npm has it, from the release's tarball.
192
+
193
+ ```ts
194
+ import { boards, documents } from "@copilotz/work"; // was copilotz/plugins/work
195
+ import { directoryWeb } from "@copilotz/directory/web";
196
+
197
+ await web({ plugins: [webShell, chatWeb, spacesWeb, directoryWeb, boardsWeb], root });
198
+ ```
199
+
200
+ - **Product packages** ([design](design/plugins.md)): `@copilotz/work` (boards, documents),
201
+ `@copilotz/directory` (many orgs behind one address), `@copilotz/billing` (credits, Stripe) and
202
+ `@copilotz/team` (agents people make, model tiers), each in `packages/<name>` with its `mod.ts`,
203
+ `web.tsx`, `contract.ts`, tests and README, on JSR and npm. They import Copilotz by its entry
204
+ points alone, as an outside plugin would; the core imports none of them, its tests neither.
205
+ - **The web shell knows no orgs.** Its `orgs` slot (a resource) takes a switcher View, an overlay
206
+ View and a hook for what the menu and palette list; `directoryWeb` fills it. The person's standing
207
+ in the org is spaces' `org.me` (`useStanding`, in the shell's contract), which spaces' sidebar and
208
+ credits' note read; renaming the org says so (`orgsChanged()`).
209
+ - **The core's contracts are entry points:** `copilotz/plugins/<theme>/contract` (access, agents,
210
+ models, interfaces, compute), each theme's plugins' `contract.ts` together.
211
+ - **Testing:** `copilotz/testing/words` (`pseudoWords`, `englishLeft`, `wordsList`) and `openTo`
212
+ (what a kind of caller is let into of some plugins), for packages' tests as for Copilotz's.
213
+ - **Releases:** `npm run build` builds Copilotz and every package; the smoke test installs them all
214
+ together from their tarballs and uses a plugin of each; a release attaches every tarball to its
215
+ GitHub release before publishing, and publishes the packages after Copilotz, each on its own (one
216
+ a registry doesn't have yet is skipped, with a notice). `node scripts/version.ts <version>` says a
217
+ version everywhere, in lockstep.
218
+
219
+ ## 1.0.0-rc.32 — 2026-11-09
220
+
221
+ **Upgrading.** `people` now lets in an agent working for a person, and an Action's `allow` is asked
222
+ of code acting for someone too (a tool's `ctx.call`, a Processor's, another Action's), not only of
223
+ outside callers. Go through your Actions:
224
+
225
+ - Say `inPerson` for what only the person decides (consent, keys, who's in a space, money,
226
+ publishing): it never lets in an agent, a key or a routine's work. Say `people` for the rest. An
227
+ `allow` written as `(actor) => actor.kind === "person"` keeps your own tools' agents out: say
228
+ `people`.
229
+ - An Action whose run takes `ctx.actor.id` for a person's id, or checks something only when
230
+ `ctx.actor.kind === "person"`, reads `personOf(ctx.actor)` instead (an agent's id isn't its
231
+ person's).
232
+ - A tool calling an Action its agent's person couldn't is refused (`forbidden`): let them in, or go
233
+ beyond on purpose with a named grant, `ctx.as(grant("<why>"))`.
234
+ - An agent's work reaches only where it is (its chat's space) and what that space draws on: a tool
235
+ that read across its person's spaces from a shared chat finds less. Have the space draw on the
236
+ other (`member.set` of a space), work from the person's Personal space, or hand the work over.
237
+ - Tools read where they are from `ctx.in`, not their chat's `in`.
238
+ - A developer key no longer calls what's now `inPerson` (`space.create`, `member.*`, `invitation.*`,
239
+ `share`, `chat.move`, `agent.create`…), even listed in its scope.
240
+ - An MCP line listing a tool without its `tool:<name>` View doesn't start: add the View.
241
+
242
+ ```ts
243
+ import { grant, inPerson, people, personOf } from "@copilotz/copilotz";
244
+
245
+ "invoice.send": defineAction({ allow: inPerson, … }), // only the person decides
246
+ "invoice.draft": defineAction({ allow: people, run: (ctx) => draft(personOf(ctx.actor)) }),
247
+ // a tool, in its chat's space; going beyond its person on purpose, on the record:
248
+ run: async (input, ctx) => await ctx.as(grant("availability")).call("slots.all", { in: ctx.in }),
249
+ ```
250
+
251
+ - **Who, for whom, where** ([design](design/work.md)). All work runs as an actor, for whom it's done
252
+ (`for`) and where (`in`, an opaque id: a space, to the access plugin), which the runtime carries
253
+ as it carries the actor: into nested calls, tools, the Processors a call's events wake, its timers
254
+ and the Views observed for it; every event records it; `guard` and `allow` see it; contexts say it
255
+ (`ctx.in`, on Actions, Processors, tools, queries and Views). `ctx.as` stays where the work is
256
+ unless told where. Every way in says it: a browser's calls (its page's space;
257
+ `client.call(…,
258
+ { in })`), the terminal (where its person works), a key (its space), WhatsApp,
259
+ voice, web and MCP lines (theirs), routines (theirs), a chat's turn (its chat's).
260
+ - **An agent's work reaches only where it is.** Reach for work done for someone is the person's
261
+ reach ∩ the agent's memberships ∩ its space and what that draws on, at the role it draws on it
262
+ with; in the person's own Personal space, all they reach. North working for Ana in a shared space
263
+ reached every space of Ana's (the core agents are members of all of them), and only labels kept
264
+ Finance from Launch's members: now it reads Launch and its sources. A person acting themselves
265
+ isn't narrowed; a tool or routine acting as them is. An agent actor's `at` is `in`.
266
+ - **`allow` is asked wherever someone acts:** from outside as before, and from code acting for an
267
+ actor (`ctx.call`, a timer, a read's unrecorded calls); for an agent, of whom it works for too
268
+ (`allows`). Actions without one stay internal. Going beyond is a named grant (`grant`), on the
269
+ record as the grant, `via` whose work it was, and counted (`copilotz.elevated.ops`).
270
+ - **Copilotz's own Actions say which:** `inPerson` for sessions, connected accounts, who's in a
271
+ space or the org, `share`, `chat.move`, `memory.move`, `agent.create/update/delete`,
272
+ `computer.code`, `computer.work` and `app.publish`, beside those that were; `people` for the rest,
273
+ boards and documents included (their agents' own tools couldn't call them). `chat.send` and
274
+ `chat.attach` let in people and contacts writing as themselves, never an agent. Code that took the
275
+ actor's id for its person's (`space.personal`, invitations, accounts, desks, cloud computers,
276
+ usage) asks `personOf`; an environment changes only by its space's managers, whoever asks.
277
+ - **Reach is kept in the owner** per who, for whom and where, until a commit changes a membership or
278
+ a space it read (`ReadContext.kept`: what rules work out from reads, let go exactly when what they
279
+ read changes; `cache.kept`, 1,000). An agent's turn works out its reach once, not on every op.
280
+ With narrowing, an agent's work for a person in one of 1,000 spaces (`examples/work-bench.ts`)
281
+ takes a fifth of the time: a turn's 13 ops, 4.4 ms median (21.5 before), 5.3 ms at p95 (22.9); the
282
+ person's own, 4.7 ms (11.7). Nothing measured got slower.
283
+ - **Tools know where they are** (`ctx.in`): documents, boards, computers, cloud computers, apps,
284
+ memory, skills, routines and an API's files no longer read their chat to find its space. What's
285
+ learned stays where it's learned.
286
+ - **Handing work to another space** writes under its grant (`chat.hand-over`, and `chat.hand-back`
287
+ for the answer), for the same person, in the new space; its check is the person's, anywhere.
288
+ - **mcp:** a listed tool without its `tool:<name>` View stops the app from starting (it was left
289
+ out, said once in the log). A line's contact, its widgets and its tools work in its space.
290
+ - **Model-use listeners** get `as` in a job; a web line's budget prices its visitors' use as its
291
+ grant (`web.budget`).
292
+ - **Startup checks** see the Views' names (`merged.views`).
293
+
294
+ ## 1.0.0-rc.31 — 2026-11-08
295
+
296
+ - **A write the rules refuse in a transaction no longer holds up every write.** Refused before it
297
+ reached its transaction, it left the transaction open, holding the store's writer: the Action's
298
+ failure and every other write in the app waited 30 s, until it was rolled back as idle. Now it
299
+ ends its transaction at once, as an op that fails in one does: it rolls back, and its later ops
300
+ fail ("The transaction is closed."), even when the error is caught. Code that caught a failed op
301
+ and wrote on used to commit what came after it. A transaction with no op for 5 s (30 s before)
302
+ rolls back, and `copilotz.transaction.duration` measures how long each one held the writer.
303
+ - **Boards** no longer read a new card back inside its transaction: one round trip less per card.
304
+
305
+ ## 1.0.0-rc.30 — 2026-11-08
306
+
307
+ **Upgrading.** `chat.send` no longer takes a file's content. Upload each file first with
308
+ `chat.attach` (`{ name, type, data, voice? }`, as `files` took it), and send what it answers by id:
309
+
310
+ ```ts
311
+ const { id } = await runtime.call("chat.attach", {
312
+ name: "plan.pdf",
313
+ type: "application/pdf",
314
+ data,
315
+ });
316
+ await runtime.call("chat.send", { text: "The plan", files: [{ id }] });
317
+ ```
318
+
319
+ Call both as the same sender: a draft is sent only by its uploader's message. An API key that sends
320
+ files needs `chat.attach` in its scope: the "Chat" preset has it now, and a key made with it before
321
+ is made again (or given `chat.attach`).
322
+
323
+ - **Files of about 10 MB go, ten to a message.** `chat.send` carried every file's content, on record
324
+ with what it wrote too, in one call, and a call carries at most 16 MiB to the owner: a file past
325
+ about 6 MB was refused (`payload_too_large`). Now each file is its own call (`chat.attach`,
326
+ unrecorded), kept as its sender's draft (`draft`, in no conversation: nobody else reads it, a rule
327
+ of chat's own), and the message names it: its commit makes it the conversation's, under the rules
328
+ as the message is. The web composer uploads each file as it's chosen (reading, uploading, its
329
+ size, or why it couldn't), so sending is instant; a voice message uploads once, also when it's
330
+ sent again without a transcript. WhatsApp uploads what a phone sends the same way.
331
+ - **Drafts are bounded:** a sender holds 20 at most (the oldest go past them), and `chat.prune`
332
+ (chat's schedule, every hour) drops those not sent within a day. A contact's upload is let in by
333
+ the `contactSend` hooks as a message to nobody carrying it: a web line's file rules apply as it's
334
+ uploaded, and it counts against the visitor's limits.
335
+
336
+ ## 1.0.0-rc.29 — 2026-11-07
337
+
338
+ - **An agent waiting on your yes waits within its turn.** A command, job or file write that needs a
339
+ person's OK used to end the agent's turn ("Waiting for ana's yes…"). The turn's answer went to
340
+ whoever had asked it, and the yes then started a new turn that answered the person. So when one
341
+ agent asked another, and that one needed a yes, the first got "I'm waiting on your yes" as its
342
+ answer and the real answer went to the person. Now the turn pauses, as it does for the messages it
343
+ sends. The call asks its person a question: the agent's message to them, answered on the approval
344
+ card. The answer is a reply to that question, and the same turn goes on. The call runs again as
345
+ itself, in a step after the answer, so the agent reads its question, the answer, then what the
346
+ command did, and its answer goes to whoever started the turn. Several asks in one step wait
347
+ together, and the turn goes on once, when the last is answered: what was allowed runs, and what
348
+ wasn't says no. A yes in this conversation, or always, answers the agent's other asks it covers,
349
+ and their turns go on too. A reply typed to the question isn't a yes: the call doesn't run, and
350
+ says what they said. A card asked in a side thread shows in its conversation too ("in a side
351
+ thread"). A card answered before its step is written is refused (`busy`, "answer in a moment");
352
+ the card shows only once the step is written anyway. Forgetting a computer tells a turn waiting on
353
+ it no. A model outside (MCP) still gets "Waiting for…" and asks again later, as before.
354
+ - **Tools can wait for a person** (`ToolContext.ask`, in chat's contract). In a turn, a tool asks
355
+ `{ to, text }` and gets the question's id; the turn waits for a reply to it (a message with that
356
+ `replyTo`), then runs the call again with `answer` (who answered, and what they said). The
357
+ question is written with the step. Steps record it (`Step.asked`), as they record what they sent
358
+ (`sent`). The `conversation` resource's Views get the conversation's side threads too (hint
359
+ `side`).
360
+
361
+ ## 1.0.0-rc.28 — 2026-11-07
362
+
363
+ - **A deploy hands over instead of fencing** (`serve` in `copilotz/web/node`, `lease` in
364
+ `copilotz/stores/postgres`). While a deploy moves traffic, the platform keeps the old process
365
+ running for as long as its browsers' sockets stay open, and the new process's store fenced it:
366
+ every write those browsers sent failed ("This owner was fenced"). Now one process at a time holds
367
+ the store's lease: `serve` listens first (a request is told it's starting: a 503 to retry, a page
368
+ that reloads itself), waits for the lease, then opens the app; the old process, asked for it,
369
+ stops listening (its browsers reconnect, to the new one), lets running work finish, and lets go.
370
+ Only a deploy at least as new asks (`revision`); a process that loses the lease stops. Its table
371
+ is `copilotz_lease`, in the schema it's given (`public` by default).
372
+ - **A contact's message may go to nobody** (`chat.send` with `to: []`), as a person's already could:
373
+ it's kept in the chat, its agents read it the next time they answer there (with its `tap`, as
374
+ `[tapped: <id>]`), and none answers it. It's how a page beside the chat says what the customer did
375
+ there (a trip chosen in a booking panel) without a turn for each tap. A contact still names no
376
+ agent: any other `to` goes to its chat's agents, as before. `contactSend` hooks are told
377
+ (`to: []`): a web line's visitor's message to nobody counts against its limits but holds none of
378
+ the line's budget, since no turn will be charged for it.
379
+
380
+ ## 1.0.0-rc.27 — 2026-11-06
381
+
382
+ **Upgrading.** Chat's `file.content` query is `file.about`, and answers a file without its content
383
+ (`data`). Host code that wants the content reads it as bytes, in parts:
384
+ `runtime.bytes("file", { _id }, "data", { actor })`, or serves it at `/files/<id>`. A file's content
385
+ is plain base64 (no line breaks, no `data:` prefix): `chat.send` refuses anything else.
386
+
387
+ - **Files of any size are served** (`GET /files/<id>`): a picture or a recording whose base64 passed
388
+ 1 MiB (about 750 KB) was answered as missing (404), so it showed broken. The route read the whole
389
+ file through a query, whose answer comes from an executor over Oxian in one chunk, and Oxian takes
390
+ at most 1 MiB a chunk. Now it reads what the file is (`file.about`, as whoever the request is),
391
+ then its content from the owner, as them again (`runtime.bytes`), and decodes it as the response
392
+ is read, 192 KiB at a time; a range (`206`) decodes only its part. Who reads a file is unchanged:
393
+ the request's actor, a signed link as the system, and a file out of reach is a 404 alike. A
394
+ failure that isn't about reach is now a 500, logged, not a 404.
395
+ - **`runtime.bytes(collection, filter, field, { actor })`**: a large value's bytes for trusted host
396
+ code, read by the owner itself, under the rules as `actor` (the system without one), its `size`
397
+ and `read(start, end)`, from the document or its blob (loaded once, at the first part). The blob's
398
+ reference never leaves the owner.
399
+ - **Projections:** `find` and `findOne` take `{ projection }`, as MongoDB's (`{ name: 1 }` keeps,
400
+ `{ data: 0 }` leaves out, `_id` either way; dotted paths into objects). The owner applies it
401
+ before it loads any blob: a field left out costs no blob read. Stores never see it.
402
+ - **Answers past 1 MiB go in parts:** a job's output (a query's answer, an Action's result, a
403
+ View's) and what a browser is pushed are written in parts of at most 1 MiB, Oxian's bound on a
404
+ chunk. A long history, a prompt with pictures (`thread.prompt`, `/prompt`) or a large read a
405
+ browser watches failed whole before (the executor "lost", the browser's session closed).
406
+ - **A message's files reach the prompt one read each:** `llm.message` read all of a message's files
407
+ in one answer of the owner's, which carries at most 16 MiB; pictures that together passed it
408
+ failed the turn.
409
+ - **WhatsApp links a file without reading its content:** sending a chat's file by signed link reads
410
+ only whether its recipient may see it; Meta's fetch streams the content from `/files/<id>`.
411
+ - **Every word Copilotz's web front ends show is the app's to change.** An app in another language
412
+ no longer rewrites the page as it is drawn: it gives a `words` resource
413
+ (`{ "chat.send":
414
+ "Enviar" }`), on any plugin the page runs, merged over the English in order.
415
+ Words are by key (`hosts/web/WORDS.md` lists them: the shell, chat, spaces, memory, team, usage,
416
+ the command palette, the toolkit and the host's notices), with `{blanks}` for names and numbers
417
+ and plural forms by the page's language (`{ one, other }`). Dates, times, numbers and currency
418
+ follow the page's `lang` (`webPage({ lang })`) instead of the browser's. Front ends of an app's
419
+ own use the same way: `defineWords(area, { … })` from `copilotz/web`. English is unchanged, so an
420
+ app that sets nothing looks as before. Not covered: the other front ends (billing's credits,
421
+ routines, skills, computers, apps, API keys, WhatsApp, tiers), text the server sends, and the
422
+ offline page.
423
+ - **Boards and documents are Copilotz's** (`copilotz/plugins/work`, front ends in
424
+ `copilotz/plugins/work/web`). `boards` is kanban in a space (boards with ordered columns, cards
425
+ dragged between them, owners, labels, due dates; Actions `board.*` and `card.*`; agents' tools
426
+ `list_boards`, `read_board`, `create_board`, `create_card`, `update_card`, `move_card`).
427
+ `documents` is shared Markdown in a space (every save a version, saves merged line by line or
428
+ refused as a `conflict`, restoring, presence; Actions `document.*`; agents' tools
429
+ `list_documents`, `read_document`, `write_document`, `append_document`, `edit_document`). Each has
430
+ its web front end (`boardsWeb`, `documentsWeb`). The empty Board tab's line about agents is the
431
+ app's: `resources.boardsText.agentHint`.
432
+ - **A `@word` is a mention only when it names someone.** Chat took any `@word` as a mention, so a
433
+ message with a social handle ("my profile is @ana.marca") and no agent named reached no agent. Now
434
+ a mention counts only when it names an agent, or a person in the conversation; any other `@word`
435
+ is plain text, and the message goes where it would without it (the conversation's agents, or the
436
+ space's default).
437
+ - **A failed recall never sinks a turn.** When memory recall fails at the start of a turn (the
438
+ embedder's provider refuses the key, or times out), the turn goes on without recalled memories.
439
+ The failure is logged (`memory: recall failed…`) and counted (`copilotz.memory.recall_failures`).
440
+ A failing `remember` is still a tool error the agent sees.
441
+ - **Web tools** (`webTools`, in `copilotz/plugins/agents`): agents search the web and read a page
442
+ without a computer. `web_search` `{ query, count?, language?, country? }` →
443
+ `{ title, url,
444
+ snippet }` results, through a new `search` adapter port (`duckduckgo`, the
445
+ default: its HTML page, no key, no cost, a bot challenge or empty page is a public "search is
446
+ unavailable" error; `serper`, optional; `fake`; one more adapter adds Brave or Google), and
447
+ `read_page` `{ url, start? }` → the final URL, title, main text and links, in parts, marked as
448
+ data. Reading refuses non-http(s) URLs, private, loopback, link-local and metadata addresses (the
449
+ host resolved, checked again on every redirect), other ports than 80 and 443 unless
450
+ `webTools.ports` lists them, pages over 2 MB or 15 s, and non-text types; a turn reads at most 8
451
+ pages. A search is a `search` use of the usage ledger (in the `agents` category), priced from
452
+ resources, asked of the `modelUse` listeners and the `spending` check first. The models contract
453
+ now exports `mayUse` and `used`, for uses outside model calls.
454
+ - **An agent's message with files.** `chat.say` takes `files`, and `text` may be left out when there
455
+ are files. Trusted code, such as a tool during a turn, can now post what it made without writing
456
+ chat's collections itself. Each file is one of these:
457
+ - `{ id, collection? }`: a document the caller reads that holds a file as `type` and `data`.
458
+ That's chat's own `file` by default, or another plugin's, such as the models plugin's `image`.
459
+ - `{ name, type, data }`: the file given as it is.
460
+
461
+ Each becomes a file of the chat, with its `thread` and space. People and contacts read it there as
462
+ they read people's files, and it meets the same limits: ten at most, about 10 MB each, and a media
463
+ type. Its content is the same blob, so a picture kept elsewhere isn't stored twice. The answer
464
+ adds the files' ids: `{ message, files }`. Saying it again sends nothing, files included. An
465
+ agent's own message tells it next time what it sent: `[sent: logo.png]`.
466
+
467
+ - **A refusal says why.** A turn that fails with a refusal written for people answers in that
468
+ refusal's own words, where only the codes `credits` and `budget` did before. That covers any
469
+ failure made public, including the `spending` check's refusal whatever its `why`: an app's own
470
+ reason, such as an inactive subscription, no longer needs to borrow `credits`. The `spending`
471
+ refusal is now public, so a model outside the app reads its message too. A web line's spent budget
472
+ now shows its own words ("This chat has done all it can for today…"). Every other failure still
473
+ shows people the short line, with the details in the event. Moving in from another app. Nothing
474
+ changes for an app that doesn't call these.
475
+
476
+ - **`chat.import`** (the system's: a migration) brings a conversation in as it was: its thread (the
477
+ importer's id) in a space, with its title, and its messages with who said them (a person's id or
478
+ an agent's name), to whom, what, their files (`data`, or the `id` of a document holding one:
479
+ chat's `file` by default) and when (ISO 8601 with a zone, kept to the millisecond). Nothing runs:
480
+ no turn, no transcript, nothing delivered. Importing again replaces what it made; a long
481
+ conversation comes in several calls, and the thread's summary (count, first, latest, when it last
482
+ moved) is worked out from every message it has. A thread already in another space is refused
483
+ (`chat.move` moves it). Unrecorded: the documents it writes are their own record.
484
+ - **`memory.import`** (the system's) brings memories in as they were, in a space: text, whom each is
485
+ about, who wrote it, `core`, when it was learned and last changed, under the importer's ids. Each
486
+ is embedded as it's kept (with an embedder), so recall finds it by meaning.
487
+ - **Dev sign-in reaches someone already there:** an email a person has (one who moved in under an id
488
+ of its own) signs in as them, and the id of someone there signs in as them too, both as they are
489
+ (their name isn't touched). Anyone else signs in as before.
490
+
491
+ ## 1.0.0-rc.26 — 2026-11-06
492
+
493
+ **Upgrading from rc.25.** The `hosts` resource names the app's own hosts an entry each, without the
494
+ `own` key it had alone. An app that names its hosts changes one line; one that doesn't changes
495
+ nothing. The shape before is refused at start, saying what's expected.
496
+
497
+ ```ts
498
+ // rc.25
499
+ resources: { hosts: { own: ["app.example.com", "*.run.app"] } }
500
+ // now
501
+ resources: { hosts: { "app.example.com": true, "*.run.app": true } }
502
+ ```
503
+
504
+ - **`resources.hosts` is an entry per host** (`{ "app.example.com": true }`), in place of
505
+ `{ own: [...] }`, like every other resource: a later plugin adds a host, or takes one away with
506
+ `null`, without restating the rest. What it does is unchanged: with the app's hosts named, any
507
+ other host is answered only by routes that take it. `HostsSettings` is `Record<string, true>`.
508
+ - **Email sign-in** (`emailSignIn`, in `copilotz/plugins/access`, with identity and `email`): people
509
+ sign in with an email and a password. Nothing changes for apps that don't add it.
510
+ - **Flows,** each an unrecorded Action behind a route, those that end signed in answering with
511
+ identity's `signedIn`: `email.sign-up` (a six-digit code by email, the password waiting for it)
512
+ and `email.verify` (the person made, and a session); `email.sign-in`, refused with `unverified`
513
+ (and a new code sent) until the address is confirmed; `email.forgot` (the same answer for any
514
+ address) and `email.reset` (the password set, the person's other sessions ended);
515
+ `email.invite`, trusted code's (a webhook after a purchase: the person, answered at once, and a
516
+ link that works once for a day, `/#email-invite=<token>`), `email.invitation` and `email.accept`
517
+ (the password chosen, signed in); and `email.import`, the system's, which keeps another app's
518
+ password hashes as they are, for a migration, with the person ids the importer chooses. Routes:
519
+ `GET /signin/email` (it's here; `signUp`), `POST /signin/email`, and `/signin/email/sign-up`,
520
+ `verify`, `forgot`, `reset`, `invitation`, `accept`; a refusal answers `{ error, code }`.
521
+ - **Passwords:** legacy hashes (`"<saltHex>:<hashHex>"`, PBKDF2-HMAC-SHA256 at 100,000, as
522
+ Copilotz 0.x apps kept them) verify as stored and are hashed again at the next sign-in; new ones
523
+ are `pbkdf2-sha256$6x100000$<salt>$<hash>` (PBKDF2 in six stages of 100,000, each salted with
524
+ the stage before: workerd refuses more than 100,000 in one call), on WebCrypto, compared in
525
+ constant time, in a private field (`email_login.hash`) no event or actor's read holds.
526
+ - **Codes and links** are kept only as HMACs under the `links` secret (still matching under its
527
+ `previous` while it changes), used once; codes last 15 minutes and five wrong tries. A stranger
528
+ signing up first with someone's address can't choose their password: each code confirms the
529
+ password its sign-up came with. Messages to an address (5 an hour), tries at it (10 in 15
530
+ minutes) and one caller's asks (30, by the `caller` resource or the socket's address) are
531
+ limited (`too_many`), the same whether or not the address has an account (`emailSignIn.limits`).
532
+ What's past goes every ten minutes (`email.prune`).
533
+ - **Its words** are the `emailSignIn` resource's `messages` (`verify`, `reset`, `invite`,
534
+ `exists`), English unless the app gives its own; `app` names the app in them (the `links`
535
+ origin's host unless said). It needs the `links` resource (`{ origin, secret }`) to start.
536
+ - **`email`, the app's email port:** `email.send` `{ to, subject, text, html? }` (trusted code's,
537
+ unrecorded) through the adapter the `email` resource names: `resend` (Resend's API, through
538
+ `ctx.fetch`, with its `apiKey` and `from`) or `console` (each message in the log, for a laptop;
539
+ refused where the `links` origin is public). `EmailAdapter` and the settings' types are in its
540
+ contract.
541
+ - **The sign-in page offers email** when `GET /signin/email` says it's there: sign in, create an
542
+ account, the code (sent on once typed or pasted; a new one every 30 seconds), a new password by
543
+ code, and arriving by an invitation's link to choose a password. Signing in by name moves under
544
+ it, a click away. The toolkit has an `eye-off` icon. The example web app takes `EMAIL=1` (and
545
+ `EMAIL_INVITE=<address>`) to try it, its messages in the terminal.
546
+ - **The sign-in page is the app's, in every word** (the `signInPage` resource of the browser's
547
+ plugins, merged over Copilotz's as the theme is): `words` patch its phrases one by one by key
548
+ (`SIGN_IN_WORDS` in `copilotz/web`: every heading, label, placeholder, button, hint and refusal of
549
+ Google's, email's and dev sign-in's screens, refusals said by their code, never in the server's
550
+ words); `about`, the panel beside the form (a headline, its quieter end, points with icons), is
551
+ given whole (no Copilotz pitch stays beside an app's own), and `null` leaves the form alone. Its
552
+ logo is the theme's and its name the page's title, as before; an app that says nothing shows
553
+ Copilotz's words and pitch, as before. Google's button speaks `page.lang`. New in `copilotz/web`:
554
+ `SIGN_IN_WORDS`, `COPILOTZ_ABOUT`, `signInPageOf` and the `SignInPage`, `SignInWords`,
555
+ `SignInAbout` and `SignInPoint` types.
556
+ - **Image generation** in `models`: `image.generate`
557
+ `{ model, prompt, references?, count?, aspectRatio?, size?, tags? }` answers
558
+ `{ images: [{ id, type, size }], text, usage }`. The images are kept in the `image` collection, a
559
+ document each, with the content as a blob, and the answer names them by id. A reference is an
560
+ image made here (`{ id }`), a document the caller may read that holds a file as `type` and `data`
561
+ (`{ id, collection: "file" }`, read as the caller), or inline data (`{ data, type }`, or a data
562
+ URL). Models are chosen as `llm`'s are: an alias, settings around one, or a list tried in order.
563
+ Adapters go under `adapters.image`: `gemini` (`generateContent` with `responseModalities`; `count`
564
+ images are that many calls, made together), `openai` (`/images/generations`, or `/images/edits`
565
+ with references), and `fake` (`"fake/image"`).
566
+ - **Metered like every model call.** The org's own key comes first. `modelUse` listeners and the
567
+ `spending` check go before the call. Its tokens are told to the ledger after, with meter
568
+ `image`, priced from the catalog as `llm`'s are, and counted under agents. The provider's
569
+ `silence` and `retry` apply.
570
+ - **Refusals are final.** A model whose safety rules say no fails `image_refused`, and no other
571
+ model is asked. One that makes nothing fails `no_image` once the list is spent. Both are public
572
+ messages: an agent's tool tells its model why.
573
+ - **Recorded, unlike the other ports' Actions.** It writes what it made, so a job that runs again
574
+ finds the call done and doesn't pay twice. `models.check` takes `port: "image"`.
575
+ - `keyed` and `mayRun` (the org's own key, and the spending check) moved from the llm port to
576
+ `shared/use.ts`, so every port that spends asks the same way. Nothing changes for `llm`.
577
+
578
+ ## 1.0.0-rc.25 — 2026-11-06
579
+
580
+ **Upgrading from rc.24.** The runtime now answers HTTP itself. `runtime.fetch(request)` is a fetch
581
+ handler (a function from a web-standard `Request` to a `Response`) that every host calls; plugins
582
+ declare their HTTP as `routes` (plain functions by URL pattern) and say who a request is with `who`
583
+ (a function from a request to an actor, or nothing); the runtime names and sets every cookie; the
584
+ page is a plugin (`webPage`); and many orgs are the directory's routes, forwarding each request to
585
+ its org's runtime. Every URL, webhook path and cookie name stays as it was, so nobody signs in
586
+ again. Developer keys made before stop working: make them again (step 7). The steps, in order:
587
+
588
+ 1. **Composition: the page is a plugin, and the runtime takes no browser options.** Drop
589
+ `transports: [socket]` and `admit: tickets.admit`: the runtime keeps its own one-time tickets and
590
+ takes its own socket at `/oxian`. Add `webPage` (from `copilotz/web/server`) with a `page`
591
+ resource. What `serve` and `webServer` took as options are resources now: `code`, `title`,
592
+ `lang`, `assets` and `base` go in `page`; `theme` in `theme`; `front: { secret }` is the `caller`
593
+ resource's `front` (beside its `header`); `widgets` go in `widgets`. `code` may be a function
594
+ that bundles once, on the page's first request.
595
+
596
+ ```ts
597
+ // rc.24
598
+ const tickets = createTickets(); // copilotz/web/tickets
599
+ const runtime = await createRuntime({
600
+ store,
601
+ plugins: [...plugins, devSignIn],
602
+ transports: [socket], // copilotz/web/server
603
+ admit: tickets.admit,
604
+ });
605
+
606
+ // now
607
+ const runtime = await createRuntime({
608
+ store,
609
+ plugins: [
610
+ ...plugins,
611
+ devSignIn,
612
+ webPage,
613
+ definePlugin({
614
+ name: "page",
615
+ resources: {
616
+ page: { title: "Notes", code: () => bundle(new URL("./browser.tsx", import.meta.url)) },
617
+ theme: themeOf([]),
618
+ },
619
+ }),
620
+ ],
621
+ });
622
+ ```
623
+
624
+ 2. **Serving: a listener calls `runtime.fetch`.** On Node and Bun, `listen(runtime.fetch, options)`
625
+ from `copilotz/web/node` replaces `serve({ runtime, tickets, code, … })`. It answers a
626
+ `Listener`, whose `shutdown()` stops listening, and you close the runtime yourself
627
+ (`runtime.close({ drain })`). On Deno, `Deno.serve(runtime.fetch)` replaces serving
628
+ `webServer({ …, upgrade })` with Oxian's Deno handler, and needs no `setClientAddress`: the
629
+ runtime reads the socket's address from what `Deno.serve` hands it. On workerd,
630
+ `export default { fetch: runtime.fetch }`. Bun's own `Bun.serve({ fetch: runtime.fetch })` serves
631
+ requests but not the runtime's socket, so use `listen` there.
632
+
633
+ ```ts
634
+ // rc.24
635
+ const server = await serve({ runtime, tickets, code, theme, port: 8080 });
636
+ process.once("SIGTERM", () => server.close({ drain: 8_000 }));
637
+
638
+ // now
639
+ const server = await listen(runtime.fetch, { port: 8080 });
640
+ process.once("SIGTERM", async () => {
641
+ await server.shutdown();
642
+ await runtime.close({ drain: 8_000 });
643
+ });
644
+ ```
645
+
646
+ 3. **Settings: flat named entries, one `caller`, and `ctx.fetch`.** Each interface plugin's resource
647
+ is a map of what the app declares, by name, with no `lines` key. `web.caller` and `mcp.caller`
648
+ are one `caller` resource. `caller.exempt` is the MCP server's own `exempt`, `voice.keep` each
649
+ number's `keep`, and `mcp.atOnce` each server's `limits.atOnce`; `whatsapp.codeMinutes` and
650
+ `whatsapp.maxFileMb` are constants now, and a declared entry's `org` is gone (each org's runtime
651
+ declares its own). Types: `WhatsAppLine` is `DeclaredNumber`, `VoiceLine` `DeclaredVoiceNumber`,
652
+ `McpLine` `DeclaredServer`, `WebLine` `DeclaredSite`, and `McpCaller` `CallerSettings`. Plugin
653
+ code calls outside services through `ctx.fetch` (step 10), so the `whatsapp.graph` setting,
654
+ Stripe's `settings.fetch`, `googleKeys(fetcher)`'s argument and openapi's `fetch` setting are
655
+ gone.
656
+
657
+ ```ts
658
+ // rc.24
659
+ resources: {
660
+ web: {
661
+ caller: { header: "cf-connecting-ip", front },
662
+ lines: { site: { in: "visitors", agent: "guide" } },
663
+ },
664
+ whatsapp: {
665
+ lines: { vendas: { in: "customers", phoneId, token, secret, verify, agent: "mobi" } },
666
+ },
667
+ mcp: { atOnce: 4, lines: { chatgpt: { in: "customers", tools } } },
668
+ }
669
+
670
+ // now
671
+ resources: {
672
+ caller: { header: "cf-connecting-ip", front },
673
+ web: { site: { in: "visitors", agent: "guide" } },
674
+ whatsapp: { vendas: { in: "customers", phoneId, token, secret, verify, agent: "mobi" } },
675
+ mcp: { chatgpt: { in: "customers", tools } },
676
+ }
677
+ ```
678
+
679
+ 4. **Routes: plain functions on a plugin.** The `routes` resource goes, with its three shapes
680
+ (`{ path, action }`, `{ path, serve }`, `{ host, serve }`), `methods`, `HttpRequest`,
681
+ `HttpAnswer` and `Served`. A plugin's `routes` field maps a `URLPattern` pathname to a `Route`:
682
+ `(request, { runtime, actor, params, cookies }) => Response`. A path that took everything under
683
+ it (`"/hooks/"`) is `"/hooks/*"`; a host route is a whole URL pattern (`"*://*-preview.*:*/*"`);
684
+ a route checks its own method. `host.runtime` is `ctx.runtime`, `await host.whom()` is
685
+ `ctx.actor`, `host.host` is the request's own URL (already the site the browser asked for),
686
+ `host.upgrade()` is Oxian's `upgradeWebSocket(request)`, and `host.widgets` is the `widgets`
687
+ resource. A route calls Actions as trusted code, as the system unless it names an actor
688
+ (`runtime.call(name, input, { actor })`): an Action that took an `HttpRequest` behind
689
+ `{ path, action }` takes plain data now, and one only a route calls needs no `allow`.
690
+
691
+ ```ts
692
+ // rc.24
693
+ resources: {
694
+ routes: {
695
+ ping: {
696
+ path: "/hooks/ping",
697
+ methods: ["POST"],
698
+ serve: async (request, host) =>
699
+ Response.json(await host.runtime.call("relay.ping", { body: await request.text() })),
700
+ },
701
+ },
702
+ },
703
+
704
+ // now
705
+ routes: {
706
+ "/hooks/ping": async (request, { runtime }) => {
707
+ if (request.method !== "POST") return new Response("Only POST", { status: 405 });
708
+ return Response.json(await runtime.call("relay.ping", { body: await request.text() }));
709
+ },
710
+ },
711
+ ```
712
+
713
+ 5. **Sign-in: plugins' routes, `who`, and the runtime's cookies.** The `entrances` and `signIn`
714
+ resources go. Apps on `googleSignIn` and `devSignIn` change nothing: their routes are
715
+ `POST /signin/google` (with `GET /google` for the button's client id) and `/signin/dev`, which
716
+ the page already used. A sign-in method of your own is a plugin built on identity whose route
717
+ calls its Action and answers with identity's `signedIn` (from `copilotz/plugins/access`), which
718
+ sets the session's cookie. A credential of your own (an entrance's `cookie` and `query`) is a
719
+ plugin's `who`, and its cookie is set and cleared with `ctx.cookies`: no plugin writes
720
+ `Set-Cookie`. Identity's `POST /signout` ends the session, disconnects its browsers and clears
721
+ its cookie; its `GET /me` says whom the page shows.
722
+
723
+ ```ts
724
+ // rc.24
725
+ resources: {
726
+ signIn: { mine: { action: "mine.sign-in" } },
727
+ entrances: { badge: { cookie: "badge", query: "badge.actor" } },
728
+ },
729
+
730
+ // now
731
+ definePlugin({
732
+ name: "mine-sign-in",
733
+ requires: ["identity"],
734
+ actions: { "mine.sign-in": signInAction }, // answers { person, session }, as before
735
+ routes: {
736
+ "/signin/mine": async (request, { runtime, cookies }) =>
737
+ signedIn(cookies, await runtime.call("mine.sign-in", await request.json())),
738
+ },
739
+ who: (_request, { cookies, query }) => {
740
+ const secret = cookies.get("badge");
741
+ return secret ? query("badge.actor", { secret }) : null;
742
+ },
743
+ });
744
+ ```
745
+
746
+ 6. **The site chat: its own route.** `web({ arrive: { line } })` is `web({ arrive: { name } })`. The
747
+ page posts to the site chat's route, `POST /web/<name>` (with `{ challenge }` when it has one),
748
+ before it connects, and `/connect` takes no JSON. `contact.arrive` loses its `secret` input. The
749
+ cookie (`visitor`) and the limits are the same.
750
+
751
+ ```tsx
752
+ // rc.24
753
+ await web({ root, plugins: [siteShell, chatWeb], arrive: { line: "site", challenge: token } });
754
+
755
+ // now
756
+ await web({ root, plugins: [siteShell, chatWeb], arrive: { name: "site", challenge: token } });
757
+ ```
758
+
759
+ 7. **Keys: members of their space, with a scope.** Every key is the api plugin's, and every key has
760
+ a scope: `api_key.create` takes `scope` (`call`, `query`, `view`, `read`, `write`) in place of
761
+ `actions`, `queries` and `views`, and `apiPresets` are `{ title, description, scope }`. An Action
762
+ that takes a space gets no default from a key: the key names `in`. Identity's unscoped keys
763
+ (`key.create`, `key.revoke`, `credential.keys`) are gone. Keys made before stop working: make
764
+ them again.
765
+
766
+ ```ts
767
+ // rc.24
768
+ await runtime.call("api_key.create", {
769
+ in: space,
770
+ name: "Bot",
771
+ actions: ["chat.send"],
772
+ queries: ["thread.recent"],
773
+ }, { actor });
774
+
775
+ // now
776
+ await runtime.call("api_key.create", {
777
+ in: space,
778
+ name: "Bot",
779
+ scope: { call: ["chat.send"], query: ["thread.recent"] },
780
+ }, { actor });
781
+ ```
782
+
783
+ 8. **REST and the client.** `/api/` is the runtime's own now (the api plugin's `serveApi` is gone),
784
+ answered for whoever `who` says: a key, a session from the app's own page, or anonymous. Its
785
+ paths are unchanged, with more beside them (below). A View over `/api/` asked with `?follow=1` is
786
+ asked with `Accept: text/event-stream`, and `?id=` is `?item=` (the item, as JSON). A script
787
+ connects with the client instead of hand-made requests, over the socket or over HTTP, and its
788
+ collections are spelled as plugin code's.
789
+
790
+ ```ts
791
+ // rc.24
792
+ const headers = { authorization: `Bearer ${key}`, "content-type": "application/json" };
793
+ await fetch(`${app}/api/actions/booking.cancel`, {
794
+ method: "POST",
795
+ headers,
796
+ body: '{"id":"42"}',
797
+ });
798
+ await fetch(`${app}/api/views/booking.panel?id=42&follow=1`, { headers });
799
+
800
+ // now
801
+ const client = await connect(app, { key }); // the socket; { key, over: "http" } for the REST API
802
+ await client.call("booking.cancel", { id: "42" });
803
+ const stop = client.db.collection("booking").watch({ _id: "42" }, (rows) => show(rows));
804
+ // by hand: GET /api/views/booking.panel?item={"_id":"42"}, with Accept: text/event-stream
805
+ ```
806
+
807
+ 9. **Many orgs: the directory's routes.** `orgsHost` (`copilotz/orgs`) goes. The directory's runtime
808
+ is the app's `fetch`, and its plugin's routes forward each request, untouched and sockets
809
+ included, to its org's runtime. Its `directory` resource takes the orgs' runtimes as a pool
810
+ (`orgs`: `runtimes(open)`, from `copilotz`) and a `lobby` for someone signed in nowhere (a
811
+ runtime with the page), beside `staff` and `operations`; `hosts` is the `hosts` resource's `own`.
812
+ Each org's runtime gets `directory.member(dir, org)`, in place of what `open` was given
813
+ (`plugins`, `admit`, `transports`) and of `here(org)`. `listen(dir.fetch)` carries sockets too:
814
+ no `hypervisor` picker. `org.get` is the `org.info` query, and front ends import the orgs'
815
+ browser half (`useOrgs`, `enterOrg`…) from `copilotz/plugins/access/web`. Stripe's webhook is the
816
+ `stripeWebhook` plugin, in the directory's runtime with the pool as the `stripe` resource's
817
+ `orgs` (below).
818
+
819
+ ```ts
820
+ // rc.24
821
+ const host = orgsHost({
822
+ directory: await createRuntime({ store, plugins: [identity, directory, devSignIn] }),
823
+ open: async (org, given) =>
824
+ await createRuntime({
825
+ store: storeOf(org),
826
+ plugins: [...plugins, ...given.plugins],
827
+ transports: given.transports,
828
+ admit: given.admit,
829
+ browsers: given.browsers,
830
+ }),
831
+ upgrade: () => new Response("Connect again", { status: 503 }),
832
+ code,
833
+ theme,
834
+ });
835
+ await listen({ fetch: host.serve, hypervisor: (r) => host.openRuntime(r)?.hypervisor, port });
836
+
837
+ // now
838
+ const orgs = runtimes(async (id) => {
839
+ const org = await dir.query<OrgInfo | null>("org.info", { org: id });
840
+ if (!org) return undefined;
841
+ return await createRuntime({
842
+ store: await storeOf(org),
843
+ plugins: [...plugins, ...page, directory.member(dir, org)], // page: webPage and its resource
844
+ browsers: { pool: visitors }, // const visitors = contactsPool()
845
+ });
846
+ });
847
+ const lobby = await createRuntime({ store: memoryStore(), plugins: page });
848
+ const dir: Runtime = await createRuntime({
849
+ store,
850
+ plugins: [
851
+ identity,
852
+ directory,
853
+ devSignIn,
854
+ definePlugin({
855
+ name: "directory-settings",
856
+ resources: { directory: { orgs, lobby } },
857
+ }),
858
+ ],
859
+ });
860
+ await listen(dir.fetch, { port });
861
+ ```
862
+
863
+ 10. **Tests: `testWho`, `ticketFor`, `runtime.fetch` and `createRuntime({ fetch })`.** A test that
864
+ made browsers with `createRuntime({ admit })` adds `testWho` (from `copilotz/testing`: a `who`
865
+ that believes the `x-test-actor` header, for tests alone) and takes each ticket from the
866
+ runtime's `/connect` with `ticketFor(runtime, actor)`. HTTP needs no listener:
867
+ `await runtime.fetch(new Request(url, init))`. A fake outside service (Meta's Graph API, Stripe,
868
+ Google's keys) is the `fetch` the runtime gives plugin code, as `clock` is replaced.
869
+
870
+ ```ts
871
+ // rc.24
872
+ const tickets = new Map<string, Actor>();
873
+ const runtime = await createRuntime({
874
+ store,
875
+ plugins: [
876
+ ...plugins,
877
+ definePlugin({ name: "t", resources: { whatsapp: { graph: fake.url } } }),
878
+ ],
879
+ transports: [transport],
880
+ admit: (secret) => tickets.get(secret),
881
+ });
882
+ const ticket = () => {
883
+ const secret = crypto.randomUUID();
884
+ tickets.set(secret, ana);
885
+ return Promise.resolve(secret);
886
+ };
887
+
888
+ // now
889
+ const runtime = await createRuntime({
890
+ store,
891
+ plugins: [...plugins, testWho],
892
+ transports: [transport],
893
+ fetch: fakeMeta,
894
+ });
895
+ const ticket = () => ticketFor(runtime, ana);
896
+ const hook = await runtime.fetch(new Request("http://localhost/hooks/whatsapp/vendas", init));
897
+ ```
898
+
899
+ **What changes, and what goes:**
900
+
901
+ - **`runtime.fetch(request, info?)`** answers every request: a route with a host first (a host it
902
+ takes is that route's alone); the socket (`/oxian`, and `<base>/oxian`); then requests from other
903
+ sites are refused; `POST /connect`; the REST API (`/api/`); plugins' routes; `GET /health` when no
904
+ route takes it (`ok`); else a 404. What a listener passes beside the request (Deno's `info`, Bun's
905
+ server) says the socket's address. Another runtime's route may forward a request to it
906
+ (`other.fetch(request)`), sockets included: a socket `Deno.serve` gave stays Deno's to accept. The
907
+ runtime accepts its own socket: Deno's upgrade under `Deno.serve`, a `WebSocketPair` on workerd
908
+ (not tested yet), else Oxian's route upgrade, whose decision `listen` takes directly (Oxian
909
+ 0.23.4's asynchronous `prepare`).
910
+ - **The site** is decided once, before anything else: the address the browser asked for, on the host
911
+ the app's front says when the request carries the front's secret (`x-copilotz-front`, the `caller`
912
+ resource's `front`; then `x-forwarded-host`), and under the app's base (`resources.page.base`: a
913
+ route sees `/o/acme/x` as `/x`). Routes are matched, and cookies named and secured, by it. Without
914
+ the secret, forwarded headers are ignored.
915
+ - **Requests from other sites are refused** (403), in one rule in place of the web host's
916
+ `fromPage`: a request that may change something (anything but GET, HEAD and OPTIONS), whose
917
+ `Sec-Fetch-Site` isn't `same-origin` (or `none`) or whose `Origin` isn't the site's own, unless it
918
+ carries `Authorization`. It holds for every route, not only `/connect`; a sibling host under the
919
+ same domain is another site; webhooks send no `Origin`, and pass. So an MCP server's `origins`
920
+ lets a browser's call through only with `Authorization`.
921
+ - **`resources.hosts`** (`{ own: ["app.example.com", "*.run.app"] }`): the app's own hosts. With
922
+ them named, a request to any other host is answered only by routes that take its host (a 404 when
923
+ none does), never by the runtime's paths, its socket or `/connect`; and the app's own hosts are
924
+ never a host route's. A host route for every host (`*`) takes only hosts that aren't the app's
925
+ own: with none named, none.
926
+ - **`who`** (`Plugin.who`, the `Who` and `WhoContext` types): asked in plugin order, once per
927
+ request and when `/connect` issues a ticket; the first answer wins, and none is anonymous
928
+ (`{ kind: "anonymous", id: "" }`). A `who` can't answer the system. What it queries is kept five
929
+ seconds per query and params, and dropped when the actor is disconnected. `WhoContext` has
930
+ `resources`, `query` and `call` (as the system: the api plugin notes a key's last use) and
931
+ `cookies.get`. A request with both a session cookie and a key is whoever the first plugin in order
932
+ says (usually the cookie). A store's failure while asking is a 500, never anonymous.
933
+ - **Routes** (`Plugin.routes`, the `Route` and `RouteContext` types): matched more specific first,
934
+ segment by segment (a literal before a parameter before a wildcard, deeper before shallower), `/*`
935
+ last, and among patterns alike in plugin order; a later plugin's route replaces an earlier one of
936
+ the same pattern, and `null` removes it. A route that isn't a pattern, or takes `/connect`,
937
+ `/oxian`, `/api` or anything under `/api/`, stops the runtime from starting. What a route throws
938
+ answers by its code: `invalid` 400, `unauthorized` 401, `forbidden` 403, `not_found` 404,
939
+ `too_many` 429 (with `retry-after`), anything else 500 (logged), its words only when they're
940
+ public.
941
+ - **Cookies** (`ctx.cookies`, the `Cookies` type): `get(name)`,
942
+ `set(name, secret, { days, sameSite })` and `clear(name, { sameSite })`, by the plain name; the
943
+ runtime puts them on the route's response. Every cookie is httpOnly, `Path=/`, with no `Domain`;
944
+ `Secure` and named `__Host-<name>` anywhere but plain http to this machine or one on its network;
945
+ `SameSite=Lax` (30 days) unless said. A value is 1 to 512 cookie-safe characters (letters, digits
946
+ and `._~+/=-`): a short one is fine where it's no secret; a cookie holding anything else reads as
947
+ none. A response that sets or clears one is `no-store`. A name is the first plugin's to set;
948
+ another may only when one builds on the other (`requires`), or both on the same one (Google's and
949
+ dev sign-in's, and the directory's sign-out, all set identity's session); anything else is a
950
+ plugin's mistake, and a 500. The `cookies` resource (`{ names, suffix }`, the `CookieSettings`
951
+ type) renames them: `names` maps a name to the one it goes by, and `suffix` follows every other.
952
+ - **Cookies the web host kept, and no longer does:** a leftover plain `session` cookie beside
953
+ `__Host-session` is no longer cleared (it's ignored); a cookie that proves no one (forged, ended)
954
+ is no longer cleared, and reads as nobody; `POST /signout` clears identity's `session` only (a
955
+ site visitor's cookie stays).
956
+ - **Tickets are the runtime's** (`runtime/tickets.ts`): one works once, for a minute; an actor has
957
+ 30 a minute (`browsers.tickets`), past which `/connect` is a 429 with `retry-after`. Disconnecting
958
+ an actor ends its tickets not yet used; a person's key has its own, apart from its person's.
959
+ `createRuntime`'s `admit` is gone, and the runtime always has a key for remote executors (a new
960
+ one each start, unless given).
961
+ - **`POST /connect`** (POST only: else 405) answers `{ ticket, actor: { kind, id } }` (no `name`:
962
+ the page asks `GET /me`), 401 for anonymous, and reads no body: arriving at a site chat is
963
+ `POST /web/<name>`.
964
+ - **Checked at start:** routes' patterns, `page.base` (a path with no trailing slash), the `cookies`
965
+ and `hosts` resources, and the `links` secret (too short to sign with stops the start, rather than
966
+ failing each link).
967
+ - **New in `copilotz`:** `runtimes` and `Runtimes`; `connect` and the client's types
968
+ (`ClientCollection`, `RemoteOptions`, `Watcher`…); `inScope` and `Scope`; `clientAddress`,
969
+ `setClientAddress` and `loopbackAddress` (were in `copilotz/web/server`); `bodyOf` and `jsonOf`;
970
+ `cookieSafe` and `CookieSettings`; `hostMatches`, `HostsSettings`, `ownHost`, `vouched`,
971
+ `loopback` and `nearby`; `callerOf` and `exemptProblem`; and the `Route`, `RouteContext`, `Who`,
972
+ `WhoContext` and `Cookies` types.
973
+ - **`runtimes(open, { idleMs })`:** runtimes by id, each opened on its first `get`, the same one
974
+ after (a failed opening is tried again), closed once idle (no browsers, nothing pending, 30
975
+ minutes unless said) and opened again on its next use; `peek(id)` and `entries()` never open one;
976
+ `close(id)` closes one now, and a `get` meanwhile opens another only once it has closed, so one id
977
+ never has two writers; `close()` closes them all.
978
+ - **`listen(fetch, { hostname, port, signal })`** (was `listen({ fetch, hypervisor, … })`) serves
979
+ any fetch handler on Node, Bun and Deno through Oxian's Node adapter, sockets included, and
980
+ answers a `Listener` (`url`, `finished`, `shutdown()`). `serve`, `ServeOptions` and `Server` are
981
+ gone.
982
+ - **The page plugin** (`webPage`, `copilotz/web/server`): `/app/*` (the code; the entry `no-cache`,
983
+ chunks kept a year), `/assets/*`, `/manifest.webmanifest`, `/sw.js`, and `/*` for GET navigations
984
+ only (`Sec-Fetch-Mode: navigate`, or an `Accept` with HTML, `*/*` or none): a script's `fetch`
985
+ there is a 404, not the page. Its `/*` takes `GET /health` too, so the runtime's `ok` answers only
986
+ an app without a page (with a page, `/health` was the page before as well). It refuses to start
987
+ without `page.code`. The page tells its code the base (`appBase()`), and its `/connect` and socket
988
+ follow it.
989
+ - **The page in the browser:** `web()` posts to `/web/<name>` first when it arrives as a visitor
990
+ (`arrive: { name, challenge? }`), asks identity's `GET /me` for the person's name while it takes
991
+ its ticket, and finds the ways to sign in by asking `GET /google` and `GET /signin/dev`.
992
+ - **Sign-in and sign-out are plugins' routes:** identity's `POST /signout` (ends the session,
993
+ disconnects whoever it was, clears the cookie) and `GET /me` (401 for anyone but a person), and
994
+ its contract's `signedIn` (sets the session's cookie, `SameSite=Lax` so an OAuth redirect back
995
+ carries it, and answers `{ person }`); Google's `POST /signin/google` (`{ idToken }`) and
996
+ `GET /google` (the first client id, cached five minutes); dev sign-in's `/signin/dev` (GET says
997
+ it's there, POST `{ name }` signs in), from this machine only, as before. Nothing refuses to start
998
+ with a recorded sign-in Action any more (the web host did): keep yours `record: false`, since its
999
+ answer is the session's secret. `credential.revoke` (taking someone out of an org) disconnects
1000
+ their browsers and drops what `who` kept for them, so their next request is nobody at once.
1001
+ - **Webhooks and other plugins' HTTP are routes; their URLs are unchanged:**
1002
+ - WhatsApp: `/hooks/whatsapp/*` does Meta's handshake and checks the signature, then calls
1003
+ `whatsapp.receive` with `{ number, payload }`; `whatsapp.number` finds a number by its path.
1004
+ Both are the system's (no `allow`); `whatsapp.hook` is gone. `hookRoute` is exported, for a
1005
+ number's own path.
1006
+ - Voice: `/hooks/voice/<name>` and `/hooks/voice/<name>/over` check Twilio's signature and call
1007
+ `voice.ring` and `voice.hangup` (`voice.hook` is gone); `/hooks/voice/<name>/relay` takes the
1008
+ call's socket with Oxian's `upgradeWebSocket`.
1009
+ - MCP: `/mcp/*`, finding the app's widgets in the `widgets` resource (was
1010
+ `webServer({ widgets })`).
1011
+ - Maintenance: `/maintenance/*`; an org's runtime (`resources.org`) still never serves it.
1012
+ - Chat: `GET /files/<id>` is chat's route (was the web host's), read as whoever the request is, or
1013
+ by a link signed for the file.
1014
+ - Connected accounts: `GET /accounts/callback/<provider>` calls `account.callback` with
1015
+ `{ provider, code, state, error? }` as the session's person, and sends them back to Connected
1016
+ accounts.
1017
+ - Computers: previews are one route for every host shaped like a preview's
1018
+ (`*://*-preview.*:*/*`), answering only for the app's `previews.domain`, with the grant at
1019
+ `/__copilotz/previews/grant`; a release's downloads (`computerDownloads({ dir })`) are
1020
+ `/computer/download/*`.
1021
+ - Stripe: `stripeWebhook` is a plugin (was a function the app routed to by hand),
1022
+ `POST /__stripe/<seller>`: it checks the signature on the raw text, reads the event as facts
1023
+ (`stripe.fact`, asking Stripe for a dispute's charge through `ctx.fetch`), and hands them to the
1024
+ org's runtime as `billing.apply` under the event's id. Which runtime is the org's: the `stripe`
1025
+ resource's `orgs` (the directory's pool), or without them this runtime, when the event is for
1026
+ its org. The plan an org goes back to is the `billing` resource's `start` ("free" unless said),
1027
+ not a `start` option. What can be tried again answers 500; what never can, 200.
1028
+ - The cloud pool: its VMs' socket (`/__pool/oxian`) is `cloudPool`'s route, answered by its
1029
+ runtime's own socket.
1030
+ - **The site chat:** `POST /web/<name>` limits newcomers by address, runs the site's challenge,
1031
+ calls `contact.arrive` and sets the visitor cookie (`SameSite=Strict`); the site chat's `who`
1032
+ reads it. `contact_visitor.actor` now answers a visitor that hasn't spoken yet too.
1033
+ - **`ctx.fetch`** (`Context.fetch`, `ReadContext.fetch`): what plugin code calls outside services
1034
+ with, in Actions, Processors and queries, remote executors included; the platform's `fetch` unless
1035
+ `createRuntime({ fetch })` gives another. Adapters stay for real ports (model providers).
1036
+ - **The REST API is the runtime's own** (`/api/`, answered by `runtime.fetch` for whoever `who`
1037
+ says): collections (`GET /api/collections/<name>?filter=…`, `…/<id>`; `POST`, `PATCH`, `PUT`,
1038
+ `DELETE`), Actions by the caller's own call id (`Idempotency-Key`), queries (`GET ?params=` or
1039
+ `POST`), Views, emits (`POST /api/events/<type>`), the events stream, and the reference
1040
+ (`GET /api/`); any GET with `Accept: text/event-stream` is a watch. A credential that proves
1041
+ nobody is a 401, and so is a refusal to anonymous. Any origin may call it with a key; with a
1042
+ session's cookie, only the app's own page. Streams end at once when their actor is disconnected,
1043
+ and at each ping (every 20 s, on the runtime's clock) when `who` says someone else. The api
1044
+ plugin's `serveApi`, `Served`, its own HTTP, events and reference, and its `api_key.see` and
1045
+ `api_key.get` queries are gone; the reference says `actor` (no `key` record).
1046
+ - **Direct writes from outside** (REST, and the socket's new `core.write`): only where a rule speaks
1047
+ for the collection's writes (`Guard`'s operation gains `direct`), never `sys.*`, never a private
1048
+ field (nor a filter, sort or update that names one, over the socket too; a replacement keeps
1049
+ them), within the caller's reach, schema-checked, and recorded as the caller's events.
1050
+ **Breaking:** plugins' records change through their Actions: their rules refuse direct writes for
1051
+ spaces, memberships, invitations and requests; identity's people and sessions; keys; contacts;
1052
+ chat's messages, `live`, threads, files and what was shown (`shown`); memories; skills and their
1053
+ files; routines and their runs; the computers plugin's records; apps; cloud computers; agents;
1054
+ accounts; WhatsApp's phones and numbers; and voice blocks. Still writable directly, each under its
1055
+ rule: apps' own collections (an app guards its own the same way when its rules assume its
1056
+ Actions). Following events or watching a read holds a request open: an anonymous caller gets 401.
1057
+ The events stream follows the rules: a change is sent when the reader's rule matches the event's
1058
+ document.
1059
+ - **Identity: only a session proves someone.** `credential.actor` asks for `kind: "session"`: a key
1060
+ identity made before (`kind: "key"`, unscoped) proves nobody.
1061
+ - **The client** (`connect`, from `copilotz` and `copilotz/web`): `client.db.collection(name)`
1062
+ (`find` with `.toArray()`, `findOne`, `countDocuments`, `insertOne`, `updateOne`, `replaceOne`,
1063
+ `deleteOne`, `query`, `watch(filter, options?, onChange)`), `client.call(action, input, { id })`,
1064
+ and `connect(url, { key, over: "socket" | "http", plugins?, fetch? })` for scripts, beside the
1065
+ page's `connect({ transport, ticket, plugins })`. The socket gains a call's own id.
1066
+ - **Developer keys** are members of their space, with a scope. A key's actor is
1067
+ `{ kind: "person", id, key, scope }` (`within` is gone): `people` still lets it in and `inPerson`
1068
+ keeps it out. It's a member of its space (`key:<id>`), an editor when its scope calls or writes,
1069
+ else a viewer, never more than its person may be there, and reaches what both its membership and
1070
+ its person reach, with no org role (an admin's key reaches only its space). Its `scope` (exact
1071
+ names, no wildcards) is checked by the runtime (`inScope`) only where a call from outside comes
1072
+ in: calls, queries, Views rendered for it, direct reads and writes; a scoped actor emits nothing.
1073
+ Never inside a job: an Action it may call writes as usual. `api_key` records keep `scope` and
1074
+ `role`; their id is the start of the secret's hash (`hash` is private); they live in their space
1075
+ (`shared`), where its members see them in the Members tab and its managers revoke them.
1076
+ `api_key.actor` answers the actor; `api_key.revoke` (its person, or a manager) ends the key, its
1077
+ membership and its connections, and so does its person leaving the space or the org;
1078
+ `ctx.disconnect` of a key ends only its own. Spaces add `spaceMembers` (a section of the Members
1079
+ tab). A key's default space is gone: the runtime knows no spaces, and REST and the socket must
1080
+ behave the same.
1081
+ - **Identity makes no keys:** `key.create`, `key.revoke` and `credential.keys` are gone, and a
1082
+ credential is a session. People and sessions change only through identity's Actions.
1083
+ - **Many orgs, by forwarding** (see design/tenancy.md): the directory's routes forward `/o/<org>/…`
1084
+ to that org (404 for none, 403 when suspended), `/*` to the org the browser is in (a page asked
1085
+ for without a session there goes in first, to the org they were in, else their last, else their
1086
+ own, made now, then 302s back), and a host an org claimed to that org's host routes; anything else
1087
+ for someone signed in nowhere is the lobby's (without one, a 401). Entering an org (`POST /orgs`,
1088
+ `/orgs/enter`, `/orgs/invites/answer`, and a page's way in) is `org.enter`, then a signed handoff,
1089
+ a minute long and never out of the process, to the org's own `POST /enter`, which keeps who they
1090
+ are, joins them the first time, starts its session and sets its cookie (`s_<org>`). The
1091
+ directory's own: `GET /orgs`, `POST /signout` out of every org it holds a session for (each ended
1092
+ where its org is open; signing out never opens one), staff's `/console/orgs…` and
1093
+ `/console/codes…`, and the front's `/__copilotz/hosts/resolve` on any host. `directory.member`
1094
+ gives each org's runtime `resources.org` (id, name, kind, address), `page.base`, its cookies'
1095
+ names (`{ names: { session: "s_<org>" }, suffix: "_<org>" }`), the app's own hosts, the
1096
+ directory's hooks (invitations, leaving, renaming, claiming and releasing hosts, gift codes) and
1097
+ its `/enter`. The directory's session is still `__Host-dir` (the directory plugin's `cookies`
1098
+ resource), and which org a browser is in, `__Host-org`. `org.info` (a query, in place of the
1099
+ `org.get` Action) is kept 10 seconds, hosts' claims a minute, each forgotten at once when the
1100
+ directory changes it. The orgs host's tests are ported (`plugins/access/tests/orgs*.test.ts`).
1101
+ - **Removed entry points and exports:** `copilotz/web/tickets` (`createTickets`) and `copilotz/orgs`
1102
+ (`orgsHost`). From `copilotz/web/server`: `webServer`, `WebServerOptions`, `socket`, `Entrance`,
1103
+ `SignIn`, `Arrived`, `Door`, `Whom`, `whomOf`, `cookieOf`, `hostCookie`, `setCookie`, `siteOf`,
1104
+ `ANONYMOUS` (write `{ kind: "anonymous", id: "" }`), `Front`, `hostOf`, `HttpRequest`,
1105
+ `HttpAnswer`, `httpRequest`, `Route` (now the runtime's, a function), `RouteSocket` and `Served`;
1106
+ `clientAddress`, `setClientAddress` and `hostMatches` moved to `copilotz`. From `copilotz/web`:
1107
+ the orgs' browser half (now `copilotz/plugins/access/web`). From `copilotz/web/node`: `serve`,
1108
+ `ServeOptions` and `Server`. From `copilotz/plugins/interfaces`: `serveApi`, `WebLine` and the
1109
+ other `*Line` types. The `entrances`, `signIn` and `routes` resources; `createRuntime`'s `admit`;
1110
+ the actor's `within`; `whatsapp.hook` and `voice.hook`.
1111
+
1112
+ - **Oxian 0.23.5:** the Node adapter keeps an error listener on each request and response for their
1113
+ whole life, so a client leaving mid-response (a server-sent stream it stops) never reaches the
1114
+ process as an unhandled error (it did under Bun).
1115
+
1116
+ ## 1.0.0-rc.24 — 2026-11-06
1117
+
1118
+ **Upgrading from rc.23** (two breaking renames; no aliases, no data moves):
1119
+
1120
+ 1. **Views are found by name alone; the medium is gone.** Flatten `views`:
1121
+ `{ "booking.panel": { web: BookingPanel } }` becomes `{ "booking.panel": BookingPanel }` (`Views`
1122
+ is `Record<string, View>`). `render(medium, name, item, options)` and
1123
+ `observe(medium, name, item, options)` lose their first argument:
1124
+ `ctx.render("llm", "thread", t)` is `ctx.render("llm.thread", t)`,
1125
+ `client.observe("web", "booking.panel", item)` is `client.observe("booking.panel", item)`.
1126
+ `ViewContext` loses `medium`, and its `kind` is now `name`. `ctx.show(name, item)` shows exactly
1127
+ the View it names: there is no inheritance by place. The `"*"` fallback is gone; the hosts ask
1128
+ for their own default (`web.default`, `terminal.default`) when a name has no View.
1129
+ `runtime.describe().views` is the list of names. `GET /api/views/<name>` takes the name
1130
+ (`llm.thread`) and no longer reads `?medium=`; API keys that list a View by `thread` or `message`
1131
+ list `llm.thread` or `llm.message`. An MCP widget's `_meta` names the View without a medium.
1132
+ Where the same thing is shown in several places the name takes the place as a prefix; seven kinds
1133
+ were renamed:
1134
+ | Was | Is |
1135
+ | ------------------------- | ------------------------------------------------------------------------------------------- |
1136
+ | `message` | `llm.message`, `web.message`, `terminal.message`, `whatsapp.message`, `voice.message` |
1137
+ | `thread` | `llm.thread`, `web.thread`, `terminal.thread` |
1138
+ | `memory` | `llm.memory`, `terminal.memory` |
1139
+ | `live`, `shell`, `spaces` | `web.live`, `web.shell`, `web.spaces`; `terminal.live`, `terminal.shell`, `terminal.spaces` |
1140
+ | `*` | `web.default`, `terminal.default` |
1141
+
1142
+ Every other name stays (`tool:<name>`, `context:<name>`, `addition:<name>`, `mcp:offered`, and
1143
+ the rest). The last plugin to register a name still wins, so an app replaces WhatsApp's message
1144
+ with its own `whatsapp.message`. A page's address still names its View as before
1145
+ (`/thread/<id>`): the web shell looks for that name, then `web.<name>`, then `web.default` (hint
1146
+ `of` names the address's kind); the terminal's `open` does the same with `terminal.`.
1147
+ 2. **The anonymous actor is `anonymous`, not `visitor`:** a request nobody is signed in to is
1148
+ `{ kind: "anonymous", id: "" }` (`VISITOR` is `ANONYMOUS` in `copilotz/web/server`). Rules that
1149
+ named `visitor` name `anonymous` (identity's `callback` allows `person` or `anonymous`). The
1150
+ `visitor` entrance and its cookie keep their names. `runtime/actor.ts` now lists all six kinds
1151
+ (person, agent, contact, system, maintenance, anonymous); `routine` is an origin and `space` a
1152
+ kind of member, not actors.
1153
+
1154
+ - **Oxian 0.23.4:** its adapters await an asynchronous `prepare`, so a front serving several
1155
+ runtimes behind one listener can open the right one before deciding a socket upgrade.
1156
+
1157
+ ## 1.0.0-rc.23 — 2026-11-05
1158
+
1159
+ **Upgrading from rc.22** (three renames and one host change; nothing else needs doing):
1160
+
1161
+ 1. **`renderer` is `medium`:** rename `ctx.renderer` to `ctx.medium` in Views and in hand-made test
1162
+ contexts (`renderer: "web"` to `medium: "web"`). No alias.
1163
+ 2. **Web lines moved to the web interface:** add `webLines` beside `...access`
1164
+ (`plugins: [models, chat, ...access, webLines]`) and import `WebLine`, `WebLimits`, `WebSettings`
1165
+ and `WEB_LIMITS` from `copilotz/plugins/interfaces`. The `contactSend` hook's key is `web` (was
1166
+ `contacts`). No data moves.
1167
+ 3. **One web host:** `serveRoutes`, `routeHost` and `RouteListener` are gone, and so are `serve`'s
1168
+ `google` and `dev` options: declare sign-in with `googleSignIn` and `devSignIn` plugins instead.
1169
+ `serve` answers a `Server` (`close({ drain })`); `/connect` answers `{ ticket, actor, name? }`
1170
+ (`person` is gone).
1171
+
1172
+ - **Breaking: web lines are the web interface's, not contacts'.** `resources.web.lines`, arrival,
1173
+ the `visitor` entrance, the budget, the challenge, prune and the limits moved from
1174
+ `plugins/access/contacts` into `plugins/interfaces/web`, as one plugin, `webLines` (exported from
1175
+ `copilotz/plugins/interfaces`), as WhatsApp's, the phone's and MCP's lines are in theirs. The
1176
+ resource shape is the same (`web: { caller?, lines: { … } }`), and so are the Actions
1177
+ (`contact.arrive`, `contact.sending`, `contact.prune`, `contact.spent`, `contact.budget`) and
1178
+ collections (`contact_visitor`, `contact_rate`): nothing is renamed, so no data moves. Migrate by
1179
+ adding `webLines` beside `...access` (`plugins: [models, chat, ...access, webLines]`) and
1180
+ importing `WebLine`, `WebLimits`, `WebSettings` and `WEB_LIMITS` from
1181
+ `copilotz/plugins/interfaces` instead of `…/access`. Contacts keeps the contact, `contact.start`,
1182
+ `contact.chat` and `contact.forget`; erasing a visitor's contact now ends its cookie and its
1183
+ connections in a processor of `contact.deleted` (`web.forget`), a moment after the erasure, not in
1184
+ the same transaction. The `contactSend` hook's key is `web` (was `contacts`).
1185
+ - **Breaking: `renderer` is `medium`.** The docs said "medium" and the API said `renderer`; now one
1186
+ word. A View's context field `ctx.renderer` is `ctx.medium`, and the wire/owner `render` job's
1187
+ `renderer` field is `medium`. Migrate by renaming `ctx.renderer` to `ctx.medium` (and a test's
1188
+ hand-made context `renderer: "web"` to `medium: "web"`); `render(medium, kind, item)` already took
1189
+ the medium by position. The medium names are unchanged (`llm`, `web`, `terminal`, `whatsapp`,
1190
+ `voice`). No alias.
1191
+ - **One web host, its parts from the app's plugins.** `serve` (and `webServer` beneath it) is the
1192
+ host for every app: routes from `routes` resources, as before; the page and its code from `code`
1193
+ (none: no page, the routes and `/health`); who a browser is from a new `entrances` resource; how
1194
+ people sign in from a new `signIn` resource; browsers connecting with `tickets` (none: no browser
1195
+ connects). `serveRoutes`, `routeHost` and `RouteListener` are gone, and so are the host's `google`
1196
+ and `dev` options; `serve` answers a `Server`, whose `close({ drain })` stops listening and then
1197
+ closes the runtime.
1198
+ - **Entrances:** each is a cookie and the query that says who its secret is (`{ secret }` in, an
1199
+ actor out), asked in `order`; one may let a newcomer in on `POST /connect` (`arrive`, given the
1200
+ socket's address and the secret its cookie holds when that's no one yet), and end what it is on
1201
+ sign-out (`end`). The host keeps every cookie (httpOnly; `Secure` but over plain http to this
1202
+ machine or a LAN host, by the host the request is for as the app's front says it; `sameSite` lax
1203
+ or strict; `hostOnly`: `__Host-<name>` wherever it's Secure), clears one that's no one (forged,
1204
+ ended), and never takes a store's failure for no one. Identity declares the session (`session`,
1205
+ host-only, read by `credential.actor`, ended by `session.end`, which now takes `{ secret }` and
1206
+ is unrecorded: its secret was in the log). `/connect` answers `{ ticket, actor, name? }`
1207
+ (`person` is gone); `web()` connects as whoever it is (`start(client, actor)`), and
1208
+ `web({ arrive })` is what the page asks coming in, at the app's `base` (an org's, with many).
1209
+ - **Sign-in:** `POST /signin/<name>` for each way a plugin declares: an unrecorded Action (the
1210
+ host refuses to start with a recorded one), called as the system with the request's JSON,
1211
+ answering `{ person, session }`; `local` ones from this machine only: the socket's address (as
1212
+ the listener saw it, `clientAddress`) and the host must both be loopback, a request whose
1213
+ address nobody set is refused, and so is one carrying any header a proxy adds (`forwarded`,
1214
+ `via`, `x-forwarded-*`, `x-real-ip`, `cf-connecting-ip`…: a proxy on this machine that rewrites
1215
+ `Host` made every request this machine's). `devSignIn` refuses to start in an app whose `links`
1216
+ origin is public (a proxy that adds no header, as nginx's `proxy_pass` as it comes, can't be
1217
+ told from this machine). `googleSignIn` declares `google` (the page shows its button for the
1218
+ first client id); the new `devSignIn` plugin declares `dev` (by name or email, this machine
1219
+ only). The orgs host signs in with whatever its directory declares (`signIn: { at: directory }`
1220
+ for its orgs' pages). `describe()` marks unrecorded Actions (`record: false`).
1221
+ - **Visitors** (the contacts plugin's web lines, `resources.web.lines.<name>`: `in`, `agent`,
1222
+ `title`, `days`, `limits`, `files`, `transcribe`, `org`; `web.caller`, as MCP's; and the app's
1223
+ `links` secret, which visitors' cookies are signed with): a page asking to come in by a line
1224
+ (`{ line }`) that isn't anyone becomes a visitor, its browser keeping a signed secret in a
1225
+ `SameSite=Strict` cookie (`__Host-visitor` wherever it's Secure) that's the same visitor for
1226
+ `days` (30). Coming in makes and keeps nothing, in memory either: the visitor the server issues
1227
+ carries its line (`web`) and its networks' tags (`from`: HMACs, never the address), which its
1228
+ messages are counted by. Its first message (`chat.send`, naming no chat) makes its contact
1229
+ (`via: "web"`), its own chat in the line's space and its record (`contact_visitor`), through
1230
+ chat's new `contactSend` hook (`contact.sending`). Limits, each a plain 429 for that caller
1231
+ alone, by address held for each network it's in (`networksOf`: an IPv4 address and its /24, an
1232
+ IPv6 /64, its /56 and its /48, each as many callers' worth as it counts, `SCALE`: 8, 4 and 8):
1233
+ new visitors an hour from one address (`ipVisitorsPerHour`, 20), and as many first messages,
1234
+ counted by the address the app's front says, else the socket's (with neither, nobody's let in,
1235
+ said loudly; all from one private address, said once); a visitor's messages a minute and a day
1236
+ (`perMinute` 10, `perDay` 200), its address's (`ipPerMinute` 30, `ipPerDay` 1,000), the line's a
1237
+ minute (`linePerMinute` 300, of which newcomers, who hadn't spoken before the minute, send
1238
+ `newcomersPerMinute` 200: the rest is kept for conversations going on), and new visitors who
1239
+ speak an hour (`visitorsPerHour`, 600), each place taken in one conditional write, so messages
1240
+ at once can't pass a limit. A line's `budget`: what its visitors' turns may be charged a day
1241
+ (UTC), as the usage ledger prices them (`usage.quote`, through `modelUse`); past it, its
1242
+ visitors' messages wait for tomorrow. A line's `challenge`: an Action of the app's a newcomer
1243
+ passes first (a CAPTCHA's check, given what the page sent,
1244
+ `web({ arrive: { line, challenge }
1245
+ })`). Files only on a line that takes them
1246
+ (`files: { count, bytes }`, 1 of 5 MB unless said), each with a media type; audio transcribed
1247
+ only with `transcribe: true`. `contact.forget` ends a visitor's cookie and its browsers'
1248
+ connections at once (its record stays, ended, until its cookie's time is past), and so does
1249
+ removing its line. Every ten minutes (`contact.prune`) what's past goes: counters, records past
1250
+ their time, a contact made for a first message that never went in. A visitor fetches its own
1251
+ chat's files (`file.content` is open to contacts, under the rules), and finds its chats by its
1252
+ own memberships (`member` by its key, `contact:<id>`). Checked at start (a challenge that's no
1253
+ Action, a budget without the usage plugin).
1254
+ - **What a contact reads:** never an agent's private steps (each tool's input and output), a tool
1255
+ call being written, a step's words before it's known to be an answer, why a model's call broke
1256
+ (the provider's words), nor a tool's files. The access rules' `shared` resource takes `contact`,
1257
+ a filter a contact acting itself (never the agent working for it) reads and writes through:
1258
+ chat's messages without `private` or `toolCalls`; `live` without a tool call or a `retry`, and
1259
+ with words only of a turn that offers no tools (`open: true`, every step an answer; of one that
1260
+ does, a contact sees only that the agent is at work); files without a tool's (`private`, as
1261
+ OpenAPI's are now). A turn stopped mid-step keeps its words only when they were surely an
1262
+ answer. A contact's own reads from its browser name what of its own they read (its chat:
1263
+ `thread`, or `_id`, 32 at most, its read 2 KB of JSON at most: `CONTACT_READ`; of spaces and
1264
+ memberships, only its memberships by its key), else they're refused and never watched; it reads
1265
+ no `aggregate` or `nearest` directly. The voice relay reads its call as the line's agent working
1266
+ for the caller (only what both may read), and says what a web visitor reads: answers, never a
1267
+ step's words before its tools, and words as they're written only of a turn that offers no tools
1268
+ but those called beside an answer (a tool's new `aside: true`, as the voice plugin's `end_call`
1269
+ is): one with other tools says its answer once it's whole. A contact's message says 4,096
1270
+ characters at most (`CONTACT_TEXT`), never what sent it (`via`), and never titles its chat or
1271
+ lets an agent rename it (`title`, `renamable`); a file's media type is one (`MEDIA_TYPE`, 127
1272
+ characters at most, `MEDIA_TYPE_LENGTH`), which the agent is told. WhatsApp, voice and MCP
1273
+ contacts never held a browser connection: they read only through the app's own code.
1274
+ - **Security:** `/connect`, sign-in and sign-out (and the orgs host's own POSTs) answer only the
1275
+ app's own page: an `Origin` that isn't this host (as the front says it), over https off this
1276
+ machine and its LAN, or a cross-site `Sec-Fetch-Site`, is a 403, so another site can't make its
1277
+ visitors arrive here or sign anyone in. Bodies there are JSON objects of 16 KiB at most; route
1278
+ bodies are refused (413) as soon as `content-length` is over 10 MB, and read no further than
1279
+ that while streaming. What either host answers in JSON is `cache-control: no-store`, and what
1280
+ goes wrong says only its public words, with its code's status (500s are logged). So does a
1281
+ route's Action that refuses (`forbidden`, `invalid`, `not_found`, `unauthorized`: its status,
1282
+ and its words only when public). The caller's address parser (`callerFrom`, `callerProblem`,
1283
+ `CallerSettings`, and `countedOf` for a socket's) moved from MCP into the runtime, so MCP and
1284
+ web lines read callers one way. `mcp.call` refuses a contact without an MCP line (a web
1285
+ visitor), naming a line or not.
1286
+ - **Limits on browsers:** 30 tickets per actor a minute (`createTickets({ perMinute })`; past them
1287
+ `/connect` is a 429 with `retry-after`, and `issue` throws `too_many`), 16 browsers (worker ids)
1288
+ per actor, each on two connections at most (one coming while the last goes), 512 watched reads
1289
+ per connection (past them, `too_many`; those watched keep going), 16 resume credentials per
1290
+ actor (the oldest dropped), each working once, for the browser it was given to. A connection
1291
+ counts from the moment it's let in (Welcome) until it goes, ready or not, and one that doesn't
1292
+ say it's ready within 10 seconds is closed (the owner's Hypervisor `readyTimeoutMs`, for every
1293
+ worker: none starts anything before Ready). A contact far less: 2 browsers, 32 watched reads on
1294
+ each connection; and contacts together 16 connections from a network (as many times as it
1295
+ counts: by the tags of `actor.from`, `scaleOf`), 300 on a web line, 400 in all: well under what
1296
+ a listener holds (`LISTENER`, Oxian's Node adapter's 1,000), so people find room. Runtimes on
1297
+ one listener count their contacts together with one `contactsPool()`: the orgs host gives each
1298
+ org one (`open`'s `given.browsers`, for `createRuntime({ browsers })`). The limits are settings:
1299
+ `createRuntime({ browsers })` (`BrowserLimits`: `sockets`, `watches`, `resumes`, `contact`,
1300
+ `network`, `line`, `contacts`, `pool`), checked at start; people never count against contacts'.
1301
+ A contact's browser is told a failure's words only when they're for anyone (`public`), as MCP's
1302
+ callers are: never a provider's (a transcription's raw error said a key's prefix). Tickets and
1303
+ resumes expire on a timer (`runtime/expiring.ts`), never by looking through them all on each one
1304
+ issued.
1305
+ - **Cookie names, and a one-time sign-out:** every entrance's cookie is the host's alone unless it
1306
+ says `hostOnly: false`: identity's session is `__Host-session` wherever it's Secure, and the
1307
+ orgs host's own cookies (`dir`, `org`, `s_<org>`) and every org's entrances' are `__Host-` too,
1308
+ so no other host under the domain (a preview's page) can set one to make a browser someone it
1309
+ chose. The names change: every browser signed in before is signed out once, on upgrade, and what
1310
+ it held under the old plain name is ended where it lives and cleared (on `/connect` and on
1311
+ sign-out), so a version rolled back that reads the plain names finds no one there. Stripping
1312
+ `Domain` from a preview's Set-Cookie (as previews do) doesn't stop that by itself: a preview's
1313
+ page script can still set `document.cookie` with `Domain=<parent>`; the `__Host-` names are what
1314
+ stop it.
1315
+ - **Signing out, and erasing a contact, end their browsers** (`runtime.disconnect(actor)`, and
1316
+ `ctx.disconnect` from an Action): their resume credentials go and each connection closes. A
1317
+ browser comes back only with a new ticket: the client now asks for one when its way back is
1318
+ refused (it used to stop, until its page reloaded), which only a cookie that's still someone
1319
+ gets; another device of the same person comes straight back. A connection let in before (not yet
1320
+ ready) is never ready, and tickets handed out to them not yet used are no one's (`Tickets.end`,
1321
+ which sign-out calls). An org's own (`bound:`) executor can't end anyone's browsers; plugins are
1322
+ trusted code, as with `cancel`. With the orgs host, sign-out ends every open org's session the
1323
+ browser holds.
1324
+ - **Migration:** `serveRoutes({ runtime, … })` is `serve({ runtime, … })` with no `code`.
1325
+ `google: { clientId }` and `dev: true` are the plugins' resources now: add `googleSignIn` (with
1326
+ the `google` resource) and `devSignIn` to the runtime's plugins (the directory's, with orgs). A
1327
+ listener of the app's own (`Deno.serve`) says where each request came from
1328
+ (`setClientAddress(request, info.remoteAddr.hostname)`, from `copilotz/web/server`), and so do
1329
+ tests that sign in with dev sign-in through a hand-made `Request`
1330
+ (`setClientAddress(request, "127.0.0.1")`); `serve` and `listen` do it themselves. Web lines
1331
+ need the `links` resource. `whomOf(runtime, { cookie?, front? })` (was
1332
+ `whomOf(runtime,
1333
+ cookie?)`), and `setCookie` takes the request's site
1334
+ (`siteOf(request, front)`). An entrance whose cookie something else under the domain reads says
1335
+ `hostOnly: false`. A visitor's page finds its chat through its memberships (`member`
1336
+ `{ member: "contact:<id>" }`), not by reading every `thread`. An app that ran this branch
1337
+ before: visitors' cookies (their secret's format and key changed) and links signed before
1338
+ upgrading don't open; visitors are newcomers once.
1339
+ - **The runtime, for the web host's limits** (from the second security review of the one host):
1340
+ - **The in-memory store reaches a document by its id at once.** A filter that keeps to ids (`_id`
1341
+ a string, `$eq` one, `$in` strings, also in a top-level `$and`) looks them up, rather than
1342
+ copying and scanning the whole collection on every read and write; other reads scan without a
1343
+ copy, and stop at a `limit` without a `sort`. The `durable: false` collections (`live`, the web
1344
+ lines' counters, billing's `room`) share that store and its one transaction queue, so their cost
1345
+ no longer grows with what they hold. Results come in the same order.
1346
+ - **Links are signed with a key of their own** (`keyOf(secret, use)`, HKDF-SHA256 of the `links`
1347
+ secret; web visitors' cookies use another), never the secret itself, and the `links` resource
1348
+ takes the one before it (`previous`), while what it signed should still open: a link until it
1349
+ expires, a visitor's cookie (the same contact) while it lasts. **Breaking:** links signed before
1350
+ upgrading (an hour's) no longer open. A secret that leaked is never given as `previous`: it goes
1351
+ at once.
1352
+ - **A rule hears a browser's own reads** (`Guard`'s `direct`, asked with the read's filter before
1353
+ it's watched) and may refuse one it won't watch, throwing. Plugins' `check` sees every Action
1354
+ (`merged.actions`). A contact reads its own memberships by its key (anyone else, memberships as
1355
+ far as they reach: a key `within` a space, that space's).
1356
+ - **An aggregate with its own `$match` works under a rule:** the rule's filter joins it in one
1357
+ `$match`; before, every such read failed `invalid`.
1358
+ - **Who calls, by network:** `networksOf(counted)` (an address's wider networks, each with its
1359
+ prefix and `scale`), `SCALE`, `scaleOf(tag)`, `privateAddress(address)`.
1360
+ - **From the third security review of the one host:**
1361
+ - **A watched read is matched only against changes it could concern.** A read whose filter names
1362
+ values of a field of its own (a string, `$eq`, `$in` of up to 256 strings: a chat's `thread`, an
1363
+ `_id`) is filed under them; a change to a document holding none of them (before or after, in
1364
+ that field or an array there) skips it before any matching. The owner's read cache does the same
1365
+ for the queries it keeps. Results are exactly as before. New in the reference
1366
+ (`runtime/mongo.ts`): `namedBy(filter)`, `valuesAt(doc, field)`.
1367
+ - **A web line's budget holds, and fails closed.** Each visitor's message holds an estimate of its
1368
+ turn's cost as it goes in (the most one of the line's visitors' model calls cost lately; before
1369
+ any is known, the rest of the day's budget, so one turn goes at a time until a cost is),
1370
+ released as its first call is charged, or lapsing in two minutes: messages at once can't all
1371
+ pass a budget only one fits. Before each model call (and transcription) for a visitor, a spent
1372
+ budget refuses it, for good, so a turn's tool loop stops there: the models plugin's `modelUse`
1373
+ listeners may now refuse a call before it's made (`may`, its refusal `final`; `mayUse`,
1374
+ `ModelCall`). Use the ledger prices at nothing (no price for the model, or pricing failing)
1375
+ closes the line for the day, said in the log. New: `contact.budget`; `contact.spent` takes
1376
+ `contact`, and `unpriced`.
1377
+ - **Web visitors:** a secret dated more than 5 minutes ahead is nobody's. An erased visitor's
1378
+ record is kept as long as any cookie made before could last (400 days, the most a line may say,
1379
+ `MOST_DAYS`), so raising a line's `days` can't bring an erased visitor back.
1380
+ - **MCP's ids** (contacts, chats, users, addresses) are HMACs with the `mcp` key of the app's
1381
+ secret (`keyOf`), never the secret itself; with `links.previous`, a conversation made under the
1382
+ one before goes on as itself (the new system-only `mcp.conversation`; `mcp.call` takes the chat
1383
+ the route found, `thread`). **Breaking:** every MCP conversation from before is new once (no
1384
+ deployment uses the MCP interface yet).
1385
+ - **MCP widgets: an app's web Views drawn inside ChatGPT and other MCP Apps hosts** (#165). A line's
1386
+ tool can name a web View (`mcp.lines.<name>.tools.<tool>.widget`); the web host serves one
1387
+ `ui://<line>/widget-<version>.html` template per line (`webServer({ widgets: widgetsOf(...) })`),
1388
+ and a result carries the View, a snapshot of what it reads, and a short-lived grant in `_meta`
1389
+ only, never in what the model reads. Widget-only tools (`visibility: ["app"]`, `action`) refuse
1390
+ calls without a grant for that conversation. The widget host is `copilotz/web/widget`
1391
+ (`widget({ plugins, root })`), speaking MCP Apps' postMessage bridge with ChatGPT's
1392
+ `window.openai` as fallback.
1393
+ - **A tab comes back after a network flap.** A new connection on a worker id that already has two
1394
+ closes the oldest instead of being refused (a Welcome lost on the way no longer locks the tab
1395
+ out), and a client that was in once keeps re-enrolling, longer apart, when it's refused.
1396
+ - **A model the app doesn't pay for is checked against a web line's budget too** (`paid`-tagged ones
1397
+ skipped `may`, so a visitor's tool loop could go on past a spent day).
1398
+ - **A web line's budget loses no charge under load:** `charge` is one atomic write (`$inc` the
1399
+ spend, `$unset` the hold), and `hold` retries with jitter until a deadline instead of eight
1400
+ immediate tries (no more false "busy"). One call costing more than the whole budget no longer
1401
+ closes the line for 30 days: with nothing held, a message holds at most what's left.
1402
+ - **Voice: a line's `waiting` phrase** (`voice.lines.<name>.waiting`, none by default) is spoken
1403
+ once when a turn starts running tools before any answer, so a caller doesn't hear silence. Never
1404
+ for an answer without tools, nor for `end_call`.
1405
+
1406
+ ## 1.0.0-rc.22 — 2026-11-04
1407
+
1408
+ **A security release: upgrade now.** Before it, a Google sign-in wrote the new session's secret to
1409
+ the event log, and connecting a computer wrote the computer's secret (the first entry below). After
1410
+ upgrading, every deployment should:
1411
+
1412
+ 1. **End every session made before the upgrade:** delete the `credential` documents of
1413
+ `kind: "session"`, so every signed-in person signs in again. Keys are unaffected.
1414
+ 2. **Scrub the old events that hold these secrets**, from the store and from anything that copied it
1415
+ (backups, exports, exporters): the `action.started` and `action.completed` events of
1416
+ `google.sign-in`, `computer.code`, `computer.enrollment` and `computer.work`, and the
1417
+ `action.started` events of `session.end`, `computer.admit`, `pool.admit` and `pool.serve`.
1418
+ 3. **Reconnect computers whose log may have been read:** forget each one (`computer.forget`) and
1419
+ connect it again with a new code. A computer's secret can't be rotated yet.
1420
+
1421
+ - **Security: a Google sign-in no longer writes the session's secret to the log.** `google.sign-in`
1422
+ was a recorded Action, so the event log kept its input, the Google ID token, and its result,
1423
+ `{ person, session }`, with the new session's secret in plain text. Anyone who could read the log
1424
+ (a database reader, a backup, an export, an exporter) could sign in as that person, staff
1425
+ included. The identity plugin keeps secrets only as hashes, and this Action undid that. It is now
1426
+ unrecorded (`record: false`), like `session.start`. So is `session.end`, whose input is the secret
1427
+ being ended. Found by a security review.
1428
+ - **Computers' secrets are kept out of the log too**, found by checking every Action for the same
1429
+ mistake. These are now unrecorded: `computer.admit`, whose input is a computer's secret (or the
1430
+ code connecting it) on every connect; `pool.admit`, whose input is a pool VM's identity token;
1431
+ `computer.code`, whose result is the code that connects a computer as its person; and
1432
+ `computer.work`, whose input and result are what a person types and sees in their shell, files'
1433
+ contents and the env values they pass. `computer.enrollment`'s result (`code`) and
1434
+ `pool.serve`'s `assign.code` and `assign.secret` (also when forwarded by `remotePool`) are
1435
+ private: still recorded, so a retried wake gets the same code, but the code isn't logged.
1436
+ - **Deployments should end every session made before this fix.** Delete the `credential` documents
1437
+ of `kind: "session"`, so every signed-in person signs in again. Keys are unaffected. A
1438
+ computer's secret can't be rotated yet: where the log may have been read, forget the computer
1439
+ (`computer.forget`) and connect it again with a new code.
1440
+ - **Old events still hold these secrets until they're scrubbed**, from the store and from anything
1441
+ that copied it: the `action.started` and `action.completed` events of `google.sign-in`,
1442
+ `computer.code`, `computer.enrollment` and `computer.work`, and the `action.started` events of
1443
+ `session.end`, `computer.admit`, `pool.admit` and `pool.serve`. Ended sessions, used codes and
1444
+ expired tokens prove nobody, but scrub them anyway.
1445
+
1446
+ - **MCP: a conversation whose first call an owner stopped no longer ends for good.** A new
1447
+ conversation's chat is made (`chat.open`) and then shared with its contact (`member.set`), two
1448
+ writes; an owner that stopped between them (a deploy, which doesn't wait for running calls, or a
1449
+ crash) left a chat its contact couldn't reach, which is how a contact its people took out of its
1450
+ chat looks, so every later call said "This conversation with the app is over". A new
1451
+ conversation's opening is now noted with its first call's counts (`mcp_opening`, durable, no
1452
+ events, gone with its receipts after 15 minutes) and dropped once the chat is shared: a chat out
1453
+ of its contact's reach, with its opening noted, goes on as new (asked again within 15 minutes, its
1454
+ contact not erased); without one, it stays over. Erasure's tombstones are read first, as before.
1455
+ This is what failed the MCP restart test on slower machines (macOS CI); the test now waits on what
1456
+ it watches for, not on fixed times, and a new one stops an owner at each of a first call's writes.
1457
+ - **Contacts: a start cut short after a contact's record, before sharing it with the contact, is
1458
+ finished when it's started again** (`contact.start`, on WhatsApp, voice and MCP): the contact, and
1459
+ the agent working for it, read the record again. A known contact was returned as it was.
1460
+ - **Maintenance SQL can run as the store's own role, told so:**
1461
+ `postgresStore({ url, schema, maintenance: { storeRole: true } })`, beside a role of its own
1462
+ (`maintenance: { url }`; both at once stop the store from opening, and neither still refuses raw
1463
+ SQL on a server, its message naming both). Anyone holding the maintenance key can then do whatever
1464
+ the store's role can: drop or truncate its tables, delete from the log, read every schema it
1465
+ reaches. Only the allowlist check is skipped; the statement filter, a connection of its own for
1466
+ each statement over the extended protocol, the timeouts, caps and `connections`, fenced writes in
1467
+ the owner with their `maintenance.sql` event, the rollback of what changes `meta` or makes a
1468
+ trigger, and the emptied cache all hold. Still refused, before each statement and after a write: a
1469
+ role that is or may become a superuser, a member of `pg_execute_server_program`,
1470
+ `pg_read_server_files` or `pg_write_server_files`, one with `CREATEROLE` before PostgreSQL 16, or
1471
+ one that may run the server's file functions (`pg_read_file`, `lo_import`, `lo_export`…). Cloud
1472
+ SQL's `postgres` user passes from PostgreSQL 16. An orgs host's orgs still don't get the plugin.
1473
+
1474
+ ## 1.0.0-rc.21 — 2026-11-04
1475
+
1476
+ - **Security: a burst of calls no longer drops an executor's connection** (Oxian 0.23.3). About 35
1477
+ concurrent calls on one executor (around 20 holding transactions) filled Oxian's queues, and the
1478
+ connection was lost with every job in flight on it (`executor_lost`): a remote DoS on any app with
1479
+ a public entry point, flagged by a security review. Full queues now hold senders back instead.
1480
+ Long-lived workers also move to a fresh connection before one's streams run out, instead of
1481
+ failing calls with `capacity`; Copilotz treats the move as the same worker (#154).
1482
+ - **MCP: models outside the app call its tools** (the new `mcp` interface; widgets come next). An
1483
+ app declares lines in `resources.mcp.lines.<name>`, each an MCP server at `POST /mcp/<name>`
1484
+ (`/o/<org>/mcp/<name>` under many orgs): the space its chats live in (`in`), the tools it offers
1485
+ (`tools`, by name: only these, never an agent's; each needs its `tool:<name>` View, else it isn't
1486
+ offered, and one whose `offer` says no to a contact isn't either), how each is shown (`title`,
1487
+ `annotations`, ChatGPT's `invoking`/`invoked` lines, 64 characters), who calls (`client`, the
1488
+ steps' sender), `title`, `version`, `instructions`, `handles`, `origins`, `org` and `limits`; and
1489
+ plugin-wide, how it knows a caller's address (`caller`) and calls at once in the process
1490
+ (`atOnce`, 8). Checked at start; it needs the `links` resource's secret.
1491
+ - **The protocol:** Streamable HTTP and JSON-RPC 2.0, written in the plugin, answered as JSON,
1492
+ with no session (GET and DELETE are 405; no `Mcp-Session-Id`). MCP 2026-07-28 (per-request
1493
+ `_meta`, `server/discover`, the `MCP-Protocol-Version`, `Mcp-Method`, `Mcp-Name` and
1494
+ `Mcp-Param-*` headers checked against the body: -32020) and 2025-11-25, 2025-06-18 and
1495
+ 2025-03-26 (`initialize`; batches only for 2025-03-26, 10 messages at most, one after another).
1496
+ Unknown versions are -32022 with the supported ones. Every tool says `noauth`, and all four of
1497
+ MCP's hints. A request with an `Origin` the line doesn't name is 403; input nested past 64
1498
+ levels, or holding a `$blob`, is -32602.
1499
+ - **Conversations:** ChatGPT's `_meta["openai/session"]` (with `openai/subject`) names one; a
1500
+ client that names none gets a `chat` handle (128 random bits, an optional input on every tool,
1501
+ said once, at the end of the first answer), or with `handles: false` is refused. Each is a
1502
+ contact (`via: "mcp"`) in a chat of its own in the line's space, its ids HMACs of the key with
1503
+ the `links` secret: no table. A handle the app never gave is refused; a chat whose contact its
1504
+ people took out, or that was erased (`contact.forget`, `chat.erase`: a tombstone, `mcp_closed`,
1505
+ no personal data), is over for good.
1506
+ - **A call** is `mcp.call`, called by the route as the conversation's contact (an actor only the
1507
+ route makes: `{ kind: "contact", id, mcp, client }`, which the Action's `allow` asks for). It
1508
+ runs the tool through chat's runner, writes a private step from the line's `client` in the chat
1509
+ (in its space as it is now; only input that fit the tool's schema, else a note of what was
1510
+ sent), and answers with the tool's View, read as the contact, never its output as it is. Only a
1511
+ public error (below) says its message. `ctx.callId` is the step's id (the call's,
1512
+ `mcp:<thread>:<hash of the request id>:<hash of tool and input>`, and when it began), the same
1513
+ however often a call cut short runs again; a new call has a new one. A tool that changes things
1514
+ keeps a receipt (`mcp_receipt`, durable, no events, gone after 15 minutes) by what it asks in
1515
+ its conversation (tool and input), whatever the request's id: the same call while it runs waits
1516
+ for that run; asked again, under any id, within two minutes of its end it's answered what it
1517
+ said (kept up to 8,000 characters), beginning with a line saying it wasn't done again (so a
1518
+ second, deliberate purchase isn't taken for done); begun and never done (stopped, an owner
1519
+ restarted, or failed by accident and told to try again), it runs again as the same step, with
1520
+ `retry` and the same `callId`. A public refusal is an answer, and is said again. A read-only
1521
+ tool always runs.
1522
+ - **Limits** (`limits`): calls at once in the runtime (`mcp.atOnce`, 4: each org's own under the
1523
+ orgs host), on the line (4: an executor's connection takes about that many tools that change
1524
+ things at once until Oxian's send backpressure is released), from one caller's address (2; a
1525
+ batch's every call counts) and in one conversation (2), past any of which it's 503 busy, -31000
1526
+ (a batch, an error for each of its requests; a batch with more tool calls than `addressAtOnce`
1527
+ is refused, -32600); how long the route waits for an answer (`timeout`, 20 s: then the model is
1528
+ told it's still working, as long as few calls are, `lateAtOnce` 2 on the line and
1529
+ `addressLateAtOnce` 1 from an address, else it's stopped) and a call may run (`stop`, 60 s: then
1530
+ it's stopped; tools should honour `ctx.signal`); a request's body (64 KiB), calls a minute by
1531
+ conversation (30), by caller's address (60) and on the line (600), new conversations an hour by
1532
+ user (30, ChatGPT's `openai/subject`), by address (20) and on the line (600), and an answer's
1533
+ length (100,000 characters). Only calls taken count, and a new conversation once it's made. The
1534
+ address is believed only as the app's front says it (`caller`: its header, with the front's
1535
+ secret, a request without which is refused, or the proxies' `hops`, which a list header such as
1536
+ `x-forwarded-for` needs); IPv6 is counted by its /64, IPv4 written as IPv6 as IPv4, and an
1537
+ address that can't be read with every other such call, as one. Ranges in `caller.exempt`
1538
+ (OpenAI's) aren't limited by address.
1539
+ - **A failure can be public** (`failure(code, message, { public: true })`, `isPublic`): its message
1540
+ is for any caller, even a model outside the app over MCP, which no other error's words reach. It
1541
+ stays public from job to job. A code alone isn't public: libraries' errors have codes too.
1542
+ - **Chat's tool runner is in its contract** (`runTool`, `toolText`): a tool's input checked, run,
1543
+ and its result read as agents read it, as a turn does; the turn uses them. Input that doesn't fit
1544
+ a tool's schema is a public failure, and the runner says so (`unchecked`). `Tool` gains `title`
1545
+ and `annotations` (`readOnly`, `destructive`, `idempotent`, `openWorld`).
1546
+
1547
+ - **Phone calls: the `voice` plugin** (in `copilotz/plugins/interfaces`), on Twilio's
1548
+ ConversationRelay. The app declares its lines (`resources.voice.lines.<name>`: `in`, `account`,
1549
+ `token`, `origin`, and optionally `agent`, `language`, `tts`, `voice`, `stt`, `texts`, `gap`,
1550
+ `trustCallerId`, `keys`, `limits`, `org`), each a Twilio number open to anyone who calls; their
1551
+ settings are checked at start.
1552
+ - **Twilio's webhook** is `POST /hooks/voice/<line>` (the `voice.hook` route): checked against
1553
+ `X-Twilio-Signature` with the line's auth token. A caller the line's managers blocked isn't
1554
+ taken (`voice.block { thread, days? }`, kept by the number's hash; `voice.unblock { block }`
1555
+ lifts it by its id, whatever is left of the call); then a call is taken within its caller's
1556
+ limits (`callerAtOnce` 1, `callerPerDay` 10; withheld numbers, together, their own
1557
+ `hiddenAtOnce` and `hiddenPerDay`, by default the line's `atOnce` and half its `perDay`), then
1558
+ the line's (`atOnce` 2, `perDay` 50 calls that went on in any 24 hours), or rejected as busy
1559
+ (`<Reject reason="busy"/>`: nothing is spent). A call taken gets TwiML that opens the line's
1560
+ socket (`<Connect><ConversationRelay>`, the line's language, greeting and voice) with a ticket
1561
+ good once, for a minute; `POST /hooks/voice/<line>/over` hears the relay end and hangs up.
1562
+ - **The socket** (`GET /hooks/voice/<line>/relay`, a `serve` route): its signature checked, its
1563
+ ticket used, then Twilio's `setup` must name the call the ticket was for. The caller is a
1564
+ contact (`via: "voice"`) in a chat of their own in the line's space, answered by the line's
1565
+ agent (a line whose agent doesn't answer there fails the call). A number isn't proof of who's
1566
+ calling: calling back goes on in the same contact and chat (until the line's `gap`, 12 hours,
1567
+ and never into a chat with another call on, checked in the write that puts the call live) only
1568
+ when Twilio verified the number (`StirVerstat` `TN-Validation-Passed-A`) or the line sets
1569
+ `trustCallerId`; otherwise, and for withheld numbers (Twilio's placeholders, `+266696687`,
1570
+ `+7378742833` and the like), each call is a new contact.
1571
+ - **What's said:** what the caller says goes to the agent at once, one prompt after the other; a
1572
+ prompt said while the answer to the one before is still being written stops that turn, and the
1573
+ next turn reads both (Twilio already waits for the caller to finish: a quiet window would add to
1574
+ every answer). What the agent writes is said as it writes it, word by word (a step's words
1575
+ before its tools, then its answer), through the `voice_call` View read as the caller, and only
1576
+ of the turns the caller's own words started: a staff member's turn in their chat isn't said.
1577
+ Speaking over it (`interrupt`) cuts what was being said, and the agent is told what was heard
1578
+ (the `voice` context). Keys pressed (with `keys`) come as a tap, `keys:<digits>`.
1579
+ - **What a call may cost** (`limits`): an answer that failed, or took longer than `turn` (25 s,
1580
+ then stopped), says the line's `failed` text, never the error; one past `said` characters
1581
+ (1,200) is cut at a word and stopped; `idle` (90 s) of silence, a call past `call` (600 s) or
1582
+ past `turns` prompts (30) says `bye` and ends it. The goodbye waits 15 seconds at most for
1583
+ what's being said; a call is over by its hard end (`call`, the goodbye and closing), and holds
1584
+ its place among the line's calls until then. A call that ends stops its turn, and any turn of it
1585
+ that starts just after. The agent ends a call too, once its goodbye is said (the `end_call`
1586
+ tool, offered to whoever answers a call while it goes on). Twilio's `end` says why
1587
+ (`handoffData`).
1588
+ - **The phone is a medium:** messages are said through their `message` View (renderer `voice`: the
1589
+ words without Markdown, a link's words, a web address's site), which an app may replace.
1590
+ - Each call is a small record (`voice_call`, no events: when, how long, why it ended, whether the
1591
+ number was verified; the caller's number private), and `voice_phone` keeps each verified
1592
+ caller's contact and chat. Erasing a contact erases its number from both; erasing a chat
1593
+ (`chat.erase`, `contact.forget` with `chats`) erases what the calls kept of it. Calls' records
1594
+ go after the plugin's `keep` days (30, at least 1: `voice.prune`, daily), once they're over: a
1595
+ call going on is never pruned. Agents working for a caller are told it's a phone call, and that
1596
+ the number isn't proof of who they are (the `contact` context).
1597
+ - It needs a host that takes a route's socket (`host.upgrade()`: `serveRoutes`, or `serve`, from
1598
+ `copilotz/web/node`).
1599
+
1600
+ - **Maintenance endpoints** (the new `maintenance` plugin, in `copilotz/plugins/interfaces`): HTTP
1601
+ under `/maintenance/` for an app's operators when they can't reach its database. A key (`key`, or
1602
+ several in `keys` to rotate one; 32 random characters at least, a weak one stops the app),
1603
+ compared in constant time; without one, every request is unauthorized. Requests act as the
1604
+ maintenance actor (`{ kind: "maintenance", by }`), whose Actions run as the system on the record,
1605
+ and each writes a line (`log`) before it runs. An orgs host's orgs don't get it.
1606
+ - `POST /maintenance/sql`: one read-only statement, with `params`, at most `limit` rows and
1607
+ `bytes`, cut off after `timeout`.
1608
+ - `POST /maintenance/collections/<collection>/<op>`: insertOne… deleteMany, find… aggregate,
1609
+ through the owner's write path: schema-checked, recorded, cached, heard by Processors.
1610
+ - `POST /maintenance/queries/<collection>.<name>`: a collection's named query, the body its
1611
+ params, read as the system.
1612
+ - `POST /maintenance/sql/write`: one statement that writes, run by the owner alone among its
1613
+ writes, fenced by its epoch, with a `maintenance.sql` audit event in the same commit; then the
1614
+ owner empties its read cache, runs observed Views again and re-reads its timers. A statement
1615
+ that changes `meta` (the epoch, Processors' positions) is rolled back. An `Idempotency-Key`
1616
+ makes it safe to send again.
1617
+ - `GET /maintenance/blobs/<id>`: a blob's bytes, as a download.
1618
+ - **SQL on the store port, for maintenance only:**
1619
+ `Store.inspect?(sql, params?, { limit, timeout })` (now SQLite's too), a transaction's
1620
+ `execute?(sql, params?)` and `transaction(…, { maintenance })`. Both run exactly one statement: a
1621
+ second, or one that ends the transaction or changes the connection (`COMMIT`, `SET`…), is refused
1622
+ (PostgreSQL ran every statement of an unparameterized `inspect` before; PostgreSQL's line comments
1623
+ end at a CR too). `runtime.maintenance` is the owner's way to them; plugin code has none. The
1624
+ cache gains `clear()`, observers `stale()`.
1625
+ - **PostgreSQL servers:** raw SQL runs only as a role of its own
1626
+ (`postgresStore({ maintenance: { url, connections } })`), which must hold exactly maintenance's
1627
+ grants: no attribute but LOGIN, membership in no role (but Cloud SQL's IAM marker, itself held
1628
+ to the same), no settings of its own, nothing owned (a large object neither), nothing granted
1629
+ outside the store's schema, `CREATE` nowhere, no large object, table or column of another's to
1630
+ read, nothing on the store's tables beyond what it needs, no `SECURITY DEFINER` function to run,
1631
+ no `dblink` or `postgres_fdw`, no trigger on the store's tables: checked before each statement
1632
+ and again after a write, in its transaction, reading only `pg_catalog`'s names. `ALTER ROLE`,
1633
+ `DO` and `LOCK` don't run; a password literal is kept as `PASSWORD '***'`. Each statement on a
1634
+ connection of its own, over the extended protocol, closed after; at most 2 at once, else `busy`.
1635
+ A read stops fetching before a row would pass its bytes. PGlite runs it as its one session, and
1636
+ discards what it left there.
1637
+ - **SQLite:** the store names its tables in `main`, so a temporary object can't stand in for them
1638
+ (a write that leaves one, or a trigger, is rolled back); a read runs in a process of its own
1639
+ (`deno`, `node` or `bun` itself, never a compiled app; an empty environment; on Deno and Node,
1640
+ read access to the database's files alone), killed at its timeout. Else, on the reading
1641
+ connection, a pragma only from those that only read, said once and on each answer
1642
+ (`inline: true`).
1643
+
1644
+ - **Security: a forged blob reference is refused, never loaded.** Large strings are kept as blobs
1645
+ and documents hold `{ $blob, size, type }` in their place; the owner loaded any object with a
1646
+ string `$blob` on every read. So an Action that stores what it's given (a tool's input, a
1647
+ webhook's body) could plant one: an id no blob has made every read of that document fail (a chat
1648
+ that can't be read or erased, Processors giving up on its events); another document's hash pulled
1649
+ that content in; and a path or a name read a file (`fileBlobs`) or any object in the bucket
1650
+ (`gcsBlobs` without a prefix).
1651
+ - What plugin code writes (documents, updates, upserts' filters, edges, events, records, timers'
1652
+ inputs, Action results) and what an Action is called with may hold no `$blob` key: `invalid`.
1653
+ The owner checks it as it walks what it offloads, so it costs no extra pass.
1654
+ - No part of an update's field path may start with `$` (as MongoDB refuses) or be `__proto__`
1655
+ (`invalid`): `{ $set: { "bio.$blob": … } }` made a reference out of plain strings, and on Node
1656
+ and Bun `{ $set: { "__proto__.x": … } }` set `x` on every object's prototype (Deno has no
1657
+ `__proto__`). `constructor` and `prototype` are fields like any other: paths read and make a
1658
+ document's own fields only, so a filter on `constructor` no longer finds `Object` in every
1659
+ document.
1660
+ - A path ends at a blob reference as it does at a string, so a large string is treated like a
1661
+ small one (`$set: { "text.note": 1 }` replaced the reference's insides, losing the text), and at
1662
+ any other object with a `$blob` key, so no update turns a planted one into a reference.
1663
+ - An aggregate's `$group` can't name a field `$…` either: `_id: { $blob: …, size, type }` built a
1664
+ reference from strings, which a browser's own read then loaded.
1665
+ - The API's event stream sends a call's result whole; one over 16 KiB went as its reference.
1666
+ Published events (`runtime.subscribe`) have `full()`: the event with its large values.
1667
+ - Only an exact reference loads a blob: the keys `$blob`, `size` and `type`, a `sha256-<64 hex>`
1668
+ id, a numeric size and a string type. Any other object is data.
1669
+ - Every blob store (memory, SQLite, PostgreSQL, `fileBlobs`, `httpBlobs`, `gcsBlobs`) takes only a
1670
+ blob's id (`checkBlobId`, exported for your own `Blobs`).
1671
+ - Fixed on the way: a timer's input over 16 KiB reached its Action as a reference; it comes whole.
1672
+ An occurrence of one that a deploy to this version cuts short fails once when it resumes
1673
+ (`id_conflict`: it started with the reference as its input); the timer's next ones run.
1674
+ - A store may already hold planted references: an exact one still loads (its blob gone, reads
1675
+ fail), and any other, carried on, is now refused. #155 has read-only queries (PostgreSQL,
1676
+ SQLite) that find them; clean every one, `sys.timers` first.
1677
+
1678
+ - **Contacts: people outside the org who talk to its agents** (the new `contacts` plugin, part of
1679
+ `access`). A WhatsApp customer is a contact, its own kind of actor (`{ kind: "contact", id }`),
1680
+ never a person: every `allow: people` Action and query stays shut to it, and nothing that asks for
1681
+ a person (`personOf`) finds one. The runtime's `principalOf` says whom work is for, a person or a
1682
+ contact (it moved there from chat), and `peopleOrContacts` is what an Action opened to contacts
1683
+ allows: today only `chat.send`, whose message is then from `contact:<id>`.
1684
+ - A contact's chat is shared with it on its own (a membership `on` the thread, made by
1685
+ `contact.chat`): it reaches that chat, what's said and filed there, and its own record, nothing
1686
+ else. The space's people reach it as any chat there; the agent working for the contact reaches
1687
+ exactly that chat. Three generic completions in spaces make it so, and help people too (a person
1688
+ can now share one chat): a shared collection's documents can be part of another's (`part`: a
1689
+ message's `thread`), reached with it; an agent working for someone reaches a document one of
1690
+ them reaches on its own in a space the other reaches; and `present(ctx, space)` says whether
1691
+ someone reaches a space or a document in it, so `space.roster` tells a contact in its chat who
1692
+ answers (agents only).
1693
+ - A contact is let into documents only, never a whole space (`member.set`, a request granted), and
1694
+ never manages one. `request_access` isn't offered to agents working for a contact, nor memory: a
1695
+ customer's chat keeps to itself.
1696
+ - `contact.start` (trusted code, idempotent by id) and `contact.chat`; `contactOf(actor)` says
1697
+ whose work an event's actor's is (the contact's id, through the agent working for them too);
1698
+ agents are told whom they talk with (the `contact` context) and see them by name: the `names`
1699
+ resource is now a map of sources
1700
+ (`{ people: { collection: "profile" }, contact: { collection: "contact", prefix:
1701
+ "contact:" } }`),
1702
+ replacing `{ collection }`. On the web, add `contactsWeb` to show contacts by name.
1703
+ - **A WhatsApp number can be a customer line.** Its space's managers open it to anyone
1704
+ (`whatsapp.set { number, open, agent, gap }`). A stranger who writes is then a contact, in a chat
1705
+ of their own in the number's space, answered by the number's agent (or who answers new chats
1706
+ there); a chat quiet for `gap` hours (12 by default) is over, and their next message starts a new
1707
+ one. Their text always goes to the agent (commands stay linked people's); a code from the app
1708
+ still links a phone, and linked phones keep working as their person. The `whatsapp` plugin now
1709
+ requires `contacts`.
1710
+ - **WhatsApp is a medium.** A View for it (renderer `whatsapp`) returns parts, each one WhatsApp
1711
+ message, built with the toolkit in WhatsApp's contract (`text`, `buttons`, `list`, `carousel`,
1712
+ `image`, `document`, and `clip` for titles), which checks Meta's limits and throws `invalid`
1713
+ instead of cutting anything short. A message goes out as its `message` View there (the plugin's:
1714
+ its text as WhatsApp formats it; an app's replaces it).
1715
+ - **Additions:** chat declares the `additions` resource kind (`{ order?, agents? }`, each an
1716
+ `addition:<name>` View in the medium, given `{ thread, answer }`, returning `Addition`s:
1717
+ `{ key, parts, fallback?, note? }`). After an agent's final answer that didn't fail
1718
+ (`isAnswer`), each goes once per chat per key, recorded in chat's new `shown` ledger through
1719
+ `chat.shown` (trusted code, unrecorded); its `note` is told to the model after that answer
1720
+ (`[then shown: …]`).
1721
+ - **One message, not two:** an answer's last text goes as the first addition's body (or caption)
1722
+ when there's room, as Meta charges per message. A part Meta refuses (a 400 that isn't the token
1723
+ or the 24-hour window) sends the addition's fallback instead, with the answer joined to it;
1724
+ without one, it's logged. A retried delivery sends only what didn't go (`whatsapp_sent` now
1725
+ keeps each part by id, with its addition's `key` and `thread`).
1726
+ - **Taps:** a button's, a list row's, a carousel card's or a template's reply comes as its title
1727
+ with `tap: { id, title, key }` (`chat.send` takes `tap`; messages keep it), answering the
1728
+ message it was on; agents read `Carla: PIX [tapped: pay:pix]`. Typing the title is just text. A
1729
+ tap is a choice, not a permission: anyone can send any id, so a tool acting on one checks it
1730
+ against what was shown there. A quote or a tap answers only what went out in its own chat.
1731
+ - What a message and its additions show is read as whom they go to, never with the reach of
1732
+ whoever's work the answer was.
1733
+ - **"Typing…" while agents work:** each step an agent takes in a WhatsApp chat shows it again once
1734
+ WhatsApp may have hidden it (after 20 s, for up to five minutes); nothing says "please wait".
1735
+ - **Media:** a part's picture or file is a public https link (as given), one of the app's routes
1736
+ (`{ route, params }`: a link signed for a day with its params, which the route checks with
1737
+ `verifyLink`), or a chat's file (`{ file }`: a signed link to `/files/<id>`, or, without the
1738
+ app's `links`, uploaded to Meta and sent by its id). A carousel's pictures must be links: a file
1739
+ with nowhere to link it sends the fallback. A message's files go as images (jpeg, png up to 5
1740
+ MB) or documents, a short text as the first one's caption.
1741
+ - **WhatsApp lines for an app, as it uses them**:
1742
+ - **A line the app declares** in its settings (`resources.whatsapp.lines.<name>`: the space,
1743
+ Meta's number id, token and app secret, its own verify token, a webhook path it routes to
1744
+ `whatsapp.hook`, its agent, gap, rate, quiet window and language): open to anyone, kept as the
1745
+ settings say at every use, with no person connecting or opening it; people can't change it
1746
+ (`whatsapp.set`, `whatsapp.credentials` and `whatsapp.disconnect` refuse), and the web tab
1747
+ leaves it alone. `whatsapp.set` stays for numbers people connect.
1748
+ - **Spaces the app declares** (the spaces plugin's `spaces` resource, by id: `{ name, agents }`):
1749
+ the app's own, owned by no person, made and kept by the system when something needs them
1750
+ (`space.keep`, trusted code; a declared line keeps the space it's `in`). Its agents are editors
1751
+ there, the first answering its new chats; people neither take them out, nor change their role,
1752
+ nor rename the space. Otherwise it's a space like any other.
1753
+ - **The reply is the body:** after an answer, an addition's own words (a question its buttons ask)
1754
+ are what it says without one; with the answer, the answer is its whole body. A fallback keeps
1755
+ its words after the answer.
1756
+ - **What Meta took but couldn't deliver** (a failed status on the webhook, such as a picture it
1757
+ couldn't fetch: `whatsapp.undelivered`) sends that addition's fallback, once, with the answer's
1758
+ text when it went in the same message.
1759
+ - **A burst gets one answer:** a customer's messages wait for the line's quiet window (`quiet`, 4
1760
+ s by default, up to 30) before the agent answers, all of them in one turn and one reply
1761
+ (`chat.send`'s new `quiet`: a durable timer each message sets again, `chat.quiet`, so a restart
1762
+ in the window still answers once).
1763
+ - **A failed turn** tells a customer only that, in their line's language, never its error.
1764
+ - Each sender's quiet window is their own (`quiet:<thread>:<sender>:<agent>`): a staff member's
1765
+ message never takes a customer's place, nor the reverse. Erasing a chat ends its windows, and a
1766
+ window whose message is gone (or no longer theirs to read) starts no turn.
1767
+ - A declared line is one org's with the orgs host: it names the org (`org`), and every other org's
1768
+ runtime has nothing of it; a line naming none is a single-org app's.
1769
+ - What Meta couldn't deliver is rendered again as its addressee, as any reply is.
1770
+ - **Signed links** (the runtime's `signLink` and `verifyLink`, with the app's `links` resource:
1771
+ `{ origin, secret }`, a secret of at least 32 bytes, checked at start): the app's origin, a path,
1772
+ its params and an expiry (an hour unless said), HMAC-signed, with a line break between origin and
1773
+ path, so a link for one app or org never opens another (under `hosts/orgs`, give each org its own
1774
+ origin). The web host checks the secret as it starts serving. A chat's file is linked or uploaded
1775
+ only for someone who may read it. The web host serves a file at a signed `/files/<id>` link
1776
+ without a session, as the system; expired or altered, a 404.
1777
+ - **Chat in spaces declares its own `shared` entries** (`thread`, `message` with labels, `file`,
1778
+ `live` and `shown`, each a part of its thread). `chat.open` opens an empty chat in a space;
1779
+ `chat.say { id, thread, from, text, to? }` has an agent say a fixed message in a chat without a
1780
+ turn (trusted code only; the same `id` is said once), sent out like any of its answers.
1781
+ - **What a contact's chat shows stays theirs to see** (from a security review):
1782
+ - A document others are parts of (a chat) labels as itself, and so do its parts: a write into a
1783
+ chat shared with someone outside its space (a contact) that drew on anything else, even the same
1784
+ space, carries that space as its source (staff read it; the contact doesn't), or an agent
1785
+ writing it is refused (`needs_share`). WhatsApp sends only what its addressee may read.
1786
+ - Agents are told who else is in a chat from outside the org (the `where` context), from a chat's
1787
+ members on its own, which its space's people now read by asking for that chat.
1788
+ - A part of a shared document, and a document shared on its own, are reached only where it lives:
1789
+ nothing written as one lands in another space. `may`, `must` and `present` never take a document
1790
+ shared on its own for a space (`may(ctx, verb, id, on)` asks about the document).
1791
+ - A contact's message goes to whom its chat is with (or the agent that wrote what it replies to):
1792
+ never to agents it names. Anyone's `replyTo` is kept only for a message of the same chat that
1793
+ they read.
1794
+ - A tool whose `offer` is a function decides for agents that name it too; `request_access` refuses
1795
+ for a contact; computers aren't woken (or billed) for work that's no person's; memory declares
1796
+ its own `shared` entry; the identity guard keeps people's records to people.
1797
+ - `chat.say`'s message is `<thread>:say:<id>`, said only by an agent answering in that chat.
1798
+ - Work handed to another space from a chat shared with a contact comes back labelled with that
1799
+ space (`sources`): the contact doesn't read it (spaces' contract: `sharedWith`).
1800
+ - The `shared` resource's entries are its own keys: a collection named like what objects inherit
1801
+ (`constructor`) is none.
1802
+ - **Erasure:** `contact.forget { contact, chats? }` (managers of its space) ends a contact's access
1803
+ at once, deletes its record (`contact.deleted`: WhatsApp erases its phone, but a block on it
1804
+ stays, by the phone's hash) and, with `chats`, its chats, each for someone who manages that chat's
1805
+ space (chat's new `chat.erase`, trusted code only: messages, files, waits, steps in flight; the
1806
+ history plugin erases its summaries on `thread.deleted`). The event log keeps what happened (what
1807
+ WhatsApp delivered, each change with its document) until retention removes it; memories learned in
1808
+ staff's chats, and chats a hand-over opened elsewhere, aren't erased.
1809
+ - **An open line, kept in hand:** `whatsapp.block { thread, blocked }` (managers) blocks the phone
1810
+ behind a chat: what it sends goes nowhere, unanswered. A customer sending more than the number's
1811
+ `rate` a minute (20) goes unanswered. One taken out of their chat is heard again once it's been
1812
+ quiet for the gap. Customers are told what can't go on in the number's `language` (`en`, `pt`),
1813
+ never in an error's own words.
1814
+ - **Fixed:** `message.questions`, and the terminal's `shell.mine`, `shell.set` and `shell.print`,
1815
+ let anyone whose id matched in; they're a person's own now.
1816
+
1817
+ - **Private fields for recorded Actions.** `private: ["buyer", "passengers"]` on an Action (dot
1818
+ paths, as a collection's): its calls are recorded without them, in `action.started`'s input and
1819
+ `action.completed`'s result alike, so the personal data a booking's buyer gives (names, CPFs,
1820
+ emails) never lands in the log, while the calls are still recorded, retried and deduplicated.
1821
+ - The call's `inputHash`, and so a nested call's id, still covers the whole input: a retry with
1822
+ the same input answers from the log, and a changed one is a new call (under an outside call id,
1823
+ `id_conflict`).
1824
+ - A result that had private fields is kept whole in `sys.results` (a document by call id, written
1825
+ in the completion's commit, no events), and `action.completed` says `private: true`: a retry
1826
+ answers with all of it, as it would without them.
1827
+
1828
+ - **A host without the web app: `serveRoutes`** (`copilotz/web/node`), for an app people use on
1829
+ WhatsApp or on the phone. Given the runtime, it serves the app's routes alone (webhooks),
1830
+ `/health` (unless a route takes it), and 404 for anything else: no page, no code, no sign-in; a
1831
+ route's Action is called as a visitor. Its `close({ drain })` stops listening, letting running
1832
+ requests finish, then closes the runtime with those options. A runtime that declares the `socket`
1833
+ transport still takes its sockets at `/oxian`. `routeHost(runtime)` (`copilotz/web/server`) is the
1834
+ same as a fetch handler. On Node, Deno and Bun (`examples/web-node/routes.ts`).
1835
+ - **A route can take a WebSocket** (a voice call's relay): a `serve` route calls `host.upgrade()`,
1836
+ and answers with the response it gives; its `socket` is a browser's `WebSocket` as far as
1837
+ `onmessage`, `send` and `close` go. It can refuse first, before any handshake. `serveRoutes` and
1838
+ the web host's `serve` take it, through Oxian's adapter (route sockets, Oxian 0.23).
1839
+
1840
+ - **A tool call runs once, even when its turn is tried again.** A step that failed after its tools
1841
+ ran (a tool's `llm` View throwing, a commit failing) was run again whole: its model asked again,
1842
+ its tools run again, with whatever input the model now chose, and the model never saw the first
1843
+ run. Now a step's calls are written before any of them runs (chat's new `intent` collection, one
1844
+ document per running turn, no events), and what each returns as soon as it does. A retried turn
1845
+ goes on with those calls without asking its model: a call that returned answers from its record,
1846
+ and one cut short (its executor lost, the runtime closed) runs again as itself.
1847
+ - Tools get `ctx.callId`, the same however many times the call runs (`<turn>:<step>:<n>`): the
1848
+ idempotency key for what they do outside. `ctx.retry` is now true only for a call that may have
1849
+ run before. The recorded Actions a tool calls answer from the log when it runs again.
1850
+ - A turn that ends without its step (failed for good, or stopped mid-tool) keeps the step, with
1851
+ what each call returned, or that it never did ("Interrupted before it returned: it may or may
1852
+ not have taken effect…"); a stopped answer no longer repeats that step's text.
1853
+ - A tool step costs one more commit (its calls, before they run) and one per tool call (what it
1854
+ returned). A step that only sends messages costs nothing more: they commit with it.
1855
+ - **Closing drops no turn.** `runtime.close()` returned from a delivery it cut short as if it were
1856
+ done, then saved its Processor's cursor past it, so a turn running at a deploy never answered. Now
1857
+ closing starts no more deliveries or timer occurrences, gives the running ones `drain` ms to
1858
+ finish (`close({ drain })`, 5 s by default), and keeps each cursor before an event it didn't
1859
+ finish: the next owner delivers it again, with `retry`, and with the above it doesn't repeat its
1860
+ tools. Workers are told they're gone after the drain, so running work can still use them. The orgs
1861
+ host's `close({ drain })` passes it on to every org's runtime.
1862
+
1863
+ - **Fixed: messages in a row ended an agent's prompt with its own answer.** A person writing several
1864
+ messages a few seconds apart starts a turn for each; one that ran after the agent had answered
1865
+ (while it wrote, or with the next turn) was sent a conversation ending with that answer, which
1866
+ Anthropic's newer models refuse ("assistant message prefill", HTTP 400), so it failed. Now an
1867
+ answer keeps how far its turn had read its thread (`knew`, the `at` of the newest message there);
1868
+ the prompt reads what others said after that, while it wrote, after the answer; and the turn of a
1869
+ person's message that an answer to them had already read ends without a model call. Adapters never
1870
+ send a conversation ending with the model's own message: a user turn ("Continue.") follows it, for
1871
+ every provider alike.
1872
+ - **Fixed: a failed turn's answer said what its provider said.** "booking failed: Anthropic 400:
1873
+ {…}" was written in the chat, where everyone there read it (and a WhatsApp customer got it). It
1874
+ now says "booking failed: something went wrong, so it couldn't answer. Try again in a moment."
1875
+ What went wrong stays in the `processor.failed` event; a missing key still says who can add one.
1876
+ - **Fixed: MiniMax's usage counted no input.** Anthropic's adapter read input and cache counts only
1877
+ from `message_start`; MiniMax (on Anthropic's protocol) says them in `message_delta`, so its calls
1878
+ were recorded with 0 input tokens. It now reads every count from both, the greatest of each (they
1879
+ are totals so far), so Anthropic's, said in both, count once.
1880
+ - **OpenAI keeps nothing: `store: false`.** The Responses API stores every response (30 days) unless
1881
+ told not to, and Copilotz never read them back: a model's reasoning already comes back encrypted
1882
+ and goes back with each call. A server that refuses `store` is asked again without it, from then
1883
+ on, as one refusing `include` is. A model's `options` can still set it.
1884
+
1885
+ - **Fixed: a collection's private fields reached the log on PostgreSQL.** Writes that go as the
1886
+ store's single command (most of them) recorded `.created`, `.updated` and `.deleted` with the
1887
+ whole document, so `private` fields (a computer's `pending` secret, unsealed account tokens) were
1888
+ in the log there; memory and SQLite left them out. The command now records documents without them
1889
+ too. Events already written still hold them.
1890
+
1891
+ ## 1.0.0-rc.20 — 2026-11-04
1892
+
1893
+ - **A model thinking past two minutes isn't a dropped call.** A call counted as dropped once its
1894
+ adapter yielded nothing for `silence` (2 minutes), and was retried or handed to the next model. A
1895
+ reasoning model yields nothing while it thinks, though its provider's stream goes on (GPT-6 Luna
1896
+ at xhigh on a hard problem: 108 s before its first word), so its thinking was thrown away past two
1897
+ minutes while the page showed the agent thinking. Adapters now say a stream is alive (`thinking`
1898
+ chunks, at most about once a second, for every provider); `generate` passes them on without
1899
+ counting them as written, so a model that thinks and then truly stalls still hands over.
1900
+ `complete` no longer reads a chunk it doesn't know as usage.
1901
+ - **`terminal`: a running command is seen again by its `commandId` alone.** rc.19 said so, but sent
1902
+ the computer no input with it, and every look at a slow command answered "stdin is required". A
1903
+ `commandId` beside a blank `command` is a look too; beside a real one, the refusal says how to
1904
+ look, type into it or stop it.
1905
+ - **An agent's OK shows once its own turn is over.** With agents answering in parallel, the
1906
+ computer's approval cards waited for every agent's turn to end, so one that asked and finished
1907
+ waited on a card that didn't show. Chat's `conversation` Views get `busy` (the agents whose turns
1908
+ run, each held 600 ms after its last step) beside `working`.
1909
+ - **People show by name on the web.** The browser loads only front ends, and the `names` resource
1910
+ was declared only by the spaces plugin: everyone signed in with a sign-in id (`google:…`) showed
1911
+ as "someone", in Members, a chat's people and messages, memories, computers and routines. The
1912
+ spaces front end declares it too.
1913
+ - **People's pictures beside their names**, in a space's Members, a chat's "In this chat" and a
1914
+ person's messages: a `profile.pictures` query (`{ ids }`), and `picturesIn` for Views.
1915
+ - **`openai-compatible` sends a model's thinking back.** `reasoning_content` (DeepSeek, Moonshot,
1916
+ Qwen, vLLM) is kept as the answer's state and goes back with it, as Anthropic's, Gemini's and
1917
+ OpenAI's already did; DeepSeek asks for it once tools are given.
1918
+ - **OpenAPI tools** (`openapi({ name, spec })`, in `copilotz/plugins/agents`): an API's operations
1919
+ as recorded Actions (`<name>.<operationId>`, not called again when a turn is retried) and agent
1920
+ tools (`<name>_<operationId>`); settings per deployment in `resources.openapi.<name>` (base URL,
1921
+ headers, query, timeouts, size limits, file fields).
1922
+ - **History by age:** an agent's `history: { maxAge }` (ms) leaves older messages out of its prompt
1923
+ (they stay in the chat), counted back from the newest message it sees, its start on a grid of a
1924
+ tenth of `maxAge` so the prompt cache holds between steps.
1925
+ - **Blobs in Google Cloud Storage:** `gcsBlobs({ bucket, prefix? })` (`copilotz/blobs/gcs`), signed
1926
+ in as the process's service account on Cloud Run or Compute Engine.
1927
+
1928
+ ## 1.0.0-rc.19 — 2026-11-03
1929
+
1930
+ - **`terminal` takes the command in `command`.** It took it in `stdin`, while `start_job` takes
1931
+ `command`, and the tool answered any other field with an empty success: a model that sent
1932
+ `command` (gpt-6-luna in 21 of 22 calls in our tests, Claude Haiku 5.5 in 7 of 35) was told it ran
1933
+ when nothing had. Now `command` runs a command; `commandId` with `stdin` answers a running one,
1934
+ and with `operation: "interrupt"` stops it. A call it can't read (another field, both a command
1935
+ and a commandId, an empty command, `stdin` without a commandId) runs nothing and says what to give
1936
+ instead. The computer program is unchanged. A chat shows the command from `command`, and from
1937
+ `stdin` on calls made before.
1938
+
1939
+ ## 1.0.0-rc.18 — 2026-11-03
1940
+
1941
+ - **Model tiers for the app's agents** (the new `tiers` plugin, in `copilotz/plugins/agents`). An
1942
+ app declares its tiers (`tiers` resource: a title, what it's good for, and a model for each of its
1943
+ agents, as an agent's `model` takes one). Which one an agent thinks with, first that applies: a
1944
+ model picked for it in the space, the space's tier, a model picked for it by the org, the org's
1945
+ tier, the tier the org's plan names (`planTier`), else its own model.
1946
+ - An org's owners and admins choose for the org, a space's managers for the space (`tiers.choose`,
1947
+ `tiers.pick`); everyone who reaches them sees it (`modelChoice.offered`, `modelChoice.agent`).
1948
+ Choices keep the tier's name, so retuning a tier moves everyone on it.
1949
+ - A pick keeps the tier's list behind it as fallback, and carries the `maxTokens` of the entry it
1950
+ replaces, and its `effort` when the picked model takes it (`models.efforts`, from the catalog).
1951
+ - Chat asks through a new `agentModel` resource, once per run, for the app's agents only; agents
1952
+ people make keep their own model. A turn's usage now says its `space`.
1953
+ - On the web (`tiersWeb`): "Agents' models" in org settings (the tiers with a typical reply's
1954
+ price, choosing one with Undo, a model per agent), and on a space's Members tab its tier and
1955
+ each app agent's model with where it comes from. Team's model picker is a View (`model.pick`)
1956
+ other plugins show.
1957
+ - **Plans say whom they're for and which tier they give.** `PlanTerms.for` (`"personal"` or
1958
+ `"team"`) is enforced on every move to a plan (checkout, staff, a provider's webhook);
1959
+ `PlanTerms.models` names the plan's tier (`billing.tier`). The Billing page offers an org only the
1960
+ plans for its kind that its seller can sell (`billing.sellable`), says how much of this period's
1961
+ plan credits is left and when they lapse, and speaks of seats only to teams.
1962
+ - **The Usage page, rebuilt around money.** One line: spent this billing month, against the budget,
1963
+ what's left and how long it lasts at this pace. One "By" switch (kind, space, person, agent,
1964
+ model) drives a stacked daily chart and a ranked list; a row filters the page. Activity shows
1965
+ turns, computer sessions, app days and conversation upkeep instead of ledger records; staff see
1966
+ cost and margin in place.
1967
+ - `usage.calls` is gone: `usage.activity` replaces it. `usage.org` groups and filters by
1968
+ `category` (agents, computers, apps; `usage.categories`) and by `tags.space`, and names what it
1969
+ groups by as the caller reads them, through a new `usageNames` resource kind each owning plugin
1970
+ contributes (spaces, conversations, computers, apps).
1971
+ - Cloud computers' records say their `space` and, for VM time, their `session`; summaries, memory
1972
+ notes and their embeddings say their conversation's `thread` and `space`.
1973
+ - Rollups keep `tags.space`. A closed day remembers its shape; days closed with an older one are
1974
+ read from records until `usage.close` closes them again (the next nightly close, or by hand).
1975
+ - **An app's own instructions are sent as instructions.** A `context` entry with
1976
+ `instructions: true` (`system` only) goes right after the agent's instructions, without the
1977
+ `<context>` tag that marks other contexts as information, not instructions.
1978
+
1979
+ ## 1.0.0-rc.17 — 2026-11-03
1980
+
1981
+ - **A model's state goes back with its answers.** What a model returns to be sent back (Anthropic's
1982
+ signed thinking, Gemini's thought signatures) was kept on tool steps but dropped on the final
1983
+ answer, so the next turn started without it. Answers keep it now, and agents are sent it on
1984
+ text-only messages too. A message's `state` is private, like `told`: people's reads and events go
1985
+ without it, and an answer handed back to another space doesn't carry it.
1986
+ - **OpenAI's reasoning goes back to it.** The Responses adapter asks for a reasoning model's
1987
+ reasoning, encrypted (`include: ["reasoning.encrypted_content"]`), keeps it as its answer's state,
1988
+ in its place among the answer's text and calls, without ids, and sends it back. Between tool steps
1989
+ the model carries on instead of thinking again: on gpt-6.1-sol, a two-turn tool task wrote 42%
1990
+ fewer output tokens. A server that refuses `include` is asked again without it, and not asked
1991
+ again. Sent back, past reasoning stays in later prompts (a probe: 616 input tokens with it, 48
1992
+ without), so a state now says about what it adds (`LlmState.tokens`), and history counts it.
1993
+ - **History counts what a prompt really carries.** The history plugin's tail is measured in
1994
+ estimated tokens of what an agent is sent for each message: its text, its model's state, text
1995
+ files' content, transcripts, images (1,600 each) and PDFs (2,000 a page), and agents' tool steps,
1996
+ which leave the tail without a line. `tail` is in tokens now (was bytes), and its default stays
1997
+ `[16_000, 48_000]`, so a text-only conversation keeps about four times more whole.
1998
+ - Until the tail first cuts, every message is sent: no 50-message cut before anything is
1999
+ summarized. That holds for threads whose outline began with them; older ones get chat's window
2000
+ until their first cut.
2001
+ - The four newest shared messages always stay whole, so a big file stays while it's talked about.
2002
+ - A message's line names its files, and `zoom(id, 1)` gives the message as the agent is sent it,
2003
+ text files' content included.
2004
+ - After a cut, state from before it (thinking bound to how the conversation began) isn't sent
2005
+ again; and when a provider refuses a model's own state as stale anyway, the call is tried once
2006
+ more without any.
2007
+ - Outlines no longer log events.
2008
+ - **Without the history plugin,** an agent's window holds 50 to 100 messages and drops 50 at a time
2009
+ (was the latest 50, one off every turn), so the prompt cache holds between drops. `lineage`
2010
+ (exported) takes `batched`; its `since: ""` now means every message, and its db needs
2011
+ `countDocuments`.
2012
+ - **Fixed:** lifting a usage waiver gave back nothing for a use recorded in the very millisecond it
2013
+ was lifted (a flaky billing test showed it).
2014
+
2015
+ ## 1.0.0-rc.16 — 2026-11-02
2016
+
2017
+ - **Fixed:** staff by email weren't staff anywhere but going into an org. `org.mine` asked without
2018
+ their email, so anyone signed in with Google, whose id isn't their email, had no console and no
2019
+ "Enter as staff". It takes `email` now, and the orgs host passes the one they verified.
2020
+
2021
+ ## 1.0.0-rc.15 — 2026-11-02
2022
+
2023
+ - **Enter as staff, in your own org too.** Staff who belong to an org go in as one of its people, as
2024
+ before, but can now ask to go in as staff: from the console, or the org switcher. They keep their
2025
+ role, get the staff tools, and "Continue as Owner" takes them back. `POST /orgs/enter` takes
2026
+ `staff: true`, `org.enter` takes `staff`, and `GET /orgs` says `asStaff`, which `asStaff()` now
2027
+ reads instead of guessing from membership.
2028
+
2029
+ ## 1.0.0-rc.14 — 2026-11-02
2030
+
2031
+ - **Credits** (`plugins/billing/credits`): what an org can spend. Plans, credits and payments are
2032
+ its own rows, the balance is walked from them and the ledger, and one check stops model calls,
2033
+ computers and builds at the limit, in plain words. Staff set plans, give credits, waive usage or
2034
+ seats, and record payments; gift codes wait in the directory.
2035
+ - **Stripe** (`plugins/billing/stripe`): Checkout, the customer portal and signed webhooks, for one
2036
+ or more accounts. A subscription's credits come with its paid invoice.
2037
+ - **Prices:** a use on an org's own key costs nothing; a plan can name a price list; `usage.quotes`;
2038
+ the model picker shows the org's real price.
2039
+ - **Removed:** the cloud plugin's `create` and `budgetUsd` settings. Anyone in an org but its guests
2040
+ makes a computer; what the org can spend keeps the cost.
2041
+ - **Fixed:** model use listeners are awaited, so a late record isn't lost; a VM's seconds stop at
2042
+ its lease, so an org closed for days isn't charged for a VM long gone.
2043
+ - `composerNotes`, a note above the composer from another front end.
2044
+
2045
+ ## 1.0.0-rc.13 — 2026-11-01
2046
+
2047
+ - **Choose an agent's model from the catalog, with your own key.** The agent editor searches every
2048
+ provider and model in the models.dev catalog an agent can work with (`models.offered`): those with
2049
+ a protocol we speak and an address of their own. An org's owners and admins add a key for a
2050
+ provider right there (`modelKey.set`): it's sealed, shows only its end, and its agents' calls to
2051
+ that provider use it, over the app's. Those uses are tagged `paid: "own-key"`. The catalog now
2052
+ keeps names, release dates, and which models can't call tools or answer in text.
2053
+ - **Secrets stay out of the log.** `env.set` and `apps.configure` recorded their input, so a space's
2054
+ or an app's secret was kept in plain text in its `action.started` event, sealed field or not. Both
2055
+ are unrecorded now. Secrets set before this remain in events already written: rotate them.
2056
+ - **Agents manage cloud computers.** `list_computers`, `create_computer` and `manage_computer` (add,
2057
+ remove, rename, default, destroy) work in the conversation's space, as the person the agent works
2058
+ for, through the same Actions and rules a person has. Nothing asks first except destroying, which
2059
+ loses the disk: like publishing, it's asked every time and only "once" allows it. A person's own
2060
+ machine isn't an agent's to manage. An agent in a space with no computer is told it can make one.
2061
+ - **A query an Action runs knows who asks.** Named queries called from an Action or a transaction
2062
+ lost the actor for what they call themselves, so a query asking another Action could fail, or
2063
+ answer as though nobody asked.
2064
+ - **A read's answer no longer overwrites something newer.** The owner answers a batch of reads once
2065
+ its slowest is ready, so a change could be pushed before the answer that didn't include it. The
2066
+ client then showed the older answer until the read next changed: on a page's first load (the push
2067
+ was dropped) and after a reconnect (the push was overwritten). What's pushed while a read is asked
2068
+ for now wins over its answer, and a connection that's been replaced is no longer listened to.
2069
+
2070
+ ## 1.0.0-rc.12 — 2026-11-01
2071
+
2072
+ - **An agent can hand work to itself in another space.** "Itself" now means the same agent in the
2073
+ same chat: North in Personal and North in Project management are two pieces of work. Whoever a
2074
+ space says answers takes what's handed there, even the agent that sent it, instead of being
2075
+ skipped for someone else, so a space where only that agent answers can receive work too. It reads
2076
+ what it handed over, and the answer back, as input (`You (via delegated "Solo"): …`), not as
2077
+ something it said.
2078
+ - **Delegated messages name the other space:** "Delegated: Personal" there, "Delegated: Project
2079
+ management" back, with an icon of their own.
2080
+
2081
+ ## 1.0.0-rc.11 — 2026-10-31
2082
+
2083
+ - **A routine can run with nobody watching.** What its agent needs a yes for can now be allowed for
2084
+ that routine alone: "Allow for this routine" on the card, or "What it can do without asking" on
2085
+ its page (run commands, start jobs, change files, per computer), ahead of its first run. Allowing
2086
+ it answers every run already stopped on the same thing. What a run waits on shows on the routine's
2087
+ page, with the way to its chat. In the terminal: `/approve <n> routine`.
2088
+ - **That yes covers only that routine's runs, as it was.** A run's work carries the routine as its
2089
+ `origin`, on the actor (`originOf`, chat's contract), which only code can set: a person's own
2090
+ message to the same agent still asks, even one claiming `via` a routine. Changing what a routine
2091
+ does (what it asks, whom, as whom) makes a new version (`routine.rev`), which the yes doesn't
2092
+ cover: its page says so and offers "Allow again". Name and schedule don't count. Where a
2093
+ computer's owner keeps the answers, only they can say it (`computer.allowOrigin`).
2094
+ - **Plugins can add to a routine's page:** the `routinePanels` resource (`{ view, order? }`), a View
2095
+ given the routine.
2096
+ - **Authorization is one model.** `personOf`, `forbidden`, `invalid`, `failure`, `people` and
2097
+ `inPerson` come from the runtime; `may`, `must` and `mustOwnOr` from the spaces contract,
2098
+ replacing seven `personOf` copies, about 25 hand-written checks and about 30 local error helpers.
2099
+ `reachOf` is the only answer to what someone may do, and respects every limit on them.
2100
+ - **Fixed: taking over a space.** A thread named after a space could be used to become its manager.
2101
+ A document's memberships now live under its own name (`note:n1`), and only shared collections can
2102
+ be named.
2103
+ - **Fixed: keys left their space.** Actions that checked reach, then wrote as the system, ignored a
2104
+ key's limit. Reach respects it now (`within`, which replaces `at` on a key's actor), and the API's
2105
+ own narrowing rules are gone. Keys can't answer approvals.
2106
+ - **Fixed: agents asked by agents ran as the agent that asked.** A turn is always its own agent, for
2107
+ the person the work is for, including where a computer's owner answered.
2108
+ - **Publishing is asked every time.** Nothing wider than once is offered or honored.
2109
+ - **Approvals can be taken back,** from the Computer tab. What's allowed for a routine comes from
2110
+ the routine (`origins` resource), not from what the caller says.
2111
+ - **Roles are given one way** (`seat`): a granted request can't name a role that doesn't exist or
2112
+ make an agent a manager, and custom roles count everywhere.
2113
+ - **An archived space isn't written in,** which only views enforced before.
2114
+ - **Replacing or rebuilding an app** takes its publisher or a manager. **Where a computer's owner
2115
+ answers,** only they change anything on it directly; others still read it.
2116
+ - **Leaving ends what someone left behind,** however they left: desks, yeses and keys for that
2117
+ space, and out of the org, all of them and their own computers. Cloud computers stay for those who
2118
+ run the org. A preview's cookie asks whether its person is still a member on each request.
2119
+ - **Agents can hand work to other spaces.** `send_message` takes `space`: any space the person can
2120
+ write in, listed in the agent's context with who answers there. A new chat opens there, visible to
2121
+ its members and marked as delegated, for the same person; the answer comes back to the chat it
2122
+ came from, and stopping that chat stops the work. An agent can't hand work to itself.
2123
+
2124
+ ## 1.0.0-rc.10 — 2026-10-31
2125
+
2126
+ - **A routine made from a chat posts back in that chat.** `schedule_routine` keeps the chat it was
2127
+ called from (`routine.thread`), where before no setting could reach it: `same` meant a new chat
2128
+ made by the first run. `routine.create` takes `thread` (a chat in that space its maker can see),
2129
+ and `post` now defaults to `same`, in the web form too. Its confirmation says where it posts. If
2130
+ the chat is deleted or moved to another space, the run starts a new one and says why
2131
+ (`routineRun.note`).
2132
+ - **A new chat each run is a first-class choice,** for runs to open later (a daily analysis):
2133
+ `post:
2134
+ "new"`. Each chat is named by `chatName`, with `{name}`, `{date}`, `{time}` (its
2135
+ timezone) and `{run}` filled in; by default its name and the day (and time, for `hours` and
2136
+ `cron`), so runs no longer all share one name. Its agent may then name it for what it found, with
2137
+ the new `name_chat` tool, offered only in those chats. The routine's page lists runs by their
2138
+ chats' names. The form and the agent's confirmation say how many chats a day it comes to, when it
2139
+ runs at least hourly.
2140
+ - **A routine's messages say they're its.** `chat.send` takes `via` (`{ kind, name, path? }`): the
2141
+ message is still its sender's, but shows "Routine: Pricing", linked to the routine, and agents
2142
+ read `ana (via routine "Pricing"): …`, so they know nobody typed it just now. `chat.send` also
2143
+ takes `title` and `renamable` for a new thread, in the same commit as its first message.
2144
+
2145
+ ## 1.0.0-rc.9 — 2026-10-31
2146
+
2147
+ - **A space's page has a few tabs, and their sections.** A `spaceTabs` entry `under` another tab is
2148
+ a section of it, listed in its menu, with an optional `group` heading; a tab with sections names
2149
+ its own View among them (`own`) and shows them in a menu beside (`menu: "side"`) or as tabs above
2150
+ (`top`, the default). A section's key opens its tab there (`?tab=memories`), so every address
2151
+ still works, and the palette lists sections too. The tabs now: Chats, Board and Documents (an
2152
+ app's), Computer (Computers, Environment, Apps), Routines and Settings (General, Members,
2153
+ Memories, Skills, Channels: WhatsApp, API). Where there's no room for a menu beside (a phone),
2154
+ Settings is a list to tap into, and a section says how to get back; in the side panel, sections
2155
+ are tabs under the panel's. Who's waiting to join shows on Settings and on Members.
2156
+ - **On phones, an app's page.** The viewport spans the screen (`viewport-fit=cover`; the composer
2157
+ keeps clear of the home bar) and the keyboard resizes the page where browsers allow
2158
+ (`interactive-widget`); pinching still zooms. The page never scrolls sideways or bounces as a
2159
+ whole, and a tap is a tap (no double-tap zoom, no grey flash). On touch screens, text is 16px,
2160
+ fields too at least (so Safari never zooms in on one you type in), and buttons, icon buttons,
2161
+ fields and copy buttons are 44px targets (40px small).
2162
+ - **A conversation scrolls up and down only.** What's wider (a table, code) scrolls in its own box;
2163
+ text wraps; a file's chip and a tool call being written no longer widen it.
2164
+ - **What an agent asks you never covers the conversation.** The command or the file it shows scrolls
2165
+ within a few lines (a command can wrap into dozens), with a copy button, so the answers are always
2166
+ in sight; the cards keep to at most 60% of the chat's height and scroll there.
2167
+
2168
+ ## 1.0.0-rc.8 — 2026-10-31
2169
+
2170
+ - **Agents' prompts only grow, so the prompt cache keeps them whole.** A turn context (the
2171
+ computers', the spaces elsewhere, memories, an app's) is sent after the conversation only when it
2172
+ says something new: when its text isn't what the agent was last told there. The turn's first
2173
+ message keeps what it was told (`told`, `[{ name, text }]`, a private field: people's reads come
2174
+ without it), and later turns are sent it there. So each model call starts with the whole call
2175
+ before it, tool steps and earlier contexts included, where before a turn's context, dropped the
2176
+ next turn, cut the cached prefix at the turn's start. `Prompt.turn` is now `{ name, text }[]`:
2177
+ what's new this turn.
2178
+ - **OpenAI's newer models keep the prefix where told.** Since GPT-5.6, OpenAI caches only at
2179
+ breakpoints: its implicit one falls at the end of the latest user message, the turn's context,
2180
+ which the next turn didn't send, so a conversation reused only its system text. The Responses
2181
+ adapter now marks a message with `cache` (the end of the history) with an explicit
2182
+ `prompt_cache_breakpoint`, on the user's or tool's input at or before it. A model that refuses
2183
+ breakpoints (earlier ones, other servers) is asked again without, and never again. What OpenAI
2184
+ wrote to the cache is metered as `cacheWrite` (billed at a premium by models that report it).
2185
+ - **Memory: the system text says how to remember; what's remembered is told.** The `memory` context
2186
+ (system) is the guide alone, the same in every conversation, so the system text is cached across
2187
+ all of an agent's conversations in a space. Core memories about who's here are the new
2188
+ `remembered` turn context: those learned before the conversation began, told at its start and kept
2189
+ there. Core memories learned since come up in `recall` when relevant (query `relevant` takes
2190
+ `since`; `core` takes `before`), so a memory learned mid-conversation never rewrites its prompt.
2191
+ - **History summarizes a message when it leaves the tail**, not when it comes: only then is its line
2192
+ read (in the outline, or by `zoom`). A conversation that stays within the tail never calls the
2193
+ summarizer; a longer one builds the same tree, in batches, as its tail shrinks. The outline keeps
2194
+ the tail's message ids (`tailIds`); threads summarized before keep the lines they have.
2195
+ - Measured on Compass's own plugins with real OpenAI calls (gpt-6.1-sol; a 12-turn conversation,
2196
+ then a 4-turn one with tool steps, the same agent in the same space): the agent's calls read 95.5%
2197
+ of their input from the prompt cache, up from 59.3%, and every model call in the run (memory
2198
+ extraction included) 92.4%, up from 44.4%, with no summarizer call (101 before). A 24-turn
2199
+ conversation that outgrew its tail: 92.4% for the agent, its one miss when the outline arrives
2200
+ (the prompt is new from there).
2201
+
2202
+ ## 1.0.0-rc.7 — 2026-10-30
2203
+
2204
+ - **Agents choose among a space's computers.** Every computer tool (the terminal, jobs, files, the
2205
+ browser, web search, `preview`, and the apps' `publish`) takes `computer`: one of the space's
2206
+ computers by its name (any case, or part of it when only one has it) or its id; the space's
2207
+ default otherwise. An unknown or ambiguous name, or a computer that's offline, is told with the
2208
+ ones to choose from; naming a cloud computer that's asleep wakes it. Each turn, an agent's context
2209
+ lists the space's computers (whose, a cloud computer or a machine, how it is now, its system, what
2210
+ it asks first, the default marked) when there are several; one stays as it was. In a space with
2211
+ several, an answer says the computer it came from (`computer`), and the web's tool steps show it.
2212
+ - **A job is found on whichever computer runs it:** `computer.preview` and `computer.scope` (and so
2213
+ `app.publish` and the agents' `preview` and `publish`) take a job without a computer and look for
2214
+ it on the space's computers that are online, the default first. `computer.preview`,
2215
+ `computer.scope`, `computer.allowed` and `app.publish` take `computer` (a name or an id).
2216
+ - **The default computer** is named so on the web (a "Default" badge, "Make it the default") and in
2217
+ `/computers`.
2218
+ - **Apps: what serves a preview serves the app.** A folder with no Dockerfile is built into an image
2219
+ made for it (no more buildpacks, which found nothing to build in a plain folder): the computer's
2220
+ system (Debian 12) with Node.js 24 and Python, the folder as it was sent, its dependencies
2221
+ installed again (npm, pnpm, yarn; `requirements.txt`) and its `build` script run, then its job's
2222
+ command behind a front that passes the platform's port on to the job's port on localhost,
2223
+ WebSockets included. A job bound to `127.0.0.1` (as previews allow) is served all the same; the
2224
+ job is given its own port as `PORT`. `AppHost.build` answers the port its image serves on. Without
2225
+ a Dockerfile, an app is published from its job (its command).
2226
+ - **A space's environment: variables and secrets.** Each space has its own (collection `envVar`,
2227
+ `{ name, value, secret, computers, by, at }`, names like `API_URL`). Its managers change it
2228
+ (`env.set` `{ in, name, value?, secret?, computers? }`, `env.unset`); its members read names and
2229
+ the values of variables. A secret is sealed at rest (AES-GCM, with the new `computers: { key }`
2230
+ resource, else kept as given) and never read back by anyone: people see only that it's there (and
2231
+ a long one's last 4 characters), agents only its name. Every job and shell started in the space,
2232
+ from the web or by an agent, gets the variables with `computers` (true unless said), under its own
2233
+ `env` (`jobs.start` and `terminal` take `env`; the `start_job` tool too); a job kept running keeps
2234
+ its env on the computer's disk and starts again with it. A secret given to computers can be read
2235
+ by any process there, and the web says so where it's given. Agents' computer context lists the
2236
+ names they have (`$NAME`), never a value.
2237
+ - **Apps get the space's environment.** An app is deployed with all of its space's variables and
2238
+ secrets, and its own over them (`envVar` with `app`; queries `here` and `apps`), passed to Cloud
2239
+ Run as its env. `app.configure` `{ app, env? }` (its publisher, or the space's managers) changes
2240
+ its own and deploys its image again with them, without a build (the port the image serves is kept
2241
+ as `served`). A change to the space's environment doesn't redeploy anything: it reaches an app
2242
+ when it's published again, or at once with "Apply to apps". Taking an app down removes its own
2243
+ environment (`env.unset` `{ in, app }`).
2244
+ - **Web: Environment.** A space's Environment tab lists its variables (a secret masked, whether its
2245
+ computers get it, who set it and when); its managers add, change and remove them, with the honest
2246
+ limit shown beside a secret given to computers. Under it, its live apps and "Apply to apps"
2247
+ (through computers' new `envActions` resource). An app's row opens its environment: the space's
2248
+ shown, its own edited, saved with a redeploy. The job start form takes its own environment
2249
+ (`NAME=value` lines). The toolkit's `Time` also draws on a server.
2250
+ - **People by name, everywhere:** agents' prompts, notes, the terminal and the web show a person's
2251
+ name where they showed their id (`google:1139…`). The spaces plugin keeps each person's profile
2252
+ (collection `profile`: their name as sign-in verified it, else their email's name, and picture;
2253
+ never their email), from the identity plugin's `person` as it changes, at `org.join`, and on
2254
+ `space.personal` (each page load), so people known before it get one the next time they come.
2255
+ Anyone in the org reads names through the query `profile.names` `{ ids }` (a browser reads
2256
+ profiles only through it); two people of one name stay apart ("Ana (2762)"). The new `names`
2257
+ resource says where names are (`{ collection: "profile" }`), and the spaces contract (and
2258
+ `copilotz/plugins/access`) gives `nameOf`, `namesOf`, `namesIn` (Views), `namesFor` (Actions,
2259
+ Processors, tools), `withNames`, `idsIn` and `PROFILE`. A sign-in's id is never shown as a name:
2260
+ without a profile, it's "someone".
2261
+ - **Agents' prompts:** others' messages read "Ana Lima: …", "People here:" names people, a
2262
+ conversation's space is "Ana Lima's Personal space", the computers context says whose computer it
2263
+ is and who says yes by name, as do waiting asks, routines (who made one, whom it runs as), history
2264
+ summaries and zoom, and recall. Memory extraction writes names, and `remember`'s `about` takes a
2265
+ person by name.
2266
+ - **Notes and summaries written before names:** a memory or a summary that says someone's id
2267
+ (`google:1139…'s cloud computer…`) reads with their name wherever it shows (prompts, recall, the
2268
+ Memories page, the terminal), substituted when it's shown: nothing stored is changed, and nothing
2269
+ needs migrating.
2270
+ - **The web:** the Members tab (people, requests to join, invitations), the space header's faces,
2271
+ other people's Personal spaces ("Ana Lima's Personal"), invitations ("Ana Lima invited you"), chat
2272
+ messages and the conversation's people, memories (grouped, by whom, search), routines, skills
2273
+ ("Made by"), apps ("by"), computers (whose each is, who asks first, who started a job or made a
2274
+ preview), usage and the org's people show names. **The terminal:** `/computers`, `/approvals`,
2275
+ `/requests`, `/grant`, `/invitations`, memories and messages, likewise; `/remove` takes a person's
2276
+ id with a colon (`google:1139…`).
2277
+ - **Share refusals** name the spaces a write would reveal ("Ana Lima's Personal space"), not their
2278
+ ids. An org invitation made by a space invitation says who invited them.
2279
+
2280
+ ## 1.0.0-rc.6 — 2026-10-30
2281
+
2282
+ - **Computer program:** an app on another machine over plain `ws:` (an `http://` address that isn't
2283
+ localhost) fails at once, saying to use https, instead of waiting to connect forever: Oxian
2284
+ refuses plain `ws:` but to this machine.
2285
+ - **Cloud pools:** a pool grown for a wake isn't shrunk while its VM boots. `pool.take` records what
2286
+ it waits for (`poolWant`), and `pool.tick` sizes each pool to its floor, the takes of the last 2
2287
+ minutes and the wakes still waiting. Before, the next minute's sizing set the pool back to its
2288
+ floor, deleting the VM a wake had grown it for before it connected.
2289
+ - **Cloud computers:** `cloudComputer.sizes` also says whether the person asking may make one now
2290
+ (`create`, and `why` not: `admins`, `budget`), and the warm and view minutes; `cloud.may` says
2291
+ just that. The web's "Use a cloud computer" choice shows why it can't be picked, and the copy says
2292
+ the app's minutes.
2293
+ - **Cloud computers shared into a space:** each computer's state is kept on it and its desks
2294
+ (`status`: `{ kind: "cloud", state, size }`, set with the new system Action `computer.mark`, as
2295
+ the cloud plugin sees it change), so the space's members see how anyone's is (asleep, waking,
2296
+ awake), not "offline".
2297
+ - **Previews:** `preview.here` records carry their address (`url`); the web no longer works it out.
2298
+ `computer.preview` and `computer.scope` take a `desk` (one of the space's), and so does
2299
+ `app.publish`: the web makes previews and publishes apps from the computer it's on, not the
2300
+ space's default.
2301
+ - **Apps:** an agent's `publish` asks its person with where the app will be ("wants to publish Shop
2302
+ at https://shop.copilotz.app").
2303
+ - **`org.me`** isn't recorded (it only reads), so reads (queries, Views) ask it too.
2304
+ - **The local cloud host** is one per app and account, whichever executor asks: with several
2305
+ executors, a VM one started was turned away by another.
2306
+
2307
+ ## 1.0.0-rc.5 — 2026-10-30
2308
+
2309
+ - **Cloud computers** (plugin `cloud`, see design/cloud-computers.md): computers the app hosts for
2310
+ its people. A cloud computer is a disk; a VM from a pool serves it for one wake, then goes.
2311
+ `cloud.create` `{ size, in?, name? }` makes one (an org's owners and admins, or its members when
2312
+ the settings say, under the org's monthly `budgetUsd`); work for one that's asleep wakes it (a few
2313
+ seconds; about 30 from cold); unused for `warmMinutes` (10) it's released, and after `coldDays`
2314
+ (7) it goes cold, kept as a snapshot. A person with it open (`computer.view`, every few minutes
2315
+ from its panel) keeps it awake up to `viewMinutes` (120). Its agents ask their person nothing
2316
+ first (the `cloud` settings' `approve`, `[]` by default, in place of the computers plugin's;
2317
+ publishing an app is always asked). `cloud.destroy`, `cloud.org`, queries `cloudComputer.mine` and
2318
+ `cloudComputer.sizes` (each size priced an hour). Hosts are adapters: Compute Engine (`gceHost`:
2319
+ managed instance groups as pools, pd-balanced disks, VMs admitted by their Google identity tokens)
2320
+ and a local one for development and tests. Metered under `computer` as `cloud/<size>` (VM
2321
+ seconds), `cloud/disk` and `cloud/snapshot` (GB-hours).
2322
+ - **Cloud pools** (plugin `cloudPool`): the pools' VMs, where they connect (the `pool` worker kind),
2323
+ and the Actions `cloud` reaches them through: `pool.take`, `pool.serve`, `pool.stop`, `pool.drop`,
2324
+ `pool.renew`, and `pool.tick` each minute (pools sized by the hour). Each VM given is leased:
2325
+ renewed each minute while its computer uses it, deleted once nobody does. A VM serving a computer
2326
+ connects again as itself when its socket drops, until it's told to stop; then, or gone, never
2327
+ again. One runtime has both plugins; an app of many orgs runs `cloudPool` once (its directory's
2328
+ runtime, needing nothing else) and gives each org's runtime `remotePool(call, org)`, the same
2329
+ Actions forwarded there, each org touching only its own VMs.
2330
+ - **Computer program:** `computer pool --app <url>`, a free VM of an app's pool: it waits to serve a
2331
+ computer, mounts its disk, and runs it, connected at the address it's told (its org's). Given the
2332
+ app's socket (`wss://…`), its identity is still for the app's https origin. scripts/cloud has a
2333
+ Google Cloud project's setup and the pool VMs' startup script.
2334
+ - **Previews:** what a job serves, at `https://<computer>-preview.<domain>`, carried to the computer
2335
+ over its own connection (no inbound network), streamed both ways (`computer.http`). For a space's
2336
+ members (a signed cookie, given by the app) or anyone with the link. `computer.preview`,
2337
+ `computer.previews`, `computer.unpreview`, and the agents' `preview` tool. Settings
2338
+ `computers.previews` `{ domain, key }`. WebSockets aren't carried yet.
2339
+ - **Apps** (plugin `apps`): what a job serves, published to run on its own at
2340
+ `https://<label>.copilotz.app`. The space's folder is archived by its computer
2341
+ (`computer.archive`), built (its Dockerfile, else buildpacks) and deployed as a service that
2342
+ scales to zero. `app.publish` (and the agents' `publish` tool, always asked), `app.list`,
2343
+ `app.redeploy`, `app.remove`; builds and running metered under `app`. Hosts: Cloud Run
2344
+ (`cloudRun`) and a local one (`localApps`).
2345
+ - **Apps' safety:** services and images are named `cz-app-<name>` (an app never replaces another
2346
+ service in its project); builds run as `cz-build@<project>` (`buildServiceAccount`), never the
2347
+ project's default service account, as they run the app's own Dockerfile. `app.publish`'s `port`
2348
+ wins over its job's.
2349
+ - **Previews' safety:** a preview's `Set-Cookie` loses its `Domain` (no preview sets cookies for the
2350
+ domain's other hosts); a request with several `cz_preview` cookies gets in when any is its host's.
2351
+ - **Jobs** can say their `port` (a preview's) and be kept (`keep`): a kept job runs again when its
2352
+ computer wakes.
2353
+ - **A person's panel** (`computer.work`): `wake` wakes a computer that sleeps (its page opened);
2354
+ what only reads (`jobs.list`, `jobs.logs`, `files.list`, `files.read`, `search`) neither wakes it
2355
+ nor keeps it awake, so a page left open lets it sleep (`computer.view` keeps it awake while
2356
+ viewed, up to the limit). A computer the app makes says what its agents ask about
2357
+ (`computer.provision`'s `approve`, kept on it and its desks).
2358
+ - **On the web** (`copilotz/plugins/compute/web`: `computersWeb`, `cloudWeb`, `appsWeb`):
2359
+ - adding a computer is one choice: a cloud computer (its sizes, priced an hour), your own machine,
2360
+ or one of yours;
2361
+ - a cloud computer shows its state, how long it's been awake and about what that came to; asleep,
2362
+ waking it, with honest progress; deleting it, asked first;
2363
+ - a job serving a port can be previewed (members, or anyone with the link), opened, copied and
2364
+ published as an app (live as it builds), and a space has an Apps tab;
2365
+ - jobs can be kept running.
2366
+ - **Web host:** routes by host (`{ host }` beside `{ path }`); a trusted front (`front`: a secret
2367
+ header and the host it forwards) for apps behind a proxy; orgs claim hosts in the directory
2368
+ (`orgHost`), resolved at `/__copilotz/hosts/resolve`.
2369
+ - **Runtime:** `runtime.workers.dispatch(kind, id, workload, body?)`, for host code (a route)
2370
+ streaming work to a connected worker.
2371
+ - **Usage:** `usage.quote` prices quantities as a use would be, without recording one.
2372
+
1
2373
  ## 1.0.0-rc.4 — 2026-10-30
2
2374
 
3
2375
  - **Usage: every use has a price.** It's the cost (a margin of 0) unless the app's price book says