@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 @@
1
+ export {};
@@ -0,0 +1,48 @@
1
+ import type { ActivityWireRow } from '../../../generated/agent-harness/types.gen';
2
+ import { type IterationOptions } from '../../utils';
3
+ import type { RoxClient } from '../../utils/client';
4
+ import type { AgentSession } from './agent-session';
5
+ /** Page options for recorded session activity, newest first. */
6
+ export type AgentActivityOptions = IterationOptions & {
7
+ /** Page size, from 1 to 100; defaults to 50. */
8
+ limit?: number;
9
+ /** Restrict to one code-mode invocation belonging to this session. */
10
+ invocation?: AgentInvocation;
11
+ };
12
+ /** A code-mode invocation, identified independently of its runtime or retries. */
13
+ export declare class AgentInvocation {
14
+ private readonly client;
15
+ private readonly parent;
16
+ readonly id: string;
17
+ private constructor();
18
+ /** Construct a handle without making a request. */
19
+ static byId(client: RoxClient, session: AgentSession, id: string): AgentInvocation;
20
+ /**
21
+ * The session that owns this invocation.
22
+ *
23
+ * @readonly
24
+ */
25
+ session(): AgentSession;
26
+ /**
27
+ * Recorded activity caused by this invocation, lazily paginated; `maxItems` caps the total.
28
+ *
29
+ * @readonly
30
+ */
31
+ activity(options?: Omit<AgentActivityOptions, 'invocation'>): AsyncGenerator<AgentActivity, any, any>;
32
+ /** Safe identity without an authenticated client. */
33
+ toJSON(): {
34
+ id: string;
35
+ session: {
36
+ id: string;
37
+ };
38
+ };
39
+ }
40
+ /** An original activity-history row attributed to a session. */
41
+ export type AgentActivity = {
42
+ /** The originating invocation; absent on legacy rows. */
43
+ invocation?: AgentInvocation;
44
+ /** Original recorded metadata. Action tags and payloads are forward-compatible. */
45
+ snapshot: ActivityWireRow;
46
+ };
47
+ /** Iterate recorded mutations; reads and failed requests do not create history. */
48
+ export declare function sessionActivity(client: RoxClient, session: AgentSession, options?: AgentActivityOptions): AsyncGenerator<AgentActivity>;
@@ -0,0 +1,518 @@
1
+ import type { FoldedMessage } from '../../../generated/agent-fold';
2
+ import type { AgentAction, AgentMode, AgentSessionChangesResponse, AgentSessionLogResponse, AgentSessionResponse, AgentUpdateKind, ArchiveCause, AutoArchivePreferencesBody, CodingPreferencesBody, ControlResponse, PromptAttachment, PullRequestLinkSource, SandboxSize, SessionBot } from '../../../generated/agent-harness/types.gen';
3
+ import type { RoxClient } from '../../utils/client';
4
+ import type { Agent } from '../agents/agent';
5
+ import type { Channel } from '../channels/channel';
6
+ import { RoxEntity } from '../entity';
7
+ import { EntityAccess } from '../sharing/access';
8
+ import { type SharePermissionOptions } from '../sharing/permissions';
9
+ import { Task } from '../tasks/task';
10
+ import { User } from '../users/user';
11
+ import { type AgentActivityOptions, AgentInvocation } from './activity';
12
+ import { CodeExecution } from './code-execution';
13
+ import { type SessionOrigin } from './origin';
14
+ import { QueuedAction } from './queued-action';
15
+ import { type CreateReviewOptions, SessionReview } from './review';
16
+ import { ToolApproval } from './tool-approval';
17
+ import { type SessionView } from './view';
18
+ export type { ArchiveCause };
19
+ /**
20
+ * One session's auto-archive choices. A trigger left `undefined` follows the
21
+ * owner's default.
22
+ */
23
+ export type AutoArchiveOverrides = {
24
+ /** Archive once every linked pull request is closed and at least one merged. */
25
+ onPullRequestMerged?: boolean;
26
+ /** Archive once the runtime session backing it is deliberately closed. */
27
+ onRuntimeClosed?: boolean;
28
+ };
29
+ /** A session's auto-archive settings, and when a trigger archived it. */
30
+ export type SessionAutoArchive = {
31
+ /** The session's own choices. */
32
+ overrides: AutoArchiveOverrides;
33
+ /** The owner's defaults, which apply where the session has no choice. */
34
+ defaults: AutoArchivePreferencesBody;
35
+ /**
36
+ * When a trigger first archived the session, if one did. It stays after the
37
+ * session is unarchived, since a session archives itself at most once.
38
+ */
39
+ autoArchivedAt?: string;
40
+ };
41
+ /** A session's history folded into readable messages, oldest first. */
42
+ export type FoldedAgentSessionLog = {
43
+ /** The agent that sent every agent message. */
44
+ bot: SessionBot;
45
+ /**
46
+ * Prompts and replies with their tool calls, results, plans, permission
47
+ * requests and how each turn ended.
48
+ */
49
+ messages: FoldedMessage[];
50
+ };
51
+ /** A GitHub pull request linked to a session. */
52
+ /** An agent session an account registered as its work. */
53
+ export type RegisteredWork = {
54
+ /** The session registered. */
55
+ session: AgentSession;
56
+ /** The account whose work this is. */
57
+ account: User;
58
+ /** When the account registered it. */
59
+ registeredAt: string;
60
+ };
61
+ export type SessionPullRequest = {
62
+ /** The pull request's `owner/repo/pull/number` key. */
63
+ githubKey: string;
64
+ /** The pull request's GitHub URL. */
65
+ url: string;
66
+ /** Whether the session's agent opened it or a person linked it. */
67
+ source: PullRequestLinkSource;
68
+ /** Who linked it, for pull requests a person linked. */
69
+ linkedBy?: User;
70
+ /** When it was linked. */
71
+ createdAt: string;
72
+ };
73
+ /** A request a session is waiting on its owner to answer, or a session gone quiet. */
74
+ export type AgentSessionUpdate = {
75
+ /** The session. */
76
+ session: AgentSession;
77
+ /** The session's name. */
78
+ sessionName: string;
79
+ /** The runtime the session runs on. */
80
+ harness: string;
81
+ /** The session's pull request, if it has one. */
82
+ pullRequestUrl?: string;
83
+ /**
84
+ * What the session waits for: `permission` to run a tool, an `elicitation`
85
+ * question, a held `tool_approval`, or `stalled` with no activity for over
86
+ * 20 minutes.
87
+ */
88
+ kind: AgentUpdateKind;
89
+ /** What is asked, or why the session looks stalled. */
90
+ summary: string;
91
+ /** When the request was made, or the session's last activity. */
92
+ since: string;
93
+ /** The choices a permission request offers; empty for other kinds. */
94
+ options: string[];
95
+ };
96
+ /** The caller's sessions waiting for them, newest activity first. */
97
+ export type AgentSessionUpdates = {
98
+ /** One entry per pending request or stalled session. */
99
+ items: AgentSessionUpdate[];
100
+ /** Whether sessions beyond the 25 most recent were left out. */
101
+ truncated: boolean;
102
+ /** Says what was left out, when truncated. */
103
+ truncationNotice?: string;
104
+ };
105
+ /** A tool call the session's runtime holds until its owner answers. */
106
+ export type PendingToolApproval = {
107
+ /** Answer it with {@link ToolApproval.answer}. */
108
+ approval: ToolApproval;
109
+ /** What a person calls the server the tool is on. */
110
+ serverName: string;
111
+ /** The tool called. */
112
+ toolName: string;
113
+ /** What it was called with. */
114
+ arguments: unknown;
115
+ /** Who prompted the turn; absent for a bot on nobody's behalf. */
116
+ requestedBy?: User;
117
+ };
118
+ /** The task a session is linked to. */
119
+ export type LinkedTask = {
120
+ /** The task. */
121
+ task: Task;
122
+ /** Put this in the pull request description so GitHub activity reaches the task. */
123
+ reference: string;
124
+ /** The session's pull request, now linked to the task, if it has one. */
125
+ pullRequestUrl?: string;
126
+ };
127
+ /** A GitHub repository the caller can point a managed session at. */
128
+ export type SelectableRepository = {
129
+ /** The canonical `https://github.com/owner/name` URL, as `createManaged` takes it. */
130
+ url: string;
131
+ /**
132
+ * The branch its clones check out, and where a session starts unless
133
+ * `createManaged` names another. Absent for a repository with no commits.
134
+ */
135
+ defaultBranch?: string;
136
+ };
137
+ /** What a managed session is created with. */
138
+ export type CreateManagedSessionOptions = {
139
+ /**
140
+ * Persona the session runs as, from {@link AgentNamespace.coding} or
141
+ * {@link AgentNamespace.list}. The caller must be able to use it. Omitted, the
142
+ * deployment's default coding persona, or Cursor when `repoUrl` is set.
143
+ * Its harness, instructions and model apply unless `instructions` or
144
+ * `model` override them.
145
+ */
146
+ agent?: Agent;
147
+ /** First prompt to deliver once the session is running. */
148
+ prompt?: string;
149
+ /**
150
+ * Instructions the session's runtime works under, fixed for its life.
151
+ * Outranks the persona's when both are set.
152
+ */
153
+ instructions?: string;
154
+ /**
155
+ * The model the session runs on, instead of its persona's. The session's
156
+ * model from creation, read back as {@link AgentSession.model}.
157
+ */
158
+ model?: string;
159
+ /**
160
+ * The repository the session works on, as one of the URLs
161
+ * {@link AgentSession.repositories} lists for the caller. Omitted, the
162
+ * runtime chooses from the prompt. Honored for Cursor sessions; omit
163
+ * `agent` and the session starts as Cursor.
164
+ */
165
+ repoUrl?: string;
166
+ /**
167
+ * The branch the session starts on; needs `repoUrl`. Omitted, the
168
+ * repository's default branch.
169
+ */
170
+ repoBranch?: string;
171
+ };
172
+ /** A managed or externally hosted coding-agent session. */
173
+ export declare class AgentSession extends RoxEntity<AgentSessionResponse> {
174
+ /** Access requests and direct user grants. */
175
+ readonly access: EntityAccess;
176
+ /**
177
+ * Share this agent session with a channel's current members, as posting it in the
178
+ * channel does. The caller must be in the channel and able to share the
179
+ * agent session; sharing again changes nothing.
180
+ *
181
+ * @write
182
+ * @idempotent
183
+ */
184
+ shareWithChannel(channel: Channel): Promise<void>;
185
+ /**
186
+ * Construct an approval handle scoped to this session.
187
+ *
188
+ * @readonly
189
+ */
190
+ toolApprovalById(id: string): ToolApproval;
191
+ /**
192
+ * Sharing configuration.
193
+ *
194
+ * @readonly
195
+ */
196
+ sharePermissions(): Promise<import("../../../generated/agent-harness").SharePermissionV2>;
197
+ /**
198
+ * Replace sharing grants.
199
+ *
200
+ * @write
201
+ * @idempotent
202
+ */
203
+ updateSharePermissions(options: SharePermissionOptions): Promise<import("../../../generated/agent-harness").SharePermissionV2>;
204
+ /**
205
+ * The session's URL in the Rox web app; hand it to users as the link.
206
+ *
207
+ * @readonly
208
+ */
209
+ webUrl(): string;
210
+ /** Identity, loaded detail and {@link webUrl}, so serialized handles carry their link. */
211
+ toJSON(): {
212
+ url: string;
213
+ id: string;
214
+ detail?: AgentSessionResponse | undefined;
215
+ };
216
+ /** A handle to an agent session by id. Details load on first access. */
217
+ static byId(client: RoxClient, id: string): AgentSession;
218
+ /**
219
+ * Create a managed session as `agent` when one is named, otherwise the
220
+ * deployment's default coding persona. List personas with
221
+ * {@link AgentNamespace.list} and construct one with {@link Agent.byId}.
222
+ * Unknown or inaccessible personas fail. `model` and `instructions`
223
+ * outrank the persona's. `repoUrl` is honored for Cursor; omit `agent`
224
+ * and it starts as Cursor.
225
+ */
226
+ static createManaged(client: RoxClient, opts?: CreateManagedSessionOptions): Promise<AgentSession>;
227
+ /**
228
+ * List repositories available for managed sessions.
229
+ *
230
+ * Includes every repository under an installation of Rox's GitHub App they or their
231
+ * teams made, sorted by `owner/name`. Empty when the App is installed
232
+ * nowhere they reach.
233
+ */
234
+ static repositories(client: RoxClient): Promise<SelectableRepository[]>;
235
+ /**
236
+ * Branch names on one repository the caller can start a managed session
237
+ * from, in the order GitHub listed them. Empty when the repository has
238
+ * no commits yet. `repoUrl` is one of the URLs {@link AgentSession.repositories}
239
+ * lists.
240
+ */
241
+ static repositoryBranches(client: RoxClient, repoUrl: string): Promise<string[]>;
242
+ /**
243
+ * Whether `prompt` needs a chat agent or a coding agent, as the app's Auto
244
+ * mode decides before starting a session. Rejects when Auto mode is not
245
+ * enabled for the caller, the classifier is unavailable or slow, or the
246
+ * caller is out of AI quota.
247
+ */
248
+ static chooseMode(client: RoxClient, prompt: string): Promise<AgentMode>;
249
+ protected fetch(): Promise<AgentSessionResponse>;
250
+ /** The session's user-facing display name. */
251
+ readonly name: () => Promise<string>;
252
+ /**
253
+ * What opened the session: who or what started it, and what it is about.
254
+ * Readable by anyone who can view the session, including other agents.
255
+ *
256
+ * @readonly
257
+ */
258
+ origin(): Promise<SessionOrigin>;
259
+ /**
260
+ * Who archived the session, making it read-only: `'user'`,
261
+ * `'pull_request_merged'` or `'runtime_closed'`. `undefined` while it is not
262
+ * archived.
263
+ */
264
+ readonly archivedBy: () => Promise<NonNullable<ArchiveCause | null | undefined> | undefined>;
265
+ /** When the session was archived (RFC 3339), or `undefined` while it is not. */
266
+ readonly archivedAt: () => Promise<string | undefined>;
267
+ /** The model currently configured for the session. */
268
+ readonly model: () => Promise<string>;
269
+ /** The agent harness implementation serving the session. */
270
+ readonly harness: () => Promise<string>;
271
+ /** The repository the agent works with, when one was supplied. */
272
+ readonly repoUrl: () => Promise<string | undefined>;
273
+ /** The directory in which the agent harness runs. */
274
+ readonly workspace: () => Promise<string>;
275
+ /**
276
+ * Instructions the session's runtime works under, when any were stated at
277
+ * creation. Fixed for the session's life.
278
+ */
279
+ readonly instructions: () => Promise<string | undefined>;
280
+ /** The session's latest runtime status. */
281
+ readonly status: () => Promise<import("../../../generated/agent-harness").SessionStatusDto>;
282
+ /** Compute tier of the managed sandbox. */
283
+ readonly sandboxSize: () => Promise<SandboxSize>;
284
+ /** When the session was created. */
285
+ readonly createdAt: () => Promise<string>;
286
+ /** When the session was last modified. */
287
+ readonly modifiedAt: () => Promise<string>;
288
+ /**
289
+ * The sessions linked to the GitHub pull request at `url` that the caller
290
+ * can view, oldest link first.
291
+ */
292
+ static forPullRequest(client: RoxClient, url: string): Promise<AgentSession[]>;
293
+ /**
294
+ * The caller's coding sessions waiting for an answer from them, or stalled
295
+ * for over 20 minutes, newest activity first. Only the 25 most recent such
296
+ * sessions are inspected.
297
+ */
298
+ static updates(client: RoxClient): Promise<AgentSessionUpdates>;
299
+ /**
300
+ * Tool calls this session's runtime holds until its owner approves them,
301
+ * oldest first. Answer each with {@link ToolApproval.answer}; only the
302
+ * owner may approve or decline. Permission requests and questions from the
303
+ * agent itself are answered with {@link control}.
304
+ *
305
+ * @readonly
306
+ */
307
+ pendingApprovals(): Promise<PendingToolApproval[]>;
308
+ /**
309
+ * Link this session to the task it works on, replacing any earlier link.
310
+ * Only the session's owner can link it, to a task they can view. The
311
+ * session's pull request, now or later, is linked to the task too.
312
+ *
313
+ * @write
314
+ */
315
+ linkTask(task: Task): Promise<LinkedTask>;
316
+ /**
317
+ * The GitHub pull requests linked to this session: the one its agent
318
+ * opened and any a person linked, oldest first.
319
+ *
320
+ * @readonly
321
+ */
322
+ pullRequests(): Promise<SessionPullRequest[]>;
323
+ /**
324
+ * Link the GitHub pull request at `url` to this session. Linking one that
325
+ * is already linked changes nothing.
326
+ *
327
+ * @write
328
+ * @idempotent
329
+ */
330
+ linkPullRequest(url: string): Promise<void>;
331
+ /**
332
+ * Unlink a GitHub pull request a person linked to this session. The pull
333
+ * request the session's agent opened stays linked.
334
+ *
335
+ * @write
336
+ * @idempotent
337
+ */
338
+ unlinkPullRequest(url: string): Promise<void>;
339
+ /**
340
+ * This session's auto-archive settings, and when a trigger archived it.
341
+ *
342
+ * @readonly
343
+ */
344
+ autoArchive(): Promise<SessionAutoArchive>;
345
+ /**
346
+ * Replace this session's auto-archive choices. Owner only; a trigger left
347
+ * `undefined` follows the owner's default.
348
+ *
349
+ * @write
350
+ * @idempotent
351
+ */
352
+ setAutoArchive(overrides: AutoArchiveOverrides): Promise<void>;
353
+ /**
354
+ * Rename this session.
355
+ *
356
+ * @write
357
+ * @idempotent
358
+ */
359
+ rename(name: string): Promise<void>;
360
+ /**
361
+ * Register this session as the caller's work, so it shows as what the caller
362
+ * is working on. Requires edit access. Registering again changes nothing.
363
+ *
364
+ * Registering does not share the session: a viewer who cannot open it does
365
+ * not see it, so share it too with {@link AgentSession.updateSharePermissions}.
366
+ *
367
+ * The registration ends on its own when the session's pull requests finish,
368
+ * when it is archived, after a day without work, or after a week blocked on
369
+ * input. A later turn does not register it again.
370
+ *
371
+ * @write
372
+ * @idempotent
373
+ */
374
+ registerAsWork(): Promise<RegisteredWork>;
375
+ /**
376
+ * End the caller's registration of this session as its work. Doing it again
377
+ * changes nothing. The session itself is untouched.
378
+ *
379
+ * @write
380
+ * @idempotent
381
+ */
382
+ unregisterAsWork(): Promise<void>;
383
+ /** The caller's active registrations, newest first. */
384
+ static listRegisteredWork(client: RoxClient): Promise<RegisteredWork[]>;
385
+ private static registeredWork;
386
+ /**
387
+ * Archive this session, making it read-only until unarchived.
388
+ *
389
+ * @write
390
+ * @idempotent
391
+ */
392
+ archive(): Promise<void>;
393
+ /**
394
+ * Restore an archived session so it can be edited and prompted again.
395
+ *
396
+ * @write
397
+ * @idempotent
398
+ */
399
+ unarchive(): Promise<void>;
400
+ private setArchived;
401
+ /**
402
+ * Resize this session's sandbox and remember the size as the owner's default.
403
+ *
404
+ * @write
405
+ * @idempotent
406
+ */
407
+ setSandboxSize(size: SandboxSize): Promise<SandboxSize>;
408
+ /** The caller's default sandbox size for new `@coder` sessions. */
409
+ static defaultSandboxSize(client: RoxClient): Promise<SandboxSize>;
410
+ /** Set the caller's default sandbox size for the next `@coder` mention. */
411
+ static setDefaultSandboxSize(client: RoxClient, size: SandboxSize): Promise<SandboxSize>;
412
+ /** What the caller's new coding sessions are told to do beyond their assignment. */
413
+ static codingPreferences(client: RoxClient): Promise<CodingPreferencesBody>;
414
+ /** Which triggers archive the caller's sessions by default; each is off unless chosen. */
415
+ static autoArchivePreferences(client: RoxClient): Promise<AutoArchivePreferencesBody>;
416
+ /** Replace which triggers archive the caller's sessions by default. */
417
+ static setAutoArchivePreferences(client: RoxClient, preferences: AutoArchivePreferencesBody): Promise<AutoArchivePreferencesBody>;
418
+ /** Replace the caller's coding preferences. */
419
+ static setCodingPreferences(client: RoxClient, preferences: CodingPreferencesBody): Promise<CodingPreferencesBody>;
420
+ /**
421
+ * Send a prompt or lifecycle operation to the live agent session.
422
+ *
423
+ * The returned `actionId` matches `requestId` on the folded message the
424
+ * action derives once it dispatches. A `queued` status means a turn was
425
+ * running: the action waits in the session's queue ({@link queue}) and
426
+ * dispatches when that turn ends.
427
+ *
428
+ * @destructive
429
+ * @openworld
430
+ */
431
+ control(action: AgentAction): Promise<ControlResponse>;
432
+ /**
433
+ * Send a prompt to the session — sugar over {@link control}.
434
+ *
435
+ * `attachments` are files the prompt refers to, each by a URL the agent
436
+ * can fetch (a static file service URL in practice); they reach the agent
437
+ * as ACP `resource_link` blocks after the text.
438
+ *
439
+ * @destructive
440
+ * @openworld
441
+ */
442
+ prompt(text: string, attachments?: PromptAttachment[]): Promise<ControlResponse>;
443
+ /**
444
+ * The actions waiting to dispatch in this session, oldest first. Each can
445
+ * be edited or removed until it dispatches.
446
+ *
447
+ * @readonly
448
+ */
449
+ queue(): Promise<QueuedAction[]>;
450
+ /**
451
+ * Read the latest captured GitHub pull request changes and capture status.
452
+ *
453
+ * @readonly
454
+ */
455
+ changes(): Promise<AgentSessionChangesResponse>;
456
+ /**
457
+ * Read the unified diff of the latest captured changeset.
458
+ *
459
+ * @readonly
460
+ */
461
+ changesPatch(): Promise<string>;
462
+ /**
463
+ * Request a fresh capture and return the current state while it runs.
464
+ *
465
+ * @write
466
+ * @idempotent
467
+ * @openworld
468
+ */
469
+ refreshChanges(): Promise<AgentSessionChangesResponse>;
470
+ /**
471
+ * Read this session's full conversation as the app renders it.
472
+ *
473
+ * Includes each user prompt and agent reply, oldest first, with tool calls and their
474
+ * results, plans, permission requests and how each turn ended. Works on any
475
+ * session the caller can view, live or finished, so it is the way to read
476
+ * what another agent session did. Prefer it to {@link log}, which returns
477
+ * raw protocol frames.
478
+ *
479
+ * @readonly
480
+ */
481
+ foldedLog(): Promise<FoldedAgentSessionLog>;
482
+ /**
483
+ * Read the complete raw protocol log for this session.
484
+ *
485
+ * @readonly
486
+ */
487
+ log(): Promise<AgentSessionLogResponse>;
488
+ /** Persisted reviews scoped to this session, with or without a code execution. */
489
+ readonly reviews: {
490
+ create: (input: CreateReviewOptions) => Promise<SessionReview>;
491
+ byId: (id: string) => SessionReview;
492
+ };
493
+ /** Views shown in this session at once, with nothing saved. */
494
+ readonly views: {
495
+ present: (view: SessionView) => Promise<void>;
496
+ };
497
+ /** Saved code executions scoped to this session. Handle construction makes no request. */
498
+ readonly codeExecutions: {
499
+ byId: (id: string) => CodeExecution;
500
+ };
501
+ /**
502
+ * Recorded activity caused by this session, lazily paginated newest first; `maxItems` caps the total.
503
+ *
504
+ * @readonly
505
+ */
506
+ activity(options?: AgentActivityOptions): AsyncGenerator<import("./activity").AgentActivity, any, any>;
507
+ /** Code-mode invocation handles, distinct from saved code executions. */
508
+ readonly invocations: {
509
+ byId: (id: string) => AgentInvocation;
510
+ };
511
+ /**
512
+ * Delete this session and any live resources it owns.
513
+ *
514
+ * @destructive
515
+ * @idempotent
516
+ */
517
+ delete(): Promise<void>;
518
+ }
@@ -0,0 +1,60 @@
1
+ import type { ExecutionRecord } from '../../../generated/agent-harness/types.gen';
2
+ import type { RoxClient } from '../../utils/client';
3
+ import { RoxEntity } from '../entity';
4
+ import type { AgentSession } from './agent-session';
5
+ import { type CreateReviewOptions, SessionReview } from './review';
6
+ import { type SessionView } from './view';
7
+ /** A saved code execution belonging to one agent session. */
8
+ export declare class CodeExecution extends RoxEntity<ExecutionRecord> {
9
+ private readonly parent;
10
+ private constructor();
11
+ /** Construct a lazy execution handle within its owning session. */
12
+ static byId(client: RoxClient, session: AgentSession, id: string): CodeExecution;
13
+ protected fetch(): Promise<ExecutionRecord>;
14
+ /** Persistent UI blocks, independent of the execution lifetime. */
15
+ readonly reviews: {
16
+ create: (input: CreateReviewOptions) => Promise<SessionReview>;
17
+ list: () => Promise<SessionReview[]>;
18
+ };
19
+ /** Views: shown to the user at once, with nothing saved. */
20
+ readonly views: {
21
+ present: (view: SessionView) => Promise<void>;
22
+ };
23
+ /**
24
+ * The session this execution belongs to.
25
+ *
26
+ * @readonly
27
+ */
28
+ session(): AgentSession;
29
+ /** Saved execution state. Call refresh to observe subsequent changes. */
30
+ readonly status: () => Promise<import("../../../generated/agent-harness").ExecutionStatus>;
31
+ /** The submitted JavaScript module source. */
32
+ readonly source: () => Promise<string>;
33
+ /** Legacy bridge calls; direct HTTP executions leave this empty. */
34
+ readonly calls: () => Promise<import("../../../generated/agent-harness").RecordedToolCall[]>;
35
+ /** Execution failure text, when present. */
36
+ readonly error: () => Promise<string | undefined>;
37
+ /**
38
+ * The program's returned JSON; preserves an explicit null result.
39
+ *
40
+ * @readonly
41
+ */
42
+ result(): Promise<unknown>;
43
+ /**
44
+ * Reload the saved state, for example after a running execution completes.
45
+ *
46
+ * @readonly
47
+ */
48
+ refresh(): Promise<this>;
49
+ }
50
+ /** JSON data returned to the model, plus references to independently saved UI. */
51
+ export type CodeResult = {
52
+ data: JsonValue;
53
+ reviews: Array<{
54
+ kind: 'email' | 'calendar';
55
+ id: string;
56
+ }>;
57
+ };
58
+ export type JsonValue = null | boolean | number | string | JsonValue[] | {
59
+ [key: string]: JsonValue;
60
+ };