@itphx/synth-shared 0.10.1 → 0.12.3
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/config/defaults.js +172 -3
- package/dist/config/env-overrides.d.ts +33 -1
- package/dist/config/env-overrides.js +191 -5
- package/dist/config/execution.d.ts +66 -0
- package/dist/config/execution.js +146 -0
- package/dist/config/index.d.ts +4 -0
- package/dist/config/index.js +4 -0
- package/dist/config/loader.js +19 -0
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1567 -0
- package/dist/config/resolve.d.ts +67 -0
- package/dist/config/resolve.js +187 -1
- package/dist/config/tls-runtime.d.ts +78 -0
- package/dist/config/tls-runtime.js +356 -0
- package/dist/config/tls.d.ts +215 -0
- package/dist/config/tls.js +394 -0
- package/dist/config/types.d.ts +1571 -2835
- package/dist/config/types.js +717 -58
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +279 -0
- package/dist/index.d.ts +24 -3
- package/dist/index.js +25 -2
- package/dist/model-metadata.d.ts +10 -0
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +1014 -2231
- package/dist/schemas/index.js +222 -14
- package/dist/types/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -0
- package/dist/types/authority.d.ts +464 -0
- package/dist/types/authority.js +445 -0
- package/dist/types/background.d.ts +96 -0
- package/dist/types/background.js +24 -0
- package/dist/types/bus-events.d.ts +23 -1
- package/dist/types/catalog.d.ts +349 -0
- package/dist/types/catalog.js +393 -0
- package/dist/types/decision.d.ts +28 -337
- package/dist/types/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +54 -2
- package/dist/types/external-credentials.d.ts +352 -0
- package/dist/types/external-credentials.js +200 -0
- package/dist/types/fs.d.ts +11 -0
- package/dist/types/fs.js +11 -0
- package/dist/types/hooks.d.ts +50 -9
- package/dist/types/index.d.ts +23 -0
- package/dist/types/index.js +55 -0
- package/dist/types/llm-filters.d.ts +150 -0
- package/dist/types/llm-filters.js +54 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +101 -5
- package/dist/types/mcp.js +127 -5
- package/dist/types/message.d.ts +45 -1
- package/dist/types/pack.d.ts +1102 -0
- package/dist/types/pack.js +1003 -0
- package/dist/types/permission.d.ts +31 -15
- package/dist/types/permission.js +1 -1
- package/dist/types/pipeline-engine.d.ts +453 -0
- package/dist/types/pipeline-engine.js +440 -0
- package/dist/types/pipeline.d.ts +275 -0
- package/dist/types/pipeline.js +212 -0
- package/dist/types/plugin-audit.d.ts +110 -0
- package/dist/types/plugin-audit.js +185 -0
- package/dist/types/plugin-hybrid.d.ts +85 -0
- package/dist/types/plugin-hybrid.js +68 -0
- package/dist/types/plugin-lock.d.ts +95 -0
- package/dist/types/plugin-lock.js +1 -0
- package/dist/types/plugin-protocol.d.ts +221 -0
- package/dist/types/plugin-protocol.js +322 -0
- package/dist/types/plugin-runtime.d.ts +25 -0
- package/dist/types/plugin-runtime.js +11 -0
- package/dist/types/plugin-scan.d.ts +159 -0
- package/dist/types/plugin-scan.js +166 -0
- package/dist/types/plugin-tools.d.ts +51 -0
- package/dist/types/plugin-tools.js +72 -0
- package/dist/types/project.d.ts +14 -0
- package/dist/types/prompt-blocks.d.ts +102 -0
- package/dist/types/prompt-blocks.js +24 -0
- package/dist/types/prompt.d.ts +47 -4
- package/dist/types/provider.d.ts +11 -0
- package/dist/types/question.d.ts +153 -0
- package/dist/types/question.js +65 -0
- package/dist/types/schedules.d.ts +26 -3
- package/dist/types/semver.d.ts +48 -0
- package/dist/types/semver.js +218 -0
- package/dist/types/service-keys.d.ts +41 -3
- package/dist/types/service-keys.js +44 -2
- package/dist/types/session.d.ts +54 -1
- package/dist/types/steering.d.ts +74 -0
- package/dist/types/steering.js +75 -0
- package/dist/types/tools.d.ts +125 -5
- package/dist/types/tools.js +75 -0
- package/dist/types/trust.d.ts +31 -0
- package/dist/types/trust.js +27 -0
- package/dist/types/webhooks.d.ts +1 -1
- package/dist/types/worktree.d.ts +170 -0
- package/dist/types/worktree.js +101 -0
- package/dist/utils/index.d.ts +46 -1
- package/dist/utils/index.js +145 -12
- package/dist/utils/reasoning.d.ts +16 -0
- package/dist/utils/reasoning.js +37 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +2 -2
package/dist/types/fs.d.ts
CHANGED
|
@@ -42,3 +42,14 @@ export interface FsError {
|
|
|
42
42
|
error: string;
|
|
43
43
|
code: FsErrorCode;
|
|
44
44
|
}
|
|
45
|
+
/**
|
|
46
|
+
* Лимит загрузки файла (`POST /api/v2/fs/upload`) по умолчанию, байт: 100 МиБ.
|
|
47
|
+
* Щедро, но ограничивает DoS (тело буферизуется в память целиком). Переопределяется
|
|
48
|
+
* конфигом (`storage.maxUploadBytes` / env `SYNTH_MAX_UPLOAD_BYTES`) или опцией
|
|
49
|
+
* фабрики `createFsRoutes` (`FsRoutesOptions.maxUploadBytes`, для тестов).
|
|
50
|
+
*/
|
|
51
|
+
export declare const DEFAULT_MAX_UPLOAD_BYTES: number;
|
|
52
|
+
/** Нижняя граница настраиваемого лимита загрузки (байт) — нельзя «залимитировать всё». */
|
|
53
|
+
export declare const MIN_UPLOAD_BYTES = 1024;
|
|
54
|
+
/** Верхняя граница настраиваемого лимита загрузки (байт): 2 ГиБ (тело буферизуется в память). */
|
|
55
|
+
export declare const MAX_UPLOAD_BYTES_LIMIT: number;
|
package/dist/types/fs.js
CHANGED
|
@@ -14,3 +14,14 @@ export var FsErrorCode;
|
|
|
14
14
|
/** ADR-075: путь вне `workspacesRoot` запрещён политикой (managed). */
|
|
15
15
|
FsErrorCode["WORKSPACE_OUTSIDE_ROOT_DENIED"] = "WORKSPACE_OUTSIDE_ROOT_DENIED";
|
|
16
16
|
})(FsErrorCode || (FsErrorCode = {}));
|
|
17
|
+
/**
|
|
18
|
+
* Лимит загрузки файла (`POST /api/v2/fs/upload`) по умолчанию, байт: 100 МиБ.
|
|
19
|
+
* Щедро, но ограничивает DoS (тело буферизуется в память целиком). Переопределяется
|
|
20
|
+
* конфигом (`storage.maxUploadBytes` / env `SYNTH_MAX_UPLOAD_BYTES`) или опцией
|
|
21
|
+
* фабрики `createFsRoutes` (`FsRoutesOptions.maxUploadBytes`, для тестов).
|
|
22
|
+
*/
|
|
23
|
+
export const DEFAULT_MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
|
|
24
|
+
/** Нижняя граница настраиваемого лимита загрузки (байт) — нельзя «залимитировать всё». */
|
|
25
|
+
export const MIN_UPLOAD_BYTES = 1024;
|
|
26
|
+
/** Верхняя граница настраиваемого лимита загрузки (байт): 2 ГиБ (тело буферизуется в память). */
|
|
27
|
+
export const MAX_UPLOAD_BYTES_LIMIT = 2 * 1024 * 1024 * 1024;
|
package/dist/types/hooks.d.ts
CHANGED
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* ADR-030: контракты hook-шины событий агента и интеграций.
|
|
3
|
-
*
|
|
4
|
-
*
|
|
2
|
+
* ADR-030: контракты hook-шины событий агента и интеграций. Здесь только типы
|
|
3
|
+
* (имена хуков, режим выполнения, результат и карта контекстов); сама шина —
|
|
4
|
+
* `HookBus` в core, внешний фасад — Plugin SDK (ADR-090).
|
|
5
5
|
*/
|
|
6
6
|
import type { SynthEvent, EventInitiator } from './events.js';
|
|
7
|
+
import type { SessionMode } from './session.js';
|
|
7
8
|
/** ADR-030: имена хуков жизненного цикла агента и интеграций (ADR-089). */
|
|
8
9
|
export type HookName = 'pre_tool_use' | 'post_tool_use' | 'session_start' | 'session_end' | 'plan_approved' | 'plan_rejected' | 'agent_spawned' | 'agent_completed' | 'agent_failed' | 'permission_denied' | 'external_event' | 'message_received' | 'callback' | 'session_requested' | 'schedule_fired';
|
|
9
10
|
/**
|
|
@@ -17,6 +18,24 @@ export interface HookResult {
|
|
|
17
18
|
reason?: string;
|
|
18
19
|
patch?: Record<string, unknown>;
|
|
19
20
|
}
|
|
21
|
+
/**
|
|
22
|
+
* ADR-102: оси атрибуции для сборщиков аналитики (`user`/`project`) — заполняются
|
|
23
|
+
* на месте эмита, где значения уже под рукой (без чтения сессии в подписчике).
|
|
24
|
+
* Необязательны: без них подписчик резолвит сессию по id (если она ещё есть).
|
|
25
|
+
*/
|
|
26
|
+
export interface HookAnalyticsAxes {
|
|
27
|
+
/** Владелец/пользователь сессии (`Session.userId`), ось `user`. */
|
|
28
|
+
userId?: string;
|
|
29
|
+
/** Проект сессии (`Session.projectId`), ось `project`. */
|
|
30
|
+
projectId?: string;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* ADR-030 / ADR-090 Ф0: вид входящего сообщения для `message_received`.
|
|
34
|
+
* - `user` — сообщение человека (UI/CLI/API);
|
|
35
|
+
* - `scheduler` — срабатывание расписания (автор `Scheduler`, ADR-051);
|
|
36
|
+
* - `external` — доставка внешнего события (webhook/шлюз, `metadata.source`).
|
|
37
|
+
*/
|
|
38
|
+
export type MessageReceivedKind = 'user' | 'scheduler' | 'external';
|
|
20
39
|
/** ADR-030: карта контекста по имени хука (минимально необходимые поля). */
|
|
21
40
|
export interface HookContextMap {
|
|
22
41
|
pre_tool_use: {
|
|
@@ -29,15 +48,24 @@ export interface HookContextMap {
|
|
|
29
48
|
input: unknown;
|
|
30
49
|
output?: unknown;
|
|
31
50
|
duration: number;
|
|
51
|
+
/** ADR-102: сессия вызова и оси атрибуции активности (ADR-030). */
|
|
52
|
+
sessionId?: string;
|
|
53
|
+
userId?: string;
|
|
54
|
+
projectId?: string;
|
|
32
55
|
};
|
|
33
56
|
session_start: {
|
|
34
57
|
sessionId: string;
|
|
35
58
|
projectId?: string;
|
|
36
59
|
agent?: string;
|
|
60
|
+
userId?: string;
|
|
37
61
|
};
|
|
38
62
|
session_end: {
|
|
39
63
|
sessionId: string;
|
|
40
64
|
summary?: string;
|
|
65
|
+
userId?: string;
|
|
66
|
+
projectId?: string;
|
|
67
|
+
/** ADR-102: сессия архивирована (а не удалена) — мера `sessions_archived`. */
|
|
68
|
+
archived?: boolean;
|
|
41
69
|
};
|
|
42
70
|
plan_approved: {
|
|
43
71
|
sessionId: string;
|
|
@@ -70,11 +98,18 @@ export interface HookContextMap {
|
|
|
70
98
|
event: SynthEvent;
|
|
71
99
|
};
|
|
72
100
|
message_received: {
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
101
|
+
/** Сессия, в которую пришло сообщение. */
|
|
102
|
+
sessionId: string;
|
|
103
|
+
/** Эффективный агент хода (`message.agentRole` либо настройка сессии). */
|
|
104
|
+
agent?: string;
|
|
105
|
+
/** Режим сессии на момент приёма (`plan`/`act`/`yolo`). */
|
|
106
|
+
mode?: SessionMode;
|
|
107
|
+
/** Вид входящего сообщения (см. {@link MessageReceivedKind}). */
|
|
108
|
+
kind: MessageReceivedKind;
|
|
109
|
+
/** Внешний источник (`message.metadata.source`) для `kind: 'external'`. */
|
|
110
|
+
source?: string;
|
|
111
|
+
/** `message.metadata.type` — тип сообщения, если задан. */
|
|
112
|
+
type?: string;
|
|
78
113
|
};
|
|
79
114
|
callback: {
|
|
80
115
|
source: string;
|
|
@@ -90,7 +125,13 @@ export interface HookContextMap {
|
|
|
90
125
|
};
|
|
91
126
|
schedule_fired: {
|
|
92
127
|
scheduleId: string;
|
|
128
|
+
/** Имя расписания (для логов/уведомлений). */
|
|
129
|
+
name?: string;
|
|
130
|
+
/** Режим цели расписания (`bound`/`ephemeral`/`queue`/`pipeline`). */
|
|
131
|
+
target?: 'bound' | 'ephemeral' | 'queue' | 'pipeline';
|
|
132
|
+
/** Cron-выражение (если расписание задано через `cron`). */
|
|
93
133
|
cron?: string;
|
|
94
|
-
|
|
134
|
+
/** Триггер срабатывания (`cron`/`manual`/`catchup`). */
|
|
135
|
+
trigger?: 'cron' | 'manual' | 'catchup';
|
|
95
136
|
};
|
|
96
137
|
}
|
package/dist/types/index.d.ts
CHANGED
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
export * from './message.js';
|
|
2
2
|
export * from './session.js';
|
|
3
3
|
export * from './prompt.js';
|
|
4
|
+
export * from './prompt-blocks.js';
|
|
5
|
+
export * from './llm-filters.js';
|
|
6
|
+
export * from './plugin-tools.js';
|
|
7
|
+
export * from './plugin-protocol.js';
|
|
4
8
|
export * from './mcp.js';
|
|
5
9
|
export * from './project.js';
|
|
6
10
|
export * from './git.js';
|
|
@@ -9,6 +13,7 @@ export * from './agent.js';
|
|
|
9
13
|
export * from './provider.js';
|
|
10
14
|
export * from './llm.js';
|
|
11
15
|
export * from './bus-events.js';
|
|
16
|
+
export * from './steering.js';
|
|
12
17
|
export * from './fs.js';
|
|
13
18
|
export * from './tools.js';
|
|
14
19
|
export * from './permission.js';
|
|
@@ -20,3 +25,21 @@ export * from './schedules.js';
|
|
|
20
25
|
export * from './decision.js';
|
|
21
26
|
export * from './service-keys.js';
|
|
22
27
|
export * from './webhooks.js';
|
|
28
|
+
export * from './external-credentials.js';
|
|
29
|
+
export * from './maintenance.js';
|
|
30
|
+
export * from './egress.js';
|
|
31
|
+
export * from './analytics.js';
|
|
32
|
+
export * from './pack.js';
|
|
33
|
+
export * from './semver.js';
|
|
34
|
+
export * from './plugin-audit.js';
|
|
35
|
+
export * from './plugin-scan.js';
|
|
36
|
+
export * from './plugin-lock.js';
|
|
37
|
+
export * from './plugin-runtime.js';
|
|
38
|
+
export * from './plugin-hybrid.js';
|
|
39
|
+
export * from './catalog.js';
|
|
40
|
+
export * from './authority.js';
|
|
41
|
+
export * from './pipeline.js';
|
|
42
|
+
export * from './pipeline-engine.js';
|
|
43
|
+
export * from './question.js';
|
|
44
|
+
export * from './background.js';
|
|
45
|
+
export * from './worktree.js';
|
package/dist/types/index.js
CHANGED
|
@@ -8,6 +8,14 @@ export * from './message.js';
|
|
|
8
8
|
export * from './session.js';
|
|
9
9
|
// Промпт: состояние/манифест/история (ADR-070/071)
|
|
10
10
|
export * from './prompt.js';
|
|
11
|
+
// ADR-090: контракт провайдера блока системного промпта
|
|
12
|
+
export * from './prompt-blocks.js';
|
|
13
|
+
// ADR-090: контракт фильтра LLM-вызовов
|
|
14
|
+
export * from './llm-filters.js';
|
|
15
|
+
// ADR-090: namespace инструментов плагина (plugin_<ns>_<tool>)
|
|
16
|
+
export * from './plugin-tools.js';
|
|
17
|
+
// ADR-090: wire-протокол плагина (версия, DTO, эндпоинты, коды)
|
|
18
|
+
export * from './plugin-protocol.js';
|
|
11
19
|
// MCP: реестр серверов, сетевой доступ, уровни/эффективный набор (ADR-071)
|
|
12
20
|
export * from './mcp.js';
|
|
13
21
|
// Проекты, workspace-политика, иконки/цвета, план (ADR-039/075)
|
|
@@ -24,6 +32,8 @@ export * from './provider.js';
|
|
|
24
32
|
export * from './llm.js';
|
|
25
33
|
// EventType/BusEvent — шина событий сессии (ADR-009/024)
|
|
26
34
|
export * from './bus-events.js';
|
|
35
|
+
// ADR-104: режимы отправки сообщения во время хода (steering)
|
|
36
|
+
export * from './steering.js';
|
|
27
37
|
// Файловая система (FS API v2)
|
|
28
38
|
export * from './fs.js';
|
|
29
39
|
// --- Реэкспорт существующих доменных модулей ---
|
|
@@ -47,3 +57,48 @@ export * from './decision.js';
|
|
|
47
57
|
export * from './service-keys.js';
|
|
48
58
|
// ADR-052 (этап II): исходящие webhooks — типы и матчер событий — re-exported from webhooks.ts
|
|
49
59
|
export * from './webhooks.js';
|
|
60
|
+
// ADR-105 (Ф0): внешний доступ к внешним сервисам (коннекторам) — типы, zod и
|
|
61
|
+
// маппер «метаданные без секрета».
|
|
62
|
+
export * from './external-credentials.js';
|
|
63
|
+
// ADR-092 (остаток): аудит-журнал обслуживания инстанса — re-exported from maintenance.ts
|
|
64
|
+
export * from './maintenance.js';
|
|
65
|
+
// Egress-политика, журнал внешних запросов и аудит security-политик
|
|
66
|
+
export * from './egress.js';
|
|
67
|
+
// Аналитика и отчётность инстанса: суточные роллапы (ADR-102)
|
|
68
|
+
export * from './analytics.js';
|
|
69
|
+
// ADR-086/ADR-090: единый манифест расширения `synth.pack` — типы и zod-схемы
|
|
70
|
+
export * from './pack.js';
|
|
71
|
+
// ADR-090: semver-матчер диапазонов версий (host/контракты расширения)
|
|
72
|
+
export * from './semver.js';
|
|
73
|
+
// ADR-090: журнал аудита плагинов — отдельный тип и отдельный scope
|
|
74
|
+
// (не расширение `SECURITY_AUDIT_SCOPES` — семантика «событие расширения»).
|
|
75
|
+
export * from './plugin-audit.js';
|
|
76
|
+
// PROP-068 §4.2/§4.3 + ADR-090: контракты сканера расширений (категории,
|
|
77
|
+
// severity→verdict, квоты), матрица install-policy и запись lock-файла.
|
|
78
|
+
export * from './plugin-scan.js';
|
|
79
|
+
// PROP-068 §4.4 / ADR-090: запись lock-файла плагинов (`plugins.lock.json`).
|
|
80
|
+
export * from './plugin-lock.js';
|
|
81
|
+
// ADR-090: runtime-override плагинов (`plugins.json`).
|
|
82
|
+
export * from './plugin-runtime.js';
|
|
83
|
+
// ADR-090 Ф7: контракт гибридной политики плагинов (сигнал дискавери,
|
|
84
|
+
// allow-list, статусы проверки сервером, заголовок `plugin_id`).
|
|
85
|
+
export * from './plugin-hybrid.js';
|
|
86
|
+
// PROP-068 §3/§12: контракт индекса каталога расширений (format: 1) — типы, zod-схемы, tolerant-парсер
|
|
87
|
+
export * from './catalog.js';
|
|
88
|
+
// ADR-106 Ф0: модель Authority-слоя — полномочия пользователей и агентов
|
|
89
|
+
// как контент (Principal/Action/Target/Grant/Role/Ceiling/Turn/Approval).
|
|
90
|
+
export * from './authority.js';
|
|
91
|
+
// ADR-051/ADR-100: контракт пайплайна (определение, шаг, экземпляр)
|
|
92
|
+
export * from './pipeline.js';
|
|
93
|
+
// ADR-101: контракты пайплайна как второго движка (спецификация, узлы,
|
|
94
|
+
// переходы, триггер, результат узла, прогон, журнал) — re-exported from pipeline-engine.ts
|
|
95
|
+
export * from './pipeline-engine.js';
|
|
96
|
+
// Этап 1 roadmap 0.13: «вопрос пользователю» (ask_user) — типы записи вопроса
|
|
97
|
+
// + Zod-схемы HTTP-входа (ответа/отмены).
|
|
98
|
+
export * from './question.js';
|
|
99
|
+
// Этап 1 roadmap 0.13: единый реестр фоновых прогонов (фоновые саб-агенты и
|
|
100
|
+
// шелл-процессы) — типы записи и фильтра выборки.
|
|
101
|
+
export * from './background.js';
|
|
102
|
+
// Этап 1 roadmap 0.13 (блок 1.4): git worktrees — per-session рабочий каталог
|
|
103
|
+
// (ADR-114): тип записи, тела HTTP-входа и привязка сессии.
|
|
104
|
+
export * from './worktree.js';
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-090: контракт фильтра LLM-вызовов.
|
|
3
|
+
*
|
|
4
|
+
* Модуль browser-safe (только типы и чистые функции) — его используют и ядро
|
|
5
|
+
* (`GatewayProvider`), и будущий пакет `@itphx/synth-plugin`.
|
|
6
|
+
*
|
|
7
|
+
* **Границы контракта.**
|
|
8
|
+
* - Вход фильтра — **узкий DTO**: ни портов, ни функций, ни внутренних полей
|
|
9
|
+
* сообщений (как `PromptBlockContext` в точке `promptBlocks`).
|
|
10
|
+
* - Тип сообщения — `LlmFilterMessage`, а не `LLMMessage` из core
|
|
11
|
+
* (`packages/core/src/providers/base.ts`): контракт живёт в `shared`, а
|
|
12
|
+
* `LLMMessage` — внутренний тип ядра с полями служебного назначения
|
|
13
|
+
* (`branchId`/`pinned`/`usage`). Дублировать `LLMMessage` в `shared` нельзя —
|
|
14
|
+
* он разошёлся бы с ядром; поэтому фильтр видит только роль и текст.
|
|
15
|
+
* - Поведение при сбое/таймауте задаёт `failMode`; **по умолчанию** — по
|
|
16
|
+
* классу фильтра: блокирующий (`closed`) — наблюдательный (`open`).
|
|
17
|
+
* - **Право вето — только у доверенных**: фильтр с trust ниже `trusted` не
|
|
18
|
+
* может заблокировать или переписать вызов — хост понижает его вердикт до
|
|
19
|
+
* `allow` (ADR-090).
|
|
20
|
+
*/
|
|
21
|
+
import type { TokenUsage } from './llm.js';
|
|
22
|
+
/**
|
|
23
|
+
* Фазы фильтра LLM-вызовов.
|
|
24
|
+
*
|
|
25
|
+
* - `pre_request` — до отправки запроса провайдеру (запрос уже обфусцирован);
|
|
26
|
+
* - `post_response` — после ответа провайдера (наблюдение: буферизация ответа
|
|
27
|
+
* запрещена, ADR-036);
|
|
28
|
+
* - `embedding` — перед вызовом эмбеддинга.
|
|
29
|
+
*/
|
|
30
|
+
export declare const LLM_FILTER_PHASES: readonly ["pre_request", "post_response", "embedding"];
|
|
31
|
+
export type LlmFilterPhase = (typeof LLM_FILTER_PHASES)[number];
|
|
32
|
+
/**
|
|
33
|
+
* Поведение фильтра при сбое/таймауте:
|
|
34
|
+
* - `closed` — вызов **не уходит** провайдеру (fail-closed);
|
|
35
|
+
* - `open` — вызов идёт как есть (fail-open), факт сбоя — в аудите.
|
|
36
|
+
*/
|
|
37
|
+
export declare const LLM_FILTER_FAIL_MODES: readonly ["open", "closed"];
|
|
38
|
+
export type LlmFilterFailMode = (typeof LLM_FILTER_FAIL_MODES)[number];
|
|
39
|
+
/**
|
|
40
|
+
* Вердикт фильтра:
|
|
41
|
+
* - `allow` — пропустить вызов;
|
|
42
|
+
* - `deny` — заблокировать вызов (вызов не уходит провайдеру);
|
|
43
|
+
* - `redact` — заменить содержимое (`post_response`/`embedding`).
|
|
44
|
+
*/
|
|
45
|
+
export declare const LLM_FILTER_VERDICTS: readonly ["allow", "deny", "redact"];
|
|
46
|
+
export type LlmFilterVerdictKind = (typeof LLM_FILTER_VERDICTS)[number];
|
|
47
|
+
/**
|
|
48
|
+
* Сообщение запроса в виде узкого DTO (без служебных полей `LLMMessage`).
|
|
49
|
+
*/
|
|
50
|
+
export interface LlmFilterMessage {
|
|
51
|
+
/** Роль сообщения (`user`/`assistant`/`system`/`tool`). */
|
|
52
|
+
readonly role: string;
|
|
53
|
+
/** Текст сообщения. */
|
|
54
|
+
readonly content: string;
|
|
55
|
+
/** Вызовы инструментов сообщения (структура провайдера — как есть). */
|
|
56
|
+
readonly toolCalls?: readonly Record<string, unknown>[];
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Вход фильтра — узкий DTO (без портов и функций).
|
|
60
|
+
*
|
|
61
|
+
* Поля по фазам:
|
|
62
|
+
* - `pre_request`: `messages`/`systemPrompt`/`tools`;
|
|
63
|
+
* - `post_response`: `content`/`usage`;
|
|
64
|
+
* - `embedding`: `texts`.
|
|
65
|
+
*/
|
|
66
|
+
export interface LlmFilterInput {
|
|
67
|
+
/** Фаза, в которой вызван фильтр. */
|
|
68
|
+
readonly phase: LlmFilterPhase;
|
|
69
|
+
/** Имя провайдера. */
|
|
70
|
+
readonly provider: string;
|
|
71
|
+
/** Модель. */
|
|
72
|
+
readonly model: string;
|
|
73
|
+
/** Сессия (пусто — вызов вне сессии: пул провайдеров, суммаризация). */
|
|
74
|
+
readonly sessionId?: string;
|
|
75
|
+
/** `pre_request`: сообщения запроса (уже обфусцированные). */
|
|
76
|
+
readonly messages?: readonly LlmFilterMessage[];
|
|
77
|
+
/** `pre_request`: текст системного промпта. */
|
|
78
|
+
readonly systemPrompt?: string;
|
|
79
|
+
/** `pre_request`: описание инструментов. */
|
|
80
|
+
readonly tools?: readonly Record<string, unknown>[];
|
|
81
|
+
/** `post_response`: полный текст ответа. */
|
|
82
|
+
readonly content?: string;
|
|
83
|
+
/** `post_response`: расход токенов. */
|
|
84
|
+
readonly usage?: TokenUsage;
|
|
85
|
+
/** `embedding`: тексты, уходящие в эмбеддинг. */
|
|
86
|
+
readonly texts?: readonly string[];
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* Вердикт фильтра.
|
|
90
|
+
*
|
|
91
|
+
* `redactedContent` — только для `redact` в `post_response`, `redactedTexts` —
|
|
92
|
+
* только для `redact` в `embedding`.
|
|
93
|
+
*/
|
|
94
|
+
export interface LlmFilterVerdict {
|
|
95
|
+
/** Вердикт. */
|
|
96
|
+
readonly verdict: LlmFilterVerdictKind;
|
|
97
|
+
/** Человекочитаемая причина (попадает в аудит и в текст ответа). */
|
|
98
|
+
readonly reason?: string;
|
|
99
|
+
/** Машиночитаемый код причины. */
|
|
100
|
+
readonly code?: string;
|
|
101
|
+
/** Новое содержимое ответа (`redact` в `post_response`). */
|
|
102
|
+
readonly redactedContent?: string;
|
|
103
|
+
/** Новые тексты (`redact` в `embedding`). */
|
|
104
|
+
readonly redactedTexts?: readonly string[];
|
|
105
|
+
}
|
|
106
|
+
/**
|
|
107
|
+
* Фильтр LLM-вызовов (точка расширения `llmFilters`).
|
|
108
|
+
*
|
|
109
|
+
* Идентификатор — `plugin:<pluginName>:<filterName>`: префикс проверяет хост
|
|
110
|
+
* (чужой плагин не может занять id другого).
|
|
111
|
+
*/
|
|
112
|
+
export interface LlmCallFilter {
|
|
113
|
+
/** Идентификатор фильтра: `plugin:<pluginName>:<filterName>`. */
|
|
114
|
+
readonly id: string;
|
|
115
|
+
/** Фаза вызова фильтра. */
|
|
116
|
+
readonly phase: LlmFilterPhase;
|
|
117
|
+
/**
|
|
118
|
+
* Поведение при сбое/таймауте. Не задан — по классу фильтра:
|
|
119
|
+
* блокирующий (`closed`) / наблюдательный (`open`).
|
|
120
|
+
*/
|
|
121
|
+
readonly failMode?: LlmFilterFailMode;
|
|
122
|
+
/** Бюджет времени на вызов фильтра, мс. Не задан — из политики плагинов. */
|
|
123
|
+
readonly timeoutMs?: number;
|
|
124
|
+
/** Проверка. Возвращает вердикт. */
|
|
125
|
+
inspect(input: LlmFilterInput): Promise<LlmFilterVerdict> | LlmFilterVerdict;
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* Бюджет времени на один вызов фильтра по умолчанию, мс
|
|
129
|
+
* (`plugins.llmFilterTimeoutMs` в конфиге).
|
|
130
|
+
*
|
|
131
|
+
* Единый источник истины для конфига (`config/defaults.ts`) и для хоста
|
|
132
|
+
* (реестр фильтров). Точное значение — вопрос владельца (ADR-090,
|
|
133
|
+
* «Бюджет времени фильтра»): механизм fail-closed/open реализован, число
|
|
134
|
+
* подтверждается отдельно.
|
|
135
|
+
*/
|
|
136
|
+
export declare const DEFAULT_LLM_FILTER_TIMEOUT_MS = 1000;
|
|
137
|
+
/** Фаза — известное значение перечня. */
|
|
138
|
+
export declare function isLlmFilterPhase(value: unknown): value is LlmFilterPhase;
|
|
139
|
+
/** Режим отказа — известное значение перечня. */
|
|
140
|
+
export declare function isLlmFilterFailMode(value: unknown): value is LlmFilterFailMode;
|
|
141
|
+
/** Вердикт — известное значение перечня. */
|
|
142
|
+
export declare function isLlmFilterVerdictKind(value: unknown): value is LlmFilterVerdictKind;
|
|
143
|
+
/**
|
|
144
|
+
* Может ли фильтр в этой фазе **заблокировать** вызов.
|
|
145
|
+
*
|
|
146
|
+
* `post_response` — не может: блокировка/правка ответа требует буферизации,
|
|
147
|
+
* а ADR-036 прямо запрещает буферы и задержки. В первой волне фаза
|
|
148
|
+
* `post_response` — только наблюдение.
|
|
149
|
+
*/
|
|
150
|
+
export declare function phaseCanBlock(phase: LlmFilterPhase): boolean;
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Фазы фильтра LLM-вызовов.
|
|
3
|
+
*
|
|
4
|
+
* - `pre_request` — до отправки запроса провайдеру (запрос уже обфусцирован);
|
|
5
|
+
* - `post_response` — после ответа провайдера (наблюдение: буферизация ответа
|
|
6
|
+
* запрещена, ADR-036);
|
|
7
|
+
* - `embedding` — перед вызовом эмбеддинга.
|
|
8
|
+
*/
|
|
9
|
+
export const LLM_FILTER_PHASES = ['pre_request', 'post_response', 'embedding'];
|
|
10
|
+
/**
|
|
11
|
+
* Поведение фильтра при сбое/таймауте:
|
|
12
|
+
* - `closed` — вызов **не уходит** провайдеру (fail-closed);
|
|
13
|
+
* - `open` — вызов идёт как есть (fail-open), факт сбоя — в аудите.
|
|
14
|
+
*/
|
|
15
|
+
export const LLM_FILTER_FAIL_MODES = ['open', 'closed'];
|
|
16
|
+
/**
|
|
17
|
+
* Вердикт фильтра:
|
|
18
|
+
* - `allow` — пропустить вызов;
|
|
19
|
+
* - `deny` — заблокировать вызов (вызов не уходит провайдеру);
|
|
20
|
+
* - `redact` — заменить содержимое (`post_response`/`embedding`).
|
|
21
|
+
*/
|
|
22
|
+
export const LLM_FILTER_VERDICTS = ['allow', 'deny', 'redact'];
|
|
23
|
+
/**
|
|
24
|
+
* Бюджет времени на один вызов фильтра по умолчанию, мс
|
|
25
|
+
* (`plugins.llmFilterTimeoutMs` в конфиге).
|
|
26
|
+
*
|
|
27
|
+
* Единый источник истины для конфига (`config/defaults.ts`) и для хоста
|
|
28
|
+
* (реестр фильтров). Точное значение — вопрос владельца (ADR-090,
|
|
29
|
+
* «Бюджет времени фильтра»): механизм fail-closed/open реализован, число
|
|
30
|
+
* подтверждается отдельно.
|
|
31
|
+
*/
|
|
32
|
+
export const DEFAULT_LLM_FILTER_TIMEOUT_MS = 1000;
|
|
33
|
+
/** Фаза — известное значение перечня. */
|
|
34
|
+
export function isLlmFilterPhase(value) {
|
|
35
|
+
return LLM_FILTER_PHASES.includes(value);
|
|
36
|
+
}
|
|
37
|
+
/** Режим отказа — известное значение перечня. */
|
|
38
|
+
export function isLlmFilterFailMode(value) {
|
|
39
|
+
return LLM_FILTER_FAIL_MODES.includes(value);
|
|
40
|
+
}
|
|
41
|
+
/** Вердикт — известное значение перечня. */
|
|
42
|
+
export function isLlmFilterVerdictKind(value) {
|
|
43
|
+
return LLM_FILTER_VERDICTS.includes(value);
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Может ли фильтр в этой фазе **заблокировать** вызов.
|
|
47
|
+
*
|
|
48
|
+
* `post_response` — не может: блокировка/правка ответа требует буферизации,
|
|
49
|
+
* а ADR-036 прямо запрещает буферы и задержки. В первой волне фаза
|
|
50
|
+
* `post_response` — только наблюдение.
|
|
51
|
+
*/
|
|
52
|
+
export function phaseCanBlock(phase) {
|
|
53
|
+
return phase === 'pre_request' || phase === 'embedding';
|
|
54
|
+
}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-092 (остаток): аудит-журнал обслуживания инстанса.
|
|
3
|
+
*
|
|
4
|
+
* Append-only журнал операций жизненного цикла (`synth backup`/`restore`/
|
|
5
|
+
* `migrate`/`update`/`rollback`/`uninstall`, экспорт/импорт) — «что, когда и
|
|
6
|
+
* кем» менялось в инстансе. Журнал не является частью доменных данных: его
|
|
7
|
+
* события лишь фиксируют факт операции и её итог. Хранилище — доменный порт
|
|
8
|
+
* `MaintenanceAuditRepository` (ADR-096), файловая реализация —
|
|
9
|
+
* `{dataDir}/audit/maintenance.jsonl`.
|
|
10
|
+
*/
|
|
11
|
+
/** ADR-092: вид операции обслуживания инстанса. */
|
|
12
|
+
export type MaintenanceAuditOp = 'backup.created' | 'backup.failed' | 'backup.deleted' | 'restore.scheduled' | 'restore.cancelled' | 'restore.applied' | 'restore.failed' | 'migrate.applied' | 'migrate.failed' | 'update.applied' | 'rollback.applied' | 'update.failed' | 'uninstall.purge' | 'export.created' | 'import.applied' | 'restart.requested';
|
|
13
|
+
/** ADR-092: итог операции обслуживания. */
|
|
14
|
+
export type MaintenanceAuditStatus = 'ok' | 'failed' | 'scheduled';
|
|
15
|
+
/**
|
|
16
|
+
* ADR-092: одна запись аудит-журнала обслуживания инстанса.
|
|
17
|
+
*
|
|
18
|
+
* Пишется best-effort (ошибка записи не ломает операцию). `id` формирует
|
|
19
|
+
* вызывающий (`ma_<uuid>`), `ts` — ISO-8601. `actor` — инициатор (`userId` при
|
|
20
|
+
* API/UI, `'cli'` при командной строке, `'startup'` при применении на старте).
|
|
21
|
+
*/
|
|
22
|
+
export interface MaintenanceAuditEntry {
|
|
23
|
+
/** `ma_<uuid>`, уникален в пределах инстанса. */
|
|
24
|
+
id: string;
|
|
25
|
+
/** Метка события, ISO-8601. */
|
|
26
|
+
ts: string;
|
|
27
|
+
/** Вид операции обслуживания. */
|
|
28
|
+
op: MaintenanceAuditOp;
|
|
29
|
+
/** Итог операции. */
|
|
30
|
+
status: MaintenanceAuditStatus;
|
|
31
|
+
/** Инициатор: `userId` (API/UI) | `'cli'` | `'startup'`. */
|
|
32
|
+
actor?: string;
|
|
33
|
+
/** Версия пакета (`SYNTH_VERSION`) на момент операции. */
|
|
34
|
+
version?: string;
|
|
35
|
+
/** Детали операции (поля зависят от `op`). */
|
|
36
|
+
details?: Record<string, unknown>;
|
|
37
|
+
/** Текст ошибки при `status === 'failed'`. */
|
|
38
|
+
error?: string;
|
|
39
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-092 (остаток): аудит-журнал обслуживания инстанса.
|
|
3
|
+
*
|
|
4
|
+
* Append-only журнал операций жизненного цикла (`synth backup`/`restore`/
|
|
5
|
+
* `migrate`/`update`/`rollback`/`uninstall`, экспорт/импорт) — «что, когда и
|
|
6
|
+
* кем» менялось в инстансе. Журнал не является частью доменных данных: его
|
|
7
|
+
* события лишь фиксируют факт операции и её итог. Хранилище — доменный порт
|
|
8
|
+
* `MaintenanceAuditRepository` (ADR-096), файловая реализация —
|
|
9
|
+
* `{dataDir}/audit/maintenance.jsonl`.
|
|
10
|
+
*/
|
|
11
|
+
export {};
|
package/dist/types/mcp.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { McpServerConfig } from '../config/types.js';
|
|
2
2
|
import type { McpToolDetail } from './prompt.js';
|
|
3
|
-
/** Версия схемы записи реестра MCP — для будущей миграции (
|
|
3
|
+
/** Версия схемы записи реестра MCP — для будущей миграции (ADR-096). */
|
|
4
4
|
export declare const MCP_REGISTRY_SCHEMA_VERSION = 1;
|
|
5
5
|
export declare const MCP_REGISTRY_ORIGINS: readonly ["instance", "user"];
|
|
6
6
|
export type McpRegistryOrigin = (typeof MCP_REGISTRY_ORIGINS)[number];
|
|
@@ -14,7 +14,7 @@ export interface McpRegistryAuthor {
|
|
|
14
14
|
/**
|
|
15
15
|
* ADR-071 §2.5: плоская запись единого реестра MCP-серверов.
|
|
16
16
|
*
|
|
17
|
-
* Логическая модель сразу проектируется под PostgreSQL (
|
|
17
|
+
* Логическая модель сразу проектируется под PostgreSQL (ADR-097): стабильный
|
|
18
18
|
* `id`, `schemaVersion`, timestamps; вложенность ограничена `config`/`author`
|
|
19
19
|
* (раскладываются в JSONB/отдельные колонки). Instance- и пользовательские
|
|
20
20
|
* записи различаются полем `origin`, не отдельными реестрами.
|
|
@@ -51,10 +51,75 @@ export type McpNetworkPolicyMode = (typeof MCP_NETWORK_POLICY_MODES)[number];
|
|
|
51
51
|
export interface McpNetworkPolicy {
|
|
52
52
|
mode: McpNetworkPolicyMode;
|
|
53
53
|
list: string[];
|
|
54
|
+
/**
|
|
55
|
+
* Allow-правила-исключения (точный hostname, `*.suffix`, CIDR/IP).
|
|
56
|
+
* Проверяются первыми; формат/семантика общие с `egress.tools`/`egress.webhooks`.
|
|
57
|
+
*/
|
|
58
|
+
exceptions?: string[];
|
|
54
59
|
}
|
|
55
|
-
/**
|
|
56
|
-
|
|
57
|
-
|
|
60
|
+
/**
|
|
61
|
+
* Служебные/специальные адресные диапазоны, запрещённые по умолчанию (SSRF/egress).
|
|
62
|
+
*
|
|
63
|
+
* **Единственный источник истины** для всех egress-политик: `mcp.networkPolicy`,
|
|
64
|
+
* `egress.tools`, `egress.webhooks` (`types/egress.ts`) и встроенный fallback
|
|
65
|
+
* guard'а (`core/engine/net/egress-guard.ts` → `isBlockedIp` без политики).
|
|
66
|
+
* Отдельных списков «заблокированных адресов» в коде больше нет: расширять
|
|
67
|
+
* нужно этот список, иначе политика и guard разойдутся (промис не будет
|
|
68
|
+
* подкреплён кодом).
|
|
69
|
+
*
|
|
70
|
+
* **Правило отбора:** диапазоны, которые не маршрутизируются в публичном
|
|
71
|
+
* интернете (IANA IPv4/IPv6 Special-Purpose Address Registry) либо непригодны
|
|
72
|
+
* как цель исходящего HTTP-запроса (multicast, limited broadcast).
|
|
73
|
+
*
|
|
74
|
+
* IPv4:
|
|
75
|
+
* - `0.0.0.0/8` — «this network»; `0.0.0.0` на Linux ведёт на localhost;
|
|
76
|
+
* - `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16` — RFC1918 (private);
|
|
77
|
+
* - `100.64.0.0/10` — CGNAT (RFC 6598); в ряде облаков это адрес метаданных
|
|
78
|
+
* (напр. Alibaba `100.100.100.200`);
|
|
79
|
+
* - `127.0.0.0/8` — loopback;
|
|
80
|
+
* - `169.254.0.0/16` — link-local (в т.ч. `169.254.169.254` — метаданные облака);
|
|
81
|
+
* - `192.0.0.0/24` — IETF protocol assignments (RFC 6890), включая well-known
|
|
82
|
+
* NAT64-префиксы `192.0.0.170/171` (RFC 6052): через них внутренний IPv4
|
|
83
|
+
* достигается по IPv6-адресу и v4-список его не ловит;
|
|
84
|
+
* - `192.0.2.0/24`, `198.51.100.0/24`, `203.0.113.0/24` — TEST-NET-1/2/3
|
|
85
|
+
* (RFC 5737): SSRF-риска не несут (не маршрутизируются), но заблокированы
|
|
86
|
+
* вместе со всеми прочими служебными диапазонами — список самосогласован
|
|
87
|
+
* («всё специальное»), риск-оценка не нужна по каждому адресу, а вернуть
|
|
88
|
+
* конкретный адрес можно явным exception политики;
|
|
89
|
+
* - `192.88.99.0/24` — 6to4 relay anycast (RFC 7526, deprecated);
|
|
90
|
+
* - `198.18.0.0/15` — benchmarking (RFC 2544);
|
|
91
|
+
* - `224.0.0.0/4` — multicast: цель для SSRF во внутренние multicast-группы
|
|
92
|
+
* (mDNS/SSDP и т.п.);
|
|
93
|
+
* - `240.0.0.0/4` — reserved (RFC 1112);
|
|
94
|
+
* - `255.255.255.255/32` — limited broadcast.
|
|
95
|
+
*
|
|
96
|
+
* IPv6:
|
|
97
|
+
* - `::/128` — unspecified, на части стеков эквивалентен loopback;
|
|
98
|
+
* - `::1/128` — loopback;
|
|
99
|
+
* - `::ffff:0:0/96` — IPv4-mapped IPv6. Mapped-запись — типичная попытка обхода
|
|
100
|
+
* (v4-диапазоны её не ловят), легитимные адреса приходят обычным v4/v6,
|
|
101
|
+
* поэтому mapped-форма блокируется целиком; `isIpInCidr` дополнительно
|
|
102
|
+
* приводит mapped к вложенному IPv4 (`::ffff:127.0.0.1` ← `127.0.0.0/8`);
|
|
103
|
+
* - `100::/64` — discard-only (RFC 6666);
|
|
104
|
+
* - `2001:2::/48` — benchmarking (IPv6);
|
|
105
|
+
* - `2001:db8::/32` — documentation (IPv6);
|
|
106
|
+
* - `2002::/16` — 6to4 (RFC 7526, deprecated): адрес вшивает IPv4, поэтому
|
|
107
|
+
* недостижим для v4-списка;
|
|
108
|
+
* - `fc00::/7` — ULA;
|
|
109
|
+
* - `fe80::/10` — link-local;
|
|
110
|
+
* - `ff00::/8` — multicast.
|
|
111
|
+
*
|
|
112
|
+
* Осознанно НЕ включены (иначе ломается легитимный egress):
|
|
113
|
+
* - `64:ff9b::/96` (NAT64 well-known prefix) и `64:ff9b:1::/48` (local-use
|
|
114
|
+
* NAT64, RFC 8215) — на IPv6-only сетях с DNS64 резолвер отдаёт
|
|
115
|
+
* синтезированные AAAA именно из этих префиксов; их блокировка заблокировала
|
|
116
|
+
* бы весь исходящий трафик к публичным хостам;
|
|
117
|
+
* - глобально маршрутизируемые служебные блоки (`192.31.196.0/24` AS112-v4,
|
|
118
|
+
* `192.52.193.0/24` AMT, `192.175.48.0/24` AS112, `2001:4860::/32` и т.п.) —
|
|
119
|
+
* это обычные публичные адреса.
|
|
120
|
+
*/
|
|
121
|
+
export declare const DEFAULT_MCP_PRIVATE_CIDRS: readonly ["0.0.0.0/8", "10.0.0.0/8", "100.64.0.0/10", "127.0.0.0/8", "169.254.0.0/16", "172.16.0.0/12", "192.0.0.0/24", "192.0.2.0/24", "192.88.99.0/24", "192.168.0.0/16", "198.18.0.0/15", "198.51.100.0/24", "203.0.113.0/24", "224.0.0.0/4", "240.0.0.0/4", "255.255.255.255/32", "::/128", "::1/128", "::ffff:0:0/96", "100::/64", "2001:2::/48", "2001:db8::/32", "2002::/16", "fc00::/7", "fe80::/10", "ff00::/8"];
|
|
122
|
+
/** Дефолтная политика: deny служебных диапазонов (ADR-071 §2.3.1). */
|
|
58
123
|
export declare const DEFAULT_MCP_NETWORK_POLICY: McpNetworkPolicy;
|
|
59
124
|
export declare const MCP_SERVER_LEVELS: readonly ["system", "project", "session"];
|
|
60
125
|
export type McpServerLevel = (typeof MCP_SERVER_LEVELS)[number];
|
|
@@ -102,3 +167,34 @@ export interface McpServerEffective {
|
|
|
102
167
|
/** ADR-071 §2.6: пер-тульные chars/estTokens/ratio + признак admin_disabled. */
|
|
103
168
|
toolDetails?: McpToolDetail[];
|
|
104
169
|
}
|
|
170
|
+
/**
|
|
171
|
+
* Машинно-читаемый код ошибки записи реестра MCP с plaintext-секретом
|
|
172
|
+
* в заголовках (ADR-105 §5, Ф3).
|
|
173
|
+
*
|
|
174
|
+
* HTTP: `400` с `error.code = "MCP_SECRET_HEADER_FORBIDDEN"`.
|
|
175
|
+
*/
|
|
176
|
+
export declare const MCP_SECRET_HEADER_ERROR_CODE = "MCP_SECRET_HEADER_FORBIDDEN";
|
|
177
|
+
/**
|
|
178
|
+
* Заголовки, значение которых — **секрет**. В реестре MCP (и в конфиге
|
|
179
|
+
* коннектора) им не место: токен лежит в слое внешних доступов
|
|
180
|
+
* (`ExternalCredential`, ADR-105), а коннектор ссылается на него по id
|
|
181
|
+
* (`auth: { kind: 'credential', credentialId }`).
|
|
182
|
+
*
|
|
183
|
+
* Сравнение — регистронезависимое (HTTP-заголовки нечувствительны к регистру).
|
|
184
|
+
*/
|
|
185
|
+
export declare const FORBIDDEN_MCP_SECRET_HEADERS: readonly ["authorization", "proxy-authorization", "x-api-key", "cookie"];
|
|
186
|
+
export type ForbiddenMcpSecretHeader = (typeof FORBIDDEN_MCP_SECRET_HEADERS)[number];
|
|
187
|
+
/**
|
|
188
|
+
* Найти запрещённые (секретные) заголовки в словаре `headers`.
|
|
189
|
+
*
|
|
190
|
+
* Возвращает **исходные имена** заголовков (как их записал пользователь) —
|
|
191
|
+
* они уходят в сообщение об ошибке (значения — никогда).
|
|
192
|
+
*/
|
|
193
|
+
export declare function findForbiddenMcpSecretHeaders(headers: Record<string, string> | undefined | null): string[];
|
|
194
|
+
/**
|
|
195
|
+
* Текст ошибки «секретный заголовок в коннекторе» — **единый** для слоя
|
|
196
|
+
* хранилища, HTTP-роутов (core/backend) и probe (ADR-105 §5, Ф3).
|
|
197
|
+
*
|
|
198
|
+
* Значений заголовков в тексте нет — только их имена.
|
|
199
|
+
*/
|
|
200
|
+
export declare function mcpSecretHeaderErrorMessage(forbidden: string[]): string;
|