@itphx/synth-backend 0.13.8 → 0.13.10
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/app/deps.d.ts +15 -2
- package/dist/app/deps.js +620 -57
- package/dist/app/listen.js +30 -35
- package/dist/app/mount-routes.js +258 -22
- package/dist/app/sse-events.js +2 -0
- package/dist/app.d.ts +7 -0
- package/dist/app.js +14 -11
- package/dist/auth/middleware.js +4 -12
- package/dist/auth/oidc.d.ts +46 -4
- package/dist/auth/oidc.js +55 -8
- package/dist/events/hub.d.ts +36 -2
- package/dist/events/hub.js +62 -3
- package/dist/events/visible-session-ids.d.ts +35 -0
- package/dist/events/visible-session-ids.js +29 -0
- package/dist/lib/app-config.js +35 -5
- package/dist/lib/i18n.js +14 -0
- package/dist/lib/principal-identity.d.ts +35 -0
- package/dist/lib/principal-identity.js +43 -0
- package/dist/lib/project-principal.d.ts +27 -0
- package/dist/lib/project-principal.js +27 -0
- package/dist/lib/recalc-can-summarize.js +8 -5
- package/dist/main.js +5 -1
- package/dist/routes/agents.d.ts +3 -3
- package/dist/routes/agents.js +6 -2
- package/dist/routes/auth.js +33 -0
- package/dist/routes/project-access.d.ts +61 -0
- package/dist/routes/project-access.js +62 -0
- package/dist/routes/projects.d.ts +41 -4
- package/dist/routes/projects.js +117 -15
- package/dist/routes/queue.d.ts +7 -1
- package/dist/routes/queue.js +7 -1
- package/dist/routes/schedules.d.ts +46 -0
- package/dist/routes/schedules.js +10 -0
- package/dist/routes/sessions.d.ts +53 -1
- package/dist/routes/sessions.js +92 -26
- package/dist/routes/users.d.ts +14 -1
- package/dist/routes/users.js +91 -1
- package/package.json +5 -5
package/dist/routes/projects.js
CHANGED
|
@@ -1,26 +1,60 @@
|
|
|
1
1
|
import { createProjectRoutes as createCoreProjectRoutes, resolveProjectSkillSeed } from '@itphx/synth-core';
|
|
2
|
-
import {
|
|
2
|
+
import { canManageWithProjectRole, canWriteWithProjectRole, resolveProjectAccess, } from '@itphx/synth-shared';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
|
+
import { projectPrincipalOf, groupsOf } from '../lib/project-principal.js';
|
|
5
|
+
import { AUTH_IDENTITY_PROVIDER } from '../lib/principal-identity.js';
|
|
4
6
|
/**
|
|
5
7
|
* ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
|
|
6
8
|
* чтобы их переиспользовали git-роуты core-фабрики (`authorizeProject`), а логика
|
|
7
9
|
* ролей не дублировалась.
|
|
10
|
+
*
|
|
11
|
+
* PROP-133 §1: предикат — **единственный** резолвер доступа
|
|
12
|
+
* (`resolveProjectAccess`); здесь только сборка принципала запроса. Своей копии
|
|
13
|
+
* правил (owner/`members`/`ADMIN`/`LEAD`) больше нет.
|
|
8
14
|
*/
|
|
9
15
|
export function createProjectAccess(kit) {
|
|
10
|
-
/** ADR-071 §2.4: owner проекта или глобальные LEAD/ADMIN (через AuthKit). */
|
|
11
|
-
const canManageProject = (c, project, userId) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
12
|
-
|| (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD'))
|
|
13
|
-
|| project.ownerId === userId
|
|
14
|
-
|| project.members?.[userId] === ProjectRole.OWNER;
|
|
15
|
-
/** D5: owner / EDITOR / глобальные LEAD/ADMIN — редактирование контента проекта. */
|
|
16
|
-
const canEditProjectContent = (c, project, userId) => canManageProject(c, project, userId)
|
|
17
|
-
|| project.members?.[userId] === ProjectRole.EDITOR;
|
|
18
16
|
/**
|
|
19
|
-
*
|
|
20
|
-
*
|
|
17
|
+
* PROP-133 §1: принципал запроса — пользователь + роли инстанса (+ группы, Ф2).
|
|
18
|
+
*
|
|
19
|
+
* Пользователь берётся из контекста (`c.get('user')` — тот же `User`, что
|
|
20
|
+
* кладёт `attachUser`/`requireAuth` и что отдаёт `kit.getCurrentUser`); если
|
|
21
|
+
* пользователя в контексте нет (мок-AuthKit в тестах) — роли инстанса
|
|
22
|
+
* определяются через AuthKit (`isAdmin`/`hasRole` — те же проверки, что и
|
|
23
|
+
* прежде). Проверка остаётся **синхронной**: контракт core-фабрики
|
|
24
|
+
* (`opts.canManage`/`canEditContent`/`canRead`) — sync.
|
|
21
25
|
*/
|
|
22
|
-
const
|
|
23
|
-
|
|
26
|
+
const principalOf = (c, userId) => {
|
|
27
|
+
const user = c.get('user');
|
|
28
|
+
const roles = user?.roles ? [...user.roles] : [];
|
|
29
|
+
if (roles.length === 0) {
|
|
30
|
+
if (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
31
|
+
roles.push('ADMIN');
|
|
32
|
+
else if (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD'))
|
|
33
|
+
roles.push('LEAD');
|
|
34
|
+
}
|
|
35
|
+
return projectPrincipalOf(user, userId, roles);
|
|
36
|
+
};
|
|
37
|
+
/** PROP-133 §1: решение по доступу к проекту для принципала запроса. */
|
|
38
|
+
const accessOf = (c, project, userId) => resolveProjectAccess(project, principalOf(c, userId));
|
|
39
|
+
/**
|
|
40
|
+
* ADR-076 §T4 / PROP-133 §1: управление доступом к проекту — автор проекта,
|
|
41
|
+
* участник с ролью `owner`, а также глобальные `LEAD`/`ADMIN` (сквозной
|
|
42
|
+
* обзор). Гранты по группе и режим «всем пользователям» роль `owner` **не**
|
|
43
|
+
* дают (см. `canManageWithProjectRole`).
|
|
44
|
+
*/
|
|
45
|
+
const canManageProject = (c, project, userId) => canManageWithProjectRole(accessOf(c, project, userId).role);
|
|
46
|
+
/**
|
|
47
|
+
* D5 / PROP-133 §1: редактирование контента проекта — `owner`/`editor`
|
|
48
|
+
* (в т.ч. грант по группе и режим «всем пользователям» с ролью `editor`).
|
|
49
|
+
* `viewer` записи не даёт (инвариант 21).
|
|
50
|
+
*/
|
|
51
|
+
const canEditProjectContent = (c, project, userId) => canWriteWithProjectRole(accessOf(c, project, userId).role);
|
|
52
|
+
/**
|
|
53
|
+
* ADR-089 / PROP-133 §1: чтение проекта по id — по роли доступа (владелец,
|
|
54
|
+
* участник, грант по группе, режим «всем пользователям»; `LEAD`/`ADMIN` —
|
|
55
|
+
* сквозной обзор). Не расширяет права на редактирование.
|
|
56
|
+
*/
|
|
57
|
+
const canReadProject = (c, project, userId) => accessOf(c, project, userId).read;
|
|
24
58
|
return { canManageProject, canEditProjectContent, canReadProject };
|
|
25
59
|
}
|
|
26
60
|
/**
|
|
@@ -32,7 +66,7 @@ export function createProjectAccess(kit) {
|
|
|
32
66
|
export function createProjectRoutes(kit, store, sessionManager, workspacesRoot,
|
|
33
67
|
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
34
68
|
mcpManager,
|
|
35
|
-
/** ADR-
|
|
69
|
+
/** ADR-126 §11: сид скиллов нового проекта (системные дефолты). */
|
|
36
70
|
skillService, settingsStore, mcpRegistryStore,
|
|
37
71
|
/**
|
|
38
72
|
* ADR-114: сервис worktree проекта — контур `/projects/:id/worktrees*`
|
|
@@ -44,15 +78,66 @@ worktreeService,
|
|
|
44
78
|
* `project.updated`/`project.deleted` в канал каждой сессии проекта.
|
|
45
79
|
* Не задана — публикации нет (поведение прежнее).
|
|
46
80
|
*/
|
|
47
|
-
eventBus
|
|
81
|
+
eventBus,
|
|
82
|
+
/**
|
|
83
|
+
* PROP-135 Ф6a: каталог профилей исполнения (`execution.remote`) —
|
|
84
|
+
* валидация `project.executor.profile`/`allowedProfiles` (PUT /:id).
|
|
85
|
+
* Не задан — проверка существования профиля пропускается.
|
|
86
|
+
*/
|
|
87
|
+
executionProfileCatalog,
|
|
88
|
+
/**
|
|
89
|
+
* PROP-135 (браузерный контур): каталог браузерных профилей — валидация
|
|
90
|
+
* `project.executor.browserProfile`/`allowedBrowserProfiles`.
|
|
91
|
+
*/
|
|
92
|
+
browserProfileCatalog,
|
|
93
|
+
/**
|
|
94
|
+
* PROP-133 §3.1: журнал изменений состояния доступа к проекту
|
|
95
|
+
* (`members`/`group_members`/`everyone_role`) — тот же порт
|
|
96
|
+
* `SecurityAuditRepository`, что у security-аудита (скоуп `projects`).
|
|
97
|
+
* Не задан — аудит не пишется (фича работает).
|
|
98
|
+
*/
|
|
99
|
+
securityAudit,
|
|
100
|
+
/**
|
|
101
|
+
* ADR-140 Ф2: хаб подписок WS/SSE — при смене состояния доступа к проекту
|
|
102
|
+
* подписки уже подключённых клиентов пересчитываются (доступ применяется
|
|
103
|
+
* к тем, кто подключён **до** изменения).
|
|
104
|
+
* Не задан — пересчёта нет (подписки остаются прежними).
|
|
105
|
+
*/
|
|
106
|
+
eventHub,
|
|
107
|
+
/**
|
|
108
|
+
* ADR-140 Ф3: профили пользователей — проверка получателя при передаче
|
|
109
|
+
* владения (`POST /:id/transfer`): цель должна существовать и быть активна.
|
|
110
|
+
* Не задан — передача владения невозможна (цель не проверяется).
|
|
111
|
+
*/
|
|
112
|
+
profilesStore) {
|
|
48
113
|
const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
|
|
49
114
|
return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
|
|
50
115
|
canManage: canManageProject,
|
|
51
116
|
canEditContent: canEditProjectContent,
|
|
52
117
|
canRead: canReadProject,
|
|
118
|
+
// ADR-140 Ф3: передача владения — текущий владелец или `ADMIN`.
|
|
119
|
+
// `LEAD`/участники/`EDITOR` — нет (передача владения ≠ управление
|
|
120
|
+
// содержимым).
|
|
121
|
+
canTransfer: (c, project, userId) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
122
|
+
|| project.ownerId === userId,
|
|
123
|
+
// ADR-140 Ф3: получатель должен существовать и быть активным.
|
|
124
|
+
// Каталог отдаёт **ACL-id** (auth-идентичность = OIDC `sub`/debug-id,
|
|
125
|
+
// ADR-140), поэтому сначала ищем профиль по идентичности, затем — по
|
|
126
|
+
// `profile.id` (legacy-профиль без привязки, ещё не логинившийся).
|
|
127
|
+
resolveTransferTarget: async (id) => {
|
|
128
|
+
if (!profilesStore)
|
|
129
|
+
return null;
|
|
130
|
+
const profile = (await profilesStore.findProfileByExternalId(AUTH_IDENTITY_PROVIDER, id))
|
|
131
|
+
?? (await profilesStore.loadProfile(id));
|
|
132
|
+
return profile ? { id, active: profile.isActive !== false } : null;
|
|
133
|
+
},
|
|
53
134
|
// ADR-089: ADMIN/LEAD — сквозная видимость всех проектов (защита от мок-AuthKit).
|
|
54
135
|
resolveElevated: (c) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
55
136
|
|| (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD')),
|
|
137
|
+
// PROP-133 §1/§6: группы принципала — грант по группе должен попадать и
|
|
138
|
+
// в список проектов (иначе проект читается по `GET /:id`, но в списке
|
|
139
|
+
// отсутствует). Нет поля/не массив/пусто — групп нет (fail-closed).
|
|
140
|
+
resolveViewerGroups: (c) => groupsOf(c.get('user')),
|
|
56
141
|
getCurrentUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
57
142
|
messages: {
|
|
58
143
|
nameRequired: (c) => t('errors.validation.nameRequired', undefined, c),
|
|
@@ -99,10 +184,27 @@ eventBus) {
|
|
|
99
184
|
for (const s of sessions) {
|
|
100
185
|
eventBus.publish(s.id, kind === 'deleted' ? 'project.deleted' : 'project.updated', {
|
|
101
186
|
project_id: projectId,
|
|
187
|
+
// ADR-140 Ф2: вид изменения — UI/подписки видят, что именно
|
|
188
|
+
// изменилось (в т.ч. состояние доступа — `access`).
|
|
189
|
+
kind,
|
|
102
190
|
});
|
|
103
191
|
}
|
|
192
|
+
// ADR-140 Ф2: изменилось состояние доступа — пересчитать
|
|
193
|
+
// подписки уже подключённых клиентов (иначе новый участник не
|
|
194
|
+
// получит события сессий проекта, а потерявший — продолжит
|
|
195
|
+
// получать).
|
|
196
|
+
if (kind === 'access') {
|
|
197
|
+
await eventHub?.resyncAllClients();
|
|
198
|
+
}
|
|
104
199
|
},
|
|
105
200
|
}
|
|
106
201
|
: {}),
|
|
202
|
+
// PROP-135 Ф6a: каталог профилей исполнения — проверка
|
|
203
|
+
// `project.executor.profile`/`allowedProfiles` в PUT /:id.
|
|
204
|
+
...(executionProfileCatalog ? { executionProfileCatalog } : {}),
|
|
205
|
+
// PROP-135 (браузерный контур): каталог браузерных профилей проекта.
|
|
206
|
+
...(browserProfileCatalog ? { browserProfileCatalog } : {}),
|
|
207
|
+
// PROP-133 §3.1: аудит изменения состояния доступа к проекту.
|
|
208
|
+
...(securityAudit ? { securityAudit } : {}),
|
|
107
209
|
});
|
|
108
210
|
}
|
package/dist/routes/queue.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
3
|
import type { SessionManager, QueueProcessorManager, ChatOrchestrator, EventBus, ProjectRepository } from '@itphx/synth-core';
|
|
4
|
+
import type { QueueRoutesOptions } from '@itphx/synth-core';
|
|
4
5
|
import type { Message } from '@itphx/synth-shared';
|
|
5
6
|
/**
|
|
6
7
|
* Backend-обёртка над core-фабрикой очереди: добавляет i18n-сообщения и RBAC
|
|
@@ -9,4 +10,9 @@ import type { Message } from '@itphx/synth-shared';
|
|
|
9
10
|
*/
|
|
10
11
|
export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, projectStore?: ProjectRepository,
|
|
11
12
|
/** ADR-036: обфускация user-сообщения (та же, что у `POST /sessions/:id/prompt`). */
|
|
12
|
-
obfuscate?: (sessionId: string, message: Message) => Promise<Message
|
|
13
|
+
obfuscate?: (sessionId: string, message: Message) => Promise<Message>,
|
|
14
|
+
/**
|
|
15
|
+
* ADR-111 §detach: авто-перевод блокирующих прогонов при вклинивании из
|
|
16
|
+
* очереди (`/queue/:sessionId/steer`) — тот же шов, что у prompt-роута.
|
|
17
|
+
*/
|
|
18
|
+
autoDetachOnSteer?: QueueRoutesOptions['autoDetachOnSteer']): Hono;
|
package/dist/routes/queue.js
CHANGED
|
@@ -9,7 +9,12 @@ import { createProjectAccess } from './projects.js';
|
|
|
9
9
|
*/
|
|
10
10
|
export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, processMessage, projectStore,
|
|
11
11
|
/** ADR-036: обфускация user-сообщения (та же, что у `POST /sessions/:id/prompt`). */
|
|
12
|
-
obfuscate
|
|
12
|
+
obfuscate,
|
|
13
|
+
/**
|
|
14
|
+
* ADR-111 §detach: авто-перевод блокирующих прогонов при вклинивании из
|
|
15
|
+
* очереди (`/queue/:sessionId/steer`) — тот же шов, что у prompt-роута.
|
|
16
|
+
*/
|
|
17
|
+
autoDetachOnSteer) {
|
|
13
18
|
const app = new Hono();
|
|
14
19
|
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
15
20
|
// ADR-071 §2.4: владелец сессии — обычный пользователь.
|
|
@@ -42,6 +47,7 @@ obfuscate) {
|
|
|
42
47
|
: canEditProjectContent(ctx, project, userId);
|
|
43
48
|
},
|
|
44
49
|
...(obfuscate ? { obfuscate } : {}),
|
|
50
|
+
...(autoDetachOnSteer ? { autoDetachOnSteer } : {}),
|
|
45
51
|
}));
|
|
46
52
|
return app;
|
|
47
53
|
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Managed-доступ к расписаниям планировщика (PROP-141, этап 5 B-1).
|
|
3
|
+
*
|
|
4
|
+
* Правило доступа — **общее** для проектных ресурсов автоматизаций: вынесено
|
|
5
|
+
* в `routes/project-access.ts` (`createBackendProjectAccess`) и переиспользуется
|
|
6
|
+
* таймерами (`routes/timers.ts`) — копии правила нет.
|
|
7
|
+
*
|
|
8
|
+
* | Актор | чтение (`GET /`, `GET /:id/jobs`) | мутации (`POST`/`PUT`/`DELETE`/`run`) |
|
|
9
|
+
* |------------------------------|-----------------------------------|----------------------------------------|
|
|
10
|
+
* | владелец проекта | да | да |
|
|
11
|
+
* | участник `EDITOR` | да | да |
|
|
12
|
+
* | участник `VIEWER` | да | **403** (`VIEWER` не мутирует) |
|
|
13
|
+
* | `LEAD`/`ADMIN` | да (сквозной обзор) | да |
|
|
14
|
+
* | чужой `USER` | **не видно в списке**, 403/404 | 403/404 |
|
|
15
|
+
*
|
|
16
|
+
* Прежний `requireAdmin` на все мутации снят (PROP-141, решение владельца
|
|
17
|
+
* 2026-11-17): EDITOR/OWNER управляют автоматизациями своего проекта.
|
|
18
|
+
*
|
|
19
|
+
* **service-key (ADR-052)** — не пользователь проекта (`service:<keyId>` не
|
|
20
|
+
* участник), поэтому ролевая проверка по проекту к нему не применяется:
|
|
21
|
+
* scope проверяет `requireScope`, проекцию `allowedProjects` —
|
|
22
|
+
* `serviceProjectProjection`. Здесь service-key ограничен своей проекцией:
|
|
23
|
+
* список — по `allowedProjects` (не задана — все проекты, пустой список —
|
|
24
|
+
* ничего), а проект вне проекции — 403.
|
|
25
|
+
*/
|
|
26
|
+
import type { ProjectRepository } from '@itphx/synth-core';
|
|
27
|
+
import type { AuthKit } from '../auth/middleware.js';
|
|
28
|
+
import type { BackendProjectAccess } from './project-access.js';
|
|
29
|
+
export interface BackendScheduleAccessDeps {
|
|
30
|
+
/** AuthKit backend (OIDC/RBAC). */
|
|
31
|
+
auth: AuthKit;
|
|
32
|
+
/** Порт проектов — по нему резолвятся права на проект расписания. */
|
|
33
|
+
projectStore: ProjectRepository;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Реализации опций core-фабрики расписаний (`createSchedulerRoutes`):
|
|
37
|
+
* граничная проверка прав на проект и скоуп видимости списка.
|
|
38
|
+
*/
|
|
39
|
+
export type BackendScheduleAccess = BackendProjectAccess;
|
|
40
|
+
/**
|
|
41
|
+
* Собрать managed-правило доступа к расписаниям.
|
|
42
|
+
*
|
|
43
|
+
* Правило — общее для автоматизаций (`createBackendProjectAccess`); здесь
|
|
44
|
+
* только привязка к зависимостям расписаний.
|
|
45
|
+
*/
|
|
46
|
+
export declare function createBackendScheduleAccess(deps: BackendScheduleAccessDeps): BackendScheduleAccess;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { createBackendProjectAccess } from './project-access.js';
|
|
2
|
+
/**
|
|
3
|
+
* Собрать managed-правило доступа к расписаниям.
|
|
4
|
+
*
|
|
5
|
+
* Правило — общее для автоматизаций (`createBackendProjectAccess`); здесь
|
|
6
|
+
* только привязка к зависимостям расписаний.
|
|
7
|
+
*/
|
|
8
|
+
export function createBackendScheduleAccess(deps) {
|
|
9
|
+
return createBackendProjectAccess(deps);
|
|
10
|
+
}
|
|
@@ -15,9 +15,14 @@ import type { BlobRefRepository, BlobStore } from '@itphx/synth-core';
|
|
|
15
15
|
import type { AttachmentThumbnailProvider } from '@itphx/synth-core';
|
|
16
16
|
import type { AttachmentsConfig, StickyNotesLimits } from '@itphx/synth-shared';
|
|
17
17
|
import type { QuestionService } from '@itphx/synth-core';
|
|
18
|
+
import type { SessionMoveService } from '@itphx/synth-core';
|
|
18
19
|
import type { WorktreeService } from '@itphx/synth-core';
|
|
19
20
|
import type { BackgroundRunService } from '@itphx/synth-core';
|
|
20
21
|
import type { ApprovalRegistry } from '@itphx/synth-core';
|
|
22
|
+
import type { ExecutionProfileCatalog } from '@itphx/synth-core';
|
|
23
|
+
import type { SnippetService } from '@itphx/synth-core';
|
|
24
|
+
import type { ScriptService, CommandAuditLog } from '@itphx/synth-core';
|
|
25
|
+
import type { PermissionConfig } from '@itphx/synth-shared';
|
|
21
26
|
/**
|
|
22
27
|
* Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
|
|
23
28
|
* backend-специфичные роуты (MCP-скоуп сессии и секреты — более строгая политика
|
|
@@ -116,4 +121,51 @@ llmAvailability?: {
|
|
|
116
121
|
* import/export/fork/merge) — live-геттер. Не задан — 10 (прежнее поведение).
|
|
117
122
|
* `0` — без ограничения; значение применяется без рестарта.
|
|
118
123
|
*/
|
|
119
|
-
getSessionOpsPerMinute?: () => number
|
|
124
|
+
getSessionOpsPerMinute?: () => number,
|
|
125
|
+
/**
|
|
126
|
+
* PROP-135 Ф6a: каталог профилей исполнения (`execution.remote`) —
|
|
127
|
+
* валидация `settings.executorProfile` в PATCH /:id. Не задан — проверка
|
|
128
|
+
* существования профиля пропускается (поведение прежнее).
|
|
129
|
+
*/
|
|
130
|
+
executionProfileCatalog?: ExecutionProfileCatalog,
|
|
131
|
+
/**
|
|
132
|
+
* PROP-135 (браузерный контур): каталог браузерных профилей — валидация
|
|
133
|
+
* `settings.browserProfile` в PATCH /:id.
|
|
134
|
+
*/
|
|
135
|
+
browserProfileCatalog?: ExecutionProfileCatalog,
|
|
136
|
+
/**
|
|
137
|
+
* ADR-126 §4: сервис сниппетов (`#`) — раскрытие `#токен` в пользовательском
|
|
138
|
+
* тексте на входе промпта (до очереди). Не задан — раскрытия нет.
|
|
139
|
+
*/
|
|
140
|
+
snippetService?: SnippetService,
|
|
141
|
+
/**
|
|
142
|
+
* ADR-126 §4: абсолютный рабочий каталог проекта по id — для project-уровня
|
|
143
|
+
* сниппетов. Не задан — workspace берётся из карточки проекта как есть.
|
|
144
|
+
*/
|
|
145
|
+
resolveProjectWorkspace?: (projectId: string) => Promise<string | undefined>,
|
|
146
|
+
/**
|
|
147
|
+
* ADR-126 §5: сервис реестра скриптов проекта (`!`-запуск) — HTTP-контур
|
|
148
|
+
* `/api/v2/sessions/:id/scripts*`. Не задан — контура нет.
|
|
149
|
+
*/
|
|
150
|
+
scriptService?: ScriptService,
|
|
151
|
+
/**
|
|
152
|
+
* ADR-126 §5: правила прав инстанса — fallback для правила
|
|
153
|
+
* `permission.rules.script` (собственные правила сессии важнее).
|
|
154
|
+
*/
|
|
155
|
+
permissionConfig?: PermissionConfig,
|
|
156
|
+
/**
|
|
157
|
+
* ADR-136: журнал исполнений команд — запись `script.run` (только
|
|
158
|
+
* метаданные).
|
|
159
|
+
*/
|
|
160
|
+
commandAudit?: CommandAuditLog,
|
|
161
|
+
/**
|
|
162
|
+
* ADR-126 §5: рабочий каталог по умолчанию — фоллбек для сессии **без
|
|
163
|
+
* проекта** (`.synth/scripts` из default workspace, как у `!`-запуска).
|
|
164
|
+
*/
|
|
165
|
+
defaultWorkingDir?: string,
|
|
166
|
+
/**
|
|
167
|
+
* PROP-141 (Часть D): сервис переноса сессии между проектами (единый шов:
|
|
168
|
+
* блокеры, согласие `move_consent`, порядок эффектов). Не задан — перенос
|
|
169
|
+
* между проектами недоступен (`PATCH { project_id }` → 500).
|
|
170
|
+
*/
|
|
171
|
+
moveService?: SessionMoveService): Hono;
|
package/dist/routes/sessions.js
CHANGED
|
@@ -4,6 +4,8 @@ import { createRateLimiter } from '../middleware/rate-limiter.js';
|
|
|
4
4
|
import { scopeGuard, serviceProjectProjection } from '../auth/service-scope.js';
|
|
5
5
|
import { enqueueUserMessage, serializeSession, createSessionAccessGuard, createSessionAccessPredicate, createSessionExportGuard, getSessionExportDecision, isSessionExportPath, createSessionRoutes as createCoreSessionRoutes, stripSessionSecrets, resolveUserPrincipal, } from '@itphx/synth-core';
|
|
6
6
|
import { t } from '../lib/i18n.js';
|
|
7
|
+
import { groupsOf } from '../lib/project-principal.js';
|
|
8
|
+
import { resolveVisibleProjectIds } from '../events/visible-session-ids.js';
|
|
7
9
|
import { createProjectAccess } from './projects.js';
|
|
8
10
|
/**
|
|
9
11
|
* Максимум сессий в одном пакетном импорте (`POST /sessions/import-batch`).
|
|
@@ -93,7 +95,54 @@ llmAvailability,
|
|
|
93
95
|
* import/export/fork/merge) — live-геттер. Не задан — 10 (прежнее поведение).
|
|
94
96
|
* `0` — без ограничения; значение применяется без рестарта.
|
|
95
97
|
*/
|
|
96
|
-
getSessionOpsPerMinute
|
|
98
|
+
getSessionOpsPerMinute,
|
|
99
|
+
/**
|
|
100
|
+
* PROP-135 Ф6a: каталог профилей исполнения (`execution.remote`) —
|
|
101
|
+
* валидация `settings.executorProfile` в PATCH /:id. Не задан — проверка
|
|
102
|
+
* существования профиля пропускается (поведение прежнее).
|
|
103
|
+
*/
|
|
104
|
+
executionProfileCatalog,
|
|
105
|
+
/**
|
|
106
|
+
* PROP-135 (браузерный контур): каталог браузерных профилей — валидация
|
|
107
|
+
* `settings.browserProfile` в PATCH /:id.
|
|
108
|
+
*/
|
|
109
|
+
browserProfileCatalog,
|
|
110
|
+
/**
|
|
111
|
+
* ADR-126 §4: сервис сниппетов (`#`) — раскрытие `#токен` в пользовательском
|
|
112
|
+
* тексте на входе промпта (до очереди). Не задан — раскрытия нет.
|
|
113
|
+
*/
|
|
114
|
+
snippetService,
|
|
115
|
+
/**
|
|
116
|
+
* ADR-126 §4: абсолютный рабочий каталог проекта по id — для project-уровня
|
|
117
|
+
* сниппетов. Не задан — workspace берётся из карточки проекта как есть.
|
|
118
|
+
*/
|
|
119
|
+
resolveProjectWorkspace,
|
|
120
|
+
/**
|
|
121
|
+
* ADR-126 §5: сервис реестра скриптов проекта (`!`-запуск) — HTTP-контур
|
|
122
|
+
* `/api/v2/sessions/:id/scripts*`. Не задан — контура нет.
|
|
123
|
+
*/
|
|
124
|
+
scriptService,
|
|
125
|
+
/**
|
|
126
|
+
* ADR-126 §5: правила прав инстанса — fallback для правила
|
|
127
|
+
* `permission.rules.script` (собственные правила сессии важнее).
|
|
128
|
+
*/
|
|
129
|
+
permissionConfig,
|
|
130
|
+
/**
|
|
131
|
+
* ADR-136: журнал исполнений команд — запись `script.run` (только
|
|
132
|
+
* метаданные).
|
|
133
|
+
*/
|
|
134
|
+
commandAudit,
|
|
135
|
+
/**
|
|
136
|
+
* ADR-126 §5: рабочий каталог по умолчанию — фоллбек для сессии **без
|
|
137
|
+
* проекта** (`.synth/scripts` из default workspace, как у `!`-запуска).
|
|
138
|
+
*/
|
|
139
|
+
defaultWorkingDir,
|
|
140
|
+
/**
|
|
141
|
+
* PROP-141 (Часть D): сервис переноса сессии между проектами (единый шов:
|
|
142
|
+
* блокеры, согласие `move_consent`, порядок эффектов). Не задан — перенос
|
|
143
|
+
* между проектами недоступен (`PATCH { project_id }` → 500).
|
|
144
|
+
*/
|
|
145
|
+
moveService) {
|
|
97
146
|
const app = new Hono();
|
|
98
147
|
const agentRegistry = orchestrator.agentRegistry;
|
|
99
148
|
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
@@ -246,30 +295,40 @@ getSessionOpsPerMinute) {
|
|
|
246
295
|
}, 400);
|
|
247
296
|
}
|
|
248
297
|
}
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
if (
|
|
254
|
-
|
|
255
|
-
|
|
298
|
+
// Тоггл/список — метаданные сессии: точечная правка под локом порта
|
|
299
|
+
// (`mutateMeta`); история и очередь не перезаписываются. `updatedAt`
|
|
300
|
+
// двигается — паритет с прежним `updateSession`.
|
|
301
|
+
const scoped = await sessionManager.mutateMeta(session.id, (meta) => {
|
|
302
|
+
if (name !== undefined) {
|
|
303
|
+
// Точечный toggle: enabled → session.enabled; disabled → opt-out.
|
|
304
|
+
const enabledList = new Set(meta.settings.mcpServers ?? []);
|
|
305
|
+
const disabledList = new Set(meta.settings.mcpDisabledServers ?? []);
|
|
306
|
+
if (enabled === false) {
|
|
307
|
+
enabledList.delete(name);
|
|
308
|
+
disabledList.add(name);
|
|
309
|
+
}
|
|
310
|
+
else {
|
|
311
|
+
enabledList.add(name);
|
|
312
|
+
disabledList.delete(name);
|
|
313
|
+
}
|
|
314
|
+
meta.settings.mcpServers = [...enabledList];
|
|
315
|
+
meta.settings.mcpDisabledServers = [...disabledList];
|
|
256
316
|
}
|
|
257
317
|
else {
|
|
258
|
-
|
|
259
|
-
|
|
318
|
+
if (mcpServers !== undefined)
|
|
319
|
+
meta.settings.mcpServers = mcpServers;
|
|
320
|
+
if (mcpDisabledServers !== undefined)
|
|
321
|
+
meta.settings.mcpDisabledServers = mcpDisabledServers;
|
|
260
322
|
}
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
if (mcpServers !== undefined)
|
|
266
|
-
session.settings.mcpServers = mcpServers;
|
|
267
|
-
if (mcpDisabledServers !== undefined)
|
|
268
|
-
session.settings.mcpDisabledServers = mcpDisabledServers;
|
|
323
|
+
return meta.settings;
|
|
324
|
+
});
|
|
325
|
+
if (!scoped.found) {
|
|
326
|
+
return c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.session', undefined, c) } }, 404);
|
|
269
327
|
}
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
328
|
+
// Свежий снимок — для события и ответа.
|
|
329
|
+
const updatedSession = (await sessionManager.getSession(session.id)) ?? session;
|
|
330
|
+
eventBus.publish(updatedSession.id, 'session.updated', serializeSession(updatedSession, { agentRegistry }));
|
|
331
|
+
return c.json(await buildSessionMcpPayload(updatedSession));
|
|
273
332
|
});
|
|
274
333
|
// GET /api/v2/sessions/:id/secrets — карта обфускации LLM Gateway (ADR-036).
|
|
275
334
|
// RBAC: только ADMIN/AUDITOR — сама карта является секретом.
|
|
@@ -618,9 +677,12 @@ getSessionOpsPerMinute) {
|
|
|
618
677
|
// форвардятся на backend). Свои `/:id/mcp` и `/:id/secrets` зарегистрированы
|
|
619
678
|
// ВЫШЕ и сохраняют более строгую политику managed (владелец|ADMIN и
|
|
620
679
|
// ADMIN|AUDITOR соответственно) — порядок регистрации оставляет её в силе.
|
|
621
|
-
app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics, ...(memory ? { memory } : {}), ...(questionService ? { questionService } : {}), ...(worktreeService ? { worktreeService } : {}), ...(attachments ? { attachments } : {}), ...(backgroundService ? { backgroundService } : {}), ...(approvalRegistry ? { approvalRegistry } : {}), ...(llmAvailability ? { llmAvailability } : {}) }, {
|
|
680
|
+
app.route('/', createCoreSessionRoutes({ requireAuth: kit.requireAuth }, { sessionManager, eventBus, queueManager, processMessage, orchestrator, contextOptimizer, projectStore, profilesStore, requestSessionService, analytics, ...(memory ? { memory } : {}), ...(questionService ? { questionService } : {}), ...(worktreeService ? { worktreeService } : {}), ...(attachments ? { attachments } : {}), ...(backgroundService ? { backgroundService } : {}), ...(approvalRegistry ? { approvalRegistry } : {}), ...(llmAvailability ? { llmAvailability } : {}), ...(executionProfileCatalog ? { executionProfileCatalog } : {}), ...(browserProfileCatalog ? { browserProfileCatalog } : {}), ...(snippetService ? { snippetService } : {}), ...(resolveProjectWorkspace ? { resolveProjectWorkspace } : {}), ...(scriptService ? { scriptService } : {}), ...(permissionConfig ? { permissionConfig } : {}), ...(commandAudit ? { commandAudit } : {}), ...(defaultWorkingDir ? { defaultWorkingDir } : {}), ...(moveService ? { moveService } : {}) }, {
|
|
622
681
|
resolveUserId: async (c) => (await kit.getCurrentUser(c)).id,
|
|
623
682
|
resolveOwner: async (c) => (await kit.getCurrentUser(c)).id,
|
|
683
|
+
// ADR-140 Ф2: группы пользователя запроса (снимок claim'а IdP) — кладутся
|
|
684
|
+
// в принципал хода при приёме ввода; нет — групп нет (fail-closed).
|
|
685
|
+
resolveUserGroups: (c) => groupsOf(c.get('user')),
|
|
624
686
|
forkWithOwner: true,
|
|
625
687
|
// Доступ к сессии обеспечивает единый prefix-guard ресурса (см. выше):
|
|
626
688
|
// `registerAccessGuard: false` отключает собственный guard core-фабрики,
|
|
@@ -635,18 +697,22 @@ getSessionOpsPerMinute) {
|
|
|
635
697
|
return isAdmin || isLead;
|
|
636
698
|
},
|
|
637
699
|
// ADR-089: проекты-участия пользователя — проектные сессии видны участникам.
|
|
638
|
-
|
|
700
|
+
// PROP-133 §6: список — **все** проекты, где у пользователя есть роль
|
|
701
|
+
// (владелец/участник/грант по группе/«всем пользователям»), а не только
|
|
702
|
+
// записи в `members`. Тот же шов использует хаб подписок.
|
|
703
|
+
resolveMemberProjectIds: async (c, userId) => {
|
|
639
704
|
if (!projectStore)
|
|
640
705
|
return [];
|
|
641
|
-
const
|
|
642
|
-
|
|
706
|
+
const user = await kit.getCurrentUser(c);
|
|
707
|
+
const groups = groupsOf(user);
|
|
708
|
+
return resolveVisibleProjectIds(projectStore, { userId, ...(groups ? { groups } : {}) });
|
|
643
709
|
},
|
|
644
710
|
resolveAuthor: async (c) => (await kit.getCurrentUser(c)).username,
|
|
645
711
|
// ADR-106 Ф3: принципал ответа на подтверждение — аутентифицированный
|
|
646
712
|
// пользователь запроса (клиенту не доверяем) и его роли инстанса.
|
|
647
713
|
resolvePermissionResponder: async (c) => {
|
|
648
714
|
const user = await kit.getCurrentUser(c);
|
|
649
|
-
return { kind: 'user', id: user?.id ?? '', roles: user?.roles ?? [] };
|
|
715
|
+
return { kind: 'user', id: user?.id ?? '', roles: user?.roles ?? [], groups: user?.groups ?? [] };
|
|
650
716
|
},
|
|
651
717
|
publishRenamed: false,
|
|
652
718
|
publishDeletedBefore: false,
|
package/dist/routes/users.d.ts
CHANGED
|
@@ -1,4 +1,17 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
3
|
import type { ProfileStore } from '@itphx/synth-shared';
|
|
4
|
-
|
|
4
|
+
/**
|
|
5
|
+
* ADR-140 Ф2: список групп, которые вообще можно выдать пользователю.
|
|
6
|
+
*
|
|
7
|
+
* Источник — allowlist имён групп из `auth.oidc.groups.allow` (конфиг/env
|
|
8
|
+
* `SYNTH_OIDC_GROUPS_ALLOW`): показываются только те группы, которые есть в
|
|
9
|
+
* allowlist, — «принять всё» невозможно (пустой allowlist → пустой список,
|
|
10
|
+
* fail-closed). Доступ — **любой аутентифицированный** пользователь (как
|
|
11
|
+
* `/directory`): группы нужны владельцу проекта для выбора участников.
|
|
12
|
+
*/
|
|
13
|
+
export interface UserRoutesOptions {
|
|
14
|
+
/** Allowlist имён групп (ADR-140 Ф2); пусто — групп нет. */
|
|
15
|
+
groups?: readonly string[];
|
|
16
|
+
}
|
|
17
|
+
export declare function createUserRoutes(kit: AuthKit, profiles: ProfileStore, options?: UserRoutesOptions): Hono;
|
package/dist/routes/users.js
CHANGED
|
@@ -3,8 +3,98 @@ import { nowISO } from '@itphx/synth-shared';
|
|
|
3
3
|
import { randomUUID } from 'node:crypto';
|
|
4
4
|
import { t } from '../lib/i18n.js';
|
|
5
5
|
import { requireAdminOrScope } from '../auth/guards.js';
|
|
6
|
-
|
|
6
|
+
import { principalIdOf } from '../lib/principal-identity.js';
|
|
7
|
+
import { parseBoundedInt, paginate } from '@itphx/synth-core';
|
|
8
|
+
/**
|
|
9
|
+
* PROP-133 §3.3: страница каталога пользователей — постранично, как прочие
|
|
10
|
+
* списки (ADR-118 §4): дефолт 50, потолок 200.
|
|
11
|
+
*/
|
|
12
|
+
const DEFAULT_DIRECTORY_LIMIT = 50;
|
|
13
|
+
const MAX_DIRECTORY_LIMIT = 200;
|
|
14
|
+
export function createUserRoutes(kit, profiles, options) {
|
|
7
15
|
const app = new Hono();
|
|
16
|
+
// GET /api/v2/users/directory — лёгкий каталог для выбора участников
|
|
17
|
+
// (PROP-133 §3.3): доступ **любому аутентифицированному** пользователю
|
|
18
|
+
// (иначе владелец проекта физически не может выбрать участников: `/users`
|
|
19
|
+
// — только ADMIN). Ответ — только `{id, username, display_name}`: ролей,
|
|
20
|
+
// почты, идентичностей и заметок в каталоге нет.
|
|
21
|
+
// Маршрут объявлен **до** `/:id`, чтобы не перехватывался параметрическим.
|
|
22
|
+
app.get('/directory', kit.requireAuth, async (c) => {
|
|
23
|
+
const limit = parseBoundedInt(c.req.query('limit'), DEFAULT_DIRECTORY_LIMIT, MAX_DIRECTORY_LIMIT);
|
|
24
|
+
if (limit === null) {
|
|
25
|
+
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidDirectoryLimit', undefined, c) } }, 400);
|
|
26
|
+
}
|
|
27
|
+
const offset = parseBoundedInt(c.req.query('offset'), 0, Number.MAX_SAFE_INTEGER);
|
|
28
|
+
if (offset === null) {
|
|
29
|
+
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidDirectoryOffset', undefined, c) } }, 400);
|
|
30
|
+
}
|
|
31
|
+
const query = (c.req.query('q') ?? '').trim().toLowerCase();
|
|
32
|
+
const all = await profiles.listProfiles();
|
|
33
|
+
// Неактивные пользователи в каталог не попадают (деактивированного
|
|
34
|
+
// участника выбрать нельзя) — и `is_active` наружу не отдаётся.
|
|
35
|
+
const filtered = all
|
|
36
|
+
.filter((profile) => profile.isActive !== false)
|
|
37
|
+
.filter((profile) => {
|
|
38
|
+
if (!query)
|
|
39
|
+
return true;
|
|
40
|
+
const username = profile.username.toLowerCase();
|
|
41
|
+
const displayName = (profile.displayName ?? '').toLowerCase();
|
|
42
|
+
return username.includes(query) || displayName.includes(query);
|
|
43
|
+
})
|
|
44
|
+
.sort((a, b) => (a.username < b.username ? -1 : a.username > b.username ? 1 : 0));
|
|
45
|
+
// ADR-140: в каталоге — ACL-id принципала (auth-идентичность: OIDC
|
|
46
|
+
// `sub`/debug-id), а не внутренний `profile.id`: по этому id UI выдаёт
|
|
47
|
+
// гранты (`members`) и передаёт владение (`owner_id`). Профили без
|
|
48
|
+
// auth-идентичности (legacy) отдаются по `profile.id`.
|
|
49
|
+
// Дедуп по этому id: два профиля с одним принципалом — один элемент.
|
|
50
|
+
const byPrincipal = new Map();
|
|
51
|
+
for (const profile of filtered) {
|
|
52
|
+
const principalId = principalIdOf(profile);
|
|
53
|
+
if (!byPrincipal.has(principalId))
|
|
54
|
+
byPrincipal.set(principalId, profile);
|
|
55
|
+
}
|
|
56
|
+
const deduped = [...byPrincipal.values()];
|
|
57
|
+
const { page, total, next_offset } = paginate(deduped, offset, limit);
|
|
58
|
+
return c.json({
|
|
59
|
+
users: page.map((profile) => ({
|
|
60
|
+
id: principalIdOf(profile),
|
|
61
|
+
username: profile.username,
|
|
62
|
+
display_name: profile.displayName || null,
|
|
63
|
+
})),
|
|
64
|
+
total,
|
|
65
|
+
offset,
|
|
66
|
+
limit,
|
|
67
|
+
next_offset,
|
|
68
|
+
});
|
|
69
|
+
});
|
|
70
|
+
// GET /api/v2/users/groups — каталог групп, которые можно выдать (ADR-140 Ф2).
|
|
71
|
+
// Источник — allowlist `auth.oidc.groups.allow`: показываем только те группы,
|
|
72
|
+
// которые вообще можно выдать (пустой allowlist → пустой список, fail-closed).
|
|
73
|
+
// Доступ — любой аутентифицированный пользователь (как `/directory`): группы
|
|
74
|
+
// нужны владельцу проекта для выбора участников. Маршрут объявлен **до**
|
|
75
|
+
// `/:id`, чтобы не перехватывался параметрическим.
|
|
76
|
+
app.get('/groups', kit.requireAuth, async (c) => {
|
|
77
|
+
const limit = parseBoundedInt(c.req.query('limit'), DEFAULT_DIRECTORY_LIMIT, MAX_DIRECTORY_LIMIT);
|
|
78
|
+
if (limit === null) {
|
|
79
|
+
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidDirectoryLimit', undefined, c) } }, 400);
|
|
80
|
+
}
|
|
81
|
+
const offset = parseBoundedInt(c.req.query('offset'), 0, Number.MAX_SAFE_INTEGER);
|
|
82
|
+
if (offset === null) {
|
|
83
|
+
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidDirectoryOffset', undefined, c) } }, 400);
|
|
84
|
+
}
|
|
85
|
+
const query = (c.req.query('q') ?? '').trim().toLowerCase();
|
|
86
|
+
const all = [...new Set((options?.groups ?? []).map((g) => g.trim()).filter(Boolean))]
|
|
87
|
+
.filter((name) => !query || name.toLowerCase().includes(query))
|
|
88
|
+
.sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
|
|
89
|
+
const { page, total, next_offset } = paginate(all, offset, limit);
|
|
90
|
+
return c.json({
|
|
91
|
+
groups: page.map((name) => ({ name })),
|
|
92
|
+
total,
|
|
93
|
+
offset,
|
|
94
|
+
limit,
|
|
95
|
+
next_offset,
|
|
96
|
+
});
|
|
97
|
+
});
|
|
8
98
|
// GET /api/v2/users — список всех пользователей (ADMIN или scope `users:read`).
|
|
9
99
|
// Идентичности сознательно не включаются: список не раздувается (детали — в /:id).
|
|
10
100
|
app.get('/', requireAdminOrScope('users:read'), async (c) => {
|