@itphx/synth-backend 0.10.1 → 0.11.3
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/bootstrap.d.ts +2 -2
- package/dist/app/deps.d.ts +50 -32
- package/dist/app/deps.js +233 -99
- package/dist/app/listen.d.ts +7 -2
- package/dist/app/listen.js +12 -1
- package/dist/app/mount-routes.d.ts +16 -3
- package/dist/app/mount-routes.js +258 -28
- package/dist/app.d.ts +16 -7
- package/dist/app.js +104 -11
- package/dist/auth/guards.d.ts +2 -1
- package/dist/auth/guards.js +9 -1
- package/dist/auth/middleware.d.ts +2 -12
- package/dist/auth/middleware.js +20 -2
- package/dist/auth/oidc.d.ts +7 -0
- package/dist/auth/oidc.js +27 -6
- package/dist/auth/service-scope.d.ts +7 -3
- package/dist/auth/service-scope.js +8 -4
- package/dist/events/hub.js +3 -38
- package/dist/lib/app-config.d.ts +2 -0
- package/dist/lib/app-config.js +3 -2
- package/dist/lib/defaults-store.d.ts +2 -25
- package/dist/lib/defaults-store.js +5 -87
- package/dist/lib/i18n.js +48 -0
- package/dist/main.js +19 -3
- package/dist/routes/agents.d.ts +2 -2
- package/dist/routes/auth.d.ts +2 -2
- package/dist/routes/context.d.ts +2 -2
- package/dist/routes/gateway-patterns.d.ts +2 -2
- package/dist/routes/llm.d.ts +8 -2
- package/dist/routes/llm.js +4 -1
- package/dist/routes/mcp-registry.d.ts +3 -3
- package/dist/routes/mcp-registry.js +2 -2
- package/dist/routes/messages.d.ts +5 -4
- package/dist/routes/messages.js +30 -3
- package/dist/routes/models.d.ts +7 -2
- package/dist/routes/models.js +3 -1
- package/dist/routes/projects.d.ts +3 -3
- package/dist/routes/providers.d.ts +15 -3
- package/dist/routes/providers.js +33 -21
- package/dist/routes/queue.d.ts +5 -4
- package/dist/routes/queue.js +30 -3
- package/dist/routes/sessions.d.ts +13 -3
- package/dist/routes/sessions.js +197 -73
- package/dist/test-helpers/close-server.d.ts +33 -0
- package/dist/test-helpers/close-server.js +50 -0
- package/package.json +3 -3
package/dist/app.js
CHANGED
|
@@ -17,14 +17,14 @@ 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 {
|
|
21
|
-
import {
|
|
20
|
+
import { applyBootstrapServiceKeys, createHealthRoutes, createHttpMetricsMiddleware, createMetricsRoutes, KeyRateLimiter, getServiceCredential, MetricsRegistry, registerProcessMetrics, resolveMetricsEnabled, resolveMetricsToken, setSynthReady, } from '@itphx/synth-core';
|
|
21
|
+
import { createStorageDegradedGuard, createStorageStatusRoutes } from '@itphx/synth-core/server/storage-degraded.js';
|
|
22
22
|
import { loadBackendConfig } from './lib/app-config.js';
|
|
23
23
|
import { resolveCorsOrigin } from './lib/cors.js';
|
|
24
24
|
import { createAuthMiddleware } from './auth/middleware.js';
|
|
25
25
|
import { createAuthRoutes } from './routes/auth.js';
|
|
26
26
|
import { t } from './lib/i18n.js';
|
|
27
|
-
import { createBackendDeps } from './app/deps.js';
|
|
27
|
+
import { createBackendDeps, createBackendStorage } from './app/deps.js';
|
|
28
28
|
import { mountBackendRoutes } from './app/mount-routes.js';
|
|
29
29
|
import { createBackendListen } from './app/listen.js';
|
|
30
30
|
/**
|
|
@@ -56,10 +56,48 @@ export async function createBackendApp(opts = {}) {
|
|
|
56
56
|
const backendConfig = await loadBackendConfig({ configPath: opts.configPath });
|
|
57
57
|
const app = new Hono();
|
|
58
58
|
app.use(logger());
|
|
59
|
+
// PROP-032 (W2.4): единый контекст хранения — собирается до `auth`, реестр
|
|
60
|
+
// service-key (`storage.serviceKeys`) нужен резолверу `synth_svc_…`; тот же
|
|
61
|
+
// инстанс переиспользует `createBackendDeps` (в т.ч. `mcpRegistry`, который
|
|
62
|
+
// деп сидирует instance-серверами).
|
|
63
|
+
// ADR-094: контекст хранения нужен до включения метрик — runtime-настройка
|
|
64
|
+
// `metrics.enabled` (`settings.json`/PG) применяется при старте.
|
|
65
|
+
const storage = await createBackendStorage(backendConfig);
|
|
66
|
+
// ADR-094: метрики — реестр до middleware; при `metrics.enabled=false`
|
|
67
|
+
// ничего не собираем, `/metrics` отдаёт 404 (middleware не ставим).
|
|
68
|
+
// Приоритет: env `SYNTH_METRICS_ENABLED` > runtime (`settings.json`) >
|
|
69
|
+
// config.yaml `metrics.enabled` > default false.
|
|
70
|
+
const runtimeMetrics = await storage.settings.getMetrics();
|
|
71
|
+
const metricsEnabled = resolveMetricsEnabled({
|
|
72
|
+
configEnabled: backendConfig.synth.metrics.enabled,
|
|
73
|
+
runtimeEnabled: runtimeMetrics.enabled,
|
|
74
|
+
env: process.env,
|
|
75
|
+
}).enabled;
|
|
76
|
+
const metrics = new MetricsRegistry();
|
|
77
|
+
const stopProcessMetrics = metricsEnabled ? registerProcessMetrics(metrics) : null;
|
|
78
|
+
if (metricsEnabled)
|
|
79
|
+
app.use('*', createHttpMetricsMiddleware(metrics));
|
|
59
80
|
// CORS настраивается после загрузки конфига
|
|
60
|
-
// Health (без auth)
|
|
61
|
-
|
|
62
|
-
|
|
81
|
+
// Health (без auth). PROP-032 (W5): при деградации хранилища status='degraded'
|
|
82
|
+
// + блок storage (аддитивно к {status, version, time}). `degradedInfo`
|
|
83
|
+
// заполняется после сборки контекста хранения ниже (до первого запроса).
|
|
84
|
+
// ADR-094: `/ready` — readiness (200 и при деградации, 503 — только не готов).
|
|
85
|
+
const degradedInfo = storage.degraded ?? null;
|
|
86
|
+
let initialized = false;
|
|
87
|
+
app.route('/', createHealthRoutes({
|
|
88
|
+
getStorageDegraded: () => degradedInfo ?? null,
|
|
89
|
+
getReadiness: () => ({
|
|
90
|
+
ready: initialized,
|
|
91
|
+
storage: degradedInfo ? 'degraded' : 'ok',
|
|
92
|
+
}),
|
|
93
|
+
}));
|
|
94
|
+
// ADR-094: `/metrics` — до auth (скрейп по сети pod'а, опциональный bearer).
|
|
95
|
+
// Токен читается на каждый запрос — правка из UI применяется без рестарта.
|
|
96
|
+
app.route('/', createMetricsRoutes({
|
|
97
|
+
registry: metrics,
|
|
98
|
+
enabled: metricsEnabled,
|
|
99
|
+
getToken: metricsEnabled ? () => resolveMetricsToken(backendConfig.dataDir) : undefined,
|
|
100
|
+
}));
|
|
63
101
|
// Динамический CORS origin (fail-closed): явный ORIGIN через env `SYNTH_CORS_ORIGIN`;
|
|
64
102
|
// иначе явный dev-флаг `SYNTH_CORS_ALLOW_ALL=true` (отражать любой origin);
|
|
65
103
|
// иначе — точное совпадение с белым списком `server.allowedOrigins`.
|
|
@@ -75,9 +113,11 @@ export async function createBackendApp(opts = {}) {
|
|
|
75
113
|
}),
|
|
76
114
|
credentials: true,
|
|
77
115
|
}));
|
|
78
|
-
//
|
|
79
|
-
//
|
|
80
|
-
|
|
116
|
+
// PROP-032 (W5): состояние деградации — для health/guard/диагностики
|
|
117
|
+
// (уже проставлено при сборке контекста выше).
|
|
118
|
+
// ADR-052 (этап I): реестр service-key — резолвер ключа `synth_svc_…`
|
|
119
|
+
// нужен аутентификации (паритет с core `server/app.ts`).
|
|
120
|
+
const serviceApiKeyStore = storage.serviceKeys;
|
|
81
121
|
// ADR-052/O1: идемпотентный bootstrap installer-ключей из env/Secret
|
|
82
122
|
// (best-effort — ошибка конфигурации не роняет старт, пишется в лог).
|
|
83
123
|
await applyBootstrapServiceKeys(serviceApiKeyStore, backendConfig.synth.security.bootstrapServiceKeys ?? []);
|
|
@@ -120,11 +160,42 @@ export async function createBackendApp(opts = {}) {
|
|
|
120
160
|
await next();
|
|
121
161
|
}));
|
|
122
162
|
// Зависимости (stores/managers/оркестратор/событийное ядро/шедулер/webhooks).
|
|
123
|
-
|
|
163
|
+
// Тот же контекст хранения, что собран до `auth`. ADR-094: реестр передаётся
|
|
164
|
+
// только при `metrics.enabled` — иначе доменные коллекторы не подключаются.
|
|
165
|
+
const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined);
|
|
124
166
|
// Auth routes (после profilesStore)
|
|
125
167
|
app.route('/auth', createAuthRoutes(auth, backendConfig.auth, deps.profilesStore, deps.dataDir, deps.defaultsStore));
|
|
168
|
+
// PROP-032 (W5): деградированное хранилище — managed: доступ только роли
|
|
169
|
+
// ADMIN (остальным 503 STORAGE_DEGRADED), мутации — 503 STORAGE_DEGRADED_READONLY
|
|
170
|
+
// (кроме ремонтных операций maintenance). Guard — после auth-роутов (логин/health
|
|
171
|
+
// не блокируются) и до admin-роутов.
|
|
172
|
+
app.use('/api/*', createStorageDegradedGuard({
|
|
173
|
+
getDegraded: () => degradedInfo,
|
|
174
|
+
isAdmin: (c) => {
|
|
175
|
+
const user = c.get('user');
|
|
176
|
+
return Array.isArray(user?.roles) && user.roles.includes('ADMIN');
|
|
177
|
+
},
|
|
178
|
+
mutationAllowlist: ['/api/v2/maintenance'],
|
|
179
|
+
}));
|
|
180
|
+
// PROP-032 (W5): диагностика деградации (проверка соединения + «нужен рестарт»).
|
|
181
|
+
app.route('/', createStorageStatusRoutes({ getDegraded: () => degradedInfo }));
|
|
126
182
|
// Роуты API v2 (порядок монтирования — как раньше, см. mount-routes.ts).
|
|
127
|
-
mountBackendRoutes(app, auth, {
|
|
183
|
+
mountBackendRoutes(app, auth, {
|
|
184
|
+
config: backendConfig,
|
|
185
|
+
deps,
|
|
186
|
+
// ADR-094: админ-раздел «Наблюдаемость» — running-флаг, реестр,
|
|
187
|
+
// readiness, backend хранения и uptime.
|
|
188
|
+
metrics: {
|
|
189
|
+
runningEnabled: metricsEnabled,
|
|
190
|
+
getRegistry: () => metrics,
|
|
191
|
+
getReadiness: () => ({
|
|
192
|
+
ready: initialized,
|
|
193
|
+
storage: degradedInfo ? 'degraded' : 'ok',
|
|
194
|
+
}),
|
|
195
|
+
storageBackend: storage.kind,
|
|
196
|
+
getUptimeSec: () => Math.floor(process.uptime()),
|
|
197
|
+
},
|
|
198
|
+
});
|
|
128
199
|
// 404
|
|
129
200
|
app.notFound((c) => {
|
|
130
201
|
return c.json({
|
|
@@ -146,7 +217,13 @@ export async function createBackendApp(opts = {}) {
|
|
|
146
217
|
processMessage: deps.processMessage,
|
|
147
218
|
orchestrator: deps.orchestrator,
|
|
148
219
|
defaultPort: backendConfig.port,
|
|
220
|
+
// ADR-094: активные WS-соединения — в streams_active (если метрики включены).
|
|
221
|
+
metrics: metricsEnabled ? metrics : undefined,
|
|
149
222
|
});
|
|
223
|
+
// Композиция завершена — readiness переключается в ready (ADR-094).
|
|
224
|
+
initialized = true;
|
|
225
|
+
if (metricsEnabled)
|
|
226
|
+
setSynthReady(metrics, 1);
|
|
150
227
|
return {
|
|
151
228
|
app,
|
|
152
229
|
dataDir: deps.dataDir,
|
|
@@ -160,6 +237,20 @@ export async function createBackendApp(opts = {}) {
|
|
|
160
237
|
orchestrator: deps.orchestrator,
|
|
161
238
|
queueManager: deps.queueManager,
|
|
162
239
|
settingsStore: deps.settingsStore,
|
|
240
|
+
// ADR-094: реестр метрик и остановка процессных **и** доменных коллекторов
|
|
241
|
+
// (таймеры сессий/хранилища, подписка шины, decision/journal).
|
|
242
|
+
metrics,
|
|
243
|
+
stopMetrics: () => {
|
|
244
|
+
stopProcessMetrics?.stop();
|
|
245
|
+
for (const stop of deps.stopMetricsCollectors) {
|
|
246
|
+
try {
|
|
247
|
+
stop();
|
|
248
|
+
}
|
|
249
|
+
catch {
|
|
250
|
+
// Остановка метрик не должна ломать shutdown.
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
},
|
|
163
254
|
// ADR-089: ядро событий (понадобится на этапах 5–6).
|
|
164
255
|
eventRouter: deps.eventRouter,
|
|
165
256
|
requestSessionService: deps.requestSessionService,
|
|
@@ -172,11 +263,13 @@ export async function createBackendApp(opts = {}) {
|
|
|
172
263
|
stopScheduler: () => deps.schedulerService.stop(),
|
|
173
264
|
stopEphemeralSweeper: deps.stopEphemeralSweeper,
|
|
174
265
|
stopEventJournalPruner: deps.stopEventJournalPruner,
|
|
266
|
+
stopAnalyticsRollupPruner: deps.stopAnalyticsRollupPruner,
|
|
175
267
|
// ADR-052 (этап II): реестр подписок и движок webhooks + остановка на shutdown.
|
|
176
268
|
webhookStore: deps.webhookStore,
|
|
177
269
|
webhookService: deps.webhookService,
|
|
178
270
|
stopWebhookService: () => deps.webhookService.stop(),
|
|
179
271
|
stopWebhookDeliveryPruner: () => deps.stopWebhookDeliveryPruner(),
|
|
272
|
+
stopEgressLogPruner: () => deps.stopEgressLogPruner(),
|
|
180
273
|
listen,
|
|
181
274
|
};
|
|
182
275
|
}
|
package/dist/auth/guards.d.ts
CHANGED
|
@@ -3,7 +3,8 @@
|
|
|
3
3
|
* - запрос с service-key → требуется хотя бы один из `scopes`
|
|
4
4
|
* (`403 SCOPE_REQUIRED` иначе);
|
|
5
5
|
* - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
|
|
6
|
-
* роль ADMIN
|
|
6
|
+
* роль ADMIN: нет аутентификации → `401 UNAUTHORIZED`, аутентифицирован без
|
|
7
|
+
* роли → `403 FORBIDDEN` (семантика HTTP; раньше оба случая склеивались в 403).
|
|
7
8
|
*
|
|
8
9
|
* Требует уже отработавшего `attachUser`/`requireAuth` (пользователь/ключ в
|
|
9
10
|
* контексте). Используется на мутациях реестра MCP (`/servers*`), записи
|
package/dist/auth/guards.js
CHANGED
|
@@ -15,6 +15,10 @@ import { t } from '../lib/i18n.js';
|
|
|
15
15
|
function scopeDenied(c) {
|
|
16
16
|
return c.json({ error: { code: 'SCOPE_REQUIRED', message: t('errors.forbidden.scopeRequired', undefined, c) } }, 403);
|
|
17
17
|
}
|
|
18
|
+
/** `true`, если пользователь аутентифицирован (в контексте есть `user`). */
|
|
19
|
+
function isAuthenticated(c) {
|
|
20
|
+
return !!c.get('user');
|
|
21
|
+
}
|
|
18
22
|
/** `true`, если в контексте ADMIN (роли synthetic service-пользователя или человека). */
|
|
19
23
|
function isAdmin(c) {
|
|
20
24
|
const user = c.get('user');
|
|
@@ -25,7 +29,8 @@ function isAdmin(c) {
|
|
|
25
29
|
* - запрос с service-key → требуется хотя бы один из `scopes`
|
|
26
30
|
* (`403 SCOPE_REQUIRED` иначе);
|
|
27
31
|
* - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
|
|
28
|
-
* роль ADMIN
|
|
32
|
+
* роль ADMIN: нет аутентификации → `401 UNAUTHORIZED`, аутентифицирован без
|
|
33
|
+
* роли → `403 FORBIDDEN` (семантика HTTP; раньше оба случая склеивались в 403).
|
|
29
34
|
*
|
|
30
35
|
* Требует уже отработавшего `attachUser`/`requireAuth` (пользователь/ключ в
|
|
31
36
|
* контексте). Используется на мутациях реестра MCP (`/servers*`), записи
|
|
@@ -41,6 +46,9 @@ export function requireAdminOrScope(...scopes) {
|
|
|
41
46
|
await next();
|
|
42
47
|
return;
|
|
43
48
|
}
|
|
49
|
+
if (!isAuthenticated(c)) {
|
|
50
|
+
return c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
|
|
51
|
+
}
|
|
44
52
|
if (!isAdmin(c)) {
|
|
45
53
|
return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
46
54
|
}
|
|
@@ -32,18 +32,8 @@ export declare function createAuthMiddleware(config: AuthMiddlewareConfig): {
|
|
|
32
32
|
message: string;
|
|
33
33
|
};
|
|
34
34
|
}, 401, "json">)>;
|
|
35
|
-
requireAdmin: import("hono").MiddlewareHandler<any, string, {}, Response
|
|
36
|
-
|
|
37
|
-
code: string;
|
|
38
|
-
message: string;
|
|
39
|
-
};
|
|
40
|
-
}, 403, "json">)>;
|
|
41
|
-
requirePermission: (...roles: string[]) => import("hono").MiddlewareHandler<any, string, {}, Response | (Response & import("hono").TypedResponse<{
|
|
42
|
-
error: {
|
|
43
|
-
code: string;
|
|
44
|
-
message: string;
|
|
45
|
-
};
|
|
46
|
-
}, 403, "json">)>;
|
|
35
|
+
requireAdmin: import("hono").MiddlewareHandler<any, string, {}, Response>;
|
|
36
|
+
requirePermission: (...roles: string[]) => import("hono").MiddlewareHandler<any, string, {}, Response>;
|
|
47
37
|
isAdmin: (c: {
|
|
48
38
|
get(key: "user"): unknown;
|
|
49
39
|
}) => boolean;
|
package/dist/auth/middleware.js
CHANGED
|
@@ -168,10 +168,25 @@ export function createAuthMiddleware(config) {
|
|
|
168
168
|
c.set('user', user);
|
|
169
169
|
await next();
|
|
170
170
|
});
|
|
171
|
+
/**
|
|
172
|
+
* Семантика HTTP для ролевых guard'ов (`requireAdmin`/`requirePermission`):
|
|
173
|
+
* нет аутентификации → `401 UNAUTHORIZED`; аутентифицирован, но роли не хватает
|
|
174
|
+
* → `403 FORBIDDEN`. Возвращает готовый 401-ответ, если пользователя в контексте
|
|
175
|
+
* нет (иначе `null`). Раньше оба случая склеивались в 403, и анонимный запрос к
|
|
176
|
+
* ADMIN-роуту получал 403 вместо 401.
|
|
177
|
+
*/
|
|
178
|
+
const ensureAuthenticated = (c) => {
|
|
179
|
+
if (c.get('user'))
|
|
180
|
+
return null;
|
|
181
|
+
return c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
|
|
182
|
+
};
|
|
171
183
|
// Middleware: требовать роль ADMIN
|
|
172
184
|
const requireAdmin = createMiddleware(async (c, next) => {
|
|
185
|
+
const unauthenticated = ensureAuthenticated(c);
|
|
186
|
+
if (unauthenticated)
|
|
187
|
+
return unauthenticated;
|
|
173
188
|
const user = c.get('user');
|
|
174
|
-
if (!user
|
|
189
|
+
if (!user.roles.includes('ADMIN')) {
|
|
175
190
|
return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
176
191
|
}
|
|
177
192
|
await next();
|
|
@@ -193,8 +208,11 @@ export function createAuthMiddleware(config) {
|
|
|
193
208
|
const isAdmin = (c) => hasRole(c, 'ADMIN');
|
|
194
209
|
// Middleware: требовать одну из указанных ролей (например, ADMIN/AUDITOR)
|
|
195
210
|
const requirePermission = (...roles) => createMiddleware(async (c, next) => {
|
|
211
|
+
const unauthenticated = ensureAuthenticated(c);
|
|
212
|
+
if (unauthenticated)
|
|
213
|
+
return unauthenticated;
|
|
196
214
|
const user = c.get('user');
|
|
197
|
-
if (!
|
|
215
|
+
if (!roles.some((r) => user.roles.includes(r))) {
|
|
198
216
|
return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
199
217
|
}
|
|
200
218
|
await next();
|
package/dist/auth/oidc.d.ts
CHANGED
|
@@ -64,6 +64,13 @@ export declare class OidcClient {
|
|
|
64
64
|
* Роли: из id_token, если пусто — из access_token (client roles учитываются).
|
|
65
65
|
*/
|
|
66
66
|
verifyTokens(idToken: string, accessToken: string): Promise<OidcUser>;
|
|
67
|
+
/**
|
|
68
|
+
* ADR-099: JWKS-набор с **явным** транспортом доверия TLS/CA (`egressFetch`),
|
|
69
|
+
* а не через глобальный dispatcher процесса — точка не зависит от глобального
|
|
70
|
+
* состояния (`applyGlobalTlsTrust` остаётся основным каналом для прочих fetch).
|
|
71
|
+
* jose 6 отдаёт кастомный транспорт через символ `customFetch`.
|
|
72
|
+
*/
|
|
73
|
+
private _remoteJwks;
|
|
67
74
|
/** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
|
|
68
75
|
private _idTokenAudience;
|
|
69
76
|
/** Допустимые `aud` access_token: clientId ИЛИ `account` (+ дополнительные). */
|
package/dist/auth/oidc.js
CHANGED
|
@@ -1,4 +1,6 @@
|
|
|
1
|
-
import { jwtVerify, createRemoteJWKSet } from 'jose';
|
|
1
|
+
import { jwtVerify, createRemoteJWKSet, customFetch } from 'jose';
|
|
2
|
+
// ADR-099: дискавери/токен-эндпоинты/JWKS OIDC — через единый транспорт доверия TLS/CA.
|
|
3
|
+
import { egressFetch } from '@itphx/synth-core';
|
|
2
4
|
/** Audience access_token по умолчанию (Keycloak): клиент либо `account`. */
|
|
3
5
|
const DEFAULT_ACCESS_TOKEN_AUDIENCE = 'account';
|
|
4
6
|
/** Известные роли Synth (в realm роли записаны в нижнем регистре). */
|
|
@@ -20,7 +22,8 @@ export class OidcClient {
|
|
|
20
22
|
if (this._discovery)
|
|
21
23
|
return this._discovery;
|
|
22
24
|
const url = `${this.config.issuer}/.well-known/openid-configuration`;
|
|
23
|
-
|
|
25
|
+
// ADR-099: дискавери — через единый транспорт доверия TLS/CA.
|
|
26
|
+
const res = await egressFetch(url);
|
|
24
27
|
if (!res.ok) {
|
|
25
28
|
throw new Error(`OIDC discovery failed: ${res.status} ${url}`);
|
|
26
29
|
}
|
|
@@ -57,7 +60,8 @@ export class OidcClient {
|
|
|
57
60
|
client_id: this.config.clientId,
|
|
58
61
|
client_secret: this.config.clientSecret,
|
|
59
62
|
});
|
|
60
|
-
|
|
63
|
+
// ADR-099: обмен кода на токены — через единый транспорт доверия TLS/CA.
|
|
64
|
+
const res = await egressFetch(discovery.token_endpoint, {
|
|
61
65
|
method: 'POST',
|
|
62
66
|
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
|
|
63
67
|
body: body.toString(),
|
|
@@ -85,7 +89,8 @@ export class OidcClient {
|
|
|
85
89
|
password,
|
|
86
90
|
scope: 'openid',
|
|
87
91
|
});
|
|
88
|
-
|
|
92
|
+
// ADR-099: ROPC-вход — через единый транспорт доверия TLS/CA.
|
|
93
|
+
const res = await egressFetch(discovery.token_endpoint, {
|
|
89
94
|
method: 'POST',
|
|
90
95
|
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
|
|
91
96
|
body: body.toString(),
|
|
@@ -107,7 +112,7 @@ export class OidcClient {
|
|
|
107
112
|
*/
|
|
108
113
|
async verifyToken(token) {
|
|
109
114
|
const discovery = await this.getDiscovery();
|
|
110
|
-
const jwks =
|
|
115
|
+
const jwks = this._remoteJwks(discovery.jwks_uri);
|
|
111
116
|
// Тип bearer-токена заранее неизвестен (id_token или access_token), поэтому
|
|
112
117
|
// принимаем audience обоих классов: clientId (id_token) и clientId/`account`
|
|
113
118
|
// (access_token Keycloak). Issuer проверяется всегда.
|
|
@@ -123,7 +128,7 @@ export class OidcClient {
|
|
|
123
128
|
*/
|
|
124
129
|
async verifyTokens(idToken, accessToken) {
|
|
125
130
|
const discovery = await this.getDiscovery();
|
|
126
|
-
const jwks =
|
|
131
|
+
const jwks = this._remoteJwks(discovery.jwks_uri);
|
|
127
132
|
const { payload: idPayload } = await jwtVerify(idToken, jwks, {
|
|
128
133
|
issuer: this.config.issuer,
|
|
129
134
|
// id_token.aud = clientId (+ доп. из конфига).
|
|
@@ -139,6 +144,22 @@ export class OidcClient {
|
|
|
139
144
|
});
|
|
140
145
|
return extractUserFromTokens(idPayload, accessPayload, this.config.clientId);
|
|
141
146
|
}
|
|
147
|
+
/**
|
|
148
|
+
* ADR-099: JWKS-набор с **явным** транспортом доверия TLS/CA (`egressFetch`),
|
|
149
|
+
* а не через глобальный dispatcher процесса — точка не зависит от глобального
|
|
150
|
+
* состояния (`applyGlobalTlsTrust` остаётся основным каналом для прочих fetch).
|
|
151
|
+
* jose 6 отдаёт кастомный транспорт через символ `customFetch`.
|
|
152
|
+
*/
|
|
153
|
+
_remoteJwks(jwksUri) {
|
|
154
|
+
return createRemoteJWKSet(new URL(jwksUri), {
|
|
155
|
+
[customFetch]: (url, options) => egressFetch(url, {
|
|
156
|
+
headers: options.headers,
|
|
157
|
+
method: options.method,
|
|
158
|
+
redirect: options.redirect,
|
|
159
|
+
signal: options.signal,
|
|
160
|
+
}),
|
|
161
|
+
});
|
|
162
|
+
}
|
|
142
163
|
/** Допустимые `aud` id_token: clientId (+ дополнительные из конфига). */
|
|
143
164
|
_idTokenAudience() {
|
|
144
165
|
return [...new Set([this.config.clientId, ...(this.config.audience ?? [])])].filter(Boolean);
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { ServiceProjectProjectionGuard, ScopeGuardFactory } from '@itphx/synth-core';
|
|
2
2
|
/**
|
|
3
3
|
* ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
|
|
4
4
|
*
|
|
@@ -10,5 +10,9 @@ import type { ProjectGuard, ScopeGuardFactory } from '@itphx/synth-core';
|
|
|
10
10
|
*/
|
|
11
11
|
/** Scope-гейт: делегирует проверку core-`requireScope`, переводит 403 на i18n. */
|
|
12
12
|
export declare const scopeGuard: ScopeGuardFactory;
|
|
13
|
-
/**
|
|
14
|
-
|
|
13
|
+
/**
|
|
14
|
+
* Гейт **проектной проекции service-key**: делегирует core-
|
|
15
|
+
* `checkServiceProjectProjection`, переводит 403. Это не проверка прав
|
|
16
|
+
* пользователя (RBAC): для интерактивных кред — no-op.
|
|
17
|
+
*/
|
|
18
|
+
export declare const serviceProjectProjection: ServiceProjectProjectionGuard;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { createMiddleware } from 'hono/factory';
|
|
2
|
-
import { requireScope,
|
|
2
|
+
import { requireScope, checkServiceProjectProjection } from '@itphx/synth-core';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
4
|
/**
|
|
5
5
|
* ADR-052 (этап I): backend-обёртки scope-гейтов service-key.
|
|
@@ -26,9 +26,13 @@ export const scopeGuard = (...required) => {
|
|
|
26
26
|
await next();
|
|
27
27
|
});
|
|
28
28
|
};
|
|
29
|
-
/**
|
|
30
|
-
|
|
31
|
-
|
|
29
|
+
/**
|
|
30
|
+
* Гейт **проектной проекции service-key**: делегирует core-
|
|
31
|
+
* `checkServiceProjectProjection`, переводит 403. Это не проверка прав
|
|
32
|
+
* пользователя (RBAC): для интерактивных кред — no-op.
|
|
33
|
+
*/
|
|
34
|
+
export const serviceProjectProjection = (c, projectId) => {
|
|
35
|
+
const denied = checkServiceProjectProjection(c, projectId);
|
|
32
36
|
if (!denied)
|
|
33
37
|
return undefined;
|
|
34
38
|
return c.json({
|
package/dist/events/hub.js
CHANGED
|
@@ -1,42 +1,6 @@
|
|
|
1
|
+
import { extractChildSessionId } from '@itphx/synth-core';
|
|
1
2
|
/** Служебный ключ глобальной подписки all-клиента в `clientSubs`. */
|
|
2
3
|
const ALL_SESSIONS_KEY = '*';
|
|
3
|
-
/** Безопасное чтение непустой строки из `unknown`. */
|
|
4
|
-
function readString(value) {
|
|
5
|
-
return typeof value === 'string' && value.length > 0 ? value : undefined;
|
|
6
|
-
}
|
|
7
|
-
/**
|
|
8
|
-
* Извлечь id новой дочерней сессии из события, опубликованного в родительскую
|
|
9
|
-
* сессию. Дочерние сессии саб-агентов создаются тулом `task` напрямую через
|
|
10
|
-
* `SessionManager`, минуя роуты, поэтому клиент изначально на них не подписан.
|
|
11
|
-
* Тул `task` публикует `session.created` (payload — serializeSession ребёнка) в
|
|
12
|
-
* родителя ДО старта LLM-стрима ребёнка, так что автоподписка успевает.
|
|
13
|
-
* `child.session.updated` несёт `session` (id внутри), `child.message.added` и
|
|
14
|
-
* resume-события — `child_session_id`. Ключи каждого события читаются ровно в
|
|
15
|
-
* одном месте (типизированные payload-интерфейсы выше).
|
|
16
|
-
*/
|
|
17
|
-
function extractChildSessionId(event) {
|
|
18
|
-
const data = event.data;
|
|
19
|
-
if (!data)
|
|
20
|
-
return undefined;
|
|
21
|
-
switch (event.type) {
|
|
22
|
-
case 'session.created': {
|
|
23
|
-
const payload = data;
|
|
24
|
-
return readString(payload.id);
|
|
25
|
-
}
|
|
26
|
-
case 'child.session.updated': {
|
|
27
|
-
const payload = data;
|
|
28
|
-
return readString(payload.session?.id) ?? readString(payload.child_session_id);
|
|
29
|
-
}
|
|
30
|
-
case 'child.message.added':
|
|
31
|
-
case 'subagent.resume.started':
|
|
32
|
-
case 'subagent.resume.finished': {
|
|
33
|
-
const payload = data;
|
|
34
|
-
return readString(payload.child_session_id);
|
|
35
|
-
}
|
|
36
|
-
default:
|
|
37
|
-
return undefined;
|
|
38
|
-
}
|
|
39
|
-
}
|
|
40
4
|
/**
|
|
41
5
|
* EventHub — центральный диспетчер подписок на события сессий.
|
|
42
6
|
* Управляет active-клиентами пользователя (WS и SSE),
|
|
@@ -64,7 +28,8 @@ export class EventHub {
|
|
|
64
28
|
console.log(`[EventHub] Register client (all sessions): user=${client.username} clients=${arr.length}`);
|
|
65
29
|
return;
|
|
66
30
|
}
|
|
67
|
-
|
|
31
|
+
// Нужны только id сессий владельца — лёгкая выборка (без истории сообщений).
|
|
32
|
+
const sessions = await this.sessionManager.listSessions({ userId: client.userId }, { light: true });
|
|
68
33
|
console.log(`[EventHub] Register client: user=${client.username} clients=${arr.length} sessions=${sessions.length}`);
|
|
69
34
|
for (const s of sessions) {
|
|
70
35
|
this._subscribeClientToSession(client, s.id);
|
package/dist/lib/app-config.d.ts
CHANGED
package/dist/lib/app-config.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot } from '@itphx/synth-shared';
|
|
1
|
+
import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot, resolveMaxUploadBytes } from '@itphx/synth-shared';
|
|
2
2
|
const envStr = (key, fallback = '') => process.env[key] || fallback;
|
|
3
3
|
const envBool = (key, fallback = false) => process.env[key] ? process.env[key] === 'true' : fallback;
|
|
4
4
|
const envInt = (key, fallback) => {
|
|
@@ -59,6 +59,7 @@ export async function loadBackendConfig(options) {
|
|
|
59
59
|
const auth = buildAuthConfig(synth.auth);
|
|
60
60
|
const dataDir = resolveDataDir(synth);
|
|
61
61
|
const workspacesRoot = resolveWorkspacesRoot(synth);
|
|
62
|
+
const maxUploadBytes = resolveMaxUploadBytes(synth);
|
|
62
63
|
const port = resolvePort(synth, 'SYNTH_PORT', synth.server.port);
|
|
63
|
-
return { synth, dataDir, workspacesRoot, port, auth };
|
|
64
|
+
return { synth, dataDir, workspacesRoot, maxUploadBytes, port, auth };
|
|
64
65
|
}
|
|
@@ -1,25 +1,2 @@
|
|
|
1
|
-
export
|
|
2
|
-
|
|
3
|
-
themeMode?: 'system' | 'light' | 'dark';
|
|
4
|
-
theme?: string;
|
|
5
|
-
uiScaleMobile?: number;
|
|
6
|
-
uiScaleDesktop?: number;
|
|
7
|
-
}
|
|
8
|
-
export declare const UI_SCALE_MIN = 0.5;
|
|
9
|
-
export declare const UI_SCALE_MAX = 1.2;
|
|
10
|
-
/**
|
|
11
|
-
* Умолчания оформления (locale/themeMode/theme/uiScaleMobile/uiScaleDesktop) для всех пользователей.
|
|
12
|
-
*
|
|
13
|
-
* Хранятся одним JSON-файлом `{dataDir}/defaults.json`. Запись атомарная:
|
|
14
|
-
* временный файл `.tmp.{uuid}` → `rename()`. Значения переживают рестарт.
|
|
15
|
-
*/
|
|
16
|
-
export declare class DefaultsStore {
|
|
17
|
-
private _opts;
|
|
18
|
-
private _lock;
|
|
19
|
-
constructor(_opts: {
|
|
20
|
-
dataDir: string;
|
|
21
|
-
});
|
|
22
|
-
private _filePath;
|
|
23
|
-
loadDefaults(): Promise<AppearanceDefaults>;
|
|
24
|
-
saveDefaults(patch: AppearanceDefaults): Promise<AppearanceDefaults>;
|
|
25
|
-
}
|
|
1
|
+
export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';
|
|
2
|
+
export type { AppearanceDefaults } from '@itphx/synth-core';
|
|
@@ -1,87 +1,5 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
export
|
|
6
|
-
/**
|
|
7
|
-
* Валидирует масштаб интерфейса: число в диапазоне 0.5..1.2.
|
|
8
|
-
* Некорректное значение → undefined (поле отбрасывается).
|
|
9
|
-
*/
|
|
10
|
-
function sanitizeScale(value) {
|
|
11
|
-
if (typeof value === 'number' &&
|
|
12
|
-
Number.isFinite(value) &&
|
|
13
|
-
value >= UI_SCALE_MIN &&
|
|
14
|
-
value <= UI_SCALE_MAX) {
|
|
15
|
-
return value;
|
|
16
|
-
}
|
|
17
|
-
return undefined;
|
|
18
|
-
}
|
|
19
|
-
/**
|
|
20
|
-
* Оставляет только валидные поля умолчаний оформления: locale ru/en,
|
|
21
|
-
* themeMode system/light/dark, theme — непустая строка, uiScaleMobile и
|
|
22
|
-
* uiScaleDesktop — каждое независимо число в диапазоне 0.5..1.2.
|
|
23
|
-
* Некорректные поля отбрасываются (без исключений).
|
|
24
|
-
*/
|
|
25
|
-
function sanitize(raw) {
|
|
26
|
-
if (typeof raw !== 'object' || raw === null)
|
|
27
|
-
return {};
|
|
28
|
-
const src = raw;
|
|
29
|
-
const out = {};
|
|
30
|
-
if (src.locale === 'ru' || src.locale === 'en') {
|
|
31
|
-
out.locale = src.locale;
|
|
32
|
-
}
|
|
33
|
-
if (src.themeMode === 'system' || src.themeMode === 'light' || src.themeMode === 'dark') {
|
|
34
|
-
out.themeMode = src.themeMode;
|
|
35
|
-
}
|
|
36
|
-
if (typeof src.theme === 'string' && src.theme.trim() !== '') {
|
|
37
|
-
out.theme = src.theme;
|
|
38
|
-
}
|
|
39
|
-
const mobile = sanitizeScale(src.uiScaleMobile);
|
|
40
|
-
if (mobile !== undefined) {
|
|
41
|
-
out.uiScaleMobile = mobile;
|
|
42
|
-
}
|
|
43
|
-
const desktop = sanitizeScale(src.uiScaleDesktop);
|
|
44
|
-
if (desktop !== undefined) {
|
|
45
|
-
out.uiScaleDesktop = desktop;
|
|
46
|
-
}
|
|
47
|
-
return out;
|
|
48
|
-
}
|
|
49
|
-
/**
|
|
50
|
-
* Умолчания оформления (locale/themeMode/theme/uiScaleMobile/uiScaleDesktop) для всех пользователей.
|
|
51
|
-
*
|
|
52
|
-
* Хранятся одним JSON-файлом `{dataDir}/defaults.json`. Запись атомарная:
|
|
53
|
-
* временный файл `.tmp.{uuid}` → `rename()`. Значения переживают рестарт.
|
|
54
|
-
*/
|
|
55
|
-
export class DefaultsStore {
|
|
56
|
-
_opts;
|
|
57
|
-
_lock = new AsyncLock();
|
|
58
|
-
constructor(_opts) {
|
|
59
|
-
this._opts = _opts;
|
|
60
|
-
}
|
|
61
|
-
_filePath() {
|
|
62
|
-
return join(this._opts.dataDir, 'defaults.json');
|
|
63
|
-
}
|
|
64
|
-
async loadDefaults() {
|
|
65
|
-
try {
|
|
66
|
-
const data = await readFile(this._filePath(), 'utf-8');
|
|
67
|
-
return sanitize(JSON.parse(data));
|
|
68
|
-
}
|
|
69
|
-
catch {
|
|
70
|
-
return {};
|
|
71
|
-
}
|
|
72
|
-
}
|
|
73
|
-
async saveDefaults(patch) {
|
|
74
|
-
await this._lock.acquire();
|
|
75
|
-
try {
|
|
76
|
-
const current = await this.loadDefaults();
|
|
77
|
-
const next = { ...current, ...sanitize(patch) };
|
|
78
|
-
const path = this._filePath();
|
|
79
|
-
await mkdir(dirname(path), { recursive: true });
|
|
80
|
-
await atomicWrite((p, d) => writeFile(p, d, 'utf-8'), (o, n) => rename(o, n), path, JSON.stringify(next, null, 2));
|
|
81
|
-
return next;
|
|
82
|
-
}
|
|
83
|
-
finally {
|
|
84
|
-
this._lock.release();
|
|
85
|
-
}
|
|
86
|
-
}
|
|
87
|
-
}
|
|
1
|
+
// PROP-032 (W2.3): реализация перенесена в core (`storage/defaults-store.ts`) —
|
|
2
|
+
// это просто `{dataDir}/defaults.json` + атомарная запись, без backend-специфики.
|
|
3
|
+
// Здесь оставлен реэкспорт, чтобы существующие импорты (`../lib/defaults-store.js`)
|
|
4
|
+
// не менялись. См. `@itphx/synth-core`.
|
|
5
|
+
export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';
|