@cosmicdrift/kumiko-bundled-features 0.413.1 → 0.414.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 (588) hide show
  1. package/dist/admin-shell/feature.js +2 -2
  2. package/dist/agent-tools/agent-doc-lint.js +2 -1
  3. package/dist/agent-tools/agent-manifest.js +33 -25
  4. package/dist/agent-tools/api-docs/collect-events.js +4 -1
  5. package/dist/agent-tools/api-docs/collect.js +3 -3
  6. package/dist/agent-tools/api-docs/generate.js +4 -1
  7. package/dist/agent-tools/api-docs/index.d.ts +1 -0
  8. package/dist/agent-tools/api-docs/index.js +1 -0
  9. package/dist/agent-tools/api-docs/problems.d.ts +21 -0
  10. package/dist/agent-tools/api-docs/problems.js +11 -1
  11. package/dist/agent-tools/api-docs/render-openapi.js +2 -0
  12. package/dist/agent-tools/api-docs/resolve-config.d.ts +9 -0
  13. package/dist/agent-tools/api-docs/resolve-config.js +11 -0
  14. package/dist/agent-tools/api-docs/scope-slug-collisions.d.ts +4 -0
  15. package/dist/agent-tools/api-docs/scope-slug-collisions.js +10 -0
  16. package/dist/agent-tools/api-docs/translation-gaps.d.ts +4 -0
  17. package/dist/agent-tools/api-docs/translation-gaps.js +29 -0
  18. package/dist/agent-tools/api-docs/webhook-example-problems.d.ts +6 -0
  19. package/dist/agent-tools/api-docs/webhook-example-problems.js +25 -0
  20. package/dist/agent-tools/index.d.ts +1 -1
  21. package/dist/agent-tools/index.js +1 -1
  22. package/dist/agent-tools/labels.d.ts +3 -2
  23. package/dist/agent-tools/labels.js +21 -4
  24. package/dist/agent-tools/tool-catalog.d.ts +5 -5
  25. package/dist/agent-tools/tool-catalog.js +12 -10
  26. package/dist/agent-tools/tool-dispatch.js +11 -1
  27. package/dist/agent-tools/types.d.ts +4 -0
  28. package/dist/audit/event-classification.js +6 -0
  29. package/dist/audit/web/i18n.js +1 -0
  30. package/dist/auth-email-password/errors.js +0 -13
  31. package/dist/auth-email-password/handlers/invite-signup-complete.write.js +101 -84
  32. package/dist/auth-email-password/handlers/login-options.query.js +1 -1
  33. package/dist/auth-email-password/handlers/request-account-unlock.write.js +1 -1
  34. package/dist/auth-email-password/handlers/request-email-verification.write.js +0 -1
  35. package/dist/auth-email-password/handlers/request-password-reset.write.js +0 -1
  36. package/dist/auth-email-password/handlers/self-registration-status.query.js +1 -1
  37. package/dist/auth-email-password/reset-token.js +0 -2
  38. package/dist/auth-email-password/seeding.js +34 -8
  39. package/dist/auth-email-password/unlock-token.js +0 -2
  40. package/dist/auth-email-password/verification-token.js +0 -2
  41. package/dist/auth-email-password/web/auth-form-primitives.js +2 -2
  42. package/dist/auth-email-password/web/auth-gate.js +2 -2
  43. package/dist/auth-email-password/web/auth-redirect.d.ts +1 -0
  44. package/dist/auth-email-password/web/auth-redirect.js +4 -0
  45. package/dist/auth-email-password/web/forgot-password-screen.js +1 -5
  46. package/dist/auth-email-password/web/invite-accept-screen.js +1 -1
  47. package/dist/auth-email-password/web/return-path.d.ts +2 -1
  48. package/dist/auth-email-password/web/return-path.js +2 -1
  49. package/dist/auth-email-password/web/session.js +11 -12
  50. package/dist/auth-email-password/web/signup-screen.js +1 -5
  51. package/dist/auth-email-password/web/static-account.js +6 -2
  52. package/dist/auth-email-password/web/token-confirm-screen.js +4 -5
  53. package/dist/auth-mfa/web/mfa-code-or-recovery-field.d.ts +6 -1
  54. package/dist/auth-mfa/web/mfa-code-or-recovery-field.js +4 -2
  55. package/dist/auth-mfa/web/mfa-disable-dialog.js +1 -1
  56. package/dist/auth-mfa/web/mfa-regenerate-recovery-dialog.js +1 -1
  57. package/dist/auth-mfa/web/mfa-setup-preauth-screen.js +1 -1
  58. package/dist/auth-mfa/web/mfa-verify-screen.js +7 -11
  59. package/dist/auth-mfa-user-data/index.js +5 -6
  60. package/dist/billing-foundation/aggregate-id.js +0 -4
  61. package/dist/billing-foundation/checkout-core.js +8 -1
  62. package/dist/billing-foundation/checkout-ledger.d.ts +15 -0
  63. package/dist/billing-foundation/checkout-ledger.js +32 -0
  64. package/dist/billing-foundation/consumer-protection/consent-gate.d.ts +1 -1
  65. package/dist/billing-foundation/consumer-protection/consent-gate.js +2 -2
  66. package/dist/billing-foundation/consumer-protection/consent-text.d.ts +6 -2
  67. package/dist/billing-foundation/consumer-protection/consent-text.js +29 -3
  68. package/dist/billing-foundation/consumer-protection/termination-open-cancels.d.ts +2 -1
  69. package/dist/billing-foundation/consumer-protection/termination-open-cancels.js +5 -1
  70. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.d.ts +2 -0
  71. package/dist/billing-foundation/consumer-protection/termination-provider-timeout.js +17 -0
  72. package/dist/billing-foundation/consumer-protection/termination-record.js +5 -4
  73. package/dist/billing-foundation/consumer-protection/termination-revoke.js +1 -1
  74. package/dist/billing-foundation/events.d.ts +22 -0
  75. package/dist/billing-foundation/events.js +38 -10
  76. package/dist/billing-foundation/feature.js +12 -1
  77. package/dist/billing-foundation/handlers/billing-plans.query.js +25 -15
  78. package/dist/billing-foundation/handlers/create-checkout-session.write.js +1 -1
  79. package/dist/billing-foundation/handlers/process-event.write.d.ts +2 -2
  80. package/dist/billing-foundation/handlers/process-event.write.js +94 -12
  81. package/dist/billing-foundation/handlers/process-payment-event.write.d.ts +1 -2
  82. package/dist/billing-foundation/handlers/process-payment-event.write.js +29 -9
  83. package/dist/billing-foundation/handlers/record-checkout-opened.write.d.ts +2 -0
  84. package/dist/billing-foundation/handlers/record-checkout-opened.write.js +22 -0
  85. package/dist/billing-foundation/handlers/start-plan-checkout.write.js +1 -1
  86. package/dist/billing-foundation/handlers/switch-plan.write.js +10 -4
  87. package/dist/billing-foundation/i18n.js +3 -0
  88. package/dist/billing-foundation/pending-plan-switch.d.ts +12 -0
  89. package/dist/billing-foundation/pending-plan-switch.js +57 -0
  90. package/dist/billing-foundation/scrub-raw-payload-headers.d.ts +4 -0
  91. package/dist/billing-foundation/scrub-raw-payload-headers.js +33 -0
  92. package/dist/billing-foundation/types.d.ts +40 -24
  93. package/dist/billing-foundation/validate-options.js +14 -0
  94. package/dist/billing-foundation/web/billing-plans-panel.js +8 -3
  95. package/dist/billing-foundation/web/cancel-contract-dialog.js +1 -1
  96. package/dist/billing-foundation/web/checkout-consent-dialog.js +1 -1
  97. package/dist/billing-foundation/web/constants.d.ts +3 -0
  98. package/dist/billing-foundation/web/constants.js +5 -2
  99. package/dist/billing-foundation/web/plan-switch-confirm-dialog.js +1 -1
  100. package/dist/billing-foundation/webhook-handler.js +53 -11
  101. package/dist/cap-counter/aggregate-id.js +0 -2
  102. package/dist/cap-counter/stock-cap-guard.d.ts +1 -0
  103. package/dist/cap-counter/stock-cap-guard.js +18 -4
  104. package/dist/cap-overview/handlers/tenant-caps-list.query.js +18 -4
  105. package/dist/cap-overview/i18n.js +1 -0
  106. package/dist/cap-overview/index.d.ts +1 -1
  107. package/dist/cap-overview/types.d.ts +4 -0
  108. package/dist/cap-overview/web/cap-cards-panel.js +6 -2
  109. package/dist/cap-overview/web/cap-usage-bar.js +6 -1
  110. package/dist/cap-overview/web/usage-math.d.ts +1 -0
  111. package/dist/cap-overview/web/usage-math.js +4 -0
  112. package/dist/channel-in-app/handlers/read-state-by-keys.query.js +2 -2
  113. package/dist/channel-whatsapp/aggregate-id.d.ts +8 -0
  114. package/dist/channel-whatsapp/aggregate-id.js +18 -0
  115. package/dist/channel-whatsapp/constants.d.ts +25 -0
  116. package/dist/channel-whatsapp/constants.js +36 -0
  117. package/dist/channel-whatsapp/events.d.ts +87 -0
  118. package/dist/channel-whatsapp/events.js +70 -0
  119. package/dist/channel-whatsapp/feature.d.ts +3 -0
  120. package/dist/channel-whatsapp/feature.js +56 -0
  121. package/dist/channel-whatsapp/graph-client.d.ts +85 -0
  122. package/dist/channel-whatsapp/graph-client.js +272 -0
  123. package/dist/channel-whatsapp/in-memory-meta.d.ts +83 -0
  124. package/dist/channel-whatsapp/in-memory-meta.js +181 -0
  125. package/dist/channel-whatsapp/inbound-handlers.d.ts +39 -0
  126. package/dist/channel-whatsapp/inbound-handlers.js +127 -0
  127. package/dist/channel-whatsapp/index.d.ts +10 -0
  128. package/dist/channel-whatsapp/index.js +10 -0
  129. package/dist/channel-whatsapp/meta-signature.d.ts +5 -0
  130. package/dist/channel-whatsapp/meta-signature.js +19 -0
  131. package/dist/channel-whatsapp/options.d.ts +32 -0
  132. package/dist/channel-whatsapp/options.js +83 -0
  133. package/dist/channel-whatsapp/pii.d.ts +32 -0
  134. package/dist/channel-whatsapp/pii.js +61 -0
  135. package/dist/channel-whatsapp/webhook-normalize.d.ts +7 -0
  136. package/dist/channel-whatsapp/webhook-normalize.js +185 -0
  137. package/dist/channel-whatsapp/webhook-routes.d.ts +10 -0
  138. package/dist/channel-whatsapp/webhook-routes.js +118 -0
  139. package/dist/compliance-profiles/handlers/sub-processors.query.js +1 -1
  140. package/dist/config/handlers/set.write.js +7 -0
  141. package/dist/config/handlers/values.query.js +8 -1
  142. package/dist/config/index.d.ts +1 -1
  143. package/dist/config/index.js +1 -1
  144. package/dist/config/read-redaction.d.ts +1 -0
  145. package/dist/config/read-redaction.js +5 -2
  146. package/dist/config/table.js +1 -0
  147. package/dist/config/write-helpers.js +3 -2
  148. package/dist/crypto-shredding/constants.d.ts +1 -0
  149. package/dist/crypto-shredding/constants.js +1 -0
  150. package/dist/crypto-shredding/handlers/forget-subject.write.js +34 -13
  151. package/dist/crypto-shredding/index.d.ts +1 -0
  152. package/dist/crypto-shredding/index.js +1 -0
  153. package/dist/crypto-shredding/subject-forget-after-delete-hook.d.ts +12 -0
  154. package/dist/crypto-shredding/subject-forget-after-delete-hook.js +38 -0
  155. package/dist/custom-fields/aggregate-id.js +0 -1
  156. package/dist/custom-fields/entity.js +1 -0
  157. package/dist/custom-fields/wire-for-entity.js +0 -1
  158. package/dist/data-retention/erase-notes-of-deleted-row.d.ts +9 -0
  159. package/dist/data-retention/erase-notes-of-deleted-row.js +15 -0
  160. package/dist/data-retention/feature.js +1 -5
  161. package/dist/data-retention/run-retention-cleanup.d.ts +1 -0
  162. package/dist/data-retention/run-retention-cleanup.js +39 -19
  163. package/dist/data-retention/tenant-destruction-hold.js +7 -0
  164. package/dist/delivery/attempt-log-factory.d.ts +3 -0
  165. package/dist/delivery/attempt-log-factory.js +5 -0
  166. package/dist/delivery/attempt-log.d.ts +2 -2
  167. package/dist/delivery/channel-context.d.ts +1 -1
  168. package/dist/delivery/channel-context.js +5 -2
  169. package/dist/delivery/db/queries/preferences.js +0 -1
  170. package/dist/delivery/delivery-service.js +3 -0
  171. package/dist/delivery/feature.d.ts +1 -4
  172. package/dist/delivery/feature.js +3 -1
  173. package/dist/delivery/handlers/attempts-by-keys.query.d.ts +1 -1
  174. package/dist/delivery/handlers/opted-in-user-ids.query.d.ts +7 -0
  175. package/dist/delivery/handlers/opted-in-user-ids.query.js +41 -0
  176. package/dist/delivery/handlers/preferences.query.js +2 -20
  177. package/dist/delivery/handlers/resubscribe-user.write.d.ts +2 -2
  178. package/dist/delivery/handlers/resubscribe-user.write.js +2 -24
  179. package/dist/delivery/handlers/unsubscribe-page-chrome.query.js +2 -0
  180. package/dist/delivery/handlers/unsubscribe-user.write.d.ts +2 -2
  181. package/dist/delivery/handlers/unsubscribe-user.write.js +2 -26
  182. package/dist/delivery/index.d.ts +3 -1
  183. package/dist/delivery/index.js +1 -0
  184. package/dist/delivery/options.d.ts +4 -0
  185. package/dist/delivery/options.js +1 -0
  186. package/dist/delivery/preference-rows.d.ts +9 -0
  187. package/dist/delivery/preference-rows.js +22 -0
  188. package/dist/delivery/set-preference-enabled.d.ts +17 -0
  189. package/dist/delivery/set-preference-enabled.js +26 -0
  190. package/dist/delivery/tables.d.ts +2 -2
  191. package/dist/delivery/testing.d.ts +1 -1
  192. package/dist/delivery/testing.js +3 -1
  193. package/dist/delivery/types.d.ts +1 -0
  194. package/dist/delivery/unsubscribe-page.js +5 -1
  195. package/dist/delivery/upsert-preference.js +0 -1
  196. package/dist/delivery/web/public-names.d.ts +1 -0
  197. package/dist/delivery/web/public-names.js +1 -0
  198. package/dist/derivatives-sharp/render.js +9 -9
  199. package/dist/document-ingest-foundation/aggregate-id.js +0 -1
  200. package/dist/document-ingest-foundation/append-missing-extract-event.d.ts +0 -1
  201. package/dist/document-ingest-foundation/append-missing-extract-event.js +32 -21
  202. package/dist/document-ingest-foundation/report-ingest-progress.d.ts +1 -1
  203. package/dist/document-ingest-foundation/report-ingest-progress.js +29 -13
  204. package/dist/documents/aggregate-id.js +0 -2
  205. package/dist/documents/constants.d.ts +6 -0
  206. package/dist/documents/constants.js +8 -2
  207. package/dist/documents/ensure-link.d.ts +5 -8
  208. package/dist/documents/ensure-link.js +4 -2
  209. package/dist/documents/feature.d.ts +3 -1
  210. package/dist/documents/feature.js +24 -5
  211. package/dist/documents/handlers/import.write.js +2 -2
  212. package/dist/documents/queries/expiry-overview.query.js +2 -1
  213. package/dist/documents/queries/for-record.query.js +3 -4
  214. package/dist/documents/queries/list-page.js +11 -3
  215. package/dist/documents/queries/overview.query.js +2 -2
  216. package/dist/documents/screens.js +3 -3
  217. package/dist/documents/tab.js +1 -1
  218. package/dist/feature-toggles/toggle-sync-signal.d.ts +2 -2
  219. package/dist/feature-toggles/toggle-sync-signal.js +3 -2
  220. package/dist/file-derivatives/handlers/public-variant-by-file-ref.query.js +1 -1
  221. package/dist/file-derivatives/handlers/public-variant.query.js +1 -1
  222. package/dist/file-foundation/probe.js +9 -3
  223. package/dist/file-foundation/read-file-ref-content.js +23 -11
  224. package/dist/file-provider-inmemory/feature.js +1 -1
  225. package/dist/file-provider-s3/env-feature.js +1 -1
  226. package/dist/file-provider-s3/env-named-feature.js +1 -1
  227. package/dist/file-provider-s3/env-schema.d.ts +10 -1
  228. package/dist/file-provider-s3/env-schema.js +20 -7
  229. package/dist/file-provider-s3/feature.js +1 -1
  230. package/dist/file-provider-s3/index.d.ts +1 -1
  231. package/dist/file-provider-s3/index.js +1 -1
  232. package/dist/file-provider-s3/lib/env-helper.d.ts +3 -2
  233. package/dist/file-provider-s3/lib/env-helper.js +13 -12
  234. package/dist/file-provider-s3/lib/s3-provider.js +10 -2
  235. package/dist/folders/aggregate-id.js +0 -1
  236. package/dist/folders/web/folder-manager.js +1 -1
  237. package/dist/folders-user-data/index.js +12 -14
  238. package/dist/helpdesk/entity.js +4 -1
  239. package/dist/helpdesk/feature.js +36 -0
  240. package/dist/helpdesk/handlers/access.d.ts +0 -1
  241. package/dist/helpdesk/handlers/access.js +0 -3
  242. package/dist/helpdesk/handlers/attempts.js +7 -13
  243. package/dist/helpdesk/handlers/challenge.query.js +1 -2
  244. package/dist/helpdesk/handlers/reply.write.js +4 -5
  245. package/dist/helpdesk/handlers/report.write.js +3 -7
  246. package/dist/helpdesk/handlers/submit.write.js +4 -9
  247. package/dist/helpdesk/index.d.ts +1 -1
  248. package/dist/helpdesk/index.js +1 -1
  249. package/dist/helpdesk/legacy-contact-config.d.ts +3 -0
  250. package/dist/helpdesk/legacy-contact-config.js +57 -0
  251. package/dist/helpdesk/legacy-contact-erasure.d.ts +9 -0
  252. package/dist/helpdesk/legacy-contact-erasure.js +19 -0
  253. package/dist/helpdesk/legacy-contact-retention.d.ts +2 -0
  254. package/dist/helpdesk/legacy-contact-retention.js +53 -0
  255. package/dist/helpdesk/legacy-contact-streams.d.ts +20 -0
  256. package/dist/helpdesk/legacy-contact-streams.js +121 -0
  257. package/dist/helpdesk/legacy-contact-user-data.d.ts +5 -0
  258. package/dist/helpdesk/legacy-contact-user-data.js +62 -0
  259. package/dist/helpdesk/lib.d.ts +7 -1
  260. package/dist/helpdesk/lib.js +29 -29
  261. package/dist/helpdesk/user-data-hooks.d.ts +10 -1
  262. package/dist/helpdesk/user-data-hooks.js +47 -36
  263. package/dist/helpdesk/web/constants.d.ts +0 -1
  264. package/dist/helpdesk/web/constants.js +0 -1
  265. package/dist/inbound-mail-foundation/account-health.js +1 -1
  266. package/dist/inbound-mail-foundation/account-poll.js +1 -1
  267. package/dist/inbound-mail-foundation/aggregate-id.js +0 -2
  268. package/dist/inbound-mail-foundation/constants.d.ts +6 -0
  269. package/dist/inbound-mail-foundation/constants.js +6 -0
  270. package/dist/inbound-mail-foundation/content-refetch.d.ts +1 -0
  271. package/dist/inbound-mail-foundation/content-refetch.js +15 -1
  272. package/dist/inbound-mail-foundation/entities.js +57 -15
  273. package/dist/inbound-mail-foundation/events.js +15 -16
  274. package/dist/inbound-mail-foundation/feature.js +3 -1
  275. package/dist/inbound-mail-foundation/handlers/account-address.d.ts +2 -2
  276. package/dist/inbound-mail-foundation/handlers/account-address.js +10 -2
  277. package/dist/inbound-mail-foundation/handlers/attach-message-content.write.js +8 -3
  278. package/dist/inbound-mail-foundation/handlers/connect-account.write.js +12 -7
  279. package/dist/inbound-mail-foundation/handlers/forget-message.write.d.ts +7 -0
  280. package/dist/inbound-mail-foundation/handlers/forget-message.write.js +54 -0
  281. package/dist/inbound-mail-foundation/i18n.js +3 -0
  282. package/dist/inbound-mail-foundation/index.d.ts +1 -0
  283. package/dist/inbound-mail-foundation/index.js +1 -0
  284. package/dist/inbound-mail-foundation/oauth-access-token.js +1 -1
  285. package/dist/inbound-mail-foundation/outbound-mail.d.ts +2 -0
  286. package/dist/inbound-mail-foundation/personal-address.d.ts +1 -0
  287. package/dist/inbound-mail-foundation/personal-address.js +16 -0
  288. package/dist/inbound-mail-foundation/purge-messages.d.ts +20 -0
  289. package/dist/inbound-mail-foundation/purge-messages.js +33 -0
  290. package/dist/inbound-mail-foundation/quarantine.d.ts +3 -2
  291. package/dist/inbound-mail-foundation/quarantine.js +9 -5
  292. package/dist/inbound-mail-foundation/retention-job.js +1 -5
  293. package/dist/inbound-mail-foundation/retention-sweep.js +17 -28
  294. package/dist/inbound-mail-foundation/send-from-account.js +9 -1
  295. package/dist/inbound-mail-foundation/supervisor-ingest.js +4 -1
  296. package/dist/inbound-mail-foundation/sync-account-now.js +1 -1
  297. package/dist/inbound-mail-foundation/tenant-destroy-hook.js +3 -6
  298. package/dist/inbound-mail-foundation/watch-supervisor.js +1 -1
  299. package/dist/inbound-provider-imap/byte-budget.d.ts +14 -0
  300. package/dist/inbound-provider-imap/byte-budget.js +53 -0
  301. package/dist/inbound-provider-imap/connect-mailbox.d.ts +2 -4
  302. package/dist/inbound-provider-imap/connect-mailbox.js +8 -3
  303. package/dist/inbound-provider-imap/connect-my-mailbox.d.ts +1 -1
  304. package/dist/inbound-provider-imap/connect-my-mailbox.js +15 -4
  305. package/dist/inbound-provider-imap/connect-target-rate-limit.d.ts +3 -0
  306. package/dist/inbound-provider-imap/connect-target-rate-limit.js +37 -0
  307. package/dist/inbound-provider-imap/download-batch.d.ts +10 -0
  308. package/dist/inbound-provider-imap/download-batch.js +21 -6
  309. package/dist/inbound-provider-imap/feature.js +7 -4
  310. package/dist/inbound-provider-imap/fetch-content.js +35 -30
  311. package/dist/inbound-provider-imap/i18n.js +2 -2
  312. package/dist/inbound-provider-imap/parse-message.d.ts +7 -0
  313. package/dist/inbound-provider-imap/parse-message.js +8 -0
  314. package/dist/inbound-provider-imap/reconnect-mailbox.js +5 -4
  315. package/dist/inbound-provider-imap/send-mail.d.ts +2 -0
  316. package/dist/inbound-provider-imap/send-mail.js +32 -6
  317. package/dist/inbound-provider-imap/smtp-client.d.ts +9 -2
  318. package/dist/inbound-provider-imap/smtp-client.js +15 -3
  319. package/dist/inbound-provider-imap/watch-mailbox.js +3 -24
  320. package/dist/inbound-provider-inmemory/feature.js +1 -1
  321. package/dist/jobs/events.d.ts +13 -0
  322. package/dist/jobs/events.js +8 -0
  323. package/dist/jobs/feature.js +2 -0
  324. package/dist/jobs/handlers/consumer.write.js +31 -20
  325. package/dist/jobs/web/constants.d.ts +3 -0
  326. package/dist/jobs/web/constants.js +3 -0
  327. package/dist/mail-transport-inmemory/feature.js +1 -1
  328. package/dist/mail-transport-smtp/feature.js +3 -2
  329. package/dist/managed-pages/handlers/branding.query.js +1 -1
  330. package/dist/managed-pages/handlers/by-slug.query.js +1 -1
  331. package/dist/managed-pages/handlers/by-tenant-published.query.js +1 -1
  332. package/dist/managed-pages/render-page-body.d.ts +2 -0
  333. package/dist/managed-pages/render-page-body.js +12 -8
  334. package/dist/managed-pages/screens/page-screens.d.ts +3 -2
  335. package/dist/managed-pages/screens/page-screens.js +14 -33
  336. package/dist/managed-pages/table.js +1 -0
  337. package/dist/managed-pages/web/client-plugin.js +8 -6
  338. package/dist/managed-pages/web/constants.d.ts +5 -1
  339. package/dist/managed-pages/web/constants.js +6 -1
  340. package/dist/managed-pages/web/i18n.js +11 -3
  341. package/dist/managed-pages/web/markdown-to-document.js +1 -1
  342. package/dist/managed-pages/web/page-edit-draft.d.ts +32 -0
  343. package/dist/managed-pages/web/page-edit-draft.js +76 -0
  344. package/dist/managed-pages/web/page-edit-screen.d.ts +2 -0
  345. package/dist/managed-pages/web/page-edit-screen.js +106 -0
  346. package/dist/managed-pages/web/page-settings-rail.d.ts +11 -0
  347. package/dist/managed-pages/web/page-settings-rail.js +14 -0
  348. package/dist/notes-history-user-data/index.js +8 -14
  349. package/dist/personal-access-tokens/boot-rules.d.ts +5 -0
  350. package/dist/personal-access-tokens/boot-rules.js +5 -0
  351. package/dist/personal-access-tokens/handlers/create.write.js +0 -1
  352. package/dist/personal-access-tokens/scope-events-check.js +26 -6
  353. package/dist/presence/handlers/list.query.js +18 -8
  354. package/dist/presence/room.d.ts +2 -0
  355. package/dist/presence/room.js +8 -5
  356. package/dist/presence/store.d.ts +2 -0
  357. package/dist/presence/store.js +62 -26
  358. package/dist/readiness/handlers/latest-summary.query.js +10 -6
  359. package/dist/readiness/handlers/run-probes.write.js +24 -4
  360. package/dist/readiness/handlers/run-tone.js +3 -2
  361. package/dist/readiness/handlers/status.query.js +11 -3
  362. package/dist/readiness/probe-context.js +7 -10
  363. package/dist/readiness/screens.js +4 -4
  364. package/dist/readiness/visible-results.d.ts +1 -1
  365. package/dist/readiness/visible-results.js +5 -2
  366. package/dist/renderer-foundation/api.js +6 -12
  367. package/dist/renderer-foundation/types.d.ts +2 -2
  368. package/dist/secrets/db/queries/read.d.ts +2 -1
  369. package/dist/secrets/db/queries/read.js +10 -1
  370. package/dist/secrets/handlers/list.query.js +4 -2
  371. package/dist/secrets/secret-scope.d.ts +0 -1
  372. package/dist/secrets/secret-scope.js +2 -2
  373. package/dist/secrets/secrets-context.js +4 -4
  374. package/dist/secrets/table.d.ts +1 -1
  375. package/dist/secrets/write-gate.js +4 -2
  376. package/dist/seo/handlers/seo-config.query.js +1 -1
  377. package/dist/shared/acknowledged-system-db.d.ts +5 -0
  378. package/dist/shared/acknowledged-system-db.js +9 -0
  379. package/dist/shared/assert-billing-live.d.ts +1 -0
  380. package/dist/shared/assert-billing-live.js +5 -2
  381. package/dist/shared/index.d.ts +6 -2
  382. package/dist/shared/index.js +6 -2
  383. package/dist/shared/parent-visibility.d.ts +1 -0
  384. package/dist/shared/parent-visibility.js +16 -1
  385. package/dist/shared/password-hashing.js +0 -1
  386. package/dist/shared/price-env-shape.js +1 -1
  387. package/dist/shared/register-user-data-hooks.d.ts +11 -0
  388. package/dist/shared/register-user-data-hooks.js +11 -0
  389. package/dist/shared/require-bootstrap-extension.d.ts +9 -0
  390. package/dist/shared/require-bootstrap-extension.js +16 -0
  391. package/dist/shared/send-best-effort.d.ts +2 -0
  392. package/dist/shared/send-best-effort.js +14 -0
  393. package/dist/shared/stream-tenant-backfill.d.ts +1 -0
  394. package/dist/shared/stream-tenant-backfill.js +17 -1
  395. package/dist/shared/stream-tenant-derived-state.d.ts +5 -1
  396. package/dist/shared/stream-tenant-derived-state.js +19 -2
  397. package/dist/step-dispatcher/constants.d.ts +4 -0
  398. package/dist/step-dispatcher/constants.js +11 -0
  399. package/dist/step-dispatcher/deliver-dispatch-request.d.ts +1 -0
  400. package/dist/step-dispatcher/deliver-dispatch-request.js +38 -2
  401. package/dist/step-dispatcher/feature.js +20 -2
  402. package/dist/step-dispatcher/mail-runner.js +0 -1
  403. package/dist/step-dispatcher/sweep-abandoned.d.ts +10 -0
  404. package/dist/step-dispatcher/sweep-abandoned.js +43 -0
  405. package/dist/subscription-mollie/plugin-methods.d.ts +1 -0
  406. package/dist/subscription-mollie/plugin-methods.js +1 -2
  407. package/dist/subscription-mollie/verify-webhook.js +5 -5
  408. package/dist/subscription-paddle/backfill-checkout-ledger.d.ts +9 -0
  409. package/dist/subscription-paddle/backfill-checkout-ledger.js +110 -0
  410. package/dist/subscription-paddle/checkout-config.query.js +1 -1
  411. package/dist/subscription-paddle/checkout-methods.js +2 -8
  412. package/dist/subscription-paddle/constants.d.ts +0 -1
  413. package/dist/subscription-paddle/constants.js +1 -2
  414. package/dist/subscription-paddle/feature.d.ts +0 -4
  415. package/dist/subscription-paddle/feature.js +21 -20
  416. package/dist/subscription-paddle/ledger-backfill-marker.d.ts +17 -0
  417. package/dist/subscription-paddle/ledger-backfill-marker.js +53 -0
  418. package/dist/subscription-paddle/plan-switch-methods.js +2 -8
  419. package/dist/subscription-paddle/redeliver-legacy-checkout.d.ts +11 -0
  420. package/dist/subscription-paddle/redeliver-legacy-checkout.js +26 -0
  421. package/dist/subscription-paddle/runtime.d.ts +3 -5
  422. package/dist/subscription-paddle/runtime.js +4 -7
  423. package/dist/subscription-paddle/subscription-state.d.ts +1 -0
  424. package/dist/subscription-paddle/subscription-state.js +1 -0
  425. package/dist/subscription-paddle/webhook-events.d.ts +4 -0
  426. package/dist/subscription-paddle/webhook-events.js +40 -22
  427. package/dist/subscription-stripe/feature.d.ts +4 -0
  428. package/dist/subscription-stripe/feature.js +1 -0
  429. package/dist/subscription-stripe/plugin-methods.d.ts +1 -0
  430. package/dist/subscription-stripe/plugin-methods.js +2 -5
  431. package/dist/subscription-stripe/runtime.d.ts +2 -1
  432. package/dist/subscription-stripe/runtime.js +5 -7
  433. package/dist/subscription-stripe/verify-webhook.js +21 -6
  434. package/dist/tags/aggregate-id.js +0 -1
  435. package/dist/tags/web/tag-chip.js +0 -1
  436. package/dist/tags/web/tag-manager.js +3 -1
  437. package/dist/template-resolver/api.js +6 -12
  438. package/dist/template-resolver/document-sanitizer.d.ts +1 -1
  439. package/dist/template-resolver/document-sanitizer.js +18 -0
  440. package/dist/template-resolver/feature.d.ts +1 -0
  441. package/dist/template-resolver/feature.js +2 -0
  442. package/dist/template-resolver/handlers/body-preview.query.d.ts +11 -0
  443. package/dist/template-resolver/handlers/body-preview.query.js +41 -0
  444. package/dist/template-resolver/handlers/by-slug.query.js +1 -1
  445. package/dist/template-resolver/handlers/by-tenant.query.js +1 -1
  446. package/dist/template-resolver/handlers/collection-shared.js +5 -8
  447. package/dist/template-resolver/handlers/overview.query.d.ts +1 -0
  448. package/dist/template-resolver/handlers/overview.query.js +2 -1
  449. package/dist/template-resolver/handlers/send-test.write.js +27 -8
  450. package/dist/template-resolver/linked-resources.js +2 -6
  451. package/dist/template-resolver/seeding.js +67 -1
  452. package/dist/template-resolver/table.js +1 -0
  453. package/dist/template-resolver/template-draft.js +2 -1
  454. package/dist/template-resolver/template-preview.js +12 -3
  455. package/dist/template-resolver/testing.js +0 -2
  456. package/dist/template-resolver/web/client-plugin.js +3 -0
  457. package/dist/template-resolver/web/collection-entry-create-form.js +19 -9
  458. package/dist/template-resolver/web/constants.d.ts +2 -0
  459. package/dist/template-resolver/web/constants.js +2 -0
  460. package/dist/template-resolver/web/content-tree-provider.js +0 -1
  461. package/dist/template-resolver/web/content-workbench.d.ts +22 -0
  462. package/dist/template-resolver/web/content-workbench.js +32 -0
  463. package/dist/template-resolver/web/document-insert-model.d.ts +2 -4
  464. package/dist/template-resolver/web/document-insert-model.js +1 -2
  465. package/dist/template-resolver/web/document-link-policy.d.ts +3 -0
  466. package/dist/template-resolver/web/document-link-policy.js +53 -0
  467. package/dist/template-resolver/web/document-schema.d.ts +2 -4
  468. package/dist/template-resolver/web/document-schema.js +2 -53
  469. package/dist/template-resolver/web/document-tiptap-context.d.ts +2 -5
  470. package/dist/template-resolver/web/document-tiptap-context.js +2 -2
  471. package/dist/template-resolver/web/document-tiptap-editor.js +2 -2
  472. package/dist/template-resolver/web/document-tiptap-helpers.d.ts +7 -4
  473. package/dist/template-resolver/web/document-tiptap-toolbar-groups.js +3 -3
  474. package/dist/template-resolver/web/editor-handle.js +1 -0
  475. package/dist/template-resolver/web/fill-document-variables.d.ts +1 -0
  476. package/dist/template-resolver/web/fill-document-variables.js +22 -0
  477. package/dist/template-resolver/web/i18n.js +10 -0
  478. package/dist/template-resolver/web/index.d.ts +3 -0
  479. package/dist/template-resolver/web/index.js +2 -0
  480. package/dist/template-resolver/web/preview-targets.d.ts +5 -0
  481. package/dist/template-resolver/web/preview-targets.js +21 -0
  482. package/dist/template-resolver/web/qualified-names.d.ts +1 -0
  483. package/dist/template-resolver/web/qualified-names.js +1 -0
  484. package/dist/template-resolver/web/snippet-preview-renderer.d.ts +2 -0
  485. package/dist/template-resolver/web/snippet-preview-renderer.js +15 -0
  486. package/dist/template-resolver/web/string-values.d.ts +1 -0
  487. package/dist/template-resolver/web/string-values.js +8 -0
  488. package/dist/template-resolver/web/text-block-editor.js +18 -11
  489. package/dist/template-resolver/web/use-collection-entry-create.d.ts +1 -0
  490. package/dist/template-resolver/web/use-collection-entry-create.js +6 -0
  491. package/dist/template-resolver/web/use-document-tiptap-model.d.ts +2 -6
  492. package/dist/template-resolver/web/use-text-block-editor.d.ts +3 -0
  493. package/dist/template-resolver/web/use-text-block-editor.js +26 -5
  494. package/dist/template-resolver/web/web-preview-renderer.d.ts +12 -0
  495. package/dist/template-resolver/web/web-preview-renderer.js +41 -0
  496. package/dist/template-resolver-user-data/index.js +11 -10
  497. package/dist/tenant/handlers/create.write.js +3 -7
  498. package/dist/tenant/handlers/list.query.js +3 -8
  499. package/dist/tenant/handlers/member-directory.query.js +10 -5
  500. package/dist/tenant/handlers/toggle-enabled.write.js +1 -1
  501. package/dist/tenant/invited-membership.js +9 -1
  502. package/dist/tenant/seeding.d.ts +3 -0
  503. package/dist/tenant/seeding.js +3 -1
  504. package/dist/tenant/stream-tenant-backfill.js +5 -1
  505. package/dist/tenant/testing.js +1 -1
  506. package/dist/tenant-inactivity/check-inactive-tenants.js +5 -5
  507. package/dist/tenant-inactivity/constants.js +1 -2
  508. package/dist/tenant-inactivity/handlers/keep-account.write.js +1 -2
  509. package/dist/tenant-inactivity/state-store.d.ts +1 -0
  510. package/dist/tenant-inactivity/state-store.js +9 -1
  511. package/dist/tenant-lifecycle/constants.d.ts +1 -0
  512. package/dist/tenant-lifecycle/constants.js +3 -0
  513. package/dist/tenant-lifecycle/run-tenant-destroy.js +38 -5
  514. package/dist/tenant-lifecycle/stages.js +14 -2
  515. package/dist/tier-engine/aggregate-id.js +0 -1
  516. package/dist/tier-engine/feature.js +9 -2
  517. package/dist/user/db/queries/stream-tenant-backfill.js +2 -1
  518. package/dist/user/handlers/me.query.js +4 -1
  519. package/dist/user/index.d.ts +1 -0
  520. package/dist/user/index.js +1 -0
  521. package/dist/user/resolve-verified-user-email.d.ts +2 -0
  522. package/dist/user/resolve-verified-user-email.js +14 -0
  523. package/dist/user-data-rights/db/queries/export-jobs.js +0 -1
  524. package/dist/user-data-rights/handlers/confirm-deletion-by-token.write.js +1 -1
  525. package/dist/user-data-rights/handlers/download-by-token.query.js +1 -1
  526. package/dist/user-data-rights/handlers/request-deletion-by-email.write.js +1 -1
  527. package/dist/user-data-rights/run-export-jobs.js +0 -2
  528. package/dist/user-data-rights/run-forget-cleanup.js +2 -2
  529. package/dist/user-data-rights/schema/download-attempt.js +3 -2
  530. package/dist/user-data-rights/web/confirm-deletion-screen.js +2 -2
  531. package/dist/user-data-rights/web/privacy-center-screen.js +1 -1
  532. package/dist/user-data-rights/web/request-deletion-screen.js +2 -2
  533. package/dist/user-data-rights-defaults/hooks/api-token.userdata-hook.js +5 -6
  534. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.d.ts +7 -0
  535. package/dist/user-data-rights-defaults/hooks/hard-delete-own-rows-hook.js +11 -0
  536. package/dist/user-data-rights-defaults/hooks/in-app-message.userdata-hook.js +5 -6
  537. package/dist/user-data-rights-defaults/hooks/job-run.userdata-hook.js +2 -1
  538. package/dist/user-data-rights-defaults/hooks/user-session.userdata-hook.js +5 -6
  539. package/dist/user-profile/handlers/change-email.write.js +0 -1
  540. package/dist/waitlist/handlers/submit.write.js +5 -18
  541. package/dist/waitlist/lib.js +2 -7
  542. package/dist/waitlist/user-data-hooks.js +6 -20
  543. package/dist/workflow-runner/aggregate-id.js +0 -1
  544. package/dist/workflow-runner/event-trigger.js +6 -2
  545. package/dist/workflow-runner/feature.js +1 -5
  546. package/dist/workflow-runner/handlers/resume-run.write.js +4 -3
  547. package/dist/workflow-runner/runner.d.ts +1 -0
  548. package/package.json +35 -11
  549. package/src/admin-shell/changes.json +6 -0
  550. package/src/agent-tools/changes.json +12 -0
  551. package/src/auth-email-password/changes.json +18 -0
  552. package/src/billing-foundation/changes.json +37 -0
  553. package/src/cap-counter/changes.json +6 -0
  554. package/src/cap-overview/changes.json +6 -0
  555. package/src/channel-in-app/changes.json +6 -0
  556. package/src/channel-whatsapp/changes.json +8 -0
  557. package/src/config/changes.json +12 -0
  558. package/src/crypto-shredding/changes.json +18 -0
  559. package/src/data-retention/changes.json +12 -0
  560. package/src/delivery/changes.json +6 -0
  561. package/src/documents/changes.json +18 -0
  562. package/src/file-provider-s3/changes.json +14 -0
  563. package/src/files/changes.json +7 -0
  564. package/src/helpdesk/changes.json +50 -0
  565. package/src/inbound-mail-foundation/changes.json +48 -0
  566. package/src/inbound-provider-imap/changes.json +13 -0
  567. package/src/mail-foundation/changes.json +6 -0
  568. package/src/managed-pages/changes.json +12 -0
  569. package/src/presence/changes.json +6 -0
  570. package/src/readiness/changes.json +25 -0
  571. package/src/secrets/changes.json +7 -0
  572. package/src/shared/changes.json +6 -0
  573. package/src/step-dispatcher/changes.json +12 -0
  574. package/src/subscription-mollie/changes.json +7 -0
  575. package/src/subscription-paddle/changes.json +13 -0
  576. package/src/subscription-stripe/changes.json +7 -0
  577. package/src/template-resolver/changes.json +36 -0
  578. package/src/tenant/changes.json +6 -0
  579. package/src/tenant-lifecycle/changes.json +18 -0
  580. package/src/tier-engine/changes.json +6 -0
  581. package/src/user/changes.json +6 -0
  582. package/src/waitlist/changes.json +6 -0
  583. package/dist/managed-pages/web/page-body-section.d.ts +0 -3
  584. package/dist/managed-pages/web/page-body-section.js +0 -40
  585. package/dist/subscription-paddle/tenant-binding.d.ts +0 -8
  586. package/dist/subscription-paddle/tenant-binding.js +0 -26
  587. package/dist/template-resolver/web/content-field.d.ts +0 -9
  588. package/dist/template-resolver/web/content-field.js +0 -14
@@ -8,7 +8,7 @@ import { ADMIN_SHELL_FEATURE, DEFAULT_PLATFORM_WORKSPACE_ID, DEFAULT_TENANT_WORK
8
8
  import { ADMIN_SHELL_I18N } from "./web/i18n.js";
9
9
  function tenantWorkspaceNavIds(options) {
10
10
  return [
11
- ...(options.includeTenantOverview === true ? ["admin-shell:nav:tenant-overview"] : []),
11
+ ...(options.includeTenantOverview ? ["admin-shell:nav:tenant-overview"] : []),
12
12
  "tenant:nav:members",
13
13
  "audit:nav:audit-log",
14
14
  ...(options.includeCapOverview ? ["admin-shell:nav:my-caps"] : []),
@@ -23,7 +23,7 @@ function platformWorkspaceNavIds(options) {
23
23
  "audit:nav:audit-log-all-tenants",
24
24
  "jobs:nav:job-runs",
25
25
  ...(options.includeDocumentDesigner ? ["document-designer:nav:platform-templates"] : []),
26
- ...(options.includeTierAdmin === true ? ["admin-shell:nav:tier-admin"] : []),
26
+ ...(options.includeTierAdmin ? ["admin-shell:nav:tier-admin"] : []),
27
27
  ];
28
28
  }
29
29
  export function createAdminShellFeature(options = {}) {
@@ -203,7 +203,8 @@ export function findDescriptionTranslationGaps(registry, options) {
203
203
  for (const handlerQn of options.handlerQns) {
204
204
  const labels = localizedLabels(translations, handlerDescriptionKey(handlerQn));
205
205
  for (const locale of options.locales) {
206
- if (locale === DESCRIPTION_FALLBACK_LOCALE || labels[locale] !== undefined)
206
+ if (locale === DESCRIPTION_FALLBACK_LOCALE ||
207
+ (labels[locale] !== undefined && labels[locale] !== ""))
207
208
  continue;
208
209
  gaps.push({
209
210
  qn: handlerQn,
@@ -2,7 +2,7 @@ import { hasAccess, isAgentVisibleScreen, resolveAgentExposure, } from "@cosmicd
2
2
  import { handlerInputJsonSchema } from "./handler-schema.js";
3
3
  import { compareIds, entryAsLabels, labelsForSuffix, pickLabel, screenTitleLabels, } from "./labels.js";
4
4
  import { recordManifestDenyQns } from "./manifest-deny-qns.js";
5
- import { isExplicitlyAgentHidden } from "./tool-catalog.js";
5
+ import { reachableQueryEntity } from "./tool-catalog.js";
6
6
  function labelProp(labels, locale) {
7
7
  const label = pickLabel(labels, locale);
8
8
  return label === undefined ? {} : { label };
@@ -68,15 +68,27 @@ function buildEntities(entities, translations, getSearchableFields, visibleEntit
68
68
  return result;
69
69
  }
70
70
  const FEATURE_DESCRIPTION_MAX_CHARS = 300;
71
- // Only ". " before a capital ends the sentence, so "e.g. the" and "Art. 15" stay whole.
72
- const SENTENCE_END = /\.\s+(?=\p{Lu})/u;
71
+ // A sentence ends at ./!/? plus a capital; a capital with its own period ("B." in "z. B.")
72
+ // continues the abbreviation, and a known abbreviation before the period is no end either.
73
+ const SENTENCE_END = /[.!?]\s+(?=\p{Lu})(?!\p{Lu}\.)/gu;
74
+ const ABBREVIATION_BEFORE_END = /(?:^|[^\p{L}])(?:e\.g|i\.e|z\. ?B|d\. ?h|u\. ?a|Dr|Art|Nr|vs)\.$/u;
75
+ const TRUNCATION_MARK = "…";
76
+ function firstSentence(text) {
77
+ for (const end of text.matchAll(SENTENCE_END)) {
78
+ const candidate = text.slice(0, end.index + 1);
79
+ if (!ABBREVIATION_BEFORE_END.test(candidate))
80
+ return candidate;
81
+ }
82
+ return text;
83
+ }
73
84
  /** The manifest is prompt payload; the full text stays in `FeatureDefinition.description`
74
- * for the docs generators. */
85
+ * for the docs generators. Cut by code point so no surrogate pair is split. */
75
86
  function leadSentence(description) {
76
- const text = description.replace(/\s+/g, " ").trim();
77
- const end = SENTENCE_END.exec(text);
78
- const sentence = end === null ? text : text.slice(0, end.index + 1);
79
- return sentence.slice(0, FEATURE_DESCRIPTION_MAX_CHARS);
87
+ const sentence = firstSentence(description.replace(/\s+/g, " ").trim());
88
+ const codePoints = Array.from(sentence);
89
+ if (codePoints.length <= FEATURE_DESCRIPTION_MAX_CHARS)
90
+ return sentence;
91
+ return codePoints.slice(0, FEATURE_DESCRIPTION_MAX_CHARS - 1).join("") + TRUNCATION_MARK;
80
92
  }
81
93
  function buildFeatures(features, visibleFeatureNames) {
82
94
  const result = [];
@@ -183,24 +195,20 @@ function withoutOrphanedNavs(navs) {
183
195
  remaining = reachable;
184
196
  }
185
197
  }
186
- // Qualified handler, screen and nav ids all start with the owning feature name.
187
- function featureNameOf(qualifiedId) {
188
- const idx = qualifiedId.indexOf(":");
189
- return idx === -1 ? qualifiedId : qualifiedId.slice(0, idx);
190
- }
191
- function visibleFeatureNamesOf(handlers, screens, navs) {
192
- return new Set([...handlers.map((h) => h.qn), ...screens.map((s) => s.id), ...navs.map((n) => n.id)].map(featureNameOf));
198
+ function visibleFeatureNamesOf(registry, handlers, screens, navs, workspaces) {
199
+ const owners = [
200
+ ...handlers.map((h) => registry.getHandlerFeature(h.qn)),
201
+ ...screens.map((s) => registry.getScreenFeature(s.id)),
202
+ ...navs.map((n) => registry.getNavFeature(n.id)),
203
+ ...workspaces.map((w) => registry.getWorkspaceFeature(w.id)),
204
+ ];
205
+ return new Set(owners.filter((owner) => owner !== undefined));
193
206
  }
194
207
  function entitiesOfQueryToolsFor(registry, roles, denyQns) {
195
- const names = [];
196
- for (const [qn, def] of registry.getAllQueryHandlers()) {
197
- const entityName = registry.getHandlerEntity(qn);
198
- if (entityName === undefined || denyQns.has(qn) || isExplicitlyAgentHidden(def))
199
- continue;
200
- if (hasAccess({ roles }, def.access))
201
- names.push(entityName);
202
- }
203
- return names;
208
+ return [...registry.getAllQueryHandlers()].flatMap(([qn, def]) => {
209
+ const entityName = reachableQueryEntity(registry, qn, def, { roles }, denyQns);
210
+ return entityName === undefined ? [] : [entityName];
211
+ });
204
212
  }
205
213
  // A reference target is "entity" or "<feature>:entity"; registry entity keys are the bare name.
206
214
  function entityNameOfReference(target) {
@@ -303,7 +311,7 @@ export function buildAgentManifest(registry, options) {
303
311
  const navs = buildNavs(navMap, workspaceMap, translations, roles, screenMap, options.locale);
304
312
  const screens = buildScreens(screenMap, navMap, workspaceMap, translations, roles, new Set(navs.map((nav) => nav.id)), options.locale);
305
313
  const workspaces = buildWorkspaces(workspaceMap, translations, roles, options.locale);
306
- const features = buildFeatures(registry.features, visibleFeatureNamesOf(handlers, screens, navs));
314
+ const features = buildFeatures(registry.features, visibleFeatureNamesOf(registry, handlers, screens, navs, workspaces));
307
315
  const entities = buildEntities(registry.getAllEntities(), translations, (name) => registry.getSearchableFields(name), visibleEntityNamesOf(registry, roles, denyQns, handlers, screens), options.locale);
308
316
  const manifest = {
309
317
  builtForRoles: [...roles],
@@ -37,6 +37,9 @@ function fieldLabelsByRow(translations, contract, payloadSchema, locales) {
37
37
  return [[name, resolved]];
38
38
  }));
39
39
  }
40
+ function exampleForVersion(example, version) {
41
+ return example?.version === version ? example : undefined;
42
+ }
40
43
  function buildEvent(registry, contract, domains, options) {
41
44
  const translations = registry.getAllTranslations();
42
45
  const { locales } = options;
@@ -65,7 +68,7 @@ function buildEvent(registry, contract, domains, options) {
65
68
  fieldLabels: fieldLabelsByRow(translations, contract, payloadSchema, locales),
66
69
  payloadSchema,
67
70
  domains,
68
- example: options.examples.get(contract.qn),
71
+ example: exampleForVersion(options.examples.get(contract.qn), contract.version),
69
72
  };
70
73
  }
71
74
  /** Events some scope lists, deduplicated and sorted by QN. An entry without a contract is
@@ -1,6 +1,6 @@
1
1
  import { patAllows } from "@cosmicdrift/kumiko-framework/api";
2
2
  import { handlerDescriptionKey, handlerFieldLabelKey, handlerTitleKey, } from "@cosmicdrift/kumiko-framework/engine";
3
- import { expandScopes, patRateLimitFromFeature, patScopesFromFeature, } from "../../personal-access-tokens/index.js";
3
+ import { expandScopes, PAT_FEATURE, patRateLimitFromFeature, patScopesFromFeature, } from "../../personal-access-tokens/index.js";
4
4
  import { handlerInputJsonSchema } from "../handler-schema.js";
5
5
  import { compareIds, entityFieldLabels, localizedLabels, pickLabel } from "../labels.js";
6
6
  import { collectApiDocsEvents } from "./collect-events.js";
@@ -8,7 +8,7 @@ import { patCreateLabel, patMenuPath } from "./menu-path.js";
8
8
  import { fieldRows } from "./schema-fields.js";
9
9
  import { isSystemOnlyHandler } from "./system-only.js";
10
10
  export function findPatFeature(registry) {
11
- return [...registry.features.values()].find((feature) => patScopesFromFeature(feature) !== undefined);
11
+ return [...registry.features.values()].find((feature) => feature.name === PAT_FEATURE && patScopesFromFeature(feature) !== undefined);
12
12
  }
13
13
  function nonEmpty(value) {
14
14
  return value !== undefined && value !== "" ? value : undefined;
@@ -30,7 +30,7 @@ function buildHandler(registry, qn, def, kind, locales, examples) {
30
30
  const own = localizedLabels(translations, handlerFieldLabelKey(qn, field));
31
31
  const labels = Object.keys(own).length > 0 || entity === undefined
32
32
  ? own
33
- : entityFieldLabels(translations, entity, field);
33
+ : entityFieldLabels(translations, entity, field, qn.split(":")[0]);
34
34
  return [field, perLocale(locales, (locale) => pickLabel(labels, locale))];
35
35
  }));
36
36
  return {
@@ -9,8 +9,11 @@ import { renderOpenApi } from "./render-openapi.js";
9
9
  import { renderOverview } from "./render-overview.js";
10
10
  import { renderReferencePage } from "./render-reference.js";
11
11
  import { renderTokens } from "./render-tokens.js";
12
+ import { scopeSlugCollisionProblems } from "./scope-slug-collisions.js";
12
13
  import { isApiDocsLocale, resolveApiDocsTexts } from "./texts/index.js";
14
+ import { findTitleAndFieldLabelProblems } from "./translation-gaps.js";
13
15
  import { uiWriteProblems } from "./ui-writes.js";
16
+ import { webhookExampleProblems } from "./webhook-example-problems.js";
14
17
  export const OPENAPI_FILE = "openapi.json";
15
18
  const OVERVIEW_ORDER = 1;
16
19
  const TOKENS_ORDER = 2;
@@ -95,7 +98,7 @@ export function generateApiDocs(input) {
95
98
  const handlerQns = model.handlers.map((handler) => handler.qn);
96
99
  problems.push(...findApiDocHandlerGaps([...registry.features.values()], new Set(handlerQns)).map((gap) => ({ kind: "docGap", gap })), ...findDescriptionTranslationGaps(registry, { handlerQns, locales }).flatMap((gap) => gap.locale === undefined
97
100
  ? []
98
- : [{ kind: "descriptionTranslationMissing", qn: gap.qn, locale: gap.locale }]), ...uiWriteProblems(registry, model, config.uiOnlyWrites ?? []), ...model.events.flatMap((event) => event.untranslatedLocales.map((locale) => ({
101
+ : [{ kind: "descriptionTranslationMissing", qn: gap.qn, locale: gap.locale }]), ...findTitleAndFieldLabelProblems(registry, model, locales), ...uiWriteProblems(registry, model, config.uiOnlyWrites ?? []), ...scopeSlugCollisionProblems(model.scopes), ...webhookExampleProblems(input.webhookExamples ?? [], model.events), ...model.events.flatMap((event) => event.untranslatedLocales.map((locale) => ({
99
102
  kind: "webhookEventWithoutDescriptionTranslation",
100
103
  qn: event.qn,
101
104
  locale,
@@ -5,5 +5,6 @@ export { type ApiDocsInput, type ApiDocsResult, generateApiDocs, OPENAPI_FILE, }
5
5
  export { INDEX_FILE } from "./index-json.ts";
6
6
  export type { ApiDocsSource, ResolvedApiDocsConfig } from "./model.ts";
7
7
  export { type ApiDocsProblem, formatApiDocsProblem } from "./problems.ts";
8
+ export { resolveApiDocsConfig } from "./resolve-config.ts";
8
9
  export type { ApiDocsLocale, ApiDocsTexts } from "./texts/index.ts";
9
10
  export { apiDocsLocales, formatApiDocsText, isApiDocsLocale } from "./texts/index.ts";
@@ -3,4 +3,5 @@ export { ApiExampleFileSchema, WebhookExampleFileSchema, } from "./examples.js";
3
3
  export { generateApiDocs, OPENAPI_FILE, } from "./generate.js";
4
4
  export { INDEX_FILE } from "./index-json.js";
5
5
  export { formatApiDocsProblem } from "./problems.js";
6
+ export { resolveApiDocsConfig } from "./resolve-config.js";
6
7
  export { apiDocsLocales, formatApiDocsText, isApiDocsLocale } from "./texts/index.js";
@@ -8,6 +8,15 @@ export type ApiDocsProblem = {
8
8
  readonly kind: "descriptionTranslationMissing";
9
9
  readonly qn: string;
10
10
  readonly locale: string;
11
+ } | {
12
+ readonly kind: "titleTranslationMissing";
13
+ readonly qn: string;
14
+ readonly locale: string;
15
+ } | {
16
+ readonly kind: "fieldLabelMissing";
17
+ readonly qn: string;
18
+ readonly field: string;
19
+ readonly locale: string;
11
20
  } | {
12
21
  readonly kind: "uiWriteOutsideScopes";
13
22
  readonly qn: string;
@@ -22,6 +31,18 @@ export type ApiDocsProblem = {
22
31
  readonly kind: "webhookEventWithoutDescriptionTranslation";
23
32
  readonly qn: string;
24
33
  readonly locale: string;
34
+ } | {
35
+ readonly kind: "webhookExampleVersionMismatch";
36
+ readonly qn: string;
37
+ readonly fileVersion: number;
38
+ readonly contractVersion: number;
39
+ } | {
40
+ readonly kind: "unusedWebhookExample";
41
+ readonly fileName: string;
42
+ } | {
43
+ readonly kind: "scopeSlugCollision";
44
+ readonly slug: string;
45
+ readonly domains: readonly string[];
25
46
  } | {
26
47
  readonly kind: "invalidTextOverride";
27
48
  readonly locale: string;
@@ -1,4 +1,4 @@
1
- import { webhookEventDescriptionKey } from "@cosmicdrift/kumiko-framework/engine";
1
+ import { handlerFieldLabelKey, handlerTitleKey, webhookEventDescriptionKey, } from "@cosmicdrift/kumiko-framework/engine";
2
2
  import { formatAgentDocGap } from "../agent-doc-lint.js";
3
3
  export function formatApiDocsProblem(problem) {
4
4
  switch (problem.kind) {
@@ -8,6 +8,10 @@ export function formatApiDocsProblem(problem) {
8
8
  return `[docGap] ${formatAgentDocGap(problem.gap)}`;
9
9
  case "descriptionTranslationMissing":
10
10
  return `[descriptionTranslationMissing] ${problem.qn} has no \`${problem.locale}\` description translation.`;
11
+ case "titleTranslationMissing":
12
+ return `[titleTranslationMissing] ${problem.qn} has no \`${problem.locale}\` title translation (key ${handlerTitleKey(problem.qn)}).`;
13
+ case "fieldLabelMissing":
14
+ return `[fieldLabelMissing] ${problem.qn} field "${problem.field}" has no \`${problem.locale}\` label (key ${handlerFieldLabelKey(problem.qn, problem.field)}).`;
11
15
  case "uiWriteOutsideScopes":
12
16
  return `[uiWriteOutsideScopes] ${problem.qn} is used by ${problem.screens.join(", ")} but no token scope grants it. Add it to a scope or list it under apiDocs.uiOnlyWrites.`;
13
17
  case "unusedUiOnlyWrite":
@@ -16,6 +20,12 @@ export function formatApiDocsProblem(problem) {
16
20
  return `[webhookDeliveryTextMissing] Webhook events are public but apiDocs.webhookDelivery has no \`${problem.locale}\` text.`;
17
21
  case "webhookEventWithoutDescriptionTranslation":
18
22
  return `[webhookEventWithoutDescriptionTranslation] ${problem.qn} has no \`${problem.locale}\` description translation (key ${webhookEventDescriptionKey(problem.qn)}).`;
23
+ case "webhookExampleVersionMismatch":
24
+ return `[webhookExampleVersionMismatch] The recorded example for ${problem.qn} is version ${problem.fileVersion}, the contract is version ${problem.contractVersion}, so the example is not shown.`;
25
+ case "unusedWebhookExample":
26
+ return `[unusedWebhookExample] The webhook example ${problem.fileName} names no event that a token scope lists.`;
27
+ case "scopeSlugCollision":
28
+ return `[scopeSlugCollision] The scopes ${problem.domains.join(", ")} share the reference page slug "${problem.slug}". Rename one of them.`;
19
29
  case "invalidTextOverride":
20
30
  return `[invalidTextOverride] apiDocs.texts.${problem.locale}["${problem.key}"]: ${problem.cause}`;
21
31
  }
@@ -22,6 +22,8 @@ function embedSchema(schema, name, hoisted) {
22
22
  return Object.fromEntries(Object.entries(node)
23
23
  .filter(([key]) => key !== "$schema" && key !== "$defs")
24
24
  .map(([key, value]) => {
25
+ if (key === "$ref" && value === "#")
26
+ return [key, `${SCHEMAS}/${name}`];
25
27
  if (key === "$ref" && typeof value === "string" && value.startsWith("#/$defs/")) {
26
28
  return [key, `${SCHEMAS}/${name}.${value.slice("#/$defs/".length)}`];
27
29
  }
@@ -0,0 +1,9 @@
1
+ import type { AppApiDocsConfig } from "@cosmicdrift/kumiko-framework/config";
2
+ import type { ResolvedApiDocsConfig } from "./model.ts";
3
+ /** The one place that fills the config defaults, so `kumiko api-docs` and the recipe golden
4
+ * test generate from the same settings. A missing `baseUrl` stays empty: the CLI refuses it
5
+ * before it gets here. */
6
+ export declare function resolveApiDocsConfig(apiDocs: AppApiDocsConfig, options: {
7
+ readonly appName: string;
8
+ readonly locales?: readonly string[];
9
+ }): ResolvedApiDocsConfig;
@@ -0,0 +1,11 @@
1
+ /** The one place that fills the config defaults, so `kumiko api-docs` and the recipe golden
2
+ * test generate from the same settings. A missing `baseUrl` stays empty: the CLI refuses it
3
+ * before it gets here. */
4
+ export function resolveApiDocsConfig(apiDocs, options) {
5
+ return {
6
+ ...apiDocs,
7
+ locales: options.locales ?? apiDocs.locales ?? ["en"],
8
+ baseUrl: apiDocs.baseUrl ?? "",
9
+ appName: apiDocs.appName ?? options.appName,
10
+ };
11
+ }
@@ -0,0 +1,4 @@
1
+ import type { ApiDocsScope } from "./model.ts";
2
+ import type { ApiDocsProblem } from "./problems.ts";
3
+ /** Scopes whose domains slugify alike would write the same reference page. */
4
+ export declare function scopeSlugCollisionProblems(scopes: readonly Pick<ApiDocsScope, "domain">[]): readonly ApiDocsProblem[];
@@ -0,0 +1,10 @@
1
+ import { slugify } from "./anchors.js";
2
+ /** Scopes whose domains slugify alike would write the same reference page. */
3
+ export function scopeSlugCollisionProblems(scopes) {
4
+ const domainsBySlug = new Map();
5
+ for (const { domain } of scopes) {
6
+ const slug = slugify(domain);
7
+ domainsBySlug.set(slug, [...(domainsBySlug.get(slug) ?? []), domain]);
8
+ }
9
+ return [...domainsBySlug].flatMap(([slug, domains]) => domains.length > 1 ? [{ kind: "scopeSlugCollision", slug, domains }] : []);
10
+ }
@@ -0,0 +1,4 @@
1
+ import type { RegistryManifestView } from "../types.ts";
2
+ import type { ApiDocsModel } from "./model.ts";
3
+ import type { ApiDocsProblem } from "./problems.ts";
4
+ export declare function findTitleAndFieldLabelProblems(registry: Pick<RegistryManifestView, "getAllTranslations" | "getHandlerEntity">, model: Pick<ApiDocsModel, "handlers">, locales: readonly string[]): readonly ApiDocsProblem[];
@@ -0,0 +1,29 @@
1
+ import { handlerFieldLabelKey, handlerTitleKey } from "@cosmicdrift/kumiko-framework/engine";
2
+ import { entityFieldLabels, localizedLabels } from "../labels.js";
3
+ import { fieldRows } from "./schema-fields.js";
4
+ // "en" is skipped like for descriptions: the English page may fall back to the handler's own
5
+ // text, while a German page that shows English titles or empty field cells is a visible gap.
6
+ const FALLBACK_LOCALE = "en";
7
+ export function findTitleAndFieldLabelProblems(registry, model, locales) {
8
+ const translations = registry.getAllTranslations();
9
+ const checkedLocales = locales.filter((locale) => locale !== FALLBACK_LOCALE);
10
+ return model.handlers.flatMap((handler) => {
11
+ const titleLabels = localizedLabels(translations, handlerTitleKey(handler.qn));
12
+ const entity = registry.getHandlerEntity(handler.qn);
13
+ const titleProblems = checkedLocales.flatMap((locale) => titleLabels[locale] === undefined
14
+ ? [{ kind: "titleTranslationMissing", qn: handler.qn, locale }]
15
+ : []);
16
+ const fieldProblems = fieldRows(handler.inputSchema).flatMap(({ name: field }) => {
17
+ const own = localizedLabels(translations, handlerFieldLabelKey(handler.qn, field));
18
+ const labels = Object.keys(own).length > 0 || entity === undefined
19
+ ? own
20
+ : entityFieldLabels(translations, entity, field, handler.qn.split(":")[0]);
21
+ if (Object.keys(labels).length === 0)
22
+ return [];
23
+ return checkedLocales.flatMap((locale) => labels[locale] === undefined
24
+ ? [{ kind: "fieldLabelMissing", qn: handler.qn, field, locale }]
25
+ : []);
26
+ });
27
+ return [...titleProblems, ...fieldProblems];
28
+ });
29
+ }
@@ -0,0 +1,6 @@
1
+ import type { NamedWebhookExample } from "./examples.ts";
2
+ import type { ApiDocsEvent } from "./model.ts";
3
+ import type { ApiDocsProblem } from "./problems.ts";
4
+ /** Recordings that never reach the events page: for an event no scope lists, or recorded
5
+ * against another contract version than the current one. */
6
+ export declare function webhookExampleProblems(examples: readonly NamedWebhookExample[], events: readonly ApiDocsEvent[]): readonly ApiDocsProblem[];
@@ -0,0 +1,25 @@
1
+ import { compareIds } from "../labels.js";
2
+ /** Recordings that never reach the events page: for an event no scope lists, or recorded
3
+ * against another contract version than the current one. */
4
+ export function webhookExampleProblems(examples, events) {
5
+ const eventByQn = new Map(events.map((event) => [event.qn, event]));
6
+ const reported = new Set();
7
+ return [...examples]
8
+ .sort((a, b) => compareIds(a.fileName, b.fileName))
9
+ .flatMap(({ fileName, file }) => {
10
+ const event = eventByQn.get(file.event);
11
+ if (event === undefined)
12
+ return [{ kind: "unusedWebhookExample", fileName }];
13
+ if (event.example !== undefined || reported.has(event.qn))
14
+ return [];
15
+ reported.add(event.qn);
16
+ return [
17
+ {
18
+ kind: "webhookExampleVersionMismatch",
19
+ qn: event.qn,
20
+ fileVersion: file.version,
21
+ contractVersion: event.version,
22
+ },
23
+ ];
24
+ });
25
+ }
@@ -1,7 +1,7 @@
1
1
  export type { AgentDocGap, AgentDocGapKind } from "./agent-doc-lint.ts";
2
2
  export { AgentDocGapKinds, findAgentDocGaps, findDescriptionTranslationGaps, findHandlerTranslationGaps, formatAgentDocGap, } from "./agent-doc-lint.ts";
3
3
  export { buildAgentManifest } from "./agent-manifest.ts";
4
- export { type ApiDocsDiff, type ApiDocsInput, type ApiDocsLocale, type ApiDocsProblem, type ApiDocsResult, type ApiDocsSource, type ApiDocsTexts, type ApiExampleFile, ApiExampleFileSchema, apiDocsLocales, diffApiDocsOutput, formatApiDocsProblem, formatApiDocsText, generateApiDocs, INDEX_FILE, isApiDocsLocale, type NamedApiExample, type NamedWebhookExample, OPENAPI_FILE, type ResolvedApiDocsConfig, WebhookExampleFileSchema, } from "./api-docs/index.ts";
4
+ export { type ApiDocsDiff, type ApiDocsInput, type ApiDocsLocale, type ApiDocsProblem, type ApiDocsResult, type ApiDocsSource, type ApiDocsTexts, type ApiExampleFile, ApiExampleFileSchema, apiDocsLocales, diffApiDocsOutput, formatApiDocsProblem, formatApiDocsText, generateApiDocs, INDEX_FILE, isApiDocsLocale, type NamedApiExample, type NamedWebhookExample, OPENAPI_FILE, type ResolvedApiDocsConfig, resolveApiDocsConfig, WebhookExampleFileSchema, } from "./api-docs/index.ts";
5
5
  export { AGENT_TOOLS_FEATURE_NAME, createAgentToolsFeature } from "./feature.ts";
6
6
  export { buildToolCatalog, OPEN_FORM_TOOL_NAME, toolNameForQn } from "./tool-catalog.ts";
7
7
  export type { ToolCallRequest, ToolCallResult, ToolDispatcher } from "./tool-dispatch.ts";
@@ -1,6 +1,6 @@
1
1
  export { AgentDocGapKinds, findAgentDocGaps, findDescriptionTranslationGaps, findHandlerTranslationGaps, formatAgentDocGap, } from "./agent-doc-lint.js";
2
2
  export { buildAgentManifest } from "./agent-manifest.js";
3
- export { ApiExampleFileSchema, apiDocsLocales, diffApiDocsOutput, formatApiDocsProblem, formatApiDocsText, generateApiDocs, INDEX_FILE, isApiDocsLocale, OPENAPI_FILE, WebhookExampleFileSchema, } from "./api-docs/index.js";
3
+ export { ApiExampleFileSchema, apiDocsLocales, diffApiDocsOutput, formatApiDocsProblem, formatApiDocsText, generateApiDocs, INDEX_FILE, isApiDocsLocale, OPENAPI_FILE, resolveApiDocsConfig, WebhookExampleFileSchema, } from "./api-docs/index.js";
4
4
  export { AGENT_TOOLS_FEATURE_NAME, createAgentToolsFeature } from "./feature.js";
5
5
  export { buildToolCatalog, OPEN_FORM_TOOL_NAME, toolNameForQn } from "./tool-catalog.js";
6
6
  export { dispatchToolCall, TOOL_CALL_ERROR_CODES } from "./tool-dispatch.js";
@@ -17,8 +17,9 @@ export declare function localizedLabels(translations: TranslationKeys, fullKey:
17
17
  /** `labelsForSuffix` with the locale-package completion of `localizedLabels`: the owner
18
18
  * key behind the suffix is preferred over a locale package key that ends the same way. */
19
19
  export declare function localizedLabelsForSuffix(translations: TranslationKeys, suffix: string): Readonly<Record<string, string>>;
20
- /** Entity field label per locale; `field` may be a dotted path, only its last segment names the field. */
21
- export declare function entityFieldLabels(translations: TranslationKeys, entity: string, field: string): Readonly<Record<string, string>>;
20
+ /** Entity field label per locale; `field` may be a dotted path, only its last segment names the field.
21
+ * With `ownerFeature` that feature's own key wins over a same-named entity of another feature. */
22
+ export declare function entityFieldLabels(translations: TranslationKeys, entity: string, field: string, ownerFeature?: string): Readonly<Record<string, string>>;
22
23
  /** Screen titles live under the qualified id or, for feature-local screens, under
23
24
  * `screen:<shortId>.title`. */
24
25
  export declare function screenTitleLabels(translations: TranslationKeys, screenId: string): Readonly<Record<string, string>>;
@@ -12,7 +12,9 @@ export function pickLabel(labels, locale) {
12
12
  const firstLocale = Object.keys(labels)
13
13
  .sort(compareIds)
14
14
  .find((key) => nonEmpty(labels[key]));
15
+ const baseLanguage = locale.split("-")[0]?.toLowerCase();
15
16
  return (nonEmpty(labels[locale]) ??
17
+ (baseLanguage !== undefined ? nonEmpty(labels[baseLanguage]) : undefined) ??
16
18
  nonEmpty(labels[FALLBACK_LOCALE]) ??
17
19
  (firstLocale !== undefined ? labels[firstLocale] : undefined));
18
20
  }
@@ -99,18 +101,33 @@ export function localizedLabels(translations, fullKey) {
99
101
  }
100
102
  return merged;
101
103
  }
104
+ function endsAtKeyBoundary(key, suffix) {
105
+ if (!key.endsWith(suffix))
106
+ return false;
107
+ if (key.length === suffix.length || suffix.startsWith(":") || suffix.startsWith("."))
108
+ return true;
109
+ const before = key[key.length - suffix.length - 1];
110
+ return before === ":" || before === ".";
111
+ }
102
112
  /** `labelsForSuffix` with the locale-package completion of `localizedLabels`: the owner
103
113
  * key behind the suffix is preferred over a locale package key that ends the same way. */
104
114
  export function localizedLabelsForSuffix(translations, suffix) {
105
115
  const match = suffixMatch(translations, suffix);
106
116
  if (match === undefined)
107
117
  return {};
108
- const owner = Object.keys(translations).find((key) => !key.startsWith(LOCALE_PACKAGE_PREFIX) && key.endsWith(suffix));
118
+ const owner = Object.keys(translations).find((key) => !key.startsWith(LOCALE_PACKAGE_PREFIX) && endsAtKeyBoundary(key, suffix));
109
119
  return localizedLabels(translations, owner ?? match.key);
110
120
  }
111
- /** Entity field label per locale; `field` may be a dotted path, only its last segment names the field. */
112
- export function entityFieldLabels(translations, entity, field) {
113
- return localizedLabelsForSuffix(translations, `:entity:${entity}:field:${field.slice(field.lastIndexOf(".") + 1)}`);
121
+ /** Entity field label per locale; `field` may be a dotted path, only its last segment names the field.
122
+ * With `ownerFeature` that feature's own key wins over a same-named entity of another feature. */
123
+ export function entityFieldLabels(translations, entity, field, ownerFeature) {
124
+ const tail = `entity:${entity}:field:${field.slice(field.lastIndexOf(".") + 1)}`;
125
+ if (ownerFeature !== undefined) {
126
+ const own = localizedLabels(translations, `${ownerFeature}:${tail}`);
127
+ if (Object.keys(own).length > 0)
128
+ return own;
129
+ }
130
+ return localizedLabelsForSuffix(translations, `:${tail}`);
114
131
  }
115
132
  function lastSegmentOf(qualifiedId) {
116
133
  return qualifiedId.slice(qualifiedId.lastIndexOf(":") + 1);
@@ -1,10 +1,10 @@
1
1
  import type { QueryHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
2
2
  import type { AgentManifest, RegistrySearchView, ToolCatalog, ToolCatalogOptions } from "./types.ts";
3
- /** The entity CRUD tools are enumerated off the registry, not off the manifest, so
4
- * `resolveAgentExposure` never runs for them. Only an EXPLICIT opt-out may hide one here —
5
- * the resolver's own default is fail-closed on a missing `description`, and CRUD-generated
6
- * handlers never carry one, so reusing it would delete every entity tool in every app. */
7
- export declare function isExplicitlyAgentHidden(def: QueryHandlerDef): boolean;
3
+ /** The entity a query handler serves to this role as a registry-derived tool, if any. The
4
+ * manifest and the catalog both decide entity reachability through this one rule. */
5
+ export declare function reachableQueryEntity(registry: Pick<RegistrySearchView, "getHandlerEntity">, qn: string, def: QueryHandlerDef, roleFilter: {
6
+ roles: readonly string[];
7
+ }, denyQns: ReadonlySet<string>): string | undefined;
8
8
  /** Drops the `query`/`write` verb segment from a handler QN, joins the rest with `_`, and
9
9
  * sanitizes to a valid tool-call identifier. Only the FIRST matching segment is dropped —
10
10
  * QNs are `<feature>:query|write:<entity>:<verb>`, so the verb only ever appears once at that
@@ -72,9 +72,17 @@ function isDetailHandlerQn(qn, entityName) {
72
72
  * `resolveAgentExposure` never runs for them. Only an EXPLICIT opt-out may hide one here —
73
73
  * the resolver's own default is fail-closed on a missing `description`, and CRUD-generated
74
74
  * handlers never carry one, so reusing it would delete every entity tool in every app. */
75
- export function isExplicitlyAgentHidden(def) {
75
+ function isExplicitlyAgentHidden(def) {
76
76
  return def.agent?.expose === false;
77
77
  }
78
+ /** The entity a query handler serves to this role as a registry-derived tool, if any. The
79
+ * manifest and the catalog both decide entity reachability through this one rule. */
80
+ export function reachableQueryEntity(registry, qn, def, roleFilter, denyQns) {
81
+ const entityName = registry.getHandlerEntity(qn);
82
+ if (entityName === undefined || denyQns.has(qn) || isExplicitlyAgentHidden(def))
83
+ return undefined;
84
+ return hasAccess(roleFilter, def.access) ? entityName : undefined;
85
+ }
78
86
  /** The model's filters feed the WHERE clause, and only the output is field-filtered — a field
79
87
  * whose read access is role- or row-restricted would leak through `totalCount` and hit/miss
80
88
  * probing. Only fields every one of these roles may read without a row condition are offered. */
@@ -332,13 +340,9 @@ function addTool(sink, tool, descriptor) {
332
340
  }
333
341
  function addRegistrySearchTools(registry, roleFilter, denyQns, sink) {
334
342
  for (const [qn, def] of registry.getAllQueryHandlers()) {
335
- const entityName = registry.getHandlerEntity(qn);
343
+ const entityName = reachableQueryEntity(registry, qn, def, roleFilter, denyQns);
336
344
  if (!entityName || !isListHandlerQn(qn, entityName))
337
345
  continue;
338
- if (denyQns.has(qn) || isExplicitlyAgentHidden(def))
339
- continue;
340
- if (!hasAccess(roleFilter, def.access))
341
- continue;
342
346
  const entity = registry.getEntity(entityName);
343
347
  if (!entity)
344
348
  continue;
@@ -361,10 +365,8 @@ function collectEntityHandlerQns(registry, roleFilter, denyQns) {
361
365
  entityListDetailQns.add(qn);
362
366
  }
363
367
  for (const [qn, def] of registry.getAllQueryHandlers()) {
364
- const entityName = registry.getHandlerEntity(qn);
365
- if (!entityName || !hasAccess(roleFilter, def.access))
366
- continue;
367
- if (denyQns.has(qn) || isExplicitlyAgentHidden(def))
368
+ const entityName = reachableQueryEntity(registry, qn, def, roleFilter, denyQns);
369
+ if (!entityName)
368
370
  continue;
369
371
  if (isDetailHandlerQn(qn, entityName))
370
372
  detailQnByEntity.set(entityName, qn);
@@ -184,7 +184,13 @@ async function dispatchServerWrite(descriptor, dispatcher, user, input, runId, t
184
184
  return invalidToolCall(`This tool requires a non-empty string "id" argument`);
185
185
  }
186
186
  if (!descriptor.detailQn) {
187
- return invalidToolCall("Tool is misconfigured: no detail handler to read version from");
187
+ const message = `Tool ${descriptor.qn} injects a version but has no detail handler to read it from`;
188
+ return classifyFailure({
189
+ code: "internal_error",
190
+ httpStatus: HTTP_SERVER_ERROR,
191
+ message,
192
+ retryAfterSeconds: undefined,
193
+ }, new Error(message));
188
194
  }
189
195
  const current = await dispatcher.query(descriptor.detailQn, { id }, user);
190
196
  const version = isRecord(current) && typeof current["version"] === "number" ? current["version"] : undefined;
@@ -282,6 +288,10 @@ function dispatchClient(descriptor, input) {
282
288
  return dispatchClientOpenForm(descriptor, input);
283
289
  case "ask_user":
284
290
  return dispatchClientAskUser(input);
291
+ default: {
292
+ const exhaustiveCheck = descriptor;
293
+ return exhaustiveCheck;
294
+ }
285
295
  }
286
296
  }
287
297
  /** Executes one LLM-issued tool call. Never throws: every failure comes back as `{ ok: false }`
@@ -192,6 +192,10 @@ export type RegistryManifestView = {
192
192
  getAllQueryHandlers(): ReadonlyMap<string, QueryHandlerDef>;
193
193
  getAllWriteHandlers(): ReadonlyMap<string, WriteHandlerDef>;
194
194
  getHandlerEntity(qualifiedHandler: string): string | undefined;
195
+ getHandlerFeature(qualifiedHandler: string): string | undefined;
196
+ getScreenFeature(qualifiedName: string): string | undefined;
197
+ getNavFeature(qualifiedName: string): string | undefined;
198
+ getWorkspaceFeature(qualifiedName: string): string | undefined;
195
199
  getSearchableFields(entityName: string): readonly string[];
196
200
  getAllTranslations(): TranslationKeys;
197
201
  getAllScreens(): ReadonlyMap<string, ScreenDefinition>;
@@ -14,6 +14,9 @@ export const AUDIT_EVENT_STANCES = {
14
14
  "inbound-mail-foundation:event:inbound-message-received": TECHNICAL_EVENT,
15
15
  "inbound-mail-foundation:event:inbound-message-content-fetched": TECHNICAL_EVENT,
16
16
  "inbound-mail-foundation:event:mail-thread-updated": TECHNICAL_EVENT,
17
+ "channel-whatsapp:event:message-received": TECHNICAL_EVENT,
18
+ "channel-whatsapp:event:status-updated": TECHNICAL_EVENT,
19
+ "channel-whatsapp:event:throttled": TECHNICAL_EVENT,
17
20
  "document-ingest-foundation:event:document-ingest-progress": TECHNICAL_EVENT,
18
21
  "document-ingest-foundation:event:document-ingest-requested": TECHNICAL_EVENT,
19
22
  "document-ingest-foundation:event:document-ingest-skipped": TECHNICAL_EVENT,
@@ -40,6 +43,8 @@ export const AUDIT_EVENT_STANCES = {
40
43
  "billing-foundation:event:invoice-payment-failed": label("invoice-payment-failed"),
41
44
  "billing-foundation:event:payment-received": label("payment-received"),
42
45
  "billing-foundation:event:checkout-consent-recorded": label("checkout-consent-recorded"),
46
+ "billing-foundation:event:checkout-opened": TECHNICAL_EVENT,
47
+ "subscription-paddle:event:ledger-backfill-sweep-completed": TECHNICAL_EVENT,
43
48
  "billing-foundation:event:contract-confirmation-issued": label("contract-confirmation-issued"),
44
49
  "billing-foundation:event:contract-termination-requested": label("contract-termination-requested"),
45
50
  "billing-foundation:event:contract-termination-declared": label("contract-termination-declared"),
@@ -54,6 +59,7 @@ export const AUDIT_EVENT_STANCES = {
54
59
  "waitlist:event:exported": label("waitlist-exported"),
55
60
  "waitlist:event:purged": label("waitlist-purged"),
56
61
  "feature-toggles:event:toggle-set": label("feature-toggle-set"),
62
+ "jobs:event:consumer-state-changed": label("consumer-state-changed"),
57
63
  };
58
64
  // Streams whose payload holds rows that only a SystemAdmin or a single owner may read: a
59
65
  // readiness probe run stores system-probe and personal-mailbox results next to the tenant's
@@ -59,6 +59,7 @@ export const AUDIT_I18N = {
59
59
  "audit.log.event.waitlist-exported": { en: "Waitlist exported" },
60
60
  "audit.log.event.waitlist-purged": { en: "Waitlist purged" },
61
61
  "audit.log.event.feature-toggle-set": { en: "Feature toggle changed" },
62
+ "audit.log.event.consumer-state-changed": { en: "Event consumer state changed" },
62
63
  "audit.log.event.contract-termination-requested": { en: "Contract termination requested" },
63
64
  "audit.log.event.contract-termination-declared": { en: "Contract termination declared" },
64
65
  "audit.log.event.contract-termination-unmatched": { en: "Contract termination not matched" },