@krantho/api 0.0.0-stage → 1.0.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 (675) hide show
  1. package/LICENSE +21 -0
  2. package/dist/active-locales.d.ts +11 -0
  3. package/dist/active-locales.d.ts.map +1 -0
  4. package/dist/active-locales.js +31 -0
  5. package/dist/active-locales.js.map +1 -0
  6. package/dist/assistant/access.d.ts +25 -0
  7. package/dist/assistant/access.d.ts.map +1 -0
  8. package/dist/assistant/access.js +35 -0
  9. package/dist/assistant/access.js.map +1 -0
  10. package/dist/assistant/agent-loop.d.ts +31 -0
  11. package/dist/assistant/agent-loop.d.ts.map +1 -0
  12. package/dist/assistant/agent-loop.js +183 -0
  13. package/dist/assistant/agent-loop.js.map +1 -0
  14. package/dist/assistant/call-handler.d.ts +15 -0
  15. package/dist/assistant/call-handler.d.ts.map +1 -0
  16. package/dist/assistant/call-handler.js +24 -0
  17. package/dist/assistant/call-handler.js.map +1 -0
  18. package/dist/assistant/chat-handler.d.ts +8 -0
  19. package/dist/assistant/chat-handler.d.ts.map +1 -0
  20. package/dist/assistant/chat-handler.js +79 -0
  21. package/dist/assistant/chat-handler.js.map +1 -0
  22. package/dist/assistant/chat-request.d.ts +16 -0
  23. package/dist/assistant/chat-request.d.ts.map +1 -0
  24. package/dist/assistant/chat-request.js +59 -0
  25. package/dist/assistant/chat-request.js.map +1 -0
  26. package/dist/assistant/confirm-handler.d.ts +3 -0
  27. package/dist/assistant/confirm-handler.d.ts.map +1 -0
  28. package/dist/assistant/confirm-handler.js +39 -0
  29. package/dist/assistant/confirm-handler.js.map +1 -0
  30. package/dist/assistant/document-change.d.ts +22 -0
  31. package/dist/assistant/document-change.d.ts.map +1 -0
  32. package/dist/assistant/document-change.js +74 -0
  33. package/dist/assistant/document-change.js.map +1 -0
  34. package/dist/assistant/document-lock.d.ts +12 -0
  35. package/dist/assistant/document-lock.d.ts.map +1 -0
  36. package/dist/assistant/document-lock.js +14 -0
  37. package/dist/assistant/document-lock.js.map +1 -0
  38. package/dist/assistant/execute-action.d.ts +19 -0
  39. package/dist/assistant/execute-action.d.ts.map +1 -0
  40. package/dist/assistant/execute-action.js +167 -0
  41. package/dist/assistant/execute-action.js.map +1 -0
  42. package/dist/assistant/pending-action.d.ts +86 -0
  43. package/dist/assistant/pending-action.d.ts.map +1 -0
  44. package/dist/assistant/pending-action.js +104 -0
  45. package/dist/assistant/pending-action.js.map +1 -0
  46. package/dist/assistant/protocol.d.ts +120 -0
  47. package/dist/assistant/protocol.d.ts.map +1 -0
  48. package/dist/assistant/protocol.js +2 -0
  49. package/dist/assistant/protocol.js.map +1 -0
  50. package/dist/assistant/routes.d.ts +4 -0
  51. package/dist/assistant/routes.d.ts.map +1 -0
  52. package/dist/assistant/routes.js +10 -0
  53. package/dist/assistant/routes.js.map +1 -0
  54. package/dist/assistant/sse-stream.d.ts +15 -0
  55. package/dist/assistant/sse-stream.d.ts.map +1 -0
  56. package/dist/assistant/sse-stream.js +61 -0
  57. package/dist/assistant/sse-stream.js.map +1 -0
  58. package/dist/assistant/status-handler.d.ts +8 -0
  59. package/dist/assistant/status-handler.d.ts.map +1 -0
  60. package/dist/assistant/status-handler.js +39 -0
  61. package/dist/assistant/status-handler.js.map +1 -0
  62. package/dist/assistant/system-prompt.d.ts +18 -0
  63. package/dist/assistant/system-prompt.d.ts.map +1 -0
  64. package/dist/assistant/system-prompt.js +48 -0
  65. package/dist/assistant/system-prompt.js.map +1 -0
  66. package/dist/assistant/tool-registry.d.ts +19 -0
  67. package/dist/assistant/tool-registry.d.ts.map +1 -0
  68. package/dist/assistant/tool-registry.js +69 -0
  69. package/dist/assistant/tool-registry.js.map +1 -0
  70. package/dist/assistant/tools/action-tools.d.ts +4 -0
  71. package/dist/assistant/tools/action-tools.d.ts.map +1 -0
  72. package/dist/assistant/tools/action-tools.js +132 -0
  73. package/dist/assistant/tools/action-tools.js.map +1 -0
  74. package/dist/assistant/tools/aeo-tools.d.ts +4 -0
  75. package/dist/assistant/tools/aeo-tools.d.ts.map +1 -0
  76. package/dist/assistant/tools/aeo-tools.js +162 -0
  77. package/dist/assistant/tools/aeo-tools.js.map +1 -0
  78. package/dist/assistant/tools/define-tool.d.ts +55 -0
  79. package/dist/assistant/tools/define-tool.d.ts.map +1 -0
  80. package/dist/assistant/tools/define-tool.js +5 -0
  81. package/dist/assistant/tools/define-tool.js.map +1 -0
  82. package/dist/assistant/tools/draft-tools.d.ts +7 -0
  83. package/dist/assistant/tools/draft-tools.d.ts.map +1 -0
  84. package/dist/assistant/tools/draft-tools.js +105 -0
  85. package/dist/assistant/tools/draft-tools.js.map +1 -0
  86. package/dist/assistant/tools/draft-write.d.ts +49 -0
  87. package/dist/assistant/tools/draft-write.d.ts.map +1 -0
  88. package/dist/assistant/tools/draft-write.js +122 -0
  89. package/dist/assistant/tools/draft-write.js.map +1 -0
  90. package/dist/assistant/tools/faq-fit.d.ts +32 -0
  91. package/dist/assistant/tools/faq-fit.d.ts.map +1 -0
  92. package/dist/assistant/tools/faq-fit.js +96 -0
  93. package/dist/assistant/tools/faq-fit.js.map +1 -0
  94. package/dist/assistant/tools/read-tools.d.ts +13 -0
  95. package/dist/assistant/tools/read-tools.d.ts.map +1 -0
  96. package/dist/assistant/tools/read-tools.js +242 -0
  97. package/dist/assistant/tools/read-tools.js.map +1 -0
  98. package/dist/assistant/tools/seo-tools.d.ts +4 -0
  99. package/dist/assistant/tools/seo-tools.d.ts.map +1 -0
  100. package/dist/assistant/tools/seo-tools.js +152 -0
  101. package/dist/assistant/tools/seo-tools.js.map +1 -0
  102. package/dist/assistant/tools/support.d.ts +35 -0
  103. package/dist/assistant/tools/support.d.ts.map +1 -0
  104. package/dist/assistant/tools/support.js +63 -0
  105. package/dist/assistant/tools/support.js.map +1 -0
  106. package/dist/assistant/untrusted.d.ts +15 -0
  107. package/dist/assistant/untrusted.d.ts.map +1 -0
  108. package/dist/assistant/untrusted.js +27 -0
  109. package/dist/assistant/untrusted.js.map +1 -0
  110. package/dist/assistant/write-policy.d.ts +20 -0
  111. package/dist/assistant/write-policy.d.ts.map +1 -0
  112. package/dist/assistant/write-policy.js +32 -0
  113. package/dist/assistant/write-policy.js.map +1 -0
  114. package/dist/auth-tokens.d.ts +31 -0
  115. package/dist/auth-tokens.d.ts.map +1 -0
  116. package/dist/auth-tokens.js +35 -0
  117. package/dist/auth-tokens.js.map +1 -0
  118. package/dist/content-change.d.ts +16 -0
  119. package/dist/content-change.d.ts.map +1 -0
  120. package/dist/content-change.js +34 -0
  121. package/dist/content-change.js.map +1 -0
  122. package/dist/content-locks.d.ts +27 -0
  123. package/dist/content-locks.d.ts.map +1 -0
  124. package/dist/content-locks.js +40 -0
  125. package/dist/content-locks.js.map +1 -0
  126. package/dist/cookies.d.ts +19 -0
  127. package/dist/cookies.d.ts.map +1 -0
  128. package/dist/cookies.js +52 -0
  129. package/dist/cookies.js.map +1 -0
  130. package/dist/create-api-handlers.d.ts +128 -0
  131. package/dist/create-api-handlers.d.ts.map +1 -0
  132. package/dist/create-api-handlers.js +384 -0
  133. package/dist/create-api-handlers.js.map +1 -0
  134. package/dist/document-actions.d.ts +25 -0
  135. package/dist/document-actions.d.ts.map +1 -0
  136. package/dist/document-actions.js +157 -0
  137. package/dist/document-actions.js.map +1 -0
  138. package/dist/document-seo.d.ts +15 -0
  139. package/dist/document-seo.d.ts.map +1 -0
  140. package/dist/document-seo.js +41 -0
  141. package/dist/document-seo.js.map +1 -0
  142. package/dist/group-by-collection.d.ts +6 -0
  143. package/dist/group-by-collection.d.ts.map +1 -0
  144. package/dist/group-by-collection.js +11 -0
  145. package/dist/group-by-collection.js.map +1 -0
  146. package/dist/handlers/apply-metadata-defaults.d.ts +4 -0
  147. package/dist/handlers/apply-metadata-defaults.d.ts.map +1 -0
  148. package/dist/handlers/apply-metadata-defaults.js +108 -0
  149. package/dist/handlers/apply-metadata-defaults.js.map +1 -0
  150. package/dist/handlers/auth-callback.d.ts +4 -0
  151. package/dist/handlers/auth-callback.d.ts.map +1 -0
  152. package/dist/handlers/auth-callback.js +217 -0
  153. package/dist/handlers/auth-callback.js.map +1 -0
  154. package/dist/handlers/auth-capabilities.d.ts +4 -0
  155. package/dist/handlers/auth-capabilities.d.ts.map +1 -0
  156. package/dist/handlers/auth-capabilities.js +19 -0
  157. package/dist/handlers/auth-capabilities.js.map +1 -0
  158. package/dist/handlers/auth-login.d.ts +4 -0
  159. package/dist/handlers/auth-login.d.ts.map +1 -0
  160. package/dist/handlers/auth-login.js +60 -0
  161. package/dist/handlers/auth-login.js.map +1 -0
  162. package/dist/handlers/auth-logout.d.ts +4 -0
  163. package/dist/handlers/auth-logout.d.ts.map +1 -0
  164. package/dist/handlers/auth-logout.js +40 -0
  165. package/dist/handlers/auth-logout.js.map +1 -0
  166. package/dist/handlers/auth-me.d.ts +4 -0
  167. package/dist/handlers/auth-me.d.ts.map +1 -0
  168. package/dist/handlers/auth-me.js +54 -0
  169. package/dist/handlers/auth-me.js.map +1 -0
  170. package/dist/handlers/auth-oidc-login.d.ts +4 -0
  171. package/dist/handlers/auth-oidc-login.d.ts.map +1 -0
  172. package/dist/handlers/auth-oidc-login.js +51 -0
  173. package/dist/handlers/auth-oidc-login.js.map +1 -0
  174. package/dist/handlers/auth-refresh.d.ts +15 -0
  175. package/dist/handlers/auth-refresh.d.ts.map +1 -0
  176. package/dist/handlers/auth-refresh.js +82 -0
  177. package/dist/handlers/auth-refresh.js.map +1 -0
  178. package/dist/handlers/bulk-delete.d.ts +8 -0
  179. package/dist/handlers/bulk-delete.d.ts.map +1 -0
  180. package/dist/handlers/bulk-delete.js +72 -0
  181. package/dist/handlers/bulk-delete.js.map +1 -0
  182. package/dist/handlers/bulk-publish.d.ts +8 -0
  183. package/dist/handlers/bulk-publish.d.ts.map +1 -0
  184. package/dist/handlers/bulk-publish.js +48 -0
  185. package/dist/handlers/bulk-publish.js.map +1 -0
  186. package/dist/handlers/capabilities.d.ts +4 -0
  187. package/dist/handlers/capabilities.d.ts.map +1 -0
  188. package/dist/handlers/capabilities.js +44 -0
  189. package/dist/handlers/capabilities.js.map +1 -0
  190. package/dist/handlers/content-changes.d.ts +28 -0
  191. package/dist/handlers/content-changes.d.ts.map +1 -0
  192. package/dist/handlers/content-changes.js +160 -0
  193. package/dist/handlers/content-changes.js.map +1 -0
  194. package/dist/handlers/content-lock.d.ts +13 -0
  195. package/dist/handlers/content-lock.d.ts.map +1 -0
  196. package/dist/handlers/content-lock.js +109 -0
  197. package/dist/handlers/content-lock.js.map +1 -0
  198. package/dist/handlers/content-tree.d.ts +11 -0
  199. package/dist/handlers/content-tree.d.ts.map +1 -0
  200. package/dist/handlers/content-tree.js +28 -0
  201. package/dist/handlers/content-tree.js.map +1 -0
  202. package/dist/handlers/create-content.d.ts +4 -0
  203. package/dist/handlers/create-content.d.ts.map +1 -0
  204. package/dist/handlers/create-content.js +49 -0
  205. package/dist/handlers/create-content.js.map +1 -0
  206. package/dist/handlers/delete-content.d.ts +4 -0
  207. package/dist/handlers/delete-content.d.ts.map +1 -0
  208. package/dist/handlers/delete-content.js +17 -0
  209. package/dist/handlers/delete-content.js.map +1 -0
  210. package/dist/handlers/delete-runtime-field.d.ts +4 -0
  211. package/dist/handlers/delete-runtime-field.d.ts.map +1 -0
  212. package/dist/handlers/delete-runtime-field.js +43 -0
  213. package/dist/handlers/delete-runtime-field.js.map +1 -0
  214. package/dist/handlers/export-bundle.d.ts +13 -0
  215. package/dist/handlers/export-bundle.d.ts.map +1 -0
  216. package/dist/handlers/export-bundle.js +99 -0
  217. package/dist/handlers/export-bundle.js.map +1 -0
  218. package/dist/handlers/export-content.d.ts +7 -0
  219. package/dist/handlers/export-content.d.ts.map +1 -0
  220. package/dist/handlers/export-content.js +69 -0
  221. package/dist/handlers/export-content.js.map +1 -0
  222. package/dist/handlers/export-schema.d.ts +4 -0
  223. package/dist/handlers/export-schema.d.ts.map +1 -0
  224. package/dist/handlers/export-schema.js +13 -0
  225. package/dist/handlers/export-schema.js.map +1 -0
  226. package/dist/handlers/get-content.d.ts +4 -0
  227. package/dist/handlers/get-content.d.ts.map +1 -0
  228. package/dist/handlers/get-content.js +65 -0
  229. package/dist/handlers/get-content.js.map +1 -0
  230. package/dist/handlers/get-runtime-schema.d.ts +4 -0
  231. package/dist/handlers/get-runtime-schema.d.ts.map +1 -0
  232. package/dist/handlers/get-runtime-schema.js +17 -0
  233. package/dist/handlers/get-runtime-schema.js.map +1 -0
  234. package/dist/handlers/get-schema.d.ts +4 -0
  235. package/dist/handlers/get-schema.d.ts.map +1 -0
  236. package/dist/handlers/get-schema.js +87 -0
  237. package/dist/handlers/get-schema.js.map +1 -0
  238. package/dist/handlers/get-version.d.ts +4 -0
  239. package/dist/handlers/get-version.d.ts.map +1 -0
  240. package/dist/handlers/get-version.js +26 -0
  241. package/dist/handlers/get-version.js.map +1 -0
  242. package/dist/handlers/import-bundle.d.ts +4 -0
  243. package/dist/handlers/import-bundle.d.ts.map +1 -0
  244. package/dist/handlers/import-bundle.js +55 -0
  245. package/dist/handlers/import-bundle.js.map +1 -0
  246. package/dist/handlers/import-content.d.ts +4 -0
  247. package/dist/handlers/import-content.d.ts.map +1 -0
  248. package/dist/handlers/import-content.js +152 -0
  249. package/dist/handlers/import-content.js.map +1 -0
  250. package/dist/handlers/index.d.ts +87 -0
  251. package/dist/handlers/index.d.ts.map +1 -0
  252. package/dist/handlers/index.js +87 -0
  253. package/dist/handlers/index.js.map +1 -0
  254. package/dist/handlers/list-collection.d.ts +8 -0
  255. package/dist/handlers/list-collection.d.ts.map +1 -0
  256. package/dist/handlers/list-collection.js +14 -0
  257. package/dist/handlers/list-collection.js.map +1 -0
  258. package/dist/handlers/list-collections.d.ts +4 -0
  259. package/dist/handlers/list-collections.d.ts.map +1 -0
  260. package/dist/handlers/list-collections.js +17 -0
  261. package/dist/handlers/list-collections.js.map +1 -0
  262. package/dist/handlers/list-content.d.ts +8 -0
  263. package/dist/handlers/list-content.d.ts.map +1 -0
  264. package/dist/handlers/list-content.js +22 -0
  265. package/dist/handlers/list-content.js.map +1 -0
  266. package/dist/handlers/list-query.d.ts +7 -0
  267. package/dist/handlers/list-query.d.ts.map +1 -0
  268. package/dist/handlers/list-query.js +36 -0
  269. package/dist/handlers/list-query.js.map +1 -0
  270. package/dist/handlers/list-versions.d.ts +4 -0
  271. package/dist/handlers/list-versions.d.ts.map +1 -0
  272. package/dist/handlers/list-versions.js +19 -0
  273. package/dist/handlers/list-versions.js.map +1 -0
  274. package/dist/handlers/llm-credential.d.ts +46 -0
  275. package/dist/handlers/llm-credential.d.ts.map +1 -0
  276. package/dist/handlers/llm-credential.js +68 -0
  277. package/dist/handlers/llm-credential.js.map +1 -0
  278. package/dist/handlers/llm-resolve.d.ts +45 -0
  279. package/dist/handlers/llm-resolve.d.ts.map +1 -0
  280. package/dist/handlers/llm-resolve.js +126 -0
  281. package/dist/handlers/llm-resolve.js.map +1 -0
  282. package/dist/handlers/llm-settings.d.ts +19 -0
  283. package/dist/handlers/llm-settings.d.ts.map +1 -0
  284. package/dist/handlers/llm-settings.js +209 -0
  285. package/dist/handlers/llm-settings.js.map +1 -0
  286. package/dist/handlers/media-bulk-delete.d.ts +4 -0
  287. package/dist/handlers/media-bulk-delete.d.ts.map +1 -0
  288. package/dist/handlers/media-bulk-delete.js +19 -0
  289. package/dist/handlers/media-bulk-delete.js.map +1 -0
  290. package/dist/handlers/media-bulk-update.d.ts +4 -0
  291. package/dist/handlers/media-bulk-update.d.ts.map +1 -0
  292. package/dist/handlers/media-bulk-update.js +25 -0
  293. package/dist/handlers/media-bulk-update.js.map +1 -0
  294. package/dist/handlers/media-delete.d.ts +4 -0
  295. package/dist/handlers/media-delete.d.ts.map +1 -0
  296. package/dist/handlers/media-delete.js +27 -0
  297. package/dist/handlers/media-delete.js.map +1 -0
  298. package/dist/handlers/media-duplicate.d.ts +4 -0
  299. package/dist/handlers/media-duplicate.d.ts.map +1 -0
  300. package/dist/handlers/media-duplicate.js +20 -0
  301. package/dist/handlers/media-duplicate.js.map +1 -0
  302. package/dist/handlers/media-folders.d.ts +12 -0
  303. package/dist/handlers/media-folders.d.ts.map +1 -0
  304. package/dist/handlers/media-folders.js +119 -0
  305. package/dist/handlers/media-folders.js.map +1 -0
  306. package/dist/handlers/media-get.d.ts +4 -0
  307. package/dist/handlers/media-get.d.ts.map +1 -0
  308. package/dist/handlers/media-get.js +16 -0
  309. package/dist/handlers/media-get.js.map +1 -0
  310. package/dist/handlers/media-image-info.d.ts +4 -0
  311. package/dist/handlers/media-image-info.d.ts.map +1 -0
  312. package/dist/handlers/media-image-info.js +32 -0
  313. package/dist/handlers/media-image-info.js.map +1 -0
  314. package/dist/handlers/media-image.d.ts +11 -0
  315. package/dist/handlers/media-image.d.ts.map +1 -0
  316. package/dist/handlers/media-image.js +116 -0
  317. package/dist/handlers/media-image.js.map +1 -0
  318. package/dist/handlers/media-info.d.ts +4 -0
  319. package/dist/handlers/media-info.d.ts.map +1 -0
  320. package/dist/handlers/media-info.js +18 -0
  321. package/dist/handlers/media-info.js.map +1 -0
  322. package/dist/handlers/media-list.d.ts +4 -0
  323. package/dist/handlers/media-list.d.ts.map +1 -0
  324. package/dist/handlers/media-list.js +14 -0
  325. package/dist/handlers/media-list.js.map +1 -0
  326. package/dist/handlers/media-register.d.ts +4 -0
  327. package/dist/handlers/media-register.d.ts.map +1 -0
  328. package/dist/handlers/media-register.js +57 -0
  329. package/dist/handlers/media-register.js.map +1 -0
  330. package/dist/handlers/media-replace.d.ts +9 -0
  331. package/dist/handlers/media-replace.d.ts.map +1 -0
  332. package/dist/handlers/media-replace.js +53 -0
  333. package/dist/handlers/media-replace.js.map +1 -0
  334. package/dist/handlers/media-tags.d.ts +4 -0
  335. package/dist/handlers/media-tags.d.ts.map +1 -0
  336. package/dist/handlers/media-tags.js +9 -0
  337. package/dist/handlers/media-tags.js.map +1 -0
  338. package/dist/handlers/media-update.d.ts +4 -0
  339. package/dist/handlers/media-update.d.ts.map +1 -0
  340. package/dist/handlers/media-update.js +64 -0
  341. package/dist/handlers/media-update.js.map +1 -0
  342. package/dist/handlers/media-upload.d.ts +4 -0
  343. package/dist/handlers/media-upload.d.ts.map +1 -0
  344. package/dist/handlers/media-upload.js +26 -0
  345. package/dist/handlers/media-upload.js.map +1 -0
  346. package/dist/handlers/media-usage.d.ts +9 -0
  347. package/dist/handlers/media-usage.d.ts.map +1 -0
  348. package/dist/handlers/media-usage.js +36 -0
  349. package/dist/handlers/media-usage.js.map +1 -0
  350. package/dist/handlers/migration-conflicts.d.ts +13 -0
  351. package/dist/handlers/migration-conflicts.d.ts.map +1 -0
  352. package/dist/handlers/migration-conflicts.js +55 -0
  353. package/dist/handlers/migration-conflicts.js.map +1 -0
  354. package/dist/handlers/migration-status.d.ts +4 -0
  355. package/dist/handlers/migration-status.d.ts.map +1 -0
  356. package/dist/handlers/migration-status.js +34 -0
  357. package/dist/handlers/migration-status.js.map +1 -0
  358. package/dist/handlers/publish-content.d.ts +9 -0
  359. package/dist/handlers/publish-content.d.ts.map +1 -0
  360. package/dist/handlers/publish-content.js +47 -0
  361. package/dist/handlers/publish-content.js.map +1 -0
  362. package/dist/handlers/publish-impact.d.ts +11 -0
  363. package/dist/handlers/publish-impact.d.ts.map +1 -0
  364. package/dist/handlers/publish-impact.js +44 -0
  365. package/dist/handlers/publish-impact.js.map +1 -0
  366. package/dist/handlers/resolve-page.d.ts +9 -0
  367. package/dist/handlers/resolve-page.d.ts.map +1 -0
  368. package/dist/handlers/resolve-page.js +105 -0
  369. package/dist/handlers/resolve-page.js.map +1 -0
  370. package/dist/handlers/restore-version.d.ts +4 -0
  371. package/dist/handlers/restore-version.d.ts.map +1 -0
  372. package/dist/handlers/restore-version.js +69 -0
  373. package/dist/handlers/restore-version.js.map +1 -0
  374. package/dist/handlers/runtime-metadata.d.ts +6 -0
  375. package/dist/handlers/runtime-metadata.d.ts.map +1 -0
  376. package/dist/handlers/runtime-metadata.js +82 -0
  377. package/dist/handlers/runtime-metadata.js.map +1 -0
  378. package/dist/handlers/save-runtime-field.d.ts +4 -0
  379. package/dist/handlers/save-runtime-field.d.ts.map +1 -0
  380. package/dist/handlers/save-runtime-field.js +108 -0
  381. package/dist/handlers/save-runtime-field.js.map +1 -0
  382. package/dist/handlers/search-content.d.ts +9 -0
  383. package/dist/handlers/search-content.d.ts.map +1 -0
  384. package/dist/handlers/search-content.js +40 -0
  385. package/dist/handlers/search-content.js.map +1 -0
  386. package/dist/handlers/seo-config.d.ts +16 -0
  387. package/dist/handlers/seo-config.d.ts.map +1 -0
  388. package/dist/handlers/seo-config.js +250 -0
  389. package/dist/handlers/seo-config.js.map +1 -0
  390. package/dist/handlers/seo-document.d.ts +24 -0
  391. package/dist/handlers/seo-document.d.ts.map +1 -0
  392. package/dist/handlers/seo-document.js +119 -0
  393. package/dist/handlers/seo-document.js.map +1 -0
  394. package/dist/handlers/seo-enrich-archetype.d.ts +71 -0
  395. package/dist/handlers/seo-enrich-archetype.d.ts.map +1 -0
  396. package/dist/handlers/seo-enrich-archetype.js +250 -0
  397. package/dist/handlers/seo-enrich-archetype.js.map +1 -0
  398. package/dist/handlers/seo-enrich-meta.d.ts +40 -0
  399. package/dist/handlers/seo-enrich-meta.d.ts.map +1 -0
  400. package/dist/handlers/seo-enrich-meta.js +121 -0
  401. package/dist/handlers/seo-enrich-meta.js.map +1 -0
  402. package/dist/handlers/seo-enrich-runner.d.ts +65 -0
  403. package/dist/handlers/seo-enrich-runner.d.ts.map +1 -0
  404. package/dist/handlers/seo-enrich-runner.js +192 -0
  405. package/dist/handlers/seo-enrich-runner.js.map +1 -0
  406. package/dist/handlers/seo-enrich.d.ts +10 -0
  407. package/dist/handlers/seo-enrich.d.ts.map +1 -0
  408. package/dist/handlers/seo-enrich.js +166 -0
  409. package/dist/handlers/seo-enrich.js.map +1 -0
  410. package/dist/handlers/seo-generate.d.ts +4 -0
  411. package/dist/handlers/seo-generate.d.ts.map +1 -0
  412. package/dist/handlers/seo-generate.js +31 -0
  413. package/dist/handlers/seo-generate.js.map +1 -0
  414. package/dist/handlers/seo-impact.d.ts +36 -0
  415. package/dist/handlers/seo-impact.d.ts.map +1 -0
  416. package/dist/handlers/seo-impact.js +137 -0
  417. package/dist/handlers/seo-impact.js.map +1 -0
  418. package/dist/handlers/seo-indexnow.d.ts +11 -0
  419. package/dist/handlers/seo-indexnow.d.ts.map +1 -0
  420. package/dist/handlers/seo-indexnow.js +15 -0
  421. package/dist/handlers/seo-indexnow.js.map +1 -0
  422. package/dist/handlers/seo-llms-txt.d.ts +26 -0
  423. package/dist/handlers/seo-llms-txt.d.ts.map +1 -0
  424. package/dist/handlers/seo-llms-txt.js +99 -0
  425. package/dist/handlers/seo-llms-txt.js.map +1 -0
  426. package/dist/handlers/seo-preview.d.ts +8 -0
  427. package/dist/handlers/seo-preview.d.ts.map +1 -0
  428. package/dist/handlers/seo-preview.js +49 -0
  429. package/dist/handlers/seo-preview.js.map +1 -0
  430. package/dist/handlers/seo-robots.d.ts +22 -0
  431. package/dist/handlers/seo-robots.d.ts.map +1 -0
  432. package/dist/handlers/seo-robots.js +48 -0
  433. package/dist/handlers/seo-robots.js.map +1 -0
  434. package/dist/handlers/seo-sitemap.d.ts +68 -0
  435. package/dist/handlers/seo-sitemap.d.ts.map +1 -0
  436. package/dist/handlers/seo-sitemap.js +178 -0
  437. package/dist/handlers/seo-sitemap.js.map +1 -0
  438. package/dist/handlers/seo-status.d.ts +4 -0
  439. package/dist/handlers/seo-status.d.ts.map +1 -0
  440. package/dist/handlers/seo-status.js +61 -0
  441. package/dist/handlers/seo-status.js.map +1 -0
  442. package/dist/handlers/seo-structured-data.d.ts +4 -0
  443. package/dist/handlers/seo-structured-data.d.ts.map +1 -0
  444. package/dist/handlers/seo-structured-data.js +18 -0
  445. package/dist/handlers/seo-structured-data.js.map +1 -0
  446. package/dist/handlers/site-config.d.ts +8 -0
  447. package/dist/handlers/site-config.d.ts.map +1 -0
  448. package/dist/handlers/site-config.js +26 -0
  449. package/dist/handlers/site-config.js.map +1 -0
  450. package/dist/handlers/site-preview.d.ts +10 -0
  451. package/dist/handlers/site-preview.d.ts.map +1 -0
  452. package/dist/handlers/site-preview.js +54 -0
  453. package/dist/handlers/site-preview.js.map +1 -0
  454. package/dist/handlers/site-settings.d.ts +17 -0
  455. package/dist/handlers/site-settings.d.ts.map +1 -0
  456. package/dist/handlers/site-settings.js +75 -0
  457. package/dist/handlers/site-settings.js.map +1 -0
  458. package/dist/handlers/snapshot-create.d.ts +4 -0
  459. package/dist/handlers/snapshot-create.d.ts.map +1 -0
  460. package/dist/handlers/snapshot-create.js +15 -0
  461. package/dist/handlers/snapshot-create.js.map +1 -0
  462. package/dist/handlers/snapshot-delete.d.ts +4 -0
  463. package/dist/handlers/snapshot-delete.d.ts.map +1 -0
  464. package/dist/handlers/snapshot-delete.js +21 -0
  465. package/dist/handlers/snapshot-delete.js.map +1 -0
  466. package/dist/handlers/snapshot-get.d.ts +4 -0
  467. package/dist/handlers/snapshot-get.d.ts.map +1 -0
  468. package/dist/handlers/snapshot-get.js +17 -0
  469. package/dist/handlers/snapshot-get.js.map +1 -0
  470. package/dist/handlers/snapshot-list.d.ts +4 -0
  471. package/dist/handlers/snapshot-list.d.ts.map +1 -0
  472. package/dist/handlers/snapshot-list.js +9 -0
  473. package/dist/handlers/snapshot-list.js.map +1 -0
  474. package/dist/handlers/snapshot-restore.d.ts +4 -0
  475. package/dist/handlers/snapshot-restore.d.ts.map +1 -0
  476. package/dist/handlers/snapshot-restore.js +27 -0
  477. package/dist/handlers/snapshot-restore.js.map +1 -0
  478. package/dist/handlers/translation-status.d.ts +9 -0
  479. package/dist/handlers/translation-status.d.ts.map +1 -0
  480. package/dist/handlers/translation-status.js +68 -0
  481. package/dist/handlers/translation-status.js.map +1 -0
  482. package/dist/handlers/update-content.d.ts +4 -0
  483. package/dist/handlers/update-content.d.ts.map +1 -0
  484. package/dist/handlers/update-content.js +66 -0
  485. package/dist/handlers/update-content.js.map +1 -0
  486. package/dist/handlers/user-create.d.ts +4 -0
  487. package/dist/handlers/user-create.d.ts.map +1 -0
  488. package/dist/handlers/user-create.js +38 -0
  489. package/dist/handlers/user-create.js.map +1 -0
  490. package/dist/handlers/user-delete.d.ts +4 -0
  491. package/dist/handlers/user-delete.d.ts.map +1 -0
  492. package/dist/handlers/user-delete.js +25 -0
  493. package/dist/handlers/user-delete.js.map +1 -0
  494. package/dist/handlers/user-get.d.ts +4 -0
  495. package/dist/handlers/user-get.d.ts.map +1 -0
  496. package/dist/handlers/user-get.js +22 -0
  497. package/dist/handlers/user-get.js.map +1 -0
  498. package/dist/handlers/user-list.d.ts +4 -0
  499. package/dist/handlers/user-list.d.ts.map +1 -0
  500. package/dist/handlers/user-list.js +28 -0
  501. package/dist/handlers/user-list.js.map +1 -0
  502. package/dist/handlers/user-permissions.d.ts +6 -0
  503. package/dist/handlers/user-permissions.d.ts.map +1 -0
  504. package/dist/handlers/user-permissions.js +42 -0
  505. package/dist/handlers/user-permissions.js.map +1 -0
  506. package/dist/handlers/user-update.d.ts +4 -0
  507. package/dist/handlers/user-update.d.ts.map +1 -0
  508. package/dist/handlers/user-update.js +54 -0
  509. package/dist/handlers/user-update.js.map +1 -0
  510. package/dist/handlers/validate-all.d.ts +4 -0
  511. package/dist/handlers/validate-all.d.ts.map +1 -0
  512. package/dist/handlers/validate-all.js +14 -0
  513. package/dist/handlers/validate-all.js.map +1 -0
  514. package/dist/handlers/version-retention.d.ts +6 -0
  515. package/dist/handlers/version-retention.d.ts.map +1 -0
  516. package/dist/handlers/version-retention.js +40 -0
  517. package/dist/handlers/version-retention.js.map +1 -0
  518. package/dist/handlers/webhook-deliveries.d.ts +4 -0
  519. package/dist/handlers/webhook-deliveries.d.ts.map +1 -0
  520. package/dist/handlers/webhook-deliveries.js +24 -0
  521. package/dist/handlers/webhook-deliveries.js.map +1 -0
  522. package/dist/handlers/webhook-retry.d.ts +11 -0
  523. package/dist/handlers/webhook-retry.d.ts.map +1 -0
  524. package/dist/handlers/webhook-retry.js +69 -0
  525. package/dist/handlers/webhook-retry.js.map +1 -0
  526. package/dist/head.d.ts +9 -0
  527. package/dist/head.d.ts.map +1 -0
  528. package/dist/head.js +28 -0
  529. package/dist/head.js.map +1 -0
  530. package/dist/hooks.d.ts +34 -0
  531. package/dist/hooks.d.ts.map +1 -0
  532. package/dist/hooks.js +19 -0
  533. package/dist/hooks.js.map +1 -0
  534. package/dist/image-cache.d.ts +47 -0
  535. package/dist/image-cache.d.ts.map +1 -0
  536. package/dist/image-cache.js +112 -0
  537. package/dist/image-cache.js.map +1 -0
  538. package/dist/image-dimensions.d.ts +12 -0
  539. package/dist/image-dimensions.d.ts.map +1 -0
  540. package/dist/image-dimensions.js +129 -0
  541. package/dist/image-dimensions.js.map +1 -0
  542. package/dist/image-optimizer.d.ts +86 -0
  543. package/dist/image-optimizer.d.ts.map +1 -0
  544. package/dist/image-optimizer.js +206 -0
  545. package/dist/image-optimizer.js.map +1 -0
  546. package/dist/image-presets.d.ts +17 -0
  547. package/dist/image-presets.d.ts.map +1 -0
  548. package/dist/image-presets.js +50 -0
  549. package/dist/image-presets.js.map +1 -0
  550. package/dist/image-url.d.ts +26 -0
  551. package/dist/image-url.d.ts.map +1 -0
  552. package/dist/image-url.js +47 -0
  553. package/dist/image-url.js.map +1 -0
  554. package/dist/index.d.ts +37 -0
  555. package/dist/index.d.ts.map +1 -0
  556. package/dist/index.js +23 -0
  557. package/dist/index.js.map +1 -0
  558. package/dist/jwt.d.ts +54 -0
  559. package/dist/jwt.d.ts.map +1 -0
  560. package/dist/jwt.js +114 -0
  561. package/dist/jwt.js.map +1 -0
  562. package/dist/locale-fallback.d.ts +18 -0
  563. package/dist/locale-fallback.d.ts.map +1 -0
  564. package/dist/locale-fallback.js +42 -0
  565. package/dist/locale-fallback.js.map +1 -0
  566. package/dist/media-library.d.ts +46 -0
  567. package/dist/media-library.d.ts.map +1 -0
  568. package/dist/media-library.js +231 -0
  569. package/dist/media-library.js.map +1 -0
  570. package/dist/media-reference-updater.d.ts +24 -0
  571. package/dist/media-reference-updater.d.ts.map +1 -0
  572. package/dist/media-reference-updater.js +124 -0
  573. package/dist/media-reference-updater.js.map +1 -0
  574. package/dist/media-references.d.ts +14 -0
  575. package/dist/media-references.d.ts.map +1 -0
  576. package/dist/media-references.js +25 -0
  577. package/dist/media-references.js.map +1 -0
  578. package/dist/merged-schema.d.ts +10 -0
  579. package/dist/merged-schema.d.ts.map +1 -0
  580. package/dist/merged-schema.js +21 -0
  581. package/dist/merged-schema.js.map +1 -0
  582. package/dist/middleware/auth.d.ts +21 -0
  583. package/dist/middleware/auth.d.ts.map +1 -0
  584. package/dist/middleware/auth.js +82 -0
  585. package/dist/middleware/auth.js.map +1 -0
  586. package/dist/oidc-state.d.ts +42 -0
  587. package/dist/oidc-state.d.ts.map +1 -0
  588. package/dist/oidc-state.js +72 -0
  589. package/dist/oidc-state.js.map +1 -0
  590. package/dist/oidc.d.ts +83 -0
  591. package/dist/oidc.d.ts.map +1 -0
  592. package/dist/oidc.js +226 -0
  593. package/dist/oidc.js.map +1 -0
  594. package/dist/openapi.d.ts +13 -0
  595. package/dist/openapi.d.ts.map +1 -0
  596. package/dist/openapi.js +133 -0
  597. package/dist/openapi.js.map +1 -0
  598. package/dist/permissions.d.ts +37 -0
  599. package/dist/permissions.d.ts.map +1 -0
  600. package/dist/permissions.js +69 -0
  601. package/dist/permissions.js.map +1 -0
  602. package/dist/plugins.d.ts +64 -0
  603. package/dist/plugins.d.ts.map +1 -0
  604. package/dist/plugins.js +73 -0
  605. package/dist/plugins.js.map +1 -0
  606. package/dist/preview-token.d.ts +13 -0
  607. package/dist/preview-token.d.ts.map +1 -0
  608. package/dist/preview-token.js +45 -0
  609. package/dist/preview-token.js.map +1 -0
  610. package/dist/public-cache.d.ts +8 -0
  611. package/dist/public-cache.d.ts.map +1 -0
  612. package/dist/public-cache.js +8 -0
  613. package/dist/public-cache.js.map +1 -0
  614. package/dist/reference-resolver.d.ts +21 -0
  615. package/dist/reference-resolver.d.ts.map +1 -0
  616. package/dist/reference-resolver.js +128 -0
  617. package/dist/reference-resolver.js.map +1 -0
  618. package/dist/return-to.d.ts +7 -0
  619. package/dist/return-to.d.ts.map +1 -0
  620. package/dist/return-to.js +15 -0
  621. package/dist/return-to.js.map +1 -0
  622. package/dist/router.d.ts +14 -0
  623. package/dist/router.d.ts.map +1 -0
  624. package/dist/router.js +51 -0
  625. package/dist/router.js.map +1 -0
  626. package/dist/runtime-field-checks.d.ts +11 -0
  627. package/dist/runtime-field-checks.d.ts.map +1 -0
  628. package/dist/runtime-field-checks.js +72 -0
  629. package/dist/runtime-field-checks.js.map +1 -0
  630. package/dist/save-document.d.ts +71 -0
  631. package/dist/save-document.d.ts.map +1 -0
  632. package/dist/save-document.js +213 -0
  633. package/dist/save-document.js.map +1 -0
  634. package/dist/seo-compose.d.ts +50 -0
  635. package/dist/seo-compose.d.ts.map +1 -0
  636. package/dist/seo-compose.js +104 -0
  637. package/dist/seo-compose.js.map +1 -0
  638. package/dist/seo-config-snapshot.d.ts +10 -0
  639. package/dist/seo-config-snapshot.d.ts.map +1 -0
  640. package/dist/seo-config-snapshot.js +16 -0
  641. package/dist/seo-config-snapshot.js.map +1 -0
  642. package/dist/seo-loader.d.ts +10 -0
  643. package/dist/seo-loader.d.ts.map +1 -0
  644. package/dist/seo-loader.js +14 -0
  645. package/dist/seo-loader.js.map +1 -0
  646. package/dist/seo-site-findings.d.ts +27 -0
  647. package/dist/seo-site-findings.d.ts.map +1 -0
  648. package/dist/seo-site-findings.js +87 -0
  649. package/dist/seo-site-findings.js.map +1 -0
  650. package/dist/seo-subsystem.d.ts +28 -0
  651. package/dist/seo-subsystem.d.ts.map +1 -0
  652. package/dist/seo-subsystem.js +62 -0
  653. package/dist/seo-subsystem.js.map +1 -0
  654. package/dist/seo-validation.d.ts +20 -0
  655. package/dist/seo-validation.d.ts.map +1 -0
  656. package/dist/seo-validation.js +96 -0
  657. package/dist/seo-validation.js.map +1 -0
  658. package/dist/types.d.ts +126 -0
  659. package/dist/types.d.ts.map +1 -0
  660. package/dist/types.js +6 -0
  661. package/dist/types.js.map +1 -0
  662. package/dist/validators.d.ts +107 -0
  663. package/dist/validators.d.ts.map +1 -0
  664. package/dist/validators.js +199 -0
  665. package/dist/validators.js.map +1 -0
  666. package/dist/webhooks.d.ts +29 -0
  667. package/dist/webhooks.d.ts.map +1 -0
  668. package/dist/webhooks.js +123 -0
  669. package/dist/webhooks.js.map +1 -0
  670. package/dist/workload-identity.d.ts +23 -0
  671. package/dist/workload-identity.d.ts.map +1 -0
  672. package/dist/workload-identity.js +145 -0
  673. package/dist/workload-identity.js.map +1 -0
  674. package/package.json +50 -3
  675. package/README.md +0 -3
@@ -0,0 +1,96 @@
1
+ import { canQuery } from '@krantho/persistence';
2
+ import { z } from 'zod';
3
+ import { getMergedSchema } from '../../merged-schema.js';
4
+ /** Whether the schema declares `key` as a string field */
5
+ export function declaresString(schema, key) {
6
+ const field = schema.shape[key];
7
+ if (!field)
8
+ return false;
9
+ try {
10
+ return z.toJSONSchema(field, { unrepresentable: 'any' })['type'] === 'string';
11
+ }
12
+ catch {
13
+ return false;
14
+ }
15
+ }
16
+ const SLUG_MAX = 60;
17
+ /** The question as a slug: lowercased, accents removed, runs of other characters as `-` */
18
+ export function questionSlug(question) {
19
+ const slug = question
20
+ .toLowerCase()
21
+ .normalize('NFKD')
22
+ .replace(/[̀-ͯ]/g, '')
23
+ .replace(/[^a-z0-9]+/g, '-')
24
+ .replace(/^-+|-+$/g, '')
25
+ .slice(0, SLUG_MAX)
26
+ .replace(/-+$/, '');
27
+ return slug || 'question';
28
+ }
29
+ /** A slug not in `taken`: the base, else the base with `-2`, `-3`, … */
30
+ function uniqueSlug(base, taken) {
31
+ let slug = base;
32
+ for (let n = 2; taken.has(slug); n++)
33
+ slug = `${base}-${n}`;
34
+ taken.add(slug);
35
+ return slug;
36
+ }
37
+ /** The slugs the target collection already uses in this locale */
38
+ async function takenSlugs(ctx, collection, locale) {
39
+ if (!canQuery(ctx.adapter))
40
+ return new Set();
41
+ const page = await ctx.adapter.query({
42
+ state: 'current',
43
+ collections: [collection],
44
+ projection: 'meta',
45
+ locale,
46
+ });
47
+ return new Set(page.items.map((meta) => meta.slug));
48
+ }
49
+ /** The fields and body of one entry in a collection with these declared fields */
50
+ function candidateFor(schema, entry) {
51
+ const hasAnswer = declaresString(schema, 'answer');
52
+ const fields = { question: entry.question };
53
+ if (hasAnswer)
54
+ fields['answer'] = entry.answer;
55
+ if (declaresString(schema, 'title'))
56
+ fields['title'] = entry.question;
57
+ if ('status' in schema.shape)
58
+ fields['status'] = 'draft';
59
+ return { fields, body: hasAnswer ? '' : entry.answer };
60
+ }
61
+ /**
62
+ * Whether FAQ entries fit a collection: it must declare `question` as a string,
63
+ * and each entry's fields must pass its schema. The answer goes to an `answer`
64
+ * field when declared, else to the body; `title` is the question. Each entry
65
+ * gets a slug unique in the collection and in the batch.
66
+ */
67
+ export async function faqFit(ctx, collection, entries, locale) {
68
+ const collectionDef = ctx.contentConfig.collections.get(collection);
69
+ if (!collectionDef)
70
+ return { ok: false, reason: `Collection "${collection}" not found` };
71
+ const schema = await getMergedSchema(collectionDef, ctx.adapter);
72
+ if (!declaresString(schema, 'question')) {
73
+ return { ok: false, reason: `The ${collection} collection has no question field` };
74
+ }
75
+ const candidates = entries.map((entry) => candidateFor(schema, entry));
76
+ const failing = new Set();
77
+ for (const candidate of candidates) {
78
+ const parsed = schema.safeParse(candidate.fields);
79
+ if (!parsed.success)
80
+ for (const issue of parsed.error.issues)
81
+ failing.add(issue.path.join('.'));
82
+ }
83
+ if (failing.size > 0) {
84
+ const fields = [...failing].join(', ');
85
+ return { ok: false, reason: `Entries do not fit ${collection}; it needs: ${fields}` };
86
+ }
87
+ const taken = await takenSlugs(ctx, collection, locale);
88
+ return {
89
+ ok: true,
90
+ candidates: candidates.map((candidate, i) => ({
91
+ ...candidate,
92
+ slug: uniqueSlug(questionSlug(entries[i]?.question ?? ''), taken),
93
+ })),
94
+ };
95
+ }
96
+ //# sourceMappingURL=faq-fit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"faq-fit.js","sourceRoot":"","sources":["../../../src/assistant/tools/faq-fit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import { type ContentDocument } from '@krantho/persistence';
2
+ import { type AssistantTool, type ToolRunContext } from './define-tool.js';
3
+ /**
4
+ * A document as the model reads it: every document string framed, no
5
+ * `changedBy`, and the body cut to what fits in one tool result.
6
+ */
7
+ export declare function documentView(run: ToolRunContext, doc: ContentDocument): {
8
+ result: Record<string, unknown>;
9
+ bodyTruncated: boolean;
10
+ };
11
+ /** Tools that read content */
12
+ export declare const READ_TOOLS: readonly AssistantTool[];
13
+ //# sourceMappingURL=read-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read-tools.d.ts","sourceRoot":"","sources":["../../../src/assistant/tools/read-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAA2B,MAAM,sBAAsB,CAAA;AAUpF,OAAO,EAAE,KAAK,aAAa,EAAc,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAgMtF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,eAAe,GACnB;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,aAAa,EAAE,OAAO,CAAA;CAAE,CAmB7D;AAyCD,8BAA8B;AAC9B,eAAO,MAAM,UAAU,EAAE,SAAS,aAAa,EAM9C,CAAA"}
@@ -0,0 +1,242 @@
1
+ import { canGetContent, canQuery } from '@krantho/persistence';
2
+ import { buildSeoFieldMap, resolveSeoField } from '@krantho/seo-shared';
3
+ import { z } from 'zod';
4
+ import { getContent } from '../../handlers/get-content.js';
5
+ import { getSchema } from '../../handlers/get-schema.js';
6
+ import { listCollections } from '../../handlers/list-collections.js';
7
+ import { applyListLimit, parseLocaleParam, validateCollectionParam } from '../../validators.js';
8
+ import { callHandler, isSuccess, responseError } from '../call-handler.js';
9
+ import { listSections } from '../document-change.js';
10
+ import { truncate } from '../untrusted.js';
11
+ import { defineTool } from './define-tool.js';
12
+ import { failure, localeOf, pathOf, refOf } from './support.js';
13
+ const always = () => true;
14
+ function summarize(doc) {
15
+ const { collection, slug, locale, version, status } = doc.meta;
16
+ const title = resolveSeoField(buildSeoFieldMap(Object.keys(doc.fields)), 'title', doc.fields);
17
+ return { collection, slug, locale, version, status, title };
18
+ }
19
+ /** The JSON Schema of a collection's fields (code and runtime), or the handler's error */
20
+ async function collectionSchema(run, collection) {
21
+ const response = await callHandler(getSchema, run.ctx, { params: { collection } });
22
+ if (!isSuccess(response))
23
+ return { ok: false, error: responseError(response) };
24
+ return { ok: true, schema: response.body.schema };
25
+ }
26
+ const listCollectionsTool = defineTool({
27
+ name: 'list_collections',
28
+ label: 'List collections',
29
+ description: 'List the content collections of the site and the field names of each.',
30
+ input: z.object({}),
31
+ role: 'viewer',
32
+ available: always,
33
+ describe: () => 'Listing collections',
34
+ async run(_input, run) {
35
+ const response = await callHandler(listCollections, run.ctx, {});
36
+ const names = response.body.collections;
37
+ const collections = [];
38
+ for (const { name } of names) {
39
+ const schema = await collectionSchema(run, name);
40
+ collections.push({
41
+ name,
42
+ fields: schema.ok ? Object.keys(schema.schema.properties ?? {}) : [],
43
+ });
44
+ }
45
+ return {
46
+ result: { ok: true, collections },
47
+ activity: { status: 'done', summary: 'Listed collections', documents: [] },
48
+ };
49
+ },
50
+ });
51
+ /** A JSON Schema property compacted to what the model needs to write a valid value */
52
+ function compactProperty(name, prop, required) {
53
+ const compact = {
54
+ name,
55
+ type: prop['type'] ?? 'any',
56
+ required: required.has(name),
57
+ };
58
+ for (const key of ['enum', 'maxLength', 'description']) {
59
+ if (prop[key] !== undefined)
60
+ compact[key] = prop[key];
61
+ }
62
+ if (prop['_runtime'] === true)
63
+ compact['runtime'] = true;
64
+ return compact;
65
+ }
66
+ const getSchemaTool = defineTool({
67
+ name: 'get_schema',
68
+ label: 'Read a schema',
69
+ description: "Get a collection's fields with their types, whether each is required, allowed values and length limits.",
70
+ input: z.object({ collection: z.string().min(1) }),
71
+ role: 'viewer',
72
+ available: always,
73
+ describe: (input) => `Reading the ${input.collection} schema`,
74
+ async run(input, run) {
75
+ const schema = await collectionSchema(run, input.collection);
76
+ if (!schema.ok)
77
+ return failure(schema.error);
78
+ const required = new Set(schema.schema.required ?? []);
79
+ const fields = Object.entries(schema.schema.properties ?? {}).map(([name, prop]) => compactProperty(name, prop, required));
80
+ return {
81
+ result: { ok: true, collection: input.collection, fields },
82
+ activity: { status: 'done', summary: `Read the ${input.collection} schema`, documents: [] },
83
+ };
84
+ },
85
+ });
86
+ const listDocumentsTool = defineTool({
87
+ name: 'list_documents',
88
+ label: 'List documents',
89
+ description: 'List the documents of one collection (current versions, drafts included), ordered by slug and then locale.',
90
+ input: z.object({
91
+ collection: z.string().min(1),
92
+ status: z.enum(['draft', 'published']).optional(),
93
+ limit: z.int().min(1).max(50).optional(),
94
+ offset: z.int().min(0).optional(),
95
+ locale: z.string().min(1).optional(),
96
+ }),
97
+ role: 'viewer',
98
+ available: (ctx) => canQuery(ctx.adapter),
99
+ describe: (input) => `Listing ${input.collection}`,
100
+ async run(input, run) {
101
+ const { adapter, config } = run.ctx;
102
+ const validated = validateCollectionParam(input.collection, run.ctx);
103
+ if (!validated.isValid)
104
+ return failure(responseError(validated.response));
105
+ if (!canQuery(adapter))
106
+ return failure('Adapter does not support query');
107
+ const page = await adapter.query({
108
+ state: 'current',
109
+ collections: [validated.collection],
110
+ projection: 'summary',
111
+ status: input.status,
112
+ locale: parseLocaleParam(input.locale),
113
+ limit: applyListLimit(input.limit ?? 20, config.content.list.maxLimit),
114
+ offset: input.offset,
115
+ });
116
+ const items = page.items.map(summarize);
117
+ return {
118
+ result: {
119
+ ok: true,
120
+ hasMore: page.hasMore,
121
+ items: run.frame(`${input.collection} list`, JSON.stringify(items)),
122
+ },
123
+ activity: { status: 'done', summary: `Listed ${input.collection}`, documents: [] },
124
+ };
125
+ },
126
+ });
127
+ const searchDocumentsTool = defineTool({
128
+ name: 'search_documents',
129
+ label: 'Search documents',
130
+ description: 'Search every collection for documents whose slug, fields or body contain the text.',
131
+ input: z.object({
132
+ query: z.string().min(1),
133
+ limit: z.int().min(1).max(20).optional(),
134
+ locale: z.string().min(1).optional(),
135
+ }),
136
+ role: 'viewer',
137
+ available: (ctx) => canQuery(ctx.adapter),
138
+ describe: (input) => `Searching for "${truncate(input.query, 40)}"`,
139
+ async run(input, run) {
140
+ const { adapter, config, contentConfig } = run.ctx;
141
+ if (!canQuery(adapter))
142
+ return failure('Adapter does not support query');
143
+ const text = input.query.trim();
144
+ const { minQueryLength } = config.content.search;
145
+ if (text.length < minQueryLength) {
146
+ return failure(`Search query must be at least ${minQueryLength} characters`);
147
+ }
148
+ const page = await adapter.query({
149
+ state: 'current',
150
+ collections: [...contentConfig.collections.keys()],
151
+ projection: 'summary',
152
+ match: { text, in: ['slug', 'fields', 'body'] },
153
+ locale: parseLocaleParam(input.locale),
154
+ limit: input.limit ?? 10,
155
+ });
156
+ const items = page.items.map((hit) => ({ ...summarize(hit), snippet: hit.snippet ?? '' }));
157
+ return {
158
+ result: {
159
+ ok: true,
160
+ hasMore: page.hasMore,
161
+ items: run.frame('search results', JSON.stringify(items)),
162
+ },
163
+ activity: {
164
+ status: 'done',
165
+ summary: `Searched for "${truncate(input.query, 40)}"`,
166
+ documents: [],
167
+ },
168
+ };
169
+ },
170
+ });
171
+ /** Room left for a frame's tags and the JSON escaping around them */
172
+ const FRAME_OVERHEAD = 200;
173
+ /**
174
+ * A document as the model reads it: every document string framed, no
175
+ * `changedBy`, and the body cut to what fits in one tool result.
176
+ */
177
+ export function documentView(run, doc) {
178
+ const { collection, slug, version, status } = doc.meta;
179
+ const source = `${pathOf(doc.meta)} v${version}`;
180
+ const result = {
181
+ ok: true,
182
+ ref: refOf(doc),
183
+ version,
184
+ status,
185
+ fields: run.frame(`${source} fields`, JSON.stringify(doc.fields)),
186
+ sections: run.frame(`${source} section headings`, JSON.stringify(listSections(doc.body))),
187
+ bodyChars: doc.body.length,
188
+ };
189
+ const used = JSON.stringify(result).length + FRAME_OVERHEAD;
190
+ const budget = Math.max(0, run.ctx.config.assistant.limits.toolResultChars - used);
191
+ const body = truncate(doc.body, budget);
192
+ const bodyTruncated = body.length < doc.body.length;
193
+ result['body'] = run.frame(`${collection}/${slug} v${version} body`, body);
194
+ result['bodyTruncated'] = bodyTruncated;
195
+ return { result, bodyTruncated };
196
+ }
197
+ const getDocumentTool = defineTool({
198
+ name: 'get_document',
199
+ label: 'Read a document',
200
+ description: "Read a document's current version (drafts included): fields, body, section headings and version. Read before changing a document.",
201
+ input: z.object({
202
+ collection: z.string().min(1),
203
+ slug: z.string().min(1),
204
+ locale: z.string().min(1).optional(),
205
+ }),
206
+ role: 'viewer',
207
+ available: (ctx) => canGetContent(ctx.adapter),
208
+ describe: (input) => `Reading ${pathOf(input)}`,
209
+ async run(input, run) {
210
+ const locale = localeOf(run.ctx, input.locale);
211
+ const response = await callHandler(getContent, run.ctx, {
212
+ params: { collection: input.collection, slug: input.slug },
213
+ query: { locale },
214
+ });
215
+ if (!isSuccess(response))
216
+ return failure(responseError(response));
217
+ const doc = response.body;
218
+ const { result } = documentView(run, doc);
219
+ if (doc.meta.locale !== locale) {
220
+ result['fallbackFrom'] = locale;
221
+ result['note'] =
222
+ `There is no ${locale} version; this is the ${doc.meta.locale} version. Writes to ${locale} cannot use it.`;
223
+ }
224
+ return {
225
+ result,
226
+ activity: {
227
+ status: 'done',
228
+ summary: `Read ${pathOf(input)} (v${doc.meta.version})`,
229
+ documents: [refOf(doc)],
230
+ },
231
+ };
232
+ },
233
+ });
234
+ /** Tools that read content */
235
+ export const READ_TOOLS = [
236
+ listCollectionsTool,
237
+ getSchemaTool,
238
+ listDocumentsTool,
239
+ searchDocumentsTool,
240
+ getDocumentTool,
241
+ ];
242
+ //# sourceMappingURL=read-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read-tools.js","sourceRoot":"","sources":["../../../src/assistant/tools/read-tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { type AssistantTool } from './define-tool.js';
2
+ /** SEO tools */
3
+ export declare const SEO_TOOLS: readonly AssistantTool[];
4
+ //# sourceMappingURL=seo-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seo-tools.d.ts","sourceRoot":"","sources":["../../../src/assistant/tools/seo-tools.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,aAAa,EAInB,MAAM,kBAAkB,CAAA;AAsKzB,gBAAgB;AAChB,eAAO,MAAM,SAAS,EAAE,SAAS,aAAa,EAI7C,CAAA"}
@@ -0,0 +1,152 @@
1
+ import { canGetContent } from '@krantho/persistence';
2
+ import { buildSeoFieldMap } from '@krantho/seo-shared';
3
+ import { z } from 'zod';
4
+ import { resolveAdapter } from '../../handlers/llm-resolve.js';
5
+ import { proposeArchetypeProperties } from '../../handlers/seo-enrich-archetype.js';
6
+ import { generateMetaDescription, prepareMetaDescription } from '../../handlers/seo-enrich-meta.js';
7
+ import { loadGetTypeProperties } from '../../handlers/seo-enrich-runner.js';
8
+ import { getMergedSchema } from '../../merged-schema.js';
9
+ import { validateDocumentSeo } from '../../seo-validation.js';
10
+ import { defineTool, } from './define-tool.js';
11
+ import { canWriteDrafts } from './draft-tools.js';
12
+ import { writeDraft } from './draft-write.js';
13
+ import { exactDocument, failure, localeOf, pathOf, proposal, refOf } from './support.js';
14
+ /** An LLM adapter whose completions count toward the chat request's token budget */
15
+ function counted(llm, run) {
16
+ return {
17
+ supportsJsonSchema: llm.supportsJsonSchema,
18
+ async complete(prompt, options) {
19
+ const result = await llm.complete(prompt, options);
20
+ run.spend(result.usage);
21
+ return result;
22
+ },
23
+ };
24
+ }
25
+ const documentInput = z.object({
26
+ collection: z.string().min(1),
27
+ slug: z.string().min(1),
28
+ locale: z.string().min(1).optional(),
29
+ });
30
+ /** Nothing to do for this document, and why */
31
+ function skipped(path, reason) {
32
+ return {
33
+ result: { ok: true, skipped: true, reason },
34
+ activity: { status: 'done', summary: `Skipped ${path}: ${reason}`, documents: [] },
35
+ };
36
+ }
37
+ const seoValidateTool = defineTool({
38
+ name: 'seo_validate',
39
+ label: 'Check SEO',
40
+ description: "Check a document's current version for SEO: title and meta description length against the site's limits, whether its structured data conforms to Schema.org, and what each reader (Google, Bing) needs for its features. Explain the findings to the user, grouped by reader.",
41
+ input: documentInput,
42
+ role: 'viewer',
43
+ available: (ctx) => canGetContent(ctx.adapter),
44
+ describe: (input) => `Checking the SEO of ${pathOf(input)}`,
45
+ async run(input, run) {
46
+ const locale = localeOf(run.ctx, input.locale);
47
+ const findings = await validateDocumentSeo(run.ctx, input.collection, input.slug, locale);
48
+ const errors = findings.filter((finding) => finding.severity === 'error').length;
49
+ const warnings = findings.filter((finding) => finding.severity === 'warning').length;
50
+ return {
51
+ result: { ok: true, findings },
52
+ activity: {
53
+ status: 'done',
54
+ summary: `Checked the SEO of ${pathOf(input)}: ${errors} errors, ${warnings} warnings`,
55
+ documents: [{ collection: input.collection, slug: input.slug, locale }],
56
+ findings,
57
+ },
58
+ };
59
+ },
60
+ });
61
+ /** The field the collection's schema keeps a document's description in */
62
+ async function descriptionField(ctx, collection) {
63
+ const collectionDef = ctx.contentConfig.collections.get(collection);
64
+ if (!collectionDef)
65
+ return null;
66
+ const schema = await getMergedSchema(collectionDef, ctx.adapter);
67
+ return buildSeoFieldMap(Object.keys(schema.shape)).description;
68
+ }
69
+ const seoFillMetaTool = defineTool({
70
+ name: 'seo_fill_meta_description',
71
+ label: 'Write a meta description',
72
+ description: 'Generate a meta description for a document that has none and save it as a draft. An existing description is never replaced here; to rewrite one, use update_draft.',
73
+ input: documentInput,
74
+ role: 'admin',
75
+ available: canWriteDrafts,
76
+ describe: (input) => `Writing a meta description for ${pathOf(input)}`,
77
+ async run(input, run) {
78
+ const locale = localeOf(run.ctx, input.locale);
79
+ const path = pathOf(input);
80
+ const current = await exactDocument(run.ctx, input.collection, input.slug, locale);
81
+ if (!current)
82
+ return failure(`${path} does not exist in locale ${locale}`);
83
+ const source = await prepareMetaDescription(input, current, run.ctx.seoConfigAdapter ?? null, false);
84
+ if ('skip' in source)
85
+ return skipped(path, source.skip);
86
+ const field = await descriptionField(run.ctx, input.collection);
87
+ if (!field)
88
+ return failure(`The ${input.collection} collection has no description field`);
89
+ const llm = counted(await resolveAdapter(run.ctx), run);
90
+ const description = await generateMetaDescription(source.text, llm, run.ctx.config.site, run.ctx.config.seo.enrichment.meta);
91
+ const outcome = await writeDraft(run, {
92
+ ref: { collection: input.collection, slug: input.slug, locale },
93
+ current,
94
+ fields: { ...current.fields, [field]: description },
95
+ body: current.body,
96
+ });
97
+ if (outcome.result['ok'] !== true || outcome.result['pending'])
98
+ return outcome;
99
+ // Generated from the document's text, so it reaches the model framed like that text
100
+ return {
101
+ ...outcome,
102
+ result: { ...outcome.result, field, description: run.frame(path, description) },
103
+ };
104
+ },
105
+ });
106
+ const seoFillArchetypeTool = defineTool({
107
+ name: 'seo_fill_archetype_properties',
108
+ label: 'Fill Schema.org properties',
109
+ description: "Generate values for the Schema.org properties of a document's archetype that are still unset. Always proposed to the user; existing values are never replaced.",
110
+ input: z.object({ collection: z.string().min(1), slug: z.string().min(1) }),
111
+ role: 'admin',
112
+ available: (ctx) => ctx.seoConfigAdapter !== undefined && canGetContent(ctx.adapter),
113
+ describe: (input) => `Generating Schema.org properties for ${pathOf(input)}`,
114
+ async run(input, run) {
115
+ const { ctx } = run;
116
+ const path = pathOf(input);
117
+ const current = await exactDocument(ctx, input.collection, input.slug, localeOf(ctx, undefined));
118
+ if (!current || !ctx.seoConfigAdapter)
119
+ return failure(`${path} does not exist`);
120
+ const getTypeProperties = await loadGetTypeProperties();
121
+ if (!getTypeProperties)
122
+ return failure('Schema.org properties need the @krantho/seo package');
123
+ const llm = counted(await resolveAdapter(ctx), run);
124
+ const limits = ctx.config.seo.enrichment.archetype;
125
+ const generated = await proposeArchetypeProperties(input, current, llm, ctx.seoConfigAdapter, ctx.config.site, limits, false, getTypeProperties);
126
+ if ('skip' in generated)
127
+ return skipped(path, generated.skip);
128
+ const entries = Object.entries(generated.add);
129
+ if (entries.length === 0)
130
+ return skipped(path, 'The model generated no values');
131
+ const { configId, schemaTypes, add, baseVersion, locale } = generated;
132
+ return proposal(run, { kind: 'save_seo_properties', configId, schemaTypes, add, baseVersion, locale }, {
133
+ title: `Add ${entries.length} Schema.org properties to ${path}`,
134
+ confirmLabel: 'Save properties',
135
+ destructive: false,
136
+ }, {
137
+ summary: `Proposed Schema.org properties for ${path} — needs your confirmation`,
138
+ documents: [refOf(current)],
139
+ proposal: {
140
+ title: `${schemaTypes.join(', ')} properties`,
141
+ items: entries.map(([label, text]) => ({ label, text })),
142
+ },
143
+ });
144
+ },
145
+ });
146
+ /** SEO tools */
147
+ export const SEO_TOOLS = [
148
+ seoValidateTool,
149
+ seoFillMetaTool,
150
+ seoFillArchetypeTool,
151
+ ];
152
+ //# sourceMappingURL=seo-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"seo-tools.js","sourceRoot":"","sources":["../../../src/assistant/tools/seo-tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,35 @@
1
+ import { type ContentDocument } from '@krantho/persistence';
2
+ import type { ApiContext, AuthenticatedUser } from '../../types.js';
3
+ import { type PendingAction } from '../pending-action.js';
4
+ import type { AssistantActivity, DocumentRef } from '../protocol.js';
5
+ import type { ToolOutcome, ToolRunContext } from './define-tool.js';
6
+ /** `changedBy` of an assistant write: the user's own, marked as made through the assistant */
7
+ export declare function assistantChangedBy(user: AuthenticatedUser | undefined): string;
8
+ /** The locale a tool acts on: the one asked for, else the site's default */
9
+ export declare function localeOf(ctx: ApiContext, locale: string | undefined): string;
10
+ /** The current version of exactly this document in exactly this locale — never a fallback */
11
+ export declare function exactDocument(ctx: ApiContext, collection: string, slug: string, locale: string): Promise<ContentDocument | null>;
12
+ /** A document's reference, with its version */
13
+ export declare function refOf(doc: ContentDocument): DocumentRef;
14
+ /** `collection/slug` */
15
+ export declare function pathOf(ref: {
16
+ collection: string;
17
+ slug: string;
18
+ }): string;
19
+ /** A failed tool call: the error for the model, and what Studio shows */
20
+ export declare function failure(error: string, activity?: {
21
+ summary?: string | undefined;
22
+ documents?: DocumentRef[] | undefined;
23
+ }): ToolOutcome;
24
+ /** The shown proposal: its one-line title, the confirm button and whether it destroys */
25
+ export interface ProposalView {
26
+ title: string;
27
+ confirmLabel: string;
28
+ destructive: boolean;
29
+ }
30
+ /**
31
+ * A pending action: the signed token and what it does go to Studio in the
32
+ * activity only; the model is told a proposal awaits the user, without the token.
33
+ */
34
+ export declare function proposal(run: ToolRunContext, action: PendingAction, view: ProposalView, activity: Omit<AssistantActivity, 'id' | 'tool' | 'status' | 'pending'>): ToolOutcome;
35
+ //# sourceMappingURL=support.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../../src/assistant/tools/support.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,sBAAsB,CAAA;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,sBAAsB,CAAA;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEnE,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAE9E;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE5E;AAED,6FAA6F;AAC7F,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAGjC;AAED,+CAA+C;AAC/C,wBAAgB,KAAK,CAAC,GAAG,EAAE,eAAe,GAAG,WAAW,CAGvD;AAED,wBAAwB;AACxB,wBAAgB,MAAM,CAAC,GAAG,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAExE;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;CAAO,GACrF,WAAW,CASb;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC,GACtE,WAAW,CAmBb"}