@rox-one/sdk 0.0.0-stage → 0.7.1

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 (483) hide show
  1. package/CALLS.md +82 -0
  2. package/README.md +1259 -2
  3. package/dist/chunk-AOHK5YXC.js +5585 -0
  4. package/dist/chunk-CATFKTFD.js +80 -0
  5. package/dist/chunk-FQGPXWPJ.js +1491 -0
  6. package/dist/chunk-G43PLP2U.js +1087 -0
  7. package/dist/chunk-LMJW65ML.js +836 -0
  8. package/dist/chunk-MCSQNZ4E.js +836 -0
  9. package/dist/chunk-NSJ3GKUC.js +1552 -0
  10. package/dist/chunk-OGFKJOK7.js +2068 -0
  11. package/dist/chunk-RDEJZJBZ.js +1351 -0
  12. package/dist/chunk-TMTYN2UK.js +1128 -0
  13. package/dist/chunk-V45LUJDI.js +838 -0
  14. package/dist/chunk-YRUXFEZM.js +1044 -0
  15. package/dist/chunk-ZYBAKW25.js +994 -0
  16. package/dist/generated/agent-fold/index.d.ts +4520 -0
  17. package/dist/generated/agent-fold/index.js +0 -0
  18. package/dist/generated/agent-harness/client/client.gen.d.ts +2 -0
  19. package/dist/generated/agent-harness/client/index.d.ts +10 -0
  20. package/dist/generated/agent-harness/client/types.gen.d.ts +120 -0
  21. package/dist/generated/agent-harness/client/utils.gen.d.ts +37 -0
  22. package/dist/generated/agent-harness/client.gen.d.ts +12 -0
  23. package/dist/generated/agent-harness/core/auth.gen.d.ts +25 -0
  24. package/dist/generated/agent-harness/core/bodySerializer.gen.d.ts +25 -0
  25. package/dist/generated/agent-harness/core/params.gen.d.ts +43 -0
  26. package/dist/generated/agent-harness/core/pathSerializer.gen.d.ts +33 -0
  27. package/dist/generated/agent-harness/core/queryKeySerializer.gen.d.ts +18 -0
  28. package/dist/generated/agent-harness/core/serverSentEvents.gen.d.ts +71 -0
  29. package/dist/generated/agent-harness/core/types.gen.d.ts +83 -0
  30. package/dist/generated/agent-harness/core/utils.gen.d.ts +19 -0
  31. package/dist/generated/agent-harness/index.d.ts +2 -0
  32. package/dist/generated/agent-harness/index.js +6 -0
  33. package/dist/generated/agent-harness/sdk.gen.d.ts +375 -0
  34. package/dist/generated/agent-harness/types.gen.d.ts +4725 -0
  35. package/dist/generated/agent-reviews/index.d.ts +895 -0
  36. package/dist/generated/agent-reviews/index.js +0 -0
  37. package/dist/generated/auth/client/client.gen.d.ts +2 -0
  38. package/dist/generated/auth/client/index.d.ts +10 -0
  39. package/dist/generated/auth/client/types.gen.d.ts +120 -0
  40. package/dist/generated/auth/client/utils.gen.d.ts +37 -0
  41. package/dist/generated/auth/client.gen.d.ts +12 -0
  42. package/dist/generated/auth/core/auth.gen.d.ts +25 -0
  43. package/dist/generated/auth/core/bodySerializer.gen.d.ts +25 -0
  44. package/dist/generated/auth/core/params.gen.d.ts +43 -0
  45. package/dist/generated/auth/core/pathSerializer.gen.d.ts +33 -0
  46. package/dist/generated/auth/core/queryKeySerializer.gen.d.ts +18 -0
  47. package/dist/generated/auth/core/serverSentEvents.gen.d.ts +71 -0
  48. package/dist/generated/auth/core/types.gen.d.ts +83 -0
  49. package/dist/generated/auth/core/utils.gen.d.ts +19 -0
  50. package/dist/generated/auth/index.d.ts +2 -0
  51. package/dist/generated/auth/index.js +6 -0
  52. package/dist/generated/auth/sdk.gen.d.ts +674 -0
  53. package/dist/generated/auth/types.gen.d.ts +5233 -0
  54. package/dist/generated/calendar/client/client.gen.d.ts +2 -0
  55. package/dist/generated/calendar/client/index.d.ts +10 -0
  56. package/dist/generated/calendar/client/types.gen.d.ts +120 -0
  57. package/dist/generated/calendar/client/utils.gen.d.ts +37 -0
  58. package/dist/generated/calendar/client.gen.d.ts +12 -0
  59. package/dist/generated/calendar/core/auth.gen.d.ts +25 -0
  60. package/dist/generated/calendar/core/bodySerializer.gen.d.ts +25 -0
  61. package/dist/generated/calendar/core/params.gen.d.ts +43 -0
  62. package/dist/generated/calendar/core/pathSerializer.gen.d.ts +33 -0
  63. package/dist/generated/calendar/core/queryKeySerializer.gen.d.ts +18 -0
  64. package/dist/generated/calendar/core/serverSentEvents.gen.d.ts +71 -0
  65. package/dist/generated/calendar/core/types.gen.d.ts +83 -0
  66. package/dist/generated/calendar/core/utils.gen.d.ts +19 -0
  67. package/dist/generated/calendar/index.d.ts +2 -0
  68. package/dist/generated/calendar/index.js +6 -0
  69. package/dist/generated/calendar/sdk.gen.d.ts +157 -0
  70. package/dist/generated/calendar/types.gen.d.ts +2333 -0
  71. package/dist/generated/cognition/client/client.gen.d.ts +2 -0
  72. package/dist/generated/cognition/client/index.d.ts +10 -0
  73. package/dist/generated/cognition/client/types.gen.d.ts +120 -0
  74. package/dist/generated/cognition/client/utils.gen.d.ts +37 -0
  75. package/dist/generated/cognition/client.gen.d.ts +12 -0
  76. package/dist/generated/cognition/core/auth.gen.d.ts +25 -0
  77. package/dist/generated/cognition/core/bodySerializer.gen.d.ts +25 -0
  78. package/dist/generated/cognition/core/params.gen.d.ts +43 -0
  79. package/dist/generated/cognition/core/pathSerializer.gen.d.ts +33 -0
  80. package/dist/generated/cognition/core/queryKeySerializer.gen.d.ts +18 -0
  81. package/dist/generated/cognition/core/serverSentEvents.gen.d.ts +71 -0
  82. package/dist/generated/cognition/core/types.gen.d.ts +83 -0
  83. package/dist/generated/cognition/core/utils.gen.d.ts +19 -0
  84. package/dist/generated/cognition/index.d.ts +2 -0
  85. package/dist/generated/cognition/index.js +6 -0
  86. package/dist/generated/cognition/sdk.gen.d.ts +348 -0
  87. package/dist/generated/cognition/types.gen.d.ts +4228 -0
  88. package/dist/generated/connection/client/client.gen.d.ts +2 -0
  89. package/dist/generated/connection/client/index.d.ts +10 -0
  90. package/dist/generated/connection/client/types.gen.d.ts +120 -0
  91. package/dist/generated/connection/client/utils.gen.d.ts +37 -0
  92. package/dist/generated/connection/client.gen.d.ts +12 -0
  93. package/dist/generated/connection/core/auth.gen.d.ts +25 -0
  94. package/dist/generated/connection/core/bodySerializer.gen.d.ts +25 -0
  95. package/dist/generated/connection/core/params.gen.d.ts +43 -0
  96. package/dist/generated/connection/core/pathSerializer.gen.d.ts +33 -0
  97. package/dist/generated/connection/core/queryKeySerializer.gen.d.ts +18 -0
  98. package/dist/generated/connection/core/serverSentEvents.gen.d.ts +71 -0
  99. package/dist/generated/connection/core/types.gen.d.ts +83 -0
  100. package/dist/generated/connection/core/utils.gen.d.ts +19 -0
  101. package/dist/generated/connection/index.d.ts +2 -0
  102. package/dist/generated/connection/index.js +854 -0
  103. package/dist/generated/connection/sdk.gen.d.ts +43 -0
  104. package/dist/generated/connection/types.gen.d.ts +252 -0
  105. package/dist/generated/contacts/client/client.gen.d.ts +2 -0
  106. package/dist/generated/contacts/client/index.d.ts +10 -0
  107. package/dist/generated/contacts/client/types.gen.d.ts +120 -0
  108. package/dist/generated/contacts/client/utils.gen.d.ts +37 -0
  109. package/dist/generated/contacts/client.gen.d.ts +12 -0
  110. package/dist/generated/contacts/core/auth.gen.d.ts +25 -0
  111. package/dist/generated/contacts/core/bodySerializer.gen.d.ts +25 -0
  112. package/dist/generated/contacts/core/params.gen.d.ts +43 -0
  113. package/dist/generated/contacts/core/pathSerializer.gen.d.ts +33 -0
  114. package/dist/generated/contacts/core/queryKeySerializer.gen.d.ts +18 -0
  115. package/dist/generated/contacts/core/serverSentEvents.gen.d.ts +71 -0
  116. package/dist/generated/contacts/core/types.gen.d.ts +83 -0
  117. package/dist/generated/contacts/core/utils.gen.d.ts +19 -0
  118. package/dist/generated/contacts/index.d.ts +2 -0
  119. package/dist/generated/contacts/index.js +6 -0
  120. package/dist/generated/contacts/sdk.gen.d.ts +47 -0
  121. package/dist/generated/contacts/types.gen.d.ts +108 -0
  122. package/dist/generated/email/client/client.gen.d.ts +2 -0
  123. package/dist/generated/email/client/index.d.ts +10 -0
  124. package/dist/generated/email/client/types.gen.d.ts +120 -0
  125. package/dist/generated/email/client/utils.gen.d.ts +37 -0
  126. package/dist/generated/email/client.gen.d.ts +12 -0
  127. package/dist/generated/email/core/auth.gen.d.ts +25 -0
  128. package/dist/generated/email/core/bodySerializer.gen.d.ts +25 -0
  129. package/dist/generated/email/core/params.gen.d.ts +43 -0
  130. package/dist/generated/email/core/pathSerializer.gen.d.ts +33 -0
  131. package/dist/generated/email/core/queryKeySerializer.gen.d.ts +18 -0
  132. package/dist/generated/email/core/serverSentEvents.gen.d.ts +71 -0
  133. package/dist/generated/email/core/types.gen.d.ts +83 -0
  134. package/dist/generated/email/core/utils.gen.d.ts +19 -0
  135. package/dist/generated/email/index.d.ts +2 -0
  136. package/dist/generated/email/index.js +6 -0
  137. package/dist/generated/email/sdk.gen.d.ts +301 -0
  138. package/dist/generated/email/types.gen.d.ts +3262 -0
  139. package/dist/generated/notification/client/client.gen.d.ts +2 -0
  140. package/dist/generated/notification/client/index.d.ts +10 -0
  141. package/dist/generated/notification/client/types.gen.d.ts +120 -0
  142. package/dist/generated/notification/client/utils.gen.d.ts +37 -0
  143. package/dist/generated/notification/client.gen.d.ts +12 -0
  144. package/dist/generated/notification/core/auth.gen.d.ts +25 -0
  145. package/dist/generated/notification/core/bodySerializer.gen.d.ts +25 -0
  146. package/dist/generated/notification/core/params.gen.d.ts +43 -0
  147. package/dist/generated/notification/core/pathSerializer.gen.d.ts +33 -0
  148. package/dist/generated/notification/core/queryKeySerializer.gen.d.ts +18 -0
  149. package/dist/generated/notification/core/serverSentEvents.gen.d.ts +71 -0
  150. package/dist/generated/notification/core/types.gen.d.ts +83 -0
  151. package/dist/generated/notification/core/utils.gen.d.ts +19 -0
  152. package/dist/generated/notification/index.d.ts +2 -0
  153. package/dist/generated/notification/index.js +6 -0
  154. package/dist/generated/notification/sdk.gen.d.ts +127 -0
  155. package/dist/generated/notification/types.gen.d.ts +2084 -0
  156. package/dist/generated/properties/client/client.gen.d.ts +2 -0
  157. package/dist/generated/properties/client/index.d.ts +10 -0
  158. package/dist/generated/properties/client/types.gen.d.ts +120 -0
  159. package/dist/generated/properties/client/utils.gen.d.ts +37 -0
  160. package/dist/generated/properties/client.gen.d.ts +12 -0
  161. package/dist/generated/properties/core/auth.gen.d.ts +25 -0
  162. package/dist/generated/properties/core/bodySerializer.gen.d.ts +25 -0
  163. package/dist/generated/properties/core/params.gen.d.ts +43 -0
  164. package/dist/generated/properties/core/pathSerializer.gen.d.ts +33 -0
  165. package/dist/generated/properties/core/queryKeySerializer.gen.d.ts +18 -0
  166. package/dist/generated/properties/core/serverSentEvents.gen.d.ts +71 -0
  167. package/dist/generated/properties/core/types.gen.d.ts +83 -0
  168. package/dist/generated/properties/core/utils.gen.d.ts +19 -0
  169. package/dist/generated/properties/index.d.ts +2 -0
  170. package/dist/generated/properties/index.js +6 -0
  171. package/dist/generated/properties/sdk.gen.d.ts +158 -0
  172. package/dist/generated/properties/types.gen.d.ts +1311 -0
  173. package/dist/generated/scheduled-action/client/client.gen.d.ts +2 -0
  174. package/dist/generated/scheduled-action/client/index.d.ts +10 -0
  175. package/dist/generated/scheduled-action/client/types.gen.d.ts +120 -0
  176. package/dist/generated/scheduled-action/client/utils.gen.d.ts +37 -0
  177. package/dist/generated/scheduled-action/client.gen.d.ts +12 -0
  178. package/dist/generated/scheduled-action/core/auth.gen.d.ts +25 -0
  179. package/dist/generated/scheduled-action/core/bodySerializer.gen.d.ts +25 -0
  180. package/dist/generated/scheduled-action/core/params.gen.d.ts +43 -0
  181. package/dist/generated/scheduled-action/core/pathSerializer.gen.d.ts +33 -0
  182. package/dist/generated/scheduled-action/core/queryKeySerializer.gen.d.ts +18 -0
  183. package/dist/generated/scheduled-action/core/serverSentEvents.gen.d.ts +71 -0
  184. package/dist/generated/scheduled-action/core/types.gen.d.ts +83 -0
  185. package/dist/generated/scheduled-action/core/utils.gen.d.ts +19 -0
  186. package/dist/generated/scheduled-action/index.d.ts +2 -0
  187. package/dist/generated/scheduled-action/index.js +6 -0
  188. package/dist/generated/scheduled-action/sdk.gen.d.ts +156 -0
  189. package/dist/generated/scheduled-action/types.gen.d.ts +3099 -0
  190. package/dist/generated/search/client/client.gen.d.ts +2 -0
  191. package/dist/generated/search/client/index.d.ts +10 -0
  192. package/dist/generated/search/client/types.gen.d.ts +120 -0
  193. package/dist/generated/search/client/utils.gen.d.ts +37 -0
  194. package/dist/generated/search/client.gen.d.ts +12 -0
  195. package/dist/generated/search/core/auth.gen.d.ts +25 -0
  196. package/dist/generated/search/core/bodySerializer.gen.d.ts +25 -0
  197. package/dist/generated/search/core/params.gen.d.ts +43 -0
  198. package/dist/generated/search/core/pathSerializer.gen.d.ts +33 -0
  199. package/dist/generated/search/core/queryKeySerializer.gen.d.ts +18 -0
  200. package/dist/generated/search/core/serverSentEvents.gen.d.ts +71 -0
  201. package/dist/generated/search/core/types.gen.d.ts +83 -0
  202. package/dist/generated/search/core/utils.gen.d.ts +19 -0
  203. package/dist/generated/search/index.d.ts +2 -0
  204. package/dist/generated/search/index.js +6 -0
  205. package/dist/generated/search/sdk.gen.d.ts +44 -0
  206. package/dist/generated/search/types.gen.d.ts +2532 -0
  207. package/dist/generated/static-files/client/client.gen.d.ts +2 -0
  208. package/dist/generated/static-files/client/index.d.ts +10 -0
  209. package/dist/generated/static-files/client/types.gen.d.ts +120 -0
  210. package/dist/generated/static-files/client/utils.gen.d.ts +37 -0
  211. package/dist/generated/static-files/client.gen.d.ts +12 -0
  212. package/dist/generated/static-files/core/auth.gen.d.ts +25 -0
  213. package/dist/generated/static-files/core/bodySerializer.gen.d.ts +25 -0
  214. package/dist/generated/static-files/core/params.gen.d.ts +43 -0
  215. package/dist/generated/static-files/core/pathSerializer.gen.d.ts +33 -0
  216. package/dist/generated/static-files/core/queryKeySerializer.gen.d.ts +18 -0
  217. package/dist/generated/static-files/core/serverSentEvents.gen.d.ts +71 -0
  218. package/dist/generated/static-files/core/types.gen.d.ts +83 -0
  219. package/dist/generated/static-files/core/utils.gen.d.ts +19 -0
  220. package/dist/generated/static-files/index.d.ts +2 -0
  221. package/dist/generated/static-files/index.js +842 -0
  222. package/dist/generated/static-files/sdk.gen.d.ts +43 -0
  223. package/dist/generated/static-files/types.gen.d.ts +220 -0
  224. package/dist/generated/storage/client/client.gen.d.ts +2 -0
  225. package/dist/generated/storage/client/index.d.ts +10 -0
  226. package/dist/generated/storage/client/types.gen.d.ts +120 -0
  227. package/dist/generated/storage/client/utils.gen.d.ts +37 -0
  228. package/dist/generated/storage/client.gen.d.ts +12 -0
  229. package/dist/generated/storage/core/auth.gen.d.ts +25 -0
  230. package/dist/generated/storage/core/bodySerializer.gen.d.ts +25 -0
  231. package/dist/generated/storage/core/params.gen.d.ts +43 -0
  232. package/dist/generated/storage/core/pathSerializer.gen.d.ts +33 -0
  233. package/dist/generated/storage/core/queryKeySerializer.gen.d.ts +18 -0
  234. package/dist/generated/storage/core/serverSentEvents.gen.d.ts +71 -0
  235. package/dist/generated/storage/core/types.gen.d.ts +83 -0
  236. package/dist/generated/storage/core/utils.gen.d.ts +19 -0
  237. package/dist/generated/storage/index.d.ts +2 -0
  238. package/dist/generated/storage/index.js +6 -0
  239. package/dist/generated/storage/sdk.gen.d.ts +2285 -0
  240. package/dist/generated/storage/types.gen.d.ts +34546 -0
  241. package/dist/generated/unfurl/client/client.gen.d.ts +2 -0
  242. package/dist/generated/unfurl/client/index.d.ts +10 -0
  243. package/dist/generated/unfurl/client/types.gen.d.ts +120 -0
  244. package/dist/generated/unfurl/client/utils.gen.d.ts +37 -0
  245. package/dist/generated/unfurl/client.gen.d.ts +12 -0
  246. package/dist/generated/unfurl/core/auth.gen.d.ts +25 -0
  247. package/dist/generated/unfurl/core/bodySerializer.gen.d.ts +25 -0
  248. package/dist/generated/unfurl/core/params.gen.d.ts +43 -0
  249. package/dist/generated/unfurl/core/pathSerializer.gen.d.ts +33 -0
  250. package/dist/generated/unfurl/core/queryKeySerializer.gen.d.ts +18 -0
  251. package/dist/generated/unfurl/core/serverSentEvents.gen.d.ts +71 -0
  252. package/dist/generated/unfurl/core/types.gen.d.ts +83 -0
  253. package/dist/generated/unfurl/core/utils.gen.d.ts +19 -0
  254. package/dist/generated/unfurl/index.d.ts +2 -0
  255. package/dist/generated/unfurl/index.js +6 -0
  256. package/dist/generated/unfurl/sdk.gen.d.ts +47 -0
  257. package/dist/generated/unfurl/types.gen.d.ts +145 -0
  258. package/dist/src/calls/browser.d.ts +14 -0
  259. package/dist/src/calls/browser.js +102 -0
  260. package/dist/src/calls/common.d.ts +18 -0
  261. package/dist/src/calls/node.d.ts +24 -0
  262. package/dist/src/calls/node.js +145 -0
  263. package/dist/src/calls/telemetry.d.ts +5 -0
  264. package/dist/src/config.d.ts +71 -0
  265. package/dist/src/entities/account-managers/grant.d.ts +62 -0
  266. package/dist/src/entities/account-managers/namespace.d.ts +29 -0
  267. package/dist/src/entities/activity/entity.d.ts +7 -0
  268. package/dist/src/entities/activity/namespace.d.ts +58 -0
  269. package/dist/src/entities/activity/namespace.test.d.ts +1 -0
  270. package/dist/src/entities/agent-sessions/activity.d.ts +48 -0
  271. package/dist/src/entities/agent-sessions/agent-session.d.ts +518 -0
  272. package/dist/src/entities/agent-sessions/code-execution.d.ts +60 -0
  273. package/dist/src/entities/agent-sessions/conversation.d.ts +91 -0
  274. package/dist/src/entities/agent-sessions/namespace.d.ts +142 -0
  275. package/dist/src/entities/agent-sessions/origin.d.ts +94 -0
  276. package/dist/src/entities/agent-sessions/queued-action.d.ts +60 -0
  277. package/dist/src/entities/agent-sessions/review.d.ts +114 -0
  278. package/dist/src/entities/agent-sessions/tool-approval.d.ts +25 -0
  279. package/dist/src/entities/agent-sessions/view.d.ts +11 -0
  280. package/dist/src/entities/agents/agent.d.ts +142 -0
  281. package/dist/src/entities/agents/namespace.d.ts +66 -0
  282. package/dist/src/entities/ai/namespace.d.ts +36 -0
  283. package/dist/src/entities/api-keys/api-key.d.ts +22 -0
  284. package/dist/src/entities/api-keys/namespace.d.ts +37 -0
  285. package/dist/src/entities/bots/bot.d.ts +143 -0
  286. package/dist/src/entities/bots/namespace.d.ts +50 -0
  287. package/dist/src/entities/bots/token.d.ts +39 -0
  288. package/dist/src/entities/calendar/booking-link.d.ts +55 -0
  289. package/dist/src/entities/calendar/booking-namespace.d.ts +143 -0
  290. package/dist/src/entities/calendar/booking-namespace.test.d.ts +1 -0
  291. package/dist/src/entities/calendar/booking.d.ts +97 -0
  292. package/dist/src/entities/calendar/calendar.d.ts +49 -0
  293. package/dist/src/entities/calendar/create-confirmed.test.d.ts +1 -0
  294. package/dist/src/entities/calendar/event.d.ts +283 -0
  295. package/dist/src/entities/calendar/event.test.d.ts +1 -0
  296. package/dist/src/entities/calendar/namespace.d.ts +334 -0
  297. package/dist/src/entities/calendar/namespace.test.d.ts +1 -0
  298. package/dist/src/entities/calendar/replacement.d.ts +31 -0
  299. package/dist/src/entities/calls/call-record.d.ts +231 -0
  300. package/dist/src/entities/calls/connection.d.ts +59 -0
  301. package/dist/src/entities/calls/errors.d.ts +15 -0
  302. package/dist/src/entities/calls/message.d.ts +55 -0
  303. package/dist/src/entities/calls/namespace.d.ts +41 -0
  304. package/dist/src/entities/calls/participant.d.ts +22 -0
  305. package/dist/src/entities/canvases/canvas.d.ts +329 -0
  306. package/dist/src/entities/channels/access-request.d.ts +42 -0
  307. package/dist/src/entities/channels/activity.d.ts +40 -0
  308. package/dist/src/entities/channels/channel.d.ts +302 -0
  309. package/dist/src/entities/channels/labels.d.ts +73 -0
  310. package/dist/src/entities/channels/message.d.ts +153 -0
  311. package/dist/src/entities/channels/message.test.d.ts +1 -0
  312. package/dist/src/entities/channels/namespace.d.ts +82 -0
  313. package/dist/src/entities/channels/namespace.test.d.ts +1 -0
  314. package/dist/src/entities/channels/picture.d.ts +11 -0
  315. package/dist/src/entities/channels/post.d.ts +37 -0
  316. package/dist/src/entities/channels/post.test.d.ts +1 -0
  317. package/dist/src/entities/channels/share.d.ts +9 -0
  318. package/dist/src/entities/channels/share.test.d.ts +1 -0
  319. package/dist/src/entities/channels/thread.d.ts +64 -0
  320. package/dist/src/entities/chats/chat.d.ts +121 -0
  321. package/dist/src/entities/chats/generation.d.ts +55 -0
  322. package/dist/src/entities/chats/namespace.d.ts +35 -0
  323. package/dist/src/entities/connected-apps/connected-app.d.ts +121 -0
  324. package/dist/src/entities/connected-apps/connector.d.ts +59 -0
  325. package/dist/src/entities/connected-apps/namespace.d.ts +92 -0
  326. package/dist/src/entities/crm/company.d.ts +154 -0
  327. package/dist/src/entities/crm/contact.d.ts +168 -0
  328. package/dist/src/entities/crm/namespace.d.ts +163 -0
  329. package/dist/src/entities/crm/pipeline-entry.d.ts +109 -0
  330. package/dist/src/entities/crm/pipeline.d.ts +426 -0
  331. package/dist/src/entities/crm/pipelines.d.ts +79 -0
  332. package/dist/src/entities/crm-email-privacy/email-privacy.d.ts +238 -0
  333. package/dist/src/entities/crm-email-privacy/email-rule-preview.d.ts +55 -0
  334. package/dist/src/entities/crm-email-privacy/email-rule-revision.d.ts +27 -0
  335. package/dist/src/entities/crm-email-privacy/email-rules.d.ts +32 -0
  336. package/dist/src/entities/databases/column.d.ts +122 -0
  337. package/dist/src/entities/databases/database.d.ts +431 -0
  338. package/dist/src/entities/databases/namespace.d.ts +109 -0
  339. package/dist/src/entities/databases/query.d.ts +86 -0
  340. package/dist/src/entities/databases/row.d.ts +29 -0
  341. package/dist/src/entities/databases/saved-query.d.ts +151 -0
  342. package/dist/src/entities/databases/table.d.ts +124 -0
  343. package/dist/src/entities/databases/view.d.ts +72 -0
  344. package/dist/src/entities/databases/webhook.d.ts +39 -0
  345. package/dist/src/entities/documents/ai-edit.d.ts +54 -0
  346. package/dist/src/entities/documents/anchor.d.ts +39 -0
  347. package/dist/src/entities/documents/comment.d.ts +68 -0
  348. package/dist/src/entities/documents/create.test.d.ts +1 -0
  349. package/dist/src/entities/documents/document.d.ts +675 -0
  350. package/dist/src/entities/documents/markdown.d.ts +25 -0
  351. package/dist/src/entities/documents/namespace.d.ts +291 -0
  352. package/dist/src/entities/documents/office-files.d.ts +47 -0
  353. package/dist/src/entities/documents/skills.test.d.ts +1 -0
  354. package/dist/src/entities/documents/system-skill.d.ts +36 -0
  355. package/dist/src/entities/documents/text-comment.d.ts +41 -0
  356. package/dist/src/entities/documents/text-comment.test.d.ts +1 -0
  357. package/dist/src/entities/documents/version.d.ts +26 -0
  358. package/dist/src/entities/email/attachment.d.ts +39 -0
  359. package/dist/src/entities/email/body-rox-compat.d.ts +22 -0
  360. package/dist/src/entities/email/draft.d.ts +164 -0
  361. package/dist/src/entities/email/filter.d.ts +44 -0
  362. package/dist/src/entities/email/label.d.ts +37 -0
  363. package/dist/src/entities/email/link.d.ts +35 -0
  364. package/dist/src/entities/email/message.d.ts +223 -0
  365. package/dist/src/entities/email/namespace.d.ts +235 -0
  366. package/dist/src/entities/email/namespace.test.d.ts +1 -0
  367. package/dist/src/entities/email/thread.d.ts +268 -0
  368. package/dist/src/entities/entity-mentions/mention.d.ts +21 -0
  369. package/dist/src/entities/entity-mentions/namespace.d.ts +20 -0
  370. package/dist/src/entities/entity.d.ts +167 -0
  371. package/dist/src/entities/external-chat/chat.d.ts +173 -0
  372. package/dist/src/entities/external-chat/message.d.ts +54 -0
  373. package/dist/src/entities/external-chat/namespace.d.ts +22 -0
  374. package/dist/src/entities/external-chat/participant.d.ts +28 -0
  375. package/dist/src/entities/external-chat/send.d.ts +40 -0
  376. package/dist/src/entities/external-chat/upload.d.ts +25 -0
  377. package/dist/src/entities/favorites/namespace.d.ts +52 -0
  378. package/dist/src/entities/foreign/foreign-entity.d.ts +36 -0
  379. package/dist/src/entities/foreign/namespace.d.ts +54 -0
  380. package/dist/src/entities/forms/form.d.ts +319 -0
  381. package/dist/src/entities/forms/namespace.d.ts +30 -0
  382. package/dist/src/entities/forms/question.d.ts +65 -0
  383. package/dist/src/entities/forms/response.d.ts +52 -0
  384. package/dist/src/entities/forms/section.d.ts +31 -0
  385. package/dist/src/entities/github-pull-requests/namespace.d.ts +20 -0
  386. package/dist/src/entities/github-pull-requests/pull-request.d.ts +64 -0
  387. package/dist/src/entities/harnesses/harness.d.ts +76 -0
  388. package/dist/src/entities/harnesses/namespace.d.ts +83 -0
  389. package/dist/src/entities/harnesses/pairing.d.ts +50 -0
  390. package/dist/src/entities/images/image.d.ts +88 -0
  391. package/dist/src/entities/images/namespace.d.ts +55 -0
  392. package/dist/src/entities/images/namespace.test.d.ts +1 -0
  393. package/dist/src/entities/imports/entry.d.ts +65 -0
  394. package/dist/src/entities/imports/namespace.d.ts +103 -0
  395. package/dist/src/entities/imports/namespace.test.d.ts +1 -0
  396. package/dist/src/entities/initiatives/initiative.d.ts +185 -0
  397. package/dist/src/entities/initiatives/initiative.test.d.ts +1 -0
  398. package/dist/src/entities/initiatives/namespace.d.ts +90 -0
  399. package/dist/src/entities/me/namespace.d.ts +68 -0
  400. package/dist/src/entities/meetings/meeting.d.ts +81 -0
  401. package/dist/src/entities/meetings/namespace.d.ts +38 -0
  402. package/dist/src/entities/memory/namespace.d.ts +49 -0
  403. package/dist/src/entities/memory/namespace.test.d.ts +1 -0
  404. package/dist/src/entities/messages/discussion.d.ts +84 -0
  405. package/dist/src/entities/messages/thread.d.ts +115 -0
  406. package/dist/src/entities/notifications/namespace.d.ts +66 -0
  407. package/dist/src/entities/notifications/notification.d.ts +78 -0
  408. package/dist/src/entities/notifications/notification.test.d.ts +1 -0
  409. package/dist/src/entities/passwords/item.d.ts +118 -0
  410. package/dist/src/entities/passwords/namespace.d.ts +45 -0
  411. package/dist/src/entities/pins/namespace.d.ts +42 -0
  412. package/dist/src/entities/projects/namespace.d.ts +45 -0
  413. package/dist/src/entities/projects/project.d.ts +108 -0
  414. package/dist/src/entities/properties/namespace.d.ts +105 -0
  415. package/dist/src/entities/properties/namespace.test.d.ts +1 -0
  416. package/dist/src/entities/properties/property-definition.d.ts +70 -0
  417. package/dist/src/entities/properties/property-option.d.ts +44 -0
  418. package/dist/src/entities/reference.d.ts +82 -0
  419. package/dist/src/entities/referrals/namespace.d.ts +40 -0
  420. package/dist/src/entities/routines/namespace.d.ts +239 -0
  421. package/dist/src/entities/routines/routine.d.ts +341 -0
  422. package/dist/src/entities/routines/suggestion.d.ts +38 -0
  423. package/dist/src/entities/saved-views/namespace.d.ts +58 -0
  424. package/dist/src/entities/saved-views/saved-view.d.ts +78 -0
  425. package/dist/src/entities/search/exclusions.d.ts +6 -0
  426. package/dist/src/entities/search/namespace.d.ts +71 -0
  427. package/dist/src/entities/search/options.d.ts +30 -0
  428. package/dist/src/entities/search/types.d.ts +90 -0
  429. package/dist/src/entities/sharing/access.d.ts +120 -0
  430. package/dist/src/entities/sharing/permissions.d.ts +13 -0
  431. package/dist/src/entities/spreadsheets/spreadsheet.d.ts +201 -0
  432. package/dist/src/entities/suggestions/namespace.d.ts +118 -0
  433. package/dist/src/entities/suggestions/suggestion.d.ts +172 -0
  434. package/dist/src/entities/suggestions/suggestion.test.d.ts +1 -0
  435. package/dist/src/entities/tasks/namespace.d.ts +77 -0
  436. package/dist/src/entities/tasks/task.d.ts +99 -0
  437. package/dist/src/entities/teams/invite.d.ts +33 -0
  438. package/dist/src/entities/teams/namespace.d.ts +23 -0
  439. package/dist/src/entities/teams/team.d.ts +129 -0
  440. package/dist/src/entities/ui/app-link.d.ts +24 -0
  441. package/dist/src/entities/ui/namespace.d.ts +75 -0
  442. package/dist/src/entities/unfurls/namespace.d.ts +24 -0
  443. package/dist/src/entities/users/namespace.d.ts +41 -0
  444. package/dist/src/entities/users/profile-picture.d.ts +29 -0
  445. package/dist/src/entities/users/profile-picture.test.d.ts +1 -0
  446. package/dist/src/entities/users/user.d.ts +102 -0
  447. package/dist/src/entities/web/namespace.d.ts +67 -0
  448. package/dist/src/entities/web/namespace.test.d.ts +1 -0
  449. package/dist/src/entities/webhooks/namespace.d.ts +38 -0
  450. package/dist/src/entities/webhooks/webhook.d.ts +130 -0
  451. package/dist/src/entities/whatsapp/account.d.ts +24 -0
  452. package/dist/src/entities/whatsapp/chat.d.ts +62 -0
  453. package/dist/src/entities/whatsapp/namespace.d.ts +29 -0
  454. package/dist/src/entities/workspace/items.d.ts +14 -0
  455. package/dist/src/entities/workspace/namespace.d.ts +96 -0
  456. package/dist/src/entities/workspace/query.d.ts +39 -0
  457. package/dist/src/entities/workspace/query.test.d.ts +1 -0
  458. package/dist/src/entities/workspace/types.d.ts +99 -0
  459. package/dist/src/events/hydrate/agentSession.d.ts +192 -0
  460. package/dist/src/events/hydrate/call.d.ts +101 -0
  461. package/dist/src/events/hydrate/channel.d.ts +55 -0
  462. package/dist/src/events/hydrate/document.d.ts +59 -0
  463. package/dist/src/events/hydrate/message.d.ts +70 -0
  464. package/dist/src/events/hydrate/user.d.ts +14 -0
  465. package/dist/src/events/receiver.d.ts +91 -0
  466. package/dist/src/events/types.d.ts +44 -0
  467. package/dist/src/events/verify.d.ts +13 -0
  468. package/dist/src/local-portmap.d.ts +8 -0
  469. package/dist/src/mentions.d.ts +42 -0
  470. package/dist/src/raw.d.ts +12 -0
  471. package/dist/src/rox.d.ts +268 -0
  472. package/dist/src/rox.js +23231 -0
  473. package/dist/src/utils/activity.d.ts +34 -0
  474. package/dist/src/utils/activity.test.d.ts +1 -0
  475. package/dist/src/utils/client.d.ts +62 -0
  476. package/dist/src/utils/concurrency.d.ts +5 -0
  477. package/dist/src/utils/index.d.ts +5 -0
  478. package/dist/src/utils/lazy.d.ts +37 -0
  479. package/dist/src/utils/options.d.ts +7 -0
  480. package/dist/src/utils/pagination.d.ts +28 -0
  481. package/dist/src/utils/unwrap.d.ts +48 -0
  482. package/dist/src/utils/verbs.d.ts +3 -0
  483. package/package.json +82 -4
@@ -0,0 +1,334 @@
1
+ import type { CreateCalendarEvent_Deserialize } from '../../../generated/agent-reviews';
2
+ import type { CalendarAttendeeInputBody, ConferenceChange, EventReminders, EventTime, EventTransparency, EventVisibility, GuestPolicy, OutOfOfficeProperties, TeamCalendarSharing } from '../../../generated/calendar/types.gen';
3
+ import type { ListOccurrencesData, ListTeamCalendarData, ListTeamOutOfOfficeData } from '../../../generated/storage/types.gen';
4
+ import { type IterationOptions } from '../../utils';
5
+ import type { RoxClient } from '../../utils/client';
6
+ import type { Link } from '../email/link';
7
+ import { User } from '../users/user';
8
+ import { BookingNamespace } from './booking-namespace';
9
+ import { Calendar } from './calendar';
10
+ import { CalendarEvent } from './event';
11
+ import { CalendarReplacement } from './replacement';
12
+ /** Fields for a new calendar event. */
13
+ export interface CreateEventOptions {
14
+ /** Display title. */
15
+ title: string;
16
+ /** Timed or all-day shape. */
17
+ time: EventTime;
18
+ /** Optional event body. */
19
+ description?: string;
20
+ /** Optional location label. */
21
+ location?: string;
22
+ /** Invited attendees. */
23
+ attendees?: CalendarAttendeeInputBody[];
24
+ /** Raw RFC 5545 recurrence properties (`RRULE`, `RDATE`, `EXDATE`). */
25
+ recurrenceLines?: string[];
26
+ /** Event visibility. */
27
+ visibility?: EventVisibility;
28
+ /** Availability behavior. */
29
+ transparency?: EventTransparency;
30
+ /** Reminder configuration; omit to keep the calendar defaults. */
31
+ reminders?: EventReminders;
32
+ /** Conference to attach; omit to create the event without one. */
33
+ conference?: ConferenceChange;
34
+ /** Mint a Rox call with the event; its join link lands in the description
35
+ * and location. Cannot be combined with `conference`. */
36
+ macroCall?: boolean;
37
+ /** Out-of-office properties; present to create an out-of-office event. */
38
+ outOfOffice?: OutOfOfficeProperties;
39
+ /** What guests may do; omit for Google's defaults. Google calendars only. */
40
+ guestPolicy?: GuestPolicy;
41
+ /** Exact calendar to create the event on; takes precedence over the inbox
42
+ * default. */
43
+ calendar?: Calendar;
44
+ /** Connected inbox whose primary calendar receives the event; defaults to the
45
+ * requester's primary inbox. */
46
+ emailLink?: Link;
47
+ }
48
+ /** What the user is on one copy of an event, through the inbox holding it:
49
+ * its organizer (or the owner of an event without guests), or a guest. Being
50
+ * able to write someone else's calendar makes them neither, and neither does
51
+ * a read-only calendar naming them organizer; `viewerCan` says what they may
52
+ * do there. */
53
+ export type CalendarEventRole = 'organizer' | 'guest';
54
+ /**
55
+ * The calendar surface: every calendar the caller can see (not all of them
56
+ * theirs), event creation, and handles to individual events and calendars.
57
+ * Backed by calendar_service (the SDK reaches it on the gateway's `/calendar`
58
+ * route).
59
+ *
60
+ * The user can see calendars that are not theirs, such as a colleague's or a
61
+ * team's. `inbox` is the account syncing a calendar, so it stays the user's
62
+ * own address on all of them, and neither it, `isPrimary`, `isWritable` nor
63
+ * `role` says whose calendar it is. Their schedule is the calendars with
64
+ * `contributesToAvailability`, plus meetings they attend: only those are
65
+ * "your calendar", and only those are conflicts when finding free time, as in
66
+ * team availability. Anything else is what that calendar shows, not where the
67
+ * user is or what they are doing. Call it by `calendarName`, say whose it is
68
+ * when the name shows that, and otherwise say you cannot tell rather than
69
+ * guess. When it overlaps a time you suggest, mention it so the user can
70
+ * decide, since their own other calendars read the same way.
71
+ *
72
+ * A meeting on more than one of the user's inboxes is one event per inbox;
73
+ * {@link CalendarNamespace.occurrences} lists each copy with its `inbox` and
74
+ * `role`. Before changing such a meeting's details, guests or guest
75
+ * permissions, or deleting it, ask the user which inbox's copy to change, then
76
+ * pass that copy's `inbox` to {@link CalendarEvent.update},
77
+ * {@link CalendarEvent.inviteGuests} or {@link CalendarEvent.delete}. Never
78
+ * choose between the user's inboxes yourself, whatever they look like: a
79
+ * test, secondary or unfamiliar address is still the user's own inbox. Skip
80
+ * the question only when the user already named the inbox, when only one copy
81
+ * can make the change, or when adding guests from the copy the user
82
+ * organizes, and say why. Reminders may go to one copy; name its inbox. Read
83
+ * those three methods' documentation before changing a meeting held through
84
+ * several inboxes: it says what each change does from each copy.
85
+ *
86
+ * {@link CalendarEvent.addToCalendar} adds a shared meeting only while none
87
+ * of the user's calendars holds it. Refused with `already_on_calendar`, it is
88
+ * refused on every calendar, so tell the user the meeting is already on their
89
+ * calendar and never offer to add it to another one.
90
+ *
91
+ * @routing Use when working with calendar events, availability, scheduling a meeting with people, or booking links; not reminders or recurring automations, which are routines.
92
+ *
93
+ * @agent
94
+ * ## Booking links
95
+ *
96
+ * - Booking links live under `rox.calendar.booking`. They are reusable booking pages, not
97
+ * calendar meetings; the meetings guests book through them are `Booking`s.
98
+ * - Booking links use conversational confirmation in every surface. First list
99
+ * `rox.calendar.booking.links()` to find existing links and reusable availability. Resolve
100
+ * teams and hosts from what it returns; never ask for IDs, revisions or JSON. Default to
101
+ * personal ownership unless a team is requested. Explain the complete proposal in readable
102
+ * prose: ownership and named hosts, who attends, meeting name and description, duration,
103
+ * location, Rox call or Google Meet, time zone, weekly hours and date exceptions, link name,
104
+ * buffers, minimum notice, booking window, slot interval, daily limit, guest questions, and
105
+ * whether bookings are enabled. Group related settings so it is easy to review. Ask whether to
106
+ * proceed, and end the turn. Only after the user's reply approving that proposal, call
107
+ * `booking.createLink` or `BookingLink.edit`, quoting the reply verbatim in `userConfirmation`.
108
+ * Do not quote the original request or invent approval. These save immediately, with no
109
+ * review card. For edits preserve unrequested settings, and re-read and reconfirm if the
110
+ * revision conflicts. Share the saved `webUrl()` with an `<m-booking-link-mention>` chip (see
111
+ * Mentions), not a bare URL. If the same proposal is already approved, do not ask again.
112
+ * - `booking.saveSettings` changes shared schedules, page settings and many links at once: explain
113
+ * the changes and the links they affect, and save only on the user's approving reply.
114
+ * - Cancelling, approving or rescheduling a `Booking` notifies its guest and hosts; do it only on
115
+ * the user's go-ahead. Reschedule to a start from `rescheduleSlots`.
116
+ *
117
+ * ## Creating events
118
+ *
119
+ * - Nothing lands on a calendar, and no invitation goes out, without the user seeing the event. A program cannot call `createEvent`; it is refused.
120
+ * - In an agent session, present the event as a review: `execution.reviews.create({kind: 'calendar', title, drafts})`, each draft with the same fields as `createConfirmed` (`calendarId` in place of `calendar`), then return `reviews: [await review.reference()]`. The user creates it from the card.
121
+ * - For a prompt from a channel or document thread, where no card is seen: write the whole event into your reply (title, date and time with its time zone, duration, guests, location, conference or Rox call, recurrence), ask whether to create it, and stop. Only once the user replies approving that event, call `createConfirmed` with their reply quoted in `userConfirmation`. Being asked to schedule something is a request to draft the event, never the approval.
122
+ */
123
+ export declare class CalendarNamespace {
124
+ private readonly client;
125
+ /**
126
+ * Calendar availability settings, each referring to a typed calendar.
127
+ *
128
+ * @readonly
129
+ */
130
+ availabilityCalendars(): Promise<{
131
+ calendar: Calendar;
132
+ name: string;
133
+ isPrimary: boolean;
134
+ contributesToAvailability: boolean;
135
+ }[]>;
136
+ /**
137
+ * Current sharing preference for the team calendar.
138
+ *
139
+ * @readonly
140
+ */
141
+ teamSharing(): Promise<TeamCalendarSharing>;
142
+ /**
143
+ * Replace the team calendar sharing preference.
144
+ *
145
+ * @write
146
+ * @idempotent
147
+ */
148
+ setTeamSharing(sharing: TeamCalendarSharing): Promise<TeamCalendarSharing>;
149
+ /** Occurrences on every calendar the user can see: their schedule is only
150
+ * `contributesToAvailability` rows and meetings they attend; call the rest
151
+ * by `calendarName`. Automatically paginated within the viewport; `maxItems` caps the total. Each names
152
+ * its calendar (`calendarName`), whether a calendar holding it is on the
153
+ * user's schedule (`contributesToAvailability`), the address of the
154
+ * connected inbox holding that copy of the event (`inbox`) and whether the
155
+ * user organizes it or is a guest there (`role`, absent when neither, when
156
+ * they can only write that calendar, or when a read-only calendar names
157
+ * them organizer).
158
+ *
159
+ * `inbox` is the account syncing the calendar, so a colleague's calendar
160
+ * reports the user's own address; it never says whose calendar it is, and
161
+ * neither does `role`, since writing someone's calendar lets the user act
162
+ * as its organizer. Say "your calendar", and count a conflict or busy time,
163
+ * only for `contributesToAvailability` rows and meetings the user attends
164
+ * (`role`), the way team availability does. Any other row is what that
165
+ * calendar shows, not where the user is or what they are doing: "the
166
+ * Offsites calendar has...", or "alex@example.com's calendar has..." when
167
+ * the name shows whose it is. If it does not, say you cannot tell rather
168
+ * than guess. When one overlaps a time you suggest, mention it so the user
169
+ * can decide, since their own other calendars read the same way.
170
+ *
171
+ * A meeting on several of the user's inboxes appears once per inbox, each
172
+ * with its own event; describe them by inbox and role, never by id.
173
+ *
174
+ * Before changing or deleting such a meeting, ask the user which inbox's
175
+ * copy to change, unless they named it, only one copy can make the change,
176
+ * or you add guests from the copy they organize. Never choose between the
177
+ * user's inboxes yourself, whatever they look like. Pass the chosen copy's
178
+ * `inbox` to its `update`, `inviteGuests` or `delete`; without it the call
179
+ * is refused with `copy_choice_required`, which names each copy's inbox and
180
+ * event and gives the question to ask. An occurrence whose calendar is no
181
+ * longer listed has no `inbox`; take it from that refusal.
182
+ *
183
+ * @readonly
184
+ */
185
+ occurrences(options: Omit<ListOccurrencesData['query'], 'cursor'> & IterationOptions): AsyncGenerator<{
186
+ event: CalendarEvent;
187
+ occurrence: import("../../../generated/storage").CalendarOccurrence;
188
+ calendarName: string | undefined;
189
+ contributesToAvailability: boolean | undefined;
190
+ inbox: string | undefined;
191
+ role: CalendarEventRole | undefined;
192
+ }, any, any>;
193
+ /**
194
+ * A page of team availability, including its roster and continuation cursor.
195
+ *
196
+ * @readonly
197
+ */
198
+ teamPage(options: NonNullable<ListTeamCalendarData['query']>): Promise<{
199
+ items: ({
200
+ owner: User;
201
+ kind: "busy";
202
+ contributesToAvailability: boolean;
203
+ id: string;
204
+ time: import("../../../generated/storage").EventTime;
205
+ } | {
206
+ owner: User;
207
+ details: import("../../../generated/storage").TeamCalendarDetails;
208
+ kind: "details";
209
+ contributesToAvailability: boolean;
210
+ id: string;
211
+ time: import("../../../generated/storage").EventTime;
212
+ })[];
213
+ members: {
214
+ user: User;
215
+ sharing: import("../../../generated/storage").TeamCalendarSharing;
216
+ coverage: import("../../../generated/storage").TeamCalendarCoverage;
217
+ }[];
218
+ nextCursor: string | undefined;
219
+ }>;
220
+ /**
221
+ * Teammates' out-of-office occurrences in a bounded viewport. Check hasMore for truncation.
222
+ *
223
+ * @readonly
224
+ */
225
+ teamOutOfOffice(options: NonNullable<ListTeamOutOfOfficeData['query']>): Promise<{
226
+ items: {
227
+ event: CalendarEvent;
228
+ owner: User;
229
+ occurrenceKey: string;
230
+ time: import("../../../generated/storage").EventTime;
231
+ title: string | undefined;
232
+ }[];
233
+ hasMore: boolean;
234
+ }>;
235
+ /** Booking links, their settings, booked meetings and booking statistics. */
236
+ readonly booking: BookingNamespace;
237
+ constructor(client: RoxClient);
238
+ /**
239
+ * When the user and their teammates are busy in a bounded UTC window (a day
240
+ * or a week is best, at most 370 days); `freeWindows` is present only when
241
+ * every person's data is complete, so never infer free time from missing
242
+ * busy blocks. Always includes the user; omit `members` for the whole team,
243
+ * or pass `[]` for only the user. Busy blocks carry no event titles, and
244
+ * working hours are not applied.
245
+ *
246
+ * @readonly
247
+ */
248
+ teamAvailability(opts: {
249
+ /** Inclusive start, RFC 3339 UTC. */
250
+ start: string;
251
+ /** Exclusive end, RFC 3339 UTC; later than `start`. */
252
+ end: string;
253
+ /** At most 100 current teammates. */
254
+ members?: User[];
255
+ }): Promise<{
256
+ start: string;
257
+ end: string;
258
+ members: {
259
+ user: User;
260
+ busy: Array<import("../../../generated/storage").AvailabilityInterval>;
261
+ coverage: import("../../../generated/storage").AvailabilityCoverage;
262
+ unknownReasons: Array<import("../../../generated/storage").AvailabilityUnknownReason>;
263
+ }[];
264
+ freeWindows: import("../../../generated/storage").AvailabilityInterval[] | undefined;
265
+ /** Requested people who are not current teammates; nothing about them is disclosed. */
266
+ unknownUsers: User[];
267
+ complete: boolean;
268
+ summary: string;
269
+ }>;
270
+ /**
271
+ * The calendars the caller can see, some possibly not theirs, primaries and writable first.
272
+ *
273
+ * @readonly
274
+ */
275
+ calendars(): Promise<Calendar[]>;
276
+ /**
277
+ * A handle to a calendar by id. Detail loads on first access.
278
+ *
279
+ * @readonly
280
+ */
281
+ calendar(id: string): Calendar;
282
+ /**
283
+ * A handle to a calendar event by id, for driving mutations.
284
+ *
285
+ * @readonly
286
+ */
287
+ event(id: string): CalendarEvent;
288
+ /**
289
+ * Recover a saved replacement, including after its original event was retired.
290
+ *
291
+ * @readonly
292
+ */
293
+ replacement(operationId: string): CalendarReplacement;
294
+ /**
295
+ * Create a calendar event and return a handle to its synced record; an
296
+ * agent's program is refused (403) and creates through a review or
297
+ * {@link createConfirmed} instead.
298
+ *
299
+ * @destructive
300
+ * @openworld
301
+ */
302
+ createEvent(options: CreateEventOptions): Promise<CalendarEvent>;
303
+ /**
304
+ * Create a calendar event only after the user replied approving it, quoting that reply in `userConfirmation`; never on the request that asked for the event.
305
+ *
306
+ * For a prompt from a channel or document thread: write the event out
307
+ * there, ask whether to create it, and call this in a later turn on the
308
+ * user's approving reply. In the agent session view, present a review
309
+ * (`execution.reviews.create({kind: 'calendar', ...})`) instead; its card
310
+ * is the confirmation. Takes what the CreateCalendarEvent tool takes:
311
+ * guests, recurrence, reminders, a provider conference or a Rox call,
312
+ * out-of-office and guest policy, and the calendar to write to. The event
313
+ * is written to the provider at once and guests receive invitations; on an
314
+ * error, look for the event before creating it again.
315
+ *
316
+ * @destructive
317
+ * @openworld
318
+ */
319
+ createConfirmed(options: ConfirmedEventOptions): Promise<CalendarEvent>;
320
+ }
321
+ /** An event the user has approved in conversation, for `calendar.createConfirmed`. */
322
+ export type ConfirmedEventOptions = EventFields<CreateCalendarEvent_Deserialize> & {
323
+ /** The calendar to write to; omit for the user's primary calendar. */
324
+ calendar?: Calendar;
325
+ /**
326
+ * The user's own reply approving this specific event, quoted verbatim, such
327
+ * as their "yes, go ahead" after you wrote the event out for them. Never the
328
+ * request that asked you to schedule it, and never your own words.
329
+ */
330
+ userConfirmation: string;
331
+ };
332
+ /** The tool's event fields, with the calendar taken as a handle instead. */
333
+ type EventFields<Event> = Event extends unknown ? Omit<Event, 'calendarId'> : never;
334
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,31 @@
1
+ import type { CalendarReplacementView } from '../../../generated/calendar/types.gen';
2
+ import type { RoxClient } from '../../utils/client';
3
+ /** Durable organizer replacement, recoverable even after the original event is retired. */
4
+ export declare class CalendarReplacement {
5
+ private readonly client;
6
+ readonly id: string;
7
+ constructor(client: RoxClient, id: string);
8
+ /** A handle to a replacement by its operation id. */
9
+ static byId(client: RoxClient, id: string): CalendarReplacement;
10
+ /**
11
+ * Read progress without initiating provider writes.
12
+ *
13
+ * @readonly
14
+ */
15
+ status(): Promise<CalendarReplacementView>;
16
+ /** Confirm the reviewed cancellation and reinvitation, or resume that same operation.
17
+ * Present the preview and obtain the organizer's confirmation before the first call.
18
+ *
19
+ * @destructive
20
+ * @openworld
21
+ * @idempotent
22
+ */
23
+ confirm(): Promise<CalendarReplacementView>;
24
+ /**
25
+ * Discard an unconfirmed preview. Confirmed operations must be recovered, not discarded.
26
+ *
27
+ * @destructive
28
+ * @idempotent
29
+ */
30
+ discard(): Promise<void>;
31
+ }
@@ -0,0 +1,231 @@
1
+ import type { EditCallTranscriptRequest, GetCallRecordResponses, LiveCallSummary, RingStatus } from '../../../generated/storage/types.gen';
2
+ import type { RoxClient } from '../../utils/client';
3
+ import { Channel } from '../channels/channel';
4
+ import { Thread } from '../channels/thread';
5
+ import { FavoritableEntity } from '../entity';
6
+ import { Meeting } from '../meetings/meeting';
7
+ import { MessageThread, type TimelineOptions } from '../messages/thread';
8
+ import { EntityAccess } from '../sharing/access';
9
+ import { type SharePermissionOptions } from '../sharing/permissions';
10
+ import { User } from '../users/user';
11
+ import { CallConnection, type JoinOptions } from './connection';
12
+ import { CallMessage } from './message';
13
+ import { CallParticipant } from './participant';
14
+ type CallRecordDetail = GetCallRecordResponses[200];
15
+ /** A Rox call record (an archived or still active call). */
16
+ export declare class CallRecord extends FavoritableEntity<CallRecordDetail> {
17
+ /** Kind is available immediately on handles returned by the live list. */
18
+ readonly kind?: LiveCallSummary['kind'];
19
+ private constructor();
20
+ /** Build a live call handle without fetching its archived detail. */
21
+ static fromLive(client: RoxClient, summary: LiveCallSummary): CallRecord;
22
+ /**
23
+ * Join only while this call is live, never starting a replacement call;
24
+ * refused to an agent's program (ExecuteCode, a routine).
25
+ *
26
+ * @write
27
+ * @mcp-exclude Returns a live call room credential; MCP calls carry JSON only.
28
+ */
29
+ join(opts?: JoinOptions): Promise<CallConnection>;
30
+ /**
31
+ * Read the current ring state for this account.
32
+ *
33
+ * @readonly
34
+ */
35
+ ringState(): Promise<RingStatus>;
36
+ /**
37
+ * Read the connected room roster without joining.
38
+ *
39
+ * @readonly
40
+ */
41
+ participants(): Promise<CallParticipant[]>;
42
+ /**
43
+ * Decline this call's ring for the current account.
44
+ *
45
+ * @write
46
+ * @idempotent
47
+ */
48
+ decline(): Promise<void>;
49
+ /**
50
+ * Read the persistent discussion, which may be a channel thread.
51
+ *
52
+ * @readonly
53
+ */
54
+ discussion(): Promise<MessageThread | Thread>;
55
+ /** Download recording bytes through the Rox host. */
56
+ readonly recording: {
57
+ bytes: () => Promise<Uint8Array>;
58
+ };
59
+ /**
60
+ * A shared message thread scoped to this resource.
61
+ *
62
+ * @readonly
63
+ */
64
+ messageThreadById(id: string): MessageThread;
65
+ /**
66
+ * A mixed message and activity timeline page.
67
+ *
68
+ * @readonly
69
+ */
70
+ timelinePage(selection?: TimelineOptions<CallMessage>): Promise<{
71
+ entries: ({
72
+ type: "activity";
73
+ activity: {
74
+ actor: User;
75
+ action: string;
76
+ actor_id: string;
77
+ id: string;
78
+ occurred_at: string;
79
+ payload?: unknown;
80
+ };
81
+ message?: undefined;
82
+ } | {
83
+ type: "message";
84
+ message: CallMessage;
85
+ activity?: undefined;
86
+ })[];
87
+ nextCursor: import("../../../generated/storage").MessageCursor | undefined;
88
+ previousCursor: import("../../../generated/storage").MessageCursor | undefined;
89
+ }>;
90
+ /** Access requests and direct user grants. */
91
+ readonly access: EntityAccess;
92
+ /**
93
+ * Get or create a shareable meeting for this call; refused to an agent's
94
+ * program (ExecuteCode, a routine), so there ask the user to share it.
95
+ *
96
+ * @write
97
+ * @idempotent
98
+ */
99
+ meeting(): Promise<Meeting>;
100
+ /**
101
+ * Update custom speaker assignments in the transcript.
102
+ *
103
+ * @write
104
+ * @idempotent
105
+ */
106
+ editTranscript(assignments: EditCallTranscriptRequest['assignments']): Promise<void>;
107
+ /**
108
+ * Toggle the server's share-with-team setting and return its new value.
109
+ *
110
+ * @write
111
+ */
112
+ toggleTeamShare(): Promise<boolean>;
113
+ /** Favorites identify call records as `call`. */
114
+ readonly entityType = "call";
115
+ /**
116
+ * Share this call record with a channel's current members, as posting it in the
117
+ * channel does. The caller must be in the channel and able to share the
118
+ * call record; sharing again changes nothing.
119
+ *
120
+ * @write
121
+ * @idempotent
122
+ */
123
+ shareWithChannel(channel: Channel): Promise<void>;
124
+ protected fetch(): Promise<CallRecordDetail>;
125
+ /**
126
+ * The call's URL in the Rox web app; hand it to users as the link.
127
+ *
128
+ * @readonly
129
+ */
130
+ webUrl(): string;
131
+ /** Identity, loaded detail and {@link webUrl}, so serialized handles carry their link. */
132
+ toJSON(): {
133
+ url: string;
134
+ id: string;
135
+ detail?: import("../../../generated/storage").CallRecord | undefined;
136
+ };
137
+ /** A handle to a call record by id. Details load on first access. */
138
+ static byId(client: RoxClient, id: string): CallRecord;
139
+ /**
140
+ * A message in this call's persistent chat. Fields load on first access.
141
+ *
142
+ * @readonly
143
+ */
144
+ message(id: string): CallMessage;
145
+ /** The call's display name (user-supplied or AI-generated; unset while active). */
146
+ readonly name: () => Promise<string | undefined>;
147
+ /** The channel the call belongs to, if it is a channel call. */
148
+ readonly channel: () => Promise<Channel | undefined>;
149
+ /** The display name of the channel the call belongs to. */
150
+ readonly channelName: () => Promise<string | undefined>;
151
+ /** The user who started the call. */
152
+ readonly creator: () => Promise<User>;
153
+ /** Whether the call is still in progress. */
154
+ readonly isActive: () => Promise<boolean>;
155
+ /** The call's status (undefined until set). */
156
+ readonly status: () => Promise<NonNullable<import("../../../generated/storage").CallStatus | null | undefined> | undefined>;
157
+ /** The realtime room the call runs in. */
158
+ readonly roomName: () => Promise<string | undefined>;
159
+ /** When the call started. */
160
+ readonly startedAt: () => Promise<string>;
161
+ /** When the call ended (undefined if still active). */
162
+ readonly endedAt: () => Promise<string | undefined>;
163
+ /** Call duration in milliseconds (undefined if still active). */
164
+ readonly durationMs: () => Promise<number | undefined>;
165
+ /** AI-generated summary of the call, once summarization has run. */
166
+ readonly summary: () => Promise<string | undefined>;
167
+ /** Transcript segments, ordered by sequence number. */
168
+ readonly transcript: () => Promise<import("../../../generated/storage").CallRecordTranscriptSegment[]>;
169
+ /** Macro-account participants, both active and historic. */
170
+ readonly historicParticipants: () => Promise<import("../../../generated/storage").CallRecordParticipant[]>;
171
+ /** Current and past guests; each id matches its transcript speaker id. */
172
+ readonly guests: () => Promise<import("../../../generated/storage").CallRecordGuest[]>;
173
+ /**
174
+ * The canonical access level granted to the creator's team once the call is
175
+ * archived, or null when it is not shared. Calls only ever grant `'view'`;
176
+ * while the call is live this is null and {@link CallRecord.shareWithTeam}
177
+ * carries the pending toggle.
178
+ */
179
+ readonly teamShareAccessLevel: () => Promise<NonNullable<import("../../../generated/storage").AccessLevel | null | undefined> | undefined>;
180
+ /**
181
+ * Whether the call is shared with the creator's team: the pending toggle
182
+ * while the call is live, the canonical grant once it is archived.
183
+ */
184
+ readonly shareWithTeam: () => Promise<boolean>;
185
+ /**
186
+ * URL of the call recording, once available; empty for an agent's program
187
+ * (ExecuteCode, a routine), which reads the bytes with `recording.bytes()`.
188
+ */
189
+ readonly recordingUrl: () => Promise<string | undefined>;
190
+ /** URL of the recording preview (thumbnail), once available; empty for an agent's program. */
191
+ readonly recordingPreviewUrl: () => Promise<string | undefined>;
192
+ /** When the recording started, if it was recorded. */
193
+ readonly recordingStartedAt: () => Promise<string | undefined>;
194
+ /**
195
+ * Rename the call or clear the custom name.
196
+ *
197
+ * @write
198
+ * @idempotent
199
+ */
200
+ rename(name: string | null): Promise<void>;
201
+ /**
202
+ * Share the call with the creator's team (view access), or unshare it.
203
+ * While the call is live this sets the pending toggle any participant with
204
+ * edit access may change; once archived only the call's creator may change
205
+ * it and the API answers 403 otherwise.
206
+ *
207
+ * @write
208
+ * @idempotent
209
+ */
210
+ setTeamShare(shared: boolean): Promise<void>;
211
+ /**
212
+ * Change who can open the call: the link share and its access level, and
213
+ * channel grants. Omitted fields are left as they are; requires edit access
214
+ * (channel membership). `teamShareAccessLevel` only accepts `view` or `null`,
215
+ * and once the call is archived only its creator may change it.
216
+ *
217
+ * @write
218
+ * @idempotent
219
+ */
220
+ updateSharePermissions(options: SharePermissionOptions): Promise<void>;
221
+ /**
222
+ * Delete the call record.
223
+ *
224
+ * @destructive
225
+ * @idempotent
226
+ */
227
+ delete(): Promise<void>;
228
+ /** Search calls by name and transcript, most relevant first, auto-paginated; `maxItems` caps the total. */
229
+ static search: (client: RoxClient, query: string, searchOpts?: import("../search/options").SearchOpts) => AsyncGenerator<CallRecord, any, any>;
230
+ }
231
+ export {};
@@ -0,0 +1,59 @@
1
+ import type { CallTokenResponse, JoinCallRequest } from '../../../generated/storage/types.gen';
2
+ import type { RoxClient } from '../../utils/client';
3
+ import { CallRecord } from './call-record';
4
+ declare const inspectSymbol: unique symbol;
5
+ /** Options for entering a call. The default is to fail if already in another call. */
6
+ export type JoinOptions = JoinCallRequest;
7
+ /** A room credential. Keep `token` out of logs and serialized values. */
8
+ export declare class CallConnection {
9
+ private readonly client;
10
+ /** The call this credential enters. */
11
+ readonly call: CallRecord;
12
+ /** LiveKit server URL. */
13
+ readonly url: string;
14
+ /** Short-lived LiveKit token; never serialize or log it. */
15
+ readonly token: string;
16
+ /** RTC participant identity. */
17
+ readonly identity: string;
18
+ /** RTC room name. */
19
+ readonly roomName: string;
20
+ /** Whether this request created the call. */
21
+ readonly started: boolean;
22
+ /** Construct a connection from the server's admission response. */
23
+ constructor(client: RoxClient, response: CallTokenResponse);
24
+ /**
25
+ * Leave this exact call; safe to invoke after another call has started.
26
+ *
27
+ * @write
28
+ * @idempotent
29
+ * @mcp-exclude Acts on a live call connection, which only a join returns.
30
+ */
31
+ leave(): Promise<{
32
+ callEnded: boolean;
33
+ }>;
34
+ /** Serialize connection metadata without the room credential. */
35
+ toJSON(): {
36
+ call: {
37
+ url: string;
38
+ id: string;
39
+ detail?: import("../../../generated/storage").CallRecord | undefined;
40
+ };
41
+ url: string;
42
+ identity: string;
43
+ roomName: string;
44
+ started: boolean;
45
+ };
46
+ /** Keep the credential out of Node's console inspection. */
47
+ [inspectSymbol](): {
48
+ call: {
49
+ url: string;
50
+ id: string;
51
+ detail?: import("../../../generated/storage").CallRecord | undefined;
52
+ };
53
+ url: string;
54
+ identity: string;
55
+ roomName: string;
56
+ started: boolean;
57
+ };
58
+ }
59
+ export {};
@@ -0,0 +1,15 @@
1
+ import { RoxApiError } from '../../utils/unwrap';
2
+ /** The account is participating in another call. */
3
+ export declare class InOtherCallError extends RoxApiError {
4
+ constructor(data: unknown);
5
+ }
6
+ /** This identity already has a room connection. */
7
+ export declare class AlreadyConnectedError extends RoxApiError {
8
+ constructor(data: unknown);
9
+ }
10
+ /** The call ended before this join completed. */
11
+ export declare class CallEndedError extends RoxApiError {
12
+ constructor(data: unknown);
13
+ }
14
+ /** Preserve the server's branchable call admission codes. */
15
+ export declare function callAdmissionError(error: unknown): never;