@itphx/synth-backend 0.8.8 → 0.10.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.
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Guard «ADMIN **или** scope»:
3
+ * - запрос с service-key → требуется хотя бы один из `scopes`
4
+ * (`403 SCOPE_REQUIRED` иначе);
5
+ * - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
6
+ * роль ADMIN (`403 FORBIDDEN` иначе) — прежнее поведение этих роутов.
7
+ *
8
+ * Требует уже отработавшего `attachUser`/`requireAuth` (пользователь/ключ в
9
+ * контексте). Используется на мутациях реестра MCP (`/servers*`), записи
10
+ * скиллов и чтении пользователей.
11
+ */
12
+ export declare function requireAdminOrScope(...scopes: string[]): import("hono").MiddlewareHandler<any, string, {}, Response>;
13
+ /**
14
+ * Guard «service-key → scope»: для service-key требует хотя бы один из `scopes`;
15
+ * интерактивные креды пропускает без изменений (их гейтит `requireAuth`/логика
16
+ * роута). Нужен там, где интерактивный доступ **не** ограничен ADMIN — например,
17
+ * `POST /api/v2/mcp/registry` (любой пользователь добавляет свой HTTP-сервер,
18
+ * stdio — только ADMIN в теле роута).
19
+ */
20
+ export declare function requireScopeForServiceKey(...scopes: string[]): import("hono").MiddlewareHandler<any, string, {}, Response>;
@@ -0,0 +1,65 @@
1
+ import { createMiddleware } from 'hono/factory';
2
+ import { getServiceCredential } from '@itphx/synth-core';
3
+ import { hasServiceScope } from '@itphx/synth-shared';
4
+ import { t } from '../lib/i18n.js';
5
+ /**
6
+ * AD-052/O1: комбинированные guard'ы «ADMIN **или** scope» для эндпоинтов,
7
+ * которые должны быть доступны и человеку-ADMIN, и installer-service-key'ю.
8
+ *
9
+ * `requireScope` (core) — no-op для интерактивных кред, поэтому одиночного
10
+ * scope-гейта недостаточно: нужно «если service-key → требуем scope; иначе —
11
+ * прежнее поведение (ADMIN)». Здесь и живёт эта развилка; enforcement scopes —
12
+ * `hasServiceScope` (shared), чтение контекста — `getServiceCredential` (core).
13
+ */
14
+ /** 403 SCOPE_REQUIRED (i18n backend) — service-key без нужного scope. */
15
+ function scopeDenied(c) {
16
+ return c.json({ error: { code: 'SCOPE_REQUIRED', message: t('errors.forbidden.scopeRequired', undefined, c) } }, 403);
17
+ }
18
+ /** `true`, если в контексте ADMIN (роли synthetic service-пользователя или человека). */
19
+ function isAdmin(c) {
20
+ const user = c.get('user');
21
+ return !!user && Array.isArray(user.roles) && user.roles.includes('ADMIN');
22
+ }
23
+ /**
24
+ * Guard «ADMIN **или** scope»:
25
+ * - запрос с service-key → требуется хотя бы один из `scopes`
26
+ * (`403 SCOPE_REQUIRED` иначе);
27
+ * - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
28
+ * роль ADMIN (`403 FORBIDDEN` иначе) — прежнее поведение этих роутов.
29
+ *
30
+ * Требует уже отработавшего `attachUser`/`requireAuth` (пользователь/ключ в
31
+ * контексте). Используется на мутациях реестра MCP (`/servers*`), записи
32
+ * скиллов и чтении пользователей.
33
+ */
34
+ export function requireAdminOrScope(...scopes) {
35
+ return createMiddleware(async (c, next) => {
36
+ const cred = getServiceCredential(c);
37
+ if (cred) {
38
+ if (!scopes.some((scope) => hasServiceScope(cred.scopes, scope))) {
39
+ return scopeDenied(c);
40
+ }
41
+ await next();
42
+ return;
43
+ }
44
+ if (!isAdmin(c)) {
45
+ return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
46
+ }
47
+ await next();
48
+ });
49
+ }
50
+ /**
51
+ * Guard «service-key → scope»: для service-key требует хотя бы один из `scopes`;
52
+ * интерактивные креды пропускает без изменений (их гейтит `requireAuth`/логика
53
+ * роута). Нужен там, где интерактивный доступ **не** ограничен ADMIN — например,
54
+ * `POST /api/v2/mcp/registry` (любой пользователь добавляет свой HTTP-сервер,
55
+ * stdio — только ADMIN в теле роута).
56
+ */
57
+ export function requireScopeForServiceKey(...scopes) {
58
+ return createMiddleware(async (c, next) => {
59
+ const cred = getServiceCredential(c);
60
+ if (cred && !scopes.some((scope) => hasServiceScope(cred.scopes, scope))) {
61
+ return scopeDenied(c);
62
+ }
63
+ await next();
64
+ });
65
+ }
@@ -1,6 +1,20 @@
1
1
  import type { AuthConfig, User } from '@itphx/synth-shared';
2
+ import type { ServiceKeyCredential } from '@itphx/synth-core';
2
3
  import { setCookie, deleteCookie } from 'hono/cookie';
3
- export declare function createAuthMiddleware(config: AuthConfig): {
4
+ /**
5
+ * AD-052 (этап I): резолвер service-key (`synth_svc_…`) → синтетический
6
+ * пользователь (RBAC) + контекст (`scopes`/`allowedProjects`/лимит).
7
+ * `null` — секрет неизвестен/отозван/истёк либо резолвер не настроен.
8
+ */
9
+ export type ServiceKeyResolver = (rawSecret: string) => Promise<{
10
+ user: User;
11
+ credential: ServiceKeyCredential;
12
+ } | null>;
13
+ /** Конфиг backend-auth: `AuthConfig` + service-key (AD-052). */
14
+ export interface AuthMiddlewareConfig extends AuthConfig {
15
+ resolveServiceKey?: ServiceKeyResolver;
16
+ }
17
+ export declare function createAuthMiddleware(config: AuthMiddlewareConfig): {
4
18
  getCurrentUser: (c: {
5
19
  req: {
6
20
  header(name: string): string | undefined;
@@ -1,3 +1,4 @@
1
+ import { isServiceKeySecret } from '@itphx/synth-core';
1
2
  import { createMiddleware } from 'hono/factory';
2
3
  import { getCookie, setCookie, deleteCookie } from 'hono/cookie';
3
4
  import { t } from '../lib/i18n.js';
@@ -24,8 +25,25 @@ function extractBearerToken(h) {
24
25
  export function createAuthMiddleware(config) {
25
26
  // Ленивый OIDC-клиент (мемоизация, безопасно при отсутствии oidc — null)
26
27
  const getOidcClient = createLazyOidcClient(config.oidc);
28
+ /**
29
+ * AD-052: машинная аутентификация по service-key. Распознаётся по префиксу
30
+ * секрета `synth_svc_`; резолвер асинхронный (стор + touch `lastUsedAt`),
31
+ * поэтому ветка живёт в middleware, а не в синхронном `getCurrentUser`.
32
+ */
33
+ const resolveServiceKey = async (c) => {
34
+ if (!config.resolveServiceKey)
35
+ return null;
36
+ const token = extractBearerToken(c.req.header('Authorization'));
37
+ if (!token || !isServiceKeySecret(token))
38
+ return null;
39
+ return config.resolveServiceKey(token);
40
+ };
27
41
  // Определить пользователя из запроса
28
42
  const getCurrentUser = async (c) => {
43
+ // 0. AD-052: service-key — синтетический пользователь ключа.
44
+ const serviceAuth = await resolveServiceKey(c);
45
+ if (serviceAuth)
46
+ return serviceAuth.user;
29
47
  // 1. Cookie-сессия
30
48
  const sessionId = typeof getCookie === 'function'
31
49
  ? getCookie(c, SESSION_COOKIE)
@@ -102,6 +120,14 @@ export function createAuthMiddleware(config) {
102
120
  };
103
121
  // Middleware: прикрепить пользователя к контексту (без ошибки)
104
122
  const attachUser = createMiddleware(async (c, next) => {
123
+ // AD-052: service-key несёт и пользователя, и контекст (scopes/проекция).
124
+ const serviceAuth = await resolveServiceKey(c);
125
+ if (serviceAuth) {
126
+ c.set('user', serviceAuth.user);
127
+ c.set('serviceKey', serviceAuth.credential);
128
+ await next();
129
+ return;
130
+ }
105
131
  const user = await getCurrentUser(c);
106
132
  if (user)
107
133
  c.set('user', user);
@@ -109,6 +135,18 @@ export function createAuthMiddleware(config) {
109
135
  });
110
136
  // Middleware: требовать аутентификации
111
137
  const requireAuth = createMiddleware(async (c, next) => {
138
+ // attachUser уже мог установить пользователя (в т.ч. service-key).
139
+ if (c.get('user')) {
140
+ await next();
141
+ return;
142
+ }
143
+ const serviceAuth = await resolveServiceKey(c);
144
+ if (serviceAuth) {
145
+ c.set('user', serviceAuth.user);
146
+ c.set('serviceKey', serviceAuth.credential);
147
+ await next();
148
+ return;
149
+ }
112
150
  const user = await getCurrentUser(c);
113
151
  if (!user) {
114
152
  return c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
@@ -0,0 +1,14 @@
1
+ import type { ProjectGuard, ScopeGuardFactory } from '@itphx/synth-core';
2
+ /**
3
+ * AD-052 (этап I): backend-обёртки scope-гейтов service-key.
4
+ *
5
+ * Enforcement (`hasServiceScope`/`isProjectAllowed`) остаётся в core —
6
+ * здесь только локализация отказов (`SCOPE_REQUIRED`/`PROJECT_FORBIDDEN`)
7
+ * через backend-i18n. Для интерактивных кред (нет `serviceKey` в контексте)
8
+ * оба гейта пропускают запрос, поэтому managed-поведение без service-key
9
+ * не меняется.
10
+ */
11
+ /** Scope-гейт: делегирует проверку core-`requireScope`, переводит 403 на i18n. */
12
+ export declare const scopeGuard: ScopeGuardFactory;
13
+ /** Гейт проектной проекции: делегирует core-`checkProjectAccess`, переводит 403. */
14
+ export declare const projectGuard: ProjectGuard;
@@ -0,0 +1,40 @@
1
+ import { createMiddleware } from 'hono/factory';
2
+ import { requireScope, checkProjectAccess } from '@itphx/synth-core';
3
+ import { t } from '../lib/i18n.js';
4
+ /**
5
+ * AD-052 (этап I): backend-обёртки scope-гейтов service-key.
6
+ *
7
+ * Enforcement (`hasServiceScope`/`isProjectAllowed`) остаётся в core —
8
+ * здесь только локализация отказов (`SCOPE_REQUIRED`/`PROJECT_FORBIDDEN`)
9
+ * через backend-i18n. Для интерактивных кред (нет `serviceKey` в контексте)
10
+ * оба гейта пропускают запрос, поэтому managed-поведение без service-key
11
+ * не меняется.
12
+ */
13
+ /** Scope-гейт: делегирует проверку core-`requireScope`, переводит 403 на i18n. */
14
+ export const scopeGuard = (...required) => {
15
+ const guard = requireScope(...required);
16
+ return createMiddleware(async (c, next) => {
17
+ const denied = await guard(c, async () => { });
18
+ if (denied) {
19
+ return c.json({
20
+ error: {
21
+ code: 'SCOPE_REQUIRED',
22
+ message: t('errors.forbidden.scopeRequired', undefined, c),
23
+ },
24
+ }, 403);
25
+ }
26
+ await next();
27
+ });
28
+ };
29
+ /** Гейт проектной проекции: делегирует core-`checkProjectAccess`, переводит 403. */
30
+ export const projectGuard = (c, projectId) => {
31
+ const denied = checkProjectAccess(c, projectId);
32
+ if (!denied)
33
+ return undefined;
34
+ return c.json({
35
+ error: {
36
+ code: 'PROJECT_FORBIDDEN',
37
+ message: t('errors.forbidden.projectForbidden', undefined, c),
38
+ },
39
+ }, 403);
40
+ };
@@ -4,6 +4,13 @@ import type { SessionManager } from '@itphx/synth-core';
4
4
  export interface EventClient {
5
5
  userId: string;
6
6
  username: string;
7
+ /**
8
+ * Watch-all: клиент получает события ВСЕХ сессий через глобальный поток
9
+ * `eventBus.subscribeAll`, а не только сессии владельца `userId`.
10
+ * Используется машинными watcher'ами (service-key, AD-052 этап IV) и ролями
11
+ * сквозного обзора ADMIN/LEAD (AD-089) — паритет со standalone-core SSE.
12
+ */
13
+ allSessions?: boolean;
7
14
  send(event: BusEvent): void;
8
15
  }
9
16
  /**
@@ -22,6 +29,8 @@ export declare class EventHub {
22
29
  shutdown(): void;
23
30
  subscribeToSession(userId: string, sessionId: string): Promise<void>;
24
31
  unsubscribeFromSession(userId: string, sessionId: string): void;
32
+ /** Глобальная подписка all-клиента: события всех сессий без привязки к владельцу. */
33
+ private _subscribeClientToAll;
25
34
  private _subscribeClientToSession;
26
35
  private _unsubscribeClientFromAll;
27
36
  }
@@ -1,3 +1,5 @@
1
+ /** Служебный ключ глобальной подписки all-клиента в `clientSubs`. */
2
+ const ALL_SESSIONS_KEY = '*';
1
3
  /** Безопасное чтение непустой строки из `unknown`. */
2
4
  function readString(value) {
3
5
  return typeof value === 'string' && value.length > 0 ? value : undefined;
@@ -54,6 +56,14 @@ export class EventHub {
54
56
  arr.push(client);
55
57
  this.clients.set(client.userId, arr);
56
58
  this.clientSubs.set(client, new Map());
59
+ // Watch-all (service-key watcher / ADMIN/LEAD): глобальная подписка на все
60
+ // события шины. Per-session подписок нет — владельца сессий у машинного
61
+ // аккаунта нет, а обзорные роли видят чужие сессии; дубли не нужны.
62
+ if (client.allSessions) {
63
+ this._subscribeClientToAll(client);
64
+ console.log(`[EventHub] Register client (all sessions): user=${client.username} clients=${arr.length}`);
65
+ return;
66
+ }
57
67
  const sessions = await this.sessionManager.listSessions({ userId: client.userId });
58
68
  console.log(`[EventHub] Register client: user=${client.username} clients=${arr.length} sessions=${sessions.length}`);
59
69
  for (const s of sessions) {
@@ -110,7 +120,26 @@ export class EventHub {
110
120
  }
111
121
  console.debug(`[EventHub] Unsubscribe session: session=${sessionId}`);
112
122
  }
123
+ /** Глобальная подписка all-клиента: события всех сессий без привязки к владельцу. */
124
+ _subscribeClientToAll(client) {
125
+ const subs = this.clientSubs.get(client);
126
+ if (!subs || subs.has(ALL_SESSIONS_KEY))
127
+ return;
128
+ const unsub = this.eventBus.subscribeAll((event) => {
129
+ try {
130
+ client.send(event);
131
+ }
132
+ catch {
133
+ // ignore send errors
134
+ }
135
+ });
136
+ subs.set(ALL_SESSIONS_KEY, unsub);
137
+ }
113
138
  _subscribeClientToSession(client, sessionId) {
139
+ // all-клиент покрыт глобальной подпиской — per-session подписки не нужны
140
+ // (иначе дубли доставки).
141
+ if (client.allSessions)
142
+ return;
114
143
  const subs = this.clientSubs.get(client);
115
144
  if (!subs)
116
145
  return;
package/dist/lib/i18n.js CHANGED
@@ -12,6 +12,8 @@ const en = {
12
12
  'errors.notFound.favicon': 'Favicon not found',
13
13
  'errors.notFound.route': 'Not found: {method} {path}',
14
14
  'errors.notFound.agentOverride': 'Override not found',
15
+ 'errors.notFound.identity': 'Linked identity not found',
16
+ 'errors.notFound.identityClaim': 'Confirmation code is invalid (unknown, expired, or already used)',
15
17
  // Validation errors
16
18
  'errors.validation.contentRequired': 'content is required',
17
19
  'errors.validation.nameRequired': 'name is required',
@@ -23,16 +25,44 @@ const en = {
23
25
  'errors.validation.usernameRequired': 'username is required',
24
26
  'errors.validation.groupsRequired': 'groups is required',
25
27
  'errors.validation.expectedFilesArray': 'expected { files: string[] }',
28
+ 'errors.validation.claimCodeRequired': 'Confirmation code is required',
29
+ // AD-089: приём внешних событий
30
+ 'errors.validation.invalidEvent': 'Invalid event payload',
31
+ 'errors.validation.invalidBinding': 'Invalid binding payload',
32
+ 'errors.notFound.binding': 'Binding not found',
33
+ 'errors.validation.invalidRule': 'Invalid routing rule payload',
34
+ 'errors.notFound.rule': 'Routing rule not found',
35
+ 'errors.validation.unknownAgent': 'Unknown agent in routing rule',
36
+ 'errors.validation.invalidEventKey': 'Invalid event API key',
37
+ 'errors.validation.invalidEventKeyUpdate': 'Invalid event API key update',
38
+ 'errors.notFound.eventKey': 'Event API key not found',
39
+ // AD-052 (этап I): service-key
40
+ 'errors.validation.invalidServiceKey': 'Invalid service key payload',
41
+ 'errors.notFound.serviceKey': 'Service key not found',
42
+ 'errors.conflict.serviceKeyLabel': 'Service key label is already used',
43
+ 'errors.forbidden.scopeRequired': 'Insufficient permissions: required scope is missing',
44
+ 'errors.forbidden.projectForbidden': 'Project is not available for this service key',
45
+ 'errors.rateLimited.serviceKey': 'Service key rate limit exceeded',
46
+ // AD-052 (этап II): исходящие webhooks
47
+ 'errors.validation.invalidWebhook': 'Invalid webhook subscription payload',
48
+ 'errors.notFound.webhook': 'Webhook subscription not found',
49
+ 'errors.conflict.webhookLabel': 'Webhook label is already used',
50
+ 'errors.validation.webhookTargetForbidden': 'Webhook target URL is not allowed by security policy',
51
+ 'errors.unavailable.webhooksDisabled': 'Webhook delivery is disabled',
26
52
  // Conflict errors
27
53
  'errors.conflict.usernameExists': 'A user with this username already exists',
28
54
  'errors.conflict.emailExists': 'A user with this email already exists',
29
55
  'errors.conflict.usernameTaken': 'Username is taken',
30
56
  'errors.conflict.emailTaken': 'Email is taken',
57
+ 'errors.conflict.eventKeyLabel': 'Event API key label is already used',
58
+ 'errors.conflict.identityClaim': 'This identity is already linked to another profile',
31
59
  // Other errors
32
60
  'errors.providerDisabled': 'Provider is disabled',
33
61
  'errors.connectionError': 'Connection error',
34
62
  'errors.faviconFetchError': 'Error fetching favicon',
35
63
  'errors.generic': 'Error',
64
+ 'errors.rateLimited.eventKey': 'Event API key rate limit exceeded',
65
+ 'errors.unavailable.eventsDisabled': 'External event ingestion is disabled',
36
66
  // Auth
37
67
  'auth.unauthorized': 'Authentication required',
38
68
  'auth.forbidden': 'Access denied',
@@ -64,6 +94,8 @@ const ru = {
64
94
  'errors.notFound.favicon': 'Favicon не найден',
65
95
  'errors.notFound.route': 'Не найдено: {method} {path}',
66
96
  'errors.notFound.agentOverride': 'Override не найден',
97
+ 'errors.notFound.identity': 'Привязанная идентичность не найдена',
98
+ 'errors.notFound.identityClaim': 'Код подтверждения недействителен (неизвестен, истёк или использован)',
67
99
  // Validation errors
68
100
  'errors.validation.contentRequired': 'content обязателен',
69
101
  'errors.validation.nameRequired': 'name обязателен',
@@ -75,16 +107,44 @@ const ru = {
75
107
  'errors.validation.usernameRequired': 'username обязателен',
76
108
  'errors.validation.groupsRequired': 'groups обязательны',
77
109
  'errors.validation.expectedFilesArray': 'expected { files: string[] }',
110
+ 'errors.validation.claimCodeRequired': 'Укажите код подтверждения',
111
+ // AD-089: приём внешних событий
112
+ 'errors.validation.invalidEvent': 'Некорректное тело события',
113
+ 'errors.validation.invalidBinding': 'Некорректное тело биндинга',
114
+ 'errors.notFound.binding': 'Биндинг не найден',
115
+ 'errors.validation.invalidRule': 'Некорректное тело правила маршрутизации',
116
+ 'errors.notFound.rule': 'Правило маршрутизации не найдено',
117
+ 'errors.validation.unknownAgent': 'Неизвестный агент в правиле маршрутизации',
118
+ 'errors.validation.invalidEventKey': 'Неверный API-ключ события',
119
+ 'errors.validation.invalidEventKeyUpdate': 'Некорректное тело обновления API-ключа события',
120
+ 'errors.notFound.eventKey': 'API-ключ события не найден',
121
+ // AD-052 (этап I): service-key
122
+ 'errors.validation.invalidServiceKey': 'Некорректное тело service-key',
123
+ 'errors.notFound.serviceKey': 'Service-key не найден',
124
+ 'errors.conflict.serviceKeyLabel': 'Метка service-key уже используется',
125
+ 'errors.forbidden.scopeRequired': 'Недостаточно прав: отсутствует требуемый scope',
126
+ 'errors.forbidden.projectForbidden': 'Проект недоступен для этого service-key',
127
+ 'errors.rateLimited.serviceKey': 'Превышен лимит запросов по service-key',
128
+ // AD-052 (этап II): исходящие webhooks
129
+ 'errors.validation.invalidWebhook': 'Некорректное тело webhook-подписки',
130
+ 'errors.notFound.webhook': 'Webhook-подписка не найдена',
131
+ 'errors.conflict.webhookLabel': 'Метка webhook уже используется',
132
+ 'errors.validation.webhookTargetForbidden': 'Целевой URL webhook запрещён политикой безопасности',
133
+ 'errors.unavailable.webhooksDisabled': 'Доставка webhooks отключена',
78
134
  // Conflict errors
79
135
  'errors.conflict.usernameExists': 'Пользователь с таким именем уже существует',
80
136
  'errors.conflict.emailExists': 'Пользователь с таким email уже существует',
81
137
  'errors.conflict.usernameTaken': 'Имя занято',
82
138
  'errors.conflict.emailTaken': 'Email занят',
139
+ 'errors.conflict.eventKeyLabel': 'Метка API-ключа события уже используется',
140
+ 'errors.conflict.identityClaim': 'Эта идентичность уже привязана к другому профилю',
83
141
  // Other errors
84
142
  'errors.providerDisabled': 'Провайдер отключён',
85
143
  'errors.connectionError': 'Ошибка подключения',
86
144
  'errors.faviconFetchError': 'Ошибка получения favicon',
87
145
  'errors.generic': 'Ошибка',
146
+ 'errors.rateLimited.eventKey': 'Превышен лимит запросов по API-ключу события',
147
+ 'errors.unavailable.eventsDisabled': 'Приём внешних событий отключён',
88
148
  // Auth
89
149
  'auth.unauthorized': 'Требуется аутентификация',
90
150
  'auth.forbidden': 'Доступ запрещён',
package/dist/main.js CHANGED
@@ -6,7 +6,7 @@
6
6
  import { createBackendApp } from './app.js';
7
7
  const host = process.env.SYNTH_HOST || '0.0.0.0';
8
8
  const handle = await createBackendApp();
9
- const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager } = handle;
9
+ const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager, stopEphemeralSweeper, stopEventJournalPruner, stopScheduler, stopWebhookService, stopWebhookDeliveryPruner } = handle;
10
10
  let shuttingDown = false;
11
11
  async function gracefulShutdown(signal) {
12
12
  if (shuttingDown)
@@ -26,6 +26,15 @@ async function gracefulShutdown(signal) {
26
26
  console.log('[Shutdown] WebSocket-сервер остановлен');
27
27
  queueManager.stopAll();
28
28
  console.log('[Shutdown] Очередь остановлена');
29
+ // AD-089: остановить авто-архивацию ephemeral-сессий.
30
+ stopEphemeralSweeper();
31
+ // AD-089: остановить retention-очистку журнала событий.
32
+ stopEventJournalPruner();
33
+ // AD-051 (срез): остановить планировщик расписаний.
34
+ stopScheduler();
35
+ // AD-052 (этап II): остановить движок исходящих webhooks и retention-очистку.
36
+ stopWebhookService();
37
+ stopWebhookDeliveryPruner();
29
38
  const drainTimeout = 10_000;
30
39
  const activeSessions = await sessionManager.listActiveSessions();
31
40
  if (activeSessions.length > 0) {
@@ -11,7 +11,7 @@ const OIDC_STATE_COOKIE = 'oidc_state';
11
11
  // по умолчанию: packages/ui/src/lib/defaults.ts + uiScale.ts).
12
12
  const BUILT_IN_DEFAULTS = {
13
13
  themeMode: 'system',
14
- theme: 'flexoki',
14
+ theme: 'synthesis',
15
15
  uiScaleMobile: null,
16
16
  uiScaleDesktop: null,
17
17
  };
@@ -237,7 +237,7 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
237
237
  preferred_language: user.preferredLanguage,
238
238
  team_role: profile?.teamRoles?.[0] ?? user.teamRole,
239
239
  notes: profile?.notes ?? user.notes,
240
- interview_completed: user.interviewCompleted,
240
+ interview_completed: profile?.interviewCompleted ?? user.interviewCompleted,
241
241
  display_name: profile?.displayName ?? null,
242
242
  is_active: profile?.isActive ?? true,
243
243
  created_at: profile?.createdAt ?? user.createdAt,
@@ -272,6 +272,11 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
272
272
  profile.teamRoles = [body.team_role];
273
273
  if (body.display_name)
274
274
  profile.displayName = body.display_name;
275
+ if (body.interview_completed !== undefined) {
276
+ // Отдельное поле статуса интервью — персистим вместе с временем.
277
+ profile.interviewCompleted = body.interview_completed;
278
+ profile.interviewCompletedAt = body.interview_completed ? new Date().toISOString() : undefined;
279
+ }
275
280
  if (body.preferences !== undefined) {
276
281
  profile.preferences = { ...(profile.preferences || {}), ...body.preferences };
277
282
  }
@@ -291,6 +296,7 @@ export function createAuthRoutes(kit, config, profiles, dataDir, defaultsStore)
291
296
  display_name: profile.displayName,
292
297
  notes: profile.notes,
293
298
  team_role: profile.teamRoles?.[0],
299
+ interview_completed: profile.interviewCompleted,
294
300
  preferences: profile.preferences,
295
301
  },
296
302
  });
@@ -1,5 +1,6 @@
1
1
  import { Hono } from 'hono';
2
2
  import { z } from 'zod';
3
+ import { scopeGuard } from '../auth/service-scope.js';
3
4
  import { ContextLengthExceededError, deobfuscateSecrets, GatewayProvider, ProviderError, ProviderFactory, RateLimitError, } from '@itphx/synth-core';
4
5
  /**
5
6
  * LLM Proxy endpoint (гибридный режим, Часть 5).
@@ -99,7 +100,8 @@ function toLlmMessages(raw) {
99
100
  }
100
101
  export function createLlmRoutes(kit, deps) {
101
102
  const app = new Hono();
102
- const middlewares = deps.rateLimiter ? [deps.rateLimiter] : [];
103
+ // AD-052: `llm:chat` — scope service-key; обычные креды scope не ограничивают.
104
+ const middlewares = [scopeGuard('llm:chat'), ...(deps.rateLimiter ? [deps.rateLimiter] : [])];
103
105
  // POST /api/v2/llm/chat/completions — OpenAI-совместимый LLM Proxy
104
106
  app.post('/chat/completions', kit.requireAuth, ...middlewares, async (c) => {
105
107
  const user = (await kit.getCurrentUser(c));
@@ -1,8 +1,9 @@
1
1
  import { Hono } from 'hono';
2
2
  import { z } from 'zod';
3
- import { evaluateMcpNetworkAccess } from '@itphx/synth-core';
4
- import { sessionMcpScopeSchema } from '@itphx/synth-shared';
3
+ import { evaluateMcpNetworkAccess, getServiceCredential } from '@itphx/synth-core';
4
+ import { sessionMcpScopeSchema, hasServiceScope } from '@itphx/synth-shared';
5
5
  import { mcpServerConfigSchema } from '@itphx/synth-shared/config';
6
+ import { requireAdminOrScope, requireScopeForServiceKey } from '../auth/guards.js';
6
7
  // Backend-only MCP-роуты (AD-071 §2.5): legacy `/servers*`, `/session/:id` и
7
8
  // единый реестр `/registry*`. Probe (`POST /probe`) — общая логика core,
8
9
  // монтируется в `routes/mcp.ts` ПЕРЕД этим роутером.
@@ -46,6 +47,15 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
46
47
  };
47
48
  const isConnected = (name) => mcpManager?.getConfiguredServers().find((s) => s.name === name)?.connected ?? false;
48
49
  const currentUser = (c) => c.get('user') ?? null;
50
+ /**
51
+ * AD-052/O1: запрос от installer-service-key (scope `addons:install`).
52
+ * Даёт scoped-ключу без роли ADMIN создавать **instance**-записи реестра
53
+ * (общие для инстанса, а не персональные) и обновлять созданные им записи.
54
+ */
55
+ const isInstallerKey = (c) => {
56
+ const cred = getServiceCredential(c);
57
+ return !!cred && hasServiceScope(cred.scopes, 'addons:install');
58
+ };
49
59
  const checkNetwork = async (config, origin) => {
50
60
  // AD-071 §2.3.1: политика — для пользовательских HTTP-серверов; instance
51
61
  // (в т.ч. приватные сети инстанса) доверенные.
@@ -101,8 +111,8 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
101
111
  }
102
112
  return c.json({ name: entry.name, config: entry.config, connected: isConnected(entry.name) });
103
113
  });
104
- // --- Обновить сервер (ADMIN) ---
105
- app.put('/servers/:name', kit.requireAdmin, async (c) => {
114
+ // --- Обновить сервер (ADMIN или scope `addons:install`) ---
115
+ app.put('/servers/:name', requireAdminOrScope('addons:install'), async (c) => {
106
116
  const name = c.req.param('name');
107
117
  const entry = await registry.getByName(name);
108
118
  if (!entry) {
@@ -121,8 +131,8 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
121
131
  await syncManagerConfig();
122
132
  return c.json({ name, config: parsed.data, connected: isConnected(name) });
123
133
  });
124
- // --- Удалить сервер (ADMIN) ---
125
- app.delete('/servers/:name', kit.requireAdmin, async (c) => {
134
+ // --- Удалить сервер (ADMIN или scope `addons:install`) ---
135
+ app.delete('/servers/:name', requireAdminOrScope('addons:install'), async (c) => {
126
136
  const name = c.req.param('name');
127
137
  const entry = await registry.getByName(name);
128
138
  if (!entry) {
@@ -135,8 +145,8 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
135
145
  await syncManagerConfig();
136
146
  return c.json({ success: true });
137
147
  });
138
- // --- Проверить подключение (ADMIN) ---
139
- app.post('/servers/:name/test', kit.requireAdmin, async (c) => {
148
+ // --- Проверить подключение (ADMIN или scope `addons:install`) ---
149
+ app.post('/servers/:name/test', requireAdminOrScope('addons:install'), async (c) => {
140
150
  const name = c.req.param('name');
141
151
  // Принимаем опциональный конфиг в теле — для теста до сохранения.
142
152
  let config;
@@ -257,7 +267,10 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
257
267
  return c.json({ entries });
258
268
  });
259
269
  // Добавить запись (auth): HTTP — любой пользователь, stdio — только ADMIN.
260
- app.post('/registry', kit.requireAuth, async (c) => {
270
+ // AD-052/O1: service-key должен нести scope `addons:install` (интерактив без
271
+ // изменений — HTTP добавляет любой, stdio-проверка ниже). Installer-ключ со
272
+ // scope создаёт instance-записи (общие для инстанса) без роли ADMIN.
273
+ app.post('/registry', kit.requireAuth, requireScopeForServiceKey('addons:install'), async (c) => {
261
274
  const body = await c.req.json().catch(() => null);
262
275
  const parsed = registryAddSchema.safeParse(body);
263
276
  if (!parsed.success) {
@@ -265,9 +278,13 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
265
278
  }
266
279
  const { name, config, enabled, enabledByDefault, origin } = parsed.data;
267
280
  const admin = kit.isAdmin(c);
281
+ // AD-052/O1: installer-ключ (scope `addons:install`) создаёт instance-записи
282
+ // даже без роли ADMIN — это общие записи инстанса (а не персональные).
283
+ const isInstaller = isInstallerKey(c);
268
284
  let entryOrigin;
269
285
  let trust;
270
286
  if (config.type === 'stdio') {
287
+ // stdio — только ADMIN (scope НЕ ослабляет проверку).
271
288
  if (!admin) {
272
289
  return c.json({
273
290
  error: { code: 'FORBIDDEN', message: 'stdio-серверы может добавлять только ADMIN' },
@@ -277,7 +294,8 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
277
294
  trust = 'builtin';
278
295
  }
279
296
  else {
280
- entryOrigin = admin && origin === 'instance' ? 'instance' : 'user';
297
+ const wantsInstance = origin === 'instance' || isInstaller;
298
+ entryOrigin = (admin || isInstaller) && wantsInstance ? 'instance' : 'user';
281
299
  trust = entryOrigin === 'instance' ? 'builtin' : 'community';
282
300
  }
283
301
  const networkError = await checkNetwork(config, entryOrigin);
@@ -301,7 +319,7 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
301
319
  await syncManagerConfig();
302
320
  return c.json(entry, 201);
303
321
  });
304
- // Обновить запись (автор или ADMIN).
322
+ // Обновить запись (автор, ADMIN или installer-ключ со scope `addons:install`).
305
323
  app.put('/registry/:id', kit.requireAuth, async (c) => {
306
324
  const id = c.req.param('id');
307
325
  const existing = await registry.get(id);
@@ -310,7 +328,12 @@ export function createMcpRegistryRoutes(kit, mcpManager, sessionManager, options
310
328
  }
311
329
  const admin = kit.isAdmin(c);
312
330
  const user = currentUser(c);
313
- if (!admin && existing.author?.userId !== user?.id) {
331
+ // Автор записи (для service-key автор — `service:<keyId>`), ADMIN **или**
332
+ // installer-ключ со scope `addons:install`: аддон может обновлять созданные
333
+ // им instance-записи; scope-ветка переживает ротацию/пересоздание ключа
334
+ // (id меняется, author-check бы не сработал).
335
+ const isAuthor = existing.author?.userId === user?.id;
336
+ if (!admin && !isAuthor && !isInstallerKey(c)) {
314
337
  return c.json({ error: { code: 'FORBIDDEN', message: 'Обновлять запись может автор или ADMIN' } }, 403);
315
338
  }
316
339
  const body = await c.req.json().catch(() => null);
@@ -14,6 +14,9 @@ export declare function createProjectAccess(kit: AuthKit): {
14
14
  canEditProjectContent: (c: {
15
15
  get(key: "user"): unknown;
16
16
  }, project: Project, userId: string) => boolean;
17
+ canReadProject: (c: {
18
+ get(key: "user"): unknown;
19
+ }, project: Project, userId: string) => boolean;
17
20
  };
18
21
  /**
19
22
  * Backend-обёртка над core-фабрикой проектов: общая логика — в core, здесь только