@itphx/synth-shared 0.10.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.
Files changed (65) hide show
  1. package/dist/config/defaults.js +11 -11
  2. package/dist/config/env-overrides.d.ts +3 -3
  3. package/dist/config/env-overrides.js +9 -9
  4. package/dist/config/loader.d.ts +2 -2
  5. package/dist/config/loader.js +4 -4
  6. package/dist/config/resolve.d.ts +10 -10
  7. package/dist/config/resolve.js +16 -16
  8. package/dist/config/types.d.ts +190 -190
  9. package/dist/config/types.js +47 -47
  10. package/dist/i18n/index.d.ts +1 -1
  11. package/dist/i18n/index.js +16 -10
  12. package/dist/interfaces/index.d.ts +3 -3
  13. package/dist/schemas/index.d.ts +96 -96
  14. package/dist/schemas/index.js +70 -70
  15. package/dist/skills/frontmatter.js +1 -1
  16. package/dist/types/agent.d.ts +30 -0
  17. package/dist/types/agent.js +1 -0
  18. package/dist/types/bus-events.d.ts +7 -0
  19. package/dist/types/bus-events.js +1 -0
  20. package/dist/types/commands.d.ts +10 -10
  21. package/dist/types/commands.js +2 -2
  22. package/dist/types/decision.d.ts +16 -16
  23. package/dist/types/decision.js +4 -4
  24. package/dist/types/events.d.ts +22 -22
  25. package/dist/types/fs.d.ts +44 -0
  26. package/dist/types/fs.js +16 -0
  27. package/dist/types/git.d.ts +63 -0
  28. package/dist/types/git.js +1 -0
  29. package/dist/types/hooks.d.ts +4 -4
  30. package/dist/types/index.d.ts +12 -1165
  31. package/dist/types/index.js +38 -244
  32. package/dist/types/llm.d.ts +32 -0
  33. package/dist/types/llm.js +8 -0
  34. package/dist/types/mcp.d.ts +104 -0
  35. package/dist/types/mcp.js +40 -0
  36. package/dist/types/message.d.ts +63 -0
  37. package/dist/types/message.js +12 -0
  38. package/dist/types/permission.d.ts +2 -2
  39. package/dist/types/permission.js +1 -1
  40. package/dist/types/project.d.ts +134 -0
  41. package/dist/types/project.js +67 -0
  42. package/dist/types/prompt.d.ts +236 -0
  43. package/dist/types/prompt.js +15 -0
  44. package/dist/types/provider.d.ts +84 -0
  45. package/dist/types/provider.js +35 -0
  46. package/dist/types/schedules.d.ts +8 -8
  47. package/dist/types/schedules.js +1 -1
  48. package/dist/types/service-keys.d.ts +10 -10
  49. package/dist/types/service-keys.js +3 -3
  50. package/dist/types/session.d.ts +269 -0
  51. package/dist/types/session.js +13 -0
  52. package/dist/types/skills.d.ts +11 -11
  53. package/dist/types/skills.js +6 -6
  54. package/dist/types/tools.d.ts +3 -3
  55. package/dist/types/user.d.ts +113 -0
  56. package/dist/types/user.js +31 -0
  57. package/dist/types/webhooks.d.ts +5 -5
  58. package/dist/types/webhooks.js +1 -1
  59. package/dist/utils/glob.d.ts +1 -1
  60. package/dist/utils/glob.js +1 -1
  61. package/dist/utils/index.js +2 -2
  62. package/dist/utils/workspace.js +1 -1
  63. package/dist/version.d.ts +1 -1
  64. package/dist/version.js +1 -1
  65. package/package.json +1 -1
@@ -1,255 +1,49 @@
1
- // Core enums
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 = {}));
13
- export var GlobalRole;
14
- (function (GlobalRole) {
15
- GlobalRole["ADMIN"] = "ADMIN";
16
- GlobalRole["USER"] = "USER";
17
- GlobalRole["LEAD"] = "LEAD";
18
- GlobalRole["AUDITOR"] = "AUDITOR";
19
- })(GlobalRole || (GlobalRole = {}));
20
- export var ProjectRole;
21
- (function (ProjectRole) {
22
- ProjectRole["OWNER"] = "owner";
23
- ProjectRole["EDITOR"] = "editor";
24
- ProjectRole["VIEWER"] = "viewer";
25
- })(ProjectRole || (ProjectRole = {}));
26
- export var StatusMessageType;
27
- (function (StatusMessageType) {
28
- StatusMessageType["INFO"] = "info";
29
- StatusMessageType["WARNING"] = "warning";
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 (AD-029) — re-exported from permission.ts
32
+ // Permission types (ADR-029) — re-exported from permission.ts
239
33
  export * from './permission.js';
240
- // Skill types (AD-046) — re-exported from skills.ts
34
+ // Skill types (ADR-046) — re-exported from skills.ts
241
35
  export * from './skills.js';
242
- // Slash-команды и bundles (AD-046 §7) — re-exported from commands.ts
36
+ // Slash-команды и bundles (ADR-046 §7) — re-exported from commands.ts
243
37
  export * from './commands.js';
244
- // Внешние события (AD-089) — re-exported from events.ts
38
+ // Внешние события (ADR-089) — re-exported from events.ts
245
39
  export * from './events.js';
246
- // Hooks агента и интеграций (AD-030) — re-exported from hooks.ts
40
+ // Hooks агента и интеграций (ADR-030) — re-exported from hooks.ts
247
41
  export * from './hooks.js';
248
- // Планировщик расписаний (AD-051 срез / AD-089) — re-exported from schedules.ts
42
+ // Планировщик расписаний (ADR-051 срез / ADR-089) — re-exported from schedules.ts
249
43
  export * from './schedules.js';
250
- // Decision-модели (AD-084): контракт state+questions → answers — re-exported from decision.ts
44
+ // Decision-модели (ADR-084): контракт state+questions → answers — re-exported from decision.ts
251
45
  export * from './decision.js';
252
- // AD-052 (этап I): service-key — scopes + проектная проекция — re-exported from service-keys.ts
46
+ // ADR-052 (этап I): service-key — scopes + проектная проекция — re-exported from service-keys.ts
253
47
  export * from './service-keys.js';
254
- // AD-052 (этап II): исходящие webhooks — типы и матчер событий — re-exported from webhooks.ts
48
+ // ADR-052 (этап II): исходящие webhooks — типы и матчер событий — re-exported from webhooks.ts
255
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
- * AD-029: Гранулярные permissions.
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
- * AD-070 §2.9.1: тул недоступен не по жёсткому запрету, а из-за текущего
40
+ * ADR-070 §2.9.1: тул недоступен не по жёсткому запрету, а из-за текущего
41
41
  * режима (`mode`), роли агента (`role`), отсутствия внешней программы
42
42
  * окружения (`dependency`) или не заданного рабочего каталога проекта
43
43
  * (`workspace`). Отличие от `deny`-политики: доступ открывается
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  /**
3
- * AD-029: Гранулярные permissions.
3
+ * ADR-029: Гранулярные permissions.
4
4
  * Модель OpenCode: allow/deny/ask для каждого тула + glob-паттерны для файлов.
5
5
  */
6
6
  export const PERMISSION_ACTIONS = ['allow', 'deny', 'ask'];