copilotz 1.0.0-rc.20 → 1.0.0-rc.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (340) hide show
  1. package/CHANGELOG.md +417 -0
  2. package/README.md +295 -19
  3. package/hosts/orgs/mod.d.ts +4 -1
  4. package/hosts/orgs/mod.js +2 -2
  5. package/hosts/web/files.d.ts +6 -2
  6. package/hosts/web/files.js +36 -3
  7. package/hosts/web/node/mod.d.ts +1 -1
  8. package/hosts/web/node/mod.js +1 -1
  9. package/hosts/web/node/serve.d.ts +26 -0
  10. package/hosts/web/node/serve.js +23 -1
  11. package/hosts/web/routes.d.ts +28 -1
  12. package/hosts/web/routes.js +65 -10
  13. package/hosts/web/server.d.ts +5 -4
  14. package/hosts/web/server.js +1 -1
  15. package/package.json +2 -2
  16. package/plugins/access/accounts/collections/account.d.ts +2 -2
  17. package/plugins/access/contacts/actions/chat.d.ts +1 -0
  18. package/plugins/access/contacts/actions/chat.js +45 -0
  19. package/plugins/access/contacts/actions/forget.d.ts +1 -0
  20. package/plugins/access/contacts/actions/forget.js +56 -0
  21. package/plugins/access/contacts/actions/start.d.ts +1 -0
  22. package/plugins/access/contacts/actions/start.js +50 -0
  23. package/plugins/access/contacts/collections/contact.d.ts +81 -0
  24. package/plugins/access/contacts/collections/contact.js +58 -0
  25. package/plugins/access/contacts/contract.d.ts +10 -0
  26. package/plugins/access/contacts/contract.js +10 -0
  27. package/plugins/access/contacts/mod.d.ts +27 -0
  28. package/plugins/access/contacts/mod.js +49 -0
  29. package/plugins/access/contacts/views/contact.d.ts +8 -0
  30. package/plugins/access/contacts/views/contact.js +25 -0
  31. package/plugins/access/contacts/web.d.ts +7 -0
  32. package/plugins/access/contacts/web.js +11 -0
  33. package/plugins/access/directory/collections/credit-code.d.ts +1 -1
  34. package/plugins/access/directory/collections/invite.d.ts +1 -1
  35. package/plugins/access/identity/mod.js +8 -6
  36. package/plugins/access/mod.d.ts +7 -1
  37. package/plugins/access/mod.js +7 -2
  38. package/plugins/access/spaces/actions/agents.js +12 -6
  39. package/plugins/access/spaces/actions/create.js +10 -1
  40. package/plugins/access/spaces/actions/invitation.js +5 -2
  41. package/plugins/access/spaces/actions/keep.d.ts +1 -0
  42. package/plugins/access/spaces/actions/keep.js +55 -0
  43. package/plugins/access/spaces/actions/member.js +17 -4
  44. package/plugins/access/spaces/actions/rename.js +4 -0
  45. package/plugins/access/spaces/collections/member.d.ts +1 -1
  46. package/plugins/access/spaces/collections/request.d.ts +1 -1
  47. package/plugins/access/spaces/collections/space.d.ts +9 -0
  48. package/plugins/access/spaces/collections/space.js +2 -0
  49. package/plugins/access/spaces/contract.d.ts +4 -3
  50. package/plugins/access/spaces/contract.js +1 -1
  51. package/plugins/access/spaces/mod.d.ts +7 -1
  52. package/plugins/access/spaces/mod.js +8 -1
  53. package/plugins/access/spaces/resources/tools.d.ts +0 -5
  54. package/plugins/access/spaces/resources/tools.js +11 -1
  55. package/plugins/access/spaces/shared/agents.js +2 -2
  56. package/plugins/access/spaces/shared/can.d.ts +18 -3
  57. package/plugins/access/spaces/shared/can.js +32 -5
  58. package/plugins/access/spaces/shared/declared.d.ts +21 -0
  59. package/plugins/access/spaces/shared/declared.js +8 -0
  60. package/plugins/access/spaces/shared/labels.d.ts +7 -1
  61. package/plugins/access/spaces/shared/labels.js +56 -8
  62. package/plugins/access/spaces/shared/managers.js +2 -2
  63. package/plugins/access/spaces/shared/names.d.ts +9 -5
  64. package/plugins/access/spaces/shared/names.js +36 -19
  65. package/plugins/access/spaces/shared/reach.d.ts +20 -6
  66. package/plugins/access/spaces/shared/reach.js +62 -20
  67. package/plugins/access/spaces/shared/rules.d.ts +10 -5
  68. package/plugins/access/spaces/shared/rules.js +35 -10
  69. package/plugins/access/spaces/shared/seat.d.ts +3 -2
  70. package/plugins/access/spaces/shared/seat.js +9 -2
  71. package/plugins/access/spaces/views/where.d.ts +4 -2
  72. package/plugins/access/spaces/views/where.js +9 -0
  73. package/plugins/access/spaces/web.js +1 -1
  74. package/plugins/access/web.d.ts +1 -0
  75. package/plugins/access/web.js +1 -0
  76. package/plugins/agents/chat/actions/erase.d.ts +1 -0
  77. package/plugins/agents/chat/actions/erase.js +51 -0
  78. package/plugins/agents/chat/actions/open.d.ts +1 -0
  79. package/plugins/agents/chat/actions/open.js +49 -0
  80. package/plugins/agents/chat/actions/quiet.d.ts +1 -0
  81. package/plugins/agents/chat/actions/quiet.js +33 -0
  82. package/plugins/agents/chat/actions/say.d.ts +1 -0
  83. package/plugins/agents/chat/actions/say.js +82 -0
  84. package/plugins/agents/chat/actions/send.js +57 -19
  85. package/plugins/agents/chat/actions/shown.d.ts +1 -0
  86. package/plugins/agents/chat/actions/shown.js +35 -0
  87. package/plugins/agents/chat/collections/intent.d.ts +124 -0
  88. package/plugins/agents/chat/collections/intent.js +52 -0
  89. package/plugins/agents/chat/collections/message.d.ts +74 -1
  90. package/plugins/agents/chat/collections/message.js +23 -1
  91. package/plugins/agents/chat/collections/shown.d.ts +105 -0
  92. package/plugins/agents/chat/collections/shown.js +34 -0
  93. package/plugins/agents/chat/contract.d.ts +15 -7
  94. package/plugins/agents/chat/contract.js +7 -1
  95. package/plugins/agents/chat/mod.d.ts +20 -2
  96. package/plugins/agents/chat/mod.js +43 -4
  97. package/plugins/agents/chat/processors/failed.js +15 -5
  98. package/plugins/agents/chat/processors/turn.d.ts +1 -1
  99. package/plugins/agents/chat/processors/turn.js +95 -35
  100. package/plugins/agents/chat/shared/delivery.d.ts +16 -2
  101. package/plugins/agents/chat/shared/delivery.js +62 -7
  102. package/plugins/agents/chat/shared/send.d.ts +1 -3
  103. package/plugins/agents/chat/shared/send.js +2 -9
  104. package/plugins/agents/chat/shared/tools.d.ts +33 -0
  105. package/plugins/agents/chat/shared/tools.js +28 -0
  106. package/plugins/agents/chat/shared/types.d.ts +59 -1
  107. package/plugins/agents/chat/views/message.d.ts +4 -2
  108. package/plugins/agents/chat/views/message.js +22 -4
  109. package/plugins/agents/chat/views/prompt.js +38 -4
  110. package/plugins/agents/history/collections/outline.d.ts +1 -1
  111. package/plugins/agents/history/collections/summary.d.ts +1 -1
  112. package/plugins/agents/history/mod.js +2 -1
  113. package/plugins/agents/history/processors/erase.d.ts +3 -0
  114. package/plugins/agents/history/processors/erase.js +11 -0
  115. package/plugins/agents/memory/mod.js +2 -1
  116. package/plugins/agents/memory/processors/extract.d.ts +1 -1
  117. package/plugins/agents/memory/processors/extract.js +5 -0
  118. package/plugins/agents/memory/resources/tools.js +1 -1
  119. package/plugins/agents/memory/shared/settings.d.ts +7 -2
  120. package/plugins/agents/memory/shared/settings.js +9 -1
  121. package/plugins/agents/routines/collections/routine.d.ts +1 -1
  122. package/plugins/agents/routines/collections/run.d.ts +1 -1
  123. package/plugins/compute/apps/collections/app.d.ts +2 -2
  124. package/plugins/compute/cloud/resources/tools.js +3 -3
  125. package/plugins/compute/computers/collections/approval.d.ts +2 -2
  126. package/plugins/compute/computers/collections/grant.d.ts +1 -1
  127. package/plugins/compute/computers/collections/preview.d.ts +2 -2
  128. package/plugins/compute/computers/program/version.d.ts +1 -1
  129. package/plugins/compute/computers/program/version.js +1 -1
  130. package/plugins/compute/computers/resources/downloads.js +1 -1
  131. package/plugins/compute/computers/shared/wake.d.ts +1 -1
  132. package/plugins/compute/computers/shared/wake.js +17 -0
  133. package/plugins/interfaces/api/collections/key.d.ts +1 -1
  134. package/plugins/interfaces/api/shared/events.js +5 -4
  135. package/plugins/interfaces/maintenance/actions/read.d.ts +4 -0
  136. package/plugins/interfaces/maintenance/actions/read.js +76 -0
  137. package/plugins/interfaces/maintenance/actions/write.d.ts +4 -0
  138. package/plugins/interfaces/maintenance/actions/write.js +64 -0
  139. package/plugins/interfaces/maintenance/contract.d.ts +60 -0
  140. package/plugins/interfaces/maintenance/contract.js +2 -0
  141. package/plugins/interfaces/maintenance/mod.d.ts +52 -0
  142. package/plugins/interfaces/maintenance/mod.js +66 -0
  143. package/plugins/interfaces/maintenance/resources/routes.d.ts +71 -0
  144. package/plugins/interfaces/maintenance/resources/routes.js +457 -0
  145. package/plugins/interfaces/maintenance/shared/ops.d.ts +4 -0
  146. package/plugins/interfaces/maintenance/shared/ops.js +19 -0
  147. package/plugins/interfaces/mcp/actions/call.d.ts +11 -0
  148. package/plugins/interfaces/mcp/actions/call.js +304 -0
  149. package/plugins/interfaces/mcp/actions/prune.d.ts +1 -0
  150. package/plugins/interfaces/mcp/actions/prune.js +18 -0
  151. package/plugins/interfaces/mcp/collections/closed.d.ts +23 -0
  152. package/plugins/interfaces/mcp/collections/closed.js +17 -0
  153. package/plugins/interfaces/mcp/collections/rate.d.ts +27 -0
  154. package/plugins/interfaces/mcp/collections/rate.js +18 -0
  155. package/plugins/interfaces/mcp/collections/receipt.d.ts +46 -0
  156. package/plugins/interfaces/mcp/collections/receipt.js +46 -0
  157. package/plugins/interfaces/mcp/contract.d.ts +9 -0
  158. package/plugins/interfaces/mcp/contract.js +9 -0
  159. package/plugins/interfaces/mcp/mod.d.ts +84 -0
  160. package/plugins/interfaces/mcp/mod.js +122 -0
  161. package/plugins/interfaces/mcp/processors/closed.d.ts +13 -0
  162. package/plugins/interfaces/mcp/processors/closed.js +16 -0
  163. package/plugins/interfaces/mcp/resources/running.d.ts +21 -0
  164. package/plugins/interfaces/mcp/resources/running.js +36 -0
  165. package/plugins/interfaces/mcp/resources/server.d.ts +54 -0
  166. package/plugins/interfaces/mcp/resources/server.js +423 -0
  167. package/plugins/interfaces/mcp/resources/tools.d.ts +114 -0
  168. package/plugins/interfaces/mcp/resources/tools.js +324 -0
  169. package/plugins/interfaces/mcp/shared/caller.d.ts +45 -0
  170. package/plugins/interfaces/mcp/shared/caller.js +99 -0
  171. package/plugins/interfaces/mcp/shared/keys.d.ts +50 -0
  172. package/plugins/interfaces/mcp/shared/keys.js +53 -0
  173. package/plugins/interfaces/mcp/shared/settings.d.ts +187 -0
  174. package/plugins/interfaces/mcp/shared/settings.js +176 -0
  175. package/plugins/interfaces/mcp/views/offered.d.ts +20 -0
  176. package/plugins/interfaces/mcp/views/offered.js +20 -0
  177. package/plugins/interfaces/mod.d.ts +5 -1
  178. package/plugins/interfaces/mod.js +5 -1
  179. package/plugins/interfaces/terminal/actions/print.js +1 -1
  180. package/plugins/interfaces/terminal/actions/set.js +1 -1
  181. package/plugins/interfaces/terminal/collections/output.d.ts +1 -1
  182. package/plugins/interfaces/terminal/collections/shell.js +1 -1
  183. package/plugins/interfaces/voice/actions/block.d.ts +2 -0
  184. package/plugins/interfaces/voice/actions/block.js +74 -0
  185. package/plugins/interfaces/voice/actions/call.d.ts +19 -0
  186. package/plugins/interfaces/voice/actions/call.js +253 -0
  187. package/plugins/interfaces/voice/actions/hook.d.ts +5 -0
  188. package/plugins/interfaces/voice/actions/hook.js +225 -0
  189. package/plugins/interfaces/voice/actions/prune.d.ts +1 -0
  190. package/plugins/interfaces/voice/actions/prune.js +35 -0
  191. package/plugins/interfaces/voice/collections/blocked.d.ts +87 -0
  192. package/plugins/interfaces/voice/collections/blocked.js +34 -0
  193. package/plugins/interfaces/voice/collections/call.d.ts +279 -0
  194. package/plugins/interfaces/voice/collections/call.js +77 -0
  195. package/plugins/interfaces/voice/collections/phone.d.ts +74 -0
  196. package/plugins/interfaces/voice/collections/phone.js +26 -0
  197. package/plugins/interfaces/voice/contract.d.ts +14 -0
  198. package/plugins/interfaces/voice/contract.js +2 -0
  199. package/plugins/interfaces/voice/mod.d.ts +57 -0
  200. package/plugins/interfaces/voice/mod.js +118 -0
  201. package/plugins/interfaces/voice/processors/forget.d.ts +13 -0
  202. package/plugins/interfaces/voice/processors/forget.js +27 -0
  203. package/plugins/interfaces/voice/resources/relay.d.ts +77 -0
  204. package/plugins/interfaces/voice/resources/relay.js +428 -0
  205. package/plugins/interfaces/voice/resources/tools.d.ts +1 -0
  206. package/plugins/interfaces/voice/resources/tools.js +25 -0
  207. package/plugins/interfaces/voice/shared/caller.d.ts +27 -0
  208. package/plugins/interfaces/voice/shared/caller.js +38 -0
  209. package/plugins/interfaces/voice/shared/settings.d.ts +136 -0
  210. package/plugins/interfaces/voice/shared/settings.js +121 -0
  211. package/plugins/interfaces/voice/shared/signature.d.ts +11 -0
  212. package/plugins/interfaces/voice/shared/signature.js +34 -0
  213. package/plugins/interfaces/voice/views/call.d.ts +41 -0
  214. package/plugins/interfaces/voice/views/call.js +30 -0
  215. package/plugins/interfaces/voice/views/context.d.ts +9 -0
  216. package/plugins/interfaces/voice/views/context.js +14 -0
  217. package/plugins/interfaces/voice/views/message.d.ts +17 -0
  218. package/plugins/interfaces/voice/views/message.js +41 -0
  219. package/plugins/interfaces/whatsapp/actions/connect.js +3 -0
  220. package/plugins/interfaces/whatsapp/actions/disconnect.js +4 -1
  221. package/plugins/interfaces/whatsapp/actions/hook.js +27 -11
  222. package/plugins/interfaces/whatsapp/actions/set.d.ts +8 -0
  223. package/plugins/interfaces/whatsapp/actions/set.js +121 -0
  224. package/plugins/interfaces/whatsapp/collections/blocked.d.ts +29 -0
  225. package/plugins/interfaces/whatsapp/collections/blocked.js +22 -0
  226. package/plugins/interfaces/whatsapp/collections/code.d.ts +1 -1
  227. package/plugins/interfaces/whatsapp/collections/number.d.ts +90 -4
  228. package/plugins/interfaces/whatsapp/collections/number.js +36 -4
  229. package/plugins/interfaces/whatsapp/collections/phone.d.ts +13 -3
  230. package/plugins/interfaces/whatsapp/collections/phone.js +9 -3
  231. package/plugins/interfaces/whatsapp/collections/rate.d.ts +27 -0
  232. package/plugins/interfaces/whatsapp/collections/rate.js +13 -0
  233. package/plugins/interfaces/whatsapp/collections/sent.d.ts +24 -12
  234. package/plugins/interfaces/whatsapp/collections/sent.js +11 -7
  235. package/plugins/interfaces/whatsapp/collections/thread.d.ts +14 -6
  236. package/plugins/interfaces/whatsapp/collections/thread.js +7 -5
  237. package/plugins/interfaces/whatsapp/collections/typing.d.ts +70 -0
  238. package/plugins/interfaces/whatsapp/collections/typing.js +21 -0
  239. package/plugins/interfaces/whatsapp/contract.d.ts +27 -4
  240. package/plugins/interfaces/whatsapp/contract.js +34 -1
  241. package/plugins/interfaces/whatsapp/events/undelivered.d.ts +8 -0
  242. package/plugins/interfaces/whatsapp/events/undelivered.js +17 -0
  243. package/plugins/interfaces/whatsapp/mod.d.ts +28 -2
  244. package/plugins/interfaces/whatsapp/mod.js +65 -6
  245. package/plugins/interfaces/whatsapp/processors/forget.d.ts +6 -0
  246. package/plugins/interfaces/whatsapp/processors/forget.js +11 -0
  247. package/plugins/interfaces/whatsapp/processors/receive.d.ts +17 -3
  248. package/plugins/interfaces/whatsapp/processors/receive.js +264 -81
  249. package/plugins/interfaces/whatsapp/processors/reply.d.ts +25 -5
  250. package/plugins/interfaces/whatsapp/processors/reply.js +216 -20
  251. package/plugins/interfaces/whatsapp/processors/typing.d.ts +8 -0
  252. package/plugins/interfaces/whatsapp/processors/typing.js +25 -0
  253. package/plugins/interfaces/whatsapp/shared/customers.d.ts +13 -0
  254. package/plugins/interfaces/whatsapp/shared/customers.js +16 -0
  255. package/plugins/interfaces/whatsapp/shared/graph.d.ts +31 -6
  256. package/plugins/interfaces/whatsapp/shared/graph.js +117 -10
  257. package/plugins/interfaces/whatsapp/shared/media.d.ts +23 -0
  258. package/plugins/interfaces/whatsapp/shared/media.js +46 -0
  259. package/plugins/interfaces/whatsapp/shared/number.d.ts +19 -8
  260. package/plugins/interfaces/whatsapp/shared/number.js +64 -7
  261. package/plugins/interfaces/whatsapp/shared/parts.d.ts +94 -0
  262. package/plugins/interfaces/whatsapp/shared/parts.js +184 -0
  263. package/plugins/interfaces/whatsapp/shared/payload.d.ts +27 -1
  264. package/plugins/interfaces/whatsapp/shared/payload.js +36 -1
  265. package/plugins/interfaces/whatsapp/shared/settings.d.ts +49 -1
  266. package/plugins/interfaces/whatsapp/shared/settings.js +11 -0
  267. package/plugins/interfaces/whatsapp/views/message.d.ts +13 -0
  268. package/plugins/interfaces/whatsapp/views/message.js +13 -0
  269. package/plugins/interfaces/whatsapp/views/web/line.d.ts +24 -0
  270. package/plugins/interfaces/whatsapp/views/web/line.js +44 -0
  271. package/plugins/interfaces/whatsapp/views/web/space.d.ts +7 -5
  272. package/plugins/interfaces/whatsapp/views/web/space.js +17 -10
  273. package/plugins/interfaces/whatsapp/views/web/style.d.ts +1 -1
  274. package/plugins/interfaces/whatsapp/views/web/style.js +8 -0
  275. package/plugins/models/adapters/llm/anthropic.d.ts +1 -1
  276. package/plugins/models/adapters/llm/anthropic.js +28 -15
  277. package/plugins/models/adapters/llm/gemini.d.ts +1 -1
  278. package/plugins/models/adapters/llm/gemini.js +2 -1
  279. package/plugins/models/adapters/llm/openai-compatible.d.ts +1 -1
  280. package/plugins/models/adapters/llm/openai-compatible.js +2 -1
  281. package/plugins/models/adapters/llm/openai.d.ts +1 -1
  282. package/plugins/models/adapters/llm/openai.js +16 -4
  283. package/plugins/models/shared/types.d.ts +8 -0
  284. package/plugins/models/shared/types.js +10 -0
  285. package/runtime/actor.d.ts +6 -0
  286. package/runtime/actor.js +9 -4
  287. package/runtime/aggregate.js +8 -2
  288. package/runtime/blobs.d.ts +15 -12
  289. package/runtime/blobs.js +58 -11
  290. package/runtime/cache.d.ts +6 -0
  291. package/runtime/cache.js +19 -1
  292. package/runtime/define.d.ts +10 -0
  293. package/runtime/errors.d.ts +20 -2
  294. package/runtime/errors.js +7 -1
  295. package/runtime/executor.js +27 -11
  296. package/runtime/links.d.ts +31 -0
  297. package/runtime/links.js +60 -0
  298. package/runtime/maintain.d.ts +88 -0
  299. package/runtime/maintain.js +120 -0
  300. package/runtime/memory.js +7 -4
  301. package/runtime/mod.d.ts +6 -4
  302. package/runtime/mod.js +5 -2
  303. package/runtime/mongo.d.ts +13 -0
  304. package/runtime/mongo.js +39 -8
  305. package/runtime/observe.d.ts +2 -0
  306. package/runtime/observe.js +14 -10
  307. package/runtime/ops.d.ts +5 -0
  308. package/runtime/ops.js +10 -1
  309. package/runtime/owner.d.ts +18 -1
  310. package/runtime/owner.js +127 -61
  311. package/runtime/presence.d.ts +18 -0
  312. package/runtime/presence.js +25 -0
  313. package/runtime/registry.d.ts +5 -0
  314. package/runtime/registry.js +18 -0
  315. package/runtime/runtime.js +9 -3
  316. package/runtime/store.d.ts +48 -1
  317. package/runtime/wire.d.ts +1 -0
  318. package/runtime/wire.js +3 -1
  319. package/stores/blobs/files/mod.js +4 -2
  320. package/stores/blobs/gcs/mod.d.ts +3 -0
  321. package/stores/blobs/gcs/mod.js +6 -5
  322. package/stores/blobs/http/mod.d.ts +1 -1
  323. package/stores/blobs/http/mod.js +2 -1
  324. package/stores/latency/mod.js +5 -1
  325. package/stores/sql/postgres/maintenance.d.ts +24 -0
  326. package/stores/sql/postgres/maintenance.js +258 -0
  327. package/stores/sql/postgres/mod.d.ts +20 -4
  328. package/stores/sql/postgres/mod.js +363 -96
  329. package/stores/sql/postgres/update.js +3 -1
  330. package/stores/sql/shared/capped.d.ts +2 -0
  331. package/stores/sql/shared/capped.js +22 -0
  332. package/stores/sql/shared/rows.d.ts +14 -0
  333. package/stores/sql/shared/rows.js +29 -0
  334. package/stores/sql/shared/statement.d.ts +12 -0
  335. package/stores/sql/shared/statement.js +244 -0
  336. package/stores/sql/sqlite/apart.d.ts +11 -0
  337. package/stores/sql/sqlite/apart.js +219 -0
  338. package/stores/sql/sqlite/mod.d.ts +16 -2
  339. package/stores/sql/sqlite/mod.js +246 -51
  340. package/testing/mod.js +1 -1
@@ -0,0 +1,253 @@
1
+ /**
2
+ * A call, as its socket goes (see resources/relay.ts, which calls these as
3
+ * the system; nobody outside may):
4
+ *
5
+ * - `voice.admit`: the socket's ticket, used: the call, if the ticket is
6
+ * one Twilio was given for it, unused and under a minute old. It works
7
+ * once: the call then holds its place among the line's calls at once
8
+ * until its hard end (the line's longest call, the goodbye's wait and
9
+ * closing: `lastsMs`), which the socket never lets it outlast.
10
+ * - `voice.start`: the call is on: its caller is a contact, in a chat in the
11
+ * line's space, answered by the line's agent (a line whose agent no longer
12
+ * answers there fails the call: no other agent takes it). Who the caller
13
+ * is goes by their number only when Twilio verified it, or the line
14
+ * trusts numbers (`trustCallerId`): then it's the contact that number was
15
+ * before, in the chat they were in, unless it's been quiet for the line's
16
+ * `gap`, or another call is on in it (checked in the very write that puts
17
+ * this call live, so two at once can't both join). Any other call, a hidden number's
18
+ * too, is a new contact in a new chat. The greeting Twilio says is
19
+ * written there too, as the agent's (`chat.say`), so the agent knows it
20
+ * was said and doesn't greet them again.
21
+ * - `voice.heard`: the caller cut what an agent said short (a message), and
22
+ * heard this much of it (the agent is told, the next turn: views/context.ts).
23
+ * - `voice.over`: the call ended, and why. What the caller heard of a cut
24
+ * answer goes with it.
25
+ *
26
+ * None is recorded: they're the call's own bookkeeping, and the ticket
27
+ * stays out of the log.
28
+ */
29
+ import { defineAction } from "../../../../runtime/mod.js";
30
+ import { lastsMs, lineOf } from "../shared/settings.js";
31
+ import { numberOf } from "../shared/caller.js";
32
+ import { sha256 } from "./hook.js";
33
+ /** Whether two strings are the same, in time that doesn't say where they differ. */
34
+ const same = (a, b) => {
35
+ let differ = a.length ^ b.length;
36
+ for (let i = 0; i < Math.max(a.length, b.length); i++) {
37
+ differ |= (a.charCodeAt(i) || 0) ^ (b.charCodeAt(i) || 0);
38
+ }
39
+ return differ === 0;
40
+ };
41
+ /** A margin on a call's place, past its hard end: clocks and commits aren't instant. */
42
+ const MARGIN_MS = 5_000;
43
+ const calls = (ctx) => ctx.as().db.collection("voice_call");
44
+ export const admitAction = defineAction({
45
+ description: "Uses a call's socket ticket, once",
46
+ input: {
47
+ type: "object",
48
+ properties: {
49
+ line: { type: "string" },
50
+ ticket: { type: "string", maxLength: 200 },
51
+ },
52
+ required: ["line", "ticket"],
53
+ additionalProperties: false,
54
+ },
55
+ record: false,
56
+ run: async (ctx, input) => {
57
+ const line = lineOf(ctx, input.line);
58
+ const [id, secret] = input.ticket.split(".");
59
+ if (!line || !id || !secret)
60
+ return null;
61
+ const found = await calls(ctx).findOne({ _id: id });
62
+ const now = Date.now();
63
+ if (!found?.ticket || found.state !== "ringing" || found.line !== line.name ||
64
+ Date.parse(found.until) <= now || !same(found.ticket, await sha256(secret)))
65
+ return null;
66
+ // Used once: only the first of two at once finds its ticket still there.
67
+ const { modifiedCount } = await calls(ctx).updateOne({ _id: id, ticket: found.ticket }, {
68
+ $set: { until: new Date(now + lastsMs(line) + MARGIN_MS).toISOString() },
69
+ $unset: { ticket: "" },
70
+ });
71
+ if (!modifiedCount)
72
+ return null;
73
+ return { _id: id, line: found.line, ...(found.from ? { from: found.from } : {}), to: found.to };
74
+ },
75
+ });
76
+ export const startAction = defineAction({
77
+ description: "A call is on: its caller's contact and chat",
78
+ input: {
79
+ type: "object",
80
+ properties: {
81
+ call: { type: "string" },
82
+ session: { type: "string", maxLength: 100 },
83
+ },
84
+ required: ["call"],
85
+ additionalProperties: false,
86
+ },
87
+ record: false,
88
+ run: async (ctx, input) => {
89
+ const call = await calls(ctx).findOne({ _id: input.call });
90
+ const line = call ? lineOf(ctx, call.line) : undefined;
91
+ if (!call || !line || call.state === "over") {
92
+ throw Object.assign(new Error("No such call going on"), { code: "not_found" });
93
+ }
94
+ const system = ctx.as();
95
+ if (call.contact && call.thread) {
96
+ return {
97
+ contact: call.contact,
98
+ thread: call.thread,
99
+ since: call.started,
100
+ ...await whom(ctx, line, call.thread),
101
+ ...greeting(call),
102
+ };
103
+ }
104
+ // Its space, when the app declares that too: made, or kept, first.
105
+ await system.call("space.keep", { id: line.in });
106
+ // Who they are goes by their number only when it's proof enough of it.
107
+ const number = numberOf(call.from);
108
+ const trusted = number && (call.verified || line.trustCallerId) ? number : undefined;
109
+ const phones = system.db.collection("voice_phone");
110
+ const key = `${line.name}:${trusted}`;
111
+ const known = trusted ? await phones.findOne({ _id: key }) : null;
112
+ // From the call, so asking again makes the same one.
113
+ const { contact } = await system.call("contact.start", {
114
+ id: known?.contact ?? `c-${(await sha256(`voice:${call._id}`)).slice(0, 24)}`,
115
+ in: line.in,
116
+ via: "voice",
117
+ });
118
+ // The chat they were in, if it goes on; else a new one. Another call on in it (two at once
119
+ // from one number) is checked again with the write that puts this one live: nobody joins.
120
+ let thread = await chatOf(ctx, line, contact, known?.thread);
121
+ const now = new Date().toISOString();
122
+ const live = async (tx, chat, joining) => {
123
+ const calls = tx.db.collection("voice_call");
124
+ if (joining && (await calls.find({ thread: chat, state: "live" })).length)
125
+ return false;
126
+ if (trusted) {
127
+ await tx.db.collection("voice_phone").replaceOne({ _id: key }, { line: line.name, phone: trusted, contact, thread: chat, at: now }, { upsert: true });
128
+ }
129
+ await calls.updateOne({ _id: call._id }, {
130
+ $set: {
131
+ state: "live",
132
+ contact,
133
+ thread: chat,
134
+ started: now,
135
+ ...(input.session ? { session: input.session } : {}),
136
+ },
137
+ });
138
+ return true;
139
+ };
140
+ if (!thread || !await system.transaction((tx) => live(tx, thread, true))) {
141
+ thread = await chatFor(ctx, line, contact, call);
142
+ await system.transaction((tx) => live(tx, thread, false));
143
+ }
144
+ const { agent } = await whom(ctx, line, thread);
145
+ // What Twilio says first, in the chat: the agent doesn't say it again.
146
+ const text = line.texts.greeting;
147
+ if (text) {
148
+ await system.call("chat.say", {
149
+ id: `voice:${call._id}`,
150
+ thread,
151
+ from: agent,
152
+ text,
153
+ to: [`contact:${contact}`],
154
+ });
155
+ }
156
+ return {
157
+ contact,
158
+ thread,
159
+ since: now,
160
+ agent,
161
+ ...(text ? greeting({ _id: call._id, thread }) : {}),
162
+ };
163
+ },
164
+ });
165
+ /** The greeting's message in a call's chat (`chat.say`'s id for it). */
166
+ const greeting = (call) => call.thread ? { greeting: `${call.thread}:say:voice:${call._id}` } : {};
167
+ /** The agent answering in a call's chat: the line's, else the chat's own. */
168
+ async function whom(ctx, line, thread) {
169
+ if (line.agent)
170
+ return { agent: line.agent };
171
+ const chat = await ctx.as().db.collection("thread").findOne({ _id: thread });
172
+ const agent = chat?.agents?.[0];
173
+ if (!agent)
174
+ throw Object.assign(new Error("Nobody answers this chat"), { code: "not_here" });
175
+ return { agent };
176
+ }
177
+ /**
178
+ * The chat a known caller was in, read as them, when it goes on: one they
179
+ * no longer reach (taken out of it), or quiet for the line's gap, doesn't.
180
+ */
181
+ async function chatOf(ctx, line, contact, thread) {
182
+ if (!thread)
183
+ return undefined;
184
+ const current = await ctx.as({ kind: "contact", id: contact }).db
185
+ .collection("thread").findOne({ _id: thread });
186
+ return current && Date.now() - Date.parse(current.at) < line.gap * 3_600_000 ? thread : undefined;
187
+ }
188
+ /**
189
+ * A new chat for a caller, in the line's space, opened by the line's agent
190
+ * (else by whoever answers new chats there), with an id from the call. When
191
+ * the line's agent doesn't answer in the space, the call fails: no other
192
+ * agent takes it.
193
+ */
194
+ async function chatFor(ctx, line, contact, call) {
195
+ const thread = `voice-${(await sha256(`voice:${call._id}`)).slice(0, 32)}`;
196
+ await ctx.as().call("contact.chat", {
197
+ contact,
198
+ in: line.in,
199
+ thread,
200
+ ...(line.agent ? { agent: line.agent } : {}),
201
+ });
202
+ return thread;
203
+ }
204
+ export const heardAction = defineAction({
205
+ description: "A caller cut an answer short: what they heard of it",
206
+ input: {
207
+ type: "object",
208
+ properties: {
209
+ call: { type: "string" },
210
+ message: { type: "string" },
211
+ heard: { type: "string" },
212
+ },
213
+ required: ["call", "message", "heard"],
214
+ additionalProperties: false,
215
+ },
216
+ record: false,
217
+ run: async (ctx, input) => {
218
+ await calls(ctx).updateOne({ _id: input.call, state: "live" }, {
219
+ $set: { cut: { message: input.message, heard: input.heard.slice(0, 1_000) } },
220
+ });
221
+ },
222
+ });
223
+ export const overAction = defineAction({
224
+ description: "A call ended, and why",
225
+ input: {
226
+ type: "object",
227
+ properties: {
228
+ call: { type: "string" },
229
+ reason: { type: "string", maxLength: 20 },
230
+ },
231
+ required: ["call", "reason"],
232
+ additionalProperties: false,
233
+ },
234
+ record: false,
235
+ run: async (ctx, input) => {
236
+ const found = await calls(ctx).findOne({ _id: input.call });
237
+ if (!found || found.state === "over")
238
+ return;
239
+ const now = new Date();
240
+ await calls(ctx).updateOne({ _id: input.call }, {
241
+ $set: {
242
+ state: "over",
243
+ over: now.toISOString(),
244
+ reason: input.reason,
245
+ ...(found.started
246
+ ? { seconds: Math.round((now.getTime() - Date.parse(found.started)) / 1000) }
247
+ : {}),
248
+ },
249
+ // What they heard of a cut answer was for the call's own turns.
250
+ $unset: { ticket: "", cut: "" },
251
+ });
252
+ },
253
+ });
@@ -0,0 +1,5 @@
1
+ /** How long a socket's ticket works, once given. */
2
+ export declare const TICKET_MS = 60000;
3
+ export declare const hookAction: import("../../../../runtime/define.js").ActionDef;
4
+ /** SHA-256 of a text, in hex. */
5
+ export declare const sha256: (text: string) => Promise<string>;
@@ -0,0 +1,225 @@
1
+ /**
2
+ * `voice.hook`: Twilio's webhook for a line the app declares, at
3
+ * `/hooks/voice/<line>` (the web host's `routes` resource).
4
+ *
5
+ * - **A call comes in** (`POST /hooks/voice/<line>`): before anything else,
6
+ * Twilio's signature (`X-Twilio-Signature`) is checked with the line's auth
7
+ * token, and the call must be an inbound one to the line's account. A
8
+ * caller the line's people blocked (`voice.block`) isn't taken. Then it's
9
+ * taken only within its caller's limits (`callerAtOnce`, 1; `callerPerDay`,
10
+ * 10; hidden numbers, together, their own: `hiddenAtOnce`, `hiddenPerDay`),
11
+ * then the line's (`atOnce`, 2;
12
+ * `perDay`, 50 calls that went on in the last 24 hours); else Twilio is
13
+ * told to reject it as busy (a busy tone, and nothing is spent). Whether
14
+ * Twilio verified the number (`StirVerstat`) is noted on the call. A call
15
+ * taken is told to open the line's socket (TwiML `<Connect>` with
16
+ * `<ConversationRelay>`), with a ticket good for one use, for a minute;
17
+ * the greeting, language and voice are the line's. Twilio asking again
18
+ * for the same call gets a new ticket, and the old one stops working.
19
+ * - **Its relay is over** (`POST /hooks/voice/<line>/over`, the `<Connect>`'s
20
+ * `action`): what Twilio says about it is noted on the call, which is
21
+ * over, and Twilio is told to hang up.
22
+ *
23
+ * Anyone may call it (it answers as a visitor); what isn't signed by the
24
+ * line's account changes nothing. It isn't recorded: the ticket stays out
25
+ * of the log.
26
+ */
27
+ import { defineAction } from "../../../../runtime/mod.js";
28
+ import { HOOKS, lineOf } from "../shared/settings.js";
29
+ import { signed } from "../shared/signature.js";
30
+ import { blockedKey, callerKey, VERIFIED } from "../shared/caller.js";
31
+ /** A request as the web host hands it to a route's Action (hosts/web/routes.ts' `httpRequest`). */
32
+ const httpRequest = {
33
+ type: "object",
34
+ properties: {
35
+ method: { type: "string" },
36
+ path: { type: "string" },
37
+ query: { type: "object", additionalProperties: { type: "string" } },
38
+ headers: { type: "object", additionalProperties: { type: "string" } },
39
+ body: { type: "string" },
40
+ base64: { type: "boolean", const: true },
41
+ },
42
+ required: ["method", "path", "query", "headers"],
43
+ additionalProperties: false,
44
+ };
45
+ /** How long a socket's ticket works, once given. */
46
+ export const TICKET_MS = 60_000;
47
+ const DAY = 86_400_000;
48
+ const plain = (status, body) => ({ status, body });
49
+ const twiml = (body) => ({
50
+ headers: { "content-type": "text/xml; charset=utf-8", "cache-control": "no-store" },
51
+ body: `<?xml version="1.0" encoding="UTF-8"?><Response>${body}</Response>`,
52
+ });
53
+ const BUSY = twiml('<Reject reason="busy"/>');
54
+ /** Text as an XML attribute's value. */
55
+ const xml = (text) => text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;")
56
+ .replaceAll('"', "&quot;").replaceAll("'", "&apos;");
57
+ export const hookAction = defineAction({
58
+ description: "Twilio's webhook for a phone line the app declares",
59
+ input: httpRequest,
60
+ record: false,
61
+ allow: () => true,
62
+ run: async (ctx, request) => {
63
+ const [name = "", what = "", ...more] = request.path.slice(HOOKS.length).split("/");
64
+ const line = request.path.startsWith(HOOKS) && !more.length
65
+ ? lineOf(ctx, decoded(name))
66
+ : undefined;
67
+ if (!line || !["", "over"].includes(what))
68
+ return plain(404, "No such line");
69
+ if (request.method !== "POST")
70
+ return plain(405, "POST");
71
+ if (!/^application\/x-www-form-urlencoded/i.test(request.headers["content-type"] ?? "")) {
72
+ return plain(415, "A form");
73
+ }
74
+ const form = new URLSearchParams(request.body ?? "");
75
+ // Twilio signs the URL it asked for: the line's public address, the path, the query as it came.
76
+ const query = new URLSearchParams(request.query).toString();
77
+ const url = `${new URL(line.origin).origin}${request.path}${query ? `?${query}` : ""}`;
78
+ if (!await signed(line.token, request.headers["x-twilio-signature"], url, form)) {
79
+ return plain(401, "Bad signature");
80
+ }
81
+ const call = form.get("CallSid") ?? "";
82
+ if (form.get("AccountSid") !== line.account || !/^CA[0-9a-f]{32}$/i.test(call)) {
83
+ return plain(403, "Not this line's call");
84
+ }
85
+ if (what === "over")
86
+ return await over(ctx, call, form);
87
+ if (form.get("Direction") !== "inbound")
88
+ return plain(403, "Calls to the line only");
89
+ return await taken(ctx, line, call, form);
90
+ },
91
+ });
92
+ /** A path's part, decoded; a malformed one names nothing. */
93
+ const decoded = (part) => {
94
+ try {
95
+ return decodeURIComponent(part);
96
+ }
97
+ catch {
98
+ return "";
99
+ }
100
+ };
101
+ /** Whether a caller is blocked on a line now (a block past its `until` is over). */
102
+ async function blockedNow(ctx, line, from, now) {
103
+ const block = await ctx.as().db.collection("voice_blocked")
104
+ .findOne({ key: await blockedKey(line, from) });
105
+ return !!block && (!block.until || Date.parse(block.until) > now);
106
+ }
107
+ /**
108
+ * A call coming in: taken unless its caller is blocked, and within its
109
+ * caller's limits and then the line's, with a ticket for its socket; else
110
+ * Twilio rejects it as busy. A day's calls are those that went on (a call
111
+ * never answered costs nothing); calls at once, those holding a place.
112
+ */
113
+ async function taken(ctx, line, id, form) {
114
+ const secret = randomText(24);
115
+ const ticket = `${id}.${secret}`;
116
+ const hash = await sha256(secret);
117
+ const now = Date.now();
118
+ const at = new Date(now).toISOString();
119
+ const until = new Date(now + TICKET_MS).toISOString();
120
+ const from = form.get("From") ?? "";
121
+ const caller = callerKey(from);
122
+ const system = ctx.as();
123
+ if (await blockedNow(ctx, line.name, from, now))
124
+ return BUSY;
125
+ // One transaction: the owner writes one at a time, so two calls can't both take the last place.
126
+ const took = await system.transaction(async (tx) => {
127
+ const calls = tx.db.collection("voice_call");
128
+ const recent = await calls.find({
129
+ line: line.name,
130
+ at: { $gt: new Date(now - DAY).toISOString() },
131
+ });
132
+ const again = recent.find((c) => c._id === id);
133
+ if (again) {
134
+ // Twilio asking again (its request timed out): a new ticket, while the call isn't on yet.
135
+ if (again.state !== "ringing")
136
+ return false;
137
+ await calls.updateOne({ _id: id }, { $set: { ticket: hash, until } });
138
+ return true;
139
+ }
140
+ const holding = (c) => c.state !== "over" && Date.parse(c.until) > now;
141
+ const theirs = recent.filter((c) => callerKey(c.from) === caller);
142
+ const { limits } = line;
143
+ // Hidden numbers, together, have an allowance of their own: one caller's would lock them all out.
144
+ const hidden = caller === "hidden";
145
+ if (theirs.filter(holding).length >= (hidden ? limits.hiddenAtOnce : limits.callerAtOnce) ||
146
+ theirs.filter((c) => c.started).length >=
147
+ (hidden ? limits.hiddenPerDay : limits.callerPerDay) ||
148
+ recent.filter(holding).length >= limits.atOnce ||
149
+ recent.filter((c) => c.started).length >= limits.perDay)
150
+ return false;
151
+ await calls.insertOne({
152
+ _id: id,
153
+ line: line.name,
154
+ in: line.in,
155
+ ...(from ? { from } : {}),
156
+ to: form.get("To") ?? "",
157
+ ...(form.get("StirVerstat") === VERIFIED ? { verified: true } : {}),
158
+ state: "ringing",
159
+ ticket: hash,
160
+ until,
161
+ at,
162
+ });
163
+ return true;
164
+ });
165
+ if (!took)
166
+ return BUSY;
167
+ const relay = new URL(line.urls.relay);
168
+ relay.searchParams.set("ticket", ticket);
169
+ const attributes = {
170
+ url: relay.toString(),
171
+ language: line.language,
172
+ welcomeGreeting: line.texts.greeting || undefined,
173
+ ttsProvider: line.tts,
174
+ voice: line.voice,
175
+ transcriptionProvider: line.stt,
176
+ dtmfDetection: line.keys ? "true" : undefined,
177
+ };
178
+ const said = Object.entries(attributes).filter(([, value]) => value !== undefined)
179
+ .map(([key, value]) => `${key}="${xml(value)}"`).join(" ");
180
+ return twiml(`<Connect action="${xml(line.urls.over)}"><ConversationRelay ${said}/></Connect>`);
181
+ }
182
+ /** A call's relay is over, as Twilio says: noted on the call, which ends; Twilio hangs up. */
183
+ async function over(ctx, id, form) {
184
+ const calls = ctx.as().db.collection("voice_call");
185
+ const found = await calls.findOne({ _id: id });
186
+ if (found) {
187
+ const status = form.get("SessionStatus") ?? form.get("CallStatus") ?? "";
188
+ const error = form.get("ErrorCode") ?? "";
189
+ let reason = "hangup";
190
+ try {
191
+ const handed = JSON.parse(form.get("HandoffData") ?? "{}");
192
+ if (typeof handed?.reason === "string")
193
+ reason = handed.reason.slice(0, 20);
194
+ }
195
+ catch {
196
+ // Not ours: it was over all the same.
197
+ }
198
+ const twilio = {
199
+ ...(status ? { status: status.slice(0, 40) } : {}),
200
+ ...(error ? { error: error.slice(0, 40) } : {}),
201
+ };
202
+ const now = new Date();
203
+ await calls.updateOne({ _id: id }, {
204
+ $set: {
205
+ ...(Object.keys(twilio).length ? { twilio } : {}),
206
+ ...(found.state === "over" ? {} : {
207
+ state: "over",
208
+ over: now.toISOString(),
209
+ reason: status === "failed" ? "error" : reason,
210
+ ...(found.started
211
+ ? { seconds: Math.round((now.getTime() - Date.parse(found.started)) / 1000) }
212
+ : {}),
213
+ }),
214
+ },
215
+ $unset: { ticket: "" },
216
+ });
217
+ }
218
+ return twiml("<Hangup/>");
219
+ }
220
+ /** `n` random bytes, as URL-safe text. */
221
+ const randomText = (n) => btoa(String.fromCharCode(...crypto.getRandomValues(new Uint8Array(n))))
222
+ .replaceAll("+", "-").replaceAll("/", "_").replaceAll("=", "");
223
+ /** SHA-256 of a text, in hex. */
224
+ export const sha256 = async (text) => [...new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(text)))]
225
+ .map((b) => b.toString(16).padStart(2, "0")).join("");
@@ -0,0 +1 @@
1
+ export declare const pruneAction: import("../../../../runtime/define.js").ActionDef;
@@ -0,0 +1,35 @@
1
+ /**
2
+ * `voice.prune`: what's kept of calls goes after the plugin's `keep` days
3
+ * (30, and 1 at least): each call's record that's over, erased, or no longer
4
+ * holding a place (a call can't go on past it), with the number it had; and
5
+ * a caller's link to their contact (`voice_phone`) when they haven't called
6
+ * since. A call going on is never pruned. Time calls it, every day (the
7
+ * plugin's `schedules`). Blocks stay until lifted, or their `until`.
8
+ */
9
+ import { defineAction } from "../../../../runtime/mod.js";
10
+ import { keepOf } from "../shared/settings.js";
11
+ export const pruneAction = defineAction({
12
+ description: "Removes calls' records older than the plugin's `keep` days, once they're over",
13
+ input: { type: "object", additionalProperties: false },
14
+ run: async (ctx) => {
15
+ const now = Date.now();
16
+ const before = new Date(now - keepOf(ctx) * 86_400_000).toISOString();
17
+ const system = ctx.as();
18
+ let pruned = 0;
19
+ await system.transaction(async (tx) => {
20
+ ({ deletedCount: pruned } = await tx.db.collection("voice_call").deleteMany({
21
+ at: { $lt: before },
22
+ $or: [
23
+ { state: "over" },
24
+ { erased: true },
25
+ { until: { $lt: new Date(now).toISOString() } },
26
+ ],
27
+ }));
28
+ await tx.db.collection("voice_phone").deleteMany({ at: { $lt: before } });
29
+ await tx.db.collection("voice_blocked").deleteMany({
30
+ until: { $lt: new Date(now).toISOString() },
31
+ });
32
+ });
33
+ return { pruned };
34
+ },
35
+ });
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Callers a line's people blocked (`voice.block`), each block by an id of
3
+ * its own (`b-…`): the line, its space, the chat it was made from, until
4
+ * when (none: until lifted, `voice.unblock`), and the caller's key (`key`: a
5
+ * hash of their number, with the line; see shared/caller.ts), which is how
6
+ * their calls are found and rejected as busy, before they're answered. Kept
7
+ * apart from the calls, so erasing a contact (`contact.forget`), or a call's
8
+ * record going, doesn't let them in again, nor keeps a block from being
9
+ * lifted. Blocking a caller whose number was hidden blocks every hidden
10
+ * number on the line.
11
+ *
12
+ * The space's members read its blocks (the spaces plugin's `shared`), never
13
+ * their key (private): a hash anyone could match to a number by trying them
14
+ * all. Only its managers change them. No events.
15
+ */
16
+ import { type Infer } from "../../../../runtime/mod.js";
17
+ declare const blockSchema: {
18
+ readonly type: "object";
19
+ readonly properties: {
20
+ readonly line: {
21
+ readonly type: "string";
22
+ };
23
+ readonly in: {
24
+ readonly type: "string";
25
+ };
26
+ readonly thread: {
27
+ readonly type: "string";
28
+ };
29
+ readonly key: {
30
+ readonly type: "string";
31
+ };
32
+ readonly until: {
33
+ readonly type: "string";
34
+ };
35
+ readonly at: {
36
+ readonly type: "string";
37
+ };
38
+ };
39
+ readonly required: readonly ["line", "in", "key", "at"];
40
+ };
41
+ export declare const blocked: {
42
+ schema: {
43
+ readonly type: "object";
44
+ readonly properties: {
45
+ readonly line: {
46
+ readonly type: "string";
47
+ };
48
+ readonly in: {
49
+ readonly type: "string";
50
+ };
51
+ readonly thread: {
52
+ readonly type: "string";
53
+ };
54
+ readonly key: {
55
+ readonly type: "string";
56
+ };
57
+ readonly until: {
58
+ readonly type: "string";
59
+ };
60
+ readonly at: {
61
+ readonly type: "string";
62
+ };
63
+ };
64
+ readonly required: readonly ["line", "in", "key", "at"];
65
+ };
66
+ events?: boolean;
67
+ records?: boolean;
68
+ durable?: false;
69
+ indexes?: string[][];
70
+ private?: string[];
71
+ queries?: Record<string, import("../../../../runtime/define.js").QueryDef<{
72
+ [x: string]: unknown;
73
+ until?: string | undefined;
74
+ thread?: string | undefined;
75
+ at: string;
76
+ key: string;
77
+ in: string;
78
+ line: string;
79
+ } & {
80
+ _id: string;
81
+ }>> | undefined;
82
+ vectors?: string[];
83
+ };
84
+ export type VoiceBlock = Infer<typeof blockSchema> & {
85
+ _id: string;
86
+ };
87
+ export {};
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Callers a line's people blocked (`voice.block`), each block by an id of
3
+ * its own (`b-…`): the line, its space, the chat it was made from, until
4
+ * when (none: until lifted, `voice.unblock`), and the caller's key (`key`: a
5
+ * hash of their number, with the line; see shared/caller.ts), which is how
6
+ * their calls are found and rejected as busy, before they're answered. Kept
7
+ * apart from the calls, so erasing a contact (`contact.forget`), or a call's
8
+ * record going, doesn't let them in again, nor keeps a block from being
9
+ * lifted. Blocking a caller whose number was hidden blocks every hidden
10
+ * number on the line.
11
+ *
12
+ * The space's members read its blocks (the spaces plugin's `shared`), never
13
+ * their key (private): a hash anyone could match to a number by trying them
14
+ * all. Only its managers change them. No events.
15
+ */
16
+ import { defineCollection } from "../../../../runtime/mod.js";
17
+ const blockSchema = {
18
+ type: "object",
19
+ properties: {
20
+ line: { type: "string" },
21
+ in: { type: "string" },
22
+ thread: { type: "string" },
23
+ key: { type: "string" },
24
+ until: { type: "string" },
25
+ at: { type: "string" },
26
+ },
27
+ required: ["line", "in", "key", "at"],
28
+ };
29
+ export const blocked = defineCollection({
30
+ schema: blockSchema,
31
+ events: false,
32
+ private: ["key"],
33
+ indexes: [["key"]],
34
+ });