@itphx/synth-shared 0.9.0 → 0.10.1
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 +51 -1
- package/dist/config/env-overrides.d.ts +68 -0
- package/dist/config/env-overrides.js +165 -0
- package/dist/config/index.d.ts +1 -0
- package/dist/config/index.js +1 -0
- package/dist/config/loader.d.ts +3 -1
- package/dist/config/loader.js +12 -4
- package/dist/config/resolve.d.ts +23 -6
- package/dist/config/resolve.js +33 -12
- package/dist/config/types.d.ts +699 -146
- package/dist/config/types.js +195 -28
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +50 -8
- package/dist/index.d.ts +4 -2
- package/dist/index.js +3 -2
- package/dist/interfaces/index.d.ts +8 -1
- package/dist/schemas/index.d.ts +1723 -45
- package/dist/schemas/index.js +403 -29
- 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/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 +502 -0
- package/dist/types/decision.js +98 -0
- package/dist/types/events.d.ts +219 -0
- package/dist/types/events.js +1 -0
- package/dist/types/fs.d.ts +44 -0
- package/dist/types/fs.js +16 -0
- package/dist/types/git.d.ts +63 -0
- package/dist/types/git.js +1 -0
- package/dist/types/hooks.d.ts +96 -0
- package/dist/types/hooks.js +1 -0
- package/dist/types/index.d.ts +18 -1097
- package/dist/types/index.js +44 -215
- package/dist/types/llm.d.ts +32 -0
- package/dist/types/llm.js +8 -0
- package/dist/types/mcp.d.ts +104 -0
- package/dist/types/mcp.js +40 -0
- package/dist/types/message.d.ts +63 -0
- package/dist/types/message.js +12 -0
- package/dist/types/permission.d.ts +2 -2
- 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 +236 -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 +109 -0
- package/dist/types/schedules.js +9 -0
- package/dist/types/service-keys.d.ts +106 -0
- package/dist/types/service-keys.js +72 -0
- package/dist/types/session.d.ts +269 -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 +4 -3
- package/dist/types/tools.js +2 -0
- package/dist/types/user.d.ts +113 -0
- package/dist/types/user.js +31 -0
- package/dist/types/webhooks.d.ts +97 -0
- package/dist/types/webhooks.js +53 -0
- package/dist/utils/glob.d.ts +1 -1
- package/dist/utils/glob.js +1 -1
- package/dist/utils/index.js +2 -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,220 +1,49 @@
|
|
|
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
|
-
// --- File System ---
|
|
198
|
-
export var FsErrorCode;
|
|
199
|
-
(function (FsErrorCode) {
|
|
200
|
-
FsErrorCode["PATH_TRAVERSAL"] = "PATH_TRAVERSAL";
|
|
201
|
-
FsErrorCode["NOT_FOUND"] = "NOT_FOUND";
|
|
202
|
-
FsErrorCode["NOT_A_DIRECTORY"] = "NOT_A_DIRECTORY";
|
|
203
|
-
FsErrorCode["IS_DIRECTORY"] = "IS_DIRECTORY";
|
|
204
|
-
FsErrorCode["BINARY_FILE"] = "BINARY_FILE";
|
|
205
|
-
FsErrorCode["WORKSPACE_NOT_SET"] = "WORKSPACE_NOT_SET";
|
|
206
|
-
FsErrorCode["WORKSPACE_NOT_FOUND"] = "WORKSPACE_NOT_FOUND";
|
|
207
|
-
FsErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
|
|
208
|
-
FsErrorCode["ALREADY_EXISTS"] = "ALREADY_EXISTS";
|
|
209
|
-
FsErrorCode["DIR_NOT_EMPTY"] = "DIR_NOT_EMPTY";
|
|
210
|
-
/** AD-075: путь вне `workspacesRoot` запрещён политикой (managed). */
|
|
211
|
-
FsErrorCode["WORKSPACE_OUTSIDE_ROOT_DENIED"] = "WORKSPACE_OUTSIDE_ROOT_DENIED";
|
|
212
|
-
})(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
|
+
// --- Реэкспорт существующих доменных модулей ---
|
|
213
30
|
// Tool types — re-exported from tools.ts
|
|
214
31
|
export * from './tools.js';
|
|
215
|
-
// Permission types (
|
|
32
|
+
// Permission types (ADR-029) — re-exported from permission.ts
|
|
216
33
|
export * from './permission.js';
|
|
217
|
-
// Skill types (
|
|
34
|
+
// Skill types (ADR-046) — re-exported from skills.ts
|
|
218
35
|
export * from './skills.js';
|
|
219
|
-
// Slash-команды и bundles (
|
|
36
|
+
// Slash-команды и bundles (ADR-046 §7) — re-exported from commands.ts
|
|
220
37
|
export * from './commands.js';
|
|
38
|
+
// Внешние события (ADR-089) — re-exported from events.ts
|
|
39
|
+
export * from './events.js';
|
|
40
|
+
// Hooks агента и интеграций (ADR-030) — re-exported from hooks.ts
|
|
41
|
+
export * from './hooks.js';
|
|
42
|
+
// Планировщик расписаний (ADR-051 срез / ADR-089) — re-exported from schedules.ts
|
|
43
|
+
export * from './schedules.js';
|
|
44
|
+
// Decision-модели (ADR-084): контракт state+questions → answers — re-exported from decision.ts
|
|
45
|
+
export * from './decision.js';
|
|
46
|
+
// ADR-052 (этап I): service-key — scopes + проектная проекция — re-exported from service-keys.ts
|
|
47
|
+
export * from './service-keys.js';
|
|
48
|
+
// ADR-052 (этап II): исходящие webhooks — типы и матчер событий — re-exported from webhooks.ts
|
|
49
|
+
export * from './webhooks.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,104 @@
|
|
|
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
|
+
/** Приватные/служебные диапазоны, запрещённые по умолчанию (SSRF/egress). */
|
|
56
|
+
export declare const DEFAULT_MCP_PRIVATE_CIDRS: readonly ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16", "127.0.0.0/8", "169.254.0.0/16", "::1/128", "fc00::/7", "fe80::/10"];
|
|
57
|
+
/** Дефолтная политика: deny приватных диапазонов (ADR-071 §2.3.1). */
|
|
58
|
+
export declare const DEFAULT_MCP_NETWORK_POLICY: McpNetworkPolicy;
|
|
59
|
+
export declare const MCP_SERVER_LEVELS: readonly ["system", "project", "session"];
|
|
60
|
+
export type McpServerLevel = (typeof MCP_SERVER_LEVELS)[number];
|
|
61
|
+
/**
|
|
62
|
+
* ADR-071 §2.2: почему сервер отключён в эффективном наборе сессии:
|
|
63
|
+
* - `system_disabled` — выключен системным мастер-флагом (`McpRegistryEntry.enabled === false`);
|
|
64
|
+
* - `project_disabled` — не разрешён проектом (`project.enabled` — hard-gate);
|
|
65
|
+
* - `session_optout` — явный opt-out в сессии (`mcpDisabledServers`);
|
|
66
|
+
* - `not_default` — нет в снапшоте сессии (`mcpDefaultOn`) и не включён явно.
|
|
67
|
+
*
|
|
68
|
+
* Причина `config` отсутствует: `McpServerConfig.enabled` — только сид записи
|
|
69
|
+
* реестра (`seedFromConfig`), в резолвинге/подключении не участвует.
|
|
70
|
+
*/
|
|
71
|
+
export declare const MCP_DISABLED_REASONS: readonly ["system_disabled", "project_disabled", "session_optout", "not_default"];
|
|
72
|
+
export type McpDisabledReason = (typeof MCP_DISABLED_REASONS)[number];
|
|
73
|
+
/**
|
|
74
|
+
* ADR-071 §2.4: эффективное состояние MCP-сервера для сессии. Отдаётся API
|
|
75
|
+
* `GET /api/v2/sessions/:id/mcp`; отключённые серверы не исчезают из выдачи.
|
|
76
|
+
*/
|
|
77
|
+
export interface McpServerEffective {
|
|
78
|
+
name: string;
|
|
79
|
+
level: McpServerLevel;
|
|
80
|
+
enabled: boolean;
|
|
81
|
+
/** Причина отключения (только при `enabled === false`). */
|
|
82
|
+
reason?: McpDisabledReason;
|
|
83
|
+
connected?: boolean;
|
|
84
|
+
origin: McpRegistryOrigin;
|
|
85
|
+
trust: McpRegistryTrust;
|
|
86
|
+
/**
|
|
87
|
+
* ADR-071 §2.2/§2.6: транспортный статус для таблицы «MCP» в статистике:
|
|
88
|
+
* `disabled` — выключен в эффективном наборе, `connected`/`error`/`circuit-open`
|
|
89
|
+
* — состояние подключения активного сервера.
|
|
90
|
+
*/
|
|
91
|
+
status?: 'connected' | 'error' | 'disabled' | 'circuit-open';
|
|
92
|
+
/** ADR-071 §2.5/§2.6: автор записи реестра (null для instance/config-серверов). */
|
|
93
|
+
author?: McpRegistryAuthor | null;
|
|
94
|
+
/** ADR-071 §2.2/§2.6: имена инструментов сервера (пусто, если не подключён). */
|
|
95
|
+
tools?: string[];
|
|
96
|
+
/** ADR-071 §2.6: суммарные символы JSON-определений тулов сервера. */
|
|
97
|
+
chars?: number;
|
|
98
|
+
/** ADR-071 §2.6: оценка токенов сервера (`ceil(chars / ratio)`). */
|
|
99
|
+
estTokens?: number;
|
|
100
|
+
/** ADR-071 §2.6: chars-per-token, применённый к оценке (4 — без калибровки). */
|
|
101
|
+
ratio?: number;
|
|
102
|
+
/** ADR-071 §2.6: пер-тульные chars/estTokens/ratio + признак admin_disabled. */
|
|
103
|
+
toolDetails?: McpToolDetail[];
|
|
104
|
+
}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
// --- MCP: реестр серверов и сетевой доступ (ADR-071 §2.3.1/§2.5) ---
|
|
2
|
+
/** Версия схемы записи реестра MCP — для будущей миграции (PROP-032). */
|
|
3
|
+
export const MCP_REGISTRY_SCHEMA_VERSION = 1;
|
|
4
|
+
export const MCP_REGISTRY_ORIGINS = ['instance', 'user'];
|
|
5
|
+
export const MCP_REGISTRY_TRUST_LEVELS = ['builtin', 'community'];
|
|
6
|
+
export const MCP_NETWORK_POLICY_MODES = ['allow', 'deny'];
|
|
7
|
+
/** Приватные/служебные диапазоны, запрещённые по умолчанию (SSRF/egress). */
|
|
8
|
+
export const DEFAULT_MCP_PRIVATE_CIDRS = [
|
|
9
|
+
'10.0.0.0/8',
|
|
10
|
+
'172.16.0.0/12',
|
|
11
|
+
'192.168.0.0/16',
|
|
12
|
+
'127.0.0.0/8',
|
|
13
|
+
'169.254.0.0/16',
|
|
14
|
+
'::1/128',
|
|
15
|
+
'fc00::/7',
|
|
16
|
+
'fe80::/10',
|
|
17
|
+
];
|
|
18
|
+
/** Дефолтная политика: deny приватных диапазонов (ADR-071 §2.3.1). */
|
|
19
|
+
export const DEFAULT_MCP_NETWORK_POLICY = {
|
|
20
|
+
mode: 'deny',
|
|
21
|
+
list: [...DEFAULT_MCP_PRIVATE_CIDRS],
|
|
22
|
+
};
|
|
23
|
+
// --- MCP: уровни/скоуп и эффективный набор (ADR-071 §2.2/§2.4) ---
|
|
24
|
+
export const MCP_SERVER_LEVELS = ['system', 'project', 'session'];
|
|
25
|
+
/**
|
|
26
|
+
* ADR-071 §2.2: почему сервер отключён в эффективном наборе сессии:
|
|
27
|
+
* - `system_disabled` — выключен системным мастер-флагом (`McpRegistryEntry.enabled === false`);
|
|
28
|
+
* - `project_disabled` — не разрешён проектом (`project.enabled` — hard-gate);
|
|
29
|
+
* - `session_optout` — явный opt-out в сессии (`mcpDisabledServers`);
|
|
30
|
+
* - `not_default` — нет в снапшоте сессии (`mcpDefaultOn`) и не включён явно.
|
|
31
|
+
*
|
|
32
|
+
* Причина `config` отсутствует: `McpServerConfig.enabled` — только сид записи
|
|
33
|
+
* реестра (`seedFromConfig`), в резолвинге/подключении не участвует.
|
|
34
|
+
*/
|
|
35
|
+
export const MCP_DISABLED_REASONS = [
|
|
36
|
+
'system_disabled',
|
|
37
|
+
'project_disabled',
|
|
38
|
+
'session_optout',
|
|
39
|
+
'not_default',
|
|
40
|
+
];
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import type { TokenUsage } from './llm.js';
|
|
2
|
+
import type { PromptMeta } from './prompt.js';
|
|
3
|
+
export declare enum MessageRole {
|
|
4
|
+
SYSTEM = "system",
|
|
5
|
+
USER = "user",
|
|
6
|
+
ASSISTANT = "assistant",
|
|
7
|
+
TOOL = "tool",
|
|
8
|
+
SUMMARY = "summary",
|
|
9
|
+
DEBUG = "debug",
|
|
10
|
+
INFO = "info",
|
|
11
|
+
ERROR = "error"
|
|
12
|
+
}
|
|
13
|
+
export type PartType = 'text' | 'tool_use' | 'tool_result' | 'reasoning' | 'session_reference';
|
|
14
|
+
export interface Part {
|
|
15
|
+
id: string;
|
|
16
|
+
type: PartType;
|
|
17
|
+
data: unknown;
|
|
18
|
+
}
|
|
19
|
+
export type MessageOrigin = 'local' | 'inherited' | 'merged' | 'crosspost';
|
|
20
|
+
/**
|
|
21
|
+
* metadata.i18n сообщения/tool_result (i18n ядра): стабильный en-like ключ
|
|
22
|
+
* системного сообщения + параметры подстановки. UI рендерит перевод по ключу
|
|
23
|
+
* (formatMessage), fallback — на content (en). Плейсхолдеры — `{param}`.
|
|
24
|
+
*/
|
|
25
|
+
export interface MessageI18n {
|
|
26
|
+
key: string;
|
|
27
|
+
params?: Record<string, string>;
|
|
28
|
+
}
|
|
29
|
+
export interface Message {
|
|
30
|
+
id: string;
|
|
31
|
+
role: MessageRole;
|
|
32
|
+
seq: number;
|
|
33
|
+
origin: MessageOrigin;
|
|
34
|
+
sourceMsgId?: string;
|
|
35
|
+
parts: Part[];
|
|
36
|
+
content: string;
|
|
37
|
+
toolCalls?: Record<string, unknown>[];
|
|
38
|
+
toolCallId?: string;
|
|
39
|
+
createdAt: string;
|
|
40
|
+
disabled: boolean;
|
|
41
|
+
pinned: boolean;
|
|
42
|
+
hidden: boolean;
|
|
43
|
+
/**
|
|
44
|
+
* ADR-046 §7.1: сообщение локальной `/`-команды (builtin-ответ) — видно в
|
|
45
|
+
* истории, но исключается из LLM-контекста.
|
|
46
|
+
*/
|
|
47
|
+
ephemeral?: boolean;
|
|
48
|
+
debugData?: Record<string, unknown>;
|
|
49
|
+
model?: string;
|
|
50
|
+
provider?: string;
|
|
51
|
+
providerType?: string;
|
|
52
|
+
usage?: TokenUsage;
|
|
53
|
+
reasoning?: string;
|
|
54
|
+
source?: 'web' | 'cli' | 'api';
|
|
55
|
+
author?: string;
|
|
56
|
+
agentRole?: string;
|
|
57
|
+
metadata?: Record<string, unknown>;
|
|
58
|
+
/** ADR-070 §2.4: предсказание/валидация prompt-cache для этого хода. */
|
|
59
|
+
promptMeta?: PromptMeta;
|
|
60
|
+
summaryOf?: number[];
|
|
61
|
+
qa_pass?: boolean;
|
|
62
|
+
qa_reason?: string;
|
|
63
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
// --- Message role ---
|
|
2
|
+
export var MessageRole;
|
|
3
|
+
(function (MessageRole) {
|
|
4
|
+
MessageRole["SYSTEM"] = "system";
|
|
5
|
+
MessageRole["USER"] = "user";
|
|
6
|
+
MessageRole["ASSISTANT"] = "assistant";
|
|
7
|
+
MessageRole["TOOL"] = "tool";
|
|
8
|
+
MessageRole["SUMMARY"] = "summary";
|
|
9
|
+
MessageRole["DEBUG"] = "debug";
|
|
10
|
+
MessageRole["INFO"] = "info";
|
|
11
|
+
MessageRole["ERROR"] = "error";
|
|
12
|
+
})(MessageRole || (MessageRole = {}));
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
/**
|
|
3
|
-
*
|
|
3
|
+
* ADR-029: Гранулярные permissions.
|
|
4
4
|
* Модель OpenCode: allow/deny/ask для каждого тула + glob-паттерны для файлов.
|
|
5
5
|
*/
|
|
6
6
|
export declare const PERMISSION_ACTIONS: readonly ["allow", "deny", "ask"];
|
|
@@ -37,7 +37,7 @@ export interface PermissionDecision {
|
|
|
37
37
|
/** Параметры подстановки в сообщение ({{path}}, {{dir}}, {{command}}). */
|
|
38
38
|
params?: Record<string, string>;
|
|
39
39
|
/**
|
|
40
|
-
*
|
|
40
|
+
* ADR-070 §2.9.1: тул недоступен не по жёсткому запрету, а из-за текущего
|
|
41
41
|
* режима (`mode`), роли агента (`role`), отсутствия внешней программы
|
|
42
42
|
* окружения (`dependency`) или не заданного рабочего каталога проекта
|
|
43
43
|
* (`workspace`). Отличие от `deny`-политики: доступ открывается
|
package/dist/types/permission.js
CHANGED