primitive-admin 1.2.0-alpha.8 → 1.3.0-alpha.0

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 (563) hide show
  1. package/README.md +258 -186
  2. package/assets/skill/skills/primitive-platform/SKILL.md +103 -29
  3. package/dist/bin/primitive.js +15 -89
  4. package/dist/bin/primitive.js.map +1 -1
  5. package/dist/src/commands/admins.js +80 -17
  6. package/dist/src/commands/admins.js.map +1 -1
  7. package/dist/src/commands/agent-sessions.d.ts +129 -0
  8. package/dist/src/commands/agent-sessions.js +532 -20
  9. package/dist/src/commands/agent-sessions.js.map +1 -1
  10. package/dist/src/commands/analytics.js +207 -155
  11. package/dist/src/commands/analytics.js.map +1 -1
  12. package/dist/src/commands/apps-children.d.ts +1 -1
  13. package/dist/src/commands/apps-children.js +56 -145
  14. package/dist/src/commands/apps-children.js.map +1 -1
  15. package/dist/src/commands/apps-transitions.d.ts +39 -0
  16. package/dist/src/commands/apps-transitions.js +198 -0
  17. package/dist/src/commands/apps-transitions.js.map +1 -0
  18. package/dist/src/commands/apps.d.ts +17 -0
  19. package/dist/src/commands/apps.js +108 -3
  20. package/dist/src/commands/apps.js.map +1 -1
  21. package/dist/src/commands/auth-sessions.js +2 -0
  22. package/dist/src/commands/auth-sessions.js.map +1 -1
  23. package/dist/src/commands/auth.js +138 -44
  24. package/dist/src/commands/auth.js.map +1 -1
  25. package/dist/src/commands/blob-buckets.js +2 -0
  26. package/dist/src/commands/blob-buckets.js.map +1 -1
  27. package/dist/src/commands/collections.js +318 -256
  28. package/dist/src/commands/collections.js.map +1 -1
  29. package/dist/src/commands/comparisons.js +2 -0
  30. package/dist/src/commands/comparisons.js.map +1 -1
  31. package/dist/src/commands/config.d.ts +2 -2
  32. package/dist/src/commands/config.js +59 -33
  33. package/dist/src/commands/config.js.map +1 -1
  34. package/dist/src/commands/connections.js +2 -0
  35. package/dist/src/commands/connections.js.map +1 -1
  36. package/dist/src/commands/database-type-configs.js +5 -3
  37. package/dist/src/commands/database-type-configs.js.map +1 -1
  38. package/dist/src/commands/database-types.js +13 -313
  39. package/dist/src/commands/database-types.js.map +1 -1
  40. package/dist/src/commands/databases.js +6 -4
  41. package/dist/src/commands/databases.js.map +1 -1
  42. package/dist/src/commands/db3-types.d.ts +15 -0
  43. package/dist/src/commands/db3-types.js +159 -0
  44. package/dist/src/commands/db3-types.js.map +1 -0
  45. package/dist/src/commands/db3.d.ts +24 -0
  46. package/dist/src/commands/db3.js +1444 -0
  47. package/dist/src/commands/db3.js.map +1 -0
  48. package/dist/src/commands/documents.d.ts +110 -10
  49. package/dist/src/commands/documents.js +1012 -748
  50. package/dist/src/commands/documents.js.map +1 -1
  51. package/dist/src/commands/email-templates.js +74 -0
  52. package/dist/src/commands/email-templates.js.map +1 -1
  53. package/dist/src/commands/env.js +8 -4
  54. package/dist/src/commands/env.js.map +1 -1
  55. package/dist/src/commands/function-trigger-commands.d.ts +28 -0
  56. package/dist/src/commands/function-trigger-commands.js +341 -0
  57. package/dist/src/commands/function-trigger-commands.js.map +1 -0
  58. package/dist/src/commands/functions.js +376 -30
  59. package/dist/src/commands/functions.js.map +1 -1
  60. package/dist/src/commands/groups.js +168 -50
  61. package/dist/src/commands/groups.js.map +1 -1
  62. package/dist/src/commands/guides.js +7 -5
  63. package/dist/src/commands/guides.js.map +1 -1
  64. package/dist/src/commands/hosting.d.ts +8 -0
  65. package/dist/src/commands/hosting.js +346 -0
  66. package/dist/src/commands/hosting.js.map +1 -0
  67. package/dist/src/commands/init.js +129 -38
  68. package/dist/src/commands/init.js.map +1 -1
  69. package/dist/src/commands/integrations.js +82 -53
  70. package/dist/src/commands/integrations.js.map +1 -1
  71. package/dist/src/commands/llm.js +9 -6
  72. package/dist/src/commands/llm.js.map +1 -1
  73. package/dist/src/commands/locks.d.ts +5 -3
  74. package/dist/src/commands/locks.js +19 -61
  75. package/dist/src/commands/locks.js.map +1 -1
  76. package/dist/src/commands/metadata-category-configs.d.ts +2 -2
  77. package/dist/src/commands/metadata-category-configs.js +4 -2
  78. package/dist/src/commands/metadata-category-configs.js.map +1 -1
  79. package/dist/src/commands/metadata.js +41 -0
  80. package/dist/src/commands/metadata.js.map +1 -1
  81. package/dist/src/commands/prompts.js +75 -52
  82. package/dist/src/commands/prompts.js.map +1 -1
  83. package/dist/src/commands/rate-counters.d.ts +19 -0
  84. package/dist/src/commands/rate-counters.js +104 -0
  85. package/dist/src/commands/rate-counters.js.map +1 -0
  86. package/dist/src/commands/rule-sets.d.ts +1 -1
  87. package/dist/src/commands/rule-sets.js +2 -1
  88. package/dist/src/commands/rule-sets.js.map +1 -1
  89. package/dist/src/commands/schemas.d.ts +15 -0
  90. package/dist/src/commands/schemas.js +122 -0
  91. package/dist/src/commands/schemas.js.map +1 -0
  92. package/dist/src/commands/scripts.d.ts +9 -17
  93. package/dist/src/commands/scripts.js +24 -479
  94. package/dist/src/commands/scripts.js.map +1 -1
  95. package/dist/src/commands/secrets.js +47 -3
  96. package/dist/src/commands/secrets.js.map +1 -1
  97. package/dist/src/commands/sessions.js +2 -0
  98. package/dist/src/commands/sessions.js.map +1 -1
  99. package/dist/src/commands/settings.d.ts +12 -9
  100. package/dist/src/commands/settings.js +31 -79
  101. package/dist/src/commands/settings.js.map +1 -1
  102. package/dist/src/commands/skill.js +2 -0
  103. package/dist/src/commands/skill.js.map +1 -1
  104. package/dist/src/commands/sync-schemas.d.ts +202 -0
  105. package/dist/src/commands/sync-schemas.js +629 -0
  106. package/dist/src/commands/sync-schemas.js.map +1 -0
  107. package/dist/src/commands/sync-user-properties.d.ts +118 -0
  108. package/dist/src/commands/sync-user-properties.js +276 -0
  109. package/dist/src/commands/sync-user-properties.js.map +1 -0
  110. package/dist/src/commands/sync.d.ts +519 -554
  111. package/dist/src/commands/sync.js +3010 -4909
  112. package/dist/src/commands/sync.js.map +1 -1
  113. package/dist/src/commands/tokens.js +5 -3
  114. package/dist/src/commands/tokens.js.map +1 -1
  115. package/dist/src/commands/transitions.d.ts +54 -0
  116. package/dist/src/commands/transitions.js +418 -0
  117. package/dist/src/commands/transitions.js.map +1 -0
  118. package/dist/src/commands/usage.d.ts +18 -0
  119. package/dist/src/commands/usage.js +343 -0
  120. package/dist/src/commands/usage.js.map +1 -0
  121. package/dist/src/commands/user-properties.d.ts +14 -0
  122. package/dist/src/commands/user-properties.js +79 -0
  123. package/dist/src/commands/user-properties.js.map +1 -0
  124. package/dist/src/commands/users.js +911 -18
  125. package/dist/src/commands/users.js.map +1 -1
  126. package/dist/src/commands/vars.js +2 -0
  127. package/dist/src/commands/vars.js.map +1 -1
  128. package/dist/src/commands/waitlist.js +39 -4
  129. package/dist/src/commands/waitlist.js.map +1 -1
  130. package/dist/src/commands/workflows.d.ts +5 -83
  131. package/dist/src/commands/workflows.js +57 -2282
  132. package/dist/src/commands/workflows.js.map +1 -1
  133. package/dist/src/lib/analytics-query.d.ts +58 -0
  134. package/dist/src/lib/analytics-query.js +134 -0
  135. package/dist/src/lib/analytics-query.js.map +1 -0
  136. package/dist/src/lib/api-client.d.ts +1830 -429
  137. package/dist/src/lib/api-client.js +1025 -546
  138. package/dist/src/lib/api-client.js.map +1 -1
  139. package/dist/src/lib/app-settings-descriptor.d.ts +1 -1
  140. package/dist/src/lib/app-settings-descriptor.js +6 -0
  141. package/dist/src/lib/app-settings-descriptor.js.map +1 -1
  142. package/dist/src/lib/auth-fixtures.d.ts +44 -0
  143. package/dist/src/lib/auth-fixtures.js +61 -0
  144. package/dist/src/lib/auth-fixtures.js.map +1 -0
  145. package/dist/src/lib/auth-flow.d.ts +34 -1
  146. package/dist/src/lib/auth-flow.js +429 -13
  147. package/dist/src/lib/auth-flow.js.map +1 -1
  148. package/dist/src/lib/block-layout.d.ts +12 -23
  149. package/dist/src/lib/block-layout.js +26 -92
  150. package/dist/src/lib/block-layout.js.map +1 -1
  151. package/dist/src/lib/block-selector.d.ts +8 -14
  152. package/dist/src/lib/block-selector.js +8 -19
  153. package/dist/src/lib/block-selector.js.map +1 -1
  154. package/dist/src/lib/child-apps-local.d.ts +3 -47
  155. package/dist/src/lib/child-apps-local.js +11 -73
  156. package/dist/src/lib/child-apps-local.js.map +1 -1
  157. package/dist/src/lib/cli-manifest.d.ts +9 -0
  158. package/dist/src/lib/cli-manifest.js +10 -1
  159. package/dist/src/lib/cli-manifest.js.map +1 -1
  160. package/dist/src/lib/cli-version.d.ts +14 -0
  161. package/dist/src/lib/cli-version.js +38 -0
  162. package/dist/src/lib/cli-version.js.map +1 -0
  163. package/dist/src/lib/codegen-shared/prettierStable.d.ts +41 -0
  164. package/dist/src/lib/codegen-shared/prettierStable.js +146 -24
  165. package/dist/src/lib/codegen-shared/prettierStable.js.map +1 -1
  166. package/dist/src/lib/collection-export.d.ts +76 -15
  167. package/dist/src/lib/collection-export.js +116 -23
  168. package/dist/src/lib/collection-export.js.map +1 -1
  169. package/dist/src/lib/collection-principal.d.ts +22 -0
  170. package/dist/src/lib/collection-principal.js +35 -0
  171. package/dist/src/lib/collection-principal.js.map +1 -0
  172. package/dist/src/lib/command-groups.d.ts +30 -0
  173. package/dist/src/lib/command-groups.js +109 -0
  174. package/dist/src/lib/command-groups.js.map +1 -0
  175. package/dist/src/lib/command-status.d.ts +147 -0
  176. package/dist/src/lib/command-status.js +266 -0
  177. package/dist/src/lib/command-status.js.map +1 -0
  178. package/dist/src/lib/config-object-descriptor.d.ts +9 -22
  179. package/dist/src/lib/config-object-descriptor.js +107 -276
  180. package/dist/src/lib/config-object-descriptor.js.map +1 -1
  181. package/dist/src/lib/config-surface.d.ts +3 -7
  182. package/dist/src/lib/config-surface.js +9 -13
  183. package/dist/src/lib/config-surface.js.map +1 -1
  184. package/dist/src/lib/config-toml.d.ts +11 -2
  185. package/dist/src/lib/config-toml.js +25 -2
  186. package/dist/src/lib/config-toml.js.map +1 -1
  187. package/dist/src/lib/credentials-home.d.ts +7 -0
  188. package/dist/src/lib/credentials-home.js +45 -10
  189. package/dist/src/lib/credentials-home.js.map +1 -1
  190. package/dist/src/lib/credentials-lock.d.ts +14 -6
  191. package/dist/src/lib/credentials-lock.js +90 -10
  192. package/dist/src/lib/credentials-lock.js.map +1 -1
  193. package/dist/src/lib/credentials-store.d.ts +123 -70
  194. package/dist/src/lib/credentials-store.js +358 -113
  195. package/dist/src/lib/credentials-store.js.map +1 -1
  196. package/dist/src/lib/custodian.d.ts +8 -0
  197. package/dist/src/lib/custodian.js +18 -0
  198. package/dist/src/lib/custodian.js.map +1 -0
  199. package/dist/src/lib/data-input.d.ts +1 -1
  200. package/dist/src/lib/data-input.js +1 -1
  201. package/dist/src/lib/db-codegen/dbTsTypes.d.ts +1 -1
  202. package/dist/src/lib/db-codegen/dbTsTypes.js +3 -0
  203. package/dist/src/lib/db-codegen/dbTsTypes.js.map +1 -1
  204. package/dist/src/lib/db-codegen/dbTypeIR.d.ts +38 -1
  205. package/dist/src/lib/db-codegen/dbTypeIR.js +29 -7
  206. package/dist/src/lib/db-codegen/dbTypeIR.js.map +1 -1
  207. package/dist/src/lib/db-type-records.d.ts +106 -0
  208. package/dist/src/lib/db-type-records.js +224 -0
  209. package/dist/src/lib/db-type-records.js.map +1 -0
  210. package/dist/src/lib/db3-export.d.ts +287 -0
  211. package/dist/src/lib/db3-export.js +647 -0
  212. package/dist/src/lib/db3-export.js.map +1 -0
  213. package/dist/src/lib/db3-index-output.d.ts +116 -0
  214. package/dist/src/lib/db3-index-output.js +223 -0
  215. package/dist/src/lib/db3-index-output.js.map +1 -0
  216. package/dist/src/lib/db3-type-models.d.ts +134 -0
  217. package/dist/src/lib/db3-type-models.js +452 -0
  218. package/dist/src/lib/db3-type-models.js.map +1 -0
  219. package/dist/src/lib/deprecation.d.ts +2 -2
  220. package/dist/src/lib/deprecation.js +2 -2
  221. package/dist/src/lib/document-ingest-artifact.d.ts +13 -0
  222. package/dist/src/lib/document-ingest-artifact.js +36 -6
  223. package/dist/src/lib/document-ingest-artifact.js.map +1 -1
  224. package/dist/src/lib/document-ingest-format2.d.ts +36 -0
  225. package/dist/src/lib/document-ingest-format2.js +78 -0
  226. package/dist/src/lib/document-ingest-format2.js.map +1 -0
  227. package/dist/src/lib/document-ingest-input.d.ts +9 -0
  228. package/dist/src/lib/document-ingest-input.js +28 -1
  229. package/dist/src/lib/document-ingest-input.js.map +1 -1
  230. package/dist/src/lib/document-ingest.d.ts +11 -1
  231. package/dist/src/lib/document-ingest.js +16 -0
  232. package/dist/src/lib/document-ingest.js.map +1 -1
  233. package/dist/src/lib/document-schema-rows.d.ts +42 -0
  234. package/dist/src/lib/document-schema-rows.js +53 -0
  235. package/dist/src/lib/document-schema-rows.js.map +1 -0
  236. package/dist/src/lib/experimental-apis.d.ts +36 -0
  237. package/dist/src/lib/experimental-apis.js +46 -0
  238. package/dist/src/lib/experimental-apis.js.map +1 -0
  239. package/dist/src/lib/file-attachment.d.ts +24 -0
  240. package/dist/src/lib/file-attachment.js +31 -0
  241. package/dist/src/lib/file-attachment.js.map +1 -0
  242. package/dist/src/lib/function-authorize-check.d.ts +142 -0
  243. package/dist/src/lib/function-authorize-check.js +311 -0
  244. package/dist/src/lib/function-authorize-check.js.map +1 -0
  245. package/dist/src/lib/function-authorize-view.d.ts +27 -0
  246. package/dist/src/lib/function-authorize-view.js +88 -0
  247. package/dist/src/lib/function-authorize-view.js.map +1 -0
  248. package/dist/src/lib/function-bundle.d.ts +27 -5
  249. package/dist/src/lib/function-bundle.js +142 -7
  250. package/dist/src/lib/function-bundle.js.map +1 -1
  251. package/dist/src/lib/function-collect.d.ts +90 -12
  252. package/dist/src/lib/function-collect.js +482 -12
  253. package/dist/src/lib/function-collect.js.map +1 -1
  254. package/dist/src/lib/function-db-types.d.ts +65 -11
  255. package/dist/src/lib/function-db-types.js +297 -157
  256. package/dist/src/lib/function-db-types.js.map +1 -1
  257. package/dist/src/lib/function-document-types.d.ts +19 -7
  258. package/dist/src/lib/function-document-types.js +24 -12
  259. package/dist/src/lib/function-document-types.js.map +1 -1
  260. package/dist/src/lib/function-lint.d.ts +57 -0
  261. package/dist/src/lib/function-lint.js +234 -0
  262. package/dist/src/lib/function-lint.js.map +1 -0
  263. package/dist/src/lib/function-log-row.js +21 -2
  264. package/dist/src/lib/function-log-row.js.map +1 -1
  265. package/dist/src/lib/function-run.d.ts +13 -21
  266. package/dist/src/lib/function-run.js +14 -27
  267. package/dist/src/lib/function-run.js.map +1 -1
  268. package/dist/src/lib/function-schema-codegen.d.ts +86 -22
  269. package/dist/src/lib/function-schema-codegen.js +194 -88
  270. package/dist/src/lib/function-schema-codegen.js.map +1 -1
  271. package/dist/src/lib/function-schema-refs.d.ts +98 -0
  272. package/dist/src/lib/function-schema-refs.js +177 -0
  273. package/dist/src/lib/function-schema-refs.js.map +1 -0
  274. package/dist/src/lib/function-sync.d.ts +109 -6
  275. package/dist/src/lib/function-sync.js +179 -26
  276. package/dist/src/lib/function-sync.js.map +1 -1
  277. package/dist/src/lib/function-trigger-listing.d.ts +11 -6
  278. package/dist/src/lib/function-trigger-listing.js +32 -11
  279. package/dist/src/lib/function-trigger-listing.js.map +1 -1
  280. package/dist/src/lib/function-triggers.d.ts +15 -3
  281. package/dist/src/lib/function-triggers.js +72 -10
  282. package/dist/src/lib/function-triggers.js.map +1 -1
  283. package/dist/src/lib/function-typecheck.d.ts +52 -0
  284. package/dist/src/lib/function-typecheck.js +174 -54
  285. package/dist/src/lib/function-typecheck.js.map +1 -1
  286. package/dist/src/lib/function-versions.d.ts +2 -0
  287. package/dist/src/lib/function-versions.js +1 -0
  288. package/dist/src/lib/function-versions.js.map +1 -1
  289. package/dist/src/lib/generated-build-flags.d.ts +13 -0
  290. package/dist/src/lib/generated-build-flags.js +14 -0
  291. package/dist/src/lib/generated-build-flags.js.map +1 -0
  292. package/dist/src/lib/generated-command-status.d.ts +6 -0
  293. package/dist/src/lib/generated-command-status.js +469 -0
  294. package/dist/src/lib/generated-command-status.js.map +1 -0
  295. package/dist/src/lib/generated-config-surfaces.d.ts +586 -152
  296. package/dist/src/lib/generated-config-surfaces.js +1919 -1883
  297. package/dist/src/lib/generated-config-surfaces.js.map +1 -1
  298. package/dist/src/lib/generated-sdk-types.d.ts +1 -1
  299. package/dist/src/lib/generated-sdk-types.js +1 -1
  300. package/dist/src/lib/generated-sdk-types.js.map +1 -1
  301. package/dist/src/lib/generated-workflow-model-fields.d.ts +20 -0
  302. package/dist/src/lib/generated-workflow-model-fields.js +53 -0
  303. package/dist/src/lib/generated-workflow-model-fields.js.map +1 -0
  304. package/dist/src/lib/hosting-build.d.ts +97 -0
  305. package/dist/src/lib/hosting-build.js +204 -0
  306. package/dist/src/lib/hosting-build.js.map +1 -0
  307. package/dist/src/lib/hosting-client.d.ts +167 -0
  308. package/dist/src/lib/hosting-client.js +340 -0
  309. package/dist/src/lib/hosting-client.js.map +1 -0
  310. package/dist/src/lib/hosting-environments.d.ts +32 -0
  311. package/dist/src/lib/hosting-environments.js +74 -0
  312. package/dist/src/lib/hosting-environments.js.map +1 -0
  313. package/dist/src/lib/hosting-errors.d.ts +30 -0
  314. package/dist/src/lib/hosting-errors.js +43 -0
  315. package/dist/src/lib/hosting-errors.js.map +1 -0
  316. package/dist/src/lib/hosting-token.d.ts +46 -0
  317. package/dist/src/lib/hosting-token.js +60 -0
  318. package/dist/src/lib/hosting-token.js.map +1 -0
  319. package/dist/src/lib/hosting-wait.d.ts +42 -0
  320. package/dist/src/lib/hosting-wait.js +84 -0
  321. package/dist/src/lib/hosting-wait.js.map +1 -0
  322. package/dist/src/lib/hosting-wfp-upload.d.ts +86 -0
  323. package/dist/src/lib/hosting-wfp-upload.js +149 -0
  324. package/dist/src/lib/hosting-wfp-upload.js.map +1 -0
  325. package/dist/src/lib/init-assets.d.ts +2 -6
  326. package/dist/src/lib/init-assets.js +11 -27
  327. package/dist/src/lib/init-assets.js.map +1 -1
  328. package/dist/src/lib/init-ios-links.d.ts +11 -7
  329. package/dist/src/lib/init-ios-links.js +28 -22
  330. package/dist/src/lib/init-ios-links.js.map +1 -1
  331. package/dist/src/lib/init-login-note.d.ts +13 -0
  332. package/dist/src/lib/init-login-note.js +22 -0
  333. package/dist/src/lib/init-login-note.js.map +1 -0
  334. package/dist/src/lib/init-schema.d.ts +15 -0
  335. package/dist/src/lib/init-schema.js +54 -0
  336. package/dist/src/lib/init-schema.js.map +1 -1
  337. package/dist/src/lib/integration-test-request.d.ts +54 -0
  338. package/dist/src/lib/integration-test-request.js +207 -0
  339. package/dist/src/lib/integration-test-request.js.map +1 -0
  340. package/dist/src/lib/invoker-shared-enums.d.ts +35 -0
  341. package/dist/src/lib/invoker-shared-enums.js +98 -0
  342. package/dist/src/lib/invoker-shared-enums.js.map +1 -0
  343. package/dist/src/lib/json-value.d.ts +6 -0
  344. package/dist/src/lib/json-value.js +13 -0
  345. package/dist/src/lib/json-value.js.map +1 -0
  346. package/dist/src/lib/load-routes.d.ts +33 -0
  347. package/dist/src/lib/load-routes.js +35 -0
  348. package/dist/src/lib/load-routes.js.map +1 -0
  349. package/dist/src/lib/log-inspection.d.ts +23 -4
  350. package/dist/src/lib/log-inspection.js +14 -5
  351. package/dist/src/lib/log-inspection.js.map +1 -1
  352. package/dist/src/lib/login-exchange-check.d.ts +18 -0
  353. package/dist/src/lib/login-exchange-check.js +27 -0
  354. package/dist/src/lib/login-exchange-check.js.map +1 -0
  355. package/dist/src/lib/login-scope-lines.d.ts +17 -7
  356. package/dist/src/lib/login-scope-lines.js +33 -10
  357. package/dist/src/lib/login-scope-lines.js.map +1 -1
  358. package/dist/src/lib/metadata-report.d.ts +85 -0
  359. package/dist/src/lib/metadata-report.js +81 -0
  360. package/dist/src/lib/metadata-report.js.map +1 -0
  361. package/dist/src/lib/object-status-filter.d.ts +9 -1
  362. package/dist/src/lib/object-status-filter.js +9 -1
  363. package/dist/src/lib/object-status-filter.js.map +1 -1
  364. package/dist/src/lib/output.d.ts +1 -1
  365. package/dist/src/lib/output.js +3 -1
  366. package/dist/src/lib/output.js.map +1 -1
  367. package/dist/src/lib/pin-refusal-hint.d.ts +12 -0
  368. package/dist/src/lib/pin-refusal-hint.js +35 -0
  369. package/dist/src/lib/pin-refusal-hint.js.map +1 -0
  370. package/dist/src/lib/platform-owned.js +5 -0
  371. package/dist/src/lib/platform-owned.js.map +1 -1
  372. package/dist/src/lib/primitive-declaration-names.d.ts +21 -0
  373. package/dist/src/lib/primitive-declaration-names.js +22 -0
  374. package/dist/src/lib/primitive-declaration-names.js.map +1 -0
  375. package/dist/src/lib/primitive-declaration.d.ts +174 -0
  376. package/dist/src/lib/primitive-declaration.js +792 -0
  377. package/dist/src/lib/primitive-declaration.js.map +1 -0
  378. package/dist/src/lib/primitive-env-plugin.d.ts +99 -0
  379. package/dist/src/lib/primitive-env-plugin.js +408 -0
  380. package/dist/src/lib/primitive-env-plugin.js.map +1 -0
  381. package/dist/src/lib/project-login-apps.d.ts +8 -0
  382. package/dist/src/lib/project-login-apps.js +27 -0
  383. package/dist/src/lib/project-login-apps.js.map +1 -0
  384. package/dist/src/lib/prompt-schema-codegen.d.ts +46 -15
  385. package/dist/src/lib/prompt-schema-codegen.js +142 -108
  386. package/dist/src/lib/prompt-schema-codegen.js.map +1 -1
  387. package/dist/src/lib/prompt-schema-document.d.ts +35 -0
  388. package/dist/src/lib/prompt-schema-document.js +92 -0
  389. package/dist/src/lib/prompt-schema-document.js.map +1 -0
  390. package/dist/src/lib/prompt-schema-refs.d.ts +173 -0
  391. package/dist/src/lib/prompt-schema-refs.js +478 -0
  392. package/dist/src/lib/prompt-schema-refs.js.map +1 -0
  393. package/dist/src/lib/records-verbs.d.ts +79 -0
  394. package/dist/src/lib/records-verbs.js +45 -0
  395. package/dist/src/lib/records-verbs.js.map +1 -0
  396. package/dist/src/lib/register-commands.d.ts +36 -0
  397. package/dist/src/lib/register-commands.js +37 -0
  398. package/dist/src/lib/register-commands.js.map +1 -0
  399. package/dist/src/lib/retired-imports.d.ts +53 -0
  400. package/dist/src/lib/retired-imports.js +120 -0
  401. package/dist/src/lib/retired-imports.js.map +1 -0
  402. package/dist/src/lib/run-status.d.ts +1 -1
  403. package/dist/src/lib/run-status.generated.d.ts +2 -2
  404. package/dist/src/lib/run-status.generated.js +3 -1
  405. package/dist/src/lib/run-status.generated.js.map +1 -1
  406. package/dist/src/lib/run-status.js +1 -1
  407. package/dist/src/lib/schema-codegen/compiledSpace.d.ts +62 -0
  408. package/dist/src/lib/schema-codegen/compiledSpace.js +103 -0
  409. package/dist/src/lib/schema-codegen/compiledSpace.js.map +1 -0
  410. package/dist/src/lib/schema-codegen/generated-db3-bridge.d.ts +86 -0
  411. package/dist/src/lib/schema-codegen/generated-db3-bridge.js +227 -0
  412. package/dist/src/lib/schema-codegen/generated-db3-bridge.js.map +1 -0
  413. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.d.ts +85 -0
  414. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js +86 -0
  415. package/dist/src/lib/schema-codegen/generated-db3-query-capabilities.js.map +1 -0
  416. package/dist/src/lib/schema-codegen/generated-field-grammar.d.ts +218 -0
  417. package/dist/src/lib/schema-codegen/generated-field-grammar.js +397 -0
  418. package/dist/src/lib/schema-codegen/generated-field-grammar.js.map +1 -0
  419. package/dist/src/lib/schema-codegen/generated-field-table.d.ts +80 -0
  420. package/dist/src/lib/schema-codegen/generated-field-table.js +542 -0
  421. package/dist/src/lib/schema-codegen/generated-field-table.js.map +1 -0
  422. package/dist/src/lib/schema-codegen/generated-prompt-schemas.d.ts +195 -0
  423. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js +503 -0
  424. package/dist/src/lib/schema-codegen/generated-prompt-schemas.js.map +1 -0
  425. package/dist/src/lib/schema-codegen/generated-schema-descriptor.d.ts +258 -0
  426. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js +422 -0
  427. package/dist/src/lib/schema-codegen/generated-schema-descriptor.js.map +1 -0
  428. package/dist/src/lib/schema-codegen/generated-schema-file.d.ts +129 -0
  429. package/dist/src/lib/schema-codegen/generated-schema-file.js +475 -0
  430. package/dist/src/lib/schema-codegen/generated-schema-file.js.map +1 -0
  431. package/dist/src/lib/schema-codegen/generated-schema-provenance.d.ts +115 -0
  432. package/dist/src/lib/schema-codegen/generated-schema-provenance.js +274 -0
  433. package/dist/src/lib/schema-codegen/generated-schema-provenance.js.map +1 -0
  434. package/dist/src/lib/schema-codegen/generated-schema-refs.d.ts +366 -0
  435. package/dist/src/lib/schema-codegen/generated-schema-refs.js +1789 -0
  436. package/dist/src/lib/schema-codegen/generated-schema-refs.js.map +1 -0
  437. package/dist/src/lib/schema-codegen/generated-schema-shape.d.ts +27 -0
  438. package/dist/src/lib/schema-codegen/generated-schema-shape.js +126 -0
  439. package/dist/src/lib/schema-codegen/generated-schema-shape.js.map +1 -0
  440. package/dist/src/lib/schema-codegen/namedRefs.d.ts +56 -0
  441. package/dist/src/lib/schema-codegen/namedRefs.js +143 -0
  442. package/dist/src/lib/schema-codegen/namedRefs.js.map +1 -0
  443. package/dist/src/lib/schema-codegen/naming.d.ts +35 -0
  444. package/dist/src/lib/schema-codegen/naming.js +83 -0
  445. package/dist/src/lib/schema-codegen/naming.js.map +1 -0
  446. package/dist/src/lib/schema-codegen/schemaChanges.d.ts +74 -0
  447. package/dist/src/lib/schema-codegen/schemaChanges.js +277 -0
  448. package/dist/src/lib/schema-codegen/schemaChanges.js.map +1 -0
  449. package/dist/src/lib/schema-codegen/schemaDocs.d.ts +69 -0
  450. package/dist/src/lib/schema-codegen/schemaDocs.js +219 -0
  451. package/dist/src/lib/schema-codegen/schemaDocs.js.map +1 -0
  452. package/dist/src/lib/schema-codegen/schemaIR.d.ts +158 -0
  453. package/dist/src/lib/schema-codegen/schemaIR.js +279 -0
  454. package/dist/src/lib/schema-codegen/schemaIR.js.map +1 -0
  455. package/dist/src/lib/schema-codegen/schemaToTs.d.ts +109 -0
  456. package/dist/src/lib/schema-codegen/schemaToTs.js +269 -0
  457. package/dist/src/lib/schema-codegen/schemaToTs.js.map +1 -0
  458. package/dist/src/lib/schema-codegen/valuesLists.d.ts +48 -0
  459. package/dist/src/lib/schema-codegen/valuesLists.js +144 -0
  460. package/dist/src/lib/schema-codegen/valuesLists.js.map +1 -0
  461. package/dist/src/lib/schema-family-index.d.ts +228 -0
  462. package/dist/src/lib/schema-family-index.js +813 -0
  463. package/dist/src/lib/schema-family-index.js.map +1 -0
  464. package/dist/src/lib/schema-pins.d.ts +82 -0
  465. package/dist/src/lib/schema-pins.js +198 -0
  466. package/dist/src/lib/schema-pins.js.map +1 -0
  467. package/dist/src/lib/schema-preview.d.ts +244 -0
  468. package/dist/src/lib/schema-preview.js +498 -0
  469. package/dist/src/lib/schema-preview.js.map +1 -0
  470. package/dist/src/lib/scope-request.d.ts +23 -11
  471. package/dist/src/lib/scope-request.js +69 -31
  472. package/dist/src/lib/scope-request.js.map +1 -1
  473. package/dist/src/lib/session-scope.d.ts +26 -0
  474. package/dist/src/lib/session-scope.js +58 -0
  475. package/dist/src/lib/session-scope.js.map +1 -0
  476. package/dist/src/lib/skill-installer.d.ts +2 -2
  477. package/dist/src/lib/skill-installer.js +2 -21
  478. package/dist/src/lib/skill-installer.js.map +1 -1
  479. package/dist/src/lib/step-run-table.d.ts +1 -2
  480. package/dist/src/lib/step-run-table.js +1 -2
  481. package/dist/src/lib/step-run-table.js.map +1 -1
  482. package/dist/src/lib/swift-codegen/agentGenerator.d.ts +8 -3
  483. package/dist/src/lib/swift-codegen/agentGenerator.js +76 -22
  484. package/dist/src/lib/swift-codegen/agentGenerator.js.map +1 -1
  485. package/dist/src/lib/swift-codegen/banners.d.ts +12 -0
  486. package/dist/src/lib/swift-codegen/banners.js +12 -0
  487. package/dist/src/lib/swift-codegen/banners.js.map +1 -1
  488. package/dist/src/lib/swift-codegen/functionGenerator.d.ts +36 -1
  489. package/dist/src/lib/swift-codegen/functionGenerator.js +169 -51
  490. package/dist/src/lib/swift-codegen/functionGenerator.js.map +1 -1
  491. package/dist/src/lib/swift-codegen/schemaToSwift.d.ts +33 -9
  492. package/dist/src/lib/swift-codegen/schemaToSwift.js +215 -179
  493. package/dist/src/lib/swift-codegen/schemaToSwift.js.map +1 -1
  494. package/dist/src/lib/swift-codegen/sharedGenerator.d.ts +45 -0
  495. package/dist/src/lib/swift-codegen/sharedGenerator.js +165 -0
  496. package/dist/src/lib/swift-codegen/sharedGenerator.js.map +1 -0
  497. package/dist/src/lib/swift-codegen/swiftKeys.d.ts +19 -0
  498. package/dist/src/lib/swift-codegen/swiftKeys.js +31 -0
  499. package/dist/src/lib/swift-codegen/swiftKeys.js.map +1 -0
  500. package/dist/src/lib/swift-codegen/userPropertiesGenerator.d.ts +30 -0
  501. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js +69 -0
  502. package/dist/src/lib/swift-codegen/userPropertiesGenerator.js.map +1 -0
  503. package/dist/src/lib/sync-resource-types.d.ts +117 -31
  504. package/dist/src/lib/sync-resource-types.js +197 -189
  505. package/dist/src/lib/sync-resource-types.js.map +1 -1
  506. package/dist/src/lib/sync-selectors.d.ts +7 -0
  507. package/dist/src/lib/sync-selectors.js +22 -2
  508. package/dist/src/lib/sync-selectors.js.map +1 -1
  509. package/dist/src/lib/template.d.ts +39 -3
  510. package/dist/src/lib/template.js +103 -14
  511. package/dist/src/lib/template.js.map +1 -1
  512. package/dist/src/lib/test-case-file-names.d.ts +3 -5
  513. package/dist/src/lib/test-case-file-names.js +3 -5
  514. package/dist/src/lib/test-case-file-names.js.map +1 -1
  515. package/dist/src/lib/test-runs.d.ts +45 -0
  516. package/dist/src/lib/test-runs.js +150 -0
  517. package/dist/src/lib/test-runs.js.map +1 -0
  518. package/dist/src/lib/test-users.d.ts +25 -0
  519. package/dist/src/lib/test-users.js +36 -0
  520. package/dist/src/lib/test-users.js.map +1 -0
  521. package/dist/src/lib/toml-database-config.d.ts +4 -2
  522. package/dist/src/lib/toml-database-config.js +11 -6
  523. package/dist/src/lib/toml-database-config.js.map +1 -1
  524. package/dist/src/lib/toml-scalar-edit.js +6 -4
  525. package/dist/src/lib/toml-scalar-edit.js.map +1 -1
  526. package/dist/src/lib/transition-warnings.d.ts +21 -0
  527. package/dist/src/lib/transition-warnings.js +49 -0
  528. package/dist/src/lib/transition-warnings.js.map +1 -0
  529. package/dist/src/lib/user-index.d.ts +80 -0
  530. package/dist/src/lib/user-index.js +166 -0
  531. package/dist/src/lib/user-index.js.map +1 -0
  532. package/dist/src/lib/user-properties/generated-properties-schema.d.ts +159 -0
  533. package/dist/src/lib/user-properties/generated-properties-schema.js +471 -0
  534. package/dist/src/lib/user-properties/generated-properties-schema.js.map +1 -0
  535. package/dist/src/lib/user-properties/user-properties-codegen.d.ts +55 -0
  536. package/dist/src/lib/user-properties/user-properties-codegen.js +129 -0
  537. package/dist/src/lib/user-properties/user-properties-codegen.js.map +1 -0
  538. package/dist/src/lib/user-walk.d.ts +31 -0
  539. package/dist/src/lib/user-walk.js +102 -0
  540. package/dist/src/lib/user-walk.js.map +1 -0
  541. package/dist/src/lib/webhook-capture.d.ts +43 -0
  542. package/dist/src/lib/webhook-capture.js +91 -0
  543. package/dist/src/lib/webhook-capture.js.map +1 -0
  544. package/dist/src/lib/webhook-deliver.d.ts +18 -20
  545. package/dist/src/lib/webhook-deliver.js +34 -89
  546. package/dist/src/lib/webhook-deliver.js.map +1 -1
  547. package/dist/src/lib/webhook-test-run.d.ts +32 -0
  548. package/dist/src/lib/webhook-test-run.js +108 -0
  549. package/dist/src/lib/webhook-test-run.js.map +1 -0
  550. package/dist/src/lib/worker-perf-format.d.ts +22 -0
  551. package/dist/src/lib/worker-perf-format.js +27 -0
  552. package/dist/src/lib/worker-perf-format.js.map +1 -0
  553. package/dist/src/lib/workflow-field-descriptor.d.ts +91 -0
  554. package/dist/src/lib/workflow-field-descriptor.js +153 -0
  555. package/dist/src/lib/workflow-field-descriptor.js.map +1 -0
  556. package/dist/src/types/index.d.ts +20 -65
  557. package/dist/src/validators.d.ts +7 -55
  558. package/dist/src/validators.js +7 -53
  559. package/dist/src/validators.js.map +1 -1
  560. package/dist/src/vite.d.ts +17 -0
  561. package/dist/src/vite.js +18 -0
  562. package/dist/src/vite.js.map +1 -0
  563. package/package.json +20 -9
@@ -1,6 +1,12 @@
1
+ import { commandStatus } from "../lib/command-status.js";
2
+ import { createHash } from "crypto";
3
+ import { readFileSync, writeFileSync } from "fs";
4
+ import { basename, resolve as resolvePath } from "path";
5
+ import { lookup as mimeLookup } from "mime-types";
6
+ import { ulid } from "ulid";
1
7
  import { ApiClient } from "../lib/api-client.js";
2
8
  import { resolveAppId } from "../lib/config.js";
3
- import { error, formatDate, formatTable, info, json, result, success, } from "../lib/output.js";
9
+ import { error, formatDate, formatDuration, formatTable, info, json, keyValue, result, success, } from "../lib/output.js";
4
10
  import { confirmPrompt } from "../lib/confirm-prompt.js";
5
11
  import { pageCursorOption, pageLimitOption, parsePageLimit, printEmptyPage, printPageHint, } from "../lib/list-options.js";
6
12
  import { normalizeCliListEnvelope } from "../lib/paginate.js";
@@ -9,10 +15,13 @@ import { describeRecordsFailure } from "./documents.js";
9
15
  * `primitive agent-sessions` — inspect and delete agent sessions (#3809,
10
16
  * design-docs/agents.md §D7). A data noun: `list` one user's sessions, `get`
11
17
  * one session's binding, status, active turn and — for app owners and admins —
12
- * the session object's state, and `delete` a session with its document. The
13
- * conversation's rows are never copied here; they are read by opening the
14
- * session's document (`documents records query`). `primitive sessions` is
15
- * sign-in sessions.
18
+ * the session object's state (`inspect` is `get`), and `delete` a session with
19
+ * everything it holds. `transcript`, `steps` and `artifacts` read the
20
+ * conversation's rows from the session's db3, whose id is the session's
21
+ * (#4883), and `upload` and `download` move a session's files (#4589). The
22
+ * rows never hold the system prompt or a turn's context, so those stay
23
+ * visible only through `get` to app owners and admins. `primitive sessions`
24
+ * is sign-in sessions.
16
25
  */
17
26
  /** The `object` keys `get` prints as sections; any other key is printed as JSON. */
18
27
  const OBJECT_SECTIONS = new Set([
@@ -27,12 +36,19 @@ const OBJECT_SECTIONS = new Set([
27
36
  "calls",
28
37
  ]);
29
38
  const ROWS_NOTE = `
30
- The conversation itself (messages, parts, steps) lives in the session's
31
- document and is never copied by these commands. Read it with:
32
- $ primitive documents records query <document-id> PrimitiveMessage
33
- $ primitive documents records query <document-id> PrimitivePart
34
- $ primitive documents records query <document-id> PrimitiveStep
35
- $ primitive documents records query <document-id> PrimitiveSession
39
+ The conversation itself (messages, parts, tool calls, steps, turns) lives in
40
+ the session's db3, whose id is the session's. Read it with:
41
+ $ primitive agent-sessions transcript <session-id>
42
+ $ primitive agent-sessions steps <session-id>
43
+ $ primitive agent-sessions artifacts <session-id>
44
+ or as raw rows of its models (Session, Member, Turn, Message, Part, ToolCall,
45
+ Step):
46
+ $ primitive db3 records query <session-id> Message
47
+ $ primitive db3 records query <session-id> ToolCall
48
+ `;
49
+ /** Who `transcript`, `steps` and `artifacts` answer: the session db3's readers. */
50
+ const READERS_NOTE = `The rows are read from the session's db3: every member of the session reads
51
+ them, and so do the app's owners and admins and a console admin of the app.
36
52
  `;
37
53
  const list = (values) => Array.isArray(values) && values.length > 0 ? values.map(String).join(", ") : "-";
38
54
  /**
@@ -42,7 +58,7 @@ const list = (values) => Array.isArray(values) && values.length > 0 ? values.map
42
58
  */
43
59
  export async function deleteAgentSessionAction(options, deps) {
44
60
  if (!options.yes) {
45
- const ok = await deps.confirm(`Delete agent session ${options.sessionId} and its document? This cannot be undone.`);
61
+ const ok = await deps.confirm(`Delete agent session ${options.sessionId} with its conversation and files? This cannot be undone.`);
46
62
  if (!ok)
47
63
  return "cancelled";
48
64
  }
@@ -132,24 +148,309 @@ function printObject(object) {
132
148
  console.log(JSON.stringify(value, null, 2));
133
149
  }
134
150
  }
151
+ /** A part's and a tool call's JSON columns: stored as text, printed as the values they hold. */
152
+ const PART_JSON_COLUMNS = ["input", "output", "artifact", "providerMetadata", "data"];
153
+ /** A step's JSON columns. */
154
+ const STEP_JSON_COLUMNS = ["historySelection"];
155
+ /** At most this many message ids in one parts filter: the records route's `$in` cap. */
156
+ export const PARTS_BATCH_SIZE = 1000;
157
+ /**
158
+ * At most this many bytes of encoded filter in one parts request. The filter
159
+ * rides in the query string and Cloudflare refuses a URL over 16 KB, so this
160
+ * leaves room for the path, the sort, the limit and a continuation cursor.
161
+ */
162
+ export const PARTS_FILTER_MAX_BYTES = 8 * 1024;
163
+ /** Parts asked for per request: the records route's maximum `limit`. */
164
+ const PARTS_PAGE_LIMIT = 10_000;
165
+ /** The most parts requests one transcript page makes before it fails. */
166
+ export const MAX_PARTS_REQUESTS = 64;
167
+ /**
168
+ * A session row with its JSON columns decoded from their stored text. A
169
+ * column whose text is not JSON is left as that text.
170
+ */
171
+ export function decodeSessionRow(row, columns = PART_JSON_COLUMNS) {
172
+ const decoded = { ...row };
173
+ for (const column of columns) {
174
+ const text = decoded[column];
175
+ if (typeof text !== "string")
176
+ continue;
177
+ try {
178
+ decoded[column] = JSON.parse(text);
179
+ }
180
+ catch {
181
+ // Not JSON: kept as it came.
182
+ }
183
+ }
184
+ return decoded;
185
+ }
186
+ /** A text's length once encoded into the query string, as the api client sends it. */
187
+ const queryBytes = (text) => new URLSearchParams({ q: text }).toString().length - "q=".length;
188
+ /** The parts filter around its ids, `{"messageId":{"$in":[]}}`, encoded. */
189
+ const PARTS_FILTER_FRAME_BYTES = queryBytes(JSON.stringify({ messageId: { $in: [] } }));
190
+ const ID_SEPARATOR_BYTES = queryBytes(",");
191
+ /**
192
+ * Message ids in order, in batches one parts filter can carry: at most
193
+ * `maxIds` ids (the `$in` cap) and at most `maxFilterBytes` of encoded filter
194
+ * (the URL budget). An id too long for the budget alone gets a batch of its own.
195
+ */
196
+ export function batchMessageIds(ids, { maxIds = PARTS_BATCH_SIZE, maxFilterBytes = PARTS_FILTER_MAX_BYTES } = {}) {
197
+ const batches = [];
198
+ let batch = [];
199
+ let bytes = PARTS_FILTER_FRAME_BYTES;
200
+ for (const id of ids) {
201
+ const idBytes = queryBytes(JSON.stringify(id));
202
+ if (batch.length > 0 && (batch.length >= maxIds || bytes + ID_SEPARATOR_BYTES + idBytes > maxFilterBytes)) {
203
+ batches.push(batch);
204
+ batch = [];
205
+ bytes = PARTS_FILTER_FRAME_BYTES;
206
+ }
207
+ bytes += (batch.length > 0 ? ID_SEPARATOR_BYTES : 0) + idBytes;
208
+ batch.push(id);
209
+ }
210
+ if (batch.length > 0)
211
+ batches.push(batch);
212
+ return batches;
213
+ }
214
+ /**
215
+ * The page's messages in their order, each with a `parts` array of its parts
216
+ * — its `Part` rows and its `ToolCall` rows, a call as `kind: "tool_call"` —
217
+ * by `seq`, whatever order they arrived in.
218
+ */
219
+ export function joinTranscriptPage(messages, parts) {
220
+ const byMessage = new Map();
221
+ for (const part of parts) {
222
+ const own = byMessage.get(part.messageId);
223
+ if (own)
224
+ own.push(part);
225
+ else
226
+ byMessage.set(part.messageId, [part]);
227
+ }
228
+ return messages.map((message) => ({
229
+ ...message,
230
+ parts: [...(byMessage.get(message.id) ?? [])].sort((a, b) => Number(a.seq) - Number(b.seq)),
231
+ }));
232
+ }
233
+ /** Where a tool call's artifact lives: on a blob, inline on the row, or nowhere. */
234
+ export function artifactOf(part) {
235
+ if (typeof part.artifactBlobId === "string" && part.artifactBlobId) {
236
+ return { kind: "blob", blobId: part.artifactBlobId };
237
+ }
238
+ if (part.artifact !== undefined && part.artifact !== null)
239
+ return { kind: "inline", value: part.artifact };
240
+ return { kind: "none" };
241
+ }
242
+ function artifactLabel(part) {
243
+ const artifact = artifactOf(part);
244
+ return artifact.kind === "blob" ? `blob ${artifact.blobId}` : artifact.kind === "inline" ? "inline" : "-";
245
+ }
246
+ /** A decoded value on one line: text as it is, anything else as compact JSON. */
247
+ const compact = (value) => (typeof value === "string" ? value : JSON.stringify(value));
248
+ const present = (value) => value !== undefined && value !== null && value !== "";
249
+ function formatPart(part) {
250
+ switch (part.kind) {
251
+ case "text":
252
+ case "reasoning":
253
+ return [` [${part.kind}] ${String(part.text ?? "").replace(/\n/g, "\n ")}`];
254
+ case "tool_call": {
255
+ const lines = [` [tool_call] ${part.toolName} (${part.id}) ${part.state}`];
256
+ if (present(part.input))
257
+ lines.push(` input: ${compact(part.input)}`);
258
+ if (present(part.output))
259
+ lines.push(` output: ${compact(part.output)}`);
260
+ if (artifactOf(part).kind !== "none")
261
+ lines.push(` artifact: ${artifactLabel(part)}`);
262
+ if (present(part.errorCode) || present(part.errorText)) {
263
+ lines.push(` error: ${[part.errorCode, part.errorText].filter(present).join(" ")}`);
264
+ }
265
+ return lines;
266
+ }
267
+ case "file":
268
+ return [` [file] ${part.filename} ${part.mediaType} ${part.sizeBytes} bytes blob ${part.blobId}`];
269
+ case "event":
270
+ return [` [event] ${part.eventKind}${present(part.data) ? ` ${compact(part.data)}` : ""}`];
271
+ default:
272
+ // A kind this CLI does not know yet, as it came.
273
+ return [` [${part.kind}] ${JSON.stringify(part)}`];
274
+ }
275
+ }
276
+ /** One transcript message as `transcript` prints it: a header, then a line per part. */
277
+ export function formatTranscriptMessage(message) {
278
+ const header = [
279
+ `#${message.seq}`,
280
+ message.authorKind,
281
+ message.authorUserId,
282
+ formatDate(message.createdAt),
283
+ message.turnId ? `turn ${message.turnId}` : undefined,
284
+ ]
285
+ .filter(present)
286
+ .join(" ");
287
+ return [header, ...(Array.isArray(message.parts) ? message.parts : []).flatMap(formatPart)];
288
+ }
289
+ /** A `ToolCall` row as one of its message's parts: `kind: "tool_call"`, its JSON columns decoded. */
290
+ const callPart = (row) => ({ ...decodeSessionRow(row), kind: "tool_call" });
291
+ function envelopeOf(page, items) {
292
+ return { items, hasMore: page.hasMore, ...(page.nextCursor ? { nextCursor: page.nextCursor } : {}) };
293
+ }
294
+ /** Every row of `model` whose `messageId` is one of `ids`, in batches each followed through its cursor. */
295
+ async function rowsOfMessages(client, options, model, ids, budget) {
296
+ const rows = [];
297
+ for (const batch of batchMessageIds(ids)) {
298
+ let cursor;
299
+ do {
300
+ if (budget.requests >= MAX_PARTS_REQUESTS) {
301
+ throw new Error(`Transcript page too large to assemble (${ids.length} messages, more than ${MAX_PARTS_REQUESTS} parts requests); use a smaller --limit.`);
302
+ }
303
+ budget.requests++;
304
+ const answer = await client.queryDb3Records(options.appId, options.sessionId, model, {
305
+ filter: { messageId: { $in: batch } },
306
+ sort: { seq: 1 },
307
+ limit: PARTS_PAGE_LIMIT,
308
+ cursor,
309
+ });
310
+ rows.push(...answer.items);
311
+ cursor = answer.hasMore ? answer.nextCursor : undefined;
312
+ } while (cursor);
313
+ }
314
+ return rows;
315
+ }
316
+ /**
317
+ * One page of a session's conversation, oldest first: the `Message` rows of
318
+ * the session's db3 by `seq`, each with every one of its `Part` and
319
+ * `ToolCall` rows. Those are read in batches of message ids, each followed
320
+ * through its cursor, so a printed message is never missing a part; a page
321
+ * that needs more than `MAX_PARTS_REQUESTS` requests fails instead.
322
+ */
323
+ export async function transcriptAction(options, client) {
324
+ const page = await client.queryDb3Records(options.appId, options.sessionId, "Message", {
325
+ ...(options.turnId ? { filter: { turnId: options.turnId } } : {}),
326
+ sort: { seq: 1 },
327
+ limit: options.limit,
328
+ cursor: options.cursor,
329
+ });
330
+ const ids = page.items.map((message) => message.id);
331
+ const budget = { requests: 0 };
332
+ const parts = (await rowsOfMessages(client, options, "Part", ids, budget)).map((part) => decodeSessionRow(part));
333
+ const calls = (await rowsOfMessages(client, options, "ToolCall", ids, budget)).map(callPart);
334
+ return envelopeOf(page, joinTranscriptPage(page.items, [...parts, ...calls]));
335
+ }
336
+ /** One page of a session's steps, oldest first: the `Step` rows of its db3. */
337
+ export async function stepsAction(options, client) {
338
+ const page = await client.queryDb3Records(options.appId, options.sessionId, "Step", {
339
+ ...(options.turnId ? { filter: { turnId: options.turnId } } : {}),
340
+ sort: { startedAt: 1 },
341
+ limit: options.limit,
342
+ cursor: options.cursor,
343
+ });
344
+ return envelopeOf(page, page.items.map((step) => decodeSessionRow(step, STEP_JSON_COLUMNS)));
345
+ }
346
+ /** One page of a session's tool calls, oldest first: the `ToolCall` rows of its db3. */
347
+ export async function toolCallsAction(options, client) {
348
+ const page = await client.queryDb3Records(options.appId, options.sessionId, "ToolCall", {
349
+ sort: { createdAt: 1 },
350
+ limit: options.limit,
351
+ cursor: options.cursor,
352
+ });
353
+ return envelopeOf(page, page.items.map(callPart));
354
+ }
355
+ /**
356
+ * One tool call's artifact: `found: false` when the session has no tool call
357
+ * by that id, else its value — read from the session's attachment when the
358
+ * artifact is a blob, `null` when the call has none.
359
+ */
360
+ export async function readArtifactAction(options, client) {
361
+ const page = await client.queryDb3Records(options.appId, options.sessionId, "ToolCall", {
362
+ filter: { id: options.callId },
363
+ limit: 1,
364
+ });
365
+ const [call] = page.items;
366
+ if (!call)
367
+ return { found: false };
368
+ const artifact = artifactOf(decodeSessionRow(call));
369
+ if (artifact.kind === "none")
370
+ return { found: true, value: null };
371
+ if (artifact.kind === "inline")
372
+ return { found: true, value: artifact.value };
373
+ const bytes = await client.downloadAgentSessionAttachment(options.appId, options.sessionId, artifact.blobId);
374
+ return { found: true, value: JSON.parse(bytes.toString("utf8")) };
375
+ }
376
+ /**
377
+ * Upload one file to a session: read it, then one `PUT` on the session's
378
+ * attachment route with the size and base64 SHA-256 the route checks. The
379
+ * blob ID defaults to a fresh ULID, the filename to the file's basename and
380
+ * the content type to the filename's MIME type. An unreadable file fails
381
+ * before any request.
382
+ */
383
+ export async function uploadAttachmentAction(options, client) {
384
+ let data;
385
+ try {
386
+ data = readFileSync(resolvePath(options.filePath));
387
+ }
388
+ catch (err) {
389
+ throw new Error(`Failed to read file: ${err?.message ?? String(err)}`);
390
+ }
391
+ const blobId = options.blobId || ulid();
392
+ const filename = options.filename || basename(options.filePath) || "upload";
393
+ const contentType = options.contentType || mimeLookup(filename) || "application/octet-stream";
394
+ const sha256 = createHash("sha256").update(data).digest("base64");
395
+ const answer = await client.uploadAgentSessionAttachment(options.appId, options.sessionId, blobId, data, {
396
+ filename,
397
+ contentType,
398
+ sha256,
399
+ });
400
+ return { answer, blobId, filename, contentType, numBytes: data.length };
401
+ }
402
+ /**
403
+ * Download one of a session's files: the bytes go to `output` with a success
404
+ * line, or to stdout alone. A refusal throws with nothing written.
405
+ */
406
+ export async function downloadAttachmentAction(options, deps) {
407
+ const data = await deps.client.downloadAgentSessionAttachment(options.appId, options.sessionId, options.blobId);
408
+ if (options.output) {
409
+ deps.writeFile(resolvePath(options.output), data);
410
+ deps.print(`Downloaded to ${options.output} (${data.length} bytes)`);
411
+ }
412
+ else {
413
+ deps.writeStdout(data);
414
+ }
415
+ return data;
416
+ }
417
+ /** The step table's display row. */
418
+ function stepCells(step) {
419
+ const providerModel = [step.provider, step.model].filter(present).join("/");
420
+ return {
421
+ ...step,
422
+ providerModel: providerModel || step.toolName || step.functionName || "-",
423
+ tokens: present(step.totalTokens) ? step.totalTokens : "-",
424
+ costCell: present(step.cost) ? step.cost : "-",
425
+ errorCell: step.errorCode || "-",
426
+ };
427
+ }
135
428
  export function registerAgentSessionsCommands(program) {
136
429
  const agentSessions = program
137
430
  .command("agent-sessions")
138
- .description("Inspect and delete agent sessions")
431
+ .description("Inspect agent sessions, read their conversations, move their files, and delete them")
139
432
  .addHelpText("after", `
140
433
  An agent session is one conversation with an agent, created by a server
141
434
  function (ctx.agents.createSession). App owners and admins list any user's
142
435
  sessions, get any session — including the session object's state: each
143
436
  turn's pinned system prompt and tools, the queue and the call ledger — and
144
- delete any session. This is not \`primitive sessions\`, which lists sign-in
145
- sessions.
437
+ delete any session. Members read their own sessions' transcript, steps and
438
+ artifacts, and the owner and participants upload files to them. This is not
439
+ \`primitive sessions\`, which lists sign-in sessions.
146
440
  ${ROWS_NOTE}
147
441
  Examples:
148
442
  $ primitive agent-sessions list --user-id 01HXY...
149
443
  $ primitive agent-sessions list --user-id 01HXY... --agent advisor --json
150
444
  $ primitive agent-sessions get 01HXZ...
445
+ $ primitive agent-sessions transcript 01HXZ... --limit 20
446
+ $ primitive agent-sessions steps 01HXZ... --turn 01HXT...
447
+ $ primitive agent-sessions artifacts 01HXZ...
448
+ $ primitive agent-sessions artifacts 01HXZ... call_01HXP... --json
449
+ $ primitive agent-sessions upload 01HXZ... ./receipt.png
450
+ $ primitive agent-sessions download 01HXZ... 01HXB... --output ./receipt.png
151
451
  $ primitive agent-sessions delete 01HXZ... --yes
152
452
  `);
453
+ commandStatus(agentSessions, { stability: "beta" });
153
454
  agentSessions
154
455
  .command("list")
155
456
  .description("List one user's agent sessions, newest first")
@@ -195,7 +496,6 @@ Examples:
195
496
  // The listed user's unread dot (#4256): activity they have not marked read.
196
497
  { header: "UNREAD", key: "hasUnread", format: (value) => (value === true ? "•" : "-") },
197
498
  { header: "LAST ACTIVITY", key: "lastActivityAt", format: formatDate },
198
- { header: "DOCUMENT", key: "documentId" },
199
499
  ]));
200
500
  printPageHint(page);
201
501
  }
@@ -206,6 +506,7 @@ Examples:
206
506
  });
207
507
  agentSessions
208
508
  .command("get")
509
+ .alias("inspect")
209
510
  .description("Show an agent session: its binding, status, members, active turn and object state")
210
511
  .argument("<session-id>", "Session ID")
211
512
  .option("--app <app-id>", "App ID (uses current app if not specified)")
@@ -227,7 +528,6 @@ ${ROWS_NOTE}`)
227
528
  }
228
529
  result("Session ID", session.sessionId);
229
530
  result("Agent", session.agentKey);
230
- result("Document ID", session.documentId);
231
531
  result("Owner", session.ownerUserId);
232
532
  result("Created", formatDate(session.createdAt));
233
533
  result("Status", session.status);
@@ -248,16 +548,228 @@ ${ROWS_NOTE}`)
248
548
  process.exit(1);
249
549
  }
250
550
  });
551
+ agentSessions
552
+ .command("transcript")
553
+ .description("Show one page of a session's conversation: its messages, oldest first, with their parts")
554
+ .argument("<session-id>", "Session ID")
555
+ .option("--app <app-id>", "App ID (uses current app if not specified)")
556
+ .option("--turn <turn-id>", "Only this turn's messages")
557
+ .addOption(pageLimitOption())
558
+ .addOption(pageCursorOption())
559
+ .option("--json", "Output as JSON")
560
+ .addHelpText("after", `
561
+ Each message prints with its parts: text, reasoning, tool calls (input, output
562
+ and where the artifact lives), files and events. --json prints the one list
563
+ envelope, each message with a \`parts\` array and the JSON columns decoded.
564
+
565
+ ${READERS_NOTE}`)
566
+ .action(async (sessionId, options) => {
567
+ const limit = parsePageLimit(options.limit);
568
+ const resolvedAppId = resolveAppId(undefined, options);
569
+ try {
570
+ const page = await transcriptAction({ appId: resolvedAppId, sessionId, limit, cursor: options.cursor, turnId: options.turn }, new ApiClient());
571
+ if (options.json) {
572
+ json(page);
573
+ return;
574
+ }
575
+ if (page.items.length === 0) {
576
+ printEmptyPage(page, "messages");
577
+ return;
578
+ }
579
+ for (const message of page.items)
580
+ console.log(formatTranscriptMessage(message).join("\n"));
581
+ printPageHint(page);
582
+ }
583
+ catch (err) {
584
+ error(describeRecordsFailure(err));
585
+ process.exit(1);
586
+ }
587
+ });
588
+ agentSessions
589
+ .command("steps")
590
+ .description("Show one page of a session's turn steps, oldest first: model, tool, context and history calls")
591
+ .argument("<session-id>", "Session ID")
592
+ .option("--app <app-id>", "App ID (uses current app if not specified)")
593
+ .option("--turn <turn-id>", "Only this turn's steps")
594
+ .addOption(pageLimitOption())
595
+ .addOption(pageCursorOption())
596
+ .option("--json", "Output as JSON")
597
+ .addHelpText("after", `\n${READERS_NOTE}`)
598
+ .action(async (sessionId, options) => {
599
+ const limit = parsePageLimit(options.limit);
600
+ const resolvedAppId = resolveAppId(undefined, options);
601
+ try {
602
+ const page = await stepsAction({ appId: resolvedAppId, sessionId, limit, cursor: options.cursor, turnId: options.turn }, new ApiClient());
603
+ if (options.json) {
604
+ json(page);
605
+ return;
606
+ }
607
+ if (page.items.length === 0) {
608
+ printEmptyPage(page, "steps");
609
+ return;
610
+ }
611
+ console.log(formatTable(page.items.map(stepCells), [
612
+ { header: "TURN", key: "turnId" },
613
+ { header: "SEQ", key: "seq" },
614
+ { header: "KIND", key: "kind" },
615
+ { header: "STATUS", key: "status" },
616
+ { header: "STARTED", key: "startedAt", format: formatDate },
617
+ { header: "DURATION", key: "durationMs", format: formatDuration },
618
+ { header: "PROVIDER/MODEL", key: "providerModel" },
619
+ { header: "TOKENS", key: "tokens" },
620
+ { header: "COST", key: "costCell" },
621
+ { header: "ERROR", key: "errorCell" },
622
+ ]));
623
+ printPageHint(page);
624
+ }
625
+ catch (err) {
626
+ error(describeRecordsFailure(err));
627
+ process.exit(1);
628
+ }
629
+ });
630
+ agentSessions
631
+ .command("artifacts")
632
+ .description("List a session's tool calls and where their artifacts live, or print one call's artifact")
633
+ .argument("<session-id>", "Session ID")
634
+ .argument("[call-id]", "A tool call's ID: print its artifact")
635
+ .option("--app <app-id>", "App ID (uses current app if not specified)")
636
+ .addOption(pageLimitOption())
637
+ .addOption(pageCursorOption())
638
+ .option("--json", "Output as JSON")
639
+ .addHelpText("after", `
640
+ Without a call ID, one page of the session's tool calls, oldest first; the
641
+ ARTIFACT column says whether each artifact is inline, on a blob, or absent.
642
+ With a call ID (the CALL column), the artifact's value as JSON, read from the
643
+ session's attachments when it is a blob.
644
+
645
+ ${READERS_NOTE}`)
646
+ .action(async (sessionId, callId, options) => {
647
+ const resolvedAppId = resolveAppId(undefined, options);
648
+ if (callId !== undefined) {
649
+ try {
650
+ const read = await readArtifactAction({ appId: resolvedAppId, sessionId, callId }, new ApiClient());
651
+ if (!read.found) {
652
+ error(`No tool call ${callId} in session ${sessionId}`);
653
+ process.exit(1);
654
+ }
655
+ if (read.value === null && !options.json) {
656
+ info("This call has no artifact.");
657
+ return;
658
+ }
659
+ json(read.value);
660
+ }
661
+ catch (err) {
662
+ error(describeRecordsFailure(err));
663
+ process.exit(1);
664
+ }
665
+ return;
666
+ }
667
+ const limit = parsePageLimit(options.limit);
668
+ try {
669
+ const page = await toolCallsAction({ appId: resolvedAppId, sessionId, limit, cursor: options.cursor }, new ApiClient());
670
+ if (options.json) {
671
+ json(page);
672
+ return;
673
+ }
674
+ if (page.items.length === 0) {
675
+ printEmptyPage(page, "tool calls");
676
+ return;
677
+ }
678
+ console.log(formatTable(page.items.map((call) => ({ ...call, artifactCell: artifactLabel(call) })), [
679
+ { header: "CALL", key: "id" },
680
+ { header: "TOOL", key: "toolName" },
681
+ { header: "STATE", key: "state" },
682
+ { header: "MESSAGE", key: "messageId" },
683
+ { header: "ARTIFACT", key: "artifactCell" },
684
+ ]));
685
+ printPageHint(page);
686
+ }
687
+ catch (err) {
688
+ error(describeRecordsFailure(err));
689
+ process.exit(1);
690
+ }
691
+ });
692
+ agentSessions
693
+ .command("upload")
694
+ .description("Upload a file to a session, for a message to reference")
695
+ .argument("<session-id>", "Session ID")
696
+ .argument("<file-path>", "Path to the file to upload")
697
+ .option("--app <app-id>", "App ID (uses current app if not specified)")
698
+ .option("--blob-id <id>", "Blob ID to upload under (a new ULID if not specified)")
699
+ .option("--filename <name>", "Filename to store (the file's own name if not specified)")
700
+ .option("--content-type <type>", "Content type (from the filename's extension if not specified)")
701
+ .option("--json", "Output the server's answer as JSON")
702
+ .addHelpText("after", `
703
+ The session's owner and participants upload. Uploading the same bytes under
704
+ the same blob ID again succeeds without sending them; different bytes under
705
+ an existing ID are refused. A message carries the file by its blob ID.
706
+ `)
707
+ .action(async (sessionId, filePath, options) => {
708
+ const resolvedAppId = resolveAppId(undefined, options);
709
+ try {
710
+ const done = await uploadAttachmentAction({
711
+ appId: resolvedAppId,
712
+ sessionId,
713
+ filePath,
714
+ blobId: options.blobId,
715
+ filename: options.filename,
716
+ contentType: options.contentType,
717
+ }, new ApiClient());
718
+ if (options.json) {
719
+ json(done.answer);
720
+ return;
721
+ }
722
+ const blobId = done.answer?.blobId ?? done.blobId;
723
+ const filename = done.answer?.filename ?? done.filename;
724
+ success(`${done.answer?.bytesTransferred === 0 ? "Already uploaded" : "Uploaded"} ${filename} to session ${sessionId}.`);
725
+ keyValue("Blob ID", blobId);
726
+ keyValue("Filename", filename);
727
+ keyValue("Content Type", done.answer?.contentType ?? done.contentType);
728
+ keyValue("Size", `${done.answer?.numBytes ?? done.numBytes} bytes`);
729
+ info(`Reference it in a message as files: [{ blobId: "${blobId}" }].`);
730
+ }
731
+ catch (err) {
732
+ error(describeRecordsFailure(err));
733
+ process.exit(1);
734
+ }
735
+ });
736
+ agentSessions
737
+ .command("download")
738
+ .description("Download one of a session's files: an upload or a tool call's artifact blob")
739
+ .argument("<session-id>", "Session ID")
740
+ .argument("<blob-id>", "Blob ID")
741
+ .option("--app <app-id>", "App ID (uses current app if not specified)")
742
+ .option("--output <path>", "Output file path (defaults to stdout)")
743
+ .addHelpText("after", `
744
+ Every member of the session and every app owner and admin downloads. Without
745
+ --output the bytes are written to stdout unchanged.
746
+ `)
747
+ .action(async (sessionId, blobId, options) => {
748
+ const resolvedAppId = resolveAppId(undefined, options);
749
+ try {
750
+ await downloadAttachmentAction({ appId: resolvedAppId, sessionId, blobId, output: options.output }, {
751
+ client: new ApiClient(),
752
+ writeFile: (path, data) => writeFileSync(path, data),
753
+ writeStdout: (data) => process.stdout.write(data),
754
+ print: success,
755
+ });
756
+ }
757
+ catch (err) {
758
+ error(describeRecordsFailure(err));
759
+ process.exit(1);
760
+ }
761
+ });
251
762
  agentSessions
252
763
  .command("delete")
253
- .description("Delete an agent session and its document")
764
+ .description("Delete an agent session with its conversation and files")
254
765
  .argument("<session-id>", "Session ID")
255
766
  .option("--app <app-id>", "App ID (uses current app if not specified)")
256
767
  .option("-y, --yes", "Skip confirmation prompt")
257
768
  .option("--json", "Output as JSON")
258
769
  .addHelpText("after", `
259
- The session's owner, app owners and admins delete; the document and its rows
260
- go with it. Deleting a session that is already deleted succeeds again.
770
+ The session's owner, app owners and admins delete; its db3, its rows and its
771
+ files go with it. A delete that stopped part-way finishes when run again; once
772
+ it is done the session is not found.
261
773
  `)
262
774
  .action(async (sessionId, options) => {
263
775
  const resolvedAppId = resolveAppId(undefined, options);