@itphx/synth-backend 0.10.1 → 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/bootstrap.d.ts +2 -2
- package/dist/app/deps.d.ts +77 -33
- package/dist/app/deps.js +969 -102
- package/dist/app/listen.d.ts +13 -2
- package/dist/app/listen.js +138 -10
- package/dist/app/mount-routes.d.ts +16 -3
- package/dist/app/mount-routes.js +625 -32
- package/dist/app.d.ts +42 -7
- package/dist/app.js +149 -12
- package/dist/auth/guards.d.ts +17 -1
- package/dist/auth/guards.js +46 -2
- package/dist/auth/middleware.d.ts +2 -12
- package/dist/auth/middleware.js +20 -2
- package/dist/auth/oidc.d.ts +7 -0
- package/dist/auth/oidc.js +27 -6
- package/dist/auth/plugin-scope.d.ts +10 -0
- package/dist/auth/plugin-scope.js +69 -0
- package/dist/auth/service-scope.d.ts +7 -3
- package/dist/auth/service-scope.js +8 -4
- package/dist/events/hub.js +3 -38
- package/dist/lib/app-config.d.ts +2 -0
- package/dist/lib/app-config.js +3 -2
- package/dist/lib/defaults-store.d.ts +2 -25
- package/dist/lib/defaults-store.js +5 -87
- package/dist/lib/i18n.js +153 -0
- package/dist/main.js +67 -4
- package/dist/routes/agents.d.ts +12 -3
- package/dist/routes/agents.js +14 -2
- package/dist/routes/auth.d.ts +12 -2
- package/dist/routes/auth.js +16 -2
- package/dist/routes/context.d.ts +2 -2
- package/dist/routes/gateway-patterns.d.ts +2 -2
- package/dist/routes/llm.d.ts +8 -2
- package/dist/routes/llm.js +6 -3
- package/dist/routes/mcp-registry.d.ts +15 -3
- package/dist/routes/mcp-registry.js +122 -21
- package/dist/routes/messages.d.ts +7 -4
- package/dist/routes/messages.js +34 -3
- package/dist/routes/models.d.ts +7 -2
- package/dist/routes/models.js +3 -1
- package/dist/routes/processes.d.ts +34 -0
- package/dist/routes/processes.js +26 -0
- package/dist/routes/projects.d.ts +9 -3
- package/dist/routes/projects.js +8 -1
- package/dist/routes/providers.d.ts +15 -3
- package/dist/routes/providers.js +33 -21
- package/dist/routes/queue.d.ts +5 -4
- package/dist/routes/queue.js +30 -3
- package/dist/routes/sessions.d.ts +50 -3
- package/dist/routes/sessions.js +221 -74
- package/dist/test-helpers/close-server.d.ts +33 -0
- package/dist/test-helpers/close-server.js +50 -0
- package/package.json +4 -4
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import type {
|
|
3
|
+
import type { ProjectRepository, SessionManager, McpManager, SkillService, SettingsRepository, McpRegistryRepository } from '@itphx/synth-core';
|
|
4
|
+
import type { WorktreeService } from '@itphx/synth-core';
|
|
4
5
|
import type { Project } from '@itphx/synth-shared';
|
|
5
6
|
/**
|
|
6
7
|
* ADR-076 §T4: RBAC-хелперы проекта (owner/EDITOR/LEAD/ADMIN). Вынесены фабрикой,
|
|
@@ -24,8 +25,13 @@ export declare function createProjectAccess(kit: AuthKit): {
|
|
|
24
25
|
* workspace (ADR-075, политика `deny` вне root), проектный MCP-скоуп (ADR-071 §2.4)
|
|
25
26
|
* и статистика сессий. Полная реализация — `@itphx/synth-core`.
|
|
26
27
|
*/
|
|
27
|
-
export declare function createProjectRoutes(kit: AuthKit, store:
|
|
28
|
+
export declare function createProjectRoutes(kit: AuthKit, store: ProjectRepository, sessionManager: SessionManager, workspacesRoot: string,
|
|
28
29
|
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
29
30
|
mcpManager?: McpManager,
|
|
30
31
|
/** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
|
|
31
|
-
skillService?: SkillService, settingsStore?:
|
|
32
|
+
skillService?: SkillService, settingsStore?: SettingsRepository, mcpRegistryStore?: McpRegistryRepository,
|
|
33
|
+
/**
|
|
34
|
+
* ADR-114: сервис worktree'ов проекта — контур `/projects/:id/worktrees*`
|
|
35
|
+
* (список/создание/удаление/prune). Не задан — роутов нет.
|
|
36
|
+
*/
|
|
37
|
+
worktreeService?: WorktreeService): Hono;
|
package/dist/routes/projects.js
CHANGED
|
@@ -33,7 +33,12 @@ export function createProjectRoutes(kit, store, sessionManager, workspacesRoot,
|
|
|
33
33
|
/** ADR-071 §2.4: источник известных MCP-серверов для проектного скоупа. */
|
|
34
34
|
mcpManager,
|
|
35
35
|
/** ADR-046 §4.5: сид скиллов нового проекта (системные дефолты). */
|
|
36
|
-
skillService, settingsStore, mcpRegistryStore
|
|
36
|
+
skillService, settingsStore, mcpRegistryStore,
|
|
37
|
+
/**
|
|
38
|
+
* ADR-114: сервис worktree'ов проекта — контур `/projects/:id/worktrees*`
|
|
39
|
+
* (список/создание/удаление/prune). Не задан — роутов нет.
|
|
40
|
+
*/
|
|
41
|
+
worktreeService) {
|
|
37
42
|
const { canManageProject, canEditProjectContent, canReadProject } = createProjectAccess(kit);
|
|
38
43
|
return createCoreProjectRoutes({ requireAuth: kit.requireAuth }, store, undefined, {
|
|
39
44
|
canManage: canManageProject,
|
|
@@ -68,5 +73,7 @@ skillService, settingsStore, mcpRegistryStore) {
|
|
|
68
73
|
sessionManager,
|
|
69
74
|
getWorkspacesRoot: () => workspacesRoot,
|
|
70
75
|
getOutsideRootPolicy: () => 'deny',
|
|
76
|
+
// ADR-114: контур worktree'ов проекта.
|
|
77
|
+
...(worktreeService ? { worktrees: worktreeService } : {}),
|
|
71
78
|
});
|
|
72
79
|
}
|
|
@@ -1,9 +1,21 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import {
|
|
4
|
-
import type {
|
|
3
|
+
import type { JsonStoreLike } from '@itphx/synth-core';
|
|
4
|
+
import type { DefaultModelPair } from '@itphx/synth-core';
|
|
5
|
+
import type { EgressPolicy, ProviderConfig } from '@itphx/synth-shared';
|
|
6
|
+
import type { EgressLogSink } from '@itphx/synth-core';
|
|
7
|
+
/** Инъекция egress-политики/журнала для `/fetch-icon` (резолвер из deps). */
|
|
8
|
+
export interface ProviderRoutesEgressOptions {
|
|
9
|
+
/** Живой резолвер `egress.tools` (per-request; без него — встроенный дефолт). */
|
|
10
|
+
resolvePolicy?: () => Promise<EgressPolicy>;
|
|
11
|
+
/** Приёмник журнала внешних запросов (scope `providers`). */
|
|
12
|
+
log?: EgressLogSink;
|
|
13
|
+
}
|
|
5
14
|
/**
|
|
6
15
|
* Backend-обёртка над core-фабрикой провайдеров: добавляет только RBAC
|
|
7
16
|
* (мутации — ADMIN), rate limit на тест подключения и backend-only `fetch-icon`.
|
|
17
|
+
*
|
|
18
|
+
* URL провайдера проверяется общей egress-политикой (`egress.tools`, live),
|
|
19
|
+
* без собственной копии списка приватных диапазонов.
|
|
8
20
|
*/
|
|
9
|
-
export declare function createProviderRoutes(kit: AuthKit, store:
|
|
21
|
+
export declare function createProviderRoutes(kit: AuthKit, store: JsonStoreLike<ProviderConfig>, providerCache: Map<string, ProviderConfig>, egress?: ProviderRoutesEgressOptions, getDefaultModel?: () => DefaultModelPair | null | Promise<DefaultModelPair | null>): Hono;
|
package/dist/routes/providers.js
CHANGED
|
@@ -1,23 +1,15 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
|
-
import {
|
|
3
|
-
import { createProviderRoutes as createCoreProviderRoutes, evaluateMcpNetworkAccess } from '@itphx/synth-core';
|
|
2
|
+
import { createProviderRoutes as createCoreProviderRoutes, checkEgressUrl, fetchWithEgressGuard, sanitizeEgressTarget, PRIVATE_EGRESS_POLICY, } from '@itphx/synth-core';
|
|
4
3
|
import { t } from '../lib/i18n.js';
|
|
5
4
|
import { createRateLimiter } from '../middleware/rate-limiter.js';
|
|
6
|
-
/**
|
|
7
|
-
* Политика проверки URL провайдера для `/fetch-icon`: блокируем внутренние и
|
|
8
|
-
* приватные адреса, включая DNS-резолв (переиспользуем MCP network-policy, а не
|
|
9
|
-
* собственный regex-список). Помимо дефолтных приватных диапазонов исключаем
|
|
10
|
-
* `0.0.0.0/8` — сохраняем прежнюю блокировку hostname `0.0.0.0`.
|
|
11
|
-
*/
|
|
12
|
-
const PROVIDER_URL_NETWORK_POLICY = {
|
|
13
|
-
mode: 'deny',
|
|
14
|
-
list: [...DEFAULT_MCP_PRIVATE_CIDRS, '0.0.0.0/8'],
|
|
15
|
-
};
|
|
16
5
|
/**
|
|
17
6
|
* Backend-обёртка над core-фабрикой провайдеров: добавляет только RBAC
|
|
18
7
|
* (мутации — ADMIN), rate limit на тест подключения и backend-only `fetch-icon`.
|
|
8
|
+
*
|
|
9
|
+
* URL провайдера проверяется общей egress-политикой (`egress.tools`, live),
|
|
10
|
+
* без собственной копии списка приватных диапазонов.
|
|
19
11
|
*/
|
|
20
|
-
export function createProviderRoutes(kit, store, providerCache) {
|
|
12
|
+
export function createProviderRoutes(kit, store, providerCache, egress = {}, getDefaultModel) {
|
|
21
13
|
const app = new Hono();
|
|
22
14
|
// POST /api/v2/providers/fetch-icon — получить favicon с домена (admin).
|
|
23
15
|
// Статический сегмент регистрируем до core-роутов (в т.ч. /:name).
|
|
@@ -34,19 +26,38 @@ export function createProviderRoutes(kit, store, providerCache) {
|
|
|
34
26
|
catch {
|
|
35
27
|
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUrl', undefined, c) } }, 400);
|
|
36
28
|
}
|
|
37
|
-
// SSRF-защита:
|
|
38
|
-
const
|
|
29
|
+
// SSRF-защита: resolved egress-политика (включая exceptions и DNS-резолв).
|
|
30
|
+
const policy = egress.resolvePolicy ? await egress.resolvePolicy() : PRIVATE_EGRESS_POLICY;
|
|
31
|
+
const networkCheck = await checkEgressUrl(origin, policy);
|
|
39
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
|
+
}
|
|
40
51
|
return c.json({ error: { code: 'VALIDATION_ERROR', message: t('errors.validation.invalidUrl', undefined, c) } }, 400);
|
|
41
52
|
}
|
|
42
53
|
try {
|
|
43
54
|
const iconUrl = `${origin}/favicon.ico`;
|
|
44
55
|
const controller = new AbortController();
|
|
45
56
|
const timer = setTimeout(() => controller.abort(), 5000);
|
|
46
|
-
const resp = await
|
|
57
|
+
const resp = await fetchWithEgressGuard(iconUrl, {
|
|
47
58
|
signal: controller.signal,
|
|
48
59
|
headers: { Accept: 'image/*' },
|
|
49
|
-
});
|
|
60
|
+
}, { policy, scope: 'providers', log: egress.log });
|
|
50
61
|
clearTimeout(timer);
|
|
51
62
|
if (resp.ok && resp.headers.get('content-type')?.includes('image')) {
|
|
52
63
|
const buffer = await resp.arrayBuffer();
|
|
@@ -57,10 +68,10 @@ export function createProviderRoutes(kit, store, providerCache) {
|
|
|
57
68
|
// Попробовать найти <link rel="icon"> в HTML
|
|
58
69
|
const htmlController = new AbortController();
|
|
59
70
|
const htmlTimer = setTimeout(() => htmlController.abort(), 5000);
|
|
60
|
-
const htmlResp = await
|
|
71
|
+
const htmlResp = await fetchWithEgressGuard(origin, {
|
|
61
72
|
signal: htmlController.signal,
|
|
62
73
|
headers: { Accept: 'text/html' },
|
|
63
|
-
});
|
|
74
|
+
}, { policy, scope: 'providers', log: egress.log });
|
|
64
75
|
clearTimeout(htmlTimer);
|
|
65
76
|
if (htmlResp.ok) {
|
|
66
77
|
const html = await htmlResp.text();
|
|
@@ -74,10 +85,10 @@ export function createProviderRoutes(kit, store, providerCache) {
|
|
|
74
85
|
resolved = `${origin}${resolved}`;
|
|
75
86
|
else if (!resolved.startsWith('http'))
|
|
76
87
|
resolved = `${origin}/${resolved}`;
|
|
77
|
-
const iconResp = await
|
|
88
|
+
const iconResp = await fetchWithEgressGuard(resolved, {
|
|
78
89
|
signal: AbortSignal.timeout(5000),
|
|
79
90
|
headers: { Accept: 'image/*' },
|
|
80
|
-
});
|
|
91
|
+
}, { policy, scope: 'providers', log: egress.log });
|
|
81
92
|
if (iconResp.ok) {
|
|
82
93
|
const buffer = await iconResp.arrayBuffer();
|
|
83
94
|
const ct = iconResp.headers.get('content-type') || 'image/x-icon';
|
|
@@ -103,6 +114,7 @@ export function createProviderRoutes(kit, store, providerCache) {
|
|
|
103
114
|
testEnabled: true,
|
|
104
115
|
testGuard: kit.requireAdmin,
|
|
105
116
|
testMiddleware: [createRateLimiter(5, 60_000)],
|
|
117
|
+
getDefaultModel,
|
|
106
118
|
messages: {
|
|
107
119
|
nameRequired: (c) => t('errors.validation.nameRequired', undefined, c),
|
|
108
120
|
providerNotFound: (c) => t('errors.notFound.provider', undefined, c),
|
package/dist/routes/queue.d.ts
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import type { AuthKit } from '../auth/middleware.js';
|
|
3
|
-
import type { SessionManager, QueueProcessorManager, ChatOrchestrator, EventBus } from '@itphx/synth-core';
|
|
3
|
+
import type { SessionManager, QueueProcessorManager, ChatOrchestrator, EventBus, ProjectRepository } from '@itphx/synth-core';
|
|
4
4
|
/**
|
|
5
|
-
* Backend-обёртка над core-фабрикой очереди: добавляет
|
|
6
|
-
*
|
|
5
|
+
* Backend-обёртка над core-фабрикой очереди: добавляет i18n-сообщения и RBAC
|
|
6
|
+
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD). Логика роутов
|
|
7
|
+
* (clear/return/resume/retry-now/cancel-retry) — в core-фабрике.
|
|
7
8
|
*/
|
|
8
|
-
export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']
|
|
9
|
+
export declare function createQueueRoutes(kit: AuthKit, sessionManager: SessionManager, queueManager: QueueProcessorManager, eventBus: EventBus, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, projectStore?: ProjectRepository): Hono;
|
package/dist/routes/queue.js
CHANGED
|
@@ -1,16 +1,43 @@
|
|
|
1
1
|
import { Hono } from 'hono';
|
|
2
2
|
import { createQueueRoutes as createCoreQueueRoutes } from '@itphx/synth-core';
|
|
3
3
|
import { t } from '../lib/i18n.js';
|
|
4
|
+
import { createProjectAccess } from './projects.js';
|
|
4
5
|
/**
|
|
5
|
-
* Backend-обёртка над core-фабрикой очереди: добавляет
|
|
6
|
-
*
|
|
6
|
+
* Backend-обёртка над core-фабрикой очереди: добавляет i18n-сообщения и RBAC
|
|
7
|
+
* доступа к сессии (владелец/ADMIN/участник проекта/LEAD). Логика роутов
|
|
8
|
+
* (clear/return/resume/retry-now/cancel-retry) — в core-фабрике.
|
|
7
9
|
*/
|
|
8
|
-
export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, processMessage) {
|
|
10
|
+
export function createQueueRoutes(kit, sessionManager, queueManager, eventBus, processMessage, projectStore) {
|
|
9
11
|
const app = new Hono();
|
|
12
|
+
const { canReadProject, canEditProjectContent } = createProjectAccess(kit);
|
|
13
|
+
// ADR-071 §2.4: владелец сессии — обычный пользователь.
|
|
14
|
+
const isSessionOwner = (session, userId) => (session.ownerId ?? session.userId) === userId;
|
|
10
15
|
app.route('/', createCoreQueueRoutes({ requireAuth: kit.requireAuth }, sessionManager, queueManager, eventBus, processMessage, undefined, {
|
|
11
16
|
messages: {
|
|
12
17
|
sessionNotFound: (c) => t('errors.notFound.session', undefined, c),
|
|
13
18
|
messageNotFoundIndex: (c) => t('errors.notFound.messageIndex', undefined, c),
|
|
19
|
+
forbidden: (c) => t('auth.forbidden', undefined, c),
|
|
20
|
+
},
|
|
21
|
+
resolveUserId: async (c) => (await kit.getCurrentUser(c))?.id ?? '',
|
|
22
|
+
canAccess: (session, c, userId) => isSessionOwner(session, userId)
|
|
23
|
+
|| (typeof kit.isAdmin === 'function' && kit.isAdmin(c)),
|
|
24
|
+
resolveElevated: (c) => {
|
|
25
|
+
const isAdmin = typeof kit.isAdmin === 'function' && kit.isAdmin(c);
|
|
26
|
+
const isLead = typeof kit.hasRole === 'function' && kit.hasRole(c, 'LEAD');
|
|
27
|
+
return isAdmin || isLead;
|
|
28
|
+
},
|
|
29
|
+
// read/write по роли в проекте: чтение — owner/любой участник, мутация —
|
|
30
|
+
// owner/EDITOR/LEAD/ADMIN (`createProjectAccess`; см. sessions.ts).
|
|
31
|
+
resolveCanAccessExtra: async (session, c, userId, access) => {
|
|
32
|
+
if (!projectStore || !session.projectId)
|
|
33
|
+
return false;
|
|
34
|
+
const project = await projectStore.load(session.projectId);
|
|
35
|
+
if (!project)
|
|
36
|
+
return false;
|
|
37
|
+
const ctx = c;
|
|
38
|
+
return access === 'read'
|
|
39
|
+
? canReadProject(ctx, project, userId)
|
|
40
|
+
: canEditProjectContent(ctx, project, userId);
|
|
14
41
|
},
|
|
15
42
|
}));
|
|
16
43
|
return app;
|
|
@@ -6,9 +6,15 @@ import type { QueueProcessorManager } from '@itphx/synth-core';
|
|
|
6
6
|
import type { ChatOrchestrator } from '@itphx/synth-core';
|
|
7
7
|
import type { ContextOptimizer } from '@itphx/synth-core';
|
|
8
8
|
import type { RequestSessionService } from '@itphx/synth-core';
|
|
9
|
+
import type { AnalyticsRecorder } from '@itphx/synth-core';
|
|
9
10
|
import type { ProfileStore } from '@itphx/synth-shared';
|
|
10
11
|
import type { EventHub } from '../events/hub.js';
|
|
11
|
-
import type {
|
|
12
|
+
import type { ProjectRepository } from '@itphx/synth-core';
|
|
13
|
+
import type { MemoryFactRepository, MemoryIndexRepository } from '@itphx/synth-core';
|
|
14
|
+
import type { BlobRefRepository, BlobStore } from '@itphx/synth-core';
|
|
15
|
+
import type { AttachmentsConfig } from '@itphx/synth-shared';
|
|
16
|
+
import type { QuestionService } from '@itphx/synth-core';
|
|
17
|
+
import type { WorktreeService } from '@itphx/synth-core';
|
|
12
18
|
/**
|
|
13
19
|
* Backend-обёртка над core-фабрикой сессий (ТД-1, фаза B2). Здесь остаются только
|
|
14
20
|
* backend-специфичные роуты (MCP-скоуп сессии, секреты, export/import, отладка,
|
|
@@ -19,8 +25,15 @@ import type { ProjectStore } from '@itphx/synth-core';
|
|
|
19
25
|
* RBAC: core-фабрика параметризуется `resolveUserId`/`resolveOwner`/`resolveAuthor`,
|
|
20
26
|
* `canAccess` (владелец|ADMIN) и EventHub-хуками; remote/hybrid-ветки отключены
|
|
21
27
|
* (getRemoteClient не передаётся). `GET /:id/events` на backend не регистрируется.
|
|
28
|
+
*
|
|
29
|
+
* Исключения из общего prefix-guard'а (собственные правила, роуты зарегистрированы
|
|
30
|
+
* до guard'а): `/:id/mcp` (владелец|ADMIN, ADR-071 §2.4) и `/:id/secrets`
|
|
31
|
+
* (ADMIN|AUDITOR — карта обфускации). `/:id/export` — ПОД guard'ом: доступ к
|
|
32
|
+
* сессии решает ЕДИНЫЙ prefix-guard, а привилегию карты обфускации — отдельный
|
|
33
|
+
* route-level guard (`createSessionExportGuard`, ADR-036); в обработчике проверок
|
|
34
|
+
* доступа нет (инвариант 16).
|
|
22
35
|
*/
|
|
23
|
-
export declare function createSessionRoutes(kit: AuthKit, sessionManager: SessionManager, eventBus: EventBus, queueManager: QueueProcessorManager, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, orchestrator: ChatOrchestrator, eventHub: EventHub, contextOptimizer?: ContextOptimizer, projectStore?:
|
|
36
|
+
export declare function createSessionRoutes(kit: AuthKit, sessionManager: SessionManager, eventBus: EventBus, queueManager: QueueProcessorManager, processMessage: ReturnType<ChatOrchestrator['createProcessMessage']>, orchestrator: ChatOrchestrator, eventHub: EventHub, contextOptimizer?: ContextOptimizer, projectStore?: ProjectRepository,
|
|
24
37
|
/** Профили пользователей: display name для статистики (fallback — username). */
|
|
25
38
|
profilesStore?: ProfileStore,
|
|
26
39
|
/** Агент по умолчанию для новых сессий без `settings.agentRole` (runtime-настройка). */
|
|
@@ -29,4 +42,38 @@ resolveDefaultAgent?: () => string | Promise<string>,
|
|
|
29
42
|
* ADR-089: единый funnel создания сессий (прокидывается в core-фабрику).
|
|
30
43
|
* Не задан — core-фабрика использует прямой `SessionManager.createSession`.
|
|
31
44
|
*/
|
|
32
|
-
requestSessionService?: RequestSessionService
|
|
45
|
+
requestSessionService?: RequestSessionService,
|
|
46
|
+
/** ADR-102: сборщик `activity` (меры `aborts`/`messages_*`) для core-фабрики. */
|
|
47
|
+
analytics?: AnalyticsRecorder,
|
|
48
|
+
/** ADR-107: агрегаты памяти сессии для `GET /:id/memory` (вкладка «Память»). */
|
|
49
|
+
memory?: {
|
|
50
|
+
facts: MemoryFactRepository;
|
|
51
|
+
indexes: MemoryIndexRepository;
|
|
52
|
+
isPluginActive: () => boolean;
|
|
53
|
+
},
|
|
54
|
+
/**
|
|
55
|
+
* Этап 1 roadmap 0.13 (блок 3): сервис «вопрос пользователю» (`ask_user`).
|
|
56
|
+
*
|
|
57
|
+
* Не задан — маршруты вопросов отвечают 503 (подсистема не подключена).
|
|
58
|
+
*/
|
|
59
|
+
questionService?: QuestionService,
|
|
60
|
+
/**
|
|
61
|
+
* ADR-114: сервис worktree'ов — привязка сессии к worktree
|
|
62
|
+
* (`PATCH /api/v2/sessions/:id { worktreeId }`).
|
|
63
|
+
*
|
|
64
|
+
* Не задан — поле `worktreeId` в PATCH игнорируется (привязка недоступна).
|
|
65
|
+
*/
|
|
66
|
+
worktreeService?: WorktreeService,
|
|
67
|
+
/**
|
|
68
|
+
* ADR-115: вложения сообщений — blob-порт, учёт ссылок и лимиты
|
|
69
|
+
* (прокидывается в core-фабрику: загрузка/раздача + `attachments` в промпте).
|
|
70
|
+
*/
|
|
71
|
+
attachments?: {
|
|
72
|
+
blobs: BlobStore;
|
|
73
|
+
blobRefs?: BlobRefRepository;
|
|
74
|
+
/**
|
|
75
|
+
* Настройки вложений: снимок **или** резолвер (ADR-115) — runtime-настройки
|
|
76
|
+
* из админки (`/api/v2/settings/attachments`) применяются на каждый вызов.
|
|
77
|
+
*/
|
|
78
|
+
config: AttachmentsConfig | (() => AttachmentsConfig);
|
|
79
|
+
}): Hono;
|