@itphx/synth-backend 0.13.4 → 0.13.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/dist/app/deps.d.ts +22 -1
  2. package/dist/app/deps.js +743 -63
  3. package/dist/app/listen.js +30 -35
  4. package/dist/app/mount-routes.js +405 -46
  5. package/dist/app/public-routes.d.ts +2 -0
  6. package/dist/app/public-routes.js +11 -0
  7. package/dist/app/sse-events.js +2 -0
  8. package/dist/app.d.ts +8 -1
  9. package/dist/app.js +45 -11
  10. package/dist/auth/api-key.d.ts +19 -0
  11. package/dist/auth/api-key.js +56 -0
  12. package/dist/auth/middleware.js +11 -15
  13. package/dist/auth/oidc.d.ts +46 -4
  14. package/dist/auth/oidc.js +55 -8
  15. package/dist/events/hub.d.ts +36 -2
  16. package/dist/events/hub.js +66 -4
  17. package/dist/events/visible-session-ids.d.ts +35 -0
  18. package/dist/events/visible-session-ids.js +29 -0
  19. package/dist/init.d.ts +1 -0
  20. package/dist/init.js +96 -0
  21. package/dist/lib/app-config.js +42 -1
  22. package/dist/lib/bind-host.d.ts +10 -0
  23. package/dist/lib/bind-host.js +32 -0
  24. package/dist/lib/i18n.js +24 -0
  25. package/dist/lib/principal-identity.d.ts +35 -0
  26. package/dist/lib/principal-identity.js +43 -0
  27. package/dist/lib/project-principal.d.ts +27 -0
  28. package/dist/lib/project-principal.js +27 -0
  29. package/dist/lib/recalc-can-summarize.js +8 -5
  30. package/dist/main.js +9 -2
  31. package/dist/middleware/rate-limiter.d.ts +4 -1
  32. package/dist/middleware/rate-limiter.js +15 -2
  33. package/dist/routes/agents.d.ts +3 -3
  34. package/dist/routes/agents.js +6 -2
  35. package/dist/routes/auth.js +38 -20
  36. package/dist/routes/llm.js +65 -7
  37. package/dist/routes/mcp-remote.d.ts +23 -0
  38. package/dist/routes/mcp-remote.js +152 -0
  39. package/dist/routes/mcp.d.ts +11 -6
  40. package/dist/routes/mcp.js +35 -6
  41. package/dist/routes/project-access.d.ts +61 -0
  42. package/dist/routes/project-access.js +62 -0
  43. package/dist/routes/projects.d.ts +42 -5
  44. package/dist/routes/projects.js +128 -17
  45. package/dist/routes/providers.d.ts +4 -1
  46. package/dist/routes/providers.js +19 -99
  47. package/dist/routes/queue.d.ts +7 -1
  48. package/dist/routes/queue.js +7 -1
  49. package/dist/routes/schedules.d.ts +46 -0
  50. package/dist/routes/schedules.js +10 -0
  51. package/dist/routes/sessions.d.ts +67 -6
  52. package/dist/routes/sessions.js +348 -208
  53. package/dist/routes/users.d.ts +14 -1
  54. package/dist/routes/users.js +91 -1
  55. package/package.json +5 -5
  56. package/dist/routes/audit.d.ts +0 -17
  57. package/dist/routes/audit.js +0 -64
  58. package/dist/routes/context.d.ts +0 -4
  59. package/dist/routes/context.js +0 -93
  60. package/dist/routes/debug.d.ts +0 -3
  61. package/dist/routes/debug.js +0 -30
  62. package/dist/routes/gateway-patterns.d.ts +0 -9
  63. package/dist/routes/gateway-patterns.js +0 -57
  64. package/dist/routes/logs.d.ts +0 -24
  65. package/dist/routes/logs.js +0 -100
  66. package/dist/routes/mcp-registry.d.ts +0 -28
  67. package/dist/routes/mcp-registry.js +0 -483
@@ -1,4 +1,5 @@
1
1
  import { extractChildSessionId } from '@itphx/synth-core';
2
+ import { listVisibleSessions } from './visible-session-ids.js';
2
3
  /** Служебный ключ глобальной подписки all-клиента в `clientSubs`. */
3
4
  const ALL_SESSIONS_KEY = '*';
4
5
  /**
@@ -9,11 +10,19 @@ const ALL_SESSIONS_KEY = '*';
9
10
  export class EventHub {
10
11
  eventBus;
11
12
  sessionManager;
13
+ projectStore;
12
14
  clients = new Map();
13
15
  clientSubs = new WeakMap();
14
- constructor(eventBus, sessionManager) {
16
+ constructor(eventBus, sessionManager,
17
+ /**
18
+ * PROP-133 §6: проекты пользователя — чтобы подписка клиента покрывала
19
+ * сессии **всех видимых** проектов (не только свои). Не задан — подписка
20
+ * остаётся «только свои сессии» (прежнее поведение).
21
+ */
22
+ projectStore) {
15
23
  this.eventBus = eventBus;
16
24
  this.sessionManager = sessionManager;
25
+ this.projectStore = projectStore;
17
26
  }
18
27
  async registerClient(client) {
19
28
  const arr = this.clients.get(client.userId) || [];
@@ -28,8 +37,13 @@ export class EventHub {
28
37
  console.log(`[EventHub] Register client (all sessions): user=${client.username} clients=${arr.length}`);
29
38
  return;
30
39
  }
31
- // Нужны только id сессий владельца — лёгкая выборка (без истории сообщений).
32
- const sessions = await this.sessionManager.listSessions({ userId: client.userId });
40
+ // Нужны id сессий, видимых пользователю: свои + сессии всех проектов, где
41
+ // у него есть роль (PROP-133 §6, инвариант 18). Лёгкая выборка (без истории
42
+ // сообщений). Тот же шов, что у списка сессий (`resolveMemberProjectIds`).
43
+ const sessions = await listVisibleSessions(this.sessionManager, this.projectStore, {
44
+ userId: client.userId,
45
+ ...(client.groups ? { groups: client.groups } : {}),
46
+ });
33
47
  console.log(`[EventHub] Register client: user=${client.username} clients=${arr.length} sessions=${sessions.length}`);
34
48
  for (const s of sessions) {
35
49
  this._subscribeClientToSession(client, s.id);
@@ -48,6 +62,51 @@ export class EventHub {
48
62
  const remaining = arr.length;
49
63
  console.log(`[EventHub] Unregister client: user=${client.username} remaining=${remaining}`);
50
64
  }
65
+ /**
66
+ * PROP-133 Ф2 / ADR-140 Ф2: пересчитать подписки клиента — доступ к
67
+ * проектам мог измениться (появился/снят участник, изменился режим
68
+ * «всем пользователям»).
69
+ *
70
+ * Список подписок = список **видимых** сессий (`listVisibleSessions` — тот
71
+ * же шов, что у списка сессий), поэтому пересчёт совпадает с видимостью
72
+ * проектов и не расходится с ней.
73
+ *
74
+ * Watch-all клиент (`allSessions`) не пересчитывается: его подписка
75
+ * глобальная и от проектов не зависит.
76
+ */
77
+ async resyncClient(client) {
78
+ if (client.allSessions)
79
+ return;
80
+ const subs = this.clientSubs.get(client);
81
+ if (!subs)
82
+ return;
83
+ // Снимаем прежние per-session подписки (глобальная — не трогаем).
84
+ for (const [key, unsub] of [...subs]) {
85
+ if (key === ALL_SESSIONS_KEY)
86
+ continue;
87
+ unsub();
88
+ subs.delete(key);
89
+ }
90
+ const sessions = await listVisibleSessions(this.sessionManager, this.projectStore, {
91
+ userId: client.userId,
92
+ ...(client.groups ? { groups: client.groups } : {}),
93
+ });
94
+ for (const s of sessions) {
95
+ this._subscribeClientToSession(client, s.id);
96
+ }
97
+ }
98
+ /**
99
+ * PROP-133 Ф2 / ADR-140 Ф2: пересчитать подписки **всем** подключённым
100
+ * клиентам (редкое admin-действие — смена состояния доступа к проекту).
101
+ */
102
+ async resyncAllClients() {
103
+ const clients = [];
104
+ for (const arr of this.clients.values())
105
+ clients.push(...arr);
106
+ await Promise.all(clients.map((c) => this.resyncClient(c)));
107
+ // Сводка без спама по каждой сессии.
108
+ console.log(`[EventHub] Resync clients: ${clients.length}`);
109
+ }
51
110
  shutdown() {
52
111
  console.log(`[EventHub] Shutting down: ${this.clients.size} users...`);
53
112
  for (const clients of this.clients.values()) {
@@ -90,9 +149,12 @@ export class EventHub {
90
149
  const subs = this.clientSubs.get(client);
91
150
  if (!subs || subs.has(ALL_SESSIONS_KEY))
92
151
  return;
152
+ // `userFacing`: клиент (WS/SSE) обслуживает пользователя и может ответить
153
+ // на `permission.asked`. Без флага подтверждение считалось бы «некому
154
+ // показать»: у watch-all клиентов per-session подписок нет.
93
155
  const unsub = this.eventBus.subscribeAll((event) => {
94
156
  this._deliver(client, event);
95
- });
157
+ }, { userFacing: true });
96
158
  subs.set(ALL_SESSIONS_KEY, unsub);
97
159
  }
98
160
  /**
@@ -0,0 +1,35 @@
1
+ /**
2
+ * PROP-133 §6: «видимые» сессии пользователя — свои **+** сессии всех проектов,
3
+ * где у пользователя есть роль (владелец, участник, грант по группе, режим
4
+ * «всем пользователям»).
5
+ *
6
+ * Единый шов для двух мест, которым нужен один и тот же список:
7
+ * - список сессий (`routes/sessions.ts` → `resolveMemberProjectIds`);
8
+ * - подписки хаба (`events/hub.ts` → `registerClient`).
9
+ *
10
+ * Своей копии предиката здесь нет: список проектов считает резолвер доступа
11
+ * слоя 1 (`ProjectRepository.list(viewer)`).
12
+ */
13
+ import type { ProjectRepository, SessionManager } from '@itphx/synth-core';
14
+ import type { Session } from '@itphx/synth-shared';
15
+ /** Кто запрашивает видимые сессии. */
16
+ export interface VisibleSessionScope {
17
+ /** Идентификатор пользователя (владелец сессии/проекта). */
18
+ userId: string;
19
+ /** Группы пользователя (PROP-133 Ф2): нет — групп нет (fail-closed). */
20
+ groups?: readonly string[];
21
+ }
22
+ /**
23
+ * Идентификаторы проектов, видимых пользователю (владелец/участник/грант по
24
+ * группе/«всем пользователям»). Список без аргумента (все проекты) здесь не
25
+ * используется — он нужен elevated-ролям (`ADMIN`/`LEAD`), они идут отдельным
26
+ * путём (`resolveElevated`).
27
+ */
28
+ export declare function resolveVisibleProjectIds(projectStore: ProjectRepository | undefined, scope: VisibleSessionScope): Promise<string[]>;
29
+ /**
30
+ * Сессии, видимые пользователю: свои + сессии видимых проектов.
31
+ *
32
+ * Пустой `userId` → пустой список (fail-closed: без идентификатора запроса
33
+ * выборка «все сессии» недопустима).
34
+ */
35
+ export declare function listVisibleSessions(sessionManager: Pick<SessionManager, 'listSessions'>, projectStore: ProjectRepository | undefined, scope: VisibleSessionScope): Promise<Session[]>;
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Идентификаторы проектов, видимых пользователю (владелец/участник/грант по
3
+ * группе/«всем пользователям»). Список без аргумента (все проекты) здесь не
4
+ * используется — он нужен elevated-ролям (`ADMIN`/`LEAD`), они идут отдельным
5
+ * путём (`resolveElevated`).
6
+ */
7
+ export async function resolveVisibleProjectIds(projectStore, scope) {
8
+ if (!projectStore)
9
+ return [];
10
+ const projects = await projectStore.list({
11
+ userId: scope.userId,
12
+ ...(scope.groups ? { groups: scope.groups } : {}),
13
+ });
14
+ return projects.map((project) => project.id);
15
+ }
16
+ /**
17
+ * Сессии, видимые пользователю: свои + сессии видимых проектов.
18
+ *
19
+ * Пустой `userId` → пустой список (fail-closed: без идентификатора запроса
20
+ * выборка «все сессии» недопустима).
21
+ */
22
+ export async function listVisibleSessions(sessionManager, projectStore, scope) {
23
+ if (!scope.userId)
24
+ return [];
25
+ const projectIds = await resolveVisibleProjectIds(projectStore, scope);
26
+ return sessionManager.listSessions(projectIds.length > 0
27
+ ? { userId: scope.userId, projectIds }
28
+ : { userId: scope.userId });
29
+ }
package/dist/init.d.ts ADDED
@@ -0,0 +1 @@
1
+ export {};
package/dist/init.js ADDED
@@ -0,0 +1,96 @@
1
+ // Обёртка дочернего процесса в контейнере backend (вторая ступень после
2
+ // sh-инициализатора `docker/init.sh`, см. ниже «Чего обёртка НЕ делает»).
3
+ //
4
+ // Зачем обёртка. С `CMD ["node","dist/main.js"]` приложение само становится
5
+ // PID 1 (в Docker/K8s это первый процесс, у которого нет родителя). PID 1
6
+ // обязан **пожинать** осиротевших детей (`waitpid`): иначе завершившиеся
7
+ // процессы остаются зомби, занимают слоты PID и ломают `kill(pid, 0)` —
8
+ // «процесс ещё жив» для давно мёртвого (аудит 0.13.4 §5.2: 38–42 зомби и
9
+ // падающие abort-тесты).
10
+ //
11
+ // Что делает обёртка:
12
+ // 1. запускает `node dist/main.js` (тот же `process.execPath`, тот же argv/env,
13
+ // тот же cwd) в **отдельной process group** (`detached: true`) — поэтому
14
+ // сигнал можно отправить всей группе (`kill(-pid)`), а не только шефу;
15
+ // 2. пробрасывает SIGTERM/SIGINT/SIGHUP группе дочернего процесса (Docker и
16
+ // K8s шлют сигнал только PID 1 — сама обёртка);
17
+ // 3. ждёт завершения ребёнка и выходит с **тем же кодом** — включая 75
18
+ // (graceful restart, ADR-092 п. 7 / инвариант 24) и 128+N при гибели от
19
+ // сигнала; супервизор (Docker `restart`/K8s `restartPolicy`) видит
20
+ // исходный код, а не код обёртки;
21
+ // 4. ошибка запуска/отсутствие цели — код 1 и понятная строка в stderr.
22
+ //
23
+ // Чего обёртка НЕ делает — reaping. Пожинать осиротевших детей умеет только
24
+ // PID 1, и для этого нужен `waitpid(-1)`; Node/libuv так не может: libuv ждёт
25
+ // лишь pid'ы своих child-handle'ов (`waitpid(process->pid)`), а усыновлённые
26
+ // сироты остаются зомби. Поэтому в контейнере PID 1 — sh-скрипт
27
+ // `docker/init.sh` (`synth-init`), а эта обёртка — его дочерний процесс
28
+ // (см. шапку `docker/Dockerfile.backend`).
29
+ //
30
+ // Это **не** замена graceful shutdown приложения: SIGTERM доходит до main.js,
31
+ // и тот закрывает сервер/очередь как раньше (см. `main.ts`).
32
+ //
33
+ // `SYNTH_INIT_ENTRY` переопределяет цель запуска — только для тестов и ручной
34
+ // отладки (в образе он не задаётся, дефолт — `dist/main.js` рядом с обёрткой).
35
+ import { spawn } from 'node:child_process';
36
+ import { existsSync } from 'node:fs';
37
+ import { constants } from 'node:os';
38
+ import { dirname, join, resolve } from 'node:path';
39
+ import { fileURLToPath } from 'node:url';
40
+ /** Сигналы, которые обёртка пересылает дочернему процессу (вся группа). */
41
+ const FORWARDED_SIGNALS = ['SIGTERM', 'SIGINT', 'SIGHUP'];
42
+ /**
43
+ * Код выхода по сигналу — как у оболочки: 128 + номер сигнала
44
+ * (SIGKILL → 137, SIGTERM → 143). `undefined` — сигнал неизвестен.
45
+ */
46
+ function signalExitCode(signal) {
47
+ const number = constants.signals[signal];
48
+ return typeof number === 'number' ? 128 + number : 1;
49
+ }
50
+ /** Скрипт-цель: `dist/main.js` рядом с обёрткой (или `SYNTH_INIT_ENTRY`). */
51
+ function resolveEntry() {
52
+ const override = process.env.SYNTH_INIT_ENTRY?.trim();
53
+ if (override !== undefined && override.length > 0)
54
+ return resolve(process.cwd(), override);
55
+ return join(dirname(fileURLToPath(import.meta.url)), 'main.js');
56
+ }
57
+ function main() {
58
+ const entry = resolveEntry();
59
+ if (!existsSync(entry)) {
60
+ // Внятная причина вместо стектрейса node «Cannot find module»: в образе
61
+ // цель — `dist/main.js` рядом с обёрткой, её отсутствие = битая сборка.
62
+ console.error(`[init] цель запуска не найдена: ${entry}`);
63
+ process.exit(1);
64
+ }
65
+ const child = spawn(process.execPath, [entry, ...process.argv.slice(2)], {
66
+ cwd: process.cwd(),
67
+ env: process.env,
68
+ stdio: 'inherit',
69
+ // Своя process group (setsid): `kill(-pid, sig)` накрывает и потомков,
70
+ // оставшихся от дочернего процесса (`sh -c '… &'`, обёртки команд).
71
+ detached: true,
72
+ });
73
+ const forward = (signal) => {
74
+ if (child.pid === undefined)
75
+ return;
76
+ try {
77
+ process.kill(-child.pid, signal);
78
+ }
79
+ catch {
80
+ // Группы уже нет (ребёнок завершился) — нечего пересылать.
81
+ }
82
+ };
83
+ for (const signal of FORWARDED_SIGNALS) {
84
+ process.on(signal, () => forward(signal));
85
+ }
86
+ child.on('error', (err) => {
87
+ console.error(`[init] не удалось запустить ${entry}: ${err.message}`);
88
+ process.exit(1);
89
+ });
90
+ child.on('exit', (code, signal) => {
91
+ // Код ребёнка сохраняется как есть (75 — рестарт, 0 — штатный выход);
92
+ // гибель от сигнала переводится в 128+N, как в оболочке.
93
+ process.exit(code ?? (signal === null ? 1 : signalExitCode(signal)));
94
+ });
95
+ }
96
+ main();
@@ -1,10 +1,23 @@
1
1
  import { loadConfig, resolveDataDir, resolvePort, resolveWorkspacesRoot, resolveMaxUploadBytes, resolveMaxReadBytes, resolveMaxPreviewBytes } from '@itphx/synth-shared';
2
+ import { resolveApiKeyRoles } from '../auth/api-key.js';
2
3
  const envStr = (key, fallback = '') => process.env[key] || fallback;
3
4
  const envBool = (key, fallback = false) => process.env[key] ? process.env[key] === 'true' : fallback;
4
5
  const envInt = (key, fallback) => {
5
6
  const v = process.env[key];
6
7
  return v ? parseInt(v, 10) : fallback;
7
8
  };
9
+ /**
10
+ * ADR-140: разобрать CSV-список имён групп (`SYNTH_OIDC_GROUPS_ALLOW`).
11
+ * По образцу соседних CSV-полей (`SYNTH_API_KEY_ROLES`,
12
+ * `SYNTH_ATTACHMENTS_MODALITIES`): trim, пустые элементы отбрасываются.
13
+ * Пустая строка → пустой список (групп нет — fail-closed).
14
+ */
15
+ function parseCsvList(raw) {
16
+ return raw
17
+ .split(',')
18
+ .map((part) => part.trim())
19
+ .filter((part) => part.length > 0);
20
+ }
8
21
  function buildAuthConfig(defaults) {
9
22
  const debugMode = envBool('SYNTH_AUTH_DEBUG', defaults.debugMode);
10
23
  let testUsers = [];
@@ -37,9 +50,22 @@ function buildAuthConfig(defaults) {
37
50
  ];
38
51
  }
39
52
  const oidcEnabled = envBool('SYNTH_OIDC_ENABLED', defaults.oidc?.enabled ?? false);
53
+ // ADR-140: источник групп — claim IdP + allowlist имён групп.
54
+ // Приоритет: env > config.yaml > дефолт (пустой allowlist → групп нет,
55
+ // fail-closed; «принять все» невозможно). Явно заданная (в т.ч. пустая)
56
+ // env-переменная перекрывает config.yaml — иначе «выключил» группы оператор
57
+ // не смог бы.
58
+ const groupsClaim = envStr('SYNTH_OIDC_GROUPS_CLAIM', defaults.oidc?.groups?.claim ?? 'groups');
59
+ const groupsAllowEnv = process.env.SYNTH_OIDC_GROUPS_ALLOW;
60
+ const groupsAllow = groupsAllowEnv !== undefined
61
+ ? parseCsvList(groupsAllowEnv)
62
+ : (defaults.oidc?.groups?.allow ?? []);
40
63
  return {
41
64
  debugMode,
42
65
  apiKey: envStr('SYNTH_API_KEY', defaults.apiKey ?? ''),
66
+ // Аудит F5: роли API-ключа — только явная настройка (`auth.apiKeyRoles` /
67
+ // `SYNTH_API_KEY_ROLES`), дефолт USER. Неизвестная роль — ошибка загрузки.
68
+ apiKeyRoles: resolveApiKeyRoles(defaults.apiKeyRoles),
43
69
  testUsers,
44
70
  sessionMaxAgeMinutes: envInt('SYNTH_SESSION_MAX_AGE', defaults.sessionMaxAgeMinutes),
45
71
  oidc: oidcEnabled
@@ -50,12 +76,27 @@ function buildAuthConfig(defaults) {
50
76
  clientSecret: envStr('SYNTH_OIDC_CLIENT_SECRET', defaults.oidc?.clientSecret ?? ''),
51
77
  redirectUri: envStr('SYNTH_OIDC_REDIRECT_URI', defaults.oidc?.redirectUri ?? 'http://localhost:5002/auth/callback'),
52
78
  cliClientId: envStr('SYNTH_OIDC_CLI_CLIENT_ID', defaults.oidc?.cliClientId ?? 'synth-cli'),
79
+ groups: {
80
+ claim: groupsClaim,
81
+ allow: groupsAllow,
82
+ },
53
83
  }
54
84
  : undefined,
55
85
  };
56
86
  }
57
87
  export async function loadBackendConfig(options) {
58
- const synth = await loadConfig(options);
88
+ const synth = await loadConfig({
89
+ baseDefaults: {
90
+ // PROP-136 (слайс 136a): managed-профиль включает аудит исполнений shell
91
+ // по умолчанию (наблюдаемость произвольного кода обязательна); explicit
92
+ // config.yaml/env (`SYNTH_COMMAND_AUDIT_ENABLED`) перебивают профиль,
93
+ // standalone остаётся выключенным. PROP-136b: зеркальный чекер команд в
94
+ // managed по умолчанию **fail-closed** (недоступность политики = deny);
95
+ // standalone сохраняет `open` из схемы.
96
+ security: { commandAudit: { enabled: true }, commandPolicy: { failMode: 'closed' } },
97
+ },
98
+ ...options,
99
+ });
59
100
  const auth = buildAuthConfig(synth.auth);
60
101
  const dataDir = resolveDataDir(synth);
61
102
  const workspacesRoot = resolveWorkspacesRoot(synth);
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Признак контейнера: маркер Docker (`/.dockerenv`), окружение Kubernetes
3
+ * (`KUBERNETES_SERVICE_HOST`) либо явный `SYNTH_IN_CONTAINER` (образ/split-режим).
4
+ */
5
+ export declare function detectContainer(env?: NodeJS.ProcessEnv, dockerEnvFileExists?: (path: string) => boolean): boolean;
6
+ /**
7
+ * Итоговый bind-host: `SYNTH_HOST` > контейнер (`0.0.0.0`) > loopback.
8
+ * Пустой `SYNTH_HOST` трактуется как «не задан».
9
+ */
10
+ export declare function resolveBindHost(env: NodeJS.ProcessEnv, isContainer: boolean): string;
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Адрес прослушивания backend (аудит F5, безопасный дефолт).
3
+ *
4
+ * Вне контейнера backend по умолчанию слушает **loopback** (`127.0.0.1`):
5
+ * публикация порта наружу — только явным `SYNTH_HOST`. В контейнере/K8s
6
+ * (образ, Helm-чарт, docker-compose) — `0.0.0.0`, иначе порт не был бы доступен
7
+ * снаружи контейнера.
8
+ *
9
+ * `SYNTH_HOST` приоритетен всегда (явная настройка оператора).
10
+ */
11
+ import { existsSync } from 'node:fs';
12
+ /**
13
+ * Признак контейнера: маркер Docker (`/.dockerenv`), окружение Kubernetes
14
+ * (`KUBERNETES_SERVICE_HOST`) либо явный `SYNTH_IN_CONTAINER` (образ/split-режим).
15
+ */
16
+ export function detectContainer(env = process.env, dockerEnvFileExists = existsSync) {
17
+ if (dockerEnvFileExists('/.dockerenv'))
18
+ return true;
19
+ if (env.KUBERNETES_SERVICE_HOST)
20
+ return true;
21
+ return env.SYNTH_IN_CONTAINER === 'true' || env.SYNTH_IN_CONTAINER === '1';
22
+ }
23
+ /**
24
+ * Итоговый bind-host: `SYNTH_HOST` > контейнер (`0.0.0.0`) > loopback.
25
+ * Пустой `SYNTH_HOST` трактуется как «не задан».
26
+ */
27
+ export function resolveBindHost(env, isContainer) {
28
+ const explicit = env.SYNTH_HOST?.trim();
29
+ if (explicit)
30
+ return explicit;
31
+ return isContainer ? '0.0.0.0' : '127.0.0.1';
32
+ }
package/dist/lib/i18n.js CHANGED
@@ -29,6 +29,14 @@ const en = {
29
29
  'errors.validation.expectedFilesArray': 'expected { files: string[] }',
30
30
  'errors.validation.claimCodeRequired': 'Confirmation code is required',
31
31
  'errors.validation.invalidUsername': 'Invalid username',
32
+ // PROP-133: каталог пользователей (`GET /api/v2/users/directory`)
33
+ 'errors.validation.invalidDirectoryLimit': 'Invalid limit value (an integer 0..200)',
34
+ 'errors.validation.invalidDirectoryOffset': 'Invalid offset value (an integer >= 0)',
35
+ // PROP-054: точечные операции плана/журнала/инвариантов проекта
36
+ 'errors.validation.invalidPlanBody': 'Invalid plan request payload',
37
+ 'errors.validation.invalidLogBody': 'Invalid project log request payload',
38
+ 'errors.validation.invalidInvariantsBody': 'Invalid project invariants payload',
39
+ 'errors.unavailable.remoteProject': 'The operation is not available for a remote project',
32
40
  // ADR-089: приём внешних событий
33
41
  'errors.validation.invalidEvent': 'Invalid event payload',
34
42
  'errors.validation.invalidBinding': 'Invalid binding payload',
@@ -90,6 +98,10 @@ const en = {
90
98
  'errors.notFound.memoryProject': 'Project not found',
91
99
  'errors.validation.memoryWorkspaceRequired': 'The project has no workspace: a file index cannot be built',
92
100
  'errors.unavailable.memoryProvider': 'The memory provider is unavailable: the memory plugin is not active',
101
+ // PROP-135 (execution profiles/pools admin API)
102
+ 'errors.validation.executionPoolKey': 'Invalid execution pool key (expected instance:<class>:<profile> or <project|session>:<id>:<class>:<profile>)',
103
+ 'errors.unavailable.executionProvider': 'The execution pool provider is unavailable: dynamic pools require execution.remote.provider=http',
104
+ 'errors.notFound.executionPool': 'Execution pool not found',
93
105
  'errors.notFound.memoryIndex': 'Memory index not found',
94
106
  'errors.failed.memoryIndex': 'Failed to perform the memory index operation',
95
107
  'memory.indexCreated': 'Memory index created',
@@ -197,6 +209,14 @@ const ru = {
197
209
  'errors.validation.expectedFilesArray': 'expected { files: string[] }',
198
210
  'errors.validation.claimCodeRequired': 'Укажите код подтверждения',
199
211
  'errors.validation.invalidUsername': 'Некорректное имя пользователя',
212
+ // PROP-133: каталог пользователей (`GET /api/v2/users/directory`)
213
+ 'errors.validation.invalidDirectoryLimit': 'Некорректное значение limit (целое 0..200)',
214
+ 'errors.validation.invalidDirectoryOffset': 'Некорректное значение offset (целое ≥ 0)',
215
+ // PROP-054: точечные операции плана/журнала/инвариантов проекта
216
+ 'errors.validation.invalidPlanBody': 'Некорректное тело запроса плана',
217
+ 'errors.validation.invalidLogBody': 'Некорректное тело запроса журнала проекта',
218
+ 'errors.validation.invalidInvariantsBody': 'Некорректное тело запроса инвариантов проекта',
219
+ 'errors.unavailable.remoteProject': 'Операция недоступна для удалённого проекта',
200
220
  // ADR-089: приём внешних событий
201
221
  'errors.validation.invalidEvent': 'Некорректное тело события',
202
222
  'errors.validation.invalidBinding': 'Некорректное тело биндинга',
@@ -259,6 +279,10 @@ const ru = {
259
279
  'errors.notFound.memoryProject': 'Проект не найден',
260
280
  'errors.validation.memoryWorkspaceRequired': 'У проекта нет рабочего каталога: индекс файлов строить негде',
261
281
  'errors.unavailable.memoryProvider': 'Провайдер памяти недоступен: плагин памяти не активен',
282
+ // PROP-135: admin-API профилей и пулов исполнения
283
+ 'errors.validation.executionPoolKey': 'Некорректный ключ пула исполнения (ожидается instance:<class>:<profile> или <project|session>:<id>:<class>:<profile>)',
284
+ 'errors.unavailable.executionProvider': 'Провайдер пулов исполнения недоступен: динамические пулы требуют execution.remote.provider=http',
285
+ 'errors.notFound.executionPool': 'Пул исполнения не найден',
262
286
  'errors.notFound.memoryIndex': 'Индекс памяти не найден',
263
287
  'errors.failed.memoryIndex': 'Не удалось выполнить операцию с индексом памяти',
264
288
  'memory.indexCreated': 'Индекс памяти создан',
@@ -0,0 +1,35 @@
1
+ /**
2
+ * ADR-140: связь профиля пользователя с принципалом (ACL-id).
3
+ *
4
+ * `ProfileData.id` — внутренний UUID профиля, а ACL-id (то, что стоит в
5
+ * `project.ownerId`, `project.members`, `session.ownerId`) — идентификатор
6
+ * пользователя из токена: OIDC `sub` либо debug-id (`admin`/`developer`).
7
+ * Из-за расхождения гранты, выданные через UI (каталог отдавал `profile.id`),
8
+ * не совпадали с принципалом, а передача владения не находила получателя.
9
+ *
10
+ * Связь делается через существующий механизм идентичностей (`ADR-089`):
11
+ * при логине профилю привязывается auth-идентичность (`provider: 'auth'`,
12
+ * `externalId` = id пользователя из токена). Миграции схемы не нужны —
13
+ * используется поле `ProfileData.identities`.
14
+ */
15
+ import type { ProfileData, ProfileStore, User } from '@itphx/synth-shared';
16
+ /** Провайдер auth-идентичности: id пользователя из токена (OIDC `sub`/debug-id). */
17
+ export declare const AUTH_IDENTITY_PROVIDER = "auth";
18
+ /**
19
+ * ACL-id профиля: привязанная auth-идентичность (sub/debug-id) либо
20
+ * `profile.id` (legacy — профиль без auth-идентичности).
21
+ */
22
+ export declare function principalIdOf(profile: ProfileData): string;
23
+ /**
24
+ * Привязать auth-идентичность пользователя к его профилю (при логине).
25
+ *
26
+ * Идемпотентно и best-effort: ошибка привязки не ломает вход (логируется
27
+ * вызывающим, без секретов).
28
+ * - профиль с такой auth-идентичностью уже есть → ничего не делаем;
29
+ * - иначе профиль по username → привязываем идентичность;
30
+ * - иначе создаём профиль и привязываем.
31
+ *
32
+ * `linkIdentity` возвращает `null`, если пара `(auth, id)` уже занята другим
33
+ * профилем (конфликт) — это не ошибка входа: факт логируется, вход продолжается.
34
+ */
35
+ export declare function ensurePrincipalIdentity(profiles: ProfileStore, user: User): Promise<void>;
@@ -0,0 +1,43 @@
1
+ import { nowISO } from '@itphx/synth-shared';
2
+ /** Провайдер auth-идентичности: id пользователя из токена (OIDC `sub`/debug-id). */
3
+ export const AUTH_IDENTITY_PROVIDER = 'auth';
4
+ /**
5
+ * ACL-id профиля: привязанная auth-идентичность (sub/debug-id) либо
6
+ * `profile.id` (legacy — профиль без auth-идентичности).
7
+ */
8
+ export function principalIdOf(profile) {
9
+ const auth = (profile.identities ?? []).find((i) => i.provider === AUTH_IDENTITY_PROVIDER);
10
+ return auth?.externalId ?? profile.id;
11
+ }
12
+ /**
13
+ * Привязать auth-идентичность пользователя к его профилю (при логине).
14
+ *
15
+ * Идемпотентно и best-effort: ошибка привязки не ломает вход (логируется
16
+ * вызывающим, без секретов).
17
+ * - профиль с такой auth-идентичностью уже есть → ничего не делаем;
18
+ * - иначе профиль по username → привязываем идентичность;
19
+ * - иначе создаём профиль и привязываем.
20
+ *
21
+ * `linkIdentity` возвращает `null`, если пара `(auth, id)` уже занята другим
22
+ * профилем (конфликт) — это не ошибка входа: факт логируется, вход продолжается.
23
+ */
24
+ export async function ensurePrincipalIdentity(profiles, user) {
25
+ const linked = await profiles.findProfileByExternalId(AUTH_IDENTITY_PROVIDER, user.id);
26
+ if (linked)
27
+ return;
28
+ const byUsername = await profiles.getProfileByUsername(user.username);
29
+ const profile = byUsername ?? await profiles.getOrCreateProfile({
30
+ username: user.username,
31
+ roles: user.roles,
32
+ });
33
+ const updated = await profiles.linkIdentity(profile.id, {
34
+ provider: AUTH_IDENTITY_PROVIDER,
35
+ externalId: user.id,
36
+ linkedAt: nowISO(),
37
+ linkedBy: 'login',
38
+ });
39
+ if (!updated) {
40
+ // Конфликт: пара `(auth, id)` занята другим профилем — перезаписывать нельзя.
41
+ console.warn('[auth] привязка auth-идентичности не выполнена: пара занята другим профилем');
42
+ }
43
+ }
@@ -0,0 +1,27 @@
1
+ /**
2
+ * PROP-133 §1: принципал доступа к проекту — пользователь, его роли инстанса
3
+ * и группы.
4
+ *
5
+ * Единая точка сборки принципала для backend-контуров (`routes/projects.ts`,
6
+ * `routes/sessions.ts`, `events/hub.ts`): иначе «кто запрашивает» собирался бы
7
+ * в трёх местах по-разному, а правила доступа разошлись бы (PROP-133 §1).
8
+ *
9
+ * Группы (ADR-140 Ф2): источник — claim `groups` из IdP, доставленный в
10
+ * `User.groups` (снимок на момент логина). Поле читается напрямую; нет поля /
11
+ * не массив / пусто → групп нет (fail-closed).
12
+ */
13
+ import type { ProjectPrincipal, User } from '@itphx/synth-shared';
14
+ /**
15
+ * ADR-140: группы пользователя.
16
+ *
17
+ * Нет поля / не массив / пусто → `undefined` (групп нет — fail-closed).
18
+ */
19
+ export declare function groupsOf(user: User | null | undefined): readonly string[] | undefined;
20
+ /**
21
+ * PROP-133 §1: принципал доступа к проекту.
22
+ *
23
+ * `userId` — идентификатор пользователя запроса (владелец сессии/проекта);
24
+ * `roles` — глобальные роли инстанса (`ADMIN`/`LEAD` — сквозной обзор);
25
+ * `groups` — группы пользователя (ADR-140; нет — `undefined`).
26
+ */
27
+ export declare function projectPrincipalOf(user: User | null | undefined, userId: string, roles?: readonly string[]): ProjectPrincipal;
@@ -0,0 +1,27 @@
1
+ /**
2
+ * ADR-140: группы пользователя.
3
+ *
4
+ * Нет поля / не массив / пусто → `undefined` (групп нет — fail-closed).
5
+ */
6
+ export function groupsOf(user) {
7
+ const groups = user?.groups;
8
+ if (!Array.isArray(groups))
9
+ return undefined;
10
+ const named = groups.filter((group) => typeof group === 'string' && group.length > 0);
11
+ return named.length > 0 ? named : undefined;
12
+ }
13
+ /**
14
+ * PROP-133 §1: принципал доступа к проекту.
15
+ *
16
+ * `userId` — идентификатор пользователя запроса (владелец сессии/проекта);
17
+ * `roles` — глобальные роли инстанса (`ADMIN`/`LEAD` — сквозной обзор);
18
+ * `groups` — группы пользователя (ADR-140; нет — `undefined`).
19
+ */
20
+ export function projectPrincipalOf(user, userId, roles) {
21
+ const groups = groupsOf(user);
22
+ return {
23
+ userId,
24
+ roles: roles ?? user?.roles ?? [],
25
+ ...(groups ? { groups } : {}),
26
+ };
27
+ }
@@ -27,12 +27,15 @@ export function createRecalcCanSummarize({ sessionManager, contextOptimizer, eve
27
27
  shouldClearPending = true;
28
28
  }
29
29
  }
30
- await sessionManager.withLock(sessionId, async (locked) => {
31
- locked.canSummarize = can;
30
+ // Значение считается по **свежему снимку** (нужна история), а запись —
31
+ // точечная, под локом порта: полный снимок затирал бы параллельную
32
+ // дозапись сообщений. `updatedAt` не двигаем — паритет с прежним
33
+ // `saveSession` (пересчёт после правок истории не «оживляет» сессию).
34
+ await sessionManager.mutateMeta(sessionId, (meta) => {
35
+ meta.canSummarize = can;
32
36
  if (shouldClearPending)
33
- locked.summarizationPending = false;
34
- await sessionManager.saveSession(locked);
35
- });
37
+ meta.summarizationPending = false;
38
+ }, { touchUpdatedAt: false });
36
39
  eventBus.publish(sessionId, 'session.updated', {
37
40
  session_id: sessionId,
38
41
  can_summarize: can,