@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.
Files changed (83) hide show
  1. package/dist/config/defaults.js +60 -14
  2. package/dist/config/env-overrides.d.ts +7 -4
  3. package/dist/config/env-overrides.js +46 -13
  4. package/dist/config/index.d.ts +3 -0
  5. package/dist/config/index.js +3 -0
  6. package/dist/config/loader.d.ts +2 -2
  7. package/dist/config/loader.js +23 -4
  8. package/dist/config/proxy.d.ts +415 -0
  9. package/dist/config/proxy.js +1565 -0
  10. package/dist/config/resolve.d.ts +77 -10
  11. package/dist/config/resolve.js +203 -17
  12. package/dist/config/tls-runtime.d.ts +78 -0
  13. package/dist/config/tls-runtime.js +356 -0
  14. package/dist/config/tls.d.ts +215 -0
  15. package/dist/config/tls.js +394 -0
  16. package/dist/config/types.d.ts +1820 -334
  17. package/dist/config/types.js +320 -54
  18. package/dist/i18n/index.d.ts +1 -1
  19. package/dist/i18n/index.js +18 -10
  20. package/dist/index.d.ts +11 -2
  21. package/dist/index.js +11 -2
  22. package/dist/interfaces/index.d.ts +3 -3
  23. package/dist/protocols/index.d.ts +0 -1
  24. package/dist/schemas/index.d.ts +230 -105
  25. package/dist/schemas/index.js +121 -74
  26. package/dist/skills/frontmatter.js +1 -1
  27. package/dist/types/agent.d.ts +30 -0
  28. package/dist/types/agent.js +1 -0
  29. package/dist/types/analytics.d.ts +113 -0
  30. package/dist/types/analytics.js +61 -0
  31. package/dist/types/bus-events.d.ts +7 -0
  32. package/dist/types/bus-events.js +1 -0
  33. package/dist/types/commands.d.ts +10 -10
  34. package/dist/types/commands.js +2 -2
  35. package/dist/types/decision.d.ts +16 -16
  36. package/dist/types/decision.js +4 -4
  37. package/dist/types/egress.d.ts +114 -0
  38. package/dist/types/egress.js +68 -0
  39. package/dist/types/events.d.ts +22 -23
  40. package/dist/types/fs.d.ts +55 -0
  41. package/dist/types/fs.js +27 -0
  42. package/dist/types/git.d.ts +63 -0
  43. package/dist/types/git.js +1 -0
  44. package/dist/types/hooks.d.ts +24 -4
  45. package/dist/types/index.d.ts +15 -1165
  46. package/dist/types/index.js +44 -244
  47. package/dist/types/llm.d.ts +32 -0
  48. package/dist/types/llm.js +8 -0
  49. package/dist/types/maintenance.d.ts +39 -0
  50. package/dist/types/maintenance.js +11 -0
  51. package/dist/types/mcp.d.ts +169 -0
  52. package/dist/types/mcp.js +119 -0
  53. package/dist/types/message.d.ts +63 -0
  54. package/dist/types/message.js +12 -0
  55. package/dist/types/permission.d.ts +9 -7
  56. package/dist/types/permission.js +1 -1
  57. package/dist/types/project.d.ts +134 -0
  58. package/dist/types/project.js +67 -0
  59. package/dist/types/prompt.d.ts +237 -0
  60. package/dist/types/prompt.js +15 -0
  61. package/dist/types/provider.d.ts +84 -0
  62. package/dist/types/provider.js +35 -0
  63. package/dist/types/schedules.d.ts +8 -8
  64. package/dist/types/schedules.js +1 -1
  65. package/dist/types/service-keys.d.ts +10 -10
  66. package/dist/types/service-keys.js +3 -3
  67. package/dist/types/session.d.ts +268 -0
  68. package/dist/types/session.js +13 -0
  69. package/dist/types/skills.d.ts +11 -11
  70. package/dist/types/skills.js +6 -6
  71. package/dist/types/tools.d.ts +3 -3
  72. package/dist/types/user.d.ts +113 -0
  73. package/dist/types/user.js +31 -0
  74. package/dist/types/webhooks.d.ts +6 -6
  75. package/dist/types/webhooks.js +1 -1
  76. package/dist/utils/glob.d.ts +1 -1
  77. package/dist/utils/glob.js +1 -1
  78. package/dist/utils/index.d.ts +15 -0
  79. package/dist/utils/index.js +55 -2
  80. package/dist/utils/workspace.js +1 -1
  81. package/dist/version.d.ts +1 -1
  82. package/dist/version.js +1 -1
  83. package/package.json +1 -1
@@ -1,1168 +1,15 @@
1
- import type { ToolCapability } from './tools.js';
2
- import type { PermissionConfig, McpServerToolSettings } from './permission.js';
3
- import type { McpServerConfig } from '../config/types.js';
4
- export declare enum MessageRole {
5
- SYSTEM = "system",
6
- USER = "user",
7
- ASSISTANT = "assistant",
8
- TOOL = "tool",
9
- SUMMARY = "summary",
10
- DEBUG = "debug",
11
- INFO = "info",
12
- ERROR = "error"
13
- }
14
- export declare enum GlobalRole {
15
- ADMIN = "ADMIN",
16
- USER = "USER",
17
- LEAD = "LEAD",
18
- AUDITOR = "AUDITOR"
19
- }
20
- export declare enum ProjectRole {
21
- OWNER = "owner",
22
- EDITOR = "editor",
23
- VIEWER = "viewer"
24
- }
25
- export declare enum StatusMessageType {
26
- INFO = "info",
27
- WARNING = "warning",
28
- ERROR = "error",
29
- STREAM = "stream"
30
- }
31
- export type PartType = 'text' | 'tool_use' | 'tool_result' | 'reasoning' | 'session_reference';
32
- export interface Part {
33
- id: string;
34
- type: PartType;
35
- data: unknown;
36
- }
37
- export type MessageOrigin = 'local' | 'inherited' | 'merged' | 'crosspost';
38
- /**
39
- * metadata.i18n сообщения/tool_result (i18n ядра): стабильный en-like ключ
40
- * системного сообщения + параметры подстановки. UI рендерит перевод по ключу
41
- * (formatMessage), fallback — на content (en). Плейсхолдеры — `{param}`.
42
- */
43
- export interface MessageI18n {
44
- key: string;
45
- params?: Record<string, string>;
46
- }
47
- export type SessionOrigin = 'user' | 'fork' | 'subagent';
48
- /** Состояние одного блока системного промпта (хэш/размер для диагностики). */
49
- export interface PromptBlockState {
50
- key: string;
51
- hash: string;
52
- chars: number;
53
- }
54
- /**
55
- * AD-070 §2.4: состояние системного промпта per-agent. Хранится в сессии
56
- * (`Session.promptStates`) и пишется только при смене generation.
57
- */
58
- export interface PromptState {
59
- generation: number;
60
- /** sha256(stablePrefix). */
61
- staticPrefixHash: string;
62
- /** Закреплённые байты кэшируемого префикса. */
63
- staticPrefix: string;
64
- /** sha256(полного system). */
65
- systemHash: string;
66
- blocks: PromptBlockState[];
67
- reason: 'init' | 'compaction' | 'generation-change' | 'override' | 'agent-change';
68
- updatedAt: string;
69
- }
70
- /** AD-070 §2.4: компактная мета промпта, кладётся в assistant-сообщение. */
71
- export interface PromptMeta {
72
- /** agentKey, к которому относится ход (agentRole или `__default__`). */
73
- agentRole?: string;
74
- generation: number;
75
- /** Предсказание по staticPrefixHash. */
76
- expected: 'hit' | 'miss';
77
- /** Фактический cacheRead из usage. */
78
- cachedTokens: number;
79
- /** expected подтверждён/опровергнут фактом. */
80
- validated: boolean;
81
- }
82
- /** Тир консистентности блока системного промпта (AD-070 §2.1). */
83
- export type PromptTier = 'stable' | 'context' | 'volatile';
84
- /** Статус блока в манифесте промпта. */
85
- export type PromptManifestStatus = 'loaded' | 'truncated' | 'empty' | 'blocked' | 'suppressed';
86
- /** AD-070 §2.5: запись манифеста — источник системного промпта. */
87
- export interface PromptManifestEntry {
88
- key: string;
89
- label: string;
90
- tier: PromptTier;
91
- /** Порядок блока внутри тира (реальный порядок отправки, AD-070 §2.5). */
92
- order?: number;
93
- chars: number;
94
- /** Эвристика: Math.ceil(chars / 4). */
95
- estTokens: number;
96
- status: PromptManifestStatus;
97
- provenance?: string;
98
- /**
99
- * Источник записи: `system` — блок системного промпта, `tools` — слой
100
- * встроенных инструментов (stable, AD-070 §2.5), `mcp.tools` — слой
101
- * MCP-инструментов (volatile, AD-071 §2.1). Слои инструментов не входят в
102
- * system-текст, но отражаются в манифесте и размерах.
103
- */
104
- source?: 'system' | 'tools' | 'mcp.tools';
105
- }
106
- /** AD-070 §2.5: манифест состава системного промпта (для API/UI/тестов). */
107
- export interface PromptManifest {
108
- generation?: number;
109
- totalChars: number;
110
- estTokens: number;
111
- staticPrefixChars: number;
112
- /**
113
- * AD-071 §2.3: фактически применённая политика **встроенных** инструментов
114
- * (`auto` уже разрешён в `consistency`/`available`) — видно, какая политика
115
- * сработала.
116
- */
117
- toolsPolicy?: Exclude<ToolsPolicy, 'auto'>;
118
- /**
119
- * AD-071 §2.3: фактически применённая политика **MCP**-инструментов
120
- * (`auto` уже разрешён в `consistency`/`available`). Независима от
121
- * `toolsPolicy`.
122
- */
123
- mcpPolicy?: Exclude<ToolsPolicy, 'auto'>;
124
- /**
125
- * AD-071 §2.6: chars-per-token, применённый к `estTokens` (калибровка по
126
- * фактическому usage; 4 — без калибровки). `estTokens` — оценка, не факт.
127
- */
128
- ratio?: number;
129
- entries: PromptManifestEntry[];
130
- }
131
- /** Дефолтный chars-per-token, если калибровки для модели нет. */
132
- export declare const DEFAULT_CHARS_PER_TOKEN = 4;
133
- /**
134
- * Нижняя граница разумного chars-per-token (аномальные семплы отбрасываются).
135
- * CJK/эффективные BPE дают ~1–2 символа на токен, поэтому допускаем 1.5.
136
- */
137
- export declare const MIN_CHARS_PER_TOKEN = 1.5;
138
- /**
139
- * Верхняя граница разумного chars-per-token. Берётся с запасом: «эффективные»
140
- * токенизаторы (например, `omn.qwen3.8:27b`) дают ratio ≈ 11.7.
141
- */
142
- export declare const MAX_CHARS_PER_TOKEN = 16;
143
- /** Минимальный `usage.inputTokens` для калибровки — меньшие значения шумные. */
144
- export declare const MIN_CALIBRATION_INPUT_TOKENS = 500;
145
- /**
146
- * AD-071 §2.6: строка таблицы «Встроенные инструменты» в панели статистики.
147
- * Отдаётся `GET /sessions/:id/prompt` полем `toolsDetail` (аддитивно).
148
- */
149
- export interface PromptToolDetail {
150
- name: string;
151
- capabilities: string[];
152
- /** Доступен ли тул текущему режиму/роли (`computeToolAvailability`). */
153
- available: boolean;
154
- /**
155
- * Причина недоступности: `mode` (переключить режим), `role` (делегировать),
156
- * `admin_disabled` (жёстко отключён администратором через `tools.disabled`),
157
- * `dependency` (в окружении нет нужной программы — git/rg/sh),
158
- * `workspace` (не задан рабочий каталог проекта).
159
- */
160
- reason?: 'mode' | 'role' | 'admin_disabled' | 'dependency' | 'workspace';
161
- /** AD-071 §2.1: источник инструмента (`built-in` — слой `tools`). */
162
- source: 'built-in';
163
- /** AD-071 §2.6: длина `JSON.stringify` LLM-определения тула (как слой `tools`). */
164
- chars?: number;
165
- /** AD-071 §2.6: оценка токенов (`ceil(chars / ratio)`) — значение оценочное. */
166
- estTokens?: number;
167
- /** AD-071 §2.6: chars-per-token, применённый к оценке (4 — без калибровки). */
168
- ratio?: number;
169
- /** AD-071 §2.6: тул жёстко отключён администратором (`tools.disabled`). */
170
- adminDisabled?: boolean;
171
- }
172
- /** AD-071 §2.6: строка тула MCP-сервера с оценкой токенов. */
173
- export interface McpToolDetail {
174
- name: string;
175
- /** Длина `JSON.stringify` LLM-определения тула (имя с префиксом сервера). */
176
- chars: number;
177
- estTokens: number;
178
- ratio: number;
179
- /** AD-071 §2.6: тул отключён администратором (`tools.disabled`). */
180
- adminDisabled?: boolean;
181
- }
182
- /** AD-070 §2.5: state-сообщения истории, сгруппированные по типу. */
183
- export interface PromptHistoryStateMessage {
184
- type: string;
185
- count: number;
186
- chars: number;
187
- estTokens: number;
188
- }
189
- /** AD-070 §2.5: состав слоя истории (`messages`), зеркалит реальную отправку. */
190
- export interface PromptHistoryInfo {
191
- /** Реально отправляемые сообщения (после фильтрации), суммарно. */
192
- messages: {
193
- count: number;
194
- chars: number;
195
- estTokens: number;
196
- };
197
- /** Chronological state-сообщения (mode_change/agent_switch/plan_updated/todos_updated/…), сгруппированы по type. */
198
- stateMessages: PromptHistoryStateMessage[];
199
- /** Что НЕ уходит в LLM. */
200
- excluded: {
201
- disabled: number;
202
- hidden: number;
203
- info: number;
204
- };
205
- /** Мультимодальные части (не text). */
206
- attachments: {
207
- count: number;
208
- chars: number;
209
- };
210
- /** Число плейсхолдеров секретов ⟦SYNTH_SECRET_N⟧ в отправляемых сообщениях (AD-036). */
211
- secretPlaceholders: number;
212
- }
213
- /**
214
- * Статистика по агенту в рамках сессии (`GET /sessions/:id/stats`).
215
- * Итоги (`input_tokens`/`output_tokens`/`cache_*`/`reasoning_tokens`/`cost_usd`)
216
- * включают usage/cost сабагентов (own + все потомки); `subagent_*` — детализация
217
- * только по дочерним сессиям (tool `task`), инициированным агентом.
218
- */
219
- export interface SessionAgentStats {
220
- agent_role: string;
221
- messages: number;
222
- input_tokens: number;
223
- output_tokens: number;
224
- cache_read_tokens: number;
225
- cache_write_tokens: number;
226
- reasoning_tokens: number;
227
- /**
228
- * Номинальная сумма всех валют (обратная совместимость). Мультивалютная
229
- * разбивка — в `cost_by_currency`; здесь значение равно её сумме.
230
- */
231
- cost_usd: number;
232
- /** Разбивка стоимости по валютам (код валюты → сумма, напр. `{ USD: 0.5, RUB: 42 }`). */
233
- cost_by_currency?: Record<string, number>;
234
- /** cache_read / input (0 при input = 0). */
235
- cache_hit_rate: number;
236
- duration_ms: number;
237
- /** output_tokens / (duration_ms / 1000); 0 при отсутствии длительности. */
238
- output_tps: number;
239
- subagent_sessions: number;
240
- subagent_tokens: number;
241
- }
242
- /** Статистика по автору user-сообщений (атрибуция usage последующего ответа). */
243
- export interface SessionUserStats {
244
- author: string;
245
- /** Display name профиля автора; при отсутствии профиля/имени — не задаётся. */
246
- display_name?: string;
247
- messages: number;
248
- input_tokens: number;
249
- output_tokens: number;
250
- cache_read_tokens: number;
251
- cache_write_tokens: number;
252
- reasoning_tokens: number;
253
- cost_usd: number;
254
- /** Разбивка стоимости по валютам (код валюты → сумма). */
255
- cost_by_currency?: Record<string, number>;
256
- cache_hit_rate: number;
257
- }
258
- /**
259
- * Сводка по сабагентам сессии (рекурсивно, tool `task`). Отдельный блок:
260
- * `SessionAgentStats` уже включает usage детей в свои итоги, а здесь — только
261
- * суммарная детализация по всем дочерним сессиям (в контекстное окно родителя
262
- * их usage не входит, AD-070 §2.6).
263
- */
264
- export interface SessionSubagentStats {
265
- sessions: number;
266
- input_tokens: number;
267
- output_tokens: number;
268
- cache_read_tokens: number;
269
- cache_write_tokens: number;
270
- reasoning_tokens: number;
271
- cost_usd: number;
272
- /** Разбивка стоимости по валютам (код валюты → сумма). */
273
- cost_by_currency?: Record<string, number>;
274
- }
275
- /** Ответ `GET /api/v2/sessions/:id/stats`. */
276
- export interface SessionStats {
277
- session_id: string;
278
- agents: SessionAgentStats[];
279
- users: SessionUserStats[];
280
- /** Суммарная статистика дочерних сессий сабагентов (отдельно от ответа). */
281
- subagents: SessionSubagentStats;
282
- }
283
- export interface Message {
284
- id: string;
285
- role: MessageRole;
286
- seq: number;
287
- origin: MessageOrigin;
288
- sourceMsgId?: string;
289
- parts: Part[];
290
- content: string;
291
- toolCalls?: Record<string, unknown>[];
292
- toolCallId?: string;
293
- createdAt: string;
294
- disabled: boolean;
295
- pinned: boolean;
296
- hidden: boolean;
297
- /**
298
- * AD-046 §7.1: сообщение локальной `/`-команды (builtin-ответ) — видно в
299
- * истории, но исключается из LLM-контекста.
300
- */
301
- ephemeral?: boolean;
302
- debugData?: Record<string, unknown>;
303
- model?: string;
304
- provider?: string;
305
- providerType?: string;
306
- usage?: TokenUsage;
307
- reasoning?: string;
308
- source?: 'web' | 'cli' | 'api';
309
- author?: string;
310
- agentRole?: string;
311
- metadata?: Record<string, unknown>;
312
- /** AD-070 §2.4: предсказание/валидация prompt-cache для этого хода. */
313
- promptMeta?: PromptMeta;
314
- summaryOf?: number[];
315
- qa_pass?: boolean;
316
- qa_reason?: string;
317
- }
318
- export interface SessionStatus {
319
- blocked?: string;
320
- blockedAt?: string;
321
- /**
322
- * Персистентный флаг запроса отмены генерации (кнопка «Стоп», `/stop`).
323
- * Живёт в JSON-хранилище (AD-005): позволяет остановить сессию, когда
324
- * `currentStream`/cancel-token ещё не установлены (очередь, backoff).
325
- * Сбрасывается процессором очереди после обработки.
326
- */
327
- cancelRequested?: boolean;
328
- /** Время запроса отмены (ISO) — для диагностики/аудита. */
329
- cancelRequestedAt?: string;
330
- }
331
- export declare const PLAN_MODES: readonly ["auto", "strict", "off"];
332
- export type PlanMode = (typeof PLAN_MODES)[number];
333
- export declare const SESSION_MODES: readonly ["plan", "act", "yolo"];
334
- export type SessionMode = (typeof SESSION_MODES)[number];
335
- /**
336
- * AD-071 §2.3: политика включения инструментов в запрос.
337
- * - `consistency` — в запрос идут все определения, недоступность кодируется
338
- * permission-слоем (`unavailable(mode|role)`); приоритет — валидность кэша;
339
- * - `available` — в запрос идут только доступные агенту/режиму/роли тулы;
340
- * приоритет — экономия контекстного окна;
341
- * - `auto` — выбор по провайдеру/модели: локальные → `available`, облачные → `consistency`.
342
- */
343
- export declare const TOOLS_POLICIES: readonly ["consistency", "available", "auto"];
344
- export type ToolsPolicy = (typeof TOOLS_POLICIES)[number];
345
- /** Версия схемы записи реестра MCP — для будущей миграции (AD-032). */
346
- export declare const MCP_REGISTRY_SCHEMA_VERSION = 1;
347
- export declare const MCP_REGISTRY_ORIGINS: readonly ["instance", "user"];
348
- export type McpRegistryOrigin = (typeof MCP_REGISTRY_ORIGINS)[number];
349
- export declare const MCP_REGISTRY_TRUST_LEVELS: readonly ["builtin", "community"];
350
- export type McpRegistryTrust = (typeof MCP_REGISTRY_TRUST_LEVELS)[number];
351
- /** Автор записи реестра (кто добавил сервер). */
352
- export interface McpRegistryAuthor {
353
- userId: string;
354
- username: string;
355
- }
356
- /**
357
- * AD-071 §2.5: плоская запись единого реестра MCP-серверов.
358
- *
359
- * Логическая модель сразу проектируется под PostgreSQL (AD-032): стабильный
360
- * `id`, `schemaVersion`, timestamps; вложенность ограничена `config`/`author`
361
- * (раскладываются в JSONB/отдельные колонки). Instance- и пользовательские
362
- * записи различаются полем `origin`, не отдельными реестрами.
363
- */
364
- export interface McpRegistryEntry {
365
- schemaVersion: number;
366
- id: string;
367
- name: string;
368
- config: McpServerConfig;
369
- origin: McpRegistryOrigin;
370
- author: McpRegistryAuthor | null;
371
- trust: McpRegistryTrust;
372
- /**
373
- * Системный мастер-флаг (hard-gate): `false` — сервер недоступен НИГДЕ и НИКОГДА
374
- * (в т.ч. в старых сессиях). Дефолт `true`.
375
- */
376
- enabled: boolean;
377
- /**
378
- * Переосмыслено: «включён по умолчанию для НОВЫХ ПРОЕКТОВ» — сид
379
- * `project.mcp.enabled`/`project.mcp.defaultOn` при создании проекта. Снимок:
380
- * изменение не влияет на ранее созданные проекты/сессии.
381
- */
382
- enabledByDefault: boolean;
383
- createdAt: string;
384
- updatedAt: string;
385
- }
386
- export declare const MCP_NETWORK_POLICY_MODES: readonly ["allow", "deny"];
387
- export type McpNetworkPolicyMode = (typeof MCP_NETWORK_POLICY_MODES)[number];
388
- /**
389
- * AD-071 §2.3.1: политика сетевого доступа пользовательских HTTP MCP-серверов.
390
- * - `deny` — перечисленные адреса/CIDR запрещены (дефолт: приватные диапазоны);
391
- * - `allow` — разрешены только перечисленные адреса/CIDR (всё прочее запрещено).
392
- */
393
- export interface McpNetworkPolicy {
394
- mode: McpNetworkPolicyMode;
395
- list: string[];
396
- }
397
- /** Приватные/служебные диапазоны, запрещённые по умолчанию (SSRF/egress). */
398
- 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"];
399
- /** Дефолтная политика: deny приватных диапазонов (AD-071 §2.3.1). */
400
- export declare const DEFAULT_MCP_NETWORK_POLICY: McpNetworkPolicy;
401
- export declare const MCP_SERVER_LEVELS: readonly ["system", "project", "session"];
402
- export type McpServerLevel = (typeof MCP_SERVER_LEVELS)[number];
403
- /**
404
- * AD-071 §2.2: почему сервер отключён в эффективном наборе сессии:
405
- * - `system_disabled` — выключен системным мастер-флагом (`McpRegistryEntry.enabled === false`);
406
- * - `project_disabled` — не разрешён проектом (`project.enabled` — hard-gate);
407
- * - `session_optout` — явный opt-out в сессии (`mcpDisabledServers`);
408
- * - `not_default` — нет в снапшоте сессии (`mcpDefaultOn`) и не включён явно.
409
- *
410
- * Причина `config` отсутствует: `McpServerConfig.enabled` — только сид записи
411
- * реестра (`seedFromConfig`), в резолвинге/подключении не участвует.
412
- */
413
- export declare const MCP_DISABLED_REASONS: readonly ["system_disabled", "project_disabled", "session_optout", "not_default"];
414
- export type McpDisabledReason = (typeof MCP_DISABLED_REASONS)[number];
415
- /**
416
- * AD-071 §2.4: эффективное состояние MCP-сервера для сессии. Отдаётся API
417
- * `GET /api/v2/sessions/:id/mcp`; отключённые серверы не исчезают из выдачи.
418
- */
419
- export interface McpServerEffective {
420
- name: string;
421
- level: McpServerLevel;
422
- enabled: boolean;
423
- /** Причина отключения (только при `enabled === false`). */
424
- reason?: McpDisabledReason;
425
- connected?: boolean;
426
- origin: McpRegistryOrigin;
427
- trust: McpRegistryTrust;
428
- /**
429
- * AD-071 §2.2/§2.6: транспортный статус для таблицы «MCP» в статистике:
430
- * `disabled` — выключен в эффективном наборе, `connected`/`error`/`circuit-open`
431
- * — состояние подключения активного сервера.
432
- */
433
- status?: 'connected' | 'error' | 'disabled' | 'circuit-open';
434
- /** AD-071 §2.5/§2.6: автор записи реестра (null для instance/config-серверов). */
435
- author?: McpRegistryAuthor | null;
436
- /** AD-071 §2.2/§2.6: имена инструментов сервера (пусто, если не подключён). */
437
- tools?: string[];
438
- /** AD-071 §2.6: суммарные символы JSON-определений тулов сервера. */
439
- chars?: number;
440
- /** AD-071 §2.6: оценка токенов сервера (`ceil(chars / ratio)`). */
441
- estTokens?: number;
442
- /** AD-071 §2.6: chars-per-token, применённый к оценке (4 — без калибровки). */
443
- ratio?: number;
444
- /** AD-071 §2.6: пер-тульные chars/estTokens/ratio + признак admin_disabled. */
445
- toolDetails?: McpToolDetail[];
446
- }
447
- export declare const TODO_STATUSES: readonly ["pending", "in_progress", "completed", "cancelled"];
448
- export type TodoStatus = (typeof TODO_STATUSES)[number];
449
- export declare const TODO_PRIORITIES: readonly ["high", "medium", "low"];
450
- export type TodoPriority = (typeof TODO_PRIORITIES)[number];
451
- export interface TodoItem {
452
- id: string;
453
- content: string;
454
- status: TodoStatus;
455
- priority: TodoPriority;
456
- /** Связь с пунктом плана проекта (AD-039). */
457
- planItemId?: string;
458
- }
459
- export type ReasoningLevel = 'default' | 'none' | 'low' | 'medium' | 'high';
460
- export interface SessionSettings {
461
- provider?: string;
462
- model?: string;
463
- /** Уровень размышлений модели. Для openai/generic — reasoning_effort, anthropic — thinking, ollama — think. */
464
- reasoningLevel?: ReasoningLevel;
465
- temperature: number;
466
- maxTokens: number;
467
- systemPrompt?: string;
468
- debugEnabled: boolean;
469
- streamEnabled: boolean;
470
- agentRole?: string;
471
- /** AD-071 §2.4: явно включённые в сессии серверы (session level). */
472
- mcpServers?: string[];
473
- /**
474
- * AD-071 §2.4: явные opt-out серверы сессии (включая системные). Вычитаются
475
- * из эффективного набора (`(seed ∪ enabled) − disabled`).
476
- */
477
- mcpDisabledServers?: string[];
478
- /**
479
- * AD-071 §2.4: СНАПШОТ MCP-серверов «по умолчанию» на момент создания сессии
480
- * (снимок `project.defaultOn` либо системного дефолта `enabledByDefault`).
481
- * Изменение дефолта проекта/системы не влияет на существующие сессии.
482
- */
483
- mcpDefaultOn?: string[];
484
- contextOptimization: 'none' | 'sliding_window' | 'summarization' | 'sticky_notes';
485
- slidingWindowMode: 'messages' | 'tokens';
486
- slidingWindowMessageLimit: number;
487
- slidingWindowTokenThreshold: number;
488
- summarizationEnabled: boolean;
489
- summarizationTriggerMode: 'messages' | 'tokens';
490
- summarizeAfterN: number;
491
- summarizeTokenThreshold: number;
492
- summarizationHeadMessages: number;
493
- summarizationTailMessages: number;
494
- showInterview: boolean;
495
- websocketEnabled: boolean;
496
- language?: string;
497
- routingEnabled: boolean;
498
- routingStrategy: 'content' | 'cost' | 'content+cost' | 'auto';
499
- routingContent: {
500
- coding?: {
501
- provider: string;
502
- model: string;
503
- };
504
- chat?: {
505
- provider: string;
506
- model: string;
507
- };
508
- research?: {
509
- provider: string;
510
- model: string;
511
- };
512
- };
513
- routingEscalation: {
514
- enabled: boolean;
515
- fallbackProvider: string;
516
- fallbackModel: string;
517
- checks: ('min_length' | 'constraint' | 'self_check')[];
518
- minLength: number;
519
- };
520
- routingCost: {
521
- enabled: boolean;
522
- cheapProvider: string;
523
- cheapModel: string;
524
- maxCheapTokens: number;
525
- };
526
- subagentRouting: {
527
- enabled: boolean;
528
- model?: string;
529
- provider?: string;
530
- };
531
- /** Категория, установленная моделью через classify_conversation. Приоритет над keyword-классификатором. */
532
- routingCategory?: 'coding' | 'chat' | 'research';
533
- /** Включить микро-слой: обработка простых запросов без LLM (приветствия, классификация, enum-решения). */
534
- microFirst: boolean;
535
- /** Порог уверенности микро-слоя. confidence >= порог → OK, иначе UNSURE → LLM fallback. */
536
- microConfidenceThreshold: number;
537
- /** Включить embedding-слой в микро-каскаде. */
538
- embeddingEnabled: boolean;
539
- /** Провайдер для embedding-модели. */
540
- embedProvider?: string;
541
- /** Модель для embedding. */
542
- embedModel?: string;
543
- /**
544
- * AD-084: включить decision-уровень в микро-каскаде (перед локальной LLM).
545
- * Не задано — берётся `config.decision.enabled`; `false` — принудительное
546
- * отключение уровня в сессии.
547
- */
548
- decisionFirst?: boolean;
549
- /** Гранулярные permissions сессии. Приоритетнее глобальной секции permission в config.yaml. */
550
- permission?: PermissionConfig;
551
- /** Доступность MCP-инструментов по режимам plan/act (serverName → настройки). */
552
- mcpToolSettings?: Record<string, McpServerToolSettings>;
553
- /**
554
- * Per-session override политики включения **встроенных** инструментов. Если
555
- * задан — перекрывает глобальную `tools.policy` из config.yaml. `auto`
556
- * резолвится по провайдеру/модели текущего запроса.
557
- */
558
- toolsPolicy?: ToolsPolicy;
559
- /**
560
- * Per-session override политики включения **MCP**-инструментов. Если задан —
561
- * перекрывает глобальную `mcp.policy` из config.yaml. Независима от
562
- * `toolsPolicy`; `auto` резолвится по провайдеру/модели текущего запроса.
563
- */
564
- mcpPolicy?: ToolsPolicy;
565
- /** Строгость цикла Plan→Build: auto — модель сама решает, strict — план обязателен, off — планирование отключено. */
566
- planMode?: PlanMode;
567
- /** AD-046: явно включённые в сессии имена скиллов (session level, volatile-каталог). */
568
- skills?: string[];
569
- /** AD-046: opt-out сессии — имена, категории или группы скиллов (volatile-каталог). */
570
- skillsDisabled?: string[];
571
- /**
572
- * AD-046: СНАПШОТ скиллов «по умолчанию» на момент создания сессии (снимок
573
- * `project.skills.defaultOn` либо системного дефолта). Изменение дефолта
574
- * проекта/системы не влияет на существующие сессии.
575
- */
576
- skillsDefaultOn?: string[];
577
- /** Per-session override LLM Gateway (AD-036). */
578
- llmGateway?: {
579
- enabled?: boolean;
580
- };
581
- }
582
- export interface StreamInfo {
583
- streamId: string;
584
- message: string;
585
- agentRole?: string;
586
- startedAt: string;
587
- cancelled: boolean;
588
- }
589
- export interface Branch {
590
- id: string;
591
- parentId?: string;
592
- name: string;
593
- messages: Message[];
594
- createdAt: string;
595
- }
596
- export interface Checkpoint {
597
- id: string;
598
- sessionId: string;
599
- messages: Message[];
600
- createdAt: string;
601
- }
602
- export interface StickyNote {
603
- id: string;
604
- content: string;
605
- createdAt: string;
606
- updatedAt: string;
607
- disabled: boolean;
608
- }
609
- export interface SessionReference {
610
- type: 'session_reference';
611
- sessionId: string;
612
- label: string;
613
- messageRange: [number, number];
614
- autoSummary?: string;
615
- createdAt: string;
616
- }
617
- export interface Session {
618
- id: string;
619
- title?: string;
620
- /** Канонический ключ иконки (PROJECT_ICON_KEYS); legacy-значения → undefined. */
621
- icon?: string;
622
- /** Канонический ключ цвета (PROJECT_COLOR_KEYS); невалидные значения сбрасываются. */
623
- color?: string;
624
- sessionOrigin: SessionOrigin;
625
- parentId?: string;
626
- branchPoint?: string;
627
- /** Флаг «план утверждён через plan_exit» (AD-039), нужен для strict-режима AD-028. */
628
- planApproved?: boolean;
629
- /** Текущий runtime-режим сессии (AD-025): 'plan' — только чтение, 'act' — полный доступ. */
630
- mode?: SessionMode;
631
- /** Todo-список сессии (тул todo_write), как в OpenCode. */
632
- todos?: TodoItem[];
633
- /**
634
- * AD-070 §2.4/§2.7: состояние промпта per-agent (ключ — agentRole или
635
- * `__default__`). Пишется только при смене generation.
636
- */
637
- promptStates?: Record<string, PromptState>;
638
- /** Карта обфускации LLM Gateway (AD-036). Живёт всю сессию независимо от глобального тумблера. */
639
- obfuscationMap?: Record<string, string>;
640
- userId?: string;
641
- ownerId?: string;
642
- projectId?: string;
643
- engine: 'synth' | 'opencode' | 'cline';
644
- messages: Message[];
645
- pendingMessages: Message[];
646
- status: SessionStatus;
647
- settings: SessionSettings;
648
- mcpServers?: string[];
649
- checkpoints: Checkpoint[];
650
- stickyNotes: StickyNote[];
651
- references: SessionReference[];
652
- currentStream?: StreamInfo;
653
- summarizationPending: boolean;
654
- canSummarize: boolean;
655
- createdAt: string;
656
- updatedAt: string;
657
- /**
658
- * AD-089: ISO-8601 — время авто-архивации ephemeral-сессии (server-managed,
659
- * клиент задать не может). Задан — сессия скрывается из списков по умолчанию.
660
- */
661
- expiresAt?: string;
662
- /** AD-089: ISO-8601 — время архивации сессии (server-managed). */
663
- archivedAt?: string;
664
- inputTokens: number;
665
- outputTokens: number;
666
- totalTokens: number;
667
- cacheReadTokens: number;
668
- cacheWriteTokens: number;
669
- reasoningTokens: number;
670
- inputCost: number;
671
- outputCost: number;
672
- cacheReadCost: number;
673
- cacheWriteCost: number;
674
- /**
675
- * AD-070 §2.3: доля кэшированных входных токенов сессии —
676
- * `cacheReadTokens / inputTokens` (0 при `inputTokens === 0`).
677
- */
678
- cacheHitRate?: number;
679
- }
680
- /**
681
- * AD-076: запись реестра git-репозиториев проекта. Старые данные (`repos` как
682
- * `string[]` либо `{ path }`) нормализуются через `normalizeGitRepoConfig`.
683
- */
684
- export interface GitRepoConfig {
685
- /** Стабильный id записи реестра (uuid); отсутствует у обнаруженных scan-ом. */
686
- id?: string;
687
- name?: string;
688
- url?: string;
689
- type?: 'https' | 'ssh';
690
- /** Относительный путь ВНУТРИ project.workspace (допускает вложенность). */
691
- path: string;
692
- defaultBranch?: string;
693
- sshKeyId?: string;
694
- lastFetch?: string;
695
- }
696
- /**
697
- * AD-076: SSH-ключ агента — отдельная сущность реестра (не в
698
- * `AgentDefinition`). Секреты `privateKey`/`passphrase` шифруются at-rest
699
- * (AES-256-GCM; реализация — в core) и НИКОГДА не отдаются через API.
700
- */
701
- export interface SSHKey {
702
- id: string;
703
- name: string;
704
- /** Метка типа ключа, дефолт `'user'`. */
705
- type?: string;
706
- privateKey: string;
707
- passphrase?: string;
708
- /** Привязка к агентам: один ключ может обслуживать несколько агентов. */
709
- agentIds: string[];
710
- createdAt: string;
711
- updatedAt?: string;
712
- }
713
- /** Публичное представление ключа (без `privateKey`/`passphrase`). */
714
- export type SSHKeyMeta = Omit<SSHKey, 'privateKey' | 'passphrase'>;
715
- export interface RepoStatus {
716
- path: string;
717
- isRepo: boolean;
718
- currentBranch?: string;
719
- lastCommitAt?: string;
720
- lastCommitSubject?: string;
721
- }
722
- export interface CommitInfo {
723
- hash: string;
724
- shortHash: string;
725
- subject: string;
726
- message: string;
727
- author: string;
728
- authorEmail: string;
729
- date: string;
730
- relativeDate: string;
731
- branch: string;
732
- }
733
- export interface CommitFileInfo {
734
- path: string;
735
- status: 'added' | 'modified' | 'deleted' | 'renamed';
736
- additions: number;
737
- deletions: number;
738
- }
739
- export interface CommitDetail extends CommitInfo {
740
- files: CommitFileInfo[];
741
- diff: string;
742
- }
743
- export interface StatusMessage {
744
- id: string;
745
- text: string;
746
- type: StatusMessageType;
747
- timestamp: string;
748
- }
749
- export interface ProjectLogEntry {
750
- id: string;
751
- text: string;
752
- createdAt: string;
753
- sessionId?: string;
754
- author?: string;
755
- }
756
- /**
757
- * AD-071 §2.4/§2.5: проектный скоуп MCP — ссылки на записи единого реестра по
758
- * имени.
759
- * - `enabled` — hard-gate: серверы, разрешённые проекту. Не разрешённый сервер
760
- * недоступен ни в одной сессии проекта (в т.ч. старой). Пустой массив — «всё
761
- * выключено» (opt-in); отсутствие `project.mcp` — гейт не задан (legacy).
762
- * - `defaultOn` — сид «по умолчанию для новых сессий»: снапшот `mcpDefaultOn`
763
- * при создании сессии. Изменение не влияет на ранее созданные сессии.
764
- */
765
- export interface ProjectMcpSettings {
766
- enabled: string[];
767
- defaultOn: string[];
768
- }
769
- /**
770
- * AD-046 §4.5: проектный скоуп скиллов (owner/lead) — аналог `ProjectMcpSettings`.
771
- * - `enabled` — hard-gate: доступные проекту скиллы. Пустой массив — «всё
772
- * выключено» (opt-in); отсутствие `project.skills` — гейт не задан (legacy).
773
- * - `defaultOn` — сид «по умолчанию для новых сессий»: снапшот
774
- * `skillsDefaultOn` при создании сессии.
775
- */
776
- export interface ProjectSkillSettings {
777
- enabled: string[];
778
- defaultOn: string[];
779
- }
780
- /**
781
- * AD-075: политика для абсолютного `project.workspace` вне `workspacesRoot`.
782
- * - `confirm` — путь разрешён только с явным подтверждением (`confirmOutsideRoot`);
783
- * - `deny` — путь запрещён (managed-развёртывание: жёстко).
784
- *
785
- * Значение `''` (пустая строка) в конфиге означает «не задано» — эффективной
786
- * политикой тогда считается `confirm` (резолвер `resolveWorkspaceOutsideRootPolicy`).
787
- */
788
- export type WorkspaceOutsideRootPolicy = 'confirm' | 'deny';
789
- /**
790
- * AD-075: ответ `GET /api/v2/settings/workspace-policy`.
791
- * `readOnly` (additive) — managed-развёртывание: политика задаётся развёртыванием,
792
- * `PUT`/`DELETE` возвращают 403 `WORKSPACE_POLICY_READ_ONLY`.
793
- */
794
- export interface WorkspacePolicyInfo {
795
- outsideRoot: WorkspaceOutsideRootPolicy;
796
- isOverridden: boolean;
797
- defaults: WorkspaceOutsideRootPolicy;
798
- readOnly?: boolean;
799
- }
800
- export interface Project {
801
- id: string;
802
- name: string;
803
- ownerId: string;
804
- members: Record<string, ProjectRole>;
805
- description: string;
806
- currentTask: string;
807
- invariants: string;
808
- icon?: string;
809
- color?: string;
810
- workspace?: string;
811
- repos?: GitRepoConfig[];
812
- /** AD-071 §2.4: проектный скоуп MCP (owner/lead). */
813
- mcp?: ProjectMcpSettings;
814
- /** AD-046 §4.5: проектный скоуп скиллов (owner/lead). */
815
- skills?: ProjectSkillSettings;
816
- statusMessages: StatusMessage[];
817
- /** Kanban-план проекта (AD-039). Владеет проектом, а не сессией. */
818
- plan?: ProjectPlan;
819
- /** Лог работ проекта (ведётся моделью через project_log_write). */
820
- log?: ProjectLogEntry[];
821
- createdAt: string;
822
- updatedAt: string;
823
- }
824
- /**
825
- * Канонические ключи иконок проектов и сессий (единый список для server и UI).
826
- * Значения — только ключи реестра (загружаемые картинки не поддерживаются).
827
- */
828
- export declare const PROJECT_ICON_KEYS: readonly ["code", "terminal", "rocket", "flask", "gamepad", "briefcase", "home", "globe", "leaf", "shield", "palette", "server", "phone", "database", "lightbulb", "music", "camera", "book", "heart", "folder", "chat", "cpu", "file", "file-code", "docs", "task", "todo", "bug", "robot", "brain", "git", "repo", "test", "chart", "star", "image", "calendar"];
829
- export type ProjectIconKey = (typeof PROJECT_ICON_KEYS)[number];
830
- /**
831
- * Канонические ключи цветов проектов и сессий — 16 цветов палитры темы
832
- * (`palette.colors[].key` в `a1..a16`; единый список для server и UI).
833
- */
834
- export declare const PROJECT_COLOR_KEYS: readonly ["a1", "a2", "a3", "a4", "a5", "a6", "a7", "a8", "a9", "a10", "a11", "a12", "a13", "a14", "a15", "a16"];
835
- export type ProjectColorKey = (typeof PROJECT_COLOR_KEYS)[number];
836
- export interface PlanColumn {
837
- id: string;
838
- name: string;
839
- order: number;
840
- wipLimit?: number;
841
- }
842
- export interface PlanDependency {
843
- projectId?: string;
844
- itemId: string;
845
- relation: 'blocked_by' | 'blocks' | 'relates_to';
846
- }
847
- export interface PlanItem {
848
- id: string;
849
- title: string;
850
- description?: string;
851
- columnId: string;
852
- priority: 'high' | 'medium' | 'low';
853
- order: number;
854
- dependsOn: PlanDependency[];
855
- tags?: string[];
856
- createdAt: string;
857
- updatedAt: string;
858
- }
859
- export interface ProjectPlan {
860
- version: number;
861
- updatedAt: string;
862
- columns: PlanColumn[];
863
- items: PlanItem[];
864
- }
865
- export interface User {
866
- id: string;
867
- username: string;
868
- email?: string;
869
- roles: string[];
870
- preferredLanguage: string;
871
- createdAt: string;
872
- teamRole: string;
873
- notes: string;
874
- interviewCompleted: boolean;
875
- isLocal?: boolean;
876
- isTestUser?: boolean;
877
- }
878
- export interface TestUser {
879
- username: string;
880
- apiKey: string;
881
- roles: string[];
882
- displayName: string;
883
- }
884
- export interface AuthConfig {
885
- debugMode: boolean;
886
- apiKey?: string;
887
- testUsers?: TestUser[];
888
- sessionMaxAgeMinutes: number;
889
- oidc?: {
890
- enabled: boolean;
891
- issuer: string;
892
- clientId: string;
893
- clientSecret: string;
894
- redirectUri: string;
895
- /** Public client_id для локального CLI/core (ROPC/device flow). Не секрет. */
896
- cliClientId?: string;
897
- };
898
- }
899
- export type AgentMode = 'primary' | 'subagent' | 'system';
900
- export interface AgentDefinition {
901
- id: string;
902
- displayName: string;
903
- contextFile?: string;
904
- capabilities: ToolCapability[];
905
- enabled: boolean;
906
- provider?: string;
907
- model?: string;
908
- temperature?: number;
909
- topP?: number;
910
- topK?: number;
911
- /** Уровень размышлений агента. Не задано — используется session.settings.reasoningLevel. */
912
- reasoningLevel?: ReasoningLevel;
913
- agentMode?: AgentMode | AgentMode[];
914
- subagentPrompt?: string;
915
- maxSteps?: number;
916
- isOverridden: boolean;
917
- icon?: string;
918
- color?: string;
919
- description?: string;
920
- /**
921
- * AD-046 §6.2: группы агентов для привязки скиллов
922
- * (`metadata.synth.groups`). Пусто/не задано — скилл с непустым `groups`
923
- * не привязан к агенту.
924
- */
925
- groups?: string[];
926
- }
927
- /** Валюта цен моделей. Отсутствует у модели → валюта провайдера → USD. */
928
- export declare const CURRENCIES: readonly ["RUB", "USD", "CNY"];
929
- export type Currency = (typeof CURRENCIES)[number];
930
- /** Проверка, что значение — допустимая валюта (RUB/USD/CNY). */
931
- export declare function isCurrency(value: unknown): value is Currency;
932
- /** Ленивый разбор валюты: неизвестное значение → undefined. */
933
- export declare function parseCurrency(value: unknown): Currency | undefined;
934
- /** Результат строгого разбора поля `currency` из тела запроса. */
935
- export type CurrencyInputResult = {
936
- ok: true;
937
- currency: Currency | undefined;
938
- } | {
939
- ok: false;
940
- };
941
- /**
942
- * Строгий разбор поля `currency`:
943
- * - `undefined` — поле не передано (сохранить existing);
944
- * - `null`/`''` — явно очистить (undefined);
945
- * - валидная валюта — принять;
946
- * - иная непустая строка — ошибка (`ok: false`), чтобы не терять значение молча.
947
- */
948
- export declare function parseCurrencyInput(raw: unknown, existing?: Currency): CurrencyInputResult;
949
- /** Присутствуют ли в теле запроса ценовые поля (snake_case или camelCase). */
950
- export declare function hasPriceInput(body: unknown): boolean;
951
- /**
952
- * AD-036/AD-072: дефолт rate limit LLM Gateway. Единый источник для Zod-схемы
953
- * конфига и runtime-дефолтов (settings-роуты, fallback'и backend/core).
954
- */
955
- export declare const DEFAULT_LLM_GATEWAY_RATE_LIMIT: {
956
- readonly userPerMinute: 60;
957
- readonly providerPerMinute: 120;
958
- };
959
- export interface ProviderConfig {
960
- name: string;
961
- type: string;
962
- baseUrl?: string;
963
- apiKey?: string;
964
- defaultModel?: string;
965
- timeout?: number;
966
- enabled?: boolean;
967
- icon?: string;
968
- /** Валюта по умолчанию для моделей провайдера. Отсутствует → USD. */
969
- currency?: Currency;
970
- }
971
- export type ContextSource = 'api' | 'reference' | 'manual' | 'unknown';
972
- /**
973
- * Источник цен модели: `api` — получены синхронизацией с провайдером,
974
- * `manual` — заданы пользователем вручную, `unknown` — не определены.
975
- */
976
- export type PriceSource = 'api' | 'manual' | 'unknown';
977
- export type ContextCategory = 'user' | 'role' | 'system';
978
- export interface ContextFileInfo {
979
- filename: string;
980
- isSystem: boolean;
981
- isOverridden: boolean;
982
- category: ContextCategory;
983
- size: number;
984
- modifiedAt?: number;
985
- enabled?: boolean;
986
- }
987
- export interface ContextFileContent {
988
- filename: string;
989
- content: string;
990
- isSystem: boolean;
991
- isOverridden: boolean;
992
- category: ContextCategory;
993
- }
994
- /**
995
- * AD-089: внешняя идентичность, привязанная к профилю пользователя.
996
- * Ключ — `provider` + `externalId` (числовой id источника). `username`/
997
- * `displayName` — display-кэш (может устареть), НЕ ключ.
998
- */
999
- export interface ExternalIdentity {
1000
- /** Префикс principalId (AD-089), напр. 'tg' (Telegram). */
1001
- provider: string;
1002
- /** Числовой id в источнике, строкой (напр. '450316139'). */
1003
- externalId: string;
1004
- /** Display-кэш: username источника (может устареть). */
1005
- username?: string;
1006
- /** Display-кэш: отображаемое имя источника. */
1007
- displayName?: string;
1008
- /** ISO: когда привязано. */
1009
- linkedAt: string;
1010
- /** Кто подтвердил (id пользователя инстанса). */
1011
- linkedBy?: string;
1012
- }
1013
- /**
1014
- * AD-089: principalId внешнего отправителя из пары провайдер+id.
1015
- * Формат — `<provider>:<externalId>` (напр. `tg:450316139`).
1016
- */
1017
- export declare function buildPrincipalId(provider: string, externalId: string): string;
1018
- /**
1019
- * AD-089: разбор principalId на `provider`/`externalId` — деление по **первому**
1020
- * `:`. Невалидное (нет `:`, пустые части) → `null`.
1021
- */
1022
- export declare function parsePrincipalId(principalId: string): {
1023
- provider: string;
1024
- externalId: string;
1025
- } | null;
1026
- export interface ProfileData {
1027
- id: string;
1028
- username: string;
1029
- email?: string;
1030
- phone?: string;
1031
- roles: string[];
1032
- teamRoles: string[];
1033
- isActive: boolean;
1034
- preferences: Record<string, unknown>;
1035
- notes: string;
1036
- /**
1037
- * Онбординг-интервью пройдено. Отдельное поле вместо legacy-метки
1038
- * `[ИНТЕРВЬЮ]` в свободном `notes`. Не задано (legacy-профиль) — бэкфилл при
1039
- * чтении по наличию метки (`FileProfileStore._deserialize`).
1040
- */
1041
- interviewCompleted: boolean;
1042
- /** ISO-время завершения интервью (для аудита/аналитики). */
1043
- interviewCompletedAt?: string;
1044
- displayName?: string;
1045
- /**
1046
- * AD-089: внешние идентичности (Telegram и др.), привязанные к профилю.
1047
- * Опционально — legacy-профили без поля трактуются как `[]`. Ключ — пара
1048
- * `provider`+`externalId`; `username`/`displayName` — display-кэш.
1049
- */
1050
- identities?: ExternalIdentity[];
1051
- createdAt: string;
1052
- updatedAt: string;
1053
- lastLogin?: string;
1054
- }
1055
- export interface InterviewQuestion {
1056
- id: string;
1057
- question: string;
1058
- order: number;
1059
- }
1060
- export interface InterviewStatus {
1061
- inProgress: boolean;
1062
- completed: boolean;
1063
- currentQuestion?: InterviewQuestion;
1064
- totalQuestions: number;
1065
- answered: number;
1066
- }
1067
- export interface ModelConfig {
1068
- id: string;
1069
- name: string;
1070
- provider: string;
1071
- description?: string;
1072
- enabled: boolean;
1073
- isDefault?: boolean;
1074
- contextWindow?: number;
1075
- contextSource?: ContextSource;
1076
- maxOutputTokens?: number;
1077
- inputPrice?: number;
1078
- outputPrice?: number;
1079
- cacheReadPrice?: number;
1080
- cacheWritePrice?: number;
1081
- /** Откуда взяты цены: `api` — синхронизация, `manual` — ручной ввод. */
1082
- priceSource?: PriceSource;
1083
- /** Валюта цен модели; отсутствует → валюта провайдера → USD. */
1084
- currency?: Currency;
1085
- }
1086
- export interface TokenUsage {
1087
- inputTokens: number;
1088
- outputTokens: number;
1089
- totalTokens: number;
1090
- cacheReadTokens?: number;
1091
- cacheWriteTokens?: number;
1092
- reasoningTokens?: number;
1093
- }
1094
- export interface LLMChunk {
1095
- content: string;
1096
- isFinal: boolean;
1097
- usage?: TokenUsage;
1098
- toolCalls?: Record<string, unknown>[];
1099
- reasoning?: string;
1100
- model?: string;
1101
- }
1102
- export interface LLMResponse {
1103
- content: string;
1104
- model: string;
1105
- usage: TokenUsage;
1106
- toolCalls?: Record<string, unknown>[];
1107
- reasoning?: string;
1108
- debugInfo?: Record<string, unknown>;
1109
- }
1110
- export interface QueueItem {
1111
- message: Message;
1112
- streamId: string;
1113
- enqueuedAt: string;
1114
- }
1115
- export type EventType = 'session.created' | 'session.updated' | 'session.deleted' | 'session.renamed' | 'session.forked' | 'session.fork.created' | 'session.reference.added' | 'session.reference.removed' | 'session.messages.merged' | 'session.moved' | 'project.updated' | 'fs.changed' | 'message.added' | 'message.updated' | 'child.message.added' | 'child.session.updated' | 'stream.start' | 'stream.chunk' | 'stream.usage' | 'stream.done' | 'stream.ended' | 'stream.cancelled' | 'stream.error' | 'stream.retry' | 'queue.stalled' | 'message.queued' | 'permission.asked' | 'permission.replied' | 'permission.hold' | 'question.asked' | 'question.replied' | 'context.summarization_pending' | 'context.summarized' | 'context.sliding_window_applied' | 'context.limit_warning' | 'context.sticky_note_added' | 'context.sticky_note_updated' | 'context.sticky_note_deleted' | 'context.instructions_loaded' | 'tool_call.started' | 'tool_call.result' | 'tool_call.loop' | 'subagent.progress' | 'subagent.retry' | 'subagent.resume.started' | 'subagent.resume.finished' | 'permission.asked' | 'permission.replied' | 'permission.denied' | 'message.quality_check' | 'session.routing_category' | 'plan.approved' | 'todos.updated' | 'skill.invoked' | 'command.invoked' | 'command.inline_shell' | 'event.received' | 'event.routed' | 'binding.changed' | 'error';
1116
- export interface BusEvent {
1117
- type: EventType;
1118
- sessionId: string;
1119
- data: Record<string, unknown>;
1120
- timestamp: string;
1121
- }
1122
- export declare enum FsErrorCode {
1123
- PATH_TRAVERSAL = "PATH_TRAVERSAL",
1124
- NOT_FOUND = "NOT_FOUND",
1125
- NOT_A_DIRECTORY = "NOT_A_DIRECTORY",
1126
- IS_DIRECTORY = "IS_DIRECTORY",
1127
- BINARY_FILE = "BINARY_FILE",
1128
- WORKSPACE_NOT_SET = "WORKSPACE_NOT_SET",
1129
- WORKSPACE_NOT_FOUND = "WORKSPACE_NOT_FOUND",
1130
- PERMISSION_DENIED = "PERMISSION_DENIED",
1131
- ALREADY_EXISTS = "ALREADY_EXISTS",
1132
- DIR_NOT_EMPTY = "DIR_NOT_EMPTY",
1133
- /** AD-075: путь вне `workspacesRoot` запрещён политикой (managed). */
1134
- WORKSPACE_OUTSIDE_ROOT_DENIED = "WORKSPACE_OUTSIDE_ROOT_DENIED"
1135
- }
1136
- export interface FileEntry {
1137
- name: string;
1138
- path: string;
1139
- isDirectory: boolean;
1140
- size: number;
1141
- modifiedAt: number;
1142
- }
1143
- export interface DirectoryListResult {
1144
- path: string;
1145
- entries: FileEntry[];
1146
- }
1147
- export interface FileReadResult {
1148
- path: string;
1149
- content: string;
1150
- size: number;
1151
- encoding: 'utf-8' | 'binary';
1152
- }
1153
- export interface FileWriteBody {
1154
- projectId: string;
1155
- path: string;
1156
- content: string;
1157
- }
1158
- export interface FileMkdirBody {
1159
- projectId: string;
1160
- path: string;
1161
- }
1162
- export interface FsError {
1163
- error: string;
1164
- code: FsErrorCode;
1165
- }
1
+ export * from './message.js';
2
+ export * from './session.js';
3
+ export * from './prompt.js';
4
+ export * from './mcp.js';
5
+ export * from './project.js';
6
+ export * from './git.js';
7
+ export * from './user.js';
8
+ export * from './agent.js';
9
+ export * from './provider.js';
10
+ export * from './llm.js';
11
+ export * from './bus-events.js';
12
+ export * from './fs.js';
1166
13
  export * from './tools.js';
1167
14
  export * from './permission.js';
1168
15
  export * from './skills.js';
@@ -1173,3 +20,6 @@ export * from './schedules.js';
1173
20
  export * from './decision.js';
1174
21
  export * from './service-keys.js';
1175
22
  export * from './webhooks.js';
23
+ export * from './maintenance.js';
24
+ export * from './egress.js';
25
+ export * from './analytics.js';