@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/app.js
CHANGED
|
@@ -17,8 +17,7 @@ import { Hono } from 'hono';
|
|
|
17
17
|
import { cors } from 'hono/cors';
|
|
18
18
|
import { logger } from 'hono/logger';
|
|
19
19
|
import { createMiddleware } from 'hono/factory';
|
|
20
|
-
import { applyBootstrapServiceKeys,
|
|
21
|
-
import { resolveExecutionConfig } from '@itphx/synth-shared';
|
|
20
|
+
import { applyBootstrapServiceKeys, createHealthRoutes, createHttpMetricsMiddleware, createMetricsRoutes, KeyRateLimiter, getServiceCredential, MetricsRegistry, registerProcessMetrics, resolveMetricsEnabled, resolveMetricsToken, resolvePluginServerPolicy, setSynthReady, } from '@itphx/synth-core';
|
|
22
21
|
import { createStorageDegradedGuard, createStorageStatusRoutes } from '@itphx/synth-core/server/storage-degraded.js';
|
|
23
22
|
import { loadBackendConfig } from './lib/app-config.js';
|
|
24
23
|
import { resolveCorsOrigin } from './lib/cors.js';
|
|
@@ -57,14 +56,14 @@ export async function createBackendApp(opts = {}) {
|
|
|
57
56
|
try {
|
|
58
57
|
// Конфигурация
|
|
59
58
|
const backendConfig = await loadBackendConfig({ configPath: opts.configPath });
|
|
60
|
-
// ADR-077: топология исполнения — параметр запуска (инвариант 24).
|
|
61
|
-
//
|
|
62
|
-
//
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
59
|
+
// ADR-077/ADR-135: топология исполнения — параметр запуска (инвариант 24).
|
|
60
|
+
// Разрешение секции `execution` и fail-closed проверка режима — **в одном
|
|
61
|
+
// месте** (`app/deps.ts`: `resolveExecutionConfig` + runtime-каталог
|
|
62
|
+
// профилей + `checkExecutionMode`). Здесь только конфиг: дублирующего
|
|
63
|
+
// разрешения не остаётся, а ошибка режима по-прежнему прерывает старт
|
|
64
|
+
// (fail-closed: неверный `mode`/`failMode` — ошибка; `remote` без
|
|
65
|
+
// адресов/пакета исполнителя/читаемого токена — старт прерывается, а не
|
|
66
|
+
// «молча уходит в inline»).
|
|
68
67
|
const app = new Hono();
|
|
69
68
|
app.use(logger());
|
|
70
69
|
// ADR-096 (W2.4): единый контекст хранения — собирается до `auth`, реестр
|
|
@@ -178,7 +177,7 @@ export async function createBackendApp(opts = {}) {
|
|
|
178
177
|
// Зависимости (stores/managers/оркестратор/событийное ядро/шедулер/webhooks).
|
|
179
178
|
// Тот же контекст хранения, что собран до `auth`. ADR-094: реестр передаётся
|
|
180
179
|
// только при `metrics.enabled` — иначе доменные коллекторы не подключаются.
|
|
181
|
-
const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined
|
|
180
|
+
const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined);
|
|
182
181
|
// F4 (аудит S1): health-геттер состояния LLM-шлюза читает эффективный конфиг
|
|
183
182
|
// (`deps.gatewayConfig` — config + runtime-тумблер), который готов только здесь.
|
|
184
183
|
depsRef = deps;
|
|
@@ -325,6 +324,8 @@ export async function createBackendApp(opts = {}) {
|
|
|
325
324
|
scheduleStore: deps.scheduleStore,
|
|
326
325
|
scheduler: deps.schedulerService,
|
|
327
326
|
stopScheduler: () => deps.schedulerService.stop(),
|
|
327
|
+
// PROP-141 (Часть B): остановка движка таймеров/будильников.
|
|
328
|
+
stopTimerService: () => deps.stopTimerService(),
|
|
328
329
|
stopEphemeralSweeper: deps.stopEphemeralSweeper,
|
|
329
330
|
stopEventJournalPruner: deps.stopEventJournalPruner,
|
|
330
331
|
stopAnalyticsRollupPruner: deps.stopAnalyticsRollupPruner,
|
|
@@ -341,6 +342,8 @@ export async function createBackendApp(opts = {}) {
|
|
|
341
342
|
stopAttachmentPruner: () => deps.stopAttachmentPruner(),
|
|
342
343
|
// ADR-115 × ADR-077: уборка временных каталогов медиа-раннера.
|
|
343
344
|
stopMediaTempPruner: () => deps.stopMediaTempPruner(),
|
|
345
|
+
// PROP-132 (Ф3в): остановка сервиса терминалов (закрытие живых PTY).
|
|
346
|
+
stopTerminalService: () => deps.stopTerminalService(),
|
|
344
347
|
// ADR-052 (этап II): реестр подписок и движок webhooks + остановка на shutdown.
|
|
345
348
|
webhookStore: deps.webhookStore,
|
|
346
349
|
webhookService: deps.webhookService,
|
package/dist/auth/middleware.js
CHANGED
|
@@ -2,7 +2,7 @@ import { isServiceKeySecret } from '@itphx/synth-core';
|
|
|
2
2
|
import { createMiddleware } from 'hono/factory';
|
|
3
3
|
import { getCookie, setCookie, deleteCookie } from 'hono/cookie';
|
|
4
4
|
import { t } from '../lib/i18n.js';
|
|
5
|
-
import { createLazyOidcClient } from './oidc.js';
|
|
5
|
+
import { createLazyOidcClient, oidcUserToUser } from './oidc.js';
|
|
6
6
|
import { apiKeyEquals, resolveApiKeyRoles } from './api-key.js';
|
|
7
7
|
const SESSION_COOKIE = 'user_session';
|
|
8
8
|
/**
|
|
@@ -96,17 +96,9 @@ export function createAuthMiddleware(config) {
|
|
|
96
96
|
if (client) {
|
|
97
97
|
try {
|
|
98
98
|
const oidcUser = await client.verifyToken(token);
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
email: oidcUser.email,
|
|
103
|
-
roles: oidcUser.roles,
|
|
104
|
-
preferredLanguage: 'ru',
|
|
105
|
-
createdAt: new Date().toISOString(),
|
|
106
|
-
teamRole: oidcUser.roles[0] || 'USER',
|
|
107
|
-
notes: '',
|
|
108
|
-
interviewCompleted: false,
|
|
109
|
-
};
|
|
99
|
+
// ADR-140: группы пользователя — снимок claim'а IdP (allowlist);
|
|
100
|
+
// `oidcUserToUser` переносит их в `User` только при непустом списке.
|
|
101
|
+
return oidcUserToUser(oidcUser);
|
|
110
102
|
}
|
|
111
103
|
catch {
|
|
112
104
|
// Некорректный/истёкший JWT — пользователь не аутентифицирован
|
package/dist/auth/oidc.d.ts
CHANGED
|
@@ -16,6 +16,16 @@ export interface OidcConfig {
|
|
|
16
16
|
* Issuer проверяется всегда.
|
|
17
17
|
*/
|
|
18
18
|
audience?: string[];
|
|
19
|
+
/**
|
|
20
|
+
* ADR-140: источник групп пользователя — claim IdP и allowlist имён.
|
|
21
|
+
* Пустой allowlist — групп нет (fail-closed): «принять все» невозможно.
|
|
22
|
+
*/
|
|
23
|
+
groups?: {
|
|
24
|
+
/** Имя claim'а с группами (Keycloak — `groups`). */
|
|
25
|
+
claim?: string;
|
|
26
|
+
/** Allowlist имён групп; пусто — ни одна группа не принимается. */
|
|
27
|
+
allow?: string[];
|
|
28
|
+
};
|
|
19
29
|
}
|
|
20
30
|
/** Подмножество документа discovery OpenID Connect. */
|
|
21
31
|
export interface OidcDiscovery {
|
|
@@ -62,6 +72,7 @@ export declare class OidcClient {
|
|
|
62
72
|
/**
|
|
63
73
|
* Проверка пары id_token + access_token через JWKS провайдера.
|
|
64
74
|
* Роли: из id_token, если пусто — из access_token (client roles учитываются).
|
|
75
|
+
* Группы: тот же fallback (id_token → access_token).
|
|
65
76
|
*/
|
|
66
77
|
verifyTokens(idToken: string, accessToken: string): Promise<OidcUser>;
|
|
67
78
|
/**
|
|
@@ -84,21 +95,52 @@ export interface OidcUser {
|
|
|
84
95
|
username: string;
|
|
85
96
|
email?: string;
|
|
86
97
|
roles: string[];
|
|
98
|
+
/**
|
|
99
|
+
* ADR-140: группы пользователя — снимок claim'а IdP на момент логина,
|
|
100
|
+
* отфильтрованный allowlist'ом. Пусто/нет — групп нет (fail-closed).
|
|
101
|
+
*/
|
|
102
|
+
groups?: string[];
|
|
87
103
|
}
|
|
104
|
+
/**
|
|
105
|
+
* ADR-140: извлечь группы пользователя из payload токена.
|
|
106
|
+
*
|
|
107
|
+
* Claim — **верхнего уровня** (Keycloak кладёт плоский массив `groups`);
|
|
108
|
+
* вложенные пути не разбираются. Нормализация: trim, только `string`-элементы,
|
|
109
|
+
* дедуп, порядок claim'а сохраняется.
|
|
110
|
+
*
|
|
111
|
+
* Фильтр — по `allow` (allowlist) **точным** совпадением: имена групп Keycloak
|
|
112
|
+
* регистрозависимы, в верхний регистр не приводим. Пустой allowlist → `[]`
|
|
113
|
+
* (fail-closed: «принять все» невозможно). Claim отсутствует или это не
|
|
114
|
+
* массив → `[]` (без throw — кривой токен не ломает аутентификацию).
|
|
115
|
+
*/
|
|
116
|
+
export declare function extractGroups(payload: Record<string, unknown>, cfg?: {
|
|
117
|
+
claim?: string;
|
|
118
|
+
allow?: string[];
|
|
119
|
+
} | null): string[];
|
|
88
120
|
/**
|
|
89
121
|
* Извлечь пользователя из payload id_token Keycloak:
|
|
90
122
|
* - username = preferred_username (fallback email, sub)
|
|
91
123
|
* - roles = realm_access.roles + resource_access.<clientId>.roles → ВЕРХНИЙ РЕГИСТР + фильтр известных (ADMIN/USER/LEAD/AUDITOR)
|
|
124
|
+
* - groups = claim'а групп (ADR-140) — по allowlist'у; пусто → `[]`
|
|
92
125
|
* - если ролей нет — дефолт ['USER']
|
|
93
126
|
*/
|
|
94
|
-
export declare function extractUser(payload: Record<string, unknown>, clientId?: string
|
|
127
|
+
export declare function extractUser(payload: Record<string, unknown>, clientId?: string, groups?: {
|
|
128
|
+
claim?: string;
|
|
129
|
+
allow?: string[];
|
|
130
|
+
} | null): OidcUser;
|
|
95
131
|
/**
|
|
96
|
-
* Объединить роли из id_token и access_token:
|
|
97
|
-
* Поля id/username/email берутся из id_token.
|
|
132
|
+
* Объединить роли и группы из id_token и access_token: из id_token, если пусто —
|
|
133
|
+
* из access_token. Поля id/username/email берутся из id_token.
|
|
98
134
|
*/
|
|
99
|
-
export declare function extractUserFromTokens(idPayload: Record<string, unknown>, accessPayload: Record<string, unknown>, clientId?: string
|
|
135
|
+
export declare function extractUserFromTokens(idPayload: Record<string, unknown>, accessPayload: Record<string, unknown>, clientId?: string, groups?: {
|
|
136
|
+
claim?: string;
|
|
137
|
+
allow?: string[];
|
|
138
|
+
} | null): OidcUser;
|
|
100
139
|
/**
|
|
101
140
|
* Собрать полноценный User из OIDC-пользователя (объект User требует служебные поля).
|
|
141
|
+
*
|
|
142
|
+
* ADR-140: группы переносятся **только если список непуст** — иначе поле не
|
|
143
|
+
* добавляется вовсе (у пользователя без групп `groups` отсутствует).
|
|
102
144
|
*/
|
|
103
145
|
export declare function oidcUserToUser(o: OidcUser): User;
|
|
104
146
|
/**
|
package/dist/auth/oidc.js
CHANGED
|
@@ -3,6 +3,8 @@ import { jwtVerify, createRemoteJWKSet, customFetch } from 'jose';
|
|
|
3
3
|
import { egressFetch } from '@itphx/synth-core';
|
|
4
4
|
/** Audience access_token по умолчанию (Keycloak): клиент либо `account`. */
|
|
5
5
|
const DEFAULT_ACCESS_TOKEN_AUDIENCE = 'account';
|
|
6
|
+
/** Имя claim'а с группами по умолчанию (Keycloak кладёт плоский массив `groups`). */
|
|
7
|
+
const DEFAULT_GROUPS_CLAIM = 'groups';
|
|
6
8
|
/** Известные роли Synth (в realm роли записаны в нижнем регистре). */
|
|
7
9
|
const KNOWN_ROLES = ['ADMIN', 'USER', 'LEAD', 'AUDITOR'];
|
|
8
10
|
/**
|
|
@@ -120,11 +122,12 @@ export class OidcClient {
|
|
|
120
122
|
issuer: this.config.issuer,
|
|
121
123
|
audience: this._anyTokenAudience(),
|
|
122
124
|
});
|
|
123
|
-
return extractUser(payload, this.config.clientId);
|
|
125
|
+
return extractUser(payload, this.config.clientId, this.config.groups);
|
|
124
126
|
}
|
|
125
127
|
/**
|
|
126
128
|
* Проверка пары id_token + access_token через JWKS провайдера.
|
|
127
129
|
* Роли: из id_token, если пусто — из access_token (client roles учитываются).
|
|
130
|
+
* Группы: тот же fallback (id_token → access_token).
|
|
128
131
|
*/
|
|
129
132
|
async verifyTokens(idToken, accessToken) {
|
|
130
133
|
const discovery = await this.getDiscovery();
|
|
@@ -142,7 +145,7 @@ export class OidcClient {
|
|
|
142
145
|
// напр. `synth-cli`, отвергались бы) — issuer и подпись проверяются всегда.
|
|
143
146
|
audience: this._accessTokenAudience(),
|
|
144
147
|
});
|
|
145
|
-
return extractUserFromTokens(idPayload, accessPayload, this.config.clientId);
|
|
148
|
+
return extractUserFromTokens(idPayload, accessPayload, this.config.clientId, this.config.groups);
|
|
146
149
|
}
|
|
147
150
|
/**
|
|
148
151
|
* ADR-099: JWKS-набор с **явным** транспортом доверия TLS/CA (`egressFetch`),
|
|
@@ -201,13 +204,49 @@ function extractKnownRoles(payload, clientId) {
|
|
|
201
204
|
.filter((r) => KNOWN_ROLES.includes(r));
|
|
202
205
|
return [...new Set(roles)];
|
|
203
206
|
}
|
|
207
|
+
/**
|
|
208
|
+
* ADR-140: извлечь группы пользователя из payload токена.
|
|
209
|
+
*
|
|
210
|
+
* Claim — **верхнего уровня** (Keycloak кладёт плоский массив `groups`);
|
|
211
|
+
* вложенные пути не разбираются. Нормализация: trim, только `string`-элементы,
|
|
212
|
+
* дедуп, порядок claim'а сохраняется.
|
|
213
|
+
*
|
|
214
|
+
* Фильтр — по `allow` (allowlist) **точным** совпадением: имена групп Keycloak
|
|
215
|
+
* регистрозависимы, в верхний регистр не приводим. Пустой allowlist → `[]`
|
|
216
|
+
* (fail-closed: «принять все» невозможно). Claim отсутствует или это не
|
|
217
|
+
* массив → `[]` (без throw — кривой токен не ломает аутентификацию).
|
|
218
|
+
*/
|
|
219
|
+
export function extractGroups(payload, cfg) {
|
|
220
|
+
const allow = (cfg?.allow ?? [])
|
|
221
|
+
.map((name) => name.trim())
|
|
222
|
+
.filter((name) => name.length > 0);
|
|
223
|
+
if (allow.length === 0)
|
|
224
|
+
return [];
|
|
225
|
+
const allowSet = new Set(allow);
|
|
226
|
+
const claim = cfg?.claim?.trim() || DEFAULT_GROUPS_CLAIM;
|
|
227
|
+
const raw = payload[claim];
|
|
228
|
+
if (!Array.isArray(raw))
|
|
229
|
+
return [];
|
|
230
|
+
const groups = [];
|
|
231
|
+
for (const item of raw) {
|
|
232
|
+
if (typeof item !== 'string')
|
|
233
|
+
continue;
|
|
234
|
+
const name = item.trim();
|
|
235
|
+
if (!name || !allowSet.has(name))
|
|
236
|
+
continue;
|
|
237
|
+
if (!groups.includes(name))
|
|
238
|
+
groups.push(name);
|
|
239
|
+
}
|
|
240
|
+
return groups;
|
|
241
|
+
}
|
|
204
242
|
/**
|
|
205
243
|
* Извлечь пользователя из payload id_token Keycloak:
|
|
206
244
|
* - username = preferred_username (fallback email, sub)
|
|
207
245
|
* - roles = realm_access.roles + resource_access.<clientId>.roles → ВЕРХНИЙ РЕГИСТР + фильтр известных (ADMIN/USER/LEAD/AUDITOR)
|
|
246
|
+
* - groups = claim'а групп (ADR-140) — по allowlist'у; пусто → `[]`
|
|
208
247
|
* - если ролей нет — дефолт ['USER']
|
|
209
248
|
*/
|
|
210
|
-
export function extractUser(payload, clientId) {
|
|
249
|
+
export function extractUser(payload, clientId, groups) {
|
|
211
250
|
const sub = typeof payload.sub === 'string' ? payload.sub : '';
|
|
212
251
|
const email = typeof payload.email === 'string' ? payload.email : undefined;
|
|
213
252
|
const preferredUsername = typeof payload.preferred_username === 'string'
|
|
@@ -220,21 +259,28 @@ export function extractUser(payload, clientId) {
|
|
|
220
259
|
username: username || 'oidc-user',
|
|
221
260
|
email,
|
|
222
261
|
roles: roles.length > 0 ? roles : ['USER'],
|
|
262
|
+
groups: extractGroups(payload, groups),
|
|
223
263
|
};
|
|
224
264
|
}
|
|
225
265
|
/**
|
|
226
|
-
* Объединить роли из id_token и access_token:
|
|
227
|
-
* Поля id/username/email берутся из id_token.
|
|
266
|
+
* Объединить роли и группы из id_token и access_token: из id_token, если пусто —
|
|
267
|
+
* из access_token. Поля id/username/email берутся из id_token.
|
|
228
268
|
*/
|
|
229
|
-
export function extractUserFromTokens(idPayload, accessPayload, clientId) {
|
|
269
|
+
export function extractUserFromTokens(idPayload, accessPayload, clientId, groups) {
|
|
230
270
|
const idRoles = extractKnownRoles(idPayload, clientId);
|
|
231
271
|
const accessRoles = extractKnownRoles(accessPayload, clientId);
|
|
232
272
|
const roles = idRoles.length > 0 ? idRoles : accessRoles;
|
|
233
|
-
const
|
|
234
|
-
|
|
273
|
+
const idGroups = extractGroups(idPayload, groups);
|
|
274
|
+
const accessGroups = extractGroups(accessPayload, groups);
|
|
275
|
+
const resolvedGroups = idGroups.length > 0 ? idGroups : accessGroups;
|
|
276
|
+
const user = extractUser(idPayload, clientId, groups);
|
|
277
|
+
return { ...user, roles: roles.length > 0 ? roles : ['USER'], groups: resolvedGroups };
|
|
235
278
|
}
|
|
236
279
|
/**
|
|
237
280
|
* Собрать полноценный User из OIDC-пользователя (объект User требует служебные поля).
|
|
281
|
+
*
|
|
282
|
+
* ADR-140: группы переносятся **только если список непуст** — иначе поле не
|
|
283
|
+
* добавляется вовсе (у пользователя без групп `groups` отсутствует).
|
|
238
284
|
*/
|
|
239
285
|
export function oidcUserToUser(o) {
|
|
240
286
|
return {
|
|
@@ -242,6 +288,7 @@ export function oidcUserToUser(o) {
|
|
|
242
288
|
username: o.username,
|
|
243
289
|
email: o.email,
|
|
244
290
|
roles: o.roles,
|
|
291
|
+
...(o.groups && o.groups.length > 0 ? { groups: [...o.groups] } : {}),
|
|
245
292
|
preferredLanguage: 'ru',
|
|
246
293
|
createdAt: new Date().toISOString(),
|
|
247
294
|
teamRole: o.roles[0] || 'USER',
|
package/dist/events/hub.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { EventBus } from '@itphx/synth-core';
|
|
1
|
+
import type { EventBus, ProjectRepository } from '@itphx/synth-core';
|
|
2
2
|
import type { BusEvent } from '@itphx/synth-shared';
|
|
3
3
|
import type { SessionManager } from '@itphx/synth-core';
|
|
4
4
|
export interface EventClient {
|
|
@@ -11,6 +11,10 @@ export interface EventClient {
|
|
|
11
11
|
* сквозного обзора ADMIN/LEAD (ADR-089) — паритет со standalone-core SSE.
|
|
12
12
|
*/
|
|
13
13
|
allSessions?: boolean;
|
|
14
|
+
/**
|
|
15
|
+
* PROP-133: группы пользователя (гранты по группам; Ф2). Нет — групп нет.
|
|
16
|
+
*/
|
|
17
|
+
groups?: readonly string[];
|
|
14
18
|
send(event: BusEvent): void;
|
|
15
19
|
}
|
|
16
20
|
/**
|
|
@@ -21,11 +25,41 @@ export interface EventClient {
|
|
|
21
25
|
export declare class EventHub {
|
|
22
26
|
private eventBus;
|
|
23
27
|
private sessionManager;
|
|
28
|
+
/**
|
|
29
|
+
* PROP-133 §6: проекты пользователя — чтобы подписка клиента покрывала
|
|
30
|
+
* сессии **всех видимых** проектов (не только свои). Не задан — подписка
|
|
31
|
+
* остаётся «только свои сессии» (прежнее поведение).
|
|
32
|
+
*/
|
|
33
|
+
private projectStore?;
|
|
24
34
|
private clients;
|
|
25
35
|
private clientSubs;
|
|
26
|
-
constructor(eventBus: EventBus, sessionManager: SessionManager
|
|
36
|
+
constructor(eventBus: EventBus, sessionManager: SessionManager,
|
|
37
|
+
/**
|
|
38
|
+
* PROP-133 §6: проекты пользователя — чтобы подписка клиента покрывала
|
|
39
|
+
* сессии **всех видимых** проектов (не только свои). Не задан — подписка
|
|
40
|
+
* остаётся «только свои сессии» (прежнее поведение).
|
|
41
|
+
*/
|
|
42
|
+
projectStore?: ProjectRepository | undefined);
|
|
27
43
|
registerClient(client: EventClient): Promise<void>;
|
|
28
44
|
unregisterClient(client: EventClient): void;
|
|
45
|
+
/**
|
|
46
|
+
* PROP-133 Ф2 / ADR-140 Ф2: пересчитать подписки клиента — доступ к
|
|
47
|
+
* проектам мог измениться (появился/снят участник, изменился режим
|
|
48
|
+
* «всем пользователям»).
|
|
49
|
+
*
|
|
50
|
+
* Список подписок = список **видимых** сессий (`listVisibleSessions` — тот
|
|
51
|
+
* же шов, что у списка сессий), поэтому пересчёт совпадает с видимостью
|
|
52
|
+
* проектов и не расходится с ней.
|
|
53
|
+
*
|
|
54
|
+
* Watch-all клиент (`allSessions`) не пересчитывается: его подписка
|
|
55
|
+
* глобальная и от проектов не зависит.
|
|
56
|
+
*/
|
|
57
|
+
resyncClient(client: EventClient): Promise<void>;
|
|
58
|
+
/**
|
|
59
|
+
* PROP-133 Ф2 / ADR-140 Ф2: пересчитать подписки **всем** подключённым
|
|
60
|
+
* клиентам (редкое admin-действие — смена состояния доступа к проекту).
|
|
61
|
+
*/
|
|
62
|
+
resyncAllClients(): Promise<void>;
|
|
29
63
|
shutdown(): void;
|
|
30
64
|
subscribeToSession(userId: string, sessionId: string): Promise<void>;
|
|
31
65
|
unsubscribeFromSession(userId: string, sessionId: string): void;
|
package/dist/events/hub.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { extractChildSessionId } from '@itphx/synth-core';
|
|
2
|
+
import { listVisibleSessions } from './visible-session-ids.js';
|
|
2
3
|
/** Служебный ключ глобальной подписки all-клиента в `clientSubs`. */
|
|
3
4
|
const ALL_SESSIONS_KEY = '*';
|
|
4
5
|
/**
|
|
@@ -9,11 +10,19 @@ const ALL_SESSIONS_KEY = '*';
|
|
|
9
10
|
export class EventHub {
|
|
10
11
|
eventBus;
|
|
11
12
|
sessionManager;
|
|
13
|
+
projectStore;
|
|
12
14
|
clients = new Map();
|
|
13
15
|
clientSubs = new WeakMap();
|
|
14
|
-
constructor(eventBus, sessionManager
|
|
16
|
+
constructor(eventBus, sessionManager,
|
|
17
|
+
/**
|
|
18
|
+
* PROP-133 §6: проекты пользователя — чтобы подписка клиента покрывала
|
|
19
|
+
* сессии **всех видимых** проектов (не только свои). Не задан — подписка
|
|
20
|
+
* остаётся «только свои сессии» (прежнее поведение).
|
|
21
|
+
*/
|
|
22
|
+
projectStore) {
|
|
15
23
|
this.eventBus = eventBus;
|
|
16
24
|
this.sessionManager = sessionManager;
|
|
25
|
+
this.projectStore = projectStore;
|
|
17
26
|
}
|
|
18
27
|
async registerClient(client) {
|
|
19
28
|
const arr = this.clients.get(client.userId) || [];
|
|
@@ -28,8 +37,13 @@ export class EventHub {
|
|
|
28
37
|
console.log(`[EventHub] Register client (all sessions): user=${client.username} clients=${arr.length}`);
|
|
29
38
|
return;
|
|
30
39
|
}
|
|
31
|
-
// Нужны
|
|
32
|
-
|
|
40
|
+
// Нужны id сессий, видимых пользователю: свои + сессии всех проектов, где
|
|
41
|
+
// у него есть роль (PROP-133 §6, инвариант 18). Лёгкая выборка (без истории
|
|
42
|
+
// сообщений). Тот же шов, что у списка сессий (`resolveMemberProjectIds`).
|
|
43
|
+
const sessions = await listVisibleSessions(this.sessionManager, this.projectStore, {
|
|
44
|
+
userId: client.userId,
|
|
45
|
+
...(client.groups ? { groups: client.groups } : {}),
|
|
46
|
+
});
|
|
33
47
|
console.log(`[EventHub] Register client: user=${client.username} clients=${arr.length} sessions=${sessions.length}`);
|
|
34
48
|
for (const s of sessions) {
|
|
35
49
|
this._subscribeClientToSession(client, s.id);
|
|
@@ -48,6 +62,51 @@ export class EventHub {
|
|
|
48
62
|
const remaining = arr.length;
|
|
49
63
|
console.log(`[EventHub] Unregister client: user=${client.username} remaining=${remaining}`);
|
|
50
64
|
}
|
|
65
|
+
/**
|
|
66
|
+
* PROP-133 Ф2 / ADR-140 Ф2: пересчитать подписки клиента — доступ к
|
|
67
|
+
* проектам мог измениться (появился/снят участник, изменился режим
|
|
68
|
+
* «всем пользователям»).
|
|
69
|
+
*
|
|
70
|
+
* Список подписок = список **видимых** сессий (`listVisibleSessions` — тот
|
|
71
|
+
* же шов, что у списка сессий), поэтому пересчёт совпадает с видимостью
|
|
72
|
+
* проектов и не расходится с ней.
|
|
73
|
+
*
|
|
74
|
+
* Watch-all клиент (`allSessions`) не пересчитывается: его подписка
|
|
75
|
+
* глобальная и от проектов не зависит.
|
|
76
|
+
*/
|
|
77
|
+
async resyncClient(client) {
|
|
78
|
+
if (client.allSessions)
|
|
79
|
+
return;
|
|
80
|
+
const subs = this.clientSubs.get(client);
|
|
81
|
+
if (!subs)
|
|
82
|
+
return;
|
|
83
|
+
// Снимаем прежние per-session подписки (глобальная — не трогаем).
|
|
84
|
+
for (const [key, unsub] of [...subs]) {
|
|
85
|
+
if (key === ALL_SESSIONS_KEY)
|
|
86
|
+
continue;
|
|
87
|
+
unsub();
|
|
88
|
+
subs.delete(key);
|
|
89
|
+
}
|
|
90
|
+
const sessions = await listVisibleSessions(this.sessionManager, this.projectStore, {
|
|
91
|
+
userId: client.userId,
|
|
92
|
+
...(client.groups ? { groups: client.groups } : {}),
|
|
93
|
+
});
|
|
94
|
+
for (const s of sessions) {
|
|
95
|
+
this._subscribeClientToSession(client, s.id);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* PROP-133 Ф2 / ADR-140 Ф2: пересчитать подписки **всем** подключённым
|
|
100
|
+
* клиентам (редкое admin-действие — смена состояния доступа к проекту).
|
|
101
|
+
*/
|
|
102
|
+
async resyncAllClients() {
|
|
103
|
+
const clients = [];
|
|
104
|
+
for (const arr of this.clients.values())
|
|
105
|
+
clients.push(...arr);
|
|
106
|
+
await Promise.all(clients.map((c) => this.resyncClient(c)));
|
|
107
|
+
// Сводка без спама по каждой сессии.
|
|
108
|
+
console.log(`[EventHub] Resync clients: ${clients.length}`);
|
|
109
|
+
}
|
|
51
110
|
shutdown() {
|
|
52
111
|
console.log(`[EventHub] Shutting down: ${this.clients.size} users...`);
|
|
53
112
|
for (const clients of this.clients.values()) {
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PROP-133 §6: «видимые» сессии пользователя — свои **+** сессии всех проектов,
|
|
3
|
+
* где у пользователя есть роль (владелец, участник, грант по группе, режим
|
|
4
|
+
* «всем пользователям»).
|
|
5
|
+
*
|
|
6
|
+
* Единый шов для двух мест, которым нужен один и тот же список:
|
|
7
|
+
* - список сессий (`routes/sessions.ts` → `resolveMemberProjectIds`);
|
|
8
|
+
* - подписки хаба (`events/hub.ts` → `registerClient`).
|
|
9
|
+
*
|
|
10
|
+
* Своей копии предиката здесь нет: список проектов считает резолвер доступа
|
|
11
|
+
* слоя 1 (`ProjectRepository.list(viewer)`).
|
|
12
|
+
*/
|
|
13
|
+
import type { ProjectRepository, SessionManager } from '@itphx/synth-core';
|
|
14
|
+
import type { Session } from '@itphx/synth-shared';
|
|
15
|
+
/** Кто запрашивает видимые сессии. */
|
|
16
|
+
export interface VisibleSessionScope {
|
|
17
|
+
/** Идентификатор пользователя (владелец сессии/проекта). */
|
|
18
|
+
userId: string;
|
|
19
|
+
/** Группы пользователя (PROP-133 Ф2): нет — групп нет (fail-closed). */
|
|
20
|
+
groups?: readonly string[];
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Идентификаторы проектов, видимых пользователю (владелец/участник/грант по
|
|
24
|
+
* группе/«всем пользователям»). Список без аргумента (все проекты) здесь не
|
|
25
|
+
* используется — он нужен elevated-ролям (`ADMIN`/`LEAD`), они идут отдельным
|
|
26
|
+
* путём (`resolveElevated`).
|
|
27
|
+
*/
|
|
28
|
+
export declare function resolveVisibleProjectIds(projectStore: ProjectRepository | undefined, scope: VisibleSessionScope): Promise<string[]>;
|
|
29
|
+
/**
|
|
30
|
+
* Сессии, видимые пользователю: свои + сессии видимых проектов.
|
|
31
|
+
*
|
|
32
|
+
* Пустой `userId` → пустой список (fail-closed: без идентификатора запроса
|
|
33
|
+
* выборка «все сессии» недопустима).
|
|
34
|
+
*/
|
|
35
|
+
export declare function listVisibleSessions(sessionManager: Pick<SessionManager, 'listSessions'>, projectStore: ProjectRepository | undefined, scope: VisibleSessionScope): Promise<Session[]>;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Идентификаторы проектов, видимых пользователю (владелец/участник/грант по
|
|
3
|
+
* группе/«всем пользователям»). Список без аргумента (все проекты) здесь не
|
|
4
|
+
* используется — он нужен elevated-ролям (`ADMIN`/`LEAD`), они идут отдельным
|
|
5
|
+
* путём (`resolveElevated`).
|
|
6
|
+
*/
|
|
7
|
+
export async function resolveVisibleProjectIds(projectStore, scope) {
|
|
8
|
+
if (!projectStore)
|
|
9
|
+
return [];
|
|
10
|
+
const projects = await projectStore.list({
|
|
11
|
+
userId: scope.userId,
|
|
12
|
+
...(scope.groups ? { groups: scope.groups } : {}),
|
|
13
|
+
});
|
|
14
|
+
return projects.map((project) => project.id);
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Сессии, видимые пользователю: свои + сессии видимых проектов.
|
|
18
|
+
*
|
|
19
|
+
* Пустой `userId` → пустой список (fail-closed: без идентификатора запроса
|
|
20
|
+
* выборка «все сессии» недопустима).
|
|
21
|
+
*/
|
|
22
|
+
export async function listVisibleSessions(sessionManager, projectStore, scope) {
|
|
23
|
+
if (!scope.userId)
|
|
24
|
+
return [];
|
|
25
|
+
const projectIds = await resolveVisibleProjectIds(projectStore, scope);
|
|
26
|
+
return sessionManager.listSessions(projectIds.length > 0
|
|
27
|
+
? { userId: scope.userId, projectIds }
|
|
28
|
+
: { userId: scope.userId });
|
|
29
|
+
}
|
package/dist/lib/app-config.js
CHANGED
|
@@ -6,6 +6,18 @@ const envInt = (key, fallback) => {
|
|
|
6
6
|
const v = process.env[key];
|
|
7
7
|
return v ? parseInt(v, 10) : fallback;
|
|
8
8
|
};
|
|
9
|
+
/**
|
|
10
|
+
* ADR-140: разобрать CSV-список имён групп (`SYNTH_OIDC_GROUPS_ALLOW`).
|
|
11
|
+
* По образцу соседних CSV-полей (`SYNTH_API_KEY_ROLES`,
|
|
12
|
+
* `SYNTH_ATTACHMENTS_MODALITIES`): trim, пустые элементы отбрасываются.
|
|
13
|
+
* Пустая строка → пустой список (групп нет — fail-closed).
|
|
14
|
+
*/
|
|
15
|
+
function parseCsvList(raw) {
|
|
16
|
+
return raw
|
|
17
|
+
.split(',')
|
|
18
|
+
.map((part) => part.trim())
|
|
19
|
+
.filter((part) => part.length > 0);
|
|
20
|
+
}
|
|
9
21
|
function buildAuthConfig(defaults) {
|
|
10
22
|
const debugMode = envBool('SYNTH_AUTH_DEBUG', defaults.debugMode);
|
|
11
23
|
let testUsers = [];
|
|
@@ -38,6 +50,16 @@ function buildAuthConfig(defaults) {
|
|
|
38
50
|
];
|
|
39
51
|
}
|
|
40
52
|
const oidcEnabled = envBool('SYNTH_OIDC_ENABLED', defaults.oidc?.enabled ?? false);
|
|
53
|
+
// ADR-140: источник групп — claim IdP + allowlist имён групп.
|
|
54
|
+
// Приоритет: env > config.yaml > дефолт (пустой allowlist → групп нет,
|
|
55
|
+
// fail-closed; «принять все» невозможно). Явно заданная (в т.ч. пустая)
|
|
56
|
+
// env-переменная перекрывает config.yaml — иначе «выключил» группы оператор
|
|
57
|
+
// не смог бы.
|
|
58
|
+
const groupsClaim = envStr('SYNTH_OIDC_GROUPS_CLAIM', defaults.oidc?.groups?.claim ?? 'groups');
|
|
59
|
+
const groupsAllowEnv = process.env.SYNTH_OIDC_GROUPS_ALLOW;
|
|
60
|
+
const groupsAllow = groupsAllowEnv !== undefined
|
|
61
|
+
? parseCsvList(groupsAllowEnv)
|
|
62
|
+
: (defaults.oidc?.groups?.allow ?? []);
|
|
41
63
|
return {
|
|
42
64
|
debugMode,
|
|
43
65
|
apiKey: envStr('SYNTH_API_KEY', defaults.apiKey ?? ''),
|
|
@@ -54,17 +76,25 @@ function buildAuthConfig(defaults) {
|
|
|
54
76
|
clientSecret: envStr('SYNTH_OIDC_CLIENT_SECRET', defaults.oidc?.clientSecret ?? ''),
|
|
55
77
|
redirectUri: envStr('SYNTH_OIDC_REDIRECT_URI', defaults.oidc?.redirectUri ?? 'http://localhost:5002/auth/callback'),
|
|
56
78
|
cliClientId: envStr('SYNTH_OIDC_CLI_CLIENT_ID', defaults.oidc?.cliClientId ?? 'synth-cli'),
|
|
79
|
+
groups: {
|
|
80
|
+
claim: groupsClaim,
|
|
81
|
+
allow: groupsAllow,
|
|
82
|
+
},
|
|
57
83
|
}
|
|
58
84
|
: undefined,
|
|
59
85
|
};
|
|
60
86
|
}
|
|
61
87
|
export async function loadBackendConfig(options) {
|
|
62
|
-
// F4 (аудит S1): профиль backend/managed включает LLM-шлюз по умолчанию —
|
|
63
|
-
// обфускация секретов, аудит каждого запроса и rate limit должны работать
|
|
64
|
-
// «из коробки». Явные config.yaml/env/CLI и runtime-тумблер из UI это
|
|
65
|
-
// перебивают (приоритет выше профиля). Standalone остаётся выключенным.
|
|
66
88
|
const synth = await loadConfig({
|
|
67
|
-
baseDefaults: {
|
|
89
|
+
baseDefaults: {
|
|
90
|
+
// PROP-136 (слайс 136a): managed-профиль включает аудит исполнений shell
|
|
91
|
+
// по умолчанию (наблюдаемость произвольного кода обязательна); explicit
|
|
92
|
+
// config.yaml/env (`SYNTH_COMMAND_AUDIT_ENABLED`) перебивают профиль,
|
|
93
|
+
// standalone остаётся выключенным. PROP-136b: зеркальный чекер команд в
|
|
94
|
+
// managed по умолчанию **fail-closed** (недоступность политики = deny);
|
|
95
|
+
// standalone сохраняет `open` из схемы.
|
|
96
|
+
security: { commandAudit: { enabled: true }, commandPolicy: { failMode: 'closed' } },
|
|
97
|
+
},
|
|
68
98
|
...options,
|
|
69
99
|
});
|
|
70
100
|
const auth = buildAuthConfig(synth.auth);
|
package/dist/lib/i18n.js
CHANGED
|
@@ -29,6 +29,9 @@ const en = {
|
|
|
29
29
|
'errors.validation.expectedFilesArray': 'expected { files: string[] }',
|
|
30
30
|
'errors.validation.claimCodeRequired': 'Confirmation code is required',
|
|
31
31
|
'errors.validation.invalidUsername': 'Invalid username',
|
|
32
|
+
// PROP-133: каталог пользователей (`GET /api/v2/users/directory`)
|
|
33
|
+
'errors.validation.invalidDirectoryLimit': 'Invalid limit value (an integer 0..200)',
|
|
34
|
+
'errors.validation.invalidDirectoryOffset': 'Invalid offset value (an integer >= 0)',
|
|
32
35
|
// PROP-054: точечные операции плана/журнала/инвариантов проекта
|
|
33
36
|
'errors.validation.invalidPlanBody': 'Invalid plan request payload',
|
|
34
37
|
'errors.validation.invalidLogBody': 'Invalid project log request payload',
|
|
@@ -95,6 +98,10 @@ const en = {
|
|
|
95
98
|
'errors.notFound.memoryProject': 'Project not found',
|
|
96
99
|
'errors.validation.memoryWorkspaceRequired': 'The project has no workspace: a file index cannot be built',
|
|
97
100
|
'errors.unavailable.memoryProvider': 'The memory provider is unavailable: the memory plugin is not active',
|
|
101
|
+
// PROP-135 (execution profiles/pools admin API)
|
|
102
|
+
'errors.validation.executionPoolKey': 'Invalid execution pool key (expected instance:<class>:<profile> or <project|session>:<id>:<class>:<profile>)',
|
|
103
|
+
'errors.unavailable.executionProvider': 'The execution pool provider is unavailable: dynamic pools require execution.remote.provider=http',
|
|
104
|
+
'errors.notFound.executionPool': 'Execution pool not found',
|
|
98
105
|
'errors.notFound.memoryIndex': 'Memory index not found',
|
|
99
106
|
'errors.failed.memoryIndex': 'Failed to perform the memory index operation',
|
|
100
107
|
'memory.indexCreated': 'Memory index created',
|
|
@@ -202,6 +209,9 @@ const ru = {
|
|
|
202
209
|
'errors.validation.expectedFilesArray': 'expected { files: string[] }',
|
|
203
210
|
'errors.validation.claimCodeRequired': 'Укажите код подтверждения',
|
|
204
211
|
'errors.validation.invalidUsername': 'Некорректное имя пользователя',
|
|
212
|
+
// PROP-133: каталог пользователей (`GET /api/v2/users/directory`)
|
|
213
|
+
'errors.validation.invalidDirectoryLimit': 'Некорректное значение limit (целое 0..200)',
|
|
214
|
+
'errors.validation.invalidDirectoryOffset': 'Некорректное значение offset (целое ≥ 0)',
|
|
205
215
|
// PROP-054: точечные операции плана/журнала/инвариантов проекта
|
|
206
216
|
'errors.validation.invalidPlanBody': 'Некорректное тело запроса плана',
|
|
207
217
|
'errors.validation.invalidLogBody': 'Некорректное тело запроса журнала проекта',
|
|
@@ -269,6 +279,10 @@ const ru = {
|
|
|
269
279
|
'errors.notFound.memoryProject': 'Проект не найден',
|
|
270
280
|
'errors.validation.memoryWorkspaceRequired': 'У проекта нет рабочего каталога: индекс файлов строить негде',
|
|
271
281
|
'errors.unavailable.memoryProvider': 'Провайдер памяти недоступен: плагин памяти не активен',
|
|
282
|
+
// PROP-135: admin-API профилей и пулов исполнения
|
|
283
|
+
'errors.validation.executionPoolKey': 'Некорректный ключ пула исполнения (ожидается instance:<class>:<profile> или <project|session>:<id>:<class>:<profile>)',
|
|
284
|
+
'errors.unavailable.executionProvider': 'Провайдер пулов исполнения недоступен: динамические пулы требуют execution.remote.provider=http',
|
|
285
|
+
'errors.notFound.executionPool': 'Пул исполнения не найден',
|
|
272
286
|
'errors.notFound.memoryIndex': 'Индекс памяти не найден',
|
|
273
287
|
'errors.failed.memoryIndex': 'Не удалось выполнить операцию с индексом памяти',
|
|
274
288
|
'memory.indexCreated': 'Индекс памяти создан',
|