@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
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Managed-доступ к расписаниям планировщика (PROP-141, этап 5 B-1).
3
+ *
4
+ * Правило доступа — **общее** для проектных ресурсов автоматизаций: вынесено
5
+ * в `routes/project-access.ts` (`createBackendProjectAccess`) и переиспользуется
6
+ * таймерами (`routes/timers.ts`) — копии правила нет.
7
+ *
8
+ * | Актор | чтение (`GET /`, `GET /:id/jobs`) | мутации (`POST`/`PUT`/`DELETE`/`run`) |
9
+ * |------------------------------|-----------------------------------|----------------------------------------|
10
+ * | владелец проекта | да | да |
11
+ * | участник `EDITOR` | да | да |
12
+ * | участник `VIEWER` | да | **403** (`VIEWER` не мутирует) |
13
+ * | `LEAD`/`ADMIN` | да (сквозной обзор) | да |
14
+ * | чужой `USER` | **не видно в списке**, 403/404 | 403/404 |
15
+ *
16
+ * Прежний `requireAdmin` на все мутации снят (PROP-141, решение владельца
17
+ * 2026-11-17): EDITOR/OWNER управляют автоматизациями своего проекта.
18
+ *
19
+ * **service-key (ADR-052)** — не пользователь проекта (`service:<keyId>` не
20
+ * участник), поэтому ролевая проверка по проекту к нему не применяется:
21
+ * scope проверяет `requireScope`, проекцию `allowedProjects` —
22
+ * `serviceProjectProjection`. Здесь service-key ограничен своей проекцией:
23
+ * список — по `allowedProjects` (не задана — все проекты, пустой список —
24
+ * ничего), а проект вне проекции — 403.
25
+ */
26
+ import type { ProjectRepository } from '@itphx/synth-core';
27
+ import type { AuthKit } from '../auth/middleware.js';
28
+ import type { BackendProjectAccess } from './project-access.js';
29
+ export interface BackendScheduleAccessDeps {
30
+ /** AuthKit backend (OIDC/RBAC). */
31
+ auth: AuthKit;
32
+ /** Порт проектов — по нему резолвятся права на проект расписания. */
33
+ projectStore: ProjectRepository;
34
+ }
35
+ /**
36
+ * Реализации опций core-фабрики расписаний (`createSchedulerRoutes`):
37
+ * граничная проверка прав на проект и скоуп видимости списка.
38
+ */
39
+ export type BackendScheduleAccess = BackendProjectAccess;
40
+ /**
41
+ * Собрать managed-правило доступа к расписаниям.
42
+ *
43
+ * Правило — общее для автоматизаций (`createBackendProjectAccess`); здесь
44
+ * только привязка к зависимостям расписаний.
45
+ */
46
+ export declare function createBackendScheduleAccess(deps: BackendScheduleAccessDeps): BackendScheduleAccess;
@@ -0,0 +1,10 @@
1
+ import { createBackendProjectAccess } from './project-access.js';
2
+ /**
3
+ * Собрать managed-правило доступа к расписаниям.
4
+ *
5
+ * Правило — общее для автоматизаций (`createBackendProjectAccess`); здесь
6
+ * только привязка к зависимостям расписаний.
7
+ */
8
+ export function createBackendScheduleAccess(deps) {
9
+ return createBackendProjectAccess(deps);
10
+ }
@@ -15,15 +15,21 @@ import type { BlobRefRepository, BlobStore } from '@itphx/synth-core';
15
15
  import type { AttachmentThumbnailProvider } from '@itphx/synth-core';
16
16
  import type { AttachmentsConfig, StickyNotesLimits } from '@itphx/synth-shared';
17
17
  import type { QuestionService } from '@itphx/synth-core';
18
+ import type { SessionMoveService } from '@itphx/synth-core';
18
19
  import type { WorktreeService } from '@itphx/synth-core';
19
20
  import type { BackgroundRunService } from '@itphx/synth-core';
20
21
  import type { ApprovalRegistry } from '@itphx/synth-core';
22
+ import type { ExecutionProfileCatalog } from '@itphx/synth-core';
23
+ import type { SnippetService } from '@itphx/synth-core';
24
+ import type { ScriptService, CommandAuditLog } from '@itphx/synth-core';
25
+ import type { PermissionConfig } from '@itphx/synth-shared';
21
26
  /**
22
27
  * Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
23
- * backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
24
- * оптимизация контекста). Общая логика (список/создание/чтение/изменение/
28
+ * backend-специфичные роуты (MCP-скоуп сессии и секреты — более строгая политика
29
+ * managed, export/import, отладка). Общая логика (список/создание/чтение/изменение/
25
30
  * удаление, status/prompt/stats, заметки (`notes`), очередь+SSE, children/tree/
26
- * fork, references, merge) — в `createSessionRoutes` из `@itphx/synth-core`.
31
+ * fork, references, merge, оптимизация контекста, core-версии MCP-скоупа и
32
+ * секретов для standalone/гибрида) — в `createSessionRoutes` из `@itphx/synth-core`.
27
33
  *
28
34
  * RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
29
35
  * `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
@@ -32,7 +38,9 @@ import type { ApprovalRegistry } from '@itphx/synth-core';
32
38
  *
33
39
  * Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
34
40
  * до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
35
- * (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
41
+ * (ADMIN|AUDITOR — карта обфускации). В core-фабрике есть версии этих маршрутов
42
+ * для standalone/гибрида; здесь они регистрируются раньше и потому выигрывают,
43
+ * сохраняя прежнюю политику. `/:id/export` — ПОД guard'ом: доступ к
36
44
  * сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
37
45
  * route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
38
46
  * доступа нет (инвариант 16).
@@ -62,7 +70,7 @@ memory?: {
62
70
  */
63
71
  questionService?: QuestionService,
64
72
  /**
65
- * ADR-114: сервис worktree'ов — привязка сессии к worktree
73
+ * ADR-114: сервис worktree — привязка сессии к worktree
66
74
  * (`PATCH /api/v2/sessions/:id { worktreeId }`).
67
75
  *
68
76
  * Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
@@ -107,4 +115,57 @@ getStickyNoteLimits?: () => StickyNotesLimits,
107
115
  llmAvailability?: {
108
116
  isProviderEnabled?: (name: string) => boolean | undefined;
109
117
  isModelEnabled?: (provider: string, model: string) => boolean | undefined;
110
- }): Hono;
118
+ },
119
+ /**
120
+ * Лимит тяжёлых операций ресурса сессий (`limits.sessionOpsPerMinute`,
121
+ * import/export/fork/merge) — live-геттер. Не задан — 10 (прежнее поведение).
122
+ * `0` — без ограничения; значение применяется без рестарта.
123
+ */
124
+ getSessionOpsPerMinute?: () => number,
125
+ /**
126
+ * PROP-135 Ф6a: каталог профилей исполнения (`execution.remote`) —
127
+ * валидация `settings.executorProfile` в PATCH /:id. Не задан — проверка
128
+ * существования профиля пропускается (поведение прежнее).
129
+ */
130
+ executionProfileCatalog?: ExecutionProfileCatalog,
131
+ /**
132
+ * PROP-135 (браузерный контур): каталог браузерных профилей — валидация
133
+ * `settings.browserProfile` в PATCH /:id.
134
+ */
135
+ browserProfileCatalog?: ExecutionProfileCatalog,
136
+ /**
137
+ * ADR-126 §4: сервис сниппетов (`#`) — раскрытие `#токен` в пользовательском
138
+ * тексте на входе промпта (до очереди). Не задан — раскрытия нет.
139
+ */
140
+ snippetService?: SnippetService,
141
+ /**
142
+ * ADR-126 §4: абсолютный рабочий каталог проекта по id — для project-уровня
143
+ * сниппетов. Не задан — workspace берётся из карточки проекта как есть.
144
+ */
145
+ resolveProjectWorkspace?: (projectId: string) => Promise<string | undefined>,
146
+ /**
147
+ * ADR-126 §5: сервис реестра скриптов проекта (`!`-запуск) — HTTP-контур
148
+ * `/api/v2/sessions/:id/scripts*`. Не задан — контура нет.
149
+ */
150
+ scriptService?: ScriptService,
151
+ /**
152
+ * ADR-126 §5: правила прав инстанса — fallback для правила
153
+ * `permission.rules.script` (собственные правила сессии важнее).
154
+ */
155
+ permissionConfig?: PermissionConfig,
156
+ /**
157
+ * ADR-136: журнал исполнений команд — запись `script.run` (только
158
+ * метаданные).
159
+ */
160
+ commandAudit?: CommandAuditLog,
161
+ /**
162
+ * ADR-126 §5: рабочий каталог по умолчанию — фоллбек для сессии **без
163
+ * проекта** (`.synth/scripts` из default workspace, как у `!`-запуска).
164
+ */
165
+ defaultWorkingDir?: string,
166
+ /**
167
+ * PROP-141 (Часть D): сервис переноса сессии между проектами (единый шов:
168
+ * блокеры, согласие `move_consent`, порядок эффектов). Не задан — перенос
169
+ * между проектами недоступен (`PATCH { project_id }` → 500).
170
+ */
171
+ moveService?: SessionMoveService): Hono;