@itphx/synth-backend 0.11.3 → 0.13.4
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 +37 -5
- package/dist/app/deps.js +1172 -37
- package/dist/app/listen.d.ts +7 -1
- package/dist/app/listen.js +182 -16
- package/dist/app/mount-routes.js +493 -12
- package/dist/app/sse-events.d.ts +4 -0
- package/dist/app/sse-events.js +53 -6
- package/dist/app.d.ts +30 -2
- package/dist/app.js +54 -8
- package/dist/auth/guards.d.ts +15 -0
- package/dist/auth/guards.js +37 -1
- package/dist/auth/plugin-scope.d.ts +10 -0
- package/dist/auth/plugin-scope.js +69 -0
- package/dist/events/hub.d.ts +17 -0
- package/dist/events/hub.js +46 -14
- package/dist/lib/app-config.d.ts +4 -0
- package/dist/lib/app-config.js +4 -2
- package/dist/lib/defaults-store.d.ts +1 -1
- package/dist/lib/defaults-store.js +2 -2
- package/dist/lib/i18n.js +123 -2
- package/dist/lib/recalc-can-summarize.js +8 -3
- package/dist/main.js +52 -3
- package/dist/routes/agents.d.ts +11 -2
- package/dist/routes/agents.js +15 -2
- package/dist/routes/auth.d.ts +11 -1
- package/dist/routes/auth.js +45 -3
- package/dist/routes/llm.js +29 -7
- package/dist/routes/mcp-registry.d.ts +13 -1
- package/dist/routes/mcp-registry.js +120 -19
- package/dist/routes/messages.d.ts +4 -2
- package/dist/routes/messages.js +7 -1
- package/dist/routes/processes.d.ts +34 -0
- package/dist/routes/processes.js +26 -0
- package/dist/routes/projects.d.ts +14 -2
- package/dist/routes/projects.js +28 -1
- package/dist/routes/queue.d.ts +4 -1
- package/dist/routes/queue.js +4 -1
- package/dist/routes/sessions.d.ts +74 -6
- package/dist/routes/sessions.js +85 -93
- package/package.json +6 -6
package/dist/app/sse-events.js
CHANGED
|
@@ -1,7 +1,12 @@
|
|
|
1
1
|
import { getServiceCredential } from '@itphx/synth-core';
|
|
2
|
+
import { MESSAGE_MODEL_QUERY_PARAM, MESSAGE_MODEL_UNSUPPORTED_REASON, isSupportedMessageModelParam, parseSinceParam, } from '@itphx/synth-core';
|
|
2
3
|
/**
|
|
3
4
|
* Зарегистрировать SSE-хаб (`GET /api/v2/events`): подписка на события сессий
|
|
4
5
|
* пользователя (watch-all — для service-key и ADMIN/LEAD, ADR-052 этап IV).
|
|
6
|
+
*
|
|
7
|
+
* ADR-118 §6/§8: кадр несёт `id:` (глобальный номер события) — по нему
|
|
8
|
+
* работает догон (`Last-Event-ID` / `?since`); клиент обязан заявить модель
|
|
9
|
+
* сообщений (`messageModel=2`) — иначе поток не устанавливается (fail-closed).
|
|
5
10
|
*/
|
|
6
11
|
export function registerEventsSse(app, deps) {
|
|
7
12
|
const { auth, eventHub, scopeGuard } = deps;
|
|
@@ -10,6 +15,13 @@ export function registerEventsSse(app, deps) {
|
|
|
10
15
|
app.get('/api/v2/events', auth.requireAuth, scopeGuard('events:watch'), async (c) => {
|
|
11
16
|
const user = (await auth.getCurrentUser(c));
|
|
12
17
|
const signal = c.req.raw.signal;
|
|
18
|
+
// ADR-118 §8: гейт минимальной версии клиента (fail-closed) — без
|
|
19
|
+
// `messageModel=2` поток не открывается (426 Upgrade Required).
|
|
20
|
+
if (!isSupportedMessageModelParam(c.req.query(MESSAGE_MODEL_QUERY_PARAM))) {
|
|
21
|
+
return c.json({ error: { code: 'UPGRADE_REQUIRED', message: MESSAGE_MODEL_UNSUPPORTED_REASON } }, 426);
|
|
22
|
+
}
|
|
23
|
+
// ADR-118 §6: догон — `Last-Event-ID` (заголовок) либо `?since=`.
|
|
24
|
+
const sinceSeq = parseSinceParam(c.req.header('last-event-id') ?? c.req.query('since'));
|
|
13
25
|
// ADR-052 (этап IV) / ADR-089: машинный watcher (service-key со scope
|
|
14
26
|
// `events:watch`) и роли сквозного обзора ADMIN/LEAD получают события ВСЕХ
|
|
15
27
|
// сессий (паритет со standalone-core `subscribeAll`), обычный пользователь —
|
|
@@ -19,23 +31,58 @@ export function registerEventsSse(app, deps) {
|
|
|
19
31
|
return new Response(new ReadableStream({
|
|
20
32
|
async start(controller) {
|
|
21
33
|
const encoder = new TextEncoder();
|
|
34
|
+
/**
|
|
35
|
+
* ADR-118 §6: порядок «сначала журнал, потом живое». Пока идёт
|
|
36
|
+
* воспроизведение журнала, живые события копятся в буфере; уже
|
|
37
|
+
* отправленные номера (`sentSeq`) отсекают дубли.
|
|
38
|
+
*/
|
|
39
|
+
let replaying = sinceSeq !== null;
|
|
40
|
+
const pending = [];
|
|
41
|
+
const sentSeq = new Map();
|
|
42
|
+
const write = (event) => {
|
|
43
|
+
const seq = event.eventSeq;
|
|
44
|
+
if (typeof seq === 'number') {
|
|
45
|
+
const last = sentSeq.get(event.sessionId) ?? 0;
|
|
46
|
+
if (seq <= last)
|
|
47
|
+
return;
|
|
48
|
+
sentSeq.set(event.sessionId, seq);
|
|
49
|
+
}
|
|
50
|
+
try {
|
|
51
|
+
// `id:` — глобальный номер события (ADR-118 §6): по нему
|
|
52
|
+
// клиент продолжает ленту после переподключения (`Last-Event-ID`).
|
|
53
|
+
const id = typeof event.eventSeq === 'number' ? `id: ${event.eventSeq}\n` : '';
|
|
54
|
+
const line = `${id}data: ${JSON.stringify(event)}\n\n`;
|
|
55
|
+
controller.enqueue(encoder.encode(line));
|
|
56
|
+
}
|
|
57
|
+
catch {
|
|
58
|
+
// client disconnected
|
|
59
|
+
}
|
|
60
|
+
};
|
|
22
61
|
const sseClient = {
|
|
23
62
|
userId: user.id,
|
|
24
63
|
username: user.username,
|
|
25
64
|
allSessions,
|
|
26
65
|
send(event) {
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
}
|
|
31
|
-
catch {
|
|
32
|
-
// client disconnected
|
|
66
|
+
if (replaying) {
|
|
67
|
+
pending.push(event);
|
|
68
|
+
return;
|
|
33
69
|
}
|
|
70
|
+
write(event);
|
|
34
71
|
},
|
|
35
72
|
};
|
|
36
73
|
try {
|
|
37
74
|
console.log(`[SSE /api/v2/events] Connected: user=${user.username} allSessions=${allSessions}`);
|
|
38
75
|
await eventHub.registerClient(sseClient);
|
|
76
|
+
// ADR-118 §6: догон — журнал строго после `since`, затем живые
|
|
77
|
+
// события (буфер), без разрыва и без дублей.
|
|
78
|
+
if (sinceSeq !== null) {
|
|
79
|
+
for (const event of eventHub.replayForClient(sseClient, sinceSeq))
|
|
80
|
+
write(event);
|
|
81
|
+
}
|
|
82
|
+
replaying = false;
|
|
83
|
+
for (const event of pending)
|
|
84
|
+
write(event);
|
|
85
|
+
pending.length = 0;
|
|
39
86
|
// Keepalive: раз в 30 секунд отправляем комментарий для предотвращения разрыва
|
|
40
87
|
const keepalive = setInterval(() => {
|
|
41
88
|
try {
|
package/dist/app.d.ts
CHANGED
|
@@ -2,7 +2,7 @@ import { createServer } from 'node:http';
|
|
|
2
2
|
import { WebSocketServer } from 'ws';
|
|
3
3
|
import { Hono } from 'hono';
|
|
4
4
|
import { MetricsRegistry } from '@itphx/synth-core';
|
|
5
|
-
import type { EventBus, SessionManager, QueueProcessorManager, ChatOrchestrator, ProjectRepository, SettingsRepository, EventRouter, RequestSessionService, EventBindingRepository, EventJournalRepository, EventIngress, ScheduleRepository, SchedulerService, WebhookRepository, WebhookService } from '@itphx/synth-core';
|
|
5
|
+
import type { EventBus, SessionManager, QueueProcessorManager, ChatOrchestrator, ProjectRepository, SettingsRepository, EventRouter, RequestSessionService, EventBindingRepository, EventJournalRepository, EventIngress, ScheduleRepository, SchedulerService, WebhookRepository, WebhookService, PluginRuntime, McpManager } from '@itphx/synth-core';
|
|
6
6
|
import type { BackendConfig } from './lib/app-config.js';
|
|
7
7
|
import type { AuthKit } from './auth/middleware.js';
|
|
8
8
|
import type { EventHub } from './events/hub.js';
|
|
@@ -43,6 +43,16 @@ export interface BackendAppHandle {
|
|
|
43
43
|
eventJournal: EventJournalRepository;
|
|
44
44
|
/** ADR-089: ingress-точка приёма внешних событий. */
|
|
45
45
|
ingress: EventIngress;
|
|
46
|
+
/**
|
|
47
|
+
* ADR-090 (Ф5б-1): рантайм плагинов — старт-активация установленного
|
|
48
|
+
* (`main.ts`) и точки для HTTP API/CLI (Ф5б-2/3).
|
|
49
|
+
*/
|
|
50
|
+
pluginRuntime: PluginRuntime;
|
|
51
|
+
/**
|
|
52
|
+
* ADR-071 §2.5: менеджер MCP. Конфиг серверов приходит из единого реестра
|
|
53
|
+
* (в т.ч. после привязки внешнего доступа к коннектору, ADR-105 Ф4).
|
|
54
|
+
*/
|
|
55
|
+
mcpManager: McpManager;
|
|
46
56
|
scheduleStore: ScheduleRepository;
|
|
47
57
|
scheduler: SchedulerService;
|
|
48
58
|
/** ADR-051 (срез): остановка планировщика (на graceful shutdown). */
|
|
@@ -51,8 +61,26 @@ export interface BackendAppHandle {
|
|
|
51
61
|
stopEphemeralSweeper: () => void;
|
|
52
62
|
/** ADR-089: остановка периодической retention-очистки журнала событий. */
|
|
53
63
|
stopEventJournalPruner: () => void;
|
|
54
|
-
/**
|
|
64
|
+
/** ADR-102: остановка retention-очистки суточных роллапов аналитики. */
|
|
55
65
|
stopAnalyticsRollupPruner: () => void;
|
|
66
|
+
/**
|
|
67
|
+
* Этап 1 roadmap 0.13 (блок 3): остановка retention-очистки вопросов и
|
|
68
|
+
* освобождение ожиданий ответа.
|
|
69
|
+
*/
|
|
70
|
+
stopQuestionPruner: () => void;
|
|
71
|
+
/**
|
|
72
|
+
* Этап 1 roadmap 0.13 (блок 4): остановка retention-очистки реестра фоновых
|
|
73
|
+
* прогонов (PROP-096).
|
|
74
|
+
*/
|
|
75
|
+
stopBackgroundRunPruner: () => void;
|
|
76
|
+
/**
|
|
77
|
+
* PROP-097 (блок 5b): остановка retention-очистки логов фоновых процессов.
|
|
78
|
+
*/
|
|
79
|
+
stopProcessLogPruner: () => void;
|
|
80
|
+
/** ADR-115: остановка GC осиротевших вложений сообщений. */
|
|
81
|
+
stopAttachmentPruner: () => void;
|
|
82
|
+
/** ADR-115 × ADR-077: остановка уборки временных каталогов медиа-раннера. */
|
|
83
|
+
stopMediaTempPruner: () => void;
|
|
56
84
|
/** ADR-052 (этап II): реестр подписок webhooks (для тестов/диагностики). */
|
|
57
85
|
webhookStore: WebhookRepository;
|
|
58
86
|
/** ADR-052 (этап II): движок исходящих webhooks. */
|
package/dist/app.js
CHANGED
|
@@ -17,11 +17,13 @@ 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, createHealthRoutes, createHttpMetricsMiddleware, createMetricsRoutes, KeyRateLimiter, getServiceCredential, MetricsRegistry, registerProcessMetrics, resolveMetricsEnabled, resolveMetricsToken, setSynthReady, } from '@itphx/synth-core';
|
|
20
|
+
import { applyBootstrapServiceKeys, checkExecutionMode, createHealthRoutes, createHttpMetricsMiddleware, createMetricsRoutes, KeyRateLimiter, getServiceCredential, MetricsRegistry, registerProcessMetrics, resolveMetricsEnabled, resolveMetricsToken, resolvePluginServerPolicy, setSynthReady, } from '@itphx/synth-core';
|
|
21
|
+
import { resolveExecutionConfig } from '@itphx/synth-shared';
|
|
21
22
|
import { createStorageDegradedGuard, createStorageStatusRoutes } from '@itphx/synth-core/server/storage-degraded.js';
|
|
22
23
|
import { loadBackendConfig } from './lib/app-config.js';
|
|
23
24
|
import { resolveCorsOrigin } from './lib/cors.js';
|
|
24
25
|
import { createAuthMiddleware } from './auth/middleware.js';
|
|
26
|
+
import { requirePluginTokenBinding } from './auth/plugin-scope.js';
|
|
25
27
|
import { createAuthRoutes } from './routes/auth.js';
|
|
26
28
|
import { t } from './lib/i18n.js';
|
|
27
29
|
import { createBackendDeps, createBackendStorage } from './app/deps.js';
|
|
@@ -54,9 +56,17 @@ export async function createBackendApp(opts = {}) {
|
|
|
54
56
|
try {
|
|
55
57
|
// Конфигурация
|
|
56
58
|
const backendConfig = await loadBackendConfig({ configPath: opts.configPath });
|
|
59
|
+
// ADR-077: топология исполнения — параметр запуска (инвариант 24). Fail-closed:
|
|
60
|
+
// неверный `mode`/`failMode` — ошибка; `remote` без адресов/пакета исполнителя/
|
|
61
|
+
// читаемого токена — старт прерывается, а не «молча уходит в inline».
|
|
62
|
+
const execution = resolveExecutionConfig(backendConfig.synth, process.env);
|
|
63
|
+
const executionCheck = await checkExecutionMode(execution);
|
|
64
|
+
if (!executionCheck.ok) {
|
|
65
|
+
throw new Error(executionCheck.message);
|
|
66
|
+
}
|
|
57
67
|
const app = new Hono();
|
|
58
68
|
app.use(logger());
|
|
59
|
-
//
|
|
69
|
+
// ADR-096 (W2.4): единый контекст хранения — собирается до `auth`, реестр
|
|
60
70
|
// service-key (`storage.serviceKeys`) нужен резолверу `synth_svc_…`; тот же
|
|
61
71
|
// инстанс переиспользует `createBackendDeps` (в т.ч. `mcpRegistry`, который
|
|
62
72
|
// деп сидирует instance-серверами).
|
|
@@ -78,7 +88,7 @@ export async function createBackendApp(opts = {}) {
|
|
|
78
88
|
if (metricsEnabled)
|
|
79
89
|
app.use('*', createHttpMetricsMiddleware(metrics));
|
|
80
90
|
// CORS настраивается после загрузки конфига
|
|
81
|
-
// Health (без auth).
|
|
91
|
+
// Health (без auth). ADR-098 (W5): при деградации хранилища status='degraded'
|
|
82
92
|
// + блок storage (аддитивно к {status, version, time}). `degradedInfo`
|
|
83
93
|
// заполняется после сборки контекста хранения ниже (до первого запроса).
|
|
84
94
|
// ADR-094: `/ready` — readiness (200 и при деградации, 503 — только не готов).
|
|
@@ -113,7 +123,7 @@ export async function createBackendApp(opts = {}) {
|
|
|
113
123
|
}),
|
|
114
124
|
credentials: true,
|
|
115
125
|
}));
|
|
116
|
-
//
|
|
126
|
+
// ADR-098 (W5): состояние деградации — для health/guard/диагностики
|
|
117
127
|
// (уже проставлено при сборке контекста выше).
|
|
118
128
|
// ADR-052 (этап I): реестр service-key — резолвер ключа `synth_svc_…`
|
|
119
129
|
// нужен аутентификации (паритет с core `server/app.ts`).
|
|
@@ -162,10 +172,26 @@ export async function createBackendApp(opts = {}) {
|
|
|
162
172
|
// Зависимости (stores/managers/оркестратор/событийное ядро/шедулер/webhooks).
|
|
163
173
|
// Тот же контекст хранения, что собран до `auth`. ADR-094: реестр передаётся
|
|
164
174
|
// только при `metrics.enabled` — иначе доменные коллекторы не подключаются.
|
|
165
|
-
const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined);
|
|
175
|
+
const deps = await createBackendDeps(backendConfig, storage, metricsEnabled ? metrics : undefined, execution);
|
|
166
176
|
// Auth routes (после profilesStore)
|
|
167
|
-
app.route('/auth', createAuthRoutes(auth, backendConfig.auth, deps.profilesStore, deps.dataDir, deps.defaultsStore
|
|
168
|
-
//
|
|
177
|
+
app.route('/auth', createAuthRoutes(auth, backendConfig.auth, deps.profilesStore, deps.dataDir, deps.defaultsStore,
|
|
178
|
+
// ADR-090 Ф7: сигнал о серверной политике плагинов для публичного
|
|
179
|
+
// дискавери (`/auth/oidc-meta`) — только режим и признак включения
|
|
180
|
+
// слоя, без списка имён.
|
|
181
|
+
{
|
|
182
|
+
enabled: deps.pluginRuntime.config.enabled,
|
|
183
|
+
mode: deps.pluginRuntime.config.hybrid.mode,
|
|
184
|
+
}));
|
|
185
|
+
// ADR-090 Ф7 (Уровень 2): plugin-bound service-key (`plugin_id`)
|
|
186
|
+
// принимается только с заголовком `X-Synth-Plugin-Id` и тем же
|
|
187
|
+
// значением, со scope `plugins:invoke` и — при
|
|
188
|
+
// `plugins.hybrid.mode='allowlist'` — с именем плагина в серверном
|
|
189
|
+
// allow-list. Гейт стоит на границе (после `attachUser`, где уже
|
|
190
|
+
// разрешён service-кредентал), поэтому правило действует на **все**
|
|
191
|
+
// серверные API, а не только на плагинные роуты. Fail-closed: ключ с
|
|
192
|
+
// привязкой без корректного заголовка отвергается всегда.
|
|
193
|
+
app.use('/api/v2/*', requirePluginTokenBinding(() => resolvePluginServerPolicy(deps.pluginRuntime.config)));
|
|
194
|
+
// ADR-098 (W5): деградированное хранилище — managed: доступ только роли
|
|
169
195
|
// ADMIN (остальным 503 STORAGE_DEGRADED), мутации — 503 STORAGE_DEGRADED_READONLY
|
|
170
196
|
// (кроме ремонтных операций maintenance). Guard — после auth-роутов (логин/health
|
|
171
197
|
// не блокируются) и до admin-роутов.
|
|
@@ -177,7 +203,7 @@ export async function createBackendApp(opts = {}) {
|
|
|
177
203
|
},
|
|
178
204
|
mutationAllowlist: ['/api/v2/maintenance'],
|
|
179
205
|
}));
|
|
180
|
-
//
|
|
206
|
+
// ADR-098 (W5): диагностика деградации (проверка соединения + «нужен рестарт»).
|
|
181
207
|
app.route('/', createStorageStatusRoutes({ getDegraded: () => degradedInfo }));
|
|
182
208
|
// Роуты API v2 (порядок монтирования — как раньше, см. mount-routes.ts).
|
|
183
209
|
mountBackendRoutes(app, auth, {
|
|
@@ -217,6 +243,9 @@ export async function createBackendApp(opts = {}) {
|
|
|
217
243
|
processMessage: deps.processMessage,
|
|
218
244
|
orchestrator: deps.orchestrator,
|
|
219
245
|
defaultPort: backendConfig.port,
|
|
246
|
+
// ADR-106 Ф3: реестр подтверждений — ответ на `permission_reply`
|
|
247
|
+
// принимает только носитель покрывающего гранта (не «кто видит сессию»).
|
|
248
|
+
approvalRegistry: deps.approvalRegistry,
|
|
220
249
|
// ADR-094: активные WS-соединения — в streams_active (если метрики включены).
|
|
221
250
|
metrics: metricsEnabled ? metrics : undefined,
|
|
222
251
|
});
|
|
@@ -257,6 +286,10 @@ export async function createBackendApp(opts = {}) {
|
|
|
257
286
|
eventBindingStore: deps.eventBindingStore,
|
|
258
287
|
eventJournal: deps.eventJournal,
|
|
259
288
|
ingress: deps.eventIngress,
|
|
289
|
+
// ADR-090 (Ф5б-1): рантайм плагинов — старт-активация в `main.ts`
|
|
290
|
+
// и точки для HTTP API/CLI (Ф5б-2/3).
|
|
291
|
+
pluginRuntime: deps.pluginRuntime,
|
|
292
|
+
mcpManager: deps.mcpManager,
|
|
260
293
|
// ADR-051 (срез) / ADR-089: реестр расписаний и планировщик.
|
|
261
294
|
scheduleStore: deps.scheduleStore,
|
|
262
295
|
scheduler: deps.schedulerService,
|
|
@@ -264,6 +297,19 @@ export async function createBackendApp(opts = {}) {
|
|
|
264
297
|
stopEphemeralSweeper: deps.stopEphemeralSweeper,
|
|
265
298
|
stopEventJournalPruner: deps.stopEventJournalPruner,
|
|
266
299
|
stopAnalyticsRollupPruner: deps.stopAnalyticsRollupPruner,
|
|
300
|
+
// Этап 1 roadmap 0.13 (блок 3): retention-очистка вопросов + ожидания.
|
|
301
|
+
stopQuestionPruner: () => {
|
|
302
|
+
deps.stopQuestionPruner();
|
|
303
|
+
deps.questionService?.dispose();
|
|
304
|
+
},
|
|
305
|
+
// Этап 1 roadmap 0.13 (блок 4): retention-очистка реестра фоновых прогонов.
|
|
306
|
+
stopBackgroundRunPruner: () => deps.stopBackgroundRunPruner(),
|
|
307
|
+
// PROP-097 (блок 5b): retention-очистка логов фоновых процессов.
|
|
308
|
+
stopProcessLogPruner: () => deps.stopProcessLogPruner(),
|
|
309
|
+
// ADR-115: GC осиротевших вложений сообщений.
|
|
310
|
+
stopAttachmentPruner: () => deps.stopAttachmentPruner(),
|
|
311
|
+
// ADR-115 × ADR-077: уборка временных каталогов медиа-раннера.
|
|
312
|
+
stopMediaTempPruner: () => deps.stopMediaTempPruner(),
|
|
267
313
|
// ADR-052 (этап II): реестр подписок и движок webhooks + остановка на shutdown.
|
|
268
314
|
webhookStore: deps.webhookStore,
|
|
269
315
|
webhookService: deps.webhookService,
|
package/dist/auth/guards.d.ts
CHANGED
|
@@ -11,6 +11,21 @@
|
|
|
11
11
|
* скиллов и чтении пользователей.
|
|
12
12
|
*/
|
|
13
13
|
export declare function requireAdminOrScope(...scopes: string[]): import("hono").MiddlewareHandler<any, string, {}, Response>;
|
|
14
|
+
/**
|
|
15
|
+
* Guard «scope **или** роль ADMIN»:
|
|
16
|
+
* - service-key → проходит, если у него есть хотя бы один из `scopes`
|
|
17
|
+
* (`403 SCOPE_REQUIRED` иначе) **или** среди выданных ролей есть `ADMIN`
|
|
18
|
+
* (роль ключа — явное решение администратора, и до введения зонтичных
|
|
19
|
+
* scope'ов именно она давала доступ к таким операциям);
|
|
20
|
+
* - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
|
|
21
|
+
* роль ADMIN: нет аутентификации → `401 UNAUTHORIZED`, аутентифицирован без
|
|
22
|
+
* роли → `403 FORBIDDEN` (семантика HTTP; раньше оба случая склеивались в 403).
|
|
23
|
+
*
|
|
24
|
+
* Отличие от `requireAdminOrScope`: там для service-key проверяются **только**
|
|
25
|
+
* scope'ы (роль ADMIN ключа не учитывается) — здесь учитывается, чтобы
|
|
26
|
+
* зонтичный scope не отбирал права у ключей с ролью ADMIN.
|
|
27
|
+
*/
|
|
28
|
+
export declare function requireAdminRoleOrScope(...scopes: string[]): import("hono").MiddlewareHandler<any, string, {}, Response>;
|
|
14
29
|
/**
|
|
15
30
|
* Guard «service-key → scope»: для service-key требует хотя бы один из `scopes`;
|
|
16
31
|
* интерактивные креды пропускает без изменений (их гейтит `requireAuth`/логика
|
package/dist/auth/guards.js
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { createMiddleware } from 'hono/factory';
|
|
2
2
|
import { getServiceCredential } from '@itphx/synth-core';
|
|
3
|
-
import { hasServiceScope } from '@itphx/synth-shared';
|
|
3
|
+
import { hasAnyServiceScope, hasServiceScope } from '@itphx/synth-shared';
|
|
4
|
+
import { GlobalRole } from '@itphx/synth-shared/types';
|
|
4
5
|
import { t } from '../lib/i18n.js';
|
|
5
6
|
/**
|
|
6
7
|
* ADR-052/O1: комбинированные guard'ы «ADMIN **или** scope» для эндпоинтов,
|
|
@@ -55,6 +56,41 @@ export function requireAdminOrScope(...scopes) {
|
|
|
55
56
|
await next();
|
|
56
57
|
});
|
|
57
58
|
}
|
|
59
|
+
/**
|
|
60
|
+
* Guard «scope **или** роль ADMIN»:
|
|
61
|
+
* - service-key → проходит, если у него есть хотя бы один из `scopes`
|
|
62
|
+
* (`403 SCOPE_REQUIRED` иначе) **или** среди выданных ролей есть `ADMIN`
|
|
63
|
+
* (роль ключа — явное решение администратора, и до введения зонтичных
|
|
64
|
+
* scope'ов именно она давала доступ к таким операциям);
|
|
65
|
+
* - интерактивные креды (cookie/debug/OIDC/API-key/локальный ключ) → требуем
|
|
66
|
+
* роль ADMIN: нет аутентификации → `401 UNAUTHORIZED`, аутентифицирован без
|
|
67
|
+
* роли → `403 FORBIDDEN` (семантика HTTP; раньше оба случая склеивались в 403).
|
|
68
|
+
*
|
|
69
|
+
* Отличие от `requireAdminOrScope`: там для service-key проверяются **только**
|
|
70
|
+
* scope'ы (роль ADMIN ключа не учитывается) — здесь учитывается, чтобы
|
|
71
|
+
* зонтичный scope не отбирал права у ключей с ролью ADMIN.
|
|
72
|
+
*/
|
|
73
|
+
export function requireAdminRoleOrScope(...scopes) {
|
|
74
|
+
return createMiddleware(async (c, next) => {
|
|
75
|
+
const cred = getServiceCredential(c);
|
|
76
|
+
if (cred) {
|
|
77
|
+
const hasScope = hasAnyServiceScope(cred.scopes, scopes);
|
|
78
|
+
const adminKey = Array.isArray(cred.roles) && cred.roles.includes(GlobalRole.ADMIN);
|
|
79
|
+
if (!hasScope && !adminKey) {
|
|
80
|
+
return scopeDenied(c);
|
|
81
|
+
}
|
|
82
|
+
await next();
|
|
83
|
+
return;
|
|
84
|
+
}
|
|
85
|
+
if (!isAuthenticated(c)) {
|
|
86
|
+
return c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
|
|
87
|
+
}
|
|
88
|
+
if (!isAdmin(c)) {
|
|
89
|
+
return c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
90
|
+
}
|
|
91
|
+
await next();
|
|
92
|
+
});
|
|
93
|
+
}
|
|
58
94
|
/**
|
|
59
95
|
* Guard «service-key → scope»: для service-key требует хотя бы один из `scopes`;
|
|
60
96
|
* интерактивные креды пропускает без изменений (их гейтит `requireAuth`/логика
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { PluginServerPolicy } from '@itphx/synth-shared';
|
|
2
|
+
/**
|
|
3
|
+
* Guard plugin-bound токена (Ф7): монтируется **после** резолва
|
|
4
|
+
* service-кредентал и **до** роутов, поэтому правило действует на все
|
|
5
|
+
* серверные API, а не только на плагинные.
|
|
6
|
+
*
|
|
7
|
+
* `getPolicy` — живой серверный allow-list (`plugins.hybrid`); политика
|
|
8
|
+
* меняется рестартом (инвариант 24), поэтому берётся из работающего рантайма.
|
|
9
|
+
*/
|
|
10
|
+
export declare function requirePluginTokenBinding(getPolicy: () => PluginServerPolicy | undefined): import("hono").MiddlewareHandler<any, string, {}, Response>;
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { createMiddleware } from 'hono/factory';
|
|
2
|
+
import { checkPluginTokenBinding } from '@itphx/synth-core';
|
|
3
|
+
import { PLUGIN_TOKEN_ERROR_CODES } from '@itphx/synth-core';
|
|
4
|
+
import { t } from '../lib/i18n.js';
|
|
5
|
+
/**
|
|
6
|
+
* ADR-090 Ф7 (Уровень 2): guard server-scoped токена плагина — backend-обёртка
|
|
7
|
+
* над core-проверкой {@link checkPluginTokenBinding}.
|
|
8
|
+
*
|
|
9
|
+
* Enforcement (сверка заголовка `X-Synth-Plugin-Id`, scope `plugins:invoke` и
|
|
10
|
+
* серверного allow-list) остаётся в **core** — здесь только локализация
|
|
11
|
+
* отказов (как у `scopeGuard`/`serviceProjectProjection`). Для интерактивных
|
|
12
|
+
* кред (нет `serviceKey` в контексте) и для обычных service-key (без привязки
|
|
13
|
+
* к плагину) guard — no-op.
|
|
14
|
+
*
|
|
15
|
+
* Правило **fail-closed**: ключ с привязкой `plugin_id` без корректного
|
|
16
|
+
* заголовка отвергается всегда.
|
|
17
|
+
*/
|
|
18
|
+
/** Локализованный 403 по коду отказа core-проверки. */
|
|
19
|
+
function localizedDenial(c, code) {
|
|
20
|
+
if (code === PLUGIN_TOKEN_ERROR_CODES.scopeRequired) {
|
|
21
|
+
return c.json({
|
|
22
|
+
error: {
|
|
23
|
+
code: PLUGIN_TOKEN_ERROR_CODES.scopeRequired,
|
|
24
|
+
message: t('errors.forbidden.scopeRequired', undefined, c),
|
|
25
|
+
},
|
|
26
|
+
}, 403);
|
|
27
|
+
}
|
|
28
|
+
if (code === PLUGIN_TOKEN_ERROR_CODES.notAllowed) {
|
|
29
|
+
return c.json({
|
|
30
|
+
error: {
|
|
31
|
+
code: PLUGIN_TOKEN_ERROR_CODES.notAllowed,
|
|
32
|
+
message: t('errors.forbidden.pluginNotAllowed', undefined, c),
|
|
33
|
+
},
|
|
34
|
+
}, 403);
|
|
35
|
+
}
|
|
36
|
+
return c.json({
|
|
37
|
+
error: {
|
|
38
|
+
code: PLUGIN_TOKEN_ERROR_CODES.idMismatch,
|
|
39
|
+
message: t('errors.forbidden.pluginIdMismatch', undefined, c),
|
|
40
|
+
},
|
|
41
|
+
}, 403);
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Guard plugin-bound токена (Ф7): монтируется **после** резолва
|
|
45
|
+
* service-кредентал и **до** роутов, поэтому правило действует на все
|
|
46
|
+
* серверные API, а не только на плагинные.
|
|
47
|
+
*
|
|
48
|
+
* `getPolicy` — живой серверный allow-list (`plugins.hybrid`); политика
|
|
49
|
+
* меняется рестартом (инвариант 24), поэтому берётся из работающего рантайма.
|
|
50
|
+
*/
|
|
51
|
+
export function requirePluginTokenBinding(getPolicy) {
|
|
52
|
+
return createMiddleware(async (c, next) => {
|
|
53
|
+
const denied = checkPluginTokenBinding(c, getPolicy());
|
|
54
|
+
if (!denied) {
|
|
55
|
+
await next();
|
|
56
|
+
return;
|
|
57
|
+
}
|
|
58
|
+
let code = PLUGIN_TOKEN_ERROR_CODES.idMismatch;
|
|
59
|
+
try {
|
|
60
|
+
const body = (await denied.clone().json());
|
|
61
|
+
if (body?.error?.code)
|
|
62
|
+
code = body.error.code;
|
|
63
|
+
}
|
|
64
|
+
catch {
|
|
65
|
+
// Тело ответа нечитаемо — отказ по умолчанию (несовпадение plugin_id).
|
|
66
|
+
}
|
|
67
|
+
return localizedDenial(c, code);
|
|
68
|
+
});
|
|
69
|
+
}
|
package/dist/events/hub.d.ts
CHANGED
|
@@ -31,6 +31,23 @@ export declare class EventHub {
|
|
|
31
31
|
unsubscribeFromSession(userId: string, sessionId: string): void;
|
|
32
32
|
/** Глобальная подписка all-клиента: события всех сессий без привязки к владельцу. */
|
|
33
33
|
private _subscribeClientToAll;
|
|
34
|
+
/**
|
|
35
|
+
* ADR-118 §4: адресная доставка.
|
|
36
|
+
*
|
|
37
|
+
* Событие с `recipient` получает **только** клиент с совпадающим `userId`
|
|
38
|
+
* (broadcast — без `recipient` — получают все подписчики сессии).
|
|
39
|
+
*/
|
|
40
|
+
private _deliver;
|
|
41
|
+
/**
|
|
42
|
+
* ADR-118 §6: догон — события журнала строго после `afterSeq` для сессий,
|
|
43
|
+
* на которые подписан клиент (`Last-Event-ID` / `?since`).
|
|
44
|
+
*
|
|
45
|
+
* Watch-all клиент (service-key / сквозной обзор) получает журнал всех
|
|
46
|
+
* сессий; обычный клиент — только своих. Номер события глобальный и
|
|
47
|
+
* монотонный в пределах инстанса, поэтому порядок между сессиями — точный
|
|
48
|
+
* (по номеру).
|
|
49
|
+
*/
|
|
50
|
+
replayForClient(client: EventClient, afterSeq: number): BusEvent[];
|
|
34
51
|
private _subscribeClientToSession;
|
|
35
52
|
private _unsubscribeClientFromAll;
|
|
36
53
|
}
|
package/dist/events/hub.js
CHANGED
|
@@ -29,7 +29,7 @@ export class EventHub {
|
|
|
29
29
|
return;
|
|
30
30
|
}
|
|
31
31
|
// Нужны только id сессий владельца — лёгкая выборка (без истории сообщений).
|
|
32
|
-
const sessions = await this.sessionManager.listSessions({ userId: client.userId }
|
|
32
|
+
const sessions = await this.sessionManager.listSessions({ userId: client.userId });
|
|
33
33
|
console.log(`[EventHub] Register client: user=${client.username} clients=${arr.length} sessions=${sessions.length}`);
|
|
34
34
|
for (const s of sessions) {
|
|
35
35
|
this._subscribeClientToSession(client, s.id);
|
|
@@ -91,15 +91,50 @@ export class EventHub {
|
|
|
91
91
|
if (!subs || subs.has(ALL_SESSIONS_KEY))
|
|
92
92
|
return;
|
|
93
93
|
const unsub = this.eventBus.subscribeAll((event) => {
|
|
94
|
-
|
|
95
|
-
client.send(event);
|
|
96
|
-
}
|
|
97
|
-
catch {
|
|
98
|
-
// ignore send errors
|
|
99
|
-
}
|
|
94
|
+
this._deliver(client, event);
|
|
100
95
|
});
|
|
101
96
|
subs.set(ALL_SESSIONS_KEY, unsub);
|
|
102
97
|
}
|
|
98
|
+
/**
|
|
99
|
+
* ADR-118 §4: адресная доставка.
|
|
100
|
+
*
|
|
101
|
+
* Событие с `recipient` получает **только** клиент с совпадающим `userId`
|
|
102
|
+
* (broadcast — без `recipient` — получают все подписчики сессии).
|
|
103
|
+
*/
|
|
104
|
+
_deliver(client, event) {
|
|
105
|
+
if (event.recipient && event.recipient !== client.userId)
|
|
106
|
+
return;
|
|
107
|
+
try {
|
|
108
|
+
client.send(event);
|
|
109
|
+
}
|
|
110
|
+
catch {
|
|
111
|
+
// ignore send errors
|
|
112
|
+
}
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* ADR-118 §6: догон — события журнала строго после `afterSeq` для сессий,
|
|
116
|
+
* на которые подписан клиент (`Last-Event-ID` / `?since`).
|
|
117
|
+
*
|
|
118
|
+
* Watch-all клиент (service-key / сквозной обзор) получает журнал всех
|
|
119
|
+
* сессий; обычный клиент — только своих. Номер события глобальный и
|
|
120
|
+
* монотонный в пределах инстанса, поэтому порядок между сессиями — точный
|
|
121
|
+
* (по номеру).
|
|
122
|
+
*/
|
|
123
|
+
replayForClient(client, afterSeq) {
|
|
124
|
+
const subs = this.clientSubs.get(client);
|
|
125
|
+
if (!subs)
|
|
126
|
+
return [];
|
|
127
|
+
const sessionIds = [...subs.keys()].filter((id) => id !== ALL_SESSIONS_KEY);
|
|
128
|
+
if (sessionIds.length === 0) {
|
|
129
|
+
return this.eventBus.journalSince(afterSeq);
|
|
130
|
+
}
|
|
131
|
+
const out = [];
|
|
132
|
+
for (const sessionId of sessionIds) {
|
|
133
|
+
out.push(...this.eventBus.since(sessionId, afterSeq));
|
|
134
|
+
}
|
|
135
|
+
out.sort((a, b) => (a.eventSeq ?? 0) - (b.eventSeq ?? 0));
|
|
136
|
+
return out;
|
|
137
|
+
}
|
|
103
138
|
_subscribeClientToSession(client, sessionId) {
|
|
104
139
|
// all-клиент покрыт глобальной подпиской — per-session подписки не нужны
|
|
105
140
|
// (иначе дубли доставки).
|
|
@@ -111,12 +146,7 @@ export class EventHub {
|
|
|
111
146
|
if (subs.has(sessionId))
|
|
112
147
|
return;
|
|
113
148
|
const unsub = this.eventBus.subscribe(sessionId, (event) => {
|
|
114
|
-
|
|
115
|
-
client.send(event);
|
|
116
|
-
}
|
|
117
|
-
catch {
|
|
118
|
-
// ignore send errors
|
|
119
|
-
}
|
|
149
|
+
this._deliver(client, event);
|
|
120
150
|
// Автоподписка на дочернюю сессию саб-агента. Раньше клиент получал
|
|
121
151
|
// live-события (`stream.usage`/`stream.chunk`) только по сессиям из
|
|
122
152
|
// `listSessions` и созданным/форкнутым через роуты; child-сессию тул
|
|
@@ -128,7 +158,9 @@ export class EventHub {
|
|
|
128
158
|
if (childId && childId !== sessionId) {
|
|
129
159
|
this._subscribeClientToSession(client, childId);
|
|
130
160
|
}
|
|
131
|
-
|
|
161
|
+
// ADR-118 §4: адресная доставка на уровне шины — подписчик сессии
|
|
162
|
+
// получает событие с `recipient` только при совпадении `userId`.
|
|
163
|
+
}, { userId: client.userId });
|
|
132
164
|
subs.set(sessionId, unsub);
|
|
133
165
|
}
|
|
134
166
|
_unsubscribeClientFromAll(client) {
|
package/dist/lib/app-config.d.ts
CHANGED
|
@@ -6,6 +6,10 @@ export interface BackendConfig {
|
|
|
6
6
|
workspacesRoot: string;
|
|
7
7
|
/** Максимальный размер загрузки файла (`POST /api/v2/fs/upload`), байт (config/env). */
|
|
8
8
|
maxUploadBytes: number;
|
|
9
|
+
/** Максимальный размер файла, отдаваемого `GET /api/v2/fs/read`, байт (config/env). */
|
|
10
|
+
maxReadBytes: number;
|
|
11
|
+
/** Максимальный размер файла, отдаваемого `GET /api/v2/fs/raw` (предпросмотр), байт (config/env). */
|
|
12
|
+
maxPreviewBytes: number;
|
|
9
13
|
port: number;
|
|
10
14
|
auth: AuthConfig;
|
|
11
15
|
}
|
package/dist/lib/app-config.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot, resolveMaxUploadBytes } from '@itphx/synth-shared';
|
|
1
|
+
import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot, resolveMaxUploadBytes, resolveMaxReadBytes, resolveMaxPreviewBytes } 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) => {
|
|
@@ -60,6 +60,8 @@ export async function loadBackendConfig(options) {
|
|
|
60
60
|
const dataDir = resolveDataDir(synth);
|
|
61
61
|
const workspacesRoot = resolveWorkspacesRoot(synth);
|
|
62
62
|
const maxUploadBytes = resolveMaxUploadBytes(synth);
|
|
63
|
+
const maxReadBytes = resolveMaxReadBytes(synth);
|
|
64
|
+
const maxPreviewBytes = resolveMaxPreviewBytes(synth);
|
|
63
65
|
const port = resolvePort(synth, 'SYNTH_PORT', synth.server.port);
|
|
64
|
-
return { synth, dataDir, workspacesRoot, maxUploadBytes, port, auth };
|
|
66
|
+
return { synth, dataDir, workspacesRoot, maxUploadBytes, maxReadBytes, maxPreviewBytes, port, auth };
|
|
65
67
|
}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';
|
|
1
|
+
export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX, CHAT_SCALE_MIN, CHAT_SCALE_MAX } from '@itphx/synth-core';
|
|
2
2
|
export type { AppearanceDefaults } from '@itphx/synth-core';
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
//
|
|
1
|
+
// ADR-096 (W2.3): реализация перенесена в core (`storage/defaults-store.ts`) —
|
|
2
2
|
// это просто `{dataDir}/defaults.json` + атомарная запись, без backend-специфики.
|
|
3
3
|
// Здесь оставлен реэкспорт, чтобы существующие импорты (`../lib/defaults-store.js`)
|
|
4
4
|
// не менялись. См. `@itphx/synth-core`.
|
|
5
|
-
export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX } from '@itphx/synth-core';
|
|
5
|
+
export { DefaultsStore, UI_SCALE_MIN, UI_SCALE_MAX, CHAT_SCALE_MIN, CHAT_SCALE_MAX } from '@itphx/synth-core';
|