@classytic/arc 2.45.1 → 2.46.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 (321) hide show
  1. package/README.md +1 -1
  2. package/dist/{EventTransport-CiicKz2Z.d.mts → EventTransport-CYEoCJGe.d.mts} +0 -2
  3. package/dist/{EventTransport-4b0noGwa.mjs → EventTransport-DNgD9NP4.mjs} +3 -4
  4. package/dist/{HookSystem-4pABQnGn.mjs → HookSystem-DRbPzEcP.mjs} +3 -4
  5. package/dist/{QueryCache--5uAuYPW.d.mts → QueryCache-DdvrGG8Q.d.mts} +1 -3
  6. package/dist/{ResourceRegistry-BBaN_Ne-.mjs → ResourceRegistry-Douk51fa.mjs} +15 -4
  7. package/dist/{acquire-kiZzy5bX.mjs → acquire-RbtvDg9s.mjs} +2 -3
  8. package/dist/{actionPermissions-BLnbDA6g.mjs → actionPermissions-De0AJ7hm.mjs} +37 -42
  9. package/dist/audit/index.d.mts +2 -10
  10. package/dist/audit/index.mjs +8 -12
  11. package/dist/auth/audit.d.mts +0 -2
  12. package/dist/auth/audit.mjs +2 -3
  13. package/dist/auth/index.d.mts +9 -17
  14. package/dist/auth/index.mjs +26 -29
  15. package/dist/auth/redis-session.d.mts +2 -4
  16. package/dist/auth/redis-session.mjs +2 -3
  17. package/dist/{authorizationDecision-CVlaTjAX.mjs → authorizationDecision-DeZMrHcm.mjs} +5 -6
  18. package/dist/{base-CZyixEQR.d.mts → base-HXNgPQww.d.mts} +1 -7
  19. package/dist/{boundedMap-DSy7KkeX.mjs → boundedMap-2WBh3gM9.mjs} +2 -3
  20. package/dist/{buildHandler-B4IhILv9.mjs → buildHandler-DxVOOBpw.mjs} +5 -6
  21. package/dist/cache/index.d.mts +4 -10
  22. package/dist/cache/index.mjs +5 -6
  23. package/dist/{caching-DqakP2vY.mjs → caching-BYRwYrUo.mjs} +3 -4
  24. package/dist/{claimed-XoiVrWZ2.mjs → claimed-DYlELdnm.mjs} +2 -3
  25. package/dist/cleanup/index.d.mts +9 -18
  26. package/dist/cleanup/index.mjs +12 -20
  27. package/dist/cli/commands/describe.d.mts +1 -3
  28. package/dist/cli/commands/describe.mjs +4 -5
  29. package/dist/cli/commands/docs.d.mts +1 -3
  30. package/dist/cli/commands/docs.mjs +4 -5
  31. package/dist/cli/commands/doctor.d.mts +1 -3
  32. package/dist/cli/commands/doctor.mjs +2 -3
  33. package/dist/cli/commands/generate.d.mts +1 -1
  34. package/dist/cli/commands/generate.mjs +2 -2
  35. package/dist/cli/commands/init.d.mts +1 -1
  36. package/dist/cli/commands/init.mjs +2 -2
  37. package/dist/cli/commands/introspect.d.mts +1 -3
  38. package/dist/cli/commands/introspect.mjs +3 -4
  39. package/dist/cli/index.d.mts +2 -2
  40. package/dist/cli/index.mjs +3 -3
  41. package/dist/{constants-CtWkmWn3.mjs → constants-CHZMUwBW.mjs} +2 -3
  42. package/dist/context/index.d.mts +0 -8
  43. package/dist/context/index.mjs +6 -7
  44. package/dist/core/index.d.mts +3 -3
  45. package/dist/core/index.mjs +8 -8
  46. package/dist/{core-Cro2v5a7.mjs → core-D9rS2BxO.mjs} +9 -12
  47. package/dist/{createActionRouter-k-gwiPv6.mjs → createActionRouter-0qkCRzTL.mjs} +7 -8
  48. package/dist/{createAggregationRouter-BqWqhAPG.mjs → createAggregationRouter-CUf5Esd9.mjs} +9 -10
  49. package/dist/{createApp-Dw7L72Hz.mjs → createApp-DZIXfDKD.mjs} +49 -62
  50. package/dist/{createMcpServer-DSztofa9.d.mts → createMcpServer-DeVpqQF-.d.mts} +1 -3
  51. package/dist/{defineAggregation-pxbd7BBK.mjs → defineAggregation-bmKQ4NmC.mjs} +2 -3
  52. package/dist/{defineResource-DwgEjLCO.mjs → defineResource-CGmdmGwh.mjs} +78 -29
  53. package/dist/discovery/index.d.mts +1 -3
  54. package/dist/discovery/index.mjs +2 -3
  55. package/dist/docs/index.d.mts +8 -8
  56. package/dist/docs/index.mjs +4 -5
  57. package/dist/{elevation-B9wF2Z1F.mjs → elevation-CzhqAyVN.mjs} +9 -10
  58. package/dist/{elevation-BW2J3tNj.d.mts → elevation-DPD0hcU-.d.mts} +0 -2
  59. package/dist/encryption/index.d.mts +1 -7
  60. package/dist/encryption/index.mjs +8 -13
  61. package/dist/{errorHandler--4rSMMvq.d.mts → errorHandler-B9r88jZV.d.mts} +8 -3
  62. package/dist/{errorHandler-Dr2nG0Ui.mjs → errorHandler-dFyGOEoB.mjs} +16 -6
  63. package/dist/{errors-BtHzrSA6.mjs → errors-BY8vzlP4.mjs} +2 -3
  64. package/dist/{errors-JYc9vwqE.d.mts → errors-DTo0me1o.d.mts} +0 -2
  65. package/dist/{eventPlugin-BtmA4-3P.d.mts → eventPlugin-BY38F6yK.d.mts} +1 -7
  66. package/dist/{eventPlugin-Dvs7OBw8.mjs → eventPlugin-eMhAPtQA.mjs} +10 -12
  67. package/dist/{eventTypes-BVoCTG5c.mjs → eventTypes-Do2KYeJx.mjs} +5 -8
  68. package/dist/events/index.d.mts +4 -16
  69. package/dist/events/index.mjs +8 -9
  70. package/dist/events/transports/redis-stream-entry.d.mts +1 -1
  71. package/dist/events/transports/redis-stream-entry.mjs +5 -6
  72. package/dist/events/transports/redis.d.mts +2 -4
  73. package/dist/events/transports/redis.mjs +3 -4
  74. package/dist/{externalPaths-CmGOxOtD.d.mts → externalPaths-BOqdq5wr.d.mts} +0 -2
  75. package/dist/factory/index.d.mts +4 -14
  76. package/dist/factory/index.mjs +12 -18
  77. package/dist/{fastify-augmentation-DRlCIWE9.d.mts → fastify-augmentation-Dtn0IIRn.d.mts} +4 -10
  78. package/dist/{fields-BBSpf8pS.d.mts → fields-JTkrtO-r.d.mts} +0 -2
  79. package/dist/{fields-C1e_7Fwi.mjs → fields-LnbCcvsw.mjs} +2 -3
  80. package/dist/{filter-merge-xaiEKtz8.mjs → filter-merge-BAWi019Q.mjs} +2 -3
  81. package/dist/{generate-DCGuEbqI.d.mts → generate-C-g_KOkV.d.mts} +0 -4
  82. package/dist/{generate-DJiJMaXN.mjs → generate-oXoDnpJf.mjs} +7 -12
  83. package/dist/{headers-Dr-wt6Tr.mjs → headers-DBd3Qheo.mjs} +3 -4
  84. package/dist/{health-DkkWbJtQ.mjs → health-BlJu9GXS.mjs} +2 -3
  85. package/dist/{health-BLYn_Hds.mjs → health-Dp-3EC9o.mjs} +4 -7
  86. package/dist/hooks/index.d.mts +1 -1
  87. package/dist/hooks/index.mjs +2 -2
  88. package/dist/idempotency/index.d.mts +3 -9
  89. package/dist/idempotency/index.mjs +10 -13
  90. package/dist/idempotency/redis.d.mts +1 -1
  91. package/dist/idempotency/redis.mjs +3 -4
  92. package/dist/{index-Bxriq3so.d.mts → index-B5i9-vuP.d.mts} +4 -26
  93. package/dist/{index-Chgz3d0i.d.mts → index-BAXDo5eE.d.mts} +1 -7
  94. package/dist/{index-Beg3aNnK.d.mts → index-BTxzJ_MN.d.mts} +67 -25
  95. package/dist/{index-CUJvoyw3.d.mts → index-Bqfo8hLz.d.mts} +2 -24
  96. package/dist/{index-uhkUA5-U.d.mts → index-CUdaoCYt.d.mts} +13 -23
  97. package/dist/{index-WH7xgvxS.d.mts → index-DyJFTJLA.d.mts} +31 -92
  98. package/dist/index.d.mts +7 -9
  99. package/dist/index.mjs +12 -13
  100. package/dist/{init-CW3kJqNW.mjs → init-BOaNkLYb.mjs} +18 -35
  101. package/dist/{init-Cscs4lab.d.mts → init-CV2_Fw3H.d.mts} +0 -4
  102. package/dist/integrations/event-gateway.d.mts +3 -5
  103. package/dist/integrations/event-gateway.mjs +3 -4
  104. package/dist/integrations/index.d.mts +3 -3
  105. package/dist/integrations/index.mjs +1 -1
  106. package/dist/integrations/jobs/index.d.mts +1 -1
  107. package/dist/integrations/jobs/index.mjs +7 -11
  108. package/dist/integrations/mcp/index.d.mts +7 -39
  109. package/dist/integrations/mcp/index.mjs +8 -14
  110. package/dist/integrations/mcp/testing.d.mts +3 -5
  111. package/dist/integrations/mcp/testing.mjs +3 -4
  112. package/dist/integrations/streamline.d.mts +1 -3
  113. package/dist/integrations/streamline.mjs +4 -5
  114. package/dist/integrations/webhooks.d.mts +2 -4
  115. package/dist/integrations/webhooks.mjs +4 -5
  116. package/dist/integrations/websocket-pushref-redis.d.mts +2 -4
  117. package/dist/integrations/websocket-pushref-redis.mjs +2 -3
  118. package/dist/integrations/websocket-redis.d.mts +2 -4
  119. package/dist/integrations/websocket-redis.mjs +2 -3
  120. package/dist/integrations/websocket.d.mts +2 -2
  121. package/dist/integrations/websocket.mjs +13 -24
  122. package/dist/{interface-JJzwH4Ro.d.mts → interface-BmExzQRD.d.mts} +0 -2
  123. package/dist/{interface-BOk3YnTz.d.mts → interface-WR1U0K7t.d.mts} +0 -2
  124. package/dist/{jsonBody-DPU8yYwA.mjs → jsonBody-DpRpKR_K.mjs} +3 -4
  125. package/dist/{keys-Dgn6OYhl.mjs → keys-FBz6Ull-.mjs} +2 -3
  126. package/dist/{loadResources-BtKj6P1P.mjs → loadResources-Bx1sKPnF.mjs} +4 -5
  127. package/dist/{loadResourcesFromEntry-Bmq6TnB7.mjs → loadResourcesFromEntry-b_jcqbxh.mjs} +3 -4
  128. package/dist/logger/index.d.mts +1 -3
  129. package/dist/logger/index.mjs +2 -2
  130. package/dist/{logger-qQNLlOAU.mjs → logger-CbFcIEBZ.mjs} +3 -5
  131. package/dist/{mcpPlugin-DDfe8jAP.mjs → mcpPlugin-yix548XX.mjs} +41 -60
  132. package/dist/{memory-C0Blueoh.mjs → memory-Bgw5dn8N.mjs} +4 -5
  133. package/dist/{metrics-DYka72iN.mjs → metrics-CZDQWVjS.mjs} +4 -5
  134. package/dist/middleware/index.d.mts +1 -5
  135. package/dist/middleware/index.mjs +4 -5
  136. package/dist/migrations/index.d.mts +0 -2
  137. package/dist/migrations/index.mjs +3 -4
  138. package/dist/{module-BszSyWbd.mjs → module-Dsc_nKL5.mjs} +2 -3
  139. package/dist/{multiTenant-CAtYlW6H.d.mts → multiTenant-XCxAUlru.d.mts} +1 -5
  140. package/dist/{multipartBody-RHvIkNmc.mjs → multipartBody-B85ek8Kj.mjs} +2 -3
  141. package/dist/observeSend-BK-JN1jK.mjs +20 -0
  142. package/dist/{openapi-BrFPc3Ny.mjs → openapi-Co7hl073.mjs} +18 -28
  143. package/dist/outbox-admin/index.d.mts +2 -4
  144. package/dist/outbox-admin/index.mjs +6 -7
  145. package/dist/{outbox-module-gZCHoE4H.d.mts → outbox-module-XvUThpqn.d.mts} +2 -8
  146. package/dist/{outbox-module-DF4Bu_Qa.mjs → outbox-module-mg9kDYkd.mjs} +13 -17
  147. package/dist/permissions/index.d.mts +4 -4
  148. package/dist/permissions/index.mjs +7 -7
  149. package/dist/{permissions-DN1CWH56.mjs → permissions-A1oKtpiC.mjs} +19 -29
  150. package/dist/{pipe-B8uq865o.mjs → pipe-Czpw9U2n.mjs} +3 -4
  151. package/dist/pipeline/index.d.mts +1 -9
  152. package/dist/pipeline/index.mjs +5 -8
  153. package/dist/{plan-DUGfynNg.mjs → plan-KVseuBCL.mjs} +5 -9
  154. package/dist/{plugin-ByU3h-bR.mjs → plugin-DTWt_8C3.mjs} +130 -62
  155. package/dist/plugins/index.d.mts +8 -16
  156. package/dist/plugins/index.mjs +22 -26
  157. package/dist/plugins/response-cache.d.mts +2 -4
  158. package/dist/plugins/response-cache.mjs +10 -10
  159. package/dist/plugins/tracing-entry.d.mts +1 -1
  160. package/dist/plugins/tracing-entry.mjs +3 -4
  161. package/dist/{pluralize-Cdya8zYt.mjs → pluralize-msB9X3yw.mjs} +2 -3
  162. package/dist/presets/filesUpload.d.mts +4 -6
  163. package/dist/presets/filesUpload.mjs +6 -7
  164. package/dist/presets/index.d.mts +3 -19
  165. package/dist/presets/index.mjs +2 -2
  166. package/dist/presets/multiTenant.d.mts +1 -1
  167. package/dist/presets/multiTenant.mjs +7 -7
  168. package/dist/presets/search.d.mts +3 -5
  169. package/dist/presets/search.mjs +3 -4
  170. package/dist/{presets-CCOlKTZw.mjs → presets-qKCehiJM.mjs} +11 -18
  171. package/dist/{projection-BGty6ie4.mjs → projection-ClBqtsIw.mjs} +3 -4
  172. package/dist/{pushref-registry-UxCkoA4C.d.mts → pushref-registry-d86QUaSq.d.mts} +0 -6
  173. package/dist/{queryCachePlugin-B7itTkWu.mjs → queryCachePlugin-3gJj5Rbz.mjs} +8 -10
  174. package/dist/{queryCachePlugin-C2lZjTxk.d.mts → queryCachePlugin-DYQUyeJ9.d.mts} +2 -4
  175. package/dist/{rateLimitKey-DBWO59H9.mjs → rateLimitKey-Kro---xl.mjs} +2 -3
  176. package/dist/{realtime-_59Rlje8.mjs → realtime-Ber8uJN2.mjs} +17 -19
  177. package/dist/{redis-BDgv9Glw.d.mts → redis-RpDMemdm.d.mts} +2 -4
  178. package/dist/{redis-stream-BMk-bpQS.d.mts → redis-stream-CS1N9dwM.d.mts} +1 -3
  179. package/dist/{redisShapes-CQksY67q.d.mts → redisShapes-CqBXTn_s.d.mts} +0 -2
  180. package/dist/registry/index.d.mts +2 -12
  181. package/dist/registry/index.mjs +3 -3
  182. package/dist/{registry-uG4wr541.mjs → registry-BA-_vFYk.mjs} +7 -12
  183. package/dist/{renewingLease-CiU3ZynH.mjs → renewingLease-CMY8YOcc.mjs} +2 -3
  184. package/dist/{replyHelpers-Dr2pnXZg.mjs → replyHelpers-DK9P_XSz.mjs} +3 -4
  185. package/dist/{requestContext-DBKIdmDi.mjs → requestContext-GYO_0gEw.mjs} +2 -3
  186. package/dist/{requirement-CbiLdQ1n.d.mts → requirement-CTRQjjQx.d.mts} +0 -2
  187. package/dist/{requirement-DxOaghWD.mjs → requirement-DeNjZIH3.mjs} +2 -3
  188. package/dist/{resourceRateLimit-Wf6d6FL9.d.mts → resourceRateLimit-DCWglD7V.d.mts} +1 -3
  189. package/dist/{resourceRateLimit-BBdj5yRq.mjs → resourceRateLimit-tHLbrtWc.mjs} +3 -4
  190. package/dist/{rolldown-runtime-DpVPUeXF.mjs → rolldown-runtime-Kv1fZdLg.mjs} +2 -3
  191. package/dist/{routeValidator-BNTqM1Eh.mjs → routeValidator-C_H5NanI.mjs} +2 -3
  192. package/dist/{runtimeCapabilities-D_3eUO6V.mjs → runtimeCapabilities-DWqbxkyw.mjs} +2 -3
  193. package/dist/{schedules-CVS7c1nv.mjs → schedules-eO_RzhCU.mjs} +132 -9
  194. package/dist/{schemaConverter-BQbg7loK.mjs → schemaConverter-DBJrPZN4.mjs} +3 -4
  195. package/dist/{schemaIR-CUI3hPQR.mjs → schemaIR-CEScKT2v.mjs} +3 -4
  196. package/dist/schemas/index.d.mts +0 -2
  197. package/dist/schemas/index.mjs +2 -3
  198. package/dist/scim/index.d.mts +0 -12
  199. package/dist/scim/index.mjs +10 -18
  200. package/dist/scope/index.d.mts +2 -6
  201. package/dist/scope/index.mjs +5 -5
  202. package/dist/{scope-DFXngazv.mjs → scope-B-Sm9m_E.mjs} +5 -6
  203. package/dist/{sessionManager-qimlKV0P.d.mts → sessionManager-CdvDF04x.d.mts} +2 -4
  204. package/dist/{shutdown-BCXCwghd.mjs → shutdown-DzLFbe27.mjs} +2 -3
  205. package/dist/{simpleEqualityMatcher-5jOzYQ_L.mjs → simpleEqualityMatcher-DOJhwQ8g.mjs} +2 -3
  206. package/dist/{sse-BilBz766.mjs → sse-2972pVwV.mjs} +8 -9
  207. package/dist/{sseStream-BG_uJL6J.mjs → sseStream-AWLEeNV-.mjs} +3 -4
  208. package/dist/{storage-Cx9Sz3Ou.d.mts → storage-odC5MNKN.d.mts} +0 -2
  209. package/dist/{store-helpers-CzLZdVa1.mjs → store-helpers-VzjgVTkM.mjs} +2 -3
  210. package/dist/{streaming-DgUvMWlv.mjs → streaming-DvraWW6x.mjs} +2 -3
  211. package/dist/{subscriberIdentity-EWnIZ-U8.mjs → subscriberIdentity-Bya56jsg.mjs} +2 -3
  212. package/dist/{tenancy-CVMvO5DH.mjs → tenancy-DSa_0hhw.mjs} +3 -4
  213. package/dist/{tenantPreparation-DIH-GX4g.mjs → tenantPreparation-BrpkQre3.mjs} +5 -6
  214. package/dist/testing/cleanupStoreContract.d.mts +2 -4
  215. package/dist/testing/cleanupStoreContract.mjs +2 -3
  216. package/dist/testing/index.d.mts +6 -32
  217. package/dist/testing/index.mjs +24 -37
  218. package/dist/testing/outboxStoreContract.d.mts +1 -3
  219. package/dist/testing/outboxStoreContract.mjs +3 -4
  220. package/dist/testing/requiredPorts.d.mts +2 -4
  221. package/dist/testing/requiredPorts.mjs +3 -4
  222. package/dist/testing/storageContract.d.mts +2 -4
  223. package/dist/testing/storageContract.mjs +2 -3
  224. package/dist/{timing-q9NITK04.mjs → timing-6rQTuCwg.mjs} +3 -5
  225. package/dist/{tracing-Dro5eH6j.d.mts → tracing-JSFiBl5r.d.mts} +0 -2
  226. package/dist/{transactionContext-NHmhDIOF.mjs → transactionContext-DaxYUEgH.mjs} +2 -3
  227. package/dist/{typeGuards-CPYR9RCg.mjs → typeGuards-UKnX8wPX.mjs} +2 -3
  228. package/dist/types/index.d.mts +4 -4
  229. package/dist/types/index.mjs +1 -1
  230. package/dist/types/storage.d.mts +1 -1
  231. package/dist/types/storage.mjs +1 -1
  232. package/dist/{types-ByHn9rEO.d.mts → types-0Dqlbgn8.d.mts} +0 -2
  233. package/dist/{types-D3Ixsh00.d.mts → types-BYEb_dLW.d.mts} +2 -4
  234. package/dist/{types-BJ-2XqVF.d.mts → types-BeEJm-DV.d.mts} +114 -14
  235. package/dist/{types-DVLddu2q.d.mts → types-C0YJAiL0.d.mts} +0 -2
  236. package/dist/{types-BI4sbUJ3.mjs → types-CuGjhn83.mjs} +5 -6
  237. package/dist/{types-Ddl9OjmE.d.mts → types-DnkIALZ8.d.mts} +0 -4
  238. package/dist/usage/index.d.mts +2 -10
  239. package/dist/usage/index.mjs +8 -12
  240. package/dist/{userHelpers-oBTU3a_k.mjs → userHelpers-oX5_mOVs.mjs} +2 -3
  241. package/dist/utils/index.d.mts +5 -39
  242. package/dist/utils/index.mjs +12 -12
  243. package/dist/{utils-BmE8zRrh.mjs → utils-CjjGOT4E.mjs} +20 -30
  244. package/dist/{validate-Dby08LhR.mjs → validate-4RlTKOJb.mjs} +5 -7
  245. package/dist/{versioning-P6JMNcJr.mjs → versioning-Dk2-19La.mjs} +4 -5
  246. package/dist/{versioning-Bqm_57Qt.d.mts → versioning-S18y2-0C.d.mts} +1 -15
  247. package/dist/{websocket-Cs4awVyD.d.mts → websocket-BGuc-WVZ.d.mts} +1 -15
  248. package/dist/{workScope-BcMLKa3G.mjs → workScope-DoBsoVo4.mjs} +3 -4
  249. package/llms.txt +37 -30
  250. package/package.json +9 -8
  251. package/skills/arc/SKILL.md +65 -844
  252. package/skills/arc/references/agent-auth.md +82 -193
  253. package/skills/arc/references/api-reference.md +41 -245
  254. package/skills/arc/references/auth-api-keys.md +99 -0
  255. package/skills/arc/references/auth-better-auth-overlay.md +87 -0
  256. package/skills/arc/references/auth-better-auth.md +78 -0
  257. package/skills/arc/references/auth-permissions.md +100 -0
  258. package/skills/arc/references/auth-strategies.md +122 -0
  259. package/skills/arc/references/boot.md +80 -0
  260. package/skills/arc/references/enterprise-auth.md +65 -81
  261. package/skills/arc/references/events-outbox.md +90 -0
  262. package/skills/arc/references/events.md +75 -440
  263. package/skills/arc/references/integrations-jobs.md +74 -0
  264. package/skills/arc/references/integrations-realtime.md +84 -0
  265. package/skills/arc/references/integrations-webhooks.md +71 -0
  266. package/skills/arc/references/integrations-workflows.md +47 -0
  267. package/skills/arc/references/mcp-auth.md +83 -0
  268. package/skills/arc/references/mcp-custom-tools.md +125 -0
  269. package/skills/arc/references/mcp-setup.md +115 -0
  270. package/skills/arc/references/mcp-testing.md +63 -0
  271. package/skills/arc/references/multi-tenancy.md +56 -230
  272. package/skills/arc/references/permissions-scope.md +81 -0
  273. package/skills/arc/references/production-api.md +119 -0
  274. package/skills/arc/references/production-audit.md +101 -0
  275. package/skills/arc/references/production-boot.md +91 -0
  276. package/skills/arc/references/production-caching.md +63 -0
  277. package/skills/arc/references/production-distributed.md +75 -0
  278. package/skills/arc/references/production-idempotency.md +83 -0
  279. package/skills/arc/references/production-observability.md +83 -0
  280. package/skills/arc/references/production-realtime.md +70 -0
  281. package/skills/arc/references/production-reliability.md +100 -0
  282. package/skills/arc/references/production-shutdown.md +43 -0
  283. package/skills/arc/references/querying.md +76 -0
  284. package/skills/arc/references/resources.md +97 -0
  285. package/skills/arc/references/schedules.md +79 -0
  286. package/skills/arc/references/scim.md +61 -208
  287. package/skills/arc/references/tenancy-scope-install.md +82 -0
  288. package/skills/arc/references/testing.md +101 -144
  289. package/skills/arc/references/usage-cleanup-capabilities.md +45 -0
  290. package/skills/arc/references/validation.md +91 -0
  291. package/skills/arc/references/writes-hooks-errors.md +80 -0
  292. package/skills/arc-code-review/SKILL.md +67 -114
  293. package/skills/arc-code-review/references/arc-cheatsheet.md +68 -167
  294. package/skills/arc-code-review/references/mongokit-repositories.md +104 -0
  295. package/skills/arc-code-review/references/recipe-events-cache-jobs.md +112 -0
  296. package/skills/arc-code-review/references/recipe-resource.md +100 -0
  297. package/skills/arc-code-review/references/recipe-schemas-fields.md +93 -0
  298. package/skills/arc-code-review/references/recipe-scope-permissions.md +82 -0
  299. package/skills/arc-code-review/references/scaffolding.md +61 -198
  300. package/skills/arc-code-review/references/severity.md +49 -102
  301. package/skills/arc-code-review/references/smells-auth-scope.md +80 -0
  302. package/skills/arc-code-review/references/smells-data-events.md +66 -0
  303. package/skills/arc-code-review/references/smells-imports-style.md +59 -0
  304. package/skills/arc-code-review/references/smells-platform.md +89 -0
  305. package/skills/arc-code-review/references/smells-routes-schemas.md +66 -0
  306. package/skills/arc-module-publishing/SKILL.md +82 -208
  307. package/skills/arc-module-publishing/references/action-presets-and-plugins.md +87 -0
  308. package/skills/arc-module-publishing/references/build-and-types.md +73 -0
  309. package/skills/arc-module-publishing/references/module-lifecycle.md +101 -0
  310. package/skills/arc-module-publishing/references/package-manifest.md +34 -122
  311. package/skills/arc-module-publishing/references/publishing-workflow.md +44 -140
  312. package/skills/arc-module-publishing/references/resource-assembly.md +102 -0
  313. package/skills/arc-module-publishing/references/testing-packages.md +82 -0
  314. package/skills/arc/references/auth.md +0 -729
  315. package/skills/arc/references/integrations.md +0 -452
  316. package/skills/arc/references/mcp.md +0 -691
  317. package/skills/arc/references/production.md +0 -835
  318. package/skills/arc-code-review/references/anti-patterns.md +0 -1008
  319. package/skills/arc-code-review/references/migration-recipes.md +0 -649
  320. package/skills/arc-code-review/references/mongokit-migration.md +0 -360
  321. package/skills/arc-module-publishing/references/authoring-modules.md +0 -327
@@ -1,4 +1,4 @@
1
- /*! @classytic/arc v2.45.1 | MIT | https://classytic.com */
1
+ /*! @classytic/arc v2.46.0 | MIT | https://classytic.com */
2
2
  import * as fs from "node:fs/promises";
3
3
  import * as path from "node:path";
4
4
  import { dirname, join } from "node:path";
@@ -6,7 +6,7 @@ import { fileURLToPath } from "node:url";
6
6
  import { accessSync, existsSync, readFileSync } from "node:fs";
7
7
  import * as readline from "node:readline";
8
8
  import { execSync, spawn } from "node:child_process";
9
- //#region src/cli/commands/init/dependency-plan.ts
9
+ // src/cli/commands/init/dependency-plan.ts
10
10
  /**
11
11
  * Single source of truth for scaffolded project dependencies.
12
12
  *
@@ -205,8 +205,7 @@ function resolveScaffoldDependencies(config) {
205
205
  function sortByKey(record) {
206
206
  return Object.fromEntries(Object.entries(record).sort(([a], [b]) => a.localeCompare(b)));
207
207
  }
208
- //#endregion
209
- //#region src/cli/commands/init/templates/adapter.ts
208
+ // src/cli/commands/init/templates/adapter.ts
210
209
  function createAdapterTemplate(config) {
211
210
  const ts = config.typescript;
212
211
  return `/**
@@ -276,8 +275,7 @@ export function createAdapter${ts ? "<TDoc = unknown>" : ""}(
276
275
  }
277
276
  `;
278
277
  }
279
- //#endregion
280
- //#region src/cli/commands/init/templates/agents.ts
278
+ // src/cli/commands/init/templates/agents.ts
281
279
  function agentsGuideTemplate(config) {
282
280
  return `# CLAUDE.md — agent guide for this app
283
281
 
@@ -330,8 +328,7 @@ npx arc describe # list registered resources + routes
330
328
  \`\`\`
331
329
  `;
332
330
  }
333
- //#endregion
334
- //#region src/cli/commands/init/templates/app.ts
331
+ // src/cli/commands/init/templates/app.ts
335
332
  function indexTemplate(config) {
336
333
  const ts = config.typescript;
337
334
  if (config.edge) return edgeIndexTemplate(config);
@@ -570,8 +567,7 @@ if (env === 'dev' && loaded.length > 0) {
570
567
  export const ENV = env;
571
568
  `;
572
569
  }
573
- //#endregion
574
- //#region src/cli/commands/init/templates/auth.ts
570
+ // src/cli/commands/init/templates/auth.ts
575
571
  function authResourceTemplate(config) {
576
572
  const ts = config.typescript;
577
573
  return `/**
@@ -1218,8 +1214,7 @@ ${config.adapter === "mongokit" ? ` await mongoose.connection.collection('use
1218
1214
  });
1219
1215
  `;
1220
1216
  }
1221
- //#endregion
1222
- //#region src/cli/commands/init/templates/config.ts
1217
+ // src/cli/commands/init/templates/config.ts
1223
1218
  /**
1224
1219
  * Project-level config templates — package.json, tsconfig, vitest, gitignore,
1225
1220
  * env files, README, runtime config module.
@@ -1812,8 +1807,7 @@ ${isMongo ? `
1812
1807
  export default config;
1813
1808
  `;
1814
1809
  }
1815
- //#endregion
1816
- //#region src/cli/commands/init/templates/docker.ts
1810
+ // src/cli/commands/init/templates/docker.ts
1817
1811
  function dockerignoreTemplate() {
1818
1812
  return `node_modules
1819
1813
  dist
@@ -1946,8 +1940,7 @@ ${dbConfig}
1946
1940
  # { pattern = "api.example.com/*", zone_name = "example.com" }
1947
1941
  `;
1948
1942
  }
1949
- //#endregion
1950
- //#region src/cli/commands/init/templates/example.ts
1943
+ // src/cli/commands/init/templates/example.ts
1951
1944
  function exampleModelTemplate(config) {
1952
1945
  const ts = config.typescript;
1953
1946
  const typeExport = ts ? `
@@ -2326,8 +2319,7 @@ ${config.tenant === "multi" ? `
2326
2319
  });
2327
2320
  `;
2328
2321
  }
2329
- //#endregion
2330
- //#region src/cli/commands/init/templates/permissions.ts
2322
+ // src/cli/commands/init/templates/permissions.ts
2331
2323
  function permissionsTemplate(config) {
2332
2324
  const ts = config.typescript;
2333
2325
  const typeImport = ts ? ",\n type PermissionCheck," : "";
@@ -2525,8 +2517,7 @@ export const teamScopedPermissions = {
2525
2517
  }
2526
2518
  return content;
2527
2519
  }
2528
- //#endregion
2529
- //#region src/cli/commands/init/templates/plugins.ts
2520
+ // src/cli/commands/init/templates/plugins.ts
2530
2521
  function pluginsIndexTemplate(config) {
2531
2522
  const ts = config.typescript;
2532
2523
  const typeImport = ts ? "import type { FastifyInstance } from 'fastify';\n" : "";
@@ -2577,8 +2568,7 @@ export async function registerPlugins(
2577
2568
  `;
2578
2569
  return content;
2579
2570
  }
2580
- //#endregion
2581
- //#region src/cli/commands/init/templates/presets.ts
2571
+ // src/cli/commands/init/templates/presets.ts
2582
2572
  function presetsMultiTenantTemplate(config) {
2583
2573
  return `/**
2584
2574
  * Arc Presets - Multi-Tenant Configuration
@@ -2737,8 +2727,7 @@ export function flexibleMultiTenantPreset(options${ts ? ": FlexibleMultiTenantOp
2737
2727
  export default flexibleMultiTenantPreset;
2738
2728
  `;
2739
2729
  }
2740
- //#endregion
2741
- //#region src/cli/commands/init/templates/resources.ts
2730
+ // src/cli/commands/init/templates/resources.ts
2742
2731
  function resourcesIndexTemplate(config) {
2743
2732
  const ts = config.typescript;
2744
2733
  const authImports = config.auth === "jwt" ? `
@@ -2796,8 +2785,7 @@ export * from './permissions.js';
2796
2785
  export * from './presets/index.js';
2797
2786
  `;
2798
2787
  }
2799
- //#endregion
2800
- //#region src/cli/commands/init/templates/user.ts
2788
+ // src/cli/commands/init/templates/user.ts
2801
2789
  function userModelTemplate(config) {
2802
2790
  const ts = config.typescript;
2803
2791
  const orgRoles = config.tenant === "multi" ? `
@@ -3068,8 +3056,7 @@ const userController = new UserController();
3068
3056
  export default userController;
3069
3057
  `;
3070
3058
  }
3071
- //#endregion
3072
- //#region src/cli/commands/init/file-writer.ts
3059
+ // src/cli/commands/init/file-writer.ts
3073
3060
  /**
3074
3061
  * Scaffolding I/O — given a fully-resolved `ProjectConfig`, materialise
3075
3062
  * the project directory tree and write every template-produced file.
@@ -3213,8 +3200,7 @@ Documentation:
3213
3200
  https://github.com/classytic/arc
3214
3201
  `);
3215
3202
  }
3216
- //#endregion
3217
- //#region src/cli/commands/init/options.ts
3203
+ // src/cli/commands/init/options.ts
3218
3204
  /**
3219
3205
  * Interactive option-gathering for `arc init`.
3220
3206
  *
@@ -3288,8 +3274,7 @@ async function gatherConfig(options) {
3288
3274
  rl.close();
3289
3275
  }
3290
3276
  }
3291
- //#endregion
3292
- //#region src/cli/commands/init/postinstall.ts
3277
+ // src/cli/commands/init/postinstall.ts
3293
3278
  /**
3294
3279
  * Package manager detection + post-scaffold installation.
3295
3280
  *
@@ -3402,8 +3387,7 @@ function runCommand(command, cwd) {
3402
3387
  child.on("error", reject);
3403
3388
  });
3404
3389
  }
3405
- //#endregion
3406
- //#region src/cli/commands/init/index.ts
3390
+ // src/cli/commands/init/index.ts
3407
3391
  /**
3408
3392
  * `arc init` orchestrator — banners, prompt-gathering, scaffold writing,
3409
3393
  * dependency installation. Every step lives in its own module under
@@ -3458,5 +3442,4 @@ async function init(options = {}) {
3458
3442
  }
3459
3443
  printSuccessMessage(config, options.skipInstall);
3460
3444
  }
3461
- //#endregion
3462
3445
  export { init as t };
@@ -1,5 +1,4 @@
1
1
 
2
- //#region src/cli/commands/init/types.d.ts
3
2
  /**
4
3
  * Shared types for the `arc init` scaffolder.
5
4
  *
@@ -62,11 +61,8 @@ interface DependencyManifest {
62
61
  dependencies: Record<string, string>;
63
62
  devDependencies: Record<string, string>;
64
63
  }
65
- //#endregion
66
- //#region src/cli/commands/init/index.d.ts
67
64
  /**
68
65
  * Initialize a new Arc project.
69
66
  */
70
67
  declare function init(options?: InitOptions): Promise<void>;
71
- //#endregion
72
68
  export { ProjectConfig as a, PackageManager as i, DependencyManifest as n, InitOptions as r, init as t };
@@ -1,8 +1,7 @@
1
1
 
2
- import { n as DomainEvent } from "../EventTransport-CiicKz2Z.mjs";
3
- import { c as WebSocketClient, l as WebSocketMessage } from "../websocket-Cs4awVyD.mjs";
2
+ import { n as DomainEvent } from "../EventTransport-CYEoCJGe.mjs";
3
+ import { c as WebSocketClient, l as WebSocketMessage } from "../websocket-BGuc-WVZ.mjs";
4
4
  import { FastifyPluginAsync, FastifyRequest } from "fastify";
5
- //#region src/integrations/event-gateway.d.ts
6
5
  export interface EventGatewayOptions {
7
6
  /** Require auth for all real-time connections (default: true) */
8
7
  auth?: boolean;
@@ -46,5 +45,4 @@ export interface EventGatewayOptions {
46
45
  onDisconnect?: (client: WebSocketClient) => void | Promise<void>;
47
46
  };
48
47
  }
49
- export declare const eventGatewayPlugin: FastifyPluginAsync<EventGatewayOptions>;
50
- //#endregion
48
+ export declare const eventGatewayPlugin: FastifyPluginAsync<EventGatewayOptions>;
@@ -1,11 +1,11 @@
1
- /*! @classytic/arc v2.45.1 | MIT | https://classytic.com */
1
+ /*! @classytic/arc v2.46.0 | MIT | https://classytic.com */
2
2
  import fp from "fastify-plugin";
3
- //#region src/integrations/event-gateway.ts
3
+ // src/integrations/event-gateway.ts
4
4
  const eventGatewayPluginImpl = async (fastify, opts = {}) => {
5
5
  const { auth = true, orgScoped, roomPolicy, maxMessageBytes, maxSubscriptionsPerClient, authenticate } = opts;
6
6
  if (auth && !authenticate && !fastify.hasDecorator("authenticate")) throw new Error("[arc-event-gateway] auth is true but fastify.authenticate is not registered. Register an auth plugin first, provide a custom authenticate function, or set auth: false.");
7
7
  if (opts.sse !== false) {
8
- const { default: ssePlugin } = await import("../sse-BilBz766.mjs").then((n) => n.n);
8
+ const { default: ssePlugin } = await import("../sse-2972pVwV.mjs").then((n) => n.n);
9
9
  await fastify.register(ssePlugin, {
10
10
  path: opts.sse?.path ?? "/events/stream",
11
11
  requireAuth: auth,
@@ -44,5 +44,4 @@ const eventGatewayPlugin = fp(eventGatewayPluginImpl, {
44
44
  name: "arc-event-gateway",
45
45
  fastify: "5.x"
46
46
  });
47
- //#endregion
48
47
  export { eventGatewayPlugin };
@@ -1,8 +1,8 @@
1
1
 
2
- import { c as WebSocketClient, l as WebSocketMessage, u as WebSocketPluginOptions } from "../websocket-Cs4awVyD.mjs";
2
+ import { c as WebSocketClient, l as WebSocketMessage, u as WebSocketPluginOptions } from "../websocket-BGuc-WVZ.mjs";
3
3
  import { EventGatewayOptions } from "./event-gateway.mjs";
4
- import { a as JobMeta, c as JobsPluginOptions, i as JobDispatcher, l as QueueStats, n as JobDefinition, r as JobDispatchOptions } from "../index-Chgz3d0i.mjs";
5
- import { _ as ToolDefinition, c as McpAuthResult, d as McpResourceConfig, f as PromptDefinition, g as ToolContext, h as ToolAnnotations, n as CallToolResult, o as CrudOperation, r as CreateMcpServerConfig, t as BetterAuthHandler, u as McpPluginOptions } from "../types-D3Ixsh00.mjs";
4
+ import { a as JobMeta, c as JobsPluginOptions, i as JobDispatcher, l as QueueStats, n as JobDefinition, r as JobDispatchOptions } from "../index-BAXDo5eE.mjs";
5
+ import { _ as ToolDefinition, c as McpAuthResult, d as McpResourceConfig, f as PromptDefinition, g as ToolContext, h as ToolAnnotations, n as CallToolResult, o as CrudOperation, r as CreateMcpServerConfig, t as BetterAuthHandler, u as McpPluginOptions } from "../types-BYEb_dLW.mjs";
6
6
  import { StreamlinePluginOptions, WorkflowLike, WorkflowRunLike } from "./streamline.mjs";
7
7
  import { WebhookDeliveryRecord, WebhookManager, WebhookPluginOptions, WebhookStore, WebhookSubscription } from "./webhooks.mjs";
8
8
  export type { BetterAuthHandler, CallToolResult, CreateMcpServerConfig, CrudOperation, EventGatewayOptions, JobDefinition, JobDispatchOptions, JobDispatcher, JobMeta, JobsPluginOptions, McpAuthResult, McpPluginOptions, McpResourceConfig, PromptDefinition, QueueStats, StreamlinePluginOptions, ToolAnnotations, ToolContext, ToolDefinition, WebSocketClient, WebSocketMessage, WebSocketPluginOptions, WebhookDeliveryRecord, WebhookManager, WebhookPluginOptions, WebhookStore, WebhookSubscription, WorkflowLike, WorkflowRunLike };
@@ -1,2 +1,2 @@
1
- /*! @classytic/arc v2.45.1 | MIT | https://classytic.com */
1
+ /*! @classytic/arc v2.46.0 | MIT | https://classytic.com */
2
2
  export {};
@@ -1,3 +1,3 @@
1
1
 
2
- import { a as JobMeta, c as JobsPluginOptions, d as ExecuteTimedHandlerOptions, f as TimedHandlerLogger, i as JobDispatcher, l as QueueStats, n as JobDefinition, o as JobRepeatOptions, p as executeTimedHandler, r as JobDispatchOptions, s as JobStatus, t as jobsPlugin, u as defineJob } from "../../index-Chgz3d0i.mjs";
2
+ import { a as JobMeta, c as JobsPluginOptions, d as ExecuteTimedHandlerOptions, f as TimedHandlerLogger, i as JobDispatcher, l as QueueStats, n as JobDefinition, o as JobRepeatOptions, p as executeTimedHandler, r as JobDispatchOptions, s as JobStatus, t as jobsPlugin, u as defineJob } from "../../index-BAXDo5eE.mjs";
3
3
  export { type ExecuteTimedHandlerOptions, type JobDefinition, type JobDispatchOptions, type JobDispatcher, type JobMeta, type JobRepeatOptions, type JobStatus, type JobsPluginOptions, type QueueStats, type TimedHandlerLogger, defineJob, executeTimedHandler, jobsPlugin };
@@ -1,8 +1,8 @@
1
- /*! @classytic/arc v2.45.1 | MIT | https://classytic.com */
2
- import { n as evaluateAndApplyPermission } from "../../authorizationDecision-CVlaTjAX.mjs";
3
- import { i as runAdmittedWork, r as registerShutdownParticipant } from "../../shutdown-BCXCwghd.mjs";
1
+ /*! @classytic/arc v2.46.0 | MIT | https://classytic.com */
2
+ import { n as evaluateAndApplyPermission } from "../../authorizationDecision-DeZMrHcm.mjs";
3
+ import { i as runAdmittedWork, r as registerShutdownParticipant } from "../../shutdown-DzLFbe27.mjs";
4
4
  import fp from "fastify-plugin";
5
- //#region src/integrations/jobs/execution.ts
5
+ // src/integrations/jobs/execution.ts
6
6
  async function executeTimedHandler(options) {
7
7
  const { run, label, jobId, timeoutMs, cancelGraceMs = 3e4, logger } = options;
8
8
  let released = false;
@@ -49,8 +49,7 @@ async function executeTimedHandler(options) {
49
49
  clearTimeout(timer);
50
50
  }
51
51
  }
52
- //#endregion
53
- //#region src/integrations/jobs/repeat.ts
52
+ // src/integrations/jobs/repeat.ts
54
53
  /**
55
54
  * Whether an existing schedule matches the currently configured repeat spec.
56
55
  *
@@ -108,8 +107,7 @@ async function removeStaleRepeatSchedulers(queue, jobName, spec, log) {
108
107
  }, `[arc/jobs] Failed to reconcile repeatable schedules for '${jobName}' — continuing (boot-time hygiene only)`);
109
108
  }
110
109
  }
111
- //#endregion
112
- //#region src/integrations/jobs/plugin.ts
110
+ // src/integrations/jobs/plugin.ts
113
111
  var Semaphore = class {
114
112
  available;
115
113
  waiters = [];
@@ -481,8 +479,7 @@ const jobsPlugin = fp(jobsPluginImpl, {
481
479
  name: "arc-jobs",
482
480
  fastify: "5.x"
483
481
  });
484
- //#endregion
485
- //#region src/integrations/jobs/types.ts
482
+ // src/integrations/jobs/types.ts
486
483
  /**
487
484
  * Define a background job with typed data and configuration.
488
485
  *
@@ -499,5 +496,4 @@ const jobsPlugin = fp(jobsPluginImpl, {
499
496
  function defineJob(definition) {
500
497
  return definition;
501
498
  }
502
- //#endregion
503
499
  export { defineJob, executeTimedHandler, jobsPlugin };
@@ -1,15 +1,14 @@
1
1
 
2
- import { i as RequestScope } from "../../types-Ddl9OjmE.mjs";
3
- import { l as PermissionCheck } from "../../base-CZyixEQR.mjs";
4
- import { F as ResourceDefinition, Gn as ServerAccessor, Hn as IRequestContext, Vn as IControllerResponse } from "../../index-WH7xgvxS.mjs";
5
- import { n as FieldPermissionMap } from "../../fields-BBSpf8pS.mjs";
6
- import "../../resourceRateLimit-Wf6d6FL9.mjs";
7
- import { _ as ToolDefinition, a as CrudDescriptionOverride, c as McpAuthResult, d as McpResourceConfig, f as PromptDefinition, g as ToolContext, h as ToolAnnotations, i as CrudDescriptionMeta, l as McpExecutionWiring, m as SessionEntry, n as CallToolResult, o as CrudOperation, p as PromptResult, r as CreateMcpServerConfig, s as McpAuthResolver, t as BetterAuthHandler, u as McpPluginOptions, v as ToolInputSchema } from "../../types-D3Ixsh00.mjs";
8
- import { i as resolveToolCollisions, n as McpServerInstance, r as createMcpServer, t as AuthRef } from "../../createMcpServer-DSztofa9.mjs";
2
+ import { i as RequestScope } from "../../types-DnkIALZ8.mjs";
3
+ import { l as PermissionCheck } from "../../base-HXNgPQww.mjs";
4
+ import { F as ResourceDefinition, Gn as ServerAccessor, Hn as IRequestContext, Vn as IControllerResponse } from "../../index-DyJFTJLA.mjs";
5
+ import { n as FieldPermissionMap } from "../../fields-JTkrtO-r.mjs";
6
+ import "../../resourceRateLimit-DCWglD7V.mjs";
7
+ import { _ as ToolDefinition, a as CrudDescriptionOverride, c as McpAuthResult, d as McpResourceConfig, f as PromptDefinition, g as ToolContext, h as ToolAnnotations, i as CrudDescriptionMeta, l as McpExecutionWiring, m as SessionEntry, n as CallToolResult, o as CrudOperation, p as PromptResult, r as CreateMcpServerConfig, s as McpAuthResolver, t as BetterAuthHandler, u as McpPluginOptions, v as ToolInputSchema } from "../../types-BYEb_dLW.mjs";
8
+ import { i as resolveToolCollisions, n as McpServerInstance, r as createMcpServer, t as AuthRef } from "../../createMcpServer-DeVpqQF-.mjs";
9
9
  import { ErrorContract } from "@classytic/repo-core/errors";
10
10
  import { FastifyPluginAsync } from "fastify";
11
11
  import { z } from "zod";
12
- //#region src/integrations/mcp/aiSdkBridge.d.ts
13
12
  /** Minimal AI SDK tool shape we need to invoke. */
14
13
  interface AiSdkExecutable {
15
14
  execute: (input: unknown, options?: unknown) => Promise<unknown>;
@@ -56,8 +55,6 @@ interface BuildMcpToolsFromBridgesOptions {
56
55
  * ```
57
56
  */
58
57
  export declare function buildMcpToolsFromBridges(bridges: readonly McpBridge[], options?: BuildMcpToolsFromBridgesOptions): ToolDefinition[];
59
- //#endregion
60
- //#region src/integrations/mcp/betterAuthApiKey.d.ts
61
58
  /** Minimal subset of Better Auth's API-key record the helper needs. */
62
59
  interface BetterAuthKeyRecord {
63
60
  id?: string;
@@ -97,8 +94,6 @@ interface CreateMcpAuthFromBetterAuthApiKeyOptions {
97
94
  * Better Auth's API-key plugin. See module docstring for the rationale.
98
95
  */
99
96
  export declare function createMcpAuthFromBetterAuthApiKey(auth: BetterAuthHandler, options?: CreateMcpAuthFromBetterAuthApiKeyOptions): McpAuthResolver;
100
- //#endregion
101
- //#region src/integrations/mcp/buildRequestContext.d.ts
102
97
  type McpOperation = "list" | "get" | "create" | "update" | "delete" | "action";
103
98
  /**
104
99
  * Optional context extras — the pieces of `IRequestContext` that HTTP's
@@ -148,11 +143,7 @@ interface McpContextExtras {
148
143
  * An authenticated session scope is never overwritten.
149
144
  */
150
145
  export declare function buildRequestContext(input: Record<string, unknown>, auth: McpAuthResult | null, operation: McpOperation, policyFilters?: Record<string, unknown>, scopeOverride?: RequestScope, extras?: McpContextExtras): IRequestContext;
151
- //#endregion
152
- //#region src/integrations/mcp/http-parity.d.ts
153
146
  type ToolAdmission = (session: McpAuthResult | null, scope?: RequestScope) => boolean | Promise<boolean>;
154
- //#endregion
155
- //#region src/integrations/mcp/crud-tools.d.ts
156
147
  /**
157
148
  * Default description for a CRUD tool. Enriches list descriptions with the
158
149
  * configured filter/sort metadata so MCP clients can see what's queryable
@@ -175,8 +166,6 @@ export declare function defaultCrudDescription(op: CrudOperation, displayName: s
175
166
  * Falls back to {@link defaultCrudDescription} when no override is set.
176
167
  */
177
168
  export declare function resolveCrudDescription(override: CrudDescriptionOverride | undefined, meta: CrudDescriptionMeta): string;
178
- //#endregion
179
- //#region src/integrations/mcp/definePrompt.d.ts
180
169
  /** definePrompt() config */
181
170
  interface DefinePromptConfig<TArgs extends Record<string, z.ZodTypeAny>> {
182
171
  description: string;
@@ -192,8 +181,6 @@ interface DefinePromptConfig<TArgs extends Record<string, z.ZodTypeAny>> {
192
181
  * @param config - Description, args schema, handler
193
182
  */
194
183
  export declare function definePrompt<TArgs extends Record<string, z.ZodTypeAny>>(name: string, config: DefinePromptConfig<TArgs>): PromptDefinition;
195
- //#endregion
196
- //#region src/integrations/mcp/defineTool.d.ts
197
184
  /**
198
185
  * defineTool() config — uses flat Zod shapes for SDK compatibility.
199
186
  *
@@ -219,8 +206,6 @@ interface DefineToolConfig<TInput extends Record<string, z.ZodTypeAny>, TSession
219
206
  * @param config - Tool description, input schema, annotations, handler
220
207
  */
221
208
  export declare function defineTool<TInput extends Record<string, z.ZodTypeAny>, TSession = McpAuthResult>(name: string, config: DefineToolConfig<TInput, TSession>): ToolDefinition<TSession>;
222
- //#endregion
223
- //#region src/integrations/mcp/fieldRulesToZod.d.ts
224
209
  interface FieldRulesToZodOptions {
225
210
  /** create: required enforced. update: all optional. list: filters + pagination. */
226
211
  mode?: "create" | "update" | "list";
@@ -268,8 +253,6 @@ interface FieldRuleEntry {
268
253
  * @returns Flat shape `Record<string, z.ZodTypeAny>` — pass directly to defineTool() or registerTool()
269
254
  */
270
255
  export declare function fieldRulesToZod(fieldRules: Record<string, FieldRuleEntry> | undefined, options?: FieldRulesToZodOptions): Record<string, z.ZodTypeAny>;
271
- //#endregion
272
- //#region src/integrations/mcp/guards.d.ts
273
256
  /** Check if the tool context has an authenticated user (not anonymous/null) */
274
257
  export declare function isAuthenticated(ctx: ToolContext): boolean;
275
258
  /** Check if the tool context has an organization scope */
@@ -319,8 +302,6 @@ export declare function requireOrgId(orgId: string): McpGuard;
319
302
  * ```
320
303
  */
321
304
  export declare function customGuard(check: (ctx: ToolContext) => boolean | Promise<boolean>, errorMessage: string): McpGuard;
322
- //#endregion
323
- //#region src/integrations/mcp/invokeController.d.ts
324
305
  /**
325
306
  * Options threaded into {@link invokeController}. `session` is required so
326
307
  * permission checks and scope resolution can both honor the caller's
@@ -441,8 +422,6 @@ export declare function invokeController(controller: unknown, op: McpOperation,
441
422
  * ```
442
423
  */
443
424
  export declare function mcpHandlerAdapter<TSession = McpAuthResult>(fn: (input: Record<string, unknown>, ctx: ToolContext<TSession>) => Promise<unknown>): ToolDefinition<TSession>["handler"];
444
- //#endregion
445
- //#region src/integrations/mcp/sessionCache.d.ts
446
425
  declare class McpSessionCache {
447
426
  private sessions;
448
427
  private ttlMs;
@@ -471,8 +450,6 @@ declare class McpSessionCache {
471
450
  /** Safely close a transport */
472
451
  private closeTransport;
473
452
  }
474
- //#endregion
475
- //#region src/integrations/mcp/mcpPlugin.d.ts
476
453
  /**
477
454
  * Per-prefix MCP registration info. A single fastify instance can register
478
455
  * mcpPlugin multiple times under different prefixes (e.g. `/mcp/catalog`,
@@ -531,8 +508,6 @@ export declare function filterResourcesForMcp<T extends {
531
508
  mcp?: boolean;
532
509
  }>(resources: readonly T[], inputs: ResourceFilterInputs): T[];
533
510
  export declare const mcpPlugin: FastifyPluginAsync<McpPluginOptions>;
534
- //#endregion
535
- //#region src/integrations/mcp/realtimeBridge.d.ts
536
511
  /**
537
512
  * Inbound tool-call shape — accepts both LiveKit Agents (`arguments`)
538
513
  * and OpenAI Realtime (`arguments_json` string) variants. Other realtime
@@ -571,8 +546,6 @@ interface DispatchOptions<TSession = unknown> {
571
546
  * responses to the original calls.
572
547
  */
573
548
  export declare function dispatchRealtimeToolCall<TSession = unknown>(tools: readonly ToolDefinition[], calls: readonly RealtimeToolCall[], opts?: DispatchOptions<TSession>): Promise<RealtimeToolResponse[]>;
574
- //#endregion
575
- //#region src/integrations/mcp/resourceToTools.d.ts
576
549
  interface ResourceToToolsConfig extends McpResourceConfig {
577
550
  toolNamePrefix?: string;
578
551
  /** Per-operation tool name overrides: `{ get: 'get_job_by_id' }` */
@@ -599,15 +572,11 @@ interface ResourceToToolsConfig extends McpResourceConfig {
599
572
  * @param config - Optional overrides (operations, descriptions, hideFields, prefix, names)
600
573
  */
601
574
  export declare function resourceToTools(resource: ResourceDefinition, config?: ResourceToToolsConfig): ToolDefinition[];
602
- //#endregion
603
- //#region src/integrations/mcp/route-input-schema.d.ts
604
575
  /**
605
576
  * The field shape a tool advertises — the flat record itself, or a whole object
606
577
  * schema's `.shape`. `undefined` for a union, which has no single shape.
607
578
  */
608
579
  export declare function toolInputShape(schema: ToolInputSchema | undefined): Record<string, z.ZodTypeAny> | undefined;
609
- //#endregion
610
- //#region src/integrations/mcp/tool-helpers.d.ts
611
580
  /**
612
581
  * Convert a controller response envelope into an MCP `CallToolResult`.
613
582
  * Carries `meta` into the serialized payload so consumers see pagination
@@ -658,5 +627,4 @@ export declare function permissionDeniedResult(args: {
658
627
  reason?: string;
659
628
  session: McpAuthResult | null;
660
629
  }): CallToolResult;
661
- //#endregion
662
630
  export { type AuthRef, type BetterAuthHandler, type BuildMcpToolsFromBridgesOptions, type CallToolResult, type CreateMcpAuthFromBetterAuthApiKeyOptions, type CreateMcpServerConfig, type CrudDescriptionMeta, type CrudDescriptionOverride, type CrudOperation, type DefinePromptConfig, type DefineToolConfig, type DispatchOptions, type FieldRuleEntry, type FieldRulesToZodOptions, type InvokeControllerOptions, type McpAuthResolver, type McpAuthResult, type McpBridge, type McpContextExtras, type McpGuard, type McpOperation, type McpPluginOptions, type McpResourceConfig, type McpServerInstance, type PromptDefinition, type PromptResult, type RealtimeToolCall, type RealtimeToolResponse, type ResourceToToolsConfig, type ToolAnnotations, type ToolContext, type ToolDefinition, type ToolInputSchema, createMcpServer, resolveToolCollisions };
@@ -1,6 +1,6 @@
1
- /*! @classytic/arc v2.45.1 | MIT | https://classytic.com */
2
- import { _ as resolveToolCollisions, a as toolInputShape, c as resolveCrudDescription, d as permissionDeniedResult, f as toCallToolError, g as createMcpServer, h as buildRequestContext, i as isZodTypeSchema, l as invokeController, m as toCallToolSuccess, n as mcpPlugin, o as fieldRulesToZod, p as toCallToolResult, r as resourceToTools, s as defaultCrudDescription, t as filterResourcesForMcp, u as mcpHandlerAdapter } from "../../mcpPlugin-DDfe8jAP.mjs";
3
- //#region src/integrations/mcp/defineTool.ts
1
+ /*! @classytic/arc v2.46.0 | MIT | https://classytic.com */
2
+ import { _ as resolveToolCollisions, a as toolInputShape, c as resolveCrudDescription, d as permissionDeniedResult, f as toCallToolError, g as createMcpServer, h as buildRequestContext, i as isZodTypeSchema, l as invokeController, m as toCallToolSuccess, n as mcpPlugin, o as fieldRulesToZod, p as toCallToolResult, r as resourceToTools, s as defaultCrudDescription, t as filterResourcesForMcp, u as mcpHandlerAdapter } from "../../mcpPlugin-yix548XX.mjs";
3
+ // src/integrations/mcp/defineTool.ts
4
4
  /**
5
5
  * Define a type-safe MCP tool.
6
6
  *
@@ -18,8 +18,7 @@ function defineTool(name, config) {
18
18
  handler: config.handler
19
19
  };
20
20
  }
21
- //#endregion
22
- //#region src/integrations/mcp/guards.ts
21
+ // src/integrations/mcp/guards.ts
23
22
  /** Check if the tool context has an authenticated user (not anonymous/null) */
24
23
  function isAuthenticated(ctx) {
25
24
  return !!ctx.session && ctx.session.userId !== "anonymous";
@@ -108,8 +107,7 @@ function customGuard(check, errorMessage) {
108
107
  return await check(ctx) ? null : errorMessage;
109
108
  };
110
109
  }
111
- //#endregion
112
- //#region src/integrations/mcp/aiSdkBridge.ts
110
+ // src/integrations/mcp/aiSdkBridge.ts
113
111
  /** Serialize an AI SDK tool result into MCP's text-content envelope. */
114
112
  function toMcpEnvelope(result) {
115
113
  if (result && typeof result === "object" && "error" in result) {
@@ -167,8 +165,7 @@ function buildMcpToolsFromBridges(bridges, options = {}) {
167
165
  return true;
168
166
  }).map(bridgeToMcp);
169
167
  }
170
- //#endregion
171
- //#region src/integrations/mcp/betterAuthApiKey.ts
168
+ // src/integrations/mcp/betterAuthApiKey.ts
172
169
  /**
173
170
  * Build an {@link McpAuthResolver} that authenticates MCP requests against
174
171
  * Better Auth's API-key plugin. See module docstring for the rationale.
@@ -258,8 +255,7 @@ function parseMetadata(value) {
258
255
  }
259
256
  return value;
260
257
  }
261
- //#endregion
262
- //#region src/integrations/mcp/definePrompt.ts
258
+ // src/integrations/mcp/definePrompt.ts
263
259
  /**
264
260
  * Define a type-safe MCP prompt.
265
261
  *
@@ -275,8 +271,7 @@ function definePrompt(name, config) {
275
271
  handler: config.handler
276
272
  };
277
273
  }
278
- //#endregion
279
- //#region src/integrations/mcp/realtimeBridge.ts
274
+ // src/integrations/mcp/realtimeBridge.ts
280
275
  function isPlainArgs(value) {
281
276
  return value !== null && typeof value === "object" && !Array.isArray(value);
282
277
  }
@@ -390,5 +385,4 @@ function normalizeResult(result) {
390
385
  }
391
386
  return {};
392
387
  }
393
- //#endregion
394
388
  export { bridgeToMcp, buildMcpToolsFromBridges, buildRequestContext, createMcpAuthFromBetterAuthApiKey, createMcpServer, customGuard, defaultCrudDescription, definePrompt, defineTool, denied, dispatchRealtimeToolCall, fieldRulesToZod, filterResourcesForMcp, getOrgId, getUserId, guard, hasOrg, invokeController, isAuthenticated, isOrg, mcpHandlerAdapter, mcpPlugin, permissionDeniedResult, requireAuth, requireOrg, requireOrgId, requireRole, resolveCrudDescription, resolveToolCollisions, resourceToTools, toCallToolError, toCallToolResult, toCallToolSuccess, toolInputShape };
@@ -1,8 +1,7 @@
1
1
 
2
- import { c as McpAuthResult, u as McpPluginOptions } from "../../types-D3Ixsh00.mjs";
3
- import { n as McpServerInstance } from "../../createMcpServer-DSztofa9.mjs";
2
+ import { c as McpAuthResult, u as McpPluginOptions } from "../../types-BYEb_dLW.mjs";
3
+ import { n as McpServerInstance } from "../../createMcpServer-DeVpqQF-.mjs";
4
4
  import { Client } from "@modelcontextprotocol/client";
5
- //#region src/integrations/mcp/testing.d.ts
6
5
  /** An MCP client bound to a live loopback server, plus its teardown. */
7
6
  export interface ConnectedMcpTestClient {
8
7
  /** The connected SDK client — full `listTools` / `callTool` / `listPrompts` surface. */
@@ -68,5 +67,4 @@ export interface TestMcpClient {
68
67
  * await client.close();
69
68
  * ```
70
69
  */
71
- export declare function createTestMcpClient(options?: TestMcpClientOptions): Promise<TestMcpClient>;
72
- //#endregion
70
+ export declare function createTestMcpClient(options?: TestMcpClientOptions): Promise<TestMcpClient>;
@@ -1,6 +1,6 @@
1
- /*! @classytic/arc v2.45.1 | MIT | https://classytic.com */
2
- import { g as createMcpServer, r as resourceToTools, t as filterResourcesForMcp } from "../../mcpPlugin-DDfe8jAP.mjs";
3
- //#region src/integrations/mcp/testing.ts
1
+ /*! @classytic/arc v2.46.0 | MIT | https://classytic.com */
2
+ import { g as createMcpServer, r as resourceToTools, t as filterResourcesForMcp } from "../../mcpPlugin-yix548XX.mjs";
3
+ // src/integrations/mcp/testing.ts
4
4
  /**
5
5
  * Serve an already-built `McpServer` on an ephemeral loopback port and connect
6
6
  * a client to it.
@@ -118,5 +118,4 @@ async function createTestMcpClient(options = {}) {
118
118
  close
119
119
  };
120
120
  }
121
- //#endregion
122
121
  export { connectMcpTestClient, createTestMcpClient };
@@ -1,6 +1,5 @@
1
1
 
2
2
  import { FastifyPluginAsync, FastifyRequest } from "fastify";
3
- //#region src/integrations/streamline.d.ts
4
3
  /**
5
4
  * Start options — matches streamline's `StartOptions`. `tenantId` /
6
5
  * `bypassTenant` must come from auth context (`tenantResolver`), never the
@@ -223,5 +222,4 @@ export declare function isStreamTerminal(eventOrStatus: string, compensates: boo
223
222
  * Streamline integration for Arc. Wrapped in `fastify-plugin` so `prefix` is
224
223
  * a plain option, not an encapsulation prefix (which would apply it twice).
225
224
  */
226
- export declare const streamlinePlugin: FastifyPluginAsync<StreamlinePluginOptions>;
227
- //#endregion
225
+ export declare const streamlinePlugin: FastifyPluginAsync<StreamlinePluginOptions>;
@@ -1,9 +1,9 @@
1
- /*! @classytic/arc v2.45.1 | MIT | https://classytic.com */
2
- import { f as createError, i as NotFoundError, r as ForbiddenError } from "../errors-BtHzrSA6.mjs";
3
- import { a as promoteStreamTokenToHeader, n as forwardedStreamHeaders } from "../streaming-DgUvMWlv.mjs";
1
+ /*! @classytic/arc v2.46.0 | MIT | https://classytic.com */
2
+ import { f as createError, i as NotFoundError, r as ForbiddenError } from "../errors-BY8vzlP4.mjs";
3
+ import { a as promoteStreamTokenToHeader, n as forwardedStreamHeaders } from "../streaming-DvraWW6x.mjs";
4
4
  import { ARC_ERROR_CODES } from "@classytic/repo-core/errors";
5
5
  import fp from "fastify-plugin";
6
- //#region src/integrations/streamline.ts
6
+ // src/integrations/streamline.ts
7
7
  /**
8
8
  * Streamline integration — wires `@classytic/streamline` workflows into arc.
9
9
  *
@@ -482,5 +482,4 @@ const streamlinePlugin = fp(streamlinePluginImpl, {
482
482
  name: "streamline-routes",
483
483
  fastify: "5.x"
484
484
  });
485
- //#endregion
486
485
  export { STREAMLINE_BUS_EVENTS, STREAMLINE_FAILURE_CODES, STREAMLINE_STREAM_EVENTS, STREAMLINE_TERMINAL_EVENTS, TERMINAL_RUN_STATUSES, isStreamTerminal, streamlinePlugin };
@@ -1,9 +1,8 @@
1
1
 
2
- import { a as EventTransport, n as DomainEvent } from "../EventTransport-CiicKz2Z.mjs";
3
- import { i as createOutboxModule, r as OutboxModuleOptions } from "../outbox-module-gZCHoE4H.mjs";
2
+ import { a as EventTransport, n as DomainEvent } from "../EventTransport-CYEoCJGe.mjs";
3
+ import { i as createOutboxModule, r as OutboxModuleOptions } from "../outbox-module-XvUThpqn.mjs";
4
4
  import { FastifyPluginAsync } from "fastify";
5
5
  import { OutboxFailurePolicy, OutboxStore } from "@classytic/primitives/outbox";
6
- //#region src/integrations/webhooks.d.ts
7
6
  export interface WebhookSubscription {
8
7
  /** Unique subscription ID */
9
8
  id: string;
@@ -310,5 +309,4 @@ export interface DurableWebhookModuleOptions extends Omit<OutboxModuleOptions, "
310
309
  * subscription store (boot-checked).
311
310
  */
312
311
  export declare function createDurableWebhookModule(options: DurableWebhookModuleOptions): ReturnType<typeof createOutboxModule>;
313
- //#endregion
314
312
  export { _default as default, webhookPlugin };
@@ -1,10 +1,10 @@
1
- /*! @classytic/arc v2.45.1 | MIT | https://classytic.com */
2
- import { n as declareRuntimeCapability } from "../runtimeCapabilities-D_3eUO6V.mjs";
3
- import { i as exponentialBackoff, t as createOutboxModule } from "../outbox-module-DF4Bu_Qa.mjs";
1
+ /*! @classytic/arc v2.46.0 | MIT | https://classytic.com */
2
+ import { n as declareRuntimeCapability } from "../runtimeCapabilities-DWqbxkyw.mjs";
3
+ import { i as exponentialBackoff, t as createOutboxModule } from "../outbox-module-mg9kDYkd.mjs";
4
4
  import { createHmac, timingSafeEqual } from "node:crypto";
5
5
  import fp from "fastify-plugin";
6
6
  import { createChildEvent, matchEventPattern } from "@classytic/primitives/events";
7
- //#region src/integrations/webhooks.ts
7
+ // src/integrations/webhooks.ts
8
8
  /**
9
9
  * Outbound webhooks — auto-dispatch arc events to registered endpoints with
10
10
  * HMAC-SHA256 signing, delivery logging, and a pluggable `WebhookStore`.
@@ -496,5 +496,4 @@ function assertWebhookHeaderOverrides(headers) {
496
496
  const reserved = Object.keys(headers).find((name) => RESERVED_WEBHOOK_HEADERS.has(name.toLowerCase()));
497
497
  if (reserved) throw new WebhookDeliveryError(`webhook authentication header '${reserved}' is reserved`, { transient: false });
498
498
  }
499
- //#endregion
500
499
  export { WEBHOOK_DELIVERY_EVENT, WebhookDeliveryError, createDurableWebhookModule, createWebhookDeliveryTransport, webhooks_default as default, defaultWebhookUrlPolicy, signWebhook, verifySignature, verifyWebhook, webhookDeliveryFailurePolicy, webhookPlugin };