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
@@ -24,14 +24,20 @@
24
24
  * without this the bare `primitive-functions` specifier every function
25
25
  * imports would not resolve at all, and the augmentation would have
26
26
  * nothing to augment;
27
- * - `primitive-function-types.d.ts` (#3281, rendered by
28
- * `function-schema-codegen.ts`) — every function's `<Key>Input` and
29
- * `<Key>Output` from its declared schemas, and the `FunctionSchemas`
30
- * augmentation that types `defineFunction("<key>", handler)`;
27
+ * - `primitive.d.ts` (#5544, rendered by `primitive-declaration.ts`) —
28
+ * every `schemas/` def, function, prompt, db3 model and user property
29
+ * type under one namespace per family, and the augmentations that type
30
+ * `defineFunction`, `ctx.prompts.run`, `ctx.db3` and `ctx.users`. It
31
+ * replaced four per-family files (`RETIRED_DECLARATIONS`), which are
32
+ * removed;
31
33
  * - `primitive-document-types.d.ts` (#3281, rendered by
32
34
  * `function-document-types.ts`) — the project's document models from
33
35
  * `models/models.toml`, and the `DocumentSchemas` augmentation that types
34
- * `ctx.doc(documentId).model("<Model>")`; open when the project has none;
36
+ * `ctx.doc(documentId).model("<Model>")`; not written when the project has
37
+ * none (#5206), and dropped from an explicit tsconfig `files` list then.
38
+ * #5208 — inside a project it is typed from `models/models.toml` only,
39
+ * and the generated schema copy a pull or push once wrote beside it is
40
+ * removed (`plannedRemovals`);
35
41
  * - `generated/<key>.generated.ts` (#3281, same renderer) — the per-key
36
42
  * CLIENT invoker, carrying every verb since #3482. Excluded from
37
43
  * the scaffolded program (it imports `js-bao-wss-client`), and written to
@@ -56,13 +62,17 @@
56
62
  import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync, } from "fs";
57
63
  import { basename, dirname, join, relative, resolve, sep } from "path";
58
64
  import { parseConfigToml } from "./config-toml.js";
59
- import { FUNCTION_INVOKERS_DIR, FUNCTION_TYPES_DECLARATION_FILE, GENERATED_FILE_SUFFIX, functionSchemaSources, renderFunctionInvokers, renderFunctionSchemasDeclaration, } from "./function-schema-codegen.js";
65
+ import { FUNCTION_INVOKERS_DIR, FunctionSchemaCodegenError, GENERATED_FILE_SUFFIX, functionSchemaSources, } from "./function-schema-codegen.js";
60
66
  import { DOCUMENT_TYPES_DECLARATION_FILE, DOCUMENT_SCHEMA_TREE_FILE, resolveDocumentSchema, renderDocumentTypesDeclaration, } from "./function-document-types.js";
61
- import { AGENT_CLIENT_FILE_SUFFIX, PROMPT_TYPES_DECLARATION_FILE, promptSchemaSources, renderAgentClientFiles, renderPromptSchemasDeclaration, } from "./prompt-schema-codegen.js";
62
- import { describeDbType } from "./db-codegen/dbTypeIR.js";
63
- import { tsTypeForDbFieldType } from "./db-codegen/dbTsTypes.js";
64
- import { objectPropertyKey } from "./db-codegen/dbNaming.js";
67
+ import { AGENT_CLIENT_FILE_SUFFIX, promptSchemaSources, renderAgentClientFiles, } from "./prompt-schema-codegen.js";
68
+ import { typeEntries } from "./db-type-records.js";
69
+ import { primitiveDeclarationInputs, renderPrimitiveDeclaration } from "./primitive-declaration.js";
70
+ import { renderFunctionInvokerSet } from "./invoker-shared-enums.js";
71
+ import { PRIMITIVE_DECLARATION_FILE, PRIMITIVE_DECLARATION_SPECIFIER, RETIRED_DECLARATIONS, } from "./primitive-declaration-names.js";
65
72
  import { SDK_TYPES_SOURCE } from "./generated-sdk-types.js";
73
+ import { USER_PROPERTIES_CLIENT_FILE, USER_PROPERTIES_FILE, renderUserPropertiesClientTypes, treeHasUserProperties, userPropertiesSource, } from "./user-properties/user-properties-codegen.js";
74
+ export { db3TypeSources } from "./db-type-records.js";
75
+ export { PRIMITIVE_DECLARATION_FILE, RETIRED_DECLARATIONS } from "./primitive-declaration-names.js";
66
76
  export const DB_TYPES_DECLARATION_FILE = "primitive-db-types.d.ts";
67
77
  export const SDK_TYPES_FILE = "primitive-functions.d.ts";
68
78
  export const FUNCTIONS_TSCONFIG_FILE = "tsconfig.json";
@@ -76,11 +86,12 @@ export const FUNCTIONS_TSCONFIG_FILE = "tsconfig.json";
76
86
  export const REGENERATED_DECLARATIONS = [
77
87
  DB_TYPES_DECLARATION_FILE,
78
88
  SDK_TYPES_FILE,
79
- FUNCTION_TYPES_DECLARATION_FILE,
89
+ // #5544 — every function, prompt, schemas/ def, db3 and user property type.
90
+ PRIMITIVE_DECLARATION_FILE,
80
91
  DOCUMENT_TYPES_DECLARATION_FILE,
81
- // #3330 — the prompt output types, from the tree's `prompts/*.toml`.
82
- PROMPT_TYPES_DECLARATION_FILE,
83
92
  ];
93
+ /** Every declaration codegen ever writes or once wrote. */
94
+ const ALL_DECLARATIONS = [...REGENERATED_DECLARATIONS, ...RETIRED_DECLARATIONS.map((retired) => retired.file)];
84
95
  /** The scaffold's exclusion for the client invokers (#3281). */
85
96
  export const GENERATED_EXCLUDE = `${FUNCTION_INVOKERS_DIR}/**`;
86
97
  const HEADER = `// GENERATED by \`primitive config push\` from database-type-configs/*.toml.
@@ -94,31 +105,6 @@ const HEADER = `// GENERATED by \`primitive config push\` from database-type-con
94
105
  // platform owns rather than the schema, added by the SDK's own row type, so it
95
106
  // is not repeated per model here whether or not a model declares one.
96
107
  `;
97
- function quote(value) {
98
- return JSON.stringify(value);
99
- }
100
- /**
101
- * A model or field name as a TYPE member key.
102
- *
103
- * Model and field names are whatever the TOML says — js-bao preserves them
104
- * verbatim — so `Order-Item` and `first-name` are ordinary schemas and are not
105
- * TypeScript identifiers. Emitting one raw makes the whole declaration a syntax
106
- * error, which breaks the editor and `tsc` wiring for every OTHER type in the
107
- * tree too. The client generators' own `objectPropertyKey` answers this,
108
- * except that its `__proto__` case is a computed key — legal in an object
109
- * literal, not in a type member — so that one is quoted instead.
110
- */
111
- function memberKey(name) {
112
- const key = objectPropertyKey(name);
113
- return key.startsWith("[") ? quote(name) : key;
114
- }
115
- /** A TS string-literal union, or `string` when there is nothing to narrow to. */
116
- function fieldType(type, enumValues) {
117
- if (type === "string" && Array.isArray(enumValues) && enumValues.length > 0) {
118
- return enumValues.map((v) => quote(v)).join(" | ");
119
- }
120
- return tsTypeForDbFieldType(type);
121
- }
122
108
  /**
123
109
  * The declaration for a whole config tree's database types.
124
110
  *
@@ -129,57 +115,12 @@ function fieldType(type, enumValues) {
129
115
  export function renderDbTypesDeclaration(sources) {
130
116
  const types = [...sources].sort((a, b) => a.databaseType < b.databaseType ? -1 : a.databaseType > b.databaseType ? 1 : 0);
131
117
  const lines = [HEADER, "export interface PrimitiveDatabaseSchemas {"];
132
- for (const source of types) {
133
- let records = [];
134
- try {
135
- const ir = describeDbType({
136
- databaseType: source.databaseType,
137
- tomlPath: source.tomlPath,
138
- tomlContent: source.tomlContent,
139
- });
140
- records = [...ir.records]
141
- .sort((a, b) => (a.modelName < b.modelName ? -1 : 1))
142
- .map((record) => {
143
- const declared = new Set();
144
- const members = [];
145
- for (const field of record.fields) {
146
- declared.add(field.name);
147
- members.push(` ${memberKey(field.name)}${field.required ? "" : "?"}: ${fieldType(field.type, field.enum)};`);
148
- }
149
- // Server-stamped fields exist on a read row but not on one a
150
- // function just built, so they are optional — the same call the
151
- // client renderer makes.
152
- for (const stamped of [...ir.stampedFields].sort()) {
153
- if (declared.has(stamped))
154
- continue;
155
- declared.add(stamped);
156
- members.push(` ${memberKey(stamped)}?: string;`);
157
- }
158
- return { modelName: record.modelName, members };
159
- });
160
- }
161
- catch {
162
- // A type whose TOML this renderer cannot describe contributes no models
163
- // rather than failing the push: its own preflight reports the file, and
164
- // an untyped handle is what a schemaless type gets anyway.
165
- records = [];
166
- }
167
- if (records.length === 0) {
168
- lines.push(` ${quote(source.databaseType)}: {};`);
169
- continue;
170
- }
171
- lines.push(` ${quote(source.databaseType)}: {`);
172
- for (const record of records) {
173
- if (record.members.length === 0) {
174
- lines.push(` ${memberKey(record.modelName)}: Record<string, unknown>;`);
175
- continue;
176
- }
177
- lines.push(` ${memberKey(record.modelName)}: {`);
178
- lines.push(...record.members);
179
- lines.push(` };`);
180
- }
181
- lines.push(` };`);
182
- }
118
+ lines.push(...typeEntries(types.map((source) => ({
119
+ key: source.databaseType,
120
+ tomlPath: source.tomlPath,
121
+ tomlContent: source.tomlContent,
122
+ table: "database",
123
+ })), "optional"));
183
124
  lines.push("}");
184
125
  lines.push("");
185
126
  // The augmentation. Only emitted when there is something to bind: an empty
@@ -193,8 +134,14 @@ export function renderDbTypesDeclaration(sources) {
193
134
  }
194
135
  return lines.join("\n");
195
136
  }
196
- /** The scaffolded compiler wiring. Written once; an author owns it after. */
197
- export function renderFunctionsTsconfig() {
137
+ /**
138
+ * The scaffolded compiler wiring. Written once; an author owns it after.
139
+ *
140
+ * `absent` names the regenerated declarations the tree does not get, which
141
+ * the scaffold leaves out of `include` (#5898).
142
+ */
143
+ export function renderFunctionsTsconfig(absent = []) {
144
+ const declarations = REGENERATED_DECLARATIONS.filter((file) => !absent.includes(file));
198
145
  return (JSON.stringify({
199
146
  // Scaffolded by `primitive config push` (#3182). Yours to adjust — push
200
147
  // writes it once and then leaves it alone. What it must keep doing is
@@ -221,7 +168,7 @@ export function renderFunctionsTsconfig() {
221
168
  "primitive-functions": [`./${SDK_TYPES_FILE}`],
222
169
  },
223
170
  },
224
- include: ["**/*.ts", ...REGENERATED_DECLARATIONS.map((file) => `./${file}`)],
171
+ include: ["**/*.ts", ...declarations.map((file) => `./${file}`)],
225
172
  // The client invokers (#3281) import `js-bao-wss-client`, which a
226
173
  // config tree does not install: they are for the app's client code,
227
174
  // and an editor program that swept them in would report every one of
@@ -305,6 +252,10 @@ function isGlobEntry(entry) {
305
252
  function isDeclarationEntry(entry, file) {
306
253
  return entry === `./${file}` || entry === file;
307
254
  }
255
+ /** The retired declaration an entry names (#5544), or null. */
256
+ function retiredEntryOf(entry) {
257
+ return RETIRED_DECLARATIONS.find((retired) => isDeclarationEntry(entry, retired.file)) ?? null;
258
+ }
308
259
  /** `"./**\/*.ts"` and `"**\/*.ts"` name the same set; read them the same way. */
309
260
  function normalizeEntry(entry) {
310
261
  return entry.startsWith("./") ? entry.slice(2) : entry;
@@ -351,7 +302,7 @@ function coversSubdirectories(entry) {
351
302
  function isSourceEntry(entry) {
352
303
  if (typeof entry !== "string")
353
304
  return false;
354
- if (REGENERATED_DECLARATIONS.some((file) => isDeclarationEntry(entry, file))) {
305
+ if (ALL_DECLARATIONS.some((file) => isDeclarationEntry(entry, file))) {
355
306
  return false;
356
307
  }
357
308
  return isGlobEntry(entry) || entry.endsWith(".ts");
@@ -399,11 +350,17 @@ function tsconfigWiringGaps(parsed, context) {
399
350
  const declarationsCovered = listed.some(coversDeclarations);
400
351
  const reachesSubdirectories = listed.some(coversSubdirectories);
401
352
  const exclude = Array.isArray(parsed.exclude) ? parsed.exclude : [];
353
+ const absent = context.absentDeclarations ?? [];
402
354
  return {
403
355
  mapping: !mapped.includes(`./${SDK_TYPES_FILE}`),
404
356
  missingDeclarations: implicitlyAll || declarationsCovered
405
357
  ? []
406
- : REGENERATED_DECLARATIONS.filter((file) => !listed.some((entry) => isDeclarationEntry(entry, file))),
358
+ : REGENERATED_DECLARATIONS.filter((file) => !absent.includes(file) && !listed.some((entry) => isDeclarationEntry(entry, file))),
359
+ absentFiles: files.filter((entry) => typeof entry === "string" && absent.some((file) => isDeclarationEntry(entry, file))),
360
+ retiredEntries: [
361
+ ...include.filter((entry) => retiredEntryOf(entry)).map((entry) => ({ list: "include", entry: entry })),
362
+ ...files.filter((entry) => retiredEntryOf(entry)).map((entry) => ({ list: "files", entry: entry })),
363
+ ],
407
364
  sources: !implicitlyAll && !declarationsCovered && !listed.some(isSourceEntry),
408
365
  // Only a program that would SEE the directory needs the exclusion: an
409
366
  // explicit list that reaches no subdirectory never sweeps it in.
@@ -413,7 +370,12 @@ function tsconfigWiringGaps(parsed, context) {
413
370
  };
414
371
  }
415
372
  function hasGaps(gaps) {
416
- return (gaps.mapping || gaps.missingDeclarations.length > 0 || gaps.sources || gaps.generatedExclusion);
373
+ return (gaps.mapping ||
374
+ gaps.missingDeclarations.length > 0 ||
375
+ gaps.sources ||
376
+ gaps.generatedExclusion ||
377
+ gaps.absentFiles.length > 0 ||
378
+ gaps.retiredEntries.length > 0);
417
379
  }
418
380
  function describeGaps(gaps) {
419
381
  const problems = [];
@@ -433,6 +395,17 @@ function describeGaps(gaps) {
433
395
  problems.push(`\`exclude\` does not cover "${GENERATED_EXCLUDE}", so the generated client ` +
434
396
  "invokers (which import `js-bao-wss-client`) are swept into the program");
435
397
  }
398
+ if (gaps.absentFiles.length > 0) {
399
+ problems.push(`\`files\` names ${gaps.absentFiles
400
+ .map((entry) => `"${entry}"`)
401
+ .join(", ")}, which codegen no longer writes, so the compiler reports it missing`);
402
+ }
403
+ for (const { list, entry } of gaps.retiredEntries) {
404
+ const retired = retiredEntryOf(entry);
405
+ problems.push(`\`${list}\` names "${entry}", which codegen no longer writes: its types are in ` +
406
+ `"./${PRIMITIVE_DECLARATION_FILE}" under ${retired.namespace}, so remove the entry` +
407
+ (list === "files" ? ` and list "./${PRIMITIVE_DECLARATION_FILE}"` : ""));
408
+ }
436
409
  return problems;
437
410
  }
438
411
  /**
@@ -458,7 +431,7 @@ function describeGaps(gaps) {
458
431
  */
459
432
  export function inspectFunctionsTsconfig(existing, context = { generatedDirExists: false }) {
460
433
  if (existing === null) {
461
- return { repaired: renderFunctionsTsconfig(), problems: [] };
434
+ return { repaired: renderFunctionsTsconfig(context.absentDeclarations), problems: [] };
462
435
  }
463
436
  let parsed;
464
437
  let plainJson = true;
@@ -508,6 +481,20 @@ export function inspectFunctionsTsconfig(existing, context = { generatedDirExist
508
481
  : [];
509
482
  paths[SDK_MODULE_SPECIFIER] = [...mapped, `./${SDK_TYPES_FILE}`];
510
483
  }
484
+ if (gaps.retiredEntries.length > 0) {
485
+ // #5544 — a retired declaration's entry goes; its replacement comes back
486
+ // through the missing-declaration repair below, and a `files` list the
487
+ // removal empties goes with it, the sources then coming through `include`.
488
+ for (const list of ["include", "files"]) {
489
+ if (!Array.isArray(parsed[list]))
490
+ continue;
491
+ const kept = parsed[list].filter((entry) => !retiredEntryOf(entry));
492
+ if (list === "files" && kept.length === 0)
493
+ delete parsed.files;
494
+ else
495
+ parsed[list] = kept;
496
+ }
497
+ }
511
498
  if (gaps.missingDeclarations.length > 0 || gaps.sources) {
512
499
  const include = Array.isArray(parsed.include) ? parsed.include : [];
513
500
  const added = [];
@@ -527,6 +514,15 @@ export function inspectFunctionsTsconfig(existing, context = { generatedDirExist
527
514
  const exclude = Array.isArray(parsed.exclude) ? parsed.exclude : [];
528
515
  parsed.exclude = [...exclude, GENERATED_EXCLUDE];
529
516
  }
517
+ if (gaps.absentFiles.length > 0 && Array.isArray(parsed.files)) {
518
+ // #5206 — a root that no longer exists is dropped; an emptied list goes
519
+ // with it, since the sources then come through `include`.
520
+ const files = parsed.files.filter((entry) => !gaps.absentFiles.includes(entry));
521
+ if (files.length > 0)
522
+ parsed.files = files;
523
+ else
524
+ delete parsed.files;
525
+ }
530
526
  return { repaired: JSON.stringify(parsed, null, 2) + "\n", problems: [] };
531
527
  }
532
528
  /**
@@ -630,37 +626,74 @@ function planAgentClientArtifacts(configDir, options) {
630
626
  };
631
627
  });
632
628
  }
629
+ /**
630
+ * The app's client types of `user-properties.toml` (#5385), where the
631
+ * invokers go: client code needs them whether or not the tree has functions.
632
+ */
633
+ function planUserPropertiesClientArtifacts(configDir, options, userProperties) {
634
+ if (!userProperties)
635
+ return [];
636
+ const absolute = join(functionInvokerDir(configDir, options), USER_PROPERTIES_CLIENT_FILE);
637
+ return [
638
+ {
639
+ relative: reportedPath(configDir, absolute),
640
+ absolute,
641
+ contents: renderUserPropertiesClientTypes(userProperties),
642
+ regenerated: true,
643
+ source: USER_PROPERTIES_FILE,
644
+ },
645
+ ];
646
+ }
633
647
  /**
634
648
  * What push would write, without writing it.
635
649
  *
636
- * Only the agents' client artifacts when the tree has no `functions/`
637
- * directory (#3798, DSO-3798-005), and nothing at all when it has neither:
638
- * the other artifacts exist to type function sources, and a tree with none
639
- * needs no compiler wiring.
650
+ * Only the client artifacts — the agents' (#3798, DSO-3798-005) and the user
651
+ * property types (#5385) — when the tree has no `functions/` directory, and
652
+ * nothing at all when it has none of them: the other artifacts exist to type
653
+ * function sources, and a tree with none needs no compiler wiring.
640
654
  */
641
655
  export function planFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
642
656
  const functionsDir = join(configDir, "functions");
643
657
  const agentArtifacts = planAgentClientArtifacts(configDir, options);
644
- if (!treeHasFunctionsDir(configDir))
645
- return agentArtifacts;
646
- // #3455 — one resolution for both the declaration below and the tree copy.
658
+ if (!treeHasFunctionsDir(configDir)) {
659
+ const clientArtifacts = [
660
+ ...planUserPropertiesClientArtifacts(configDir, options, userPropertiesSource(configDir)),
661
+ ...agentArtifacts,
662
+ ];
663
+ refuseSharedDestinations(clientArtifacts);
664
+ return clientArtifacts;
665
+ }
666
+ // #3455 — one resolution for the document declaration below.
647
667
  const documentSchema = resolveDocumentSchema(configDir);
648
- const declaration = renderDbTypesDeclaration(databaseTypeSources(configDir));
649
- // #3281 — the functions declaration and the per-key invokers, from the same
668
+ // #5898 — `ctx.db`'s declaration only for a tree with database types: with
669
+ // none it would be an empty interface, and the one an earlier run wrote goes
670
+ // (`retiredFunctionTypeArtifacts`). The handle stays open without it.
671
+ const databaseTypes = databaseTypeSources(configDir);
672
+ // #5544 — every function, prompt, schemas/ def, db3 and user property type
673
+ // in one declaration, and the per-key invokers from the same
650
674
  // `functions/*.toml`. A malformed schema throws naming the file: the honest
651
675
  // `unknown` is for an absent schema, and typing a broken one as anything
652
676
  // would be a declaration that lies.
653
677
  const functionSources = functionSchemaSources(configDir);
654
- const functionsDeclaration = renderFunctionSchemasDeclaration(functionSources);
678
+ const primitiveDeclaration = renderPrimitiveDeclaration(primitiveDeclarationInputs(configDir));
655
679
  const invokerDir = functionInvokerDir(configDir, options);
656
- const invokers = renderFunctionInvokers(functionSources);
680
+ // #5896 — with the shared `schemas/` enums they use, declared once beside them.
681
+ const invokerSet = renderFunctionInvokerSet(configDir, functionSources);
682
+ const invokers = invokerSet.invokers;
683
+ // #5385 — the user property types, only for a tree that declares them. A
684
+ // file that does not parse throws naming it, like a malformed function schema.
685
+ const userProperties = userPropertiesSource(configDir);
657
686
  const artifacts = [
658
- {
659
- relative: `functions/${DB_TYPES_DECLARATION_FILE}`,
660
- absolute: join(functionsDir, DB_TYPES_DECLARATION_FILE),
661
- contents: declaration,
662
- regenerated: true,
663
- },
687
+ ...(databaseTypes.length > 0
688
+ ? [
689
+ {
690
+ relative: `functions/${DB_TYPES_DECLARATION_FILE}`,
691
+ absolute: join(functionsDir, DB_TYPES_DECLARATION_FILE),
692
+ contents: renderDbTypesDeclaration(databaseTypes),
693
+ regenerated: true,
694
+ },
695
+ ]
696
+ : []),
664
697
  {
665
698
  relative: `functions/${SDK_TYPES_FILE}`,
666
699
  absolute: join(functionsDir, SDK_TYPES_FILE),
@@ -668,50 +701,37 @@ export function planFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
668
701
  regenerated: true,
669
702
  },
670
703
  {
671
- relative: `functions/${FUNCTION_TYPES_DECLARATION_FILE}`,
672
- absolute: join(functionsDir, FUNCTION_TYPES_DECLARATION_FILE),
673
- contents: functionsDeclaration,
704
+ relative: `functions/${PRIMITIVE_DECLARATION_FILE}`,
705
+ absolute: join(functionsDir, PRIMITIVE_DECLARATION_FILE),
706
+ contents: primitiveDeclaration,
674
707
  regenerated: true,
675
708
  },
676
709
  // #3281 — the document handle's declaration, from the project's
677
- // `models/models.toml` (open when the project has none).
710
+ // `models/models.toml`.
678
711
  //
679
712
  // #3455 (D3455-009) — through the SAME resolution push and diff use, so a
680
713
  // tree pulled into a project with no `models/models.toml` is typed from
681
714
  // the schema its active version was pushed with rather than losing its
682
715
  // types the moment it is pulled.
683
- {
684
- relative: `functions/${DOCUMENT_TYPES_DECLARATION_FILE}`,
685
- absolute: join(functionsDir, DOCUMENT_TYPES_DECLARATION_FILE),
686
- contents: renderDocumentTypesDeclaration(documentSchema.declarationSource),
687
- regenerated: true,
688
- },
689
- // #3330 — `ctx.prompts.run`'s output types, from this tree's
690
- // `prompts/*.toml` (open when the tree declares none).
691
- {
692
- relative: `functions/${PROMPT_TYPES_DECLARATION_FILE}`,
693
- absolute: join(functionsDir, PROMPT_TYPES_DECLARATION_FILE),
694
- contents: renderPromptSchemasDeclaration(promptSchemaSources(configDir)),
695
- regenerated: true,
696
- },
697
- // #3455 (D3455-009) — the project's document schema, copied into the tree
698
- // so a fresh `config pull` into a project that has no `models/models.toml`
699
- // still rebuilds the same envelope and reads Synced.
700
716
  //
701
- // Regenerated from the PROJECT file whenever there is one, and otherwise
702
- // left exactly alone: when the copy is itself what the resolution answered
703
- // (rule 2) it IS the source, and rewriting a file from itself would be the
704
- // second source of truth the fixed precedence exists to avoid.
705
- ...(documentSchema.origin === "project" && documentSchema.source
717
+ // #5206 — none when no schema file resolves: an app with no documents
718
+ // gets no document declaration, and the one an earlier run wrote goes
719
+ // (`retiredFunctionTypeArtifacts`). The handle stays open without it.
720
+ ...(documentSchema.declarationSource
706
721
  ? [
707
722
  {
708
- relative: `functions/${DOCUMENT_SCHEMA_TREE_FILE}`,
709
- absolute: join(functionsDir, DOCUMENT_SCHEMA_TREE_FILE),
710
- contents: documentSchema.source.content,
723
+ relative: `functions/${DOCUMENT_TYPES_DECLARATION_FILE}`,
724
+ absolute: join(functionsDir, DOCUMENT_TYPES_DECLARATION_FILE),
725
+ contents: renderDocumentTypesDeclaration(documentSchema.declarationSource),
711
726
  regenerated: true,
712
727
  },
713
728
  ]
714
729
  : []),
730
+ // #5208 — the generated schema copy (D3455-009) is never planned: inside
731
+ // a project `models/models.toml` is the only document schema, so a copy
732
+ // there is a planned removal; outside one, a copy is itself the
733
+ // resolution (rule 2), and rewriting a file from itself would be a second
734
+ // source of truth.
715
735
  ...invokers.map((invoker) => {
716
736
  const absolute = join(invokerDir, invoker.fileName);
717
737
  return {
@@ -719,8 +739,25 @@ export function planFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
719
739
  absolute,
720
740
  contents: invoker.content,
721
741
  regenerated: true,
742
+ source: `function ${invoker.fileName.slice(0, -GENERATED_FILE_SUFFIX.length)}`,
722
743
  };
723
744
  }),
745
+ // #5896 — after the invokers, so a function keyed `shared-enums` is the
746
+ // one a refusal names first.
747
+ ...(invokerSet.sharedEnums
748
+ ? [
749
+ {
750
+ relative: reportedPath(configDir, join(invokerDir, invokerSet.sharedEnums.fileName)),
751
+ absolute: join(invokerDir, invokerSet.sharedEnums.fileName),
752
+ contents: invokerSet.sharedEnums.content,
753
+ regenerated: true,
754
+ source: `the shared enums of ${invokerSet.sharedEnums.sources.join(", ")}`,
755
+ },
756
+ ]
757
+ : []),
758
+ // #5385 — `UserProperties` and `ClientUserProperties` for the app's client
759
+ // code (beside the invokers); the functions' are in `primitive.d.ts`.
760
+ ...planUserPropertiesClientArtifacts(configDir, options, userProperties),
724
761
  // #3798 — each agent's client-side types, beside the invokers and owned
725
762
  // by the same plan (so the orphan sweep keeps them while the agent does).
726
763
  ...agentArtifacts,
@@ -747,8 +784,27 @@ export function planFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
747
784
  regenerated: false,
748
785
  });
749
786
  }
787
+ refuseSharedDestinations(artifacts);
750
788
  return artifacts;
751
789
  }
790
+ /**
791
+ * Refuse a plan in which two artifacts name one file (#5385): a function
792
+ * keyed `user-properties` writes its invoker where the user property client
793
+ * types go, and either would silently overwrite the other. Judged on the
794
+ * absolute paths, so a `-o` directory is judged as written.
795
+ */
796
+ function refuseSharedDestinations(artifacts) {
797
+ const byPath = new Map();
798
+ for (const artifact of artifacts) {
799
+ const prior = byPath.get(artifact.absolute);
800
+ if (prior) {
801
+ throw new FunctionSchemaCodegenError(`${artifact.relative} would be generated twice — from ${prior.source ?? prior.relative} and from ` +
802
+ `${artifact.source ?? artifact.relative} — and one would overwrite the other. Rename the function ` +
803
+ "(its key names its generated file) so the two differ.");
804
+ }
805
+ byPath.set(artifact.absolute, artifact);
806
+ }
807
+ }
752
808
  /**
753
809
  * The tsconfig wiring push could not repair, phrased for the author.
754
810
  *
@@ -777,13 +833,21 @@ export function functionTypeWiringProblems(configDir, options = {}) {
777
833
  /**
778
834
  * What the inspection knows about the directory: whether `generated/` will
779
835
  * exist beside the tsconfig once this plan is written (it exists now, or this
780
- * plan writes an invoker into the default location).
836
+ * plan writes an invoker into the default location), and which declarations
837
+ * the plan leaves out (#5206, #5898).
781
838
  */
782
839
  function tsconfigContext(configDir, options) {
783
840
  const defaultDir = join(configDir, "functions", FUNCTION_INVOKERS_DIR);
841
+ const userProperties = treeHasUserProperties(configDir);
784
842
  const writesThere = functionInvokerDir(configDir, options) === defaultDir &&
785
- functionSchemaSources(configDir).length > 0;
786
- return { generatedDirExists: existsSync(defaultDir) || writesThere };
843
+ (functionSchemaSources(configDir).length > 0 || userProperties);
844
+ return {
845
+ generatedDirExists: existsSync(defaultDir) || writesThere,
846
+ absentDeclarations: [
847
+ ...(databaseTypeSources(configDir).length > 0 ? [] : [DB_TYPES_DECLARATION_FILE]),
848
+ ...(resolveDocumentSchema(configDir).declarationSource ? [] : [DOCUMENT_TYPES_DECLARATION_FILE]),
849
+ ],
850
+ };
787
851
  }
788
852
  /**
789
853
  * Invokers in the plan's directory that the plan no longer writes — a
@@ -797,20 +861,88 @@ function orphanedInvokers(configDir, planned, options) {
797
861
  const keep = new Set(planned.map((a) => a.absolute));
798
862
  // #3798 (CSO-3798-003) — with no `functions/` at all, an agent's client
799
863
  // artifact is the only thing a run could have written here (an `-o`
800
- // directory the functions run never owned before), so only those are swept.
801
- const suffix = existsSync(join(configDir, "functions"))
802
- ? GENERATED_FILE_SUFFIX
803
- : AGENT_CLIENT_FILE_SUFFIX;
864
+ // directory the functions run never owned before), so only those are swept
865
+ // — and (#5385) the user property client types.
866
+ const owned = existsSync(join(configDir, "functions"))
867
+ ? (f) => f.endsWith(GENERATED_FILE_SUFFIX)
868
+ : (f) => f.endsWith(AGENT_CLIENT_FILE_SUFFIX) || f === USER_PROPERTIES_CLIENT_FILE;
804
869
  return readdirSync(dir)
805
- .filter((f) => f.endsWith(suffix))
870
+ .filter(owned)
806
871
  .map((f) => join(dir, f))
807
872
  .filter((absolute) => !keep.has(absolute));
808
873
  }
809
- /** Write them, and report the tree-relative paths that changed on disk. */
810
- export function writeFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
874
+ /**
875
+ * Declarations a plan may leave out: the database declaration exists only
876
+ * while the tree has database types (#5898), and the document declaration
877
+ * only while a document schema resolves (#5206).
878
+ */
879
+ const OPTIONAL_DECLARATIONS = [DB_TYPES_DECLARATION_FILE, DOCUMENT_TYPES_DECLARATION_FILE];
880
+ /**
881
+ * The generated files on disk that `planned` no longer writes: a database
882
+ * or document declaration an earlier run wrote, once the tree's database
883
+ * types (#5898) or document schema (#5206) are gone, the four declarations `primitive.d.ts` replaced (#5544), and,
884
+ * inside a project, the generated schema copy no resolution there reads
885
+ * (#5208).
886
+ */
887
+ export function retiredFunctionTypeArtifacts(configDir, planned) {
888
+ if (!treeHasFunctionsDir(configDir))
889
+ return [];
890
+ const keep = new Set(planned.map((a) => a.absolute));
891
+ const staleCopy = resolveDocumentSchema(configDir).staleTreeCopy;
892
+ return [
893
+ ...OPTIONAL_DECLARATIONS.map((file) => join(configDir, "functions", file)),
894
+ ...RETIRED_DECLARATIONS.map((retired) => join(configDir, "functions", retired.file)),
895
+ ...(staleCopy ? [staleCopy] : []),
896
+ ].filter((absolute) => !keep.has(absolute) && existsSync(absolute));
897
+ }
898
+ /**
899
+ * Every file a write of `planned` removes, as absolute paths (#5208): the
900
+ * invokers of removed functions, and the retired generated files. The one
901
+ * list the write, `--check`, the dry-run typechecker and the removal lines
902
+ * all read, so they cannot disagree about what goes.
903
+ */
904
+ export function plannedRemovals(configDir, planned, options = {}) {
905
+ return [
906
+ ...orphanedInvokers(configDir, planned, options),
907
+ ...retiredFunctionTypeArtifacts(configDir, planned),
908
+ ];
909
+ }
910
+ /**
911
+ * The line a command prints for a file a write removed (#5208), given its
912
+ * tree-relative path. The schema copy's names where the document schema
913
+ * lives and how to get it back; it never sends the author to the copy.
914
+ */
915
+ export function functionTypeRemovalLine(relative) {
916
+ if (relative.endsWith(`/${DOCUMENT_SCHEMA_TREE_FILE}`)) {
917
+ return (`Removed ${relative}: inside a project the document schema is models/models.toml, and this ` +
918
+ "generated file is no longer read. To keep the schema, restore models/models.toml from version " +
919
+ "control (the generated file was committed beside your functions); the running version keeps " +
920
+ "the schema until a push without it.");
921
+ }
922
+ if (relative.endsWith(`/${DOCUMENT_TYPES_DECLARATION_FILE}`)) {
923
+ return `Removed ${relative}: no document schema resolves, so ctx.doc's models are untyped.`;
924
+ }
925
+ if (relative.endsWith(`/${DB_TYPES_DECLARATION_FILE}`)) {
926
+ return `Removed ${relative}: the tree has no database-type-configs/*.toml, so ctx.db's models are untyped.`;
927
+ }
928
+ // #5544 — a declaration `primitive.d.ts` replaced names where its types went.
929
+ const retired = RETIRED_DECLARATIONS.find((entry) => relative.endsWith(`/${entry.file}`));
930
+ if (retired) {
931
+ return (`Removed ${relative}: its types are in functions/${PRIMITIVE_DECLARATION_FILE} under ${retired.namespace}; ` +
932
+ `import type { ${retired.namespace} } from "${PRIMITIVE_DECLARATION_SPECIFIER}".`);
933
+ }
934
+ // #5385 — the user property client types go with user-properties.toml.
935
+ if (relative.endsWith(`/${USER_PROPERTIES_CLIENT_FILE}`)) {
936
+ return `Removed ${relative}: the tree has no ${USER_PROPERTIES_FILE}, so UserProperties declares no field.`;
937
+ }
938
+ return `Removed ${relative}: no function declares it any more.`;
939
+ }
940
+ /** Write them, and report what was written and what was removed. */
941
+ export function applyFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
811
942
  // No early return for an empty plan (CSO-3798-003): removing a tree's last
812
943
  // agent (or its last function) plans nothing, and its artifacts still go.
813
944
  const artifacts = planFunctionTypeArtifacts(configDir, sdkTypes, options);
945
+ const removals = plannedRemovals(configDir, artifacts, options);
814
946
  const written = [];
815
947
  for (const artifact of artifacts) {
816
948
  const exists = existsSync(artifact.absolute);
@@ -825,10 +957,18 @@ export function writeFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
825
957
  // A removed function's invoker goes with it (#3281): a stale generated file
826
958
  // an app still imports is a compile error naming a function that no longer
827
959
  // exists, which is the right failure, but one left behind forever is not.
828
- for (const orphan of orphanedInvokers(configDir, artifacts, options)) {
829
- rmSync(orphan, { force: true });
960
+ const removed = [];
961
+ for (const absolute of removals) {
962
+ if (!existsSync(absolute))
963
+ continue;
964
+ rmSync(absolute, { force: true });
965
+ removed.push(reportedPath(configDir, absolute));
830
966
  }
831
- return written;
967
+ return { written, removed };
968
+ }
969
+ /** Write them, and report the tree-relative paths that changed on disk. */
970
+ export function writeFunctionTypeArtifacts(configDir, sdkTypes, options = {}) {
971
+ return applyFunctionTypeArtifacts(configDir, sdkTypes, options).written;
832
972
  }
833
973
  /**
834
974
  * The artifacts a `--check` run would rewrite: the freshness answer for CI and
@@ -851,8 +991,8 @@ export function staleFunctionTypeArtifacts(configDir, options = {}) {
851
991
  stale.push(artifact.relative);
852
992
  }
853
993
  }
854
- for (const orphan of orphanedInvokers(configDir, planned, options)) {
855
- stale.push(reportedPath(configDir, orphan));
994
+ for (const removal of plannedRemovals(configDir, planned, options)) {
995
+ stale.push(reportedPath(configDir, removal));
856
996
  }
857
997
  return stale;
858
998
  }