@mastra/auth-cloud 1.2.0 → 1.2.1-alpha.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 (33) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/dist/_types/@internal_auth/dist/_types/@internal_core/dist/base/index.d.ts +31 -0
  3. package/dist/_types/@internal_auth/dist/_types/@internal_core/dist/logger/index.d.ts +217 -0
  4. package/dist/_types/@internal_auth/dist/ee/capabilities.d.ts +142 -0
  5. package/dist/_types/@internal_auth/dist/ee/defaults/index.d.ts +8 -0
  6. package/dist/_types/@internal_auth/dist/ee/defaults/rbac/index.d.ts +7 -0
  7. package/dist/_types/@internal_auth/dist/ee/defaults/rbac/static.d.ts +106 -0
  8. package/dist/_types/@internal_auth/dist/ee/defaults/roles.d.ts +92 -0
  9. package/dist/_types/@internal_auth/dist/ee/fga-check.d.ts +62 -0
  10. package/dist/_types/@internal_auth/dist/ee/index.d.ts +15 -0
  11. package/dist/_types/@internal_auth/dist/ee/interfaces/acl.d.ts +140 -0
  12. package/dist/_types/@internal_auth/dist/ee/interfaces/fga.d.ts +350 -0
  13. package/dist/_types/@internal_auth/dist/ee/interfaces/index.d.ts +15 -0
  14. package/dist/_types/@internal_auth/dist/ee/interfaces/permissions.generated.d.ts +519 -0
  15. package/dist/_types/@internal_auth/dist/ee/interfaces/rbac.d.ts +207 -0
  16. package/dist/_types/@internal_auth/dist/ee/interfaces/user.d.ts +18 -0
  17. package/dist/_types/@internal_auth/dist/ee/license.d.ts +171 -0
  18. package/dist/_types/@internal_auth/dist/index.d.ts +277 -0
  19. package/dist/_types/@internal_auth/dist/provider/index.d.ts +125 -0
  20. package/dist/_types/@internal_auth/dist/session/cookie.d.ts +82 -0
  21. package/dist/_types/@internal_auth/dist/session/index.d.ts +30 -0
  22. package/dist/_types/@internal_auth/dist/session/memory.d.ts +60 -0
  23. package/dist/_types/@internal_auth/dist/types/index.d.ts +52 -0
  24. package/dist/auth-provider.d.ts +4 -4
  25. package/dist/auth-provider.d.ts.map +1 -1
  26. package/dist/index.cjs +301 -9
  27. package/dist/index.cjs.map +1 -1
  28. package/dist/index.js +296 -4
  29. package/dist/index.js.map +1 -1
  30. package/dist/rbac/rbac-provider.d.ts +1 -1
  31. package/dist/rbac/rbac-provider.d.ts.map +1 -1
  32. package/package.json +6 -6
  33. package/LICENSE.md +0 -30
@@ -0,0 +1,519 @@
1
+ /**
2
+ * AUTO-GENERATED FILE - DO NOT EDIT DIRECTLY
3
+ *
4
+ * This file is generated by packages/server/scripts/generate-permissions.ts
5
+ * Run `pnpm generate:permissions` from packages/server to regenerate.
6
+ *
7
+ * Source of truth: SERVER_ROUTES in @mastra/server
8
+ */
9
+ /**
10
+ * All known API resources.
11
+ * Derived from SERVER_ROUTES paths in @mastra/server.
12
+ */
13
+ export declare const RESOURCES: readonly ["a2a", "agent-builder", "agents", "auth", "background-tasks", "channels", "datasets", "embedders", "experiments", "harness", "infrastructure", "logs", "mcp", "memory", "observability", "processor-providers", "processors", "schedules", "scores", "stored-agents", "stored-mcp-clients", "stored-prompt-blocks", "stored-scorers", "stored-skills", "stored-workspaces", "system", "tool-providers", "tools", "vector", "vectors", "workflows", "workspaces"];
14
+ /**
15
+ * Resource type union.
16
+ */
17
+ export type Resource = (typeof RESOURCES)[number];
18
+ /**
19
+ * All permission actions.
20
+ * Derived from HTTP methods and route overrides:
21
+ * - GET → read
22
+ * - POST → write or execute (context-dependent)
23
+ * - PUT/PATCH → write
24
+ * - DELETE → delete
25
+ * - Additional actions from explicit requiresPermission overrides
26
+ */
27
+ export declare const ACTIONS: readonly ["create", "delete", "execute", "publish", "read", "share", "write"];
28
+ /**
29
+ * Action type union.
30
+ */
31
+ export type Action = (typeof ACTIONS)[number];
32
+ /**
33
+ * All valid permission patterns.
34
+ * Use `keyof typeof PERMISSION_PATTERNS` or the `PermissionPattern` type.
35
+ */
36
+ export declare const PERMISSION_PATTERNS: {
37
+ /** Full access to all resources and actions */
38
+ readonly '*': "*";
39
+ /** Create all resources */
40
+ readonly '*:create': "*:create";
41
+ /** Delete all resources */
42
+ readonly '*:delete': "*:delete";
43
+ /** Execute all resources */
44
+ readonly '*:execute': "*:execute";
45
+ /** Publish, activate, or restore all resources */
46
+ readonly '*:publish': "*:publish";
47
+ /** View all resources */
48
+ readonly '*:read': "*:read";
49
+ /** Change visibility/audience all resources */
50
+ readonly '*:share': "*:share";
51
+ /** Create and modify all resources */
52
+ readonly '*:write': "*:write";
53
+ /** Full access to agent-to-agent communication */
54
+ readonly 'a2a:*': "a2a:*";
55
+ /** Full access to agent builder */
56
+ readonly 'agent-builder:*': "agent-builder:*";
57
+ /** Full access to agents */
58
+ readonly 'agents:*': "agents:*";
59
+ /** Full access to auth */
60
+ readonly 'auth:*': "auth:*";
61
+ /** Full access to background tasks */
62
+ readonly 'background-tasks:*': "background-tasks:*";
63
+ /** Full access to channels */
64
+ readonly 'channels:*': "channels:*";
65
+ /** Full access to datasets */
66
+ readonly 'datasets:*': "datasets:*";
67
+ /** Full access to embedders */
68
+ readonly 'embedders:*': "embedders:*";
69
+ /** Full access to experiments */
70
+ readonly 'experiments:*': "experiments:*";
71
+ /** Full access to harness sessions */
72
+ readonly 'harness:*': "harness:*";
73
+ /** Full access to infrastructure */
74
+ readonly 'infrastructure:*': "infrastructure:*";
75
+ /** Full access to logs */
76
+ readonly 'logs:*': "logs:*";
77
+ /** Full access to MCP servers */
78
+ readonly 'mcp:*': "mcp:*";
79
+ /** Full access to memory and threads */
80
+ readonly 'memory:*': "memory:*";
81
+ /** Full access to traces and spans */
82
+ readonly 'observability:*': "observability:*";
83
+ /** Full access to processor-providers */
84
+ readonly 'processor-providers:*': "processor-providers:*";
85
+ /** Full access to processors */
86
+ readonly 'processors:*': "processors:*";
87
+ /** Full access to schedules */
88
+ readonly 'schedules:*': "schedules:*";
89
+ /** Full access to evaluation scores */
90
+ readonly 'scores:*': "scores:*";
91
+ /** Full access to stored agents */
92
+ readonly 'stored-agents:*': "stored-agents:*";
93
+ /** Full access to stored MCP clients */
94
+ readonly 'stored-mcp-clients:*': "stored-mcp-clients:*";
95
+ /** Full access to stored prompt blocks */
96
+ readonly 'stored-prompt-blocks:*': "stored-prompt-blocks:*";
97
+ /** Full access to stored scorers */
98
+ readonly 'stored-scorers:*': "stored-scorers:*";
99
+ /** Full access to stored skills */
100
+ readonly 'stored-skills:*': "stored-skills:*";
101
+ /** Full access to stored workspaces */
102
+ readonly 'stored-workspaces:*': "stored-workspaces:*";
103
+ /** Full access to system info */
104
+ readonly 'system:*': "system:*";
105
+ /** Full access to tool-providers */
106
+ readonly 'tool-providers:*': "tool-providers:*";
107
+ /** Full access to tools */
108
+ readonly 'tools:*': "tools:*";
109
+ /** Full access to vector stores */
110
+ readonly 'vector:*': "vector:*";
111
+ /** Full access to vectors */
112
+ readonly 'vectors:*': "vectors:*";
113
+ /** Full access to workflows */
114
+ readonly 'workflows:*': "workflows:*";
115
+ /** Full access to workspaces */
116
+ readonly 'workspaces:*': "workspaces:*";
117
+ /** View agent-to-agent communication */
118
+ readonly 'a2a:read': "a2a:read";
119
+ /** Create and modify agent-to-agent communication */
120
+ readonly 'a2a:write': "a2a:write";
121
+ /** Execute agent builder */
122
+ readonly 'agent-builder:execute': "agent-builder:execute";
123
+ /** View agent builder */
124
+ readonly 'agent-builder:read': "agent-builder:read";
125
+ /** Create and modify agent builder */
126
+ readonly 'agent-builder:write': "agent-builder:write";
127
+ /** Create agents */
128
+ readonly 'agents:create': "agents:create";
129
+ /** Delete agents */
130
+ readonly 'agents:delete': "agents:delete";
131
+ /** Execute agents */
132
+ readonly 'agents:execute': "agents:execute";
133
+ /** View agents */
134
+ readonly 'agents:read': "agents:read";
135
+ /** Create and modify agents */
136
+ readonly 'agents:write': "agents:write";
137
+ /** View auth */
138
+ readonly 'auth:read': "auth:read";
139
+ /** View background tasks */
140
+ readonly 'background-tasks:read': "background-tasks:read";
141
+ /** View channels */
142
+ readonly 'channels:read': "channels:read";
143
+ /** Create and modify channels */
144
+ readonly 'channels:write': "channels:write";
145
+ /** Delete datasets */
146
+ readonly 'datasets:delete': "datasets:delete";
147
+ /** Execute datasets */
148
+ readonly 'datasets:execute': "datasets:execute";
149
+ /** View datasets */
150
+ readonly 'datasets:read': "datasets:read";
151
+ /** Create and modify datasets */
152
+ readonly 'datasets:write': "datasets:write";
153
+ /** View embedders */
154
+ readonly 'embedders:read': "embedders:read";
155
+ /** View experiments */
156
+ readonly 'experiments:read': "experiments:read";
157
+ /** Execute harness sessions */
158
+ readonly 'harness:execute': "harness:execute";
159
+ /** View harness sessions */
160
+ readonly 'harness:read': "harness:read";
161
+ /** View infrastructure */
162
+ readonly 'infrastructure:read': "infrastructure:read";
163
+ /** View logs */
164
+ readonly 'logs:read': "logs:read";
165
+ /** Execute MCP servers */
166
+ readonly 'mcp:execute': "mcp:execute";
167
+ /** View MCP servers */
168
+ readonly 'mcp:read': "mcp:read";
169
+ /** Create and modify MCP servers */
170
+ readonly 'mcp:write': "mcp:write";
171
+ /** Delete memory and threads */
172
+ readonly 'memory:delete': "memory:delete";
173
+ /** Execute memory and threads */
174
+ readonly 'memory:execute': "memory:execute";
175
+ /** View memory and threads */
176
+ readonly 'memory:read': "memory:read";
177
+ /** Create and modify memory and threads */
178
+ readonly 'memory:write': "memory:write";
179
+ /** View traces and spans */
180
+ readonly 'observability:read': "observability:read";
181
+ /** Create and modify traces and spans */
182
+ readonly 'observability:write': "observability:write";
183
+ /** View processor-providers */
184
+ readonly 'processor-providers:read': "processor-providers:read";
185
+ /** Execute processors */
186
+ readonly 'processors:execute': "processors:execute";
187
+ /** View processors */
188
+ readonly 'processors:read': "processors:read";
189
+ /** Execute schedules */
190
+ readonly 'schedules:execute': "schedules:execute";
191
+ /** View schedules */
192
+ readonly 'schedules:read': "schedules:read";
193
+ /** Create and modify schedules */
194
+ readonly 'schedules:write': "schedules:write";
195
+ /** View evaluation scores */
196
+ readonly 'scores:read': "scores:read";
197
+ /** Create and modify evaluation scores */
198
+ readonly 'scores:write': "scores:write";
199
+ /** Delete stored agents */
200
+ readonly 'stored-agents:delete': "stored-agents:delete";
201
+ /** Publish, activate, or restore stored agents */
202
+ readonly 'stored-agents:publish': "stored-agents:publish";
203
+ /** View stored agents */
204
+ readonly 'stored-agents:read': "stored-agents:read";
205
+ /** Create and modify stored agents */
206
+ readonly 'stored-agents:write': "stored-agents:write";
207
+ /** Delete stored MCP clients */
208
+ readonly 'stored-mcp-clients:delete': "stored-mcp-clients:delete";
209
+ /** Publish, activate, or restore stored MCP clients */
210
+ readonly 'stored-mcp-clients:publish': "stored-mcp-clients:publish";
211
+ /** View stored MCP clients */
212
+ readonly 'stored-mcp-clients:read': "stored-mcp-clients:read";
213
+ /** Create and modify stored MCP clients */
214
+ readonly 'stored-mcp-clients:write': "stored-mcp-clients:write";
215
+ /** Delete stored prompt blocks */
216
+ readonly 'stored-prompt-blocks:delete': "stored-prompt-blocks:delete";
217
+ /** Publish, activate, or restore stored prompt blocks */
218
+ readonly 'stored-prompt-blocks:publish': "stored-prompt-blocks:publish";
219
+ /** View stored prompt blocks */
220
+ readonly 'stored-prompt-blocks:read': "stored-prompt-blocks:read";
221
+ /** Create and modify stored prompt blocks */
222
+ readonly 'stored-prompt-blocks:write': "stored-prompt-blocks:write";
223
+ /** Delete stored scorers */
224
+ readonly 'stored-scorers:delete': "stored-scorers:delete";
225
+ /** Publish, activate, or restore stored scorers */
226
+ readonly 'stored-scorers:publish': "stored-scorers:publish";
227
+ /** View stored scorers */
228
+ readonly 'stored-scorers:read': "stored-scorers:read";
229
+ /** Create and modify stored scorers */
230
+ readonly 'stored-scorers:write': "stored-scorers:write";
231
+ /** Delete stored skills */
232
+ readonly 'stored-skills:delete': "stored-skills:delete";
233
+ /** Publish, activate, or restore stored skills */
234
+ readonly 'stored-skills:publish': "stored-skills:publish";
235
+ /** View stored skills */
236
+ readonly 'stored-skills:read': "stored-skills:read";
237
+ /** Create and modify stored skills */
238
+ readonly 'stored-skills:write': "stored-skills:write";
239
+ /** Delete stored workspaces */
240
+ readonly 'stored-workspaces:delete': "stored-workspaces:delete";
241
+ /** View stored workspaces */
242
+ readonly 'stored-workspaces:read': "stored-workspaces:read";
243
+ /** Create and modify stored workspaces */
244
+ readonly 'stored-workspaces:write': "stored-workspaces:write";
245
+ /** View system info */
246
+ readonly 'system:read': "system:read";
247
+ /** Delete tool-providers */
248
+ readonly 'tool-providers:delete': "tool-providers:delete";
249
+ /** View tool-providers */
250
+ readonly 'tool-providers:read': "tool-providers:read";
251
+ /** Create and modify tool-providers */
252
+ readonly 'tool-providers:write': "tool-providers:write";
253
+ /** Execute tools */
254
+ readonly 'tools:execute': "tools:execute";
255
+ /** View tools */
256
+ readonly 'tools:read': "tools:read";
257
+ /** Delete vector stores */
258
+ readonly 'vector:delete': "vector:delete";
259
+ /** Execute vector stores */
260
+ readonly 'vector:execute': "vector:execute";
261
+ /** View vector stores */
262
+ readonly 'vector:read': "vector:read";
263
+ /** Create and modify vector stores */
264
+ readonly 'vector:write': "vector:write";
265
+ /** View vectors */
266
+ readonly 'vectors:read': "vectors:read";
267
+ /** Delete workflows */
268
+ readonly 'workflows:delete': "workflows:delete";
269
+ /** Execute workflows */
270
+ readonly 'workflows:execute': "workflows:execute";
271
+ /** View workflows */
272
+ readonly 'workflows:read': "workflows:read";
273
+ /** Create and modify workflows */
274
+ readonly 'workflows:write': "workflows:write";
275
+ /** Delete workspaces */
276
+ readonly 'workspaces:delete': "workspaces:delete";
277
+ /** View workspaces */
278
+ readonly 'workspaces:read': "workspaces:read";
279
+ /** Create and modify workspaces */
280
+ readonly 'workspaces:write': "workspaces:write";
281
+ /** Full access to all stored resource families */
282
+ readonly 'stored:*': "stored:*";
283
+ /** View all stored resource families */
284
+ readonly 'stored:read': "stored:read";
285
+ /** Create and modify all stored resource families */
286
+ readonly 'stored:write': "stored:write";
287
+ /** Delete all stored resource families */
288
+ readonly 'stored:delete': "stored:delete";
289
+ /** Change visibility/audience stored agents */
290
+ readonly 'stored-agents:share': "stored-agents:share";
291
+ /** Change visibility/audience stored skills */
292
+ readonly 'stored-skills:share': "stored-skills:share";
293
+ };
294
+ /**
295
+ * Permission pattern that can be used in role definitions.
296
+ * Supports:
297
+ * - Specific permissions: 'agents:read', 'workflows:execute'
298
+ * - Resource wildcards: 'agents:*', 'workflows:*' (all actions on a resource)
299
+ * - Action wildcards: '*:read', '*:write' (an action across all resources)
300
+ * - Global wildcard: '*' (full access)
301
+ */
302
+ export type PermissionPattern = keyof typeof PERMISSION_PATTERNS;
303
+ /**
304
+ * All valid resource:action permission combinations (excludes wildcards).
305
+ */
306
+ export declare const PERMISSIONS: readonly ["a2a:read", "a2a:write", "agent-builder:execute", "agent-builder:read", "agent-builder:write", "agents:create", "agents:delete", "agents:execute", "agents:read", "agents:write", "auth:read", "background-tasks:read", "channels:read", "channels:write", "datasets:delete", "datasets:execute", "datasets:read", "datasets:write", "embedders:read", "experiments:read", "harness:execute", "harness:read", "infrastructure:read", "logs:read", "mcp:execute", "mcp:read", "mcp:write", "memory:delete", "memory:execute", "memory:read", "memory:write", "observability:read", "observability:write", "processor-providers:read", "processors:execute", "processors:read", "schedules:execute", "schedules:read", "schedules:write", "scores:read", "scores:write", "stored-agents:delete", "stored-agents:publish", "stored-agents:read", "stored-agents:write", "stored-mcp-clients:delete", "stored-mcp-clients:publish", "stored-mcp-clients:read", "stored-mcp-clients:write", "stored-prompt-blocks:delete", "stored-prompt-blocks:publish", "stored-prompt-blocks:read", "stored-prompt-blocks:write", "stored-scorers:delete", "stored-scorers:publish", "stored-scorers:read", "stored-scorers:write", "stored-skills:delete", "stored-skills:publish", "stored-skills:read", "stored-skills:write", "stored-workspaces:delete", "stored-workspaces:read", "stored-workspaces:write", "system:read", "tool-providers:delete", "tool-providers:read", "tool-providers:write", "tools:execute", "tools:read", "vector:delete", "vector:execute", "vector:read", "vector:write", "vectors:read", "workflows:delete", "workflows:execute", "workflows:read", "workflows:write", "workspaces:delete", "workspaces:read", "workspaces:write"];
307
+ /**
308
+ * Specific permission type (e.g., 'agents:read', 'workflows:execute').
309
+ */
310
+ export type Permission = (typeof PERMISSIONS)[number];
311
+ /**
312
+ * Type-safe constants for Mastra-owned FGA permissions.
313
+ *
314
+ * These values are generated from server routes and can be used wherever
315
+ * Mastra checks or maps FGA permissions.
316
+ */
317
+ export declare const MastraFGAPermissions: {
318
+ /** View agent-to-agent communication */
319
+ readonly A2A_READ: "a2a:read";
320
+ /** Create and modify agent-to-agent communication */
321
+ readonly A2A_WRITE: "a2a:write";
322
+ /** Execute agent builder */
323
+ readonly AGENT_BUILDER_EXECUTE: "agent-builder:execute";
324
+ /** View agent builder */
325
+ readonly AGENT_BUILDER_READ: "agent-builder:read";
326
+ /** Create and modify agent builder */
327
+ readonly AGENT_BUILDER_WRITE: "agent-builder:write";
328
+ /** Create agents */
329
+ readonly AGENTS_CREATE: "agents:create";
330
+ /** Delete agents */
331
+ readonly AGENTS_DELETE: "agents:delete";
332
+ /** Execute agents */
333
+ readonly AGENTS_EXECUTE: "agents:execute";
334
+ /** View agents */
335
+ readonly AGENTS_READ: "agents:read";
336
+ /** Create and modify agents */
337
+ readonly AGENTS_WRITE: "agents:write";
338
+ /** View auth */
339
+ readonly AUTH_READ: "auth:read";
340
+ /** View background tasks */
341
+ readonly BACKGROUND_TASKS_READ: "background-tasks:read";
342
+ /** View channels */
343
+ readonly CHANNELS_READ: "channels:read";
344
+ /** Create and modify channels */
345
+ readonly CHANNELS_WRITE: "channels:write";
346
+ /** Delete datasets */
347
+ readonly DATASETS_DELETE: "datasets:delete";
348
+ /** Execute datasets */
349
+ readonly DATASETS_EXECUTE: "datasets:execute";
350
+ /** View datasets */
351
+ readonly DATASETS_READ: "datasets:read";
352
+ /** Create and modify datasets */
353
+ readonly DATASETS_WRITE: "datasets:write";
354
+ /** View embedders */
355
+ readonly EMBEDDERS_READ: "embedders:read";
356
+ /** View experiments */
357
+ readonly EXPERIMENTS_READ: "experiments:read";
358
+ /** Execute harness sessions */
359
+ readonly HARNESS_EXECUTE: "harness:execute";
360
+ /** View harness sessions */
361
+ readonly HARNESS_READ: "harness:read";
362
+ /** View infrastructure */
363
+ readonly INFRASTRUCTURE_READ: "infrastructure:read";
364
+ /** View logs */
365
+ readonly LOGS_READ: "logs:read";
366
+ /** Execute MCP servers */
367
+ readonly MCP_EXECUTE: "mcp:execute";
368
+ /** View MCP servers */
369
+ readonly MCP_READ: "mcp:read";
370
+ /** Create and modify MCP servers */
371
+ readonly MCP_WRITE: "mcp:write";
372
+ /** Delete memory and threads */
373
+ readonly MEMORY_DELETE: "memory:delete";
374
+ /** Execute memory and threads */
375
+ readonly MEMORY_EXECUTE: "memory:execute";
376
+ /** View memory and threads */
377
+ readonly MEMORY_READ: "memory:read";
378
+ /** Create and modify memory and threads */
379
+ readonly MEMORY_WRITE: "memory:write";
380
+ /** View traces and spans */
381
+ readonly OBSERVABILITY_READ: "observability:read";
382
+ /** Create and modify traces and spans */
383
+ readonly OBSERVABILITY_WRITE: "observability:write";
384
+ /** View processor-providers */
385
+ readonly PROCESSOR_PROVIDERS_READ: "processor-providers:read";
386
+ /** Execute processors */
387
+ readonly PROCESSORS_EXECUTE: "processors:execute";
388
+ /** View processors */
389
+ readonly PROCESSORS_READ: "processors:read";
390
+ /** Execute schedules */
391
+ readonly SCHEDULES_EXECUTE: "schedules:execute";
392
+ /** View schedules */
393
+ readonly SCHEDULES_READ: "schedules:read";
394
+ /** Create and modify schedules */
395
+ readonly SCHEDULES_WRITE: "schedules:write";
396
+ /** View evaluation scores */
397
+ readonly SCORES_READ: "scores:read";
398
+ /** Create and modify evaluation scores */
399
+ readonly SCORES_WRITE: "scores:write";
400
+ /** Delete stored agents */
401
+ readonly STORED_AGENTS_DELETE: "stored-agents:delete";
402
+ /** Publish, activate, or restore stored agents */
403
+ readonly STORED_AGENTS_PUBLISH: "stored-agents:publish";
404
+ /** View stored agents */
405
+ readonly STORED_AGENTS_READ: "stored-agents:read";
406
+ /** Create and modify stored agents */
407
+ readonly STORED_AGENTS_WRITE: "stored-agents:write";
408
+ /** Delete stored MCP clients */
409
+ readonly STORED_MCP_CLIENTS_DELETE: "stored-mcp-clients:delete";
410
+ /** Publish, activate, or restore stored MCP clients */
411
+ readonly STORED_MCP_CLIENTS_PUBLISH: "stored-mcp-clients:publish";
412
+ /** View stored MCP clients */
413
+ readonly STORED_MCP_CLIENTS_READ: "stored-mcp-clients:read";
414
+ /** Create and modify stored MCP clients */
415
+ readonly STORED_MCP_CLIENTS_WRITE: "stored-mcp-clients:write";
416
+ /** Delete stored prompt blocks */
417
+ readonly STORED_PROMPT_BLOCKS_DELETE: "stored-prompt-blocks:delete";
418
+ /** Publish, activate, or restore stored prompt blocks */
419
+ readonly STORED_PROMPT_BLOCKS_PUBLISH: "stored-prompt-blocks:publish";
420
+ /** View stored prompt blocks */
421
+ readonly STORED_PROMPT_BLOCKS_READ: "stored-prompt-blocks:read";
422
+ /** Create and modify stored prompt blocks */
423
+ readonly STORED_PROMPT_BLOCKS_WRITE: "stored-prompt-blocks:write";
424
+ /** Delete stored scorers */
425
+ readonly STORED_SCORERS_DELETE: "stored-scorers:delete";
426
+ /** Publish, activate, or restore stored scorers */
427
+ readonly STORED_SCORERS_PUBLISH: "stored-scorers:publish";
428
+ /** View stored scorers */
429
+ readonly STORED_SCORERS_READ: "stored-scorers:read";
430
+ /** Create and modify stored scorers */
431
+ readonly STORED_SCORERS_WRITE: "stored-scorers:write";
432
+ /** Delete stored skills */
433
+ readonly STORED_SKILLS_DELETE: "stored-skills:delete";
434
+ /** Publish, activate, or restore stored skills */
435
+ readonly STORED_SKILLS_PUBLISH: "stored-skills:publish";
436
+ /** View stored skills */
437
+ readonly STORED_SKILLS_READ: "stored-skills:read";
438
+ /** Create and modify stored skills */
439
+ readonly STORED_SKILLS_WRITE: "stored-skills:write";
440
+ /** Delete stored workspaces */
441
+ readonly STORED_WORKSPACES_DELETE: "stored-workspaces:delete";
442
+ /** View stored workspaces */
443
+ readonly STORED_WORKSPACES_READ: "stored-workspaces:read";
444
+ /** Create and modify stored workspaces */
445
+ readonly STORED_WORKSPACES_WRITE: "stored-workspaces:write";
446
+ /** View system info */
447
+ readonly SYSTEM_READ: "system:read";
448
+ /** Delete tool-providers */
449
+ readonly TOOL_PROVIDERS_DELETE: "tool-providers:delete";
450
+ /** View tool-providers */
451
+ readonly TOOL_PROVIDERS_READ: "tool-providers:read";
452
+ /** Create and modify tool-providers */
453
+ readonly TOOL_PROVIDERS_WRITE: "tool-providers:write";
454
+ /** Execute tools */
455
+ readonly TOOLS_EXECUTE: "tools:execute";
456
+ /** View tools */
457
+ readonly TOOLS_READ: "tools:read";
458
+ /** Delete vector stores */
459
+ readonly VECTOR_DELETE: "vector:delete";
460
+ /** Execute vector stores */
461
+ readonly VECTOR_EXECUTE: "vector:execute";
462
+ /** View vector stores */
463
+ readonly VECTOR_READ: "vector:read";
464
+ /** Create and modify vector stores */
465
+ readonly VECTOR_WRITE: "vector:write";
466
+ /** View vectors */
467
+ readonly VECTORS_READ: "vectors:read";
468
+ /** Delete workflows */
469
+ readonly WORKFLOWS_DELETE: "workflows:delete";
470
+ /** Execute workflows */
471
+ readonly WORKFLOWS_EXECUTE: "workflows:execute";
472
+ /** View workflows */
473
+ readonly WORKFLOWS_READ: "workflows:read";
474
+ /** Create and modify workflows */
475
+ readonly WORKFLOWS_WRITE: "workflows:write";
476
+ /** Delete workspaces */
477
+ readonly WORKSPACES_DELETE: "workspaces:delete";
478
+ /** View workspaces */
479
+ readonly WORKSPACES_READ: "workspaces:read";
480
+ /** Create and modify workspaces */
481
+ readonly WORKSPACES_WRITE: "workspaces:write";
482
+ };
483
+ /**
484
+ * Mastra-owned FGA permission values.
485
+ */
486
+ export type MastraFGAPermission = (typeof MastraFGAPermissions)[keyof typeof MastraFGAPermissions];
487
+ /**
488
+ * FGA permission input accepted by public config and provider APIs.
489
+ * Keeps autocomplete for Mastra-owned permissions while allowing custom provider strings.
490
+ */
491
+ export type MastraFGAPermissionInput = MastraFGAPermission | (string & {});
492
+ /**
493
+ * Type-safe role mapping configuration.
494
+ *
495
+ * Maps role names (from your identity provider) to Mastra permission patterns.
496
+ *
497
+ * @example
498
+ * ```typescript
499
+ * const roleMapping: TypedRoleMapping = {
500
+ * "Engineering": ["agents:*", "workflows:*"],
501
+ * "Product": ["agents:read", "workflows:read"],
502
+ * "Admin": ["*"],
503
+ * "_default": [],
504
+ * };
505
+ * ```
506
+ */
507
+ export type TypedRoleMapping = {
508
+ [role: string]: PermissionPattern[];
509
+ };
510
+ /**
511
+ * Validates that a string is a valid permission pattern.
512
+ * Useful for runtime validation of permission strings.
513
+ */
514
+ export declare function isValidPermissionPattern(pattern: string): pattern is PermissionPattern;
515
+ /**
516
+ * Validates that all permissions in an array are valid patterns.
517
+ */
518
+ export declare function validatePermissions(permissions: string[]): permissions is PermissionPattern[];
519
+ //# sourceMappingURL=permissions.generated.d.ts.map