@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.
- package/dist/{DocsViewerServiceProvider-qFCaeiUv.js → DocsViewerServiceProvider-D2cuVgtN.js} +7 -12
- package/dist/{Hash-C8aejmi8.js → Hash-D2DFd8xX.js} +7 -57
- package/dist/{HttpException-BkS3euNG.js → HttpException-BlQ2yEmT.js} +2 -79
- package/dist/{Job-BVT813DO.js → Job-DxQK8h3P.js} +24 -179
- package/dist/{McpServiceProvider-BawsYjgN.js → McpServiceProvider-Zihx3Bjq.js} +35 -20
- package/dist/{Random-DbIJ22KQ.js → Random-S0OvCuR8.js} +9 -106
- package/dist/agent/AgentApprovalRequested.d.ts +11 -39
- package/dist/agent/approval-status.d.ts +56 -0
- package/dist/agent/approval.d.ts +76 -187
- package/dist/agent/audit-emitter.d.ts +16 -44
- package/dist/agent/audit.d.ts +20 -56
- package/dist/agent/derive.d.ts +32 -66
- package/dist/agent/dispatch.d.ts +38 -90
- package/dist/agent/events.d.ts +17 -23
- package/dist/agent/gate.d.ts +118 -0
- package/dist/agent/meta-tools.d.ts +18 -46
- package/dist/agent/pipeline.d.ts +234 -0
- package/dist/agent/public.d.ts +6 -25
- package/dist/agent/public.js +1 -1
- package/dist/agent/redact.d.ts +16 -38
- package/dist/agent/scopes.d.ts +55 -69
- package/dist/auth/AgentPrincipalGuard.d.ts +49 -0
- package/dist/auth/AuthManager.d.ts +22 -43
- package/dist/auth/AuthenticatableModel.d.ts +2 -2
- package/dist/auth/SessionGuard.d.ts +0 -1
- package/dist/auth/TokenGuard.d.ts +6 -26
- package/dist/auth/api-token.d.ts +16 -148
- package/dist/auth/context.d.ts +5 -10
- package/dist/auth/email-verification.d.ts +29 -127
- package/dist/auth/index.js +1 -1
- package/dist/auth/oauth/index.d.ts +35 -57
- package/dist/auth/password/DefaultHasher.d.ts +5 -14
- package/dist/auth/password/PasswordHasher.d.ts +5 -13
- package/dist/auth/password/hash-format.d.ts +5 -13
- package/dist/auth/password-reset.d.ts +16 -42
- package/dist/auth/providers/ModelUserProvider.d.ts +3 -4
- package/dist/auth/providers/UserProvider.d.ts +4 -4
- package/dist/auth/signed-token.d.ts +18 -0
- package/dist/auth/types.d.ts +9 -32
- package/dist/auth/utils.d.ts +6 -27
- package/dist/{auth-DkYoAPVn.js → auth-Gg54ppQi.js} +279 -519
- package/dist/authorization/Gate.d.ts +9 -145
- package/dist/authorization/Policy.d.ts +6 -53
- package/dist/authorization/index.js +1 -1
- package/dist/authorization/middleware.d.ts +16 -62
- package/dist/authorization/types.d.ts +8 -64
- package/dist/{authorization-CdfbCj8J.js → authorization-CdEWZZw3.js} +44 -309
- package/dist/broadcasting/BroadcastManager.d.ts +29 -149
- package/dist/broadcasting/channels/Channel.d.ts +1 -19
- package/dist/broadcasting/channels/PresenceChannel.d.ts +1 -55
- package/dist/broadcasting/channels/PrivateChannel.d.ts +1 -23
- package/dist/broadcasting/drivers/MemoryDriver.d.ts +18 -70
- package/dist/broadcasting/drivers/RedisDriver.d.ts +3 -80
- package/dist/broadcasting/drivers/index.d.ts +1 -1
- package/dist/broadcasting/index.d.ts +1 -1
- package/dist/broadcasting/index.js +1 -1
- package/dist/broadcasting/types.d.ts +7 -88
- package/dist/{broadcasting-BwodCA4q.js → broadcasting-B5RzB0A2.js} +87 -414
- package/dist/cache/CacheManager.d.ts +8 -62
- package/dist/cache/TaggedCache.d.ts +2 -35
- package/dist/cache/index.js +1 -1
- package/dist/cache/stores/FileStore.d.ts +2 -36
- package/dist/cache/stores/MemoryStore.d.ts +2 -26
- package/dist/cache/stores/RedisStore.d.ts +1 -29
- package/dist/cache/types.d.ts +21 -128
- package/dist/{cache-BYnZf2FR.js → cache-BOOIr324.js} +19 -198
- package/dist/client-C4TEr_Dd.js +9 -0
- package/dist/console/Command.d.ts +17 -126
- package/dist/console/ConsoleKernel.d.ts +2 -74
- package/dist/console/Input.d.ts +5 -113
- package/dist/console/Output.d.ts +3 -99
- package/dist/console/types.d.ts +3 -33
- package/dist/container/Container.d.ts +12 -103
- package/dist/container/ServiceProvider.d.ts +17 -61
- package/dist/container/bindings.d.ts +5 -26
- package/dist/container/defineModule.d.ts +16 -54
- package/dist/container/definePlugin.d.ts +12 -45
- package/dist/container/types.d.ts +2 -34
- package/dist/context-CXk_umpT.js +21 -0
- package/dist/database/Factory.d.ts +4 -57
- package/dist/database/Seeder.d.ts +8 -46
- package/dist/database/SeederRunner.d.ts +3 -33
- package/dist/database/types.d.ts +3 -24
- package/dist/discovery/AutoDiscovery.d.ts +10 -82
- package/dist/{dispatch-erOS9epZ.js → dispatch-BAwzftws.js} +32 -79
- package/dist/docs-viewer/DocsViewerServiceProvider.d.ts +2 -5
- package/dist/docs-viewer/endpoint.d.ts +5 -11
- package/dist/encryption/Encrypter.d.ts +5 -71
- package/dist/encryption/Hash.d.ts +7 -57
- package/dist/encryption/Random.d.ts +6 -99
- package/dist/encryption/index.js +3 -3
- package/dist/encryption/types.d.ts +10 -72
- package/dist/{encryption-D99Vmls3.js → encryption-uwP3Di4D.js} +9 -78
- package/dist/{endpoint-D6GIqOpe.js → endpoint-BXipU2Jj.js} +6 -12
- package/dist/endpoint-Dsw3Acvq.js +26 -0
- package/dist/errors/ExceptionHandler.d.ts +3 -90
- package/dist/errors/HttpException.d.ts +2 -79
- package/dist/errors/debug-page.d.ts +3 -17
- package/dist/errors/error-page.d.ts +1 -0
- package/dist/errors/exceptions/AuthenticationException.d.ts +2 -24
- package/dist/errors/exceptions/AuthorizationException.d.ts +1 -24
- package/dist/errors/exceptions/MethodNotAllowedException.d.ts +1 -23
- package/dist/errors/exceptions/NotFoundHttpException.d.ts +1 -27
- package/dist/errors/exceptions/ValidationException.d.ts +2 -43
- package/dist/errors/types.d.ts +1 -25
- package/dist/{errors-BgeOl_DC.js → errors-JpkcCjjn.js} +3 -41
- package/dist/events/Event.d.ts +1 -28
- package/dist/events/EventManager.d.ts +5 -107
- package/dist/events/Listener.d.ts +7 -55
- package/dist/events/builtin.d.ts +0 -24
- package/dist/events/index.js +1 -1
- package/dist/events/types.d.ts +4 -22
- package/dist/{events-aIH_bWRx.js → events-DOmAHDeP.js} +11 -191
- package/dist/facades/index.d.ts +2 -14
- package/dist/health/HealthCheck.d.ts +0 -24
- package/dist/health/HealthManager.d.ts +0 -36
- package/dist/health/checks/CacheCheck.d.ts +2 -17
- package/dist/health/checks/CustomCheck.d.ts +0 -9
- package/dist/health/checks/DatabaseCheck.d.ts +2 -17
- package/dist/health/checks/MemoryCheck.d.ts +3 -12
- package/dist/health/checks/RedisCheck.d.ts +1 -13
- package/dist/health/checks/StorageCheck.d.ts +2 -17
- package/dist/health/index.js +1 -1
- package/dist/health/types.d.ts +4 -24
- package/dist/{health-VWdWXRwh.js → health-DQSvUplL.js} +1 -76
- package/dist/hot-disposables-B5BXqaIH.js +167 -0
- package/dist/hot-reload/hot-disposables.d.ts +22 -74
- package/dist/hot-reload/testing.d.ts +4 -9
- package/dist/http/Application.d.ts +77 -205
- package/dist/http/FormRequest.d.ts +4 -55
- package/dist/http/dev-assets.d.ts +13 -31
- package/dist/http/dev-banner.d.ts +2 -5
- package/dist/http/inertia-assets.d.ts +3 -6
- package/dist/http/middleware/capabilities.d.ts +27 -50
- package/dist/http/middleware/cors.d.ts +4 -29
- package/dist/http/middleware/csp.d.ts +2 -25
- package/dist/http/middleware/csrf.d.ts +28 -95
- package/dist/http/middleware/detect-locale.d.ts +7 -27
- package/dist/http/middleware/force-https.d.ts +6 -24
- package/dist/http/middleware/host-authorization.d.ts +2 -12
- package/dist/http/middleware/index.d.ts +1 -1
- package/dist/http/middleware/loopback-guard.d.ts +15 -33
- package/dist/http/middleware/rate-limit.d.ts +29 -126
- package/dist/http/middleware/redirect-safety.d.ts +2 -20
- package/dist/http/middleware/request-id.d.ts +1 -14
- package/dist/http/middleware/request-logging.d.ts +2 -13
- package/dist/http/middleware/response-headers.d.ts +5 -13
- package/dist/http/middleware/security-headers.d.ts +2 -16
- package/dist/http/middleware/session.d.ts +15 -34
- package/dist/http/middleware/validation-errors-cookie.d.ts +7 -18
- package/dist/http/middleware/validation.d.ts +8 -63
- package/dist/http/public-assets.d.ts +11 -7
- package/dist/http/request.d.ts +32 -118
- package/dist/http/resources/CursorPaginator.d.ts +5 -64
- package/dist/http/resources/Paginator.d.ts +7 -84
- package/dist/http/resources/Resource.d.ts +9 -65
- package/dist/http/resources/ResourceCollection.d.ts +5 -39
- package/dist/http/resources/types.d.ts +10 -30
- package/dist/http/static-documents.d.ts +10 -20
- package/dist/http/validation/Validator.d.ts +25 -85
- package/dist/http/validation/rules.d.ts +48 -147
- package/dist/http/validation/types.d.ts +16 -61
- package/dist/http/vite-assets.d.ts +5 -28
- package/dist/http/vite-dev-server.d.ts +6 -9
- package/dist/http/vite-manifest.d.ts +19 -33
- package/dist/i18n/I18nManager.d.ts +12 -78
- package/dist/i18n/Translator.d.ts +3 -54
- package/dist/i18n/index.js +1 -1
- package/dist/i18n/loaders/JsonLoader.d.ts +4 -31
- package/dist/i18n/loaders/MemoryLoader.d.ts +1 -21
- package/dist/i18n/pluralization.d.ts +4 -13
- package/dist/i18n/types.d.ts +17 -69
- package/dist/{i18n-mcWi7LCd.js → i18n-Cg1aajRP.js} +31 -225
- package/dist/index.d.ts +11 -4
- package/dist/index.js +1186 -3040
- package/dist/internal/agent-preflight.d.ts +9 -21
- package/dist/internal/agent-principal.d.ts +32 -0
- package/dist/internal/request.d.ts +6 -19
- package/dist/internal/request.js +1 -1
- package/dist/internal/route-path.d.ts +9 -21
- package/dist/internal/route-path.js +9 -21
- package/dist/internal/zod-compat.d.ts +55 -122
- package/dist/internal/zod-compat.js +39 -70
- package/dist/internal/zod-json-schema.d.ts +18 -54
- package/dist/internal/zod-json-schema.js +46 -123
- package/dist/jsx-runtime.d.ts +3 -8
- package/dist/lambda/index.d.ts +17 -79
- package/dist/lambda/index.js +11 -59
- package/dist/logging/LogManager.d.ts +1 -51
- package/dist/logging/Logger.d.ts +8 -47
- package/dist/logging/channels/ConsoleChannel.d.ts +1 -3
- package/dist/logging/channels/DailyFileChannel.d.ts +1 -3
- package/dist/logging/channels/FileChannel.d.ts +1 -3
- package/dist/logging/daily-file-path.d.ts +7 -16
- package/dist/logging/index.js +1 -1
- package/dist/logging/types.d.ts +13 -45
- package/dist/{logging-B-kngi3q.js → logging-zOY1XCtq.js} +52 -141
- package/dist/{loopback-guard-D0Kc7-xc.js → loopback-guard-DT9gHF0F.js} +41 -92
- package/dist/mail/Mail.d.ts +10 -106
- package/dist/mail/MailManager.d.ts +2 -60
- package/dist/mail/index.js +1 -1
- package/dist/mail/transports/LogTransport.d.ts +1 -4
- package/dist/mail/transports/MemoryTransport.d.ts +1 -63
- package/dist/mail/transports/ResendTransport.d.ts +1 -23
- package/dist/mail/transports/SmtpTransport.d.ts +1 -31
- package/dist/mail/types.d.ts +28 -150
- package/dist/{mail-DfEfSQEr.js → mail-76DWy9lj.js} +31 -289
- package/dist/mcp/McpServiceProvider.d.ts +4 -10
- package/dist/mcp/create-mcp-server.d.ts +42 -57
- package/dist/mcp/endpoint.d.ts +12 -36
- package/dist/mcp/index.js +1 -1
- package/dist/mvc/Controller.d.ts +46 -227
- package/dist/mvc/Router.d.ts +50 -129
- package/dist/mvc/inertia/InertiaEngine.d.ts +18 -48
- package/dist/mvc/inertia/shared.d.ts +6 -19
- package/dist/mvc/mount-route.d.ts +2 -6
- package/dist/mvc/view.d.ts +1 -2
- package/dist/notifications/Notification.d.ts +8 -75
- package/dist/notifications/NotificationManager.d.ts +15 -88
- package/dist/notifications/channels/DatabaseChannel.d.ts +1 -41
- package/dist/notifications/channels/MailChannel.d.ts +2 -31
- package/dist/notifications/channels/MemoryChannel.d.ts +2 -62
- package/dist/notifications/channels/SlackChannel.d.ts +3 -48
- package/dist/notifications/index.js +1 -1
- package/dist/notifications/notifiable-type.d.ts +3 -6
- package/dist/notifications/registry.d.ts +8 -27
- package/dist/notifications/types.d.ts +16 -53
- package/dist/{notifications-BGqmUNZ8.js → notifications-okWFs9ly.js} +37 -335
- package/dist/providers/AuthServiceProvider.d.ts +1 -3
- package/dist/providers/AuthorizationServiceProvider.d.ts +2 -3
- package/dist/providers/BroadcastServiceProvider.d.ts +1 -3
- package/dist/providers/CacheServiceProvider.d.ts +1 -3
- package/dist/providers/EncryptionServiceProvider.d.ts +1 -3
- package/dist/providers/ErrorServiceProvider.d.ts +1 -4
- package/dist/providers/EventServiceProvider.d.ts +1 -3
- package/dist/providers/HealthServiceProvider.d.ts +1 -3
- package/dist/providers/I18nServiceProvider.d.ts +6 -10
- package/dist/providers/InertiaServiceProvider.d.ts +1 -4
- package/dist/providers/LogServiceProvider.d.ts +1 -3
- package/dist/providers/MailServiceProvider.d.ts +1 -3
- package/dist/providers/NotificationServiceProvider.d.ts +1 -3
- package/dist/providers/OAuthServiceProvider.d.ts +1 -3
- package/dist/providers/QueueServiceProvider.d.ts +1 -3
- package/dist/providers/SchedulingServiceProvider.d.ts +1 -3
- package/dist/providers/StorageServiceProvider.d.ts +1 -3
- package/dist/queue/FailedJobReporter.d.ts +1 -24
- package/dist/queue/Job.d.ts +12 -99
- package/dist/queue/QueueManager.d.ts +6 -57
- package/dist/queue/Worker.d.ts +4 -65
- package/dist/queue/drivers/MemoryDriver.d.ts +3 -44
- package/dist/queue/drivers/RedisDriver.d.ts +7 -65
- package/dist/queue/drivers/SqsDriver.d.ts +6 -57
- package/dist/queue/drivers/SyncDriver.d.ts +10 -13
- package/dist/queue/index.js +2 -2
- package/dist/queue/types.d.ts +10 -92
- package/dist/{queue-CXrRK85G.js → queue-CcXCjuJI.js} +32 -260
- package/dist/redis/RedisApiTokenStore.d.ts +4 -56
- package/dist/redis/RedisEmailVerificationStore.d.ts +4 -37
- package/dist/redis/RedisOAuthStateStore.d.ts +2 -10
- package/dist/redis/RedisPasswordResetStore.d.ts +4 -37
- package/dist/redis/RedisRateLimitStore.d.ts +16 -49
- package/dist/redis/RedisSessionStore.d.ts +3 -44
- package/dist/redis/client.d.ts +2 -32
- package/dist/redis/index.js +47 -232
- package/dist/redis/redis-values.d.ts +6 -12
- package/dist/redis/scan-keys.d.ts +1 -4
- package/dist/request-CLOYytGP.js +68 -0
- package/dist/runtime/index.d.ts +2 -0
- package/dist/runtime/index.js +50 -92
- package/dist/scheduling/CronParser.d.ts +0 -29
- package/dist/scheduling/Schedule.d.ts +1 -153
- package/dist/scheduling/ScheduledTask.d.ts +0 -31
- package/dist/scheduling/Scheduler.d.ts +0 -70
- package/dist/scheduling/index.js +1 -1
- package/dist/scheduling/types.d.ts +4 -65
- package/dist/{scheduling-CPiEdtQd.js → scheduling-C6tcOtUl.js} +2 -287
- package/dist/storage/StorageManager.d.ts +0 -48
- package/dist/storage/drivers/LocalDriver.d.ts +1 -25
- package/dist/storage/drivers/MemoryDriver.d.ts +5 -35
- package/dist/storage/drivers/S3Driver.d.ts +6 -36
- package/dist/storage/drivers/s3-acl.d.ts +5 -10
- package/dist/storage/index.js +1 -1
- package/dist/storage/types.d.ts +27 -265
- package/dist/{storage-TLD9t0Q2.js → storage-BB59f07j.js} +17 -157
- package/dist/support/contained-path.d.ts +10 -20
- package/dist/support/error-polyfill.d.ts +4 -6
- package/dist/support/expiry.d.ts +17 -33
- package/dist/support/expiry.js +17 -33
- package/dist/support/import-map.d.ts +3 -7
- package/dist/support/inertia-defaults.d.ts +5 -10
- package/dist/support/redirect-target.d.ts +4 -6
- package/dist/support/stack-frames.d.ts +11 -50
- package/dist/support/trim-slashes.d.ts +4 -7
- package/dist/support/warn-once.d.ts +2 -6
- package/dist/{trim-slashes-ZJ_VsY5s.js → trim-slashes-BLY9hKAa.js} +4 -7
- package/dist/{vite-manifest-w_RSOvQW.js → vite-manifest-B_Iy5183.js} +34 -58
- package/package.json +2 -2
- package/dist/client-Dd7vLcqp.js +0 -27
- package/dist/context-DoD0c7J_.js +0 -26
- package/dist/endpoint-D-20PiHY.js +0 -46
- package/dist/hot-disposables-WsTX2ySN.js +0 -281
- 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-
|
|
3
|
-
import { n as createMcpAccessGuard, r as isMcpEndpointEnabled, t as MCP_ENDPOINT_PATH } from "./endpoint-
|
|
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
|
-
*
|
|
15
|
-
*
|
|
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`.
|
|
234
|
-
*
|
|
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
|
|
405
|
-
*
|
|
406
|
-
*
|
|
407
|
-
*
|
|
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
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
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
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
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 —
|
|
43
|
-
*
|
|
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
|
-
*
|
|
53
|
-
*
|
|
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;
|