@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.
- package/dist/app/deps.d.ts +22 -1
- package/dist/app/deps.js +743 -63
- package/dist/app/listen.js +30 -35
- package/dist/app/mount-routes.js +405 -46
- package/dist/app/public-routes.d.ts +2 -0
- package/dist/app/public-routes.js +11 -0
- package/dist/app/sse-events.js +2 -0
- package/dist/app.d.ts +8 -1
- package/dist/app.js +45 -11
- package/dist/auth/api-key.d.ts +19 -0
- package/dist/auth/api-key.js +56 -0
- package/dist/auth/middleware.js +11 -15
- package/dist/auth/oidc.d.ts +46 -4
- package/dist/auth/oidc.js +55 -8
- package/dist/events/hub.d.ts +36 -2
- package/dist/events/hub.js +66 -4
- package/dist/events/visible-session-ids.d.ts +35 -0
- package/dist/events/visible-session-ids.js +29 -0
- package/dist/init.d.ts +1 -0
- package/dist/init.js +96 -0
- package/dist/lib/app-config.js +42 -1
- package/dist/lib/bind-host.d.ts +10 -0
- package/dist/lib/bind-host.js +32 -0
- package/dist/lib/i18n.js +24 -0
- package/dist/lib/principal-identity.d.ts +35 -0
- package/dist/lib/principal-identity.js +43 -0
- package/dist/lib/project-principal.d.ts +27 -0
- package/dist/lib/project-principal.js +27 -0
- package/dist/lib/recalc-can-summarize.js +8 -5
- package/dist/main.js +9 -2
- package/dist/middleware/rate-limiter.d.ts +4 -1
- package/dist/middleware/rate-limiter.js +15 -2
- package/dist/routes/agents.d.ts +3 -3
- package/dist/routes/agents.js +6 -2
- package/dist/routes/auth.js +38 -20
- package/dist/routes/llm.js +65 -7
- package/dist/routes/mcp-remote.d.ts +23 -0
- package/dist/routes/mcp-remote.js +152 -0
- package/dist/routes/mcp.d.ts +11 -6
- package/dist/routes/mcp.js +35 -6
- package/dist/routes/project-access.d.ts +61 -0
- package/dist/routes/project-access.js +62 -0
- package/dist/routes/projects.d.ts +42 -5
- package/dist/routes/projects.js +128 -17
- package/dist/routes/providers.d.ts +4 -1
- package/dist/routes/providers.js +19 -99
- package/dist/routes/queue.d.ts +7 -1
- package/dist/routes/queue.js +7 -1
- package/dist/routes/schedules.d.ts +46 -0
- package/dist/routes/schedules.js +10 -0
- package/dist/routes/sessions.d.ts +67 -6
- package/dist/routes/sessions.js +348 -208
- package/dist/routes/users.d.ts +14 -1
- package/dist/routes/users.js +91 -1
- package/package.json +5 -5
- package/dist/routes/audit.d.ts +0 -17
- package/dist/routes/audit.js +0 -64
- package/dist/routes/context.d.ts +0 -4
- package/dist/routes/context.js +0 -93
- package/dist/routes/debug.d.ts +0 -3
- package/dist/routes/debug.js +0 -30
- package/dist/routes/gateway-patterns.d.ts +0 -9
- package/dist/routes/gateway-patterns.js +0 -57
- package/dist/routes/logs.d.ts +0 -24
- package/dist/routes/logs.js +0 -100
- package/dist/routes/mcp-registry.d.ts +0 -28
- package/dist/routes/mcp-registry.js +0 -483
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Managed-доступ к проектным ресурсам автоматизаций (PROP-141, этап 5 B-1/B-2).
|
|
3
|
+
*
|
|
4
|
+
* Право — на **проект ресурса** (ADR-089 §5.5/§5.8, инвариант 21):
|
|
5
|
+
*
|
|
6
|
+
* | Актор | чтение | мутации |
|
|
7
|
+
* |------------------------------|---------------------------|----------------------------------|
|
|
8
|
+
* | владелец проекта | да | да |
|
|
9
|
+
* | участник `EDITOR` | да | да |
|
|
10
|
+
* | участник `VIEWER` | да | **403** (`VIEWER` не мутирует) |
|
|
11
|
+
* | `LEAD`/`ADMIN` | да (сквозной обзор) | да |
|
|
12
|
+
* | чужой `USER` | **не видно в списке** | 403/404 |
|
|
13
|
+
*
|
|
14
|
+
* Правило доступа — **одно** для HTTP-контура и агентских тулов
|
|
15
|
+
* (`engine/tools/automation-helpers.ts`): источник истины по ролям —
|
|
16
|
+
* `createProjectAccess` (PROP-133), тот же резолвер, что у `routes/processes.ts`
|
|
17
|
+
* и `routes/messages.ts`.
|
|
18
|
+
*
|
|
19
|
+
* **service-key (ADR-052)** — не пользователь проекта (`service:<keyId>` не
|
|
20
|
+
* участник), поэтому ролевая проверка по проекту к нему не применяется:
|
|
21
|
+
* scope проверяет `requireScope`, проекцию `allowedProjects` —
|
|
22
|
+
* `serviceProjectProjection`. Здесь service-key ограничен своей проекцией:
|
|
23
|
+
* список — по `allowedProjects` (не задана — все проекты, пустой список —
|
|
24
|
+
* ничего), а проект вне проекции — 403.
|
|
25
|
+
*
|
|
26
|
+
* Общий хелпер для **расписаний** (`routes/schedules.ts`) и **таймеров**
|
|
27
|
+
* (`routes/timers.ts`): правило одно, копии нет.
|
|
28
|
+
*/
|
|
29
|
+
import type { Context } from 'hono';
|
|
30
|
+
import type { ProjectRepository } from '@itphx/synth-core';
|
|
31
|
+
import type { AuthKit } from '../auth/middleware.js';
|
|
32
|
+
export interface BackendProjectAccessDeps {
|
|
33
|
+
/** AuthKit backend (OIDC/RBAC). */
|
|
34
|
+
auth: AuthKit;
|
|
35
|
+
/** Порт проектов — по нему резолвятся права на проект ресурса. */
|
|
36
|
+
projectStore: ProjectRepository;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Реализации опций core-фабрик (расписаний/таймеров): граничная проверка
|
|
40
|
+
* прав на проект и скоуп видимости списка.
|
|
41
|
+
*/
|
|
42
|
+
export interface BackendProjectAccess {
|
|
43
|
+
/**
|
|
44
|
+
* Граничная проверка доступа к проекту ресурса (инвариант 16):
|
|
45
|
+
* `read` — право чтения, `write` — право изменения содержимого.
|
|
46
|
+
* `null` — доступ разрешён; иначе — готовый ответ (403/404).
|
|
47
|
+
*/
|
|
48
|
+
authorizeProject: (c: Context, projectId: string, mode: 'read' | 'write') => Promise<Response | null>;
|
|
49
|
+
/**
|
|
50
|
+
* Скоуп чтения списка: id проектов, видимых пользователю; `null` — «все»
|
|
51
|
+
* (`ADMIN`/`LEAD` — сквозной обзор; service-key без `allowedProjects`).
|
|
52
|
+
*/
|
|
53
|
+
listVisibleProjectIds: (c: Context) => Promise<string[] | null>;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Собрать managed-правило доступа к проектным ресурсам автоматизаций.
|
|
57
|
+
*
|
|
58
|
+
* Fail-closed: нет пользователя/проекта/прав — отказ; проект не найден — 404
|
|
59
|
+
* (ресурса нет), права не те — 403.
|
|
60
|
+
*/
|
|
61
|
+
export declare function createBackendProjectAccess(deps: BackendProjectAccessDeps): BackendProjectAccess;
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { getServiceCredential } from '@itphx/synth-core';
|
|
2
|
+
import { createProjectAccess } from './projects.js';
|
|
3
|
+
import { groupsOf } from '../lib/project-principal.js';
|
|
4
|
+
import { t } from '../lib/i18n.js';
|
|
5
|
+
/**
|
|
6
|
+
* Собрать managed-правило доступа к проектным ресурсам автоматизаций.
|
|
7
|
+
*
|
|
8
|
+
* Fail-closed: нет пользователя/проекта/прав — отказ; проект не найден — 404
|
|
9
|
+
* (ресурса нет), права не те — 403.
|
|
10
|
+
*/
|
|
11
|
+
export function createBackendProjectAccess(deps) {
|
|
12
|
+
const projectAccess = createProjectAccess(deps.auth);
|
|
13
|
+
const forbidden = (c) => c.json({ error: { code: 'FORBIDDEN', message: t('auth.forbidden', undefined, c) } }, 403);
|
|
14
|
+
const projectNotFound = (c) => c.json({ error: { code: 'NOT_FOUND', message: t('errors.notFound.project', undefined, c) } }, 404);
|
|
15
|
+
const unauthorized = (c) => c.json({ error: { code: 'UNAUTHORIZED', message: t('auth.unauthorized', undefined, c) } }, 401);
|
|
16
|
+
const authorizeProject = async (c, projectId, mode) => {
|
|
17
|
+
// ADR-052: service-key — не пользователь проекта (`service:<keyId>` не
|
|
18
|
+
// участник), поэтому ролевую проверку по проекту для него не применяем:
|
|
19
|
+
// scope проверяет `requireScope`, а проекцию `allowedProjects` —
|
|
20
|
+
// `serviceProjectProjection`. Здесь — только граница проекции:
|
|
21
|
+
// проекта вне `allowedProjects` ключ не адресует (403).
|
|
22
|
+
const credential = getServiceCredential(c);
|
|
23
|
+
if (credential) {
|
|
24
|
+
const allowedProjects = credential.allowedProjects;
|
|
25
|
+
if (!allowedProjects || allowedProjects.includes(projectId))
|
|
26
|
+
return null;
|
|
27
|
+
return forbidden(c);
|
|
28
|
+
}
|
|
29
|
+
const user = await deps.auth.getCurrentUser(c);
|
|
30
|
+
if (!user)
|
|
31
|
+
return unauthorized(c);
|
|
32
|
+
const project = await deps.projectStore.load(projectId);
|
|
33
|
+
if (!project)
|
|
34
|
+
return projectNotFound(c);
|
|
35
|
+
const allowed = mode === 'read'
|
|
36
|
+
? projectAccess.canReadProject(c, project, user.id)
|
|
37
|
+
: projectAccess.canEditProjectContent(c, project, user.id);
|
|
38
|
+
return allowed ? null : forbidden(c);
|
|
39
|
+
};
|
|
40
|
+
const listVisibleProjectIds = async (c) => {
|
|
41
|
+
// ADR-052: service-key — область видимости = проекция `allowedProjects`
|
|
42
|
+
// (не задана — все проекты, как и у `isProjectAllowed`). Пустой список —
|
|
43
|
+
// не «всё», а «ничего»: fail-closed.
|
|
44
|
+
const credential = getServiceCredential(c);
|
|
45
|
+
if (credential)
|
|
46
|
+
return credential.allowedProjects ?? null;
|
|
47
|
+
const ctx = c;
|
|
48
|
+
const user = await deps.auth.getCurrentUser(c);
|
|
49
|
+
if (!user)
|
|
50
|
+
return [];
|
|
51
|
+
// `ADMIN`/`LEAD` — сквозной обзор (как `resolveElevated` в проектах).
|
|
52
|
+
if (deps.auth.isAdmin(ctx) || deps.auth.hasRole(ctx, 'LEAD'))
|
|
53
|
+
return null;
|
|
54
|
+
// Остальным — только проекты, доступные для чтения (PROP-133).
|
|
55
|
+
const projects = await deps.projectStore.list({
|
|
56
|
+
userId: user.id,
|
|
57
|
+
groups: groupsOf(c.get('user')),
|
|
58
|
+
});
|
|
59
|
+
return projects.map((project) => project.id);
|
|
60
|
+
};
|
|
61
|
+
return { authorizeProject, listVisibleProjectIds };
|
|
62
|
+
}
|
|
@@ -1,12 +1,18 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import type { ProjectRepository, SessionManager, McpManager, SkillService, SettingsRepository, McpRegistryRepository, EventBus } from '@itphx/synth-core';
|
|
3
|
+
import type { ProjectRepository, SessionManager, McpManager, SkillService, SettingsRepository, McpRegistryRepository, EventBus, SecurityAuditRepository } from '@itphx/synth-core';
|
|
4
|
+
import type { ExecutionProfileCatalog } from '@itphx/synth-core';
|
|
4
5
|
import type { WorktreeService } from '@itphx/synth-core';
|
|
5
|
-
import type {
|
|
6
|
+
import type { EventHub } from '../events/hub.js';
|
|
7
|
+
import type { ProfileStore, Project } from '@itphx/synth-shared';
|
|
6
8
|
/**
|
|
7
9
|
* ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
|
|
8
10
|
* чтобы их переиспользовали git-роуты core-фабрики (`authorizeProject`), а логика
|
|
9
11
|
* ролей не дублировалась.
|
|
12
|
+
*
|
|
13
|
+
* PROP-133 §1: предикат — **единственный** резолвер доступа
|
|
14
|
+
* (`resolveProjectAccess`); здесь только сборка принципала запроса. Своей копии
|
|
15
|
+
* правил (owner/`members`/`ADMIN`/`LEAD`) больше нет.
|
|
10
16
|
*/
|
|
11
17
|
export declare function createProjectAccess(kit: AuthKit): {
|
|
12
18
|
canManageProject: (c: {
|
|
@@ -28,10 +34,10 @@ export declare function createProjectAccess(kit: AuthKit): {
|
|
|
28
34
|
export declare function createProjectRoutes(kit: AuthKit, store: ProjectRepository, sessionManager: SessionManager, workspacesRoot: string,
|
|
29
35
|
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
30
36
|
mcpManager?: McpManager,
|
|
31
|
-
/** ADR-
|
|
37
|
+
/** ADR-126 §11: сид скиллов нового проекта (системные дефолты). */
|
|
32
38
|
skillService?: SkillService, settingsStore?: SettingsRepository, mcpRegistryStore?: McpRegistryRepository,
|
|
33
39
|
/**
|
|
34
|
-
* ADR-114: сервис worktree
|
|
40
|
+
* ADR-114: сервис worktree проекта — контур `/projects/:id/worktrees*`
|
|
35
41
|
* (список/создание/удаление/prune). Не задан — роутов нет.
|
|
36
42
|
*/
|
|
37
43
|
worktreeService?: WorktreeService,
|
|
@@ -40,4 +46,35 @@ worktreeService?: WorktreeService,
|
|
|
40
46
|
* `project.updated`/`project.deleted` в канал каждой сессии проекта.
|
|
41
47
|
* Не задана — публикации нет (поведение прежнее).
|
|
42
48
|
*/
|
|
43
|
-
eventBus?: EventBus
|
|
49
|
+
eventBus?: EventBus,
|
|
50
|
+
/**
|
|
51
|
+
* PROP-135 Ф6a: каталог профилей исполнения (`execution.remote`) —
|
|
52
|
+
* валидация `project.executor.profile`/`allowedProfiles` (PUT /:id).
|
|
53
|
+
* Не задан — проверка существования профиля пропускается.
|
|
54
|
+
*/
|
|
55
|
+
executionProfileCatalog?: ExecutionProfileCatalog,
|
|
56
|
+
/**
|
|
57
|
+
* PROP-135 (браузерный контур): каталог браузерных профилей — валидация
|
|
58
|
+
* `project.executor.browserProfile`/`allowedBrowserProfiles`.
|
|
59
|
+
*/
|
|
60
|
+
browserProfileCatalog?: ExecutionProfileCatalog,
|
|
61
|
+
/**
|
|
62
|
+
* PROP-133 §3.1: журнал изменений состояния доступа к проекту
|
|
63
|
+
* (`members`/`group_members`/`everyone_role`) — тот же порт
|
|
64
|
+
* `SecurityAuditRepository`, что у security-аудита (скоуп `projects`).
|
|
65
|
+
* Не задан — аудит не пишется (фича работает).
|
|
66
|
+
*/
|
|
67
|
+
securityAudit?: SecurityAuditRepository,
|
|
68
|
+
/**
|
|
69
|
+
* ADR-140 Ф2: хаб подписок WS/SSE — при смене состояния доступа к проекту
|
|
70
|
+
* подписки уже подключённых клиентов пересчитываются (доступ применяется
|
|
71
|
+
* к тем, кто подключён **до** изменения).
|
|
72
|
+
* Не задан — пересчёта нет (подписки остаются прежними).
|
|
73
|
+
*/
|
|
74
|
+
eventHub?: EventHub,
|
|
75
|
+
/**
|
|
76
|
+
* ADR-140 Ф3: профили пользователей — проверка получателя при передаче
|
|
77
|
+
* владения (`POST /:id/transfer`): цель должна существовать и быть активна.
|
|
78
|
+
* Не задан — передача владения невозможна (цель не проверяется).
|
|
79
|
+
*/
|
|
80
|
+
profilesStore?: ProfileStore): Hono;
|
package/dist/routes/projects.js
CHANGED
|
@@ -1,26 +1,60 @@
|
|
|
1
1
|
import { createProjectRoutes as createCoreProjectRoutes, resolveProjectSkillSeed } from '@itphx/synth-core';
|
|
2
|
-
import {
|
|
2
|
+
import { canManageWithProjectRole, canWriteWithProjectRole, resolveProjectAccess, } from '@itphx/synth-shared';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
|
+
import { projectPrincipalOf, groupsOf } from '../lib/project-principal.js';
|
|
5
|
+
import { AUTH_IDENTITY_PROVIDER } from '../lib/principal-identity.js';
|
|
4
6
|
/**
|
|
5
7
|
* ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
|
|
6
8
|
* чтобы их переиспользовали git-роуты core-фабрики (`authorizeProject`), а логика
|
|
7
9
|
* ролей не дублировалась.
|
|
10
|
+
*
|
|
11
|
+
* PROP-133 §1: предикат — **единственный** резолвер доступа
|
|
12
|
+
* (`resolveProjectAccess`); здесь только сборка принципала запроса. Своей копии
|
|
13
|
+
* правил (owner/`members`/`ADMIN`/`LEAD`) больше нет.
|
|
8
14
|
*/
|
|
9
15
|
export function createProjectAccess(kit) {
|
|
10
|
-
/** ADR-071 §2.4: owner проекта или глобальные LEAD/ADMIN (через AuthKit). */
|
|
11
|
-
const canManageProject = (c, project, userId) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
12
|
-
|| (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD'))
|
|
13
|
-
|| project.ownerId === userId
|
|
14
|
-
|| project.members?.[userId] === ProjectRole.OWNER;
|
|
15
|
-
/** D5: owner / EDITOR / глобальные LEAD/ADMIN — редактирование контента проекта. */
|
|
16
|
-
const canEditProjectContent = (c, project, userId) => canManageProject(c, project, userId)
|
|
17
|
-
|| project.members?.[userId] === ProjectRole.EDITOR;
|
|
18
16
|
/**
|
|
19
|
-
*
|
|
20
|
-
*
|
|
17
|
+
* PROP-133 §1: принципал запроса — пользователь + роли инстанса (+ группы, Ф2).
|
|
18
|
+
*
|
|
19
|
+
* Пользователь берётся из контекста (`c.get('user')` — тот же `User`, что
|
|
20
|
+
* кладёт `attachUser`/`requireAuth` и что отдаёт `kit.getCurrentUser`); если
|
|
21
|
+
* пользователя в контексте нет (мок-AuthKit в тестах) — роли инстанса
|
|
22
|
+
* определяются через AuthKit (`isAdmin`/`hasRole` — те же проверки, что и
|
|
23
|
+
* прежде). Проверка остаётся **синхронной**: контракт core-фабрики
|
|
24
|
+
* (`opts.canManage`/`canEditContent`/`canRead`) — sync.
|
|
21
25
|
*/
|
|
22
|
-
const
|
|
23
|
-
|
|
26
|
+
const principalOf = (c, userId) => {
|
|
27
|
+
const user = c.get('user');
|
|
28
|
+
const roles = user?.roles ? [...user.roles] : [];
|
|
29
|
+
if (roles.length === 0) {
|
|
30
|
+
if (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
31
|
+
roles.push('ADMIN');
|
|
32
|
+
else if (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD'))
|
|
33
|
+
roles.push('LEAD');
|
|
34
|
+
}
|
|
35
|
+
return projectPrincipalOf(user, userId, roles);
|
|
36
|
+
};
|
|
37
|
+
/** PROP-133 §1: решение по доступу к проекту для принципала запроса. */
|
|
38
|
+
const accessOf = (c, project, userId) => resolveProjectAccess(project, principalOf(c, userId));
|
|
39
|
+
/**
|
|
40
|
+
* ADR-076 §T4 / PROP-133 §1: управление доступом к проекту — автор проекта,
|
|
41
|
+
* участник с ролью `owner`, а также глобальные `LEAD`/`ADMIN` (сквозной
|
|
42
|
+
* обзор). Гранты по группе и режим «всем пользователям» роль `owner` **не**
|
|
43
|
+
* дают (см. `canManageWithProjectRole`).
|
|
44
|
+
*/
|
|
45
|
+
const canManageProject = (c, project, userId) => canManageWithProjectRole(accessOf(c, project, userId).role);
|
|
46
|
+
/**
|
|
47
|
+
* D5 / PROP-133 §1: редактирование контента проекта — `owner`/`editor`
|
|
48
|
+
* (в т.ч. грант по группе и режим «всем пользователям» с ролью `editor`).
|
|
49
|
+
* `viewer` записи не даёт (инвариант 21).
|
|
50
|
+
*/
|
|
51
|
+
const canEditProjectContent = (c, project, userId) => canWriteWithProjectRole(accessOf(c, project, userId).role);
|
|
52
|
+
/**
|
|
53
|
+
* ADR-089 / PROP-133 §1: чтение проекта по id — по роли доступа (владелец,
|
|
54
|
+
* участник, грант по группе, режим «всем пользователям»; `LEAD`/`ADMIN` —
|
|
55
|
+
* сквозной обзор). Не расширяет права на редактирование.
|
|
56
|
+
*/
|
|
57
|
+
const canReadProject = (c, project, userId) => accessOf(c, project, userId).read;
|
|
24
58
|
return { canManageProject, canEditProjectContent, canReadProject };
|
|
25
59
|
}
|
|
26
60
|
/**
|
|
@@ -32,10 +66,10 @@ export function createProjectAccess(kit) {
|
|
|
32
66
|
export function createProjectRoutes(kit, store, sessionManager, workspacesRoot,
|
|
33
67
|
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
34
68
|
mcpManager,
|
|
35
|
-
/** ADR-
|
|
69
|
+
/** ADR-126 §11: сид скиллов нового проекта (системные дефолты). */
|
|
36
70
|
skillService, settingsStore, mcpRegistryStore,
|
|
37
71
|
/**
|
|
38
|
-
* ADR-114: сервис worktree
|
|
72
|
+
* ADR-114: сервис worktree проекта — контур `/projects/:id/worktrees*`
|
|
39
73
|
* (список/создание/удаление/prune). Не задан — роутов нет.
|
|
40
74
|
*/
|
|
41
75
|
worktreeService,
|
|
@@ -44,15 +78,66 @@ worktreeService,
|
|
|
44
78
|
* `project.updated`/`project.deleted` в канал каждой сессии проекта.
|
|
45
79
|
* Не задана — публикации нет (поведение прежнее).
|
|
46
80
|
*/
|
|
47
|
-
eventBus
|
|
81
|
+
eventBus,
|
|
82
|
+
/**
|
|
83
|
+
* PROP-135 Ф6a: каталог профилей исполнения (`execution.remote`) —
|
|
84
|
+
* валидация `project.executor.profile`/`allowedProfiles` (PUT /:id).
|
|
85
|
+
* Не задан — проверка существования профиля пропускается.
|
|
86
|
+
*/
|
|
87
|
+
executionProfileCatalog,
|
|
88
|
+
/**
|
|
89
|
+
* PROP-135 (браузерный контур): каталог браузерных профилей — валидация
|
|
90
|
+
* `project.executor.browserProfile`/`allowedBrowserProfiles`.
|
|
91
|
+
*/
|
|
92
|
+
browserProfileCatalog,
|
|
93
|
+
/**
|
|
94
|
+
* PROP-133 §3.1: журнал изменений состояния доступа к проекту
|
|
95
|
+
* (`members`/`group_members`/`everyone_role`) — тот же порт
|
|
96
|
+
* `SecurityAuditRepository`, что у security-аудита (скоуп `projects`).
|
|
97
|
+
* Не задан — аудит не пишется (фича работает).
|
|
98
|
+
*/
|
|
99
|
+
securityAudit,
|
|
100
|
+
/**
|
|
101
|
+
* ADR-140 Ф2: хаб подписок WS/SSE — при смене состояния доступа к проекту
|
|
102
|
+
* подписки уже подключённых клиентов пересчитываются (доступ применяется
|
|
103
|
+
* к тем, кто подключён **до** изменения).
|
|
104
|
+
* Не задан — пересчёта нет (подписки остаются прежними).
|
|
105
|
+
*/
|
|
106
|
+
eventHub,
|
|
107
|
+
/**
|
|
108
|
+
* ADR-140 Ф3: профили пользователей — проверка получателя при передаче
|
|
109
|
+
* владения (`POST /:id/transfer`): цель должна существовать и быть активна.
|
|
110
|
+
* Не задан — передача владения невозможна (цель не проверяется).
|
|
111
|
+
*/
|
|
112
|
+
profilesStore) {
|
|
48
113
|
const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
|
|
49
114
|
return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
|
|
50
115
|
canManage: canManageProject,
|
|
51
116
|
canEditContent: canEditProjectContent,
|
|
52
117
|
canRead: canReadProject,
|
|
118
|
+
// ADR-140 Ф3: передача владения — текущий владелец или `ADMIN`.
|
|
119
|
+
// `LEAD`/участники/`EDITOR` — нет (передача владения ≠ управление
|
|
120
|
+
// содержимым).
|
|
121
|
+
canTransfer: (c, project, userId) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
122
|
+
|| project.ownerId === userId,
|
|
123
|
+
// ADR-140 Ф3: получатель должен существовать и быть активным.
|
|
124
|
+
// Каталог отдаёт **ACL-id** (auth-идентичность = OIDC `sub`/debug-id,
|
|
125
|
+
// ADR-140), поэтому сначала ищем профиль по идентичности, затем — по
|
|
126
|
+
// `profile.id` (legacy-профиль без привязки, ещё не логинившийся).
|
|
127
|
+
resolveTransferTarget: async (id) => {
|
|
128
|
+
if (!profilesStore)
|
|
129
|
+
return null;
|
|
130
|
+
const profile = (await profilesStore.findProfileByExternalId(AUTH_IDENTITY_PROVIDER, id))
|
|
131
|
+
?? (await profilesStore.loadProfile(id));
|
|
132
|
+
return profile ? { id, active: profile.isActive !== false } : null;
|
|
133
|
+
},
|
|
53
134
|
// ADR-089: ADMIN/LEAD — сквозная видимость всех проектов (защита от мок-AuthKit).
|
|
54
135
|
resolveElevated: (c) => (typeof kit.isAdmin === 'function' && kit.isAdmin(c))
|
|
55
136
|
|| (typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD')),
|
|
137
|
+
// PROP-133 §1/§6: группы принципала — грант по группе должен попадать и
|
|
138
|
+
// в список проектов (иначе проект читается по `GET /:id`, но в списке
|
|
139
|
+
// отсутствует). Нет поля/не массив/пусто — групп нет (fail-closed).
|
|
140
|
+
resolveViewerGroups: (c) => groupsOf(c.get('user')),
|
|
56
141
|
getCurrentUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
57
142
|
messages: {
|
|
58
143
|
nameRequired: (c) => t('errors.validation.nameRequired', undefined, c),
|
|
@@ -61,6 +146,15 @@ eventBus) {
|
|
|
61
146
|
},
|
|
62
147
|
autoProvisionWorkspace: true,
|
|
63
148
|
getMcpServers: () => Object.keys(mcpManager?.getConfig() ?? {}),
|
|
149
|
+
// PROP-125: источник сервера (`local`/`server`) — бейдж «серверный» в UI.
|
|
150
|
+
// У backend удалённых записей нет (сервер отдаёт состав сам) → `local`,
|
|
151
|
+
// но контракт ответа единый с core.
|
|
152
|
+
getMcpServerSources: () => Object.fromEntries(Object.keys(mcpManager?.getConfig() ?? {}).map((name) => [
|
|
153
|
+
name,
|
|
154
|
+
(typeof mcpManager?.isRemoteServer === 'function' && mcpManager.isRemoteServer(name))
|
|
155
|
+
? 'server'
|
|
156
|
+
: 'local',
|
|
157
|
+
])),
|
|
64
158
|
getProjectSeeds: async () => {
|
|
65
159
|
const defaultMcpServers = mcpRegistryStore
|
|
66
160
|
? await mcpRegistryStore.toDefaultServers()
|
|
@@ -79,7 +173,7 @@ eventBus) {
|
|
|
79
173
|
sessionManager,
|
|
80
174
|
getWorkspacesRoot: () => workspacesRoot,
|
|
81
175
|
getOutsideRootPolicy: () => 'deny',
|
|
82
|
-
// ADR-114: контур worktree
|
|
176
|
+
// ADR-114: контур worktree проекта.
|
|
83
177
|
...(worktreeService ? { worktrees: worktreeService } : {}),
|
|
84
178
|
// ADR-118 §4: изменение/удаление проекта — в канал каждой сессии проекта.
|
|
85
179
|
...(eventBus
|
|
@@ -90,10 +184,27 @@ eventBus) {
|
|
|
90
184
|
for (const s of sessions) {
|
|
91
185
|
eventBus.publish(s.id, kind === 'deleted' ? 'project.deleted' : 'project.updated', {
|
|
92
186
|
project_id: projectId,
|
|
187
|
+
// ADR-140 Ф2: вид изменения — UI/подписки видят, что именно
|
|
188
|
+
// изменилось (в т.ч. состояние доступа — `access`).
|
|
189
|
+
kind,
|
|
93
190
|
});
|
|
94
191
|
}
|
|
192
|
+
// ADR-140 Ф2: изменилось состояние доступа — пересчитать
|
|
193
|
+
// подписки уже подключённых клиентов (иначе новый участник не
|
|
194
|
+
// получит события сессий проекта, а потерявший — продолжит
|
|
195
|
+
// получать).
|
|
196
|
+
if (kind === 'access') {
|
|
197
|
+
await eventHub?.resyncAllClients();
|
|
198
|
+
}
|
|
95
199
|
},
|
|
96
200
|
}
|
|
97
201
|
: {}),
|
|
202
|
+
// PROP-135 Ф6a: каталог профилей исполнения — проверка
|
|
203
|
+
// `project.executor.profile`/`allowedProfiles` в PUT /:id.
|
|
204
|
+
...(executionProfileCatalog ? { executionProfileCatalog } : {}),
|
|
205
|
+
// PROP-135 (браузерный контур): каталог браузерных профилей проекта.
|
|
206
|
+
...(browserProfileCatalog ? { browserProfileCatalog } : {}),
|
|
207
|
+
// PROP-133 §3.1: аудит изменения состояния доступа к проекту.
|
|
208
|
+
...(securityAudit ? { securityAudit } : {}),
|
|
98
209
|
});
|
|
99
210
|
}
|
|
@@ -13,7 +13,10 @@ export interface ProviderRoutesEgressOptions {
|
|
|
13
13
|
}
|
|
14
14
|
/**
|
|
15
15
|
* Backend-обёртка над core-фабрикой провайдеров: добавляет только RBAC
|
|
16
|
-
* (мутации — ADMIN), rate limit на тест подключения и
|
|
16
|
+
* (мутации — ADMIN), rate limit на тест подключения и на `fetch-icon`.
|
|
17
|
+
*
|
|
18
|
+
* Сами роуты (в т.ч. `POST /fetch-icon`) — в core-фабрике; обёртка лишь
|
|
19
|
+
* передаёт guard'ы, rate limit, egress-политику/журнал и тексты (i18n).
|
|
17
20
|
*
|
|
18
21
|
* URL провайдера проверяется общей egress-политикой (`egress.tools`, live),
|
|
19
22
|
* без собственной копии списка приватных диапазонов.
|
package/dist/routes/providers.js
CHANGED
|
@@ -1,119 +1,37 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
|
-
import { createProviderRoutes as createCoreProviderRoutes
|
|
2
|
+
import { createProviderRoutes as createCoreProviderRoutes } from '@itphx/synth-core';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
4
|
import { createRateLimiter } from '../middleware/rate-limiter.js';
|
|
5
5
|
/**
|
|
6
6
|
* Backend-обёртка над core-фабрикой провайдеров: добавляет только RBAC
|
|
7
|
-
* (мутации — ADMIN), rate limit на тест подключения и
|
|
7
|
+
* (мутации — ADMIN), rate limit на тест подключения и на `fetch-icon`.
|
|
8
|
+
*
|
|
9
|
+
* Сами роуты (в т.ч. `POST /fetch-icon`) — в core-фабрике; обёртка лишь
|
|
10
|
+
* передаёт guard'ы, rate limit, egress-политику/журнал и тексты (i18n).
|
|
8
11
|
*
|
|
9
12
|
* URL провайдера проверяется общей egress-политикой (`egress.tools`, live),
|
|
10
13
|
* без собственной копии списка приватных диапазонов.
|
|
11
14
|
*/
|
|
12
15
|
export function createProviderRoutes(kit, store, providerCache, egress = {}, getDefaultModel) {
|
|
13
16
|
const app = new Hono();
|
|
14
|
-
//
|
|
15
|
-
//
|
|
16
|
-
app.post('/fetch-icon', kit.requireAdmin, createRateLimiter(10, 60_000), async (c) => {
|
|
17
|
-
const body = await c.req.json().catch(() => ({}));
|
|
18
|
-
const url = body.url?.trim();
|
|
19
|
-
if (!url) {
|
|
20
|
-
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.urlRequired', undefined, c) } }, 400);
|
|
21
|
-
}
|
|
22
|
-
let origin;
|
|
23
|
-
try {
|
|
24
|
-
origin = new URL(url).origin;
|
|
25
|
-
}
|
|
26
|
-
catch {
|
|
27
|
-
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUrl', undefined, c) } }, 400);
|
|
28
|
-
}
|
|
29
|
-
// SSRF-защита: resolved egress-политика (включая exceptions и DNS-резолв).
|
|
30
|
-
const policy = egress.resolvePolicy ? await egress.resolvePolicy() : PRIVATE_EGRESS_POLICY;
|
|
31
|
-
const networkCheck = await checkEgressUrl(origin, policy);
|
|
32
|
-
if (!networkCheck.allowed) {
|
|
33
|
-
// Отказ до HTTP-запроса — фиксируем в журнале egress (ответ остаётся 400).
|
|
34
|
-
if (egress.log) {
|
|
35
|
-
const target = sanitizeEgressTarget(origin);
|
|
36
|
-
try {
|
|
37
|
-
await egress.log({
|
|
38
|
-
scope: 'providers',
|
|
39
|
-
host: target.host,
|
|
40
|
-
url: target.url,
|
|
41
|
-
method: 'GET',
|
|
42
|
-
status: 'blocked',
|
|
43
|
-
reason: networkCheck.reason,
|
|
44
|
-
...(networkCheck.matchedRule ? { matchedRule: networkCheck.matchedRule } : {}),
|
|
45
|
-
});
|
|
46
|
-
}
|
|
47
|
-
catch (err) {
|
|
48
|
-
console.warn(`[providers] egress log: ${err instanceof Error ? err.message : String(err)}`);
|
|
49
|
-
}
|
|
50
|
-
}
|
|
51
|
-
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUrl', undefined, c) } }, 400);
|
|
52
|
-
}
|
|
53
|
-
try {
|
|
54
|
-
const iconUrl = `${origin}/favicon.ico`;
|
|
55
|
-
const controller = new AbortController();
|
|
56
|
-
const timer = setTimeout(() => controller.abort(), 5000);
|
|
57
|
-
const resp = await fetchWithEgressGuard(iconUrl, {
|
|
58
|
-
signal: controller.signal,
|
|
59
|
-
headers: { Accept: 'image/*' },
|
|
60
|
-
}, { policy, scope: 'providers', log: egress.log });
|
|
61
|
-
clearTimeout(timer);
|
|
62
|
-
if (resp.ok && resp.headers.get('content-type')?.includes('image')) {
|
|
63
|
-
const buffer = await resp.arrayBuffer();
|
|
64
|
-
const ct = resp.headers.get('content-type') || 'image/x-icon';
|
|
65
|
-
const b64 = Buffer.from(buffer).toString('base64');
|
|
66
|
-
return c.json({ icon: `data:${ct};base64,${b64}`, source: iconUrl });
|
|
67
|
-
}
|
|
68
|
-
// Попробовать найти <link rel="icon"> в HTML
|
|
69
|
-
const htmlController = new AbortController();
|
|
70
|
-
const htmlTimer = setTimeout(() => htmlController.abort(), 5000);
|
|
71
|
-
const htmlResp = await fetchWithEgressGuard(origin, {
|
|
72
|
-
signal: htmlController.signal,
|
|
73
|
-
headers: { Accept: 'text/html' },
|
|
74
|
-
}, { policy, scope: 'providers', log: egress.log });
|
|
75
|
-
clearTimeout(htmlTimer);
|
|
76
|
-
if (htmlResp.ok) {
|
|
77
|
-
const html = await htmlResp.text();
|
|
78
|
-
const match = html.match(/<link[^>]*rel=["'](?:shortcut\s+)?icon["'][^>]*href=["']([^"']+)["']/i)
|
|
79
|
-
|| html.match(/<link[^>]*href=["']([^"']+)["'][^>]*rel=["'](?:shortcut\s+)?icon["']/i);
|
|
80
|
-
if (match) {
|
|
81
|
-
const href = match[1];
|
|
82
|
-
if (href) {
|
|
83
|
-
let resolved = href;
|
|
84
|
-
if (resolved.startsWith('/'))
|
|
85
|
-
resolved = `${origin}${resolved}`;
|
|
86
|
-
else if (!resolved.startsWith('http'))
|
|
87
|
-
resolved = `${origin}/${resolved}`;
|
|
88
|
-
const iconResp = await fetchWithEgressGuard(resolved, {
|
|
89
|
-
signal: AbortSignal.timeout(5000),
|
|
90
|
-
headers: { Accept: 'image/*' },
|
|
91
|
-
}, { policy, scope: 'providers', log: egress.log });
|
|
92
|
-
if (iconResp.ok) {
|
|
93
|
-
const buffer = await iconResp.arrayBuffer();
|
|
94
|
-
const ct = iconResp.headers.get('content-type') || 'image/x-icon';
|
|
95
|
-
const b64 = Buffer.from(buffer).toString('base64');
|
|
96
|
-
return c.json({ icon: `data:${ct};base64,${b64}`, source: resolved });
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
return c.json({ icon: null, error: t('errors.notFound.favicon', undefined, c) });
|
|
102
|
-
}
|
|
103
|
-
catch (err) {
|
|
104
|
-
return c.json({
|
|
105
|
-
icon: null,
|
|
106
|
-
error: err instanceof Error ? err.message : t('errors.faviconFetchError', undefined, c),
|
|
107
|
-
});
|
|
108
|
-
}
|
|
109
|
-
});
|
|
110
|
-
// Общая логика (GET /, POST /, GET/DELETE /:name, POST /:name/test) — в core.
|
|
17
|
+
// Общая логика (GET /, POST /, GET/DELETE /:name, POST /:name/test,
|
|
18
|
+
// POST /fetch-icon) — в core.
|
|
111
19
|
app.route('/', createCoreProviderRoutes({ requireAuth: kit.requireAuth }, store, providerCache, {
|
|
112
20
|
writeGuard: kit.requireAdmin,
|
|
113
21
|
detailGuard: kit.requireAdmin,
|
|
114
22
|
testEnabled: true,
|
|
115
23
|
testGuard: kit.requireAdmin,
|
|
116
24
|
testMiddleware: [createRateLimiter(5, 60_000)],
|
|
25
|
+
// POST /api/v2/providers/fetch-icon — favicon домена (admin).
|
|
26
|
+
// Статический сегмент `/fetch-icon` core-фабрика регистрирует ДО
|
|
27
|
+
// параметрических (`/:name`).
|
|
28
|
+
fetchIcon: {
|
|
29
|
+
enabled: true,
|
|
30
|
+
guard: kit.requireAdmin,
|
|
31
|
+
middleware: [createRateLimiter(10, 60_000)],
|
|
32
|
+
resolvePolicy: egress.resolvePolicy,
|
|
33
|
+
log: egress.log,
|
|
34
|
+
},
|
|
117
35
|
getDefaultModel,
|
|
118
36
|
messages: {
|
|
119
37
|
nameRequired: (c) => t('errors.validation.nameRequired', undefined, c),
|
|
@@ -122,6 +40,8 @@ export function createProviderRoutes(kit, store, providerCache, egress = {}, get
|
|
|
122
40
|
urlRequired: (c) => t('errors.validation.urlRequired', undefined, c),
|
|
123
41
|
urlInvalid: (c) => t('errors.validation.invalidUrl', undefined, c),
|
|
124
42
|
connectionError: (c) => t('errors.connectionError', undefined, c),
|
|
43
|
+
faviconNotFound: (c) => t('errors.notFound.favicon', undefined, c),
|
|
44
|
+
faviconFetchError: (c) => t('errors.faviconFetchError', undefined, c),
|
|
125
45
|
},
|
|
126
46
|
}));
|
|
127
47
|
return app;
|
package/dist/routes/queue.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
3
|
import type { SessionManager, QueueProcessorManager, ChatOrchestrator, EventBus, ProjectRepository } from '@itphx/synth-core';
|
|
4
|
+
import type { QueueRoutesOptions } from '@itphx/synth-core';
|
|
4
5
|
import type { Message } from '@itphx/synth-shared';
|
|
5
6
|
/**
|
|
6
7
|
* Backend-обёртка над core-фабрикой очереди: добавляет i18n-сообщения и RBAC
|
|
@@ -9,4 +10,9 @@ import type { Message } from '@itphx/synth-shared';
|
|
|
9
10
|
*/
|
|
10
11
|
export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, projectStore?: ProjectRepository,
|
|
11
12
|
/** ADR-036: обфускация user-сообщения (та же, что у `POST /sessions/:id/prompt`). */
|
|
12
|
-
obfuscate?: (sessionId: string, message: Message) => Promise<Message
|
|
13
|
+
obfuscate?: (sessionId: string, message: Message) => Promise<Message>,
|
|
14
|
+
/**
|
|
15
|
+
* ADR-111 §detach: авто-перевод блокирующих прогонов при вклинивании из
|
|
16
|
+
* очереди (`/queue/:sessionId/steer`) — тот же шов, что у prompt-роута.
|
|
17
|
+
*/
|
|
18
|
+
autoDetachOnSteer?: QueueRoutesOptions['autoDetachOnSteer']): Hono;
|
package/dist/routes/queue.js
CHANGED
|
@@ -9,7 +9,12 @@ import { createProjectAccess } from './projects.js';
|
|
|
9
9
|
*/
|
|
10
10
|
export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, processMessage, projectStore,
|
|
11
11
|
/** ADR-036: обфускация user-сообщения (та же, что у `POST /sessions/:id/prompt`). */
|
|
12
|
-
obfuscate
|
|
12
|
+
obfuscate,
|
|
13
|
+
/**
|
|
14
|
+
* ADR-111 §detach: авто-перевод блокирующих прогонов при вклинивании из
|
|
15
|
+
* очереди (`/queue/:sessionId/steer`) — тот же шов, что у prompt-роута.
|
|
16
|
+
*/
|
|
17
|
+
autoDetachOnSteer) {
|
|
13
18
|
const app = new Hono();
|
|
14
19
|
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
15
20
|
// ADR-071 §2.4: владелец сессии — обычный пользователь.
|
|
@@ -42,6 +47,7 @@ obfuscate) {
|
|
|
42
47
|
: canEditProjectContent(ctx, project, userId);
|
|
43
48
|
},
|
|
44
49
|
...(obfuscate ? { obfuscate } : {}),
|
|
50
|
+
...(autoDetachOnSteer ? { autoDetachOnSteer } : {}),
|
|
45
51
|
}));
|
|
46
52
|
return app;
|
|
47
53
|
}
|