@itphx/synth-shared 0.10.0 → 0.11.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 +60 -14
- package/dist/config/env-overrides.d.ts +7 -4
- package/dist/config/env-overrides.js +46 -13
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.js +3 -0
- package/dist/config/loader.d.ts +2 -2
- package/dist/config/loader.js +23 -4
- package/dist/config/proxy.d.ts +415 -0
- package/dist/config/proxy.js +1565 -0
- package/dist/config/resolve.d.ts +77 -10
- package/dist/config/resolve.js +203 -17
- 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 +1820 -334
- package/dist/config/types.js +320 -54
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +18 -10
- package/dist/index.d.ts +11 -2
- package/dist/index.js +11 -2
- package/dist/interfaces/index.d.ts +3 -3
- package/dist/protocols/index.d.ts +0 -1
- package/dist/schemas/index.d.ts +230 -105
- package/dist/schemas/index.js +121 -74
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +30 -0
- package/dist/types/agent.js +1 -0
- package/dist/types/analytics.d.ts +113 -0
- package/dist/types/analytics.js +61 -0
- package/dist/types/bus-events.d.ts +7 -0
- package/dist/types/bus-events.js +1 -0
- package/dist/types/commands.d.ts +10 -10
- package/dist/types/commands.js +2 -2
- package/dist/types/decision.d.ts +16 -16
- package/dist/types/decision.js +4 -4
- package/dist/types/egress.d.ts +114 -0
- package/dist/types/egress.js +68 -0
- package/dist/types/events.d.ts +22 -23
- package/dist/types/fs.d.ts +55 -0
- package/dist/types/fs.js +27 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +24 -4
- package/dist/types/index.d.ts +15 -1165
- package/dist/types/index.js +44 -244
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/maintenance.d.ts +39 -0
- package/dist/types/maintenance.js +11 -0
- package/dist/types/mcp.d.ts +169 -0
- package/dist/types/mcp.js +119 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +9 -7
- package/dist/types/permission.js +1 -1
- package/dist/types/project.d.ts +134 -0
- package/dist/types/project.js +67 -0
- package/dist/types/prompt.d.ts +237 -0
- package/dist/types/prompt.js +15 -0
- package/dist/types/provider.d.ts +84 -0
- package/dist/types/provider.js +35 -0
- package/dist/types/schedules.d.ts +8 -8
- package/dist/types/schedules.js +1 -1
- package/dist/types/service-keys.d.ts +10 -10
- package/dist/types/service-keys.js +3 -3
- package/dist/types/session.d.ts +268 -0
- package/dist/types/session.js +13 -0
- package/dist/types/skills.d.ts +11 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/tools.d.ts +3 -3
- package/dist/types/user.d.ts +113 -0
- package/dist/types/user.js +31 -0
- package/dist/types/webhooks.d.ts +6 -6
- package/dist/types/webhooks.js +1 -1
- package/dist/utils/glob.d.ts +1 -1
- package/dist/utils/glob.js +1 -1
- package/dist/utils/index.d.ts +15 -0
- package/dist/utils/index.js +55 -2
- package/dist/utils/workspace.js +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
package/dist/types/index.js
CHANGED
|
@@ -1,255 +1,55 @@
|
|
|
1
|
-
//
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
export
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
export
|
|
27
|
-
(
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
StatusMessageType["ERROR"] = "error";
|
|
31
|
-
StatusMessageType["STREAM"] = "stream";
|
|
32
|
-
})(StatusMessageType || (StatusMessageType = {}));
|
|
33
|
-
// --- Оценка токенов по символам (AD-071 §2.6) ---
|
|
34
|
-
/** Дефолтный chars-per-token, если калибровки для модели нет. */
|
|
35
|
-
export const DEFAULT_CHARS_PER_TOKEN = 4;
|
|
36
|
-
/**
|
|
37
|
-
* Нижняя граница разумного chars-per-token (аномальные семплы отбрасываются).
|
|
38
|
-
* CJK/эффективные BPE дают ~1–2 символа на токен, поэтому допускаем 1.5.
|
|
39
|
-
*/
|
|
40
|
-
export const MIN_CHARS_PER_TOKEN = 1.5;
|
|
41
|
-
/**
|
|
42
|
-
* Верхняя граница разумного chars-per-token. Берётся с запасом: «эффективные»
|
|
43
|
-
* токенизаторы (например, `omn.qwen3.8:27b`) дают ratio ≈ 11.7.
|
|
44
|
-
*/
|
|
45
|
-
export const MAX_CHARS_PER_TOKEN = 16;
|
|
46
|
-
/** Минимальный `usage.inputTokens` для калибровки — меньшие значения шумные. */
|
|
47
|
-
export const MIN_CALIBRATION_INPUT_TOKENS = 500;
|
|
48
|
-
export const PLAN_MODES = ['auto', 'strict', 'off'];
|
|
49
|
-
export const SESSION_MODES = ['plan', 'act', 'yolo'];
|
|
50
|
-
/**
|
|
51
|
-
* AD-071 §2.3: политика включения инструментов в запрос.
|
|
52
|
-
* - `consistency` — в запрос идут все определения, недоступность кодируется
|
|
53
|
-
* permission-слоем (`unavailable(mode|role)`); приоритет — валидность кэша;
|
|
54
|
-
* - `available` — в запрос идут только доступные агенту/режиму/роли тулы;
|
|
55
|
-
* приоритет — экономия контекстного окна;
|
|
56
|
-
* - `auto` — выбор по провайдеру/модели: локальные → `available`, облачные → `consistency`.
|
|
57
|
-
*/
|
|
58
|
-
export const TOOLS_POLICIES = ['consistency', 'available', 'auto'];
|
|
59
|
-
// --- MCP: реестр серверов и сетевой доступ (AD-071 §2.3.1/§2.5) ---
|
|
60
|
-
/** Версия схемы записи реестра MCP — для будущей миграции (AD-032). */
|
|
61
|
-
export const MCP_REGISTRY_SCHEMA_VERSION = 1;
|
|
62
|
-
export const MCP_REGISTRY_ORIGINS = ['instance', 'user'];
|
|
63
|
-
export const MCP_REGISTRY_TRUST_LEVELS = ['builtin', 'community'];
|
|
64
|
-
export const MCP_NETWORK_POLICY_MODES = ['allow', 'deny'];
|
|
65
|
-
/** Приватные/служебные диапазоны, запрещённые по умолчанию (SSRF/egress). */
|
|
66
|
-
export const DEFAULT_MCP_PRIVATE_CIDRS = [
|
|
67
|
-
'10.0.0.0/8',
|
|
68
|
-
'172.16.0.0/12',
|
|
69
|
-
'192.168.0.0/16',
|
|
70
|
-
'127.0.0.0/8',
|
|
71
|
-
'169.254.0.0/16',
|
|
72
|
-
'::1/128',
|
|
73
|
-
'fc00::/7',
|
|
74
|
-
'fe80::/10',
|
|
75
|
-
];
|
|
76
|
-
/** Дефолтная политика: deny приватных диапазонов (AD-071 §2.3.1). */
|
|
77
|
-
export const DEFAULT_MCP_NETWORK_POLICY = {
|
|
78
|
-
mode: 'deny',
|
|
79
|
-
list: [...DEFAULT_MCP_PRIVATE_CIDRS],
|
|
80
|
-
};
|
|
81
|
-
// --- MCP: уровни/скоуп и эффективный набор (AD-071 §2.2/§2.4) ---
|
|
82
|
-
export const MCP_SERVER_LEVELS = ['system', 'project', 'session'];
|
|
83
|
-
/**
|
|
84
|
-
* AD-071 §2.2: почему сервер отключён в эффективном наборе сессии:
|
|
85
|
-
* - `system_disabled` — выключен системным мастер-флагом (`McpRegistryEntry.enabled === false`);
|
|
86
|
-
* - `project_disabled` — не разрешён проектом (`project.enabled` — hard-gate);
|
|
87
|
-
* - `session_optout` — явный opt-out в сессии (`mcpDisabledServers`);
|
|
88
|
-
* - `not_default` — нет в снапшоте сессии (`mcpDefaultOn`) и не включён явно.
|
|
89
|
-
*
|
|
90
|
-
* Причина `config` отсутствует: `McpServerConfig.enabled` — только сид записи
|
|
91
|
-
* реестра (`seedFromConfig`), в резолвинге/подключении не участвует.
|
|
92
|
-
*/
|
|
93
|
-
export const MCP_DISABLED_REASONS = [
|
|
94
|
-
'system_disabled',
|
|
95
|
-
'project_disabled',
|
|
96
|
-
'session_optout',
|
|
97
|
-
'not_default',
|
|
98
|
-
];
|
|
99
|
-
export const TODO_STATUSES = ['pending', 'in_progress', 'completed', 'cancelled'];
|
|
100
|
-
export const TODO_PRIORITIES = ['high', 'medium', 'low'];
|
|
101
|
-
/**
|
|
102
|
-
* Канонические ключи иконок проектов и сессий (единый список для server и UI).
|
|
103
|
-
* Значения — только ключи реестра (загружаемые картинки не поддерживаются).
|
|
104
|
-
*/
|
|
105
|
-
export const PROJECT_ICON_KEYS = [
|
|
106
|
-
'code',
|
|
107
|
-
'terminal',
|
|
108
|
-
'rocket',
|
|
109
|
-
'flask',
|
|
110
|
-
'gamepad',
|
|
111
|
-
'briefcase',
|
|
112
|
-
'home',
|
|
113
|
-
'globe',
|
|
114
|
-
'leaf',
|
|
115
|
-
'shield',
|
|
116
|
-
'palette',
|
|
117
|
-
'server',
|
|
118
|
-
'phone',
|
|
119
|
-
'database',
|
|
120
|
-
'lightbulb',
|
|
121
|
-
'music',
|
|
122
|
-
'camera',
|
|
123
|
-
'book',
|
|
124
|
-
'heart',
|
|
125
|
-
'folder',
|
|
126
|
-
'chat',
|
|
127
|
-
'cpu',
|
|
128
|
-
'file',
|
|
129
|
-
'file-code',
|
|
130
|
-
'docs',
|
|
131
|
-
'task',
|
|
132
|
-
'todo',
|
|
133
|
-
'bug',
|
|
134
|
-
'robot',
|
|
135
|
-
'brain',
|
|
136
|
-
'git',
|
|
137
|
-
'repo',
|
|
138
|
-
'test',
|
|
139
|
-
'chart',
|
|
140
|
-
'star',
|
|
141
|
-
'image',
|
|
142
|
-
'calendar',
|
|
143
|
-
];
|
|
144
|
-
/**
|
|
145
|
-
* Канонические ключи цветов проектов и сессий — 16 цветов палитры темы
|
|
146
|
-
* (`palette.colors[].key` в `a1..a16`; единый список для server и UI).
|
|
147
|
-
*/
|
|
148
|
-
export const PROJECT_COLOR_KEYS = [
|
|
149
|
-
'a1', 'a2', 'a3', 'a4',
|
|
150
|
-
'a5', 'a6', 'a7', 'a8',
|
|
151
|
-
'a9', 'a10', 'a11', 'a12',
|
|
152
|
-
'a13', 'a14', 'a15', 'a16',
|
|
153
|
-
];
|
|
154
|
-
// --- Currency ---
|
|
155
|
-
/** Валюта цен моделей. Отсутствует у модели → валюта провайдера → USD. */
|
|
156
|
-
export const CURRENCIES = ['RUB', 'USD', 'CNY'];
|
|
157
|
-
/** Проверка, что значение — допустимая валюта (RUB/USD/CNY). */
|
|
158
|
-
export function isCurrency(value) {
|
|
159
|
-
return typeof value === 'string' && CURRENCIES.includes(value);
|
|
160
|
-
}
|
|
161
|
-
/** Ленивый разбор валюты: неизвестное значение → undefined. */
|
|
162
|
-
export function parseCurrency(value) {
|
|
163
|
-
return isCurrency(value) ? value : undefined;
|
|
164
|
-
}
|
|
165
|
-
/**
|
|
166
|
-
* Строгий разбор поля `currency`:
|
|
167
|
-
* - `undefined` — поле не передано (сохранить existing);
|
|
168
|
-
* - `null`/`''` — явно очистить (undefined);
|
|
169
|
-
* - валидная валюта — принять;
|
|
170
|
-
* - иная непустая строка — ошибка (`ok: false`), чтобы не терять значение молча.
|
|
171
|
-
*/
|
|
172
|
-
export function parseCurrencyInput(raw, existing) {
|
|
173
|
-
if (raw === null || raw === '')
|
|
174
|
-
return { ok: true, currency: undefined };
|
|
175
|
-
if (raw === undefined)
|
|
176
|
-
return { ok: true, currency: existing };
|
|
177
|
-
return isCurrency(raw) ? { ok: true, currency: raw } : { ok: false };
|
|
178
|
-
}
|
|
179
|
-
/** Присутствуют ли в теле запроса ценовые поля (snake_case или camelCase). */
|
|
180
|
-
export function hasPriceInput(body) {
|
|
181
|
-
if (!body || typeof body !== 'object')
|
|
182
|
-
return false;
|
|
183
|
-
const b = body;
|
|
184
|
-
return 'input_price' in b || 'inputPrice' in b
|
|
185
|
-
|| 'output_price' in b || 'outputPrice' in b
|
|
186
|
-
|| 'cache_read_price' in b || 'cacheReadPrice' in b
|
|
187
|
-
|| 'cache_write_price' in b || 'cacheWritePrice' in b;
|
|
188
|
-
}
|
|
189
|
-
/**
|
|
190
|
-
* AD-036/AD-072: дефолт rate limit LLM Gateway. Единый источник для Zod-схемы
|
|
191
|
-
* конфига и runtime-дефолтов (settings-роуты, fallback'и backend/core).
|
|
192
|
-
*/
|
|
193
|
-
export const DEFAULT_LLM_GATEWAY_RATE_LIMIT = {
|
|
194
|
-
userPerMinute: 60,
|
|
195
|
-
providerPerMinute: 120,
|
|
196
|
-
};
|
|
197
|
-
/**
|
|
198
|
-
* AD-089: principalId внешнего отправителя из пары провайдер+id.
|
|
199
|
-
* Формат — `<provider>:<externalId>` (напр. `tg:450316139`).
|
|
200
|
-
*/
|
|
201
|
-
export function buildPrincipalId(provider, externalId) {
|
|
202
|
-
return `${provider}:${externalId}`;
|
|
203
|
-
}
|
|
204
|
-
/**
|
|
205
|
-
* AD-089: разбор principalId на `provider`/`externalId` — деление по **первому**
|
|
206
|
-
* `:`. Невалидное (нет `:`, пустые части) → `null`.
|
|
207
|
-
*/
|
|
208
|
-
export function parsePrincipalId(principalId) {
|
|
209
|
-
if (typeof principalId !== 'string')
|
|
210
|
-
return null;
|
|
211
|
-
const idx = principalId.indexOf(':');
|
|
212
|
-
if (idx <= 0 || idx === principalId.length - 1)
|
|
213
|
-
return null;
|
|
214
|
-
const provider = principalId.slice(0, idx);
|
|
215
|
-
const externalId = principalId.slice(idx + 1);
|
|
216
|
-
if (!provider || !externalId)
|
|
217
|
-
return null;
|
|
218
|
-
return { provider, externalId };
|
|
219
|
-
}
|
|
220
|
-
// --- File System ---
|
|
221
|
-
export var FsErrorCode;
|
|
222
|
-
(function (FsErrorCode) {
|
|
223
|
-
FsErrorCode["PATH_TRAVERSAL"] = "PATH_TRAVERSAL";
|
|
224
|
-
FsErrorCode["NOT_FOUND"] = "NOT_FOUND";
|
|
225
|
-
FsErrorCode["NOT_A_DIRECTORY"] = "NOT_A_DIRECTORY";
|
|
226
|
-
FsErrorCode["IS_DIRECTORY"] = "IS_DIRECTORY";
|
|
227
|
-
FsErrorCode["BINARY_FILE"] = "BINARY_FILE";
|
|
228
|
-
FsErrorCode["WORKSPACE_NOT_SET"] = "WORKSPACE_NOT_SET";
|
|
229
|
-
FsErrorCode["WORKSPACE_NOT_FOUND"] = "WORKSPACE_NOT_FOUND";
|
|
230
|
-
FsErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
|
|
231
|
-
FsErrorCode["ALREADY_EXISTS"] = "ALREADY_EXISTS";
|
|
232
|
-
FsErrorCode["DIR_NOT_EMPTY"] = "DIR_NOT_EMPTY";
|
|
233
|
-
/** AD-075: путь вне `workspacesRoot` запрещён политикой (managed). */
|
|
234
|
-
FsErrorCode["WORKSPACE_OUTSIDE_ROOT_DENIED"] = "WORKSPACE_OUTSIDE_ROOT_DENIED";
|
|
235
|
-
})(FsErrorCode || (FsErrorCode = {}));
|
|
1
|
+
// Barrel-фасад доменных модулей типов (ADR-095, шаг 2).
|
|
2
|
+
// Внешние импорты (`./types`/`../types/index.js`) остаются валидными: набор
|
|
3
|
+
// публичных имён не меняется, определения живут в доменных модулях.
|
|
4
|
+
// --- Доменные модули ---
|
|
5
|
+
// Common enums + сообщения/части (MessageRole, Message, Part, …)
|
|
6
|
+
export * from './message.js';
|
|
7
|
+
// Сессии, режимы, todo, настройки, статистика сессии
|
|
8
|
+
export * from './session.js';
|
|
9
|
+
// Промпт: состояние/манифест/история (ADR-070/071)
|
|
10
|
+
export * from './prompt.js';
|
|
11
|
+
// MCP: реестр серверов, сетевой доступ, уровни/эффективный набор (ADR-071)
|
|
12
|
+
export * from './mcp.js';
|
|
13
|
+
// Проекты, workspace-политика, иконки/цвета, план (ADR-039/075)
|
|
14
|
+
export * from './project.js';
|
|
15
|
+
// Git-репозитории и SSH-ключи (ADR-076)
|
|
16
|
+
export * from './git.js';
|
|
17
|
+
// Пользователи, auth и внешние идентичности (ADR-089)
|
|
18
|
+
export * from './user.js';
|
|
19
|
+
// Агенты (определения и режимы)
|
|
20
|
+
export * from './agent.js';
|
|
21
|
+
// Провайдеры, модели, контекст-файлы, валюты (ADR-034)
|
|
22
|
+
export * from './provider.js';
|
|
23
|
+
// LLM-чанки/ответы и дефолты Gateway (ADR-036)
|
|
24
|
+
export * from './llm.js';
|
|
25
|
+
// EventType/BusEvent — шина событий сессии (ADR-009/024)
|
|
26
|
+
export * from './bus-events.js';
|
|
27
|
+
// Файловая система (FS API v2)
|
|
28
|
+
export * from './fs.js';
|
|
29
|
+
// --- Реэкспорт существующих доменных модулей ---
|
|
236
30
|
// Tool types — re-exported from tools.ts
|
|
237
31
|
export * from './tools.js';
|
|
238
|
-
// Permission types (
|
|
32
|
+
// Permission types (ADR-029) — re-exported from permission.ts
|
|
239
33
|
export * from './permission.js';
|
|
240
|
-
// Skill types (
|
|
34
|
+
// Skill types (ADR-046) — re-exported from skills.ts
|
|
241
35
|
export * from './skills.js';
|
|
242
|
-
// Slash-команды и bundles (
|
|
36
|
+
// Slash-команды и bundles (ADR-046 §7) — re-exported from commands.ts
|
|
243
37
|
export * from './commands.js';
|
|
244
|
-
// Внешние события (
|
|
38
|
+
// Внешние события (ADR-089) — re-exported from events.ts
|
|
245
39
|
export * from './events.js';
|
|
246
|
-
// Hooks агента и интеграций (
|
|
40
|
+
// Hooks агента и интеграций (ADR-030) — re-exported from hooks.ts
|
|
247
41
|
export * from './hooks.js';
|
|
248
|
-
// Планировщик расписаний (
|
|
42
|
+
// Планировщик расписаний (ADR-051 срез / ADR-089) — re-exported from schedules.ts
|
|
249
43
|
export * from './schedules.js';
|
|
250
|
-
// Decision-модели (
|
|
44
|
+
// Decision-модели (ADR-084): контракт state+questions → answers — re-exported from decision.ts
|
|
251
45
|
export * from './decision.js';
|
|
252
|
-
//
|
|
46
|
+
// ADR-052 (этап I): service-key — scopes + проектная проекция — re-exported from service-keys.ts
|
|
253
47
|
export * from './service-keys.js';
|
|
254
|
-
//
|
|
48
|
+
// ADR-052 (этап II): исходящие webhooks — типы и матчер событий — re-exported from webhooks.ts
|
|
255
49
|
export * from './webhooks.js';
|
|
50
|
+
// ADR-092 (остаток): аудит-журнал обслуживания инстанса — re-exported from maintenance.ts
|
|
51
|
+
export * from './maintenance.js';
|
|
52
|
+
// Egress-политика, журнал внешних запросов и аудит security-политик
|
|
53
|
+
export * from './egress.js';
|
|
54
|
+
// Аналитика и отчётность инстанса: суточные роллапы (PROP-102)
|
|
55
|
+
export * from './analytics.js';
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-036/ADR-072: дефолт rate limit LLM Gateway. Единый источник для Zod-схемы
|
|
3
|
+
* конфига и runtime-дефолтов (settings-роуты, fallback'и backend/core).
|
|
4
|
+
*/
|
|
5
|
+
export declare const DEFAULT_LLM_GATEWAY_RATE_LIMIT: {
|
|
6
|
+
readonly userPerMinute: 60;
|
|
7
|
+
readonly providerPerMinute: 120;
|
|
8
|
+
};
|
|
9
|
+
export interface TokenUsage {
|
|
10
|
+
inputTokens: number;
|
|
11
|
+
outputTokens: number;
|
|
12
|
+
totalTokens: number;
|
|
13
|
+
cacheReadTokens?: number;
|
|
14
|
+
cacheWriteTokens?: number;
|
|
15
|
+
reasoningTokens?: number;
|
|
16
|
+
}
|
|
17
|
+
export interface LLMChunk {
|
|
18
|
+
content: string;
|
|
19
|
+
isFinal: boolean;
|
|
20
|
+
usage?: TokenUsage;
|
|
21
|
+
toolCalls?: Record<string, unknown>[];
|
|
22
|
+
reasoning?: string;
|
|
23
|
+
model?: string;
|
|
24
|
+
}
|
|
25
|
+
export interface LLMResponse {
|
|
26
|
+
content: string;
|
|
27
|
+
model: string;
|
|
28
|
+
usage: TokenUsage;
|
|
29
|
+
toolCalls?: Record<string, unknown>[];
|
|
30
|
+
reasoning?: string;
|
|
31
|
+
debugInfo?: Record<string, unknown>;
|
|
32
|
+
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-036/ADR-072: дефолт rate limit LLM Gateway. Единый источник для Zod-схемы
|
|
3
|
+
* конфига и runtime-дефолтов (settings-роуты, fallback'и backend/core).
|
|
4
|
+
*/
|
|
5
|
+
export const DEFAULT_LLM_GATEWAY_RATE_LIMIT = {
|
|
6
|
+
userPerMinute: 60,
|
|
7
|
+
providerPerMinute: 120,
|
|
8
|
+
};
|
|
@@ -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 {};
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
import type { McpServerConfig } from '../config/types.js';
|
|
2
|
+
import type { McpToolDetail } from './prompt.js';
|
|
3
|
+
/** Версия схемы записи реестра MCP — для будущей миграции (PROP-032). */
|
|
4
|
+
export declare const MCP_REGISTRY_SCHEMA_VERSION = 1;
|
|
5
|
+
export declare const MCP_REGISTRY_ORIGINS: readonly ["instance", "user"];
|
|
6
|
+
export type McpRegistryOrigin = (typeof MCP_REGISTRY_ORIGINS)[number];
|
|
7
|
+
export declare const MCP_REGISTRY_TRUST_LEVELS: readonly ["builtin", "community"];
|
|
8
|
+
export type McpRegistryTrust = (typeof MCP_REGISTRY_TRUST_LEVELS)[number];
|
|
9
|
+
/** Автор записи реестра (кто добавил сервер). */
|
|
10
|
+
export interface McpRegistryAuthor {
|
|
11
|
+
userId: string;
|
|
12
|
+
username: string;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* ADR-071 §2.5: плоская запись единого реестра MCP-серверов.
|
|
16
|
+
*
|
|
17
|
+
* Логическая модель сразу проектируется под PostgreSQL (PROP-032): стабильный
|
|
18
|
+
* `id`, `schemaVersion`, timestamps; вложенность ограничена `config`/`author`
|
|
19
|
+
* (раскладываются в JSONB/отдельные колонки). Instance- и пользовательские
|
|
20
|
+
* записи различаются полем `origin`, не отдельными реестрами.
|
|
21
|
+
*/
|
|
22
|
+
export interface McpRegistryEntry {
|
|
23
|
+
schemaVersion: number;
|
|
24
|
+
id: string;
|
|
25
|
+
name: string;
|
|
26
|
+
config: McpServerConfig;
|
|
27
|
+
origin: McpRegistryOrigin;
|
|
28
|
+
author: McpRegistryAuthor | null;
|
|
29
|
+
trust: McpRegistryTrust;
|
|
30
|
+
/**
|
|
31
|
+
* Системный мастер-флаг (hard-gate): `false` — сервер недоступен НИГДЕ и НИКОГДА
|
|
32
|
+
* (в т.ч. в старых сессиях). Дефолт `true`.
|
|
33
|
+
*/
|
|
34
|
+
enabled: boolean;
|
|
35
|
+
/**
|
|
36
|
+
* Переосмыслено: «включён по умолчанию для НОВЫХ ПРОЕКТОВ» — сид
|
|
37
|
+
* `project.mcp.enabled`/`project.mcp.defaultOn` при создании проекта. Снимок:
|
|
38
|
+
* изменение не влияет на ранее созданные проекты/сессии.
|
|
39
|
+
*/
|
|
40
|
+
enabledByDefault: boolean;
|
|
41
|
+
createdAt: string;
|
|
42
|
+
updatedAt: string;
|
|
43
|
+
}
|
|
44
|
+
export declare const MCP_NETWORK_POLICY_MODES: readonly ["allow", "deny"];
|
|
45
|
+
export type McpNetworkPolicyMode = (typeof MCP_NETWORK_POLICY_MODES)[number];
|
|
46
|
+
/**
|
|
47
|
+
* ADR-071 §2.3.1: политика сетевого доступа пользовательских HTTP MCP-серверов.
|
|
48
|
+
* - `deny` — перечисленные адреса/CIDR запрещены (дефолт: приватные диапазоны);
|
|
49
|
+
* - `allow` — разрешены только перечисленные адреса/CIDR (всё прочее запрещено).
|
|
50
|
+
*/
|
|
51
|
+
export interface McpNetworkPolicy {
|
|
52
|
+
mode: McpNetworkPolicyMode;
|
|
53
|
+
list: string[];
|
|
54
|
+
/**
|
|
55
|
+
* Allow-правила-исключения (точный hostname, `*.suffix`, CIDR/IP).
|
|
56
|
+
* Проверяются первыми; формат/семантика общие с `egress.tools`/`egress.webhooks`.
|
|
57
|
+
*/
|
|
58
|
+
exceptions?: string[];
|
|
59
|
+
}
|
|
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). */
|
|
123
|
+
export declare const DEFAULT_MCP_NETWORK_POLICY: McpNetworkPolicy;
|
|
124
|
+
export declare const MCP_SERVER_LEVELS: readonly ["system", "project", "session"];
|
|
125
|
+
export type McpServerLevel = (typeof MCP_SERVER_LEVELS)[number];
|
|
126
|
+
/**
|
|
127
|
+
* ADR-071 §2.2: почему сервер отключён в эффективном наборе сессии:
|
|
128
|
+
* - `system_disabled` — выключен системным мастер-флагом (`McpRegistryEntry.enabled === false`);
|
|
129
|
+
* - `project_disabled` — не разрешён проектом (`project.enabled` — hard-gate);
|
|
130
|
+
* - `session_optout` — явный opt-out в сессии (`mcpDisabledServers`);
|
|
131
|
+
* - `not_default` — нет в снапшоте сессии (`mcpDefaultOn`) и не включён явно.
|
|
132
|
+
*
|
|
133
|
+
* Причина `config` отсутствует: `McpServerConfig.enabled` — только сид записи
|
|
134
|
+
* реестра (`seedFromConfig`), в резолвинге/подключении не участвует.
|
|
135
|
+
*/
|
|
136
|
+
export declare const MCP_DISABLED_REASONS: readonly ["system_disabled", "project_disabled", "session_optout", "not_default"];
|
|
137
|
+
export type McpDisabledReason = (typeof MCP_DISABLED_REASONS)[number];
|
|
138
|
+
/**
|
|
139
|
+
* ADR-071 §2.4: эффективное состояние MCP-сервера для сессии. Отдаётся API
|
|
140
|
+
* `GET /api/v2/sessions/:id/mcp`; отключённые серверы не исчезают из выдачи.
|
|
141
|
+
*/
|
|
142
|
+
export interface McpServerEffective {
|
|
143
|
+
name: string;
|
|
144
|
+
level: McpServerLevel;
|
|
145
|
+
enabled: boolean;
|
|
146
|
+
/** Причина отключения (только при `enabled === false`). */
|
|
147
|
+
reason?: McpDisabledReason;
|
|
148
|
+
connected?: boolean;
|
|
149
|
+
origin: McpRegistryOrigin;
|
|
150
|
+
trust: McpRegistryTrust;
|
|
151
|
+
/**
|
|
152
|
+
* ADR-071 §2.2/§2.6: транспортный статус для таблицы «MCP» в статистике:
|
|
153
|
+
* `disabled` — выключен в эффективном наборе, `connected`/`error`/`circuit-open`
|
|
154
|
+
* — состояние подключения активного сервера.
|
|
155
|
+
*/
|
|
156
|
+
status?: 'connected' | 'error' | 'disabled' | 'circuit-open';
|
|
157
|
+
/** ADR-071 §2.5/§2.6: автор записи реестра (null для instance/config-серверов). */
|
|
158
|
+
author?: McpRegistryAuthor | null;
|
|
159
|
+
/** ADR-071 §2.2/§2.6: имена инструментов сервера (пусто, если не подключён). */
|
|
160
|
+
tools?: string[];
|
|
161
|
+
/** ADR-071 §2.6: суммарные символы JSON-определений тулов сервера. */
|
|
162
|
+
chars?: number;
|
|
163
|
+
/** ADR-071 §2.6: оценка токенов сервера (`ceil(chars / ratio)`). */
|
|
164
|
+
estTokens?: number;
|
|
165
|
+
/** ADR-071 §2.6: chars-per-token, применённый к оценке (4 — без калибровки). */
|
|
166
|
+
ratio?: number;
|
|
167
|
+
/** ADR-071 §2.6: пер-тульные chars/estTokens/ratio + признак admin_disabled. */
|
|
168
|
+
toolDetails?: McpToolDetail[];
|
|
169
|
+
}
|