@itphx/synth-backend 0.11.3 → 0.12.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 +31 -5
- package/dist/app/deps.js +769 -36
- package/dist/app/listen.d.ts +7 -1
- package/dist/app/listen.js +126 -9
- package/dist/app/mount-routes.js +374 -11
- package/dist/app.d.ts +28 -2
- package/dist/app.js +52 -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/lib/defaults-store.js +1 -1
- package/dist/lib/i18n.js +107 -2
- package/dist/main.js +50 -3
- package/dist/routes/agents.d.ts +11 -2
- package/dist/routes/agents.js +14 -2
- package/dist/routes/auth.d.ts +11 -1
- package/dist/routes/auth.js +16 -2
- package/dist/routes/llm.js +2 -2
- 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 +5 -1
- package/dist/routes/processes.d.ts +34 -0
- package/dist/routes/processes.js +26 -0
- package/dist/routes/projects.d.ts +7 -1
- package/dist/routes/projects.js +8 -1
- package/dist/routes/sessions.d.ts +39 -2
- package/dist/routes/sessions.js +28 -5
- package/package.json +4 -4
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,17 @@ 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(),
|
|
267
311
|
// ADR-052 (этап II): реестр подписок и движок webhooks + остановка на shutdown.
|
|
268
312
|
webhookStore: deps.webhookStore,
|
|
269
313
|
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
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
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`.
|
package/dist/lib/i18n.js
CHANGED
|
@@ -19,6 +19,7 @@ const en = {
|
|
|
19
19
|
'errors.validation.nameRequired': 'name is required',
|
|
20
20
|
'errors.validation.idRequired': 'id is required',
|
|
21
21
|
'errors.validation.invalidAgentId': 'Agent ID may contain only Latin letters, digits, hyphen and underscore',
|
|
22
|
+
'errors.validation.invalidRoleFile': 'Role file name must be a plain file name without paths and ".."',
|
|
22
23
|
'errors.validation.urlRequired': 'url is required',
|
|
23
24
|
'errors.validation.invalidUrl': 'Invalid URL',
|
|
24
25
|
'errors.validation.apiKeyRequired': 'api_key is required',
|
|
@@ -40,16 +41,64 @@ const en = {
|
|
|
40
41
|
// ADR-052 (этап I): service-key
|
|
41
42
|
'errors.validation.invalidServiceKey': 'Invalid service key payload',
|
|
42
43
|
'errors.notFound.serviceKey': 'Service key not found',
|
|
44
|
+
'errors.notFound.credential': 'External access not found',
|
|
43
45
|
'errors.conflict.serviceKeyLabel': 'Service key label is already used',
|
|
44
46
|
'errors.forbidden.scopeRequired': 'Insufficient permissions: required scope is missing',
|
|
45
47
|
'errors.forbidden.projectForbidden': 'Project is not available for this service key',
|
|
46
48
|
'errors.rateLimited.serviceKey': 'Service key rate limit exceeded',
|
|
47
|
-
//
|
|
49
|
+
// ADR-090 Ф7 (Уровень 2): server-scoped токен плагина
|
|
50
|
+
'errors.forbidden.pluginIdMismatch': 'Plugin token: the X-Synth-Plugin-Id header does not match the key plugin_id',
|
|
51
|
+
'errors.forbidden.pluginNotAllowed': 'Plugin token: the plugin is not in the server allow-list',
|
|
52
|
+
// ADR-101 (Э6): пайплайны проекта, прогоны, шаблоны инстанса
|
|
53
|
+
'errors.notFound.pipeline': 'Pipeline not found',
|
|
54
|
+
'errors.notFound.pipelineRun': 'Pipeline run not found',
|
|
55
|
+
'errors.notFound.pipelineTemplate': 'Pipeline template not found',
|
|
56
|
+
'errors.validation.invalidPipelineBody': 'Invalid pipeline request payload',
|
|
57
|
+
'errors.validation.invalidPipelineSpec': 'Invalid pipeline specification',
|
|
58
|
+
'errors.validation.projectIdRequired': 'projectId is required',
|
|
59
|
+
'errors.conflict.pipelineNotPublished': 'The pipeline has no published version',
|
|
60
|
+
'errors.conflict.pipelineInvalidState': 'The run is not waiting for a human decision',
|
|
61
|
+
'errors.conflict.pipelineNothingToPublish': 'There is no draft to publish',
|
|
62
|
+
'errors.conflict.pipelineRunFinished': 'The run is already finished',
|
|
63
|
+
'errors.conflict.pipelineTemplateUnsupported': 'The template cannot be instantiated as a pipeline',
|
|
64
|
+
// PROP-096/097: единый реестр фоновых прогонов
|
|
65
|
+
'errors.notFound.backgroundRun': 'Background run not found',
|
|
66
|
+
'errors.notFound.backgroundRunSession': 'Session of the background run not found',
|
|
67
|
+
'errors.validation.invalidBackgroundRunQuery': 'Invalid background run filter',
|
|
68
|
+
'errors.validation.backgroundRunLogKind': 'Logs are available for background processes only',
|
|
69
|
+
'errors.notFound.processLog': 'Background process log not found',
|
|
70
|
+
'errors.conflict.backgroundRunFinished': 'The background run is already finished',
|
|
71
|
+
'errors.conflict.backgroundRunNotStoppable': 'The background run is not controlled by this instance',
|
|
72
|
+
'errors.conflict.backgroundRunActive': 'The background run is still running',
|
|
73
|
+
// ADR-102: отчёты аналитики (только чтение)
|
|
48
74
|
'errors.validation.invalidAnalyticsPeriod': 'Invalid period: expected a date in YYYY-MM-DD (UTC)',
|
|
49
75
|
'errors.validation.invalidAnalyticsRange': 'Period start is later than period end',
|
|
50
76
|
'errors.validation.invalidAnalyticsGroupBy': 'Invalid grouping axis (groupBy)',
|
|
51
77
|
'errors.validation.invalidAnalyticsOption': 'Invalid report parameter (report/format)',
|
|
52
78
|
'errors.forbidden.analytics': 'Insufficient permissions for this report',
|
|
79
|
+
// ADR-107 / PROP-047: портал памяти (чтение + мутации индексов, М2)
|
|
80
|
+
'errors.validation.invalidMemoryStatus': 'Invalid memory fact status filter',
|
|
81
|
+
'errors.validation.invalidMemoryState': 'Invalid memory index state filter',
|
|
82
|
+
'errors.validation.invalidMemoryLimit': 'Invalid limit value (an integer 1..200)',
|
|
83
|
+
'errors.validation.invalidMemoryOffset': 'Invalid offset value (an integer >= 0)',
|
|
84
|
+
'errors.notFound.memoryFact': 'Memory fact not found',
|
|
85
|
+
'errors.unavailable.memory': 'Memory storage is unavailable',
|
|
86
|
+
'errors.validation.invalidMemoryBody': 'Invalid memory request payload',
|
|
87
|
+
'errors.validation.invalidMemorySource': 'Invalid memory index source (expected files or facts)',
|
|
88
|
+
'errors.validation.memoryProjectRequired': 'A memory index is built in a project: projectId is required',
|
|
89
|
+
'errors.notFound.memoryProject': 'Project not found',
|
|
90
|
+
'errors.validation.memoryWorkspaceRequired': 'The project has no workspace: a file index cannot be built',
|
|
91
|
+
'errors.unavailable.memoryProvider': 'The memory provider is unavailable: the memory plugin is not active',
|
|
92
|
+
'errors.notFound.memoryIndex': 'Memory index not found',
|
|
93
|
+
'errors.failed.memoryIndex': 'Failed to perform the memory index operation',
|
|
94
|
+
'memory.indexCreated': 'Memory index created',
|
|
95
|
+
'errors.validation.invalidMemoryThreshold': 'Invalid memory consolidation threshold (expected a number 0.5..0.99)',
|
|
96
|
+
'errors.failed.memoryConsolidation': 'Failed to consolidate memory',
|
|
97
|
+
'memory.consolidated': 'Memory consolidation completed',
|
|
98
|
+
'errors.validation.invalidMemoryGraphDepth': 'Invalid memory graph depth (an integer 1..3)',
|
|
99
|
+
'errors.validation.invalidMemoryGraphLimit': 'Invalid memory graph limit (an integer 1..200)',
|
|
100
|
+
'errors.validation.invalidMemoryGraphEntity': 'Invalid memory graph entity (a non-empty string of at most 200 characters)',
|
|
101
|
+
'errors.failed.memoryGraph': 'Failed to read the memory graph',
|
|
53
102
|
// ADR-052 (этап II): исходящие webhooks
|
|
54
103
|
'errors.validation.invalidWebhook': 'Invalid webhook subscription payload',
|
|
55
104
|
'errors.notFound.webhook': 'Webhook subscription not found',
|
|
@@ -103,6 +152,9 @@ const en = {
|
|
|
103
152
|
'locales.ru.nativeName': 'Russian',
|
|
104
153
|
// Chat
|
|
105
154
|
'errors.chat.queueFull': 'Queue is full (max {max} messages)',
|
|
155
|
+
'errors.chat.steerLimitExceeded': 'Steering limit reached (max {max} injected messages per turn)',
|
|
156
|
+
// ADR-106 Ф3: подтверждение не принято (нет гранта / повторный ответ / чужой ход).
|
|
157
|
+
'errors.chat.approvalDenied': 'Approval was not accepted: {reason}',
|
|
106
158
|
// Stub
|
|
107
159
|
'stub.llmNotConnected': '[Stub] You said: "{content}". LLM engine is not connected yet.',
|
|
108
160
|
};
|
|
@@ -127,6 +179,7 @@ const ru = {
|
|
|
127
179
|
'errors.validation.nameRequired': 'name обязателен',
|
|
128
180
|
'errors.validation.idRequired': 'id обязателен',
|
|
129
181
|
'errors.validation.invalidAgentId': 'ID агента может содержать только латиницу, цифры, дефис и подчёркивание',
|
|
182
|
+
'errors.validation.invalidRoleFile': 'Имя файла роли должно быть именем файла без путей и «..»',
|
|
130
183
|
'errors.validation.urlRequired': 'URL не указан',
|
|
131
184
|
'errors.validation.invalidUrl': 'Некорректный URL',
|
|
132
185
|
'errors.validation.apiKeyRequired': 'api_key обязателен',
|
|
@@ -148,16 +201,65 @@ const ru = {
|
|
|
148
201
|
// ADR-052 (этап I): service-key
|
|
149
202
|
'errors.validation.invalidServiceKey': 'Некорректное тело service-key',
|
|
150
203
|
'errors.notFound.serviceKey': 'Service-key не найден',
|
|
204
|
+
// ADR-105 (Ф3): внешний доступ (OAuth-кред) не найден.
|
|
205
|
+
'errors.notFound.credential': 'Внешний доступ не найден',
|
|
151
206
|
'errors.conflict.serviceKeyLabel': 'Метка service-key уже используется',
|
|
152
207
|
'errors.forbidden.scopeRequired': 'Недостаточно прав: отсутствует требуемый scope',
|
|
153
208
|
'errors.forbidden.projectForbidden': 'Проект недоступен для этого service-key',
|
|
154
209
|
'errors.rateLimited.serviceKey': 'Превышен лимит запросов по service-key',
|
|
155
|
-
//
|
|
210
|
+
// ADR-090 Ф7 (Уровень 2): server-scoped токен плагина
|
|
211
|
+
'errors.forbidden.pluginIdMismatch': 'Токен плагина: заголовок X-Synth-Plugin-Id не совпадает с plugin_id ключа',
|
|
212
|
+
'errors.forbidden.pluginNotAllowed': 'Токен плагина: плагина нет в серверном allow-list',
|
|
213
|
+
// ADR-101 (Э6): пайплайны проекта, прогоны, шаблоны инстанса
|
|
214
|
+
'errors.notFound.pipeline': 'Пайплайн не найден',
|
|
215
|
+
'errors.notFound.pipelineRun': 'Прогон пайплайна не найден',
|
|
216
|
+
'errors.notFound.pipelineTemplate': 'Шаблон пайплайна не найден',
|
|
217
|
+
'errors.validation.invalidPipelineBody': 'Некорректное тело запроса пайплайна',
|
|
218
|
+
'errors.validation.invalidPipelineSpec': 'Некорректная спецификация пайплайна',
|
|
219
|
+
'errors.validation.projectIdRequired': 'Не указан projectId',
|
|
220
|
+
'errors.conflict.pipelineNotPublished': 'У пайплайна нет опубликованной версии',
|
|
221
|
+
'errors.conflict.pipelineInvalidState': 'Прогон не ожидает решения человека',
|
|
222
|
+
'errors.conflict.pipelineNothingToPublish': 'Нет черновика для публикации',
|
|
223
|
+
'errors.conflict.pipelineRunFinished': 'Прогон уже завершён',
|
|
224
|
+
'errors.conflict.pipelineTemplateUnsupported': 'Шаблон нельзя инстанцировать в пайплайн',
|
|
225
|
+
// PROP-096/097: единый реестр фоновых прогонов
|
|
226
|
+
'errors.notFound.backgroundRun': 'Фоновый прогон не найден',
|
|
227
|
+
'errors.notFound.backgroundRunSession': 'Сессия фонового прогона не найдена',
|
|
228
|
+
'errors.validation.invalidBackgroundRunQuery': 'Некорректный фильтр фоновых прогонов',
|
|
229
|
+
'errors.validation.backgroundRunLogKind': 'Логи доступны только для фоновых процессов',
|
|
230
|
+
'errors.notFound.processLog': 'Лог фонового процесса не найден',
|
|
231
|
+
'errors.conflict.backgroundRunFinished': 'Фоновый прогон уже завершён',
|
|
232
|
+
'errors.conflict.backgroundRunNotStoppable': 'Фоновый прогон не контролируется этим инстансом',
|
|
233
|
+
'errors.conflict.backgroundRunActive': 'Фоновый прогон ещё выполняется',
|
|
234
|
+
// ADR-102: отчёты аналитики (только чтение)
|
|
156
235
|
'errors.validation.invalidAnalyticsPeriod': 'Некорректный период: ожидается дата YYYY-MM-DD (UTC)',
|
|
157
236
|
'errors.validation.invalidAnalyticsRange': 'Начало периода позже конца периода',
|
|
158
237
|
'errors.validation.invalidAnalyticsGroupBy': 'Некорректная ось группировки (groupBy)',
|
|
159
238
|
'errors.validation.invalidAnalyticsOption': 'Некорректный параметр отчёта (report/format)',
|
|
160
239
|
'errors.forbidden.analytics': 'Недостаточно прав для отчёта',
|
|
240
|
+
// ADR-107 / PROP-047: портал памяти (чтение + мутации индексов, М2)
|
|
241
|
+
'errors.validation.invalidMemoryStatus': 'Некорректный фильтр статуса факта памяти',
|
|
242
|
+
'errors.validation.invalidMemoryState': 'Некорректный фильтр состояния индекса памяти',
|
|
243
|
+
'errors.validation.invalidMemoryLimit': 'Некорректное значение limit (целое 1..200)',
|
|
244
|
+
'errors.validation.invalidMemoryOffset': 'Некорректное значение offset (целое ≥ 0)',
|
|
245
|
+
'errors.notFound.memoryFact': 'Факт памяти не найден',
|
|
246
|
+
'errors.unavailable.memory': 'Хранилище памяти недоступно',
|
|
247
|
+
'errors.validation.invalidMemoryBody': 'Некорректное тело запроса памяти',
|
|
248
|
+
'errors.validation.invalidMemorySource': 'Некорректный источник индекса памяти (ожидается files или facts)',
|
|
249
|
+
'errors.validation.memoryProjectRequired': 'Индекс памяти строится в проекте: укажите projectId',
|
|
250
|
+
'errors.notFound.memoryProject': 'Проект не найден',
|
|
251
|
+
'errors.validation.memoryWorkspaceRequired': 'У проекта нет рабочего каталога: индекс файлов строить негде',
|
|
252
|
+
'errors.unavailable.memoryProvider': 'Провайдер памяти недоступен: плагин памяти не активен',
|
|
253
|
+
'errors.notFound.memoryIndex': 'Индекс памяти не найден',
|
|
254
|
+
'errors.failed.memoryIndex': 'Не удалось выполнить операцию с индексом памяти',
|
|
255
|
+
'memory.indexCreated': 'Индекс памяти создан',
|
|
256
|
+
'errors.validation.invalidMemoryThreshold': 'Некорректный порог консолидации памяти (ожидается число 0.5..0.99)',
|
|
257
|
+
'errors.failed.memoryConsolidation': 'Не удалось выполнить консолидацию памяти',
|
|
258
|
+
'memory.consolidated': 'Консолидация памяти выполнена',
|
|
259
|
+
'errors.validation.invalidMemoryGraphDepth': 'Некорректная глубина графа памяти (целое 1..3)',
|
|
260
|
+
'errors.validation.invalidMemoryGraphLimit': 'Некорректное значение limit графа памяти (целое 1..200)',
|
|
261
|
+
'errors.validation.invalidMemoryGraphEntity': 'Некорректная сущность графа памяти (непустая строка длиной до 200 символов)',
|
|
262
|
+
'errors.failed.memoryGraph': 'Не удалось прочитать граф памяти',
|
|
161
263
|
// ADR-052 (этап II): исходящие webhooks
|
|
162
264
|
'errors.validation.invalidWebhook': 'Некорректное тело webhook-подписки',
|
|
163
265
|
'errors.notFound.webhook': 'Webhook-подписка не найдена',
|
|
@@ -211,6 +313,9 @@ const ru = {
|
|
|
211
313
|
'locales.ru.nativeName': 'Русский',
|
|
212
314
|
// Chat
|
|
213
315
|
'errors.chat.queueFull': 'Очередь переполнена (максимум {max} сообщений)',
|
|
316
|
+
'errors.chat.steerLimitExceeded': 'Достигнут лимит вмешательств в ход (максимум {max} сообщений на ход)',
|
|
317
|
+
// ADR-106 Ф3: подтверждение не принято (нет гранта / повторный ответ / чужой ход).
|
|
318
|
+
'errors.chat.approvalDenied': 'Подтверждение не принято: {reason}',
|
|
214
319
|
// Stub
|
|
215
320
|
'stub.llmNotConnected': '[Заглушка] Вы сказали: "{content}". LLM-движок ещё не подключён.',
|
|
216
321
|
};
|
package/dist/main.js
CHANGED
|
@@ -6,8 +6,45 @@
|
|
|
6
6
|
import { createBackendApp } from './app.js';
|
|
7
7
|
import { configureRestart, resolveRestartMode, RESTART_EXIT_CODE, setSynthReady, } from '@itphx/synth-core';
|
|
8
8
|
const host = process.env.SYNTH_HOST || '0.0.0.0';
|
|
9
|
-
|
|
10
|
-
|
|
9
|
+
// ADR-077: fail-closed на старте (неверный `execution.mode` или `remote` —
|
|
10
|
+
// удалённый исполнитель ещё не реализован, шаг 7 плана) — с понятным текстом.
|
|
11
|
+
let handle;
|
|
12
|
+
try {
|
|
13
|
+
handle = await createBackendApp();
|
|
14
|
+
}
|
|
15
|
+
catch (err) {
|
|
16
|
+
console.error(err instanceof Error ? err.message : String(err));
|
|
17
|
+
process.exit(1);
|
|
18
|
+
}
|
|
19
|
+
const { app, dataDir, port, config, auth, eventHub, queueManager, sessionManager, stopEphemeralSweeper, stopEventJournalPruner, stopAnalyticsRollupPruner, stopScheduler, stopWebhookService, stopWebhookDeliveryPruner, stopMetrics, stopQuestionPruner, stopBackgroundRunPruner, stopProcessLogPruner, stopAttachmentPruner } = handle;
|
|
20
|
+
// ADR-090 (Ф5б-1): старт-активация установленных плагинов.
|
|
21
|
+
// `plugins.lock.json` — источник истины; `plugins.executionEnabled=false`
|
|
22
|
+
// (дефолт) → no-op. Ошибка плагина/рантайма **не роняет старт** (только
|
|
23
|
+
// предупреждение); тексты плагинов в лог не попадают (инвариант 13).
|
|
24
|
+
//
|
|
25
|
+
// Ф5в: **сначала** установка deploy-плагинов (образ/PVC, `plugins.deployDir`),
|
|
26
|
+
// затем активация — иначе поставленный образом плагин не попал бы в
|
|
27
|
+
// `plugins.lock.json` и не активировался при первом старте.
|
|
28
|
+
try {
|
|
29
|
+
const deploy = await handle.pluginRuntime.installDeployPlugins({ actor: 'startup' });
|
|
30
|
+
if (deploy.installed.length > 0 || deploy.failed.length > 0) {
|
|
31
|
+
console.log(`[plugins] deploy: установлено ${deploy.installed.length}, ` +
|
|
32
|
+
`пропущено ${deploy.skipped.length}, ошибок ${deploy.failed.length}`);
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
catch (err) {
|
|
36
|
+
console.warn(`[plugins] установка deploy-плагинов не выполнена: ${err instanceof Error ? err.message : String(err)}`);
|
|
37
|
+
}
|
|
38
|
+
try {
|
|
39
|
+
const results = await handle.pluginRuntime.activateInstalled({ actor: 'startup' });
|
|
40
|
+
if (results.length > 0) {
|
|
41
|
+
const activated = results.filter((item) => item.outcome === 'activated').length;
|
|
42
|
+
console.log(`[plugins] активировано: ${activated}, отклонено: ${results.length - activated}`);
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
catch (err) {
|
|
46
|
+
console.warn(`[plugins] старт-активация не выполнена: ${err instanceof Error ? err.message : String(err)}`);
|
|
47
|
+
}
|
|
11
48
|
let shuttingDown = false;
|
|
12
49
|
async function gracefulShutdown(signal, exitCode = 0) {
|
|
13
50
|
if (shuttingDown)
|
|
@@ -34,8 +71,18 @@ async function gracefulShutdown(signal, exitCode = 0) {
|
|
|
34
71
|
stopEphemeralSweeper();
|
|
35
72
|
// ADR-089: остановить retention-очистку журнала событий.
|
|
36
73
|
stopEventJournalPruner();
|
|
37
|
-
//
|
|
74
|
+
// ADR-102: остановить retention-очистку роллапов аналитики.
|
|
38
75
|
stopAnalyticsRollupPruner();
|
|
76
|
+
// Этап 1 roadmap 0.13 (блок 3): остановить retention-очистку вопросов и
|
|
77
|
+
// освободить ожидания ответа.
|
|
78
|
+
stopQuestionPruner();
|
|
79
|
+
// Этап 1 roadmap 0.13 (блок 4): остановить retention-очистку реестра
|
|
80
|
+
// фоновых прогонов.
|
|
81
|
+
stopBackgroundRunPruner();
|
|
82
|
+
// PROP-097 (блок 5b): остановить retention-очистку логов фоновых процессов.
|
|
83
|
+
stopProcessLogPruner();
|
|
84
|
+
// ADR-115: остановить GC осиротевших вложений сообщений.
|
|
85
|
+
stopAttachmentPruner();
|
|
39
86
|
// ADR-094: остановить процессные метрики и фоновые доменные коллекторы
|
|
40
87
|
// (таймеры сессий/хранилища, подписка шины, decision/journal).
|
|
41
88
|
stopMetrics();
|
package/dist/routes/agents.d.ts
CHANGED
|
@@ -2,10 +2,19 @@ import { Hono } from 'hono';
|
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
3
|
import type { JsonStoreLike } from '@itphx/synth-core';
|
|
4
4
|
import type { AgentDefinition } from '@itphx/synth-shared';
|
|
5
|
-
import type { AgentRegistry } from '@itphx/synth-core';
|
|
5
|
+
import type { AgentRegistry, ContextFileRepository } from '@itphx/synth-core';
|
|
6
6
|
/**
|
|
7
7
|
* Backend-обёртка над core-фабрикой агентов: добавляет только RBAC
|
|
8
8
|
* (админ-эндпоинты — ADMIN) и i18n-сообщения. Логика роутов
|
|
9
9
|
* (GET /, GET /all, POST /, GET /:id, DELETE /:id, PATCH /:id/enabled) — в core.
|
|
10
|
+
*
|
|
11
|
+
* `contextFiles` — порт файлов контекста: запись ролевого промпта агента
|
|
12
|
+
* вместе с агентом (ADR-046/ADR-089, поле `role_prompt` в теле POST).
|
|
13
|
+
* Роль пишется тем же guard'ом, что и создание агента (ADMIN).
|
|
14
|
+
*
|
|
15
|
+
* ADR-052: запись агентов (создание + ролевой промпт) — «роль ADMIN **или**
|
|
16
|
+
* scope `automation:install`» (зонтичный скоуп установщика пакетов
|
|
17
|
+
* расширений). Guard `requireAdminRoleOrScope` учитывает и роль ADMIN в
|
|
18
|
+
* service-key, и scope — прежние права не отбираются, новые добавляются.
|
|
10
19
|
*/
|
|
11
|
-
export declare function createAgentRoutes(kit: AuthKit, agentStore: JsonStoreLike<AgentDefinition>, agentRegistry?: AgentRegistry, getDefaultAgentId?: () => string | Promise<string
|
|
20
|
+
export declare function createAgentRoutes(kit: AuthKit, agentStore: JsonStoreLike<AgentDefinition>, agentRegistry?: AgentRegistry, getDefaultAgentId?: () => string | Promise<string>, contextFiles?: ContextFileRepository): Hono;
|
package/dist/routes/agents.js
CHANGED
|
@@ -1,20 +1,32 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import { createAgentRoutes as createCoreAgentRoutes } from '@itphx/synth-core';
|
|
3
|
+
import { requireAdminRoleOrScope } from '../auth/guards.js';
|
|
3
4
|
import { t } from '../lib/i18n.js';
|
|
4
5
|
/**
|
|
5
6
|
* Backend-обёртка над core-фабрикой агентов: добавляет только RBAC
|
|
6
7
|
* (админ-эндпоинты — ADMIN) и i18n-сообщения. Логика роутов
|
|
7
8
|
* (GET /, GET /all, POST /, GET /:id, DELETE /:id, PATCH /:id/enabled) — в core.
|
|
9
|
+
*
|
|
10
|
+
* `contextFiles` — порт файлов контекста: запись ролевого промпта агента
|
|
11
|
+
* вместе с агентом (ADR-046/ADR-089, поле `role_prompt` в теле POST).
|
|
12
|
+
* Роль пишется тем же guard'ом, что и создание агента (ADMIN).
|
|
13
|
+
*
|
|
14
|
+
* ADR-052: запись агентов (создание + ролевой промпт) — «роль ADMIN **или**
|
|
15
|
+
* scope `automation:install`» (зонтичный скоуп установщика пакетов
|
|
16
|
+
* расширений). Guard `requireAdminRoleOrScope` учитывает и роль ADMIN в
|
|
17
|
+
* service-key, и scope — прежние права не отбираются, новые добавляются.
|
|
8
18
|
*/
|
|
9
|
-
export function createAgentRoutes(kit, agentStore, agentRegistry, getDefaultAgentId) {
|
|
19
|
+
export function createAgentRoutes(kit, agentStore, agentRegistry, getDefaultAgentId, contextFiles) {
|
|
10
20
|
const app = new Hono();
|
|
11
21
|
app.route('/', createCoreAgentRoutes({ requireAuth: kit.requireAuth }, agentStore, agentRegistry, getDefaultAgentId, {
|
|
12
|
-
writeGuard:
|
|
22
|
+
writeGuard: requireAdminRoleOrScope('automation:install'),
|
|
13
23
|
allGuard: kit.requireAdmin,
|
|
14
24
|
detailGuard: kit.requireAdmin,
|
|
25
|
+
roleFiles: contextFiles,
|
|
15
26
|
messages: {
|
|
16
27
|
idRequired: (c) => t('errors.validation.idRequired', undefined, c),
|
|
17
28
|
invalidAgentId: (c) => t('errors.validation.invalidAgentId', undefined, c),
|
|
29
|
+
invalidRoleFile: (c) => t('errors.validation.invalidRoleFile', undefined, c),
|
|
18
30
|
agentNotFound: (c) => t('errors.notFound.agent', undefined, c),
|
|
19
31
|
agentOverrideNotFound: (c) => t('errors.notFound.agentOverride', undefined, c),
|
|
20
32
|
},
|
package/dist/routes/auth.d.ts
CHANGED
|
@@ -1,6 +1,16 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
3
|
import type { AuthConfig } from '@itphx/synth-shared';
|
|
4
|
+
import type { PluginPolicySignal } from '@itphx/synth-shared';
|
|
4
5
|
import type { ProfileStore } from '@itphx/synth-shared';
|
|
5
6
|
import type { DefaultsRepository } from '@itphx/synth-core';
|
|
6
|
-
export declare function createAuthRoutes(kit: AuthKit, config: AuthConfig, profiles?: ProfileStore, dataDir?: string, defaultsStore?: DefaultsRepository | null
|
|
7
|
+
export declare function createAuthRoutes(kit: AuthKit, config: AuthConfig, profiles?: ProfileStore, dataDir?: string, defaultsStore?: DefaultsRepository | null,
|
|
8
|
+
/**
|
|
9
|
+
* ADR-090 Ф7: сигнал о серверной политике плагинов для публичного
|
|
10
|
+
* дискавери (`GET /auth/oidc-meta`).
|
|
11
|
+
*
|
|
12
|
+
* Только `{ enabled, mode }` — **без списка имён**: allow-list не публичен,
|
|
13
|
+
* полный список отдаёт аутентифицированный роут `GET /api/v2/settings/plugins`.
|
|
14
|
+
* Не задан — сигнала нет (старый клиент трактует это как «неизвестно»).
|
|
15
|
+
*/
|
|
16
|
+
pluginPolicySignal?: PluginPolicySignal | null): Hono;
|