@guren/server 2.15.0 → 2.17.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 (302) hide show
  1. package/dist/{DocsViewerServiceProvider-qFCaeiUv.js → DocsViewerServiceProvider-D2cuVgtN.js} +7 -12
  2. package/dist/{Hash-C8aejmi8.js → Hash-D2DFd8xX.js} +7 -57
  3. package/dist/{HttpException-BkS3euNG.js → HttpException-BlQ2yEmT.js} +2 -79
  4. package/dist/{Job-BVT813DO.js → Job-DxQK8h3P.js} +24 -179
  5. package/dist/{McpServiceProvider-BawsYjgN.js → McpServiceProvider-Zihx3Bjq.js} +35 -20
  6. package/dist/{Random-DbIJ22KQ.js → Random-S0OvCuR8.js} +9 -106
  7. package/dist/agent/AgentApprovalRequested.d.ts +11 -39
  8. package/dist/agent/approval-status.d.ts +56 -0
  9. package/dist/agent/approval.d.ts +76 -187
  10. package/dist/agent/audit-emitter.d.ts +16 -44
  11. package/dist/agent/audit.d.ts +20 -56
  12. package/dist/agent/derive.d.ts +32 -66
  13. package/dist/agent/dispatch.d.ts +38 -90
  14. package/dist/agent/events.d.ts +17 -23
  15. package/dist/agent/gate.d.ts +118 -0
  16. package/dist/agent/meta-tools.d.ts +18 -46
  17. package/dist/agent/pipeline.d.ts +234 -0
  18. package/dist/agent/public.d.ts +6 -25
  19. package/dist/agent/public.js +1 -1
  20. package/dist/agent/redact.d.ts +16 -38
  21. package/dist/agent/scopes.d.ts +55 -69
  22. package/dist/auth/AgentPrincipalGuard.d.ts +49 -0
  23. package/dist/auth/AuthManager.d.ts +22 -43
  24. package/dist/auth/AuthenticatableModel.d.ts +2 -2
  25. package/dist/auth/SessionGuard.d.ts +0 -1
  26. package/dist/auth/TokenGuard.d.ts +6 -26
  27. package/dist/auth/api-token.d.ts +16 -148
  28. package/dist/auth/context.d.ts +5 -10
  29. package/dist/auth/email-verification.d.ts +29 -127
  30. package/dist/auth/index.js +1 -1
  31. package/dist/auth/oauth/index.d.ts +35 -57
  32. package/dist/auth/password/DefaultHasher.d.ts +5 -14
  33. package/dist/auth/password/PasswordHasher.d.ts +5 -13
  34. package/dist/auth/password/hash-format.d.ts +5 -13
  35. package/dist/auth/password-reset.d.ts +16 -42
  36. package/dist/auth/providers/ModelUserProvider.d.ts +3 -4
  37. package/dist/auth/providers/UserProvider.d.ts +4 -4
  38. package/dist/auth/signed-token.d.ts +18 -0
  39. package/dist/auth/types.d.ts +9 -32
  40. package/dist/auth/utils.d.ts +6 -27
  41. package/dist/{auth-DkYoAPVn.js → auth-Gg54ppQi.js} +279 -519
  42. package/dist/authorization/Gate.d.ts +9 -145
  43. package/dist/authorization/Policy.d.ts +6 -53
  44. package/dist/authorization/index.js +1 -1
  45. package/dist/authorization/middleware.d.ts +16 -62
  46. package/dist/authorization/types.d.ts +8 -64
  47. package/dist/{authorization-CdfbCj8J.js → authorization-CdEWZZw3.js} +44 -309
  48. package/dist/broadcasting/BroadcastManager.d.ts +29 -149
  49. package/dist/broadcasting/channels/Channel.d.ts +1 -19
  50. package/dist/broadcasting/channels/PresenceChannel.d.ts +1 -55
  51. package/dist/broadcasting/channels/PrivateChannel.d.ts +1 -23
  52. package/dist/broadcasting/drivers/MemoryDriver.d.ts +18 -70
  53. package/dist/broadcasting/drivers/RedisDriver.d.ts +3 -80
  54. package/dist/broadcasting/drivers/index.d.ts +1 -1
  55. package/dist/broadcasting/index.d.ts +1 -1
  56. package/dist/broadcasting/index.js +1 -1
  57. package/dist/broadcasting/types.d.ts +7 -88
  58. package/dist/{broadcasting-BwodCA4q.js → broadcasting-B5RzB0A2.js} +87 -414
  59. package/dist/cache/CacheManager.d.ts +8 -62
  60. package/dist/cache/TaggedCache.d.ts +2 -35
  61. package/dist/cache/index.js +1 -1
  62. package/dist/cache/stores/FileStore.d.ts +2 -36
  63. package/dist/cache/stores/MemoryStore.d.ts +2 -26
  64. package/dist/cache/stores/RedisStore.d.ts +1 -29
  65. package/dist/cache/types.d.ts +21 -128
  66. package/dist/{cache-BYnZf2FR.js → cache-BOOIr324.js} +19 -198
  67. package/dist/client-C4TEr_Dd.js +9 -0
  68. package/dist/console/Command.d.ts +17 -126
  69. package/dist/console/ConsoleKernel.d.ts +2 -74
  70. package/dist/console/Input.d.ts +5 -113
  71. package/dist/console/Output.d.ts +3 -99
  72. package/dist/console/types.d.ts +3 -33
  73. package/dist/container/Container.d.ts +12 -103
  74. package/dist/container/ServiceProvider.d.ts +17 -61
  75. package/dist/container/bindings.d.ts +5 -26
  76. package/dist/container/defineModule.d.ts +16 -54
  77. package/dist/container/definePlugin.d.ts +12 -45
  78. package/dist/container/types.d.ts +2 -34
  79. package/dist/context-CXk_umpT.js +21 -0
  80. package/dist/database/Factory.d.ts +4 -57
  81. package/dist/database/Seeder.d.ts +8 -46
  82. package/dist/database/SeederRunner.d.ts +3 -33
  83. package/dist/database/types.d.ts +3 -24
  84. package/dist/discovery/AutoDiscovery.d.ts +10 -82
  85. package/dist/{dispatch-erOS9epZ.js → dispatch-BAwzftws.js} +32 -79
  86. package/dist/docs-viewer/DocsViewerServiceProvider.d.ts +2 -5
  87. package/dist/docs-viewer/endpoint.d.ts +5 -11
  88. package/dist/encryption/Encrypter.d.ts +5 -71
  89. package/dist/encryption/Hash.d.ts +7 -57
  90. package/dist/encryption/Random.d.ts +6 -99
  91. package/dist/encryption/index.js +3 -3
  92. package/dist/encryption/types.d.ts +10 -72
  93. package/dist/{encryption-D99Vmls3.js → encryption-uwP3Di4D.js} +9 -78
  94. package/dist/{endpoint-D6GIqOpe.js → endpoint-BXipU2Jj.js} +6 -12
  95. package/dist/endpoint-Dsw3Acvq.js +26 -0
  96. package/dist/errors/ExceptionHandler.d.ts +3 -90
  97. package/dist/errors/HttpException.d.ts +2 -79
  98. package/dist/errors/debug-page.d.ts +3 -17
  99. package/dist/errors/error-page.d.ts +1 -0
  100. package/dist/errors/exceptions/AuthenticationException.d.ts +2 -24
  101. package/dist/errors/exceptions/AuthorizationException.d.ts +1 -24
  102. package/dist/errors/exceptions/MethodNotAllowedException.d.ts +1 -23
  103. package/dist/errors/exceptions/NotFoundHttpException.d.ts +1 -27
  104. package/dist/errors/exceptions/ValidationException.d.ts +2 -43
  105. package/dist/errors/types.d.ts +1 -25
  106. package/dist/{errors-BgeOl_DC.js → errors-JpkcCjjn.js} +3 -41
  107. package/dist/events/Event.d.ts +1 -28
  108. package/dist/events/EventManager.d.ts +5 -107
  109. package/dist/events/Listener.d.ts +7 -55
  110. package/dist/events/builtin.d.ts +0 -24
  111. package/dist/events/index.js +1 -1
  112. package/dist/events/types.d.ts +4 -22
  113. package/dist/{events-aIH_bWRx.js → events-DOmAHDeP.js} +11 -191
  114. package/dist/facades/index.d.ts +2 -14
  115. package/dist/health/HealthCheck.d.ts +0 -24
  116. package/dist/health/HealthManager.d.ts +0 -36
  117. package/dist/health/checks/CacheCheck.d.ts +2 -17
  118. package/dist/health/checks/CustomCheck.d.ts +0 -9
  119. package/dist/health/checks/DatabaseCheck.d.ts +2 -17
  120. package/dist/health/checks/MemoryCheck.d.ts +3 -12
  121. package/dist/health/checks/RedisCheck.d.ts +1 -13
  122. package/dist/health/checks/StorageCheck.d.ts +2 -17
  123. package/dist/health/index.js +1 -1
  124. package/dist/health/types.d.ts +4 -24
  125. package/dist/{health-VWdWXRwh.js → health-DQSvUplL.js} +1 -76
  126. package/dist/hot-disposables-B5BXqaIH.js +167 -0
  127. package/dist/hot-reload/hot-disposables.d.ts +22 -74
  128. package/dist/hot-reload/testing.d.ts +4 -9
  129. package/dist/http/Application.d.ts +77 -205
  130. package/dist/http/FormRequest.d.ts +4 -55
  131. package/dist/http/dev-assets.d.ts +13 -31
  132. package/dist/http/dev-banner.d.ts +2 -5
  133. package/dist/http/inertia-assets.d.ts +3 -6
  134. package/dist/http/middleware/capabilities.d.ts +27 -50
  135. package/dist/http/middleware/cors.d.ts +4 -29
  136. package/dist/http/middleware/csp.d.ts +2 -25
  137. package/dist/http/middleware/csrf.d.ts +28 -95
  138. package/dist/http/middleware/detect-locale.d.ts +7 -27
  139. package/dist/http/middleware/force-https.d.ts +6 -24
  140. package/dist/http/middleware/host-authorization.d.ts +2 -12
  141. package/dist/http/middleware/index.d.ts +1 -1
  142. package/dist/http/middleware/loopback-guard.d.ts +15 -33
  143. package/dist/http/middleware/rate-limit.d.ts +29 -126
  144. package/dist/http/middleware/redirect-safety.d.ts +2 -20
  145. package/dist/http/middleware/request-id.d.ts +1 -14
  146. package/dist/http/middleware/request-logging.d.ts +2 -13
  147. package/dist/http/middleware/response-headers.d.ts +5 -13
  148. package/dist/http/middleware/security-headers.d.ts +2 -16
  149. package/dist/http/middleware/session.d.ts +15 -34
  150. package/dist/http/middleware/validation-errors-cookie.d.ts +7 -18
  151. package/dist/http/middleware/validation.d.ts +8 -63
  152. package/dist/http/public-assets.d.ts +11 -7
  153. package/dist/http/request.d.ts +32 -118
  154. package/dist/http/resources/CursorPaginator.d.ts +5 -64
  155. package/dist/http/resources/Paginator.d.ts +7 -84
  156. package/dist/http/resources/Resource.d.ts +9 -65
  157. package/dist/http/resources/ResourceCollection.d.ts +5 -39
  158. package/dist/http/resources/types.d.ts +10 -30
  159. package/dist/http/static-documents.d.ts +10 -20
  160. package/dist/http/validation/Validator.d.ts +25 -85
  161. package/dist/http/validation/rules.d.ts +48 -147
  162. package/dist/http/validation/types.d.ts +16 -61
  163. package/dist/http/vite-assets.d.ts +5 -28
  164. package/dist/http/vite-dev-server.d.ts +6 -9
  165. package/dist/http/vite-manifest.d.ts +19 -33
  166. package/dist/i18n/I18nManager.d.ts +12 -78
  167. package/dist/i18n/Translator.d.ts +3 -54
  168. package/dist/i18n/index.js +1 -1
  169. package/dist/i18n/loaders/JsonLoader.d.ts +4 -31
  170. package/dist/i18n/loaders/MemoryLoader.d.ts +1 -21
  171. package/dist/i18n/pluralization.d.ts +4 -13
  172. package/dist/i18n/types.d.ts +17 -69
  173. package/dist/{i18n-mcWi7LCd.js → i18n-Cg1aajRP.js} +31 -225
  174. package/dist/index.d.ts +11 -4
  175. package/dist/index.js +1186 -3040
  176. package/dist/internal/agent-preflight.d.ts +9 -21
  177. package/dist/internal/agent-principal.d.ts +32 -0
  178. package/dist/internal/request.d.ts +6 -19
  179. package/dist/internal/request.js +1 -1
  180. package/dist/internal/route-path.d.ts +9 -21
  181. package/dist/internal/route-path.js +9 -21
  182. package/dist/internal/zod-compat.d.ts +55 -122
  183. package/dist/internal/zod-compat.js +39 -70
  184. package/dist/internal/zod-json-schema.d.ts +18 -54
  185. package/dist/internal/zod-json-schema.js +46 -123
  186. package/dist/jsx-runtime.d.ts +3 -8
  187. package/dist/lambda/index.d.ts +17 -79
  188. package/dist/lambda/index.js +11 -59
  189. package/dist/logging/LogManager.d.ts +1 -51
  190. package/dist/logging/Logger.d.ts +8 -47
  191. package/dist/logging/channels/ConsoleChannel.d.ts +1 -3
  192. package/dist/logging/channels/DailyFileChannel.d.ts +1 -3
  193. package/dist/logging/channels/FileChannel.d.ts +1 -3
  194. package/dist/logging/daily-file-path.d.ts +7 -16
  195. package/dist/logging/index.js +1 -1
  196. package/dist/logging/types.d.ts +13 -45
  197. package/dist/{logging-B-kngi3q.js → logging-zOY1XCtq.js} +52 -141
  198. package/dist/{loopback-guard-D0Kc7-xc.js → loopback-guard-DT9gHF0F.js} +41 -92
  199. package/dist/mail/Mail.d.ts +10 -106
  200. package/dist/mail/MailManager.d.ts +2 -60
  201. package/dist/mail/index.js +1 -1
  202. package/dist/mail/transports/LogTransport.d.ts +1 -4
  203. package/dist/mail/transports/MemoryTransport.d.ts +1 -63
  204. package/dist/mail/transports/ResendTransport.d.ts +1 -23
  205. package/dist/mail/transports/SmtpTransport.d.ts +1 -31
  206. package/dist/mail/types.d.ts +28 -150
  207. package/dist/{mail-DfEfSQEr.js → mail-76DWy9lj.js} +31 -289
  208. package/dist/mcp/McpServiceProvider.d.ts +4 -10
  209. package/dist/mcp/create-mcp-server.d.ts +42 -57
  210. package/dist/mcp/endpoint.d.ts +12 -36
  211. package/dist/mcp/index.js +1 -1
  212. package/dist/mvc/Controller.d.ts +46 -227
  213. package/dist/mvc/Router.d.ts +50 -129
  214. package/dist/mvc/inertia/InertiaEngine.d.ts +18 -48
  215. package/dist/mvc/inertia/shared.d.ts +6 -19
  216. package/dist/mvc/mount-route.d.ts +2 -6
  217. package/dist/mvc/view.d.ts +1 -2
  218. package/dist/notifications/Notification.d.ts +8 -75
  219. package/dist/notifications/NotificationManager.d.ts +15 -88
  220. package/dist/notifications/channels/DatabaseChannel.d.ts +1 -41
  221. package/dist/notifications/channels/MailChannel.d.ts +2 -31
  222. package/dist/notifications/channels/MemoryChannel.d.ts +2 -62
  223. package/dist/notifications/channels/SlackChannel.d.ts +3 -48
  224. package/dist/notifications/index.js +1 -1
  225. package/dist/notifications/notifiable-type.d.ts +3 -6
  226. package/dist/notifications/registry.d.ts +8 -27
  227. package/dist/notifications/types.d.ts +16 -53
  228. package/dist/{notifications-BGqmUNZ8.js → notifications-okWFs9ly.js} +37 -335
  229. package/dist/providers/AuthServiceProvider.d.ts +1 -3
  230. package/dist/providers/AuthorizationServiceProvider.d.ts +2 -3
  231. package/dist/providers/BroadcastServiceProvider.d.ts +1 -3
  232. package/dist/providers/CacheServiceProvider.d.ts +1 -3
  233. package/dist/providers/EncryptionServiceProvider.d.ts +1 -3
  234. package/dist/providers/ErrorServiceProvider.d.ts +1 -4
  235. package/dist/providers/EventServiceProvider.d.ts +1 -3
  236. package/dist/providers/HealthServiceProvider.d.ts +1 -3
  237. package/dist/providers/I18nServiceProvider.d.ts +6 -10
  238. package/dist/providers/InertiaServiceProvider.d.ts +1 -4
  239. package/dist/providers/LogServiceProvider.d.ts +1 -3
  240. package/dist/providers/MailServiceProvider.d.ts +1 -3
  241. package/dist/providers/NotificationServiceProvider.d.ts +1 -3
  242. package/dist/providers/OAuthServiceProvider.d.ts +1 -3
  243. package/dist/providers/QueueServiceProvider.d.ts +1 -3
  244. package/dist/providers/SchedulingServiceProvider.d.ts +1 -3
  245. package/dist/providers/StorageServiceProvider.d.ts +1 -3
  246. package/dist/queue/FailedJobReporter.d.ts +1 -24
  247. package/dist/queue/Job.d.ts +12 -99
  248. package/dist/queue/QueueManager.d.ts +6 -57
  249. package/dist/queue/Worker.d.ts +4 -65
  250. package/dist/queue/drivers/MemoryDriver.d.ts +3 -44
  251. package/dist/queue/drivers/RedisDriver.d.ts +7 -65
  252. package/dist/queue/drivers/SqsDriver.d.ts +6 -57
  253. package/dist/queue/drivers/SyncDriver.d.ts +10 -13
  254. package/dist/queue/index.js +2 -2
  255. package/dist/queue/types.d.ts +10 -92
  256. package/dist/{queue-CXrRK85G.js → queue-CcXCjuJI.js} +32 -260
  257. package/dist/redis/RedisApiTokenStore.d.ts +4 -56
  258. package/dist/redis/RedisEmailVerificationStore.d.ts +4 -37
  259. package/dist/redis/RedisOAuthStateStore.d.ts +2 -10
  260. package/dist/redis/RedisPasswordResetStore.d.ts +4 -37
  261. package/dist/redis/RedisRateLimitStore.d.ts +16 -49
  262. package/dist/redis/RedisSessionStore.d.ts +3 -44
  263. package/dist/redis/client.d.ts +2 -32
  264. package/dist/redis/index.js +47 -232
  265. package/dist/redis/redis-values.d.ts +6 -12
  266. package/dist/redis/scan-keys.d.ts +1 -4
  267. package/dist/request-CLOYytGP.js +68 -0
  268. package/dist/runtime/index.d.ts +2 -0
  269. package/dist/runtime/index.js +50 -92
  270. package/dist/scheduling/CronParser.d.ts +0 -29
  271. package/dist/scheduling/Schedule.d.ts +1 -153
  272. package/dist/scheduling/ScheduledTask.d.ts +0 -31
  273. package/dist/scheduling/Scheduler.d.ts +0 -70
  274. package/dist/scheduling/index.js +1 -1
  275. package/dist/scheduling/types.d.ts +4 -65
  276. package/dist/{scheduling-CPiEdtQd.js → scheduling-C6tcOtUl.js} +2 -287
  277. package/dist/storage/StorageManager.d.ts +0 -48
  278. package/dist/storage/drivers/LocalDriver.d.ts +1 -25
  279. package/dist/storage/drivers/MemoryDriver.d.ts +5 -35
  280. package/dist/storage/drivers/S3Driver.d.ts +6 -36
  281. package/dist/storage/drivers/s3-acl.d.ts +5 -10
  282. package/dist/storage/index.js +1 -1
  283. package/dist/storage/types.d.ts +27 -265
  284. package/dist/{storage-TLD9t0Q2.js → storage-BB59f07j.js} +17 -157
  285. package/dist/support/contained-path.d.ts +10 -20
  286. package/dist/support/error-polyfill.d.ts +4 -6
  287. package/dist/support/expiry.d.ts +17 -33
  288. package/dist/support/expiry.js +17 -33
  289. package/dist/support/import-map.d.ts +3 -7
  290. package/dist/support/inertia-defaults.d.ts +5 -10
  291. package/dist/support/redirect-target.d.ts +4 -6
  292. package/dist/support/stack-frames.d.ts +11 -50
  293. package/dist/support/trim-slashes.d.ts +4 -7
  294. package/dist/support/warn-once.d.ts +2 -6
  295. package/dist/{trim-slashes-ZJ_VsY5s.js → trim-slashes-BLY9hKAa.js} +4 -7
  296. package/dist/{vite-manifest-w_RSOvQW.js → vite-manifest-B_Iy5183.js} +34 -58
  297. package/package.json +2 -2
  298. package/dist/client-Dd7vLcqp.js +0 -27
  299. package/dist/context-DoD0c7J_.js +0 -26
  300. package/dist/endpoint-D-20PiHY.js +0 -46
  301. package/dist/hot-disposables-WsTX2ySN.js +0 -281
  302. package/dist/request-CVQwpu2J.js +0 -129
@@ -1,6 +1,6 @@
1
1
  import { t as __exportAll } from "./rolldown-runtime-B4FMCO8f.js";
2
- import { r as ServiceProvider } from "./loopback-guard-D0Kc7-xc.js";
3
- import { n as createMcpAccessGuard, r as isMcpEndpointEnabled, t as MCP_ENDPOINT_PATH } from "./endpoint-D-20PiHY.js";
2
+ import { r as ServiceProvider } from "./loopback-guard-DT9gHF0F.js";
3
+ import { n as createMcpAccessGuard, r as isMcpEndpointEnabled, t as MCP_ENDPOINT_PATH } from "./endpoint-Dsw3Acvq.js";
4
4
  import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
5
5
  import { z } from "zod";
6
6
  //#region src/mcp/create-mcp-server.ts
@@ -10,10 +10,9 @@ function isAgentRoute(route) {
10
10
  return typeof method === "string" && typeof path === "string" && typeof agent === "object" && agent !== null;
11
11
  }
12
12
  /**
13
- * One tool as an agent editing the app should see it. Annotations are
14
- * reported **as declared**, with no defaults filled in: the derivation layer
15
- * owns the GET/QUERY → readOnlyHint rule, and restating it here would be a
16
- * second copy of it that can disagree.
13
+ * One tool as an agent editing the app should see it. Annotations are reported
14
+ * **as declared**, no defaults filled in: the derivation layer owns the
15
+ * GET/QUERY → readOnlyHint rule, and a second copy here could disagree.
17
16
  */
18
17
  function describeAgentRoute(route) {
19
18
  const { agent } = route;
@@ -128,6 +127,30 @@ function createMcpServer(options) {
128
127
  text: JSON.stringify(report, null, 2)
129
128
  }] };
130
129
  });
130
+ server.tool("guren_gate", "Run every verification stage the scaffolded CI runs (codegen, typecheck, lint, check, audit, test) and report each; `ok` is the one verdict on whether the change is done. A stage that cannot run fails rather than skips.", {
131
+ changed: z.boolean().default(false).describe("Narrow check and lint to files changed vs. the merge base with main"),
132
+ deps: z.boolean().default(false).describe("Scan dependencies in the audit stage (needs registry access)")
133
+ }, async ({ changed, deps }) => {
134
+ if (!cli.runGate) return {
135
+ content: [{
136
+ type: "text",
137
+ text: "guren_gate needs a @guren/cli that ships `guren gate`; upgrade the app (bunx guren upgrade)."
138
+ }],
139
+ isError: true
140
+ };
141
+ const report = await cli.runGate({
142
+ cwd,
143
+ changed,
144
+ deps
145
+ });
146
+ return {
147
+ content: [{
148
+ type: "text",
149
+ text: JSON.stringify(report, null, 2)
150
+ }],
151
+ isError: !report.ok
152
+ };
153
+ });
131
154
  server.tool("guren_list_models", "List all models with their table names, relationships, authentication trait, and soft deletes status.", {}, async () => {
132
155
  const models = await cli.listModels({ appRoot: cwd });
133
156
  return { content: [{
@@ -230,10 +253,8 @@ function createMcpServer(options) {
230
253
  let failed = false;
231
254
  /**
232
255
  * Runs one generator and files its artifacts under `generated` or
233
- * `skipped`. A generator that returns an empty `outputPath` had
234
- * nothing to describe, which is a normal shape for a project rather
235
- * than a failure; a throw is the opposite, and is what `isError`
236
- * reports on.
256
+ * `skipped`. An empty `outputPath` is a normal project shape, not a
257
+ * failure; a throw is, and is what `isError` reports on.
237
258
  */
238
259
  const run = async (artifacts, generate) => {
239
260
  try {
@@ -401,16 +422,10 @@ function createMcpServer(options) {
401
422
  //#region src/mcp/McpServiceProvider.ts
402
423
  var McpServiceProvider_exports = /* @__PURE__ */ __exportAll({ McpServiceProvider: () => McpServiceProvider });
403
424
  /**
404
- * Registers the MCP (Model Context Protocol) endpoint at /_guren/mcp.
405
- *
406
- * Only active while `isMcpEndpointEnabled()` holds, so registering this
407
- * provider directly honours the same `GUREN_MCP=1` opt-in that `Application`
408
- * gates on — and the same condition that exempts the endpoint from CSRF.
409
- * It allows AI coding agents (Claude Code, Cursor, etc.) to introspect
410
- * the project structure, run integrity checks, and scaffold code.
411
- *
412
- * @guren/cli is loaded via dynamic import to avoid circular dependencies
413
- * (@guren/server -> @guren/cli -> @guren/core -> @guren/server).
425
+ * Registers the MCP endpoint at /_guren/mcp, so AI coding agents can introspect
426
+ * the project, run integrity checks, and scaffold code. Only active while
427
+ * `isMcpEndpointEnabled()` holds — the same `GUREN_MCP=1` opt-in that exempts
428
+ * the endpoint from CSRF. @guren/cli is imported dynamically to break a cycle.
414
429
  */
415
430
  var McpServiceProvider = class extends ServiceProvider {
416
431
  register() {}
@@ -1,8 +1,5 @@
1
1
  import { randomBytes, randomInt, randomUUID } from "crypto";
2
2
  //#region src/encryption/Random.ts
3
- /**
4
- * Character sets for random string generation.
5
- */
6
3
  const CHARSETS = {
7
4
  alphanumeric: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789",
8
5
  alphabetic: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",
@@ -12,10 +9,9 @@ const CHARSETS = {
12
9
  "url-safe": "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_"
13
10
  };
14
11
  /**
15
- * Map random bytes onto a character set without modulo bias: bytes that fall
16
- * into the truncated remainder of the 0-255 range are discarded and redrawn,
17
- * so every character stays equally likely (a plain `byte % chars.length`
18
- * skews toward the front of the set whenever 256 is not a multiple of it).
12
+ * Maps random bytes onto a character set without modulo bias: bytes above the
13
+ * largest multiple of `chars.length` under 256 are discarded and redrawn, so
14
+ * every character stays equally likely.
19
15
  */
20
16
  function unbiasedRandomChars(length, chars) {
21
17
  if (!Number.isInteger(length) || length < 0) throw new RangeError(`Random string length must be a non-negative integer, received ${length}.`);
@@ -31,90 +27,35 @@ function unbiasedRandomChars(length, chars) {
31
27
  }
32
28
  return result;
33
29
  }
34
- /**
35
- * Generate a cryptographically secure random string.
36
- *
37
- * @example
38
- * ```typescript
39
- * randomString(32) // 32-character alphanumeric string
40
- * randomString(16, { charset: 'hex' }) // 16-character hex string
41
- * randomString(24, { charset: 'url-safe' }) // URL-safe string
42
- * ```
43
- */
30
+ /** Cryptographically secure random string. */
44
31
  function randomString(length, options = {}) {
45
32
  const { charset = "alphanumeric" } = options;
46
33
  return unbiasedRandomChars(length, CHARSETS[charset]);
47
34
  }
48
- /**
49
- * Generate random bytes.
50
- *
51
- * @example
52
- * ```typescript
53
- * const bytes = random(32) // 32 random bytes
54
- * ```
55
- */
35
+ /** Cryptographically secure random bytes. */
56
36
  function random(length) {
57
37
  return randomBytes(length);
58
38
  }
59
- /**
60
- * Generate random bytes as hex string.
61
- */
62
39
  function randomHex(length) {
63
40
  return randomBytes(length).toString("hex");
64
41
  }
65
- /**
66
- * Generate random bytes as base64 string.
67
- */
68
42
  function randomBase64(length) {
69
43
  return randomBytes(length).toString("base64");
70
44
  }
71
- /**
72
- * Generate random bytes as URL-safe base64 string.
73
- */
74
45
  function randomBase64Url(length) {
75
46
  return randomBytes(length).toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
76
47
  }
77
- /**
78
- * Generate a UUID v4.
79
- *
80
- * @example
81
- * ```typescript
82
- * const id = uuid() // e.g., '550e8400-e29b-41d4-a716-446655440000'
83
- * ```
84
- */
85
48
  function uuid() {
86
49
  return randomUUID();
87
50
  }
88
- /**
89
- * Generate a secure random integer.
90
- *
91
- * @example
92
- * ```typescript
93
- * randomInt(1, 100) // Random number between 1 and 100 (inclusive)
94
- * ```
95
- */
51
+ /** Secure random integer in `[min, max]` — `max` is inclusive. */
96
52
  function randomInt$1(min, max) {
97
53
  return randomInt(min, max + 1);
98
54
  }
99
- /**
100
- * Generate a random token suitable for URLs.
101
- *
102
- * @example
103
- * ```typescript
104
- * const token = urlSafeToken(32) // URL-safe 32-character token
105
- * ```
106
- */
55
+ /** URL-safe token of exactly `length` characters. */
107
56
  function urlSafeToken(length = 32) {
108
57
  return randomBase64Url(Math.ceil(length * .75)).slice(0, length);
109
58
  }
110
- /**
111
- * Generate a secure random password.
112
- *
113
- * @example
114
- * ```typescript
115
- * const password = generatePassword(16) // Random 16-character password
116
- * ```
117
- */
118
59
  function generatePassword(length = 16, options = {}) {
119
60
  const { uppercase = true, lowercase = true, numbers = true, symbols = true } = options;
120
61
  let chars = "";
@@ -125,36 +66,14 @@ function generatePassword(length = 16, options = {}) {
125
66
  if (chars.length === 0) chars = CHARSETS.alphanumeric;
126
67
  return unbiasedRandomChars(length, chars);
127
68
  }
128
- /**
129
- * Generate a random OTP (One-Time Password).
130
- *
131
- * @example
132
- * ```typescript
133
- * const otp = generateOtp(6) // e.g., '482901'
134
- * ```
135
- */
69
+ /** One-time password. */
136
70
  function generateOtp(length = 6) {
137
71
  return randomString(length, { charset: "numeric" });
138
72
  }
139
- /**
140
- * Generate a random slug-friendly string.
141
- *
142
- * @example
143
- * ```typescript
144
- * const slug = generateSlug() // e.g., 'a8b2c4d6e8'
145
- * ```
146
- */
147
73
  function generateSlug(length = 10) {
148
74
  return randomString(length, { charset: "hex" });
149
75
  }
150
- /**
151
- * Shuffle an array using Fisher-Yates algorithm with secure random.
152
- *
153
- * @example
154
- * ```typescript
155
- * const shuffled = shuffle([1, 2, 3, 4, 5])
156
- * ```
157
- */
76
+ /** Fisher-Yates, drawing from the secure source. */
158
77
  function shuffle(array) {
159
78
  const result = [...array];
160
79
  for (let i = result.length - 1; i > 0; i--) {
@@ -163,26 +82,10 @@ function shuffle(array) {
163
82
  }
164
83
  return result;
165
84
  }
166
- /**
167
- * Pick a random element from an array.
168
- *
169
- * @example
170
- * ```typescript
171
- * const item = pick(['a', 'b', 'c']) // Random element
172
- * ```
173
- */
174
85
  function pick(array) {
175
86
  if (array.length === 0) throw new Error("Cannot pick from empty array.");
176
87
  return array[randomInt$1(0, array.length - 1)];
177
88
  }
178
- /**
179
- * Pick multiple random elements from an array.
180
- *
181
- * @example
182
- * ```typescript
183
- * const items = sample(['a', 'b', 'c', 'd'], 2) // Two random elements
184
- * ```
185
- */
186
89
  function sample(array, count) {
187
90
  if (count > array.length) throw new Error("Sample count exceeds array length.");
188
91
  return shuffle(array).slice(0, count);
@@ -2,35 +2,11 @@
2
2
  * The notification an application sends its approvers when an agent tool call
3
3
  * becomes a pending approval request (RFC 0016 §5.4 item 4).
4
4
  *
5
- * A ready-made {@link Notification} rather than a message the adapter composes,
6
- * so "notify approvers through the existing notifications system" is one line
7
- * in an application's configuration:
8
- *
9
- * ```typescript
10
- * mcpPlugin({
11
- * approvals: {
12
- * store,
13
- * notify: (request) => notifications.sendToMany(admins, new AgentApprovalRequested(request)),
14
- * },
15
- * })
16
- * ```
17
- *
18
- * **Who the approvers are is never the framework's decision**, which is why
19
- * this class takes a request and not a recipient. The plugin hands the request
20
- * over; the application picks who hears about it, over which channels, with
21
- * whatever escalation it already has. An adapter that chose recipients would be
22
- * choosing them from a list it cannot see.
23
- *
24
- * Deliberately in its own module, and deliberately not imported by
25
- * `approval.ts`: the store interface and its derivations stay declaration-only
26
- * and free of the notifications subsystem, so a runtime that never notifies
27
- * never pulls it into the graph.
28
- *
29
- * Not queued (`shouldQueue` stays false). An approval request is answered by a
30
- * human in the next few minutes or it expires, and a queue worker that is
31
- * behind — or absent, which is the common case in the small deployments this
32
- * endpoint targets — turns "notify approvers" into "notify approvers
33
- * eventually", after the window closed.
5
+ * Takes a request, not a recipient: who the approvers are is never the
6
+ * framework's decision. Deliberately unimported by `approval.ts`, so a runtime
7
+ * that never notifies does not pull the notifications subsystem into its graph.
8
+ * Not queued (`shouldQueue` stays false): an approval is answered within minutes
9
+ * or expires, and a worker that is behind notifies after the window closed.
34
10
  */
35
11
  import { Notification } from '../notifications/Notification.js';
36
12
  import type { Notifiable, NotificationMailMessage, SlackMessage } from '../notifications/types.js';
@@ -39,20 +15,16 @@ export declare class AgentApprovalRequested extends Notification {
39
15
  readonly request: AgentApprovalRequest;
40
16
  constructor(request: AgentApprovalRequest);
41
17
  /**
42
- * Mail and database by default — the two channels an application configures
43
- * first, and the pair that covers "tell someone now" and "there is a list of
44
- * things waiting". An application overrides by subclassing, exactly as it
45
- * would for any other notification.
18
+ * Mail and database by default — "tell someone now" and "there is a list of
19
+ * things waiting". An application overrides by subclassing.
46
20
  */
47
21
  via(_notifiable: Notifiable): string[];
48
22
  toMail(_notifiable: Notifiable): NotificationMailMessage;
49
23
  /**
50
- * The record's own fields, minus the fingerprint.
51
- *
52
- * The fingerprint is a hash of the *raw* arguments (see `approval.ts`), and
53
- * a database notification is read by more people, and kept longer, than the
54
- * approval store itself. It decides nothing an approver looks at: the
55
- * arguments they judge are `input`, already masked.
24
+ * The record's own fields, minus the fingerprint: that is a hash of the *raw*
25
+ * arguments (see `approval.ts`), while a database notification is read by
26
+ * more people and kept longer. The arguments an approver judges are `input`,
27
+ * already masked.
56
28
  */
57
29
  toDatabase(_notifiable: Notifiable): Record<string, unknown>;
58
30
  toSlack(_notifiable: Notifiable): SlackMessage;
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Reading one approval record as an answer for the caller that asked
3
+ * (RFC 0016 §5.4 item 4). Pure derivation, like `approval.ts`: no store, no
4
+ * clock, no protocol.
5
+ *
6
+ * Here rather than in an adapter because two surfaces answer this question —
7
+ * `guren.approval_status` over MCP and a durable agent's own status check
8
+ * (RFC 0017 §5) — and a record one of them calls "approved" must not be one
9
+ * the other hides.
10
+ */
11
+ import { type AgentApprovalRequest } from './approval.js';
12
+ import type { AgentPrincipal } from './events.js';
13
+ /** One answer about one request. */
14
+ export interface ApprovalStatusReport {
15
+ [key: string]: unknown;
16
+ requestId: string;
17
+ status: string;
18
+ tool: string;
19
+ requestedAt: string;
20
+ expiresAt: string;
21
+ executed: false;
22
+ resolvedAt?: string;
23
+ resolvedBy?: string;
24
+ /**
25
+ * When the approval was spent, if it has been. An approved record carrying
26
+ * this authorizes nothing further — the one call it permitted has run, and
27
+ * repeating that call files a fresh request rather than reusing this one.
28
+ */
29
+ consumedAt?: string;
30
+ }
31
+ /**
32
+ * The one message for "there is no such request *for you*". One function for
33
+ * both branches because an unknown id and another principal's id must be the
34
+ * same answer byte for byte: any difference turns the check into a way to
35
+ * enumerate other principals' pending actions. The audit trail is where the
36
+ * distinction is kept, for the operator.
37
+ */
38
+ export declare function approvalStatusNotFoundMessage(requestId: string): string;
39
+ export type ApprovalStatusOutcome = {
40
+ report: ApprovalStatusReport;
41
+ }
42
+ /**
43
+ * Unknown, or not this caller's — one answer to the caller. `foreign` is the
44
+ * half the *operator* gets: it rides beside the message, for the audit event,
45
+ * and must never reach the result.
46
+ */
47
+ | {
48
+ notFound: string;
49
+ foreign: boolean;
50
+ };
51
+ /**
52
+ * Read a stored record as an answer for `principal` at `now`. `record === null`
53
+ * and "not visible to this principal" converge here rather than at two call
54
+ * sites, so their sameness is structural.
55
+ */
56
+ export declare function toApprovalStatusReport(requestId: string, record: AgentApprovalRequest | null, principal: AgentPrincipal | null, now: Date): ApprovalStatusOutcome;