@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.
- package/LICENSE +1 -1
- package/LICENSE.ru.md +31 -0
- package/dist/app.d.ts +23 -1
- package/dist/app.js +486 -10
- package/dist/auth/guards.d.ts +20 -0
- package/dist/auth/guards.js +65 -0
- package/dist/auth/middleware.d.ts +15 -1
- package/dist/auth/middleware.js +38 -0
- package/dist/auth/service-scope.d.ts +14 -0
- package/dist/auth/service-scope.js +40 -0
- package/dist/events/hub.d.ts +9 -0
- package/dist/events/hub.js +29 -0
- package/dist/lib/i18n.js +60 -0
- package/dist/main.js +10 -1
- package/dist/routes/auth.js +8 -2
- package/dist/routes/llm.js +3 -1
- package/dist/routes/mcp-registry.js +35 -12
- package/dist/routes/projects.d.ts +3 -0
- package/dist/routes/projects.js +12 -2
- package/dist/routes/sessions.d.ts +7 -1
- package/dist/routes/sessions.js +37 -2
- package/dist/routes/users.js +17 -4
- package/package.json +5 -4
- package/dist/agents/definitions/admin.json +0 -24
- package/dist/agents/definitions/analyst.json +0 -20
- package/dist/agents/definitions/assistant.json +0 -25
- package/dist/agents/definitions/auditor.json +0 -19
- package/dist/agents/definitions/developer.json +0 -23
- package/dist/agents/definitions/devops.json +0 -23
- package/dist/agents/definitions/explore.json +0 -15
- package/dist/agents/definitions/general.json +0 -15
- package/dist/agents/definitions/pm.json +0 -20
- package/dist/agents/definitions/qa.json +0 -22
|
@@ -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
|
-
|
|
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;
|
package/dist/auth/middleware.js
CHANGED
|
@@ -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
|
+
};
|
package/dist/events/hub.d.ts
CHANGED
|
@@ -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
|
}
|
package/dist/events/hub.js
CHANGED
|
@@ -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) {
|
package/dist/routes/auth.js
CHANGED
|
@@ -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: '
|
|
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
|
});
|
package/dist/routes/llm.js
CHANGED
|
@@ -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
|
-
|
|
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',
|
|
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',
|
|
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',
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
// Обновить запись (
|
|
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
|
-
|
|
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, здесь только
|