@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
@@ -0,0 +1,237 @@
1
+ import type { ToolsPolicy } from './session.js';
2
+ /** Состояние одного блока системного промпта (хэш/размер для диагностики). */
3
+ export interface PromptBlockState {
4
+ key: string;
5
+ hash: string;
6
+ chars: number;
7
+ }
8
+ /**
9
+ * ADR-070 §2.4: состояние системного промпта per-agent. Хранится в сессии
10
+ * (`Session.promptStates`) и пишется только при смене generation.
11
+ */
12
+ export interface PromptState {
13
+ generation: number;
14
+ /** sha256(stablePrefix). */
15
+ staticPrefixHash: string;
16
+ /** Закреплённые байты кэшируемого префикса. */
17
+ staticPrefix: string;
18
+ /** sha256(полного system). */
19
+ systemHash: string;
20
+ blocks: PromptBlockState[];
21
+ reason: 'init' | 'compaction' | 'generation-change' | 'override' | 'agent-change';
22
+ updatedAt: string;
23
+ }
24
+ /** ADR-070 §2.4: компактная мета промпта, кладётся в assistant-сообщение. */
25
+ export interface PromptMeta {
26
+ /** agentKey, к которому относится ход (agentRole или `__default__`). */
27
+ agentRole?: string;
28
+ generation: number;
29
+ /** Предсказание по staticPrefixHash. */
30
+ expected: 'hit' | 'miss';
31
+ /** Фактический cacheRead из usage. */
32
+ cachedTokens: number;
33
+ /** expected подтверждён/опровергнут фактом. */
34
+ validated: boolean;
35
+ }
36
+ /** Тир консистентности блока системного промпта (ADR-070 §2.1). */
37
+ export type PromptTier = 'stable' | 'context' | 'volatile';
38
+ /** Статус блока в манифесте промпта. */
39
+ export type PromptManifestStatus = 'loaded' | 'truncated' | 'empty' | 'blocked' | 'suppressed';
40
+ /** ADR-070 §2.5: запись манифеста — источник системного промпта. */
41
+ export interface PromptManifestEntry {
42
+ key: string;
43
+ label: string;
44
+ tier: PromptTier;
45
+ /** Порядок блока внутри тира (реальный порядок отправки, ADR-070 §2.5). */
46
+ order?: number;
47
+ chars: number;
48
+ /** Эвристика: Math.ceil(chars / 4). */
49
+ estTokens: number;
50
+ status: PromptManifestStatus;
51
+ provenance?: string;
52
+ /**
53
+ * Источник записи: `system` — блок системного промпта, `tools` — слой
54
+ * встроенных инструментов (stable, ADR-070 §2.5), `mcp.tools` — слой
55
+ * MCP-инструментов (volatile, ADR-071 §2.1). Слои инструментов не входят в
56
+ * system-текст, но отражаются в манифесте и размерах.
57
+ */
58
+ source?: 'system' | 'tools' | 'mcp.tools';
59
+ }
60
+ /** ADR-070 §2.5: манифест состава системного промпта (для API/UI/тестов). */
61
+ export interface PromptManifest {
62
+ generation?: number;
63
+ totalChars: number;
64
+ estTokens: number;
65
+ staticPrefixChars: number;
66
+ /**
67
+ * ADR-071 §2.3: фактически применённая политика **встроенных** инструментов
68
+ * (`auto` уже разрешён в `consistency`/`available`) — видно, какая политика
69
+ * сработала.
70
+ */
71
+ toolsPolicy?: Exclude<ToolsPolicy, 'auto'>;
72
+ /**
73
+ * ADR-071 §2.3: фактически применённая политика **MCP**-инструментов
74
+ * (`auto` уже разрешён в `consistency`/`available`). Независима от
75
+ * `toolsPolicy`.
76
+ */
77
+ mcpPolicy?: Exclude<ToolsPolicy, 'auto'>;
78
+ /**
79
+ * ADR-071 §2.6: chars-per-token, применённый к `estTokens` (калибровка по
80
+ * фактическому usage; 4 — без калибровки). `estTokens` — оценка, не факт.
81
+ */
82
+ ratio?: number;
83
+ entries: PromptManifestEntry[];
84
+ }
85
+ /** Дефолтный chars-per-token, если калибровки для модели нет. */
86
+ export declare const DEFAULT_CHARS_PER_TOKEN = 4;
87
+ /**
88
+ * Нижняя граница разумного chars-per-token (аномальные семплы отбрасываются).
89
+ * CJK/эффективные BPE дают ~1–2 символа на токен, поэтому допускаем 1.5.
90
+ */
91
+ export declare const MIN_CHARS_PER_TOKEN = 1.5;
92
+ /**
93
+ * Верхняя граница разумного chars-per-token. Берётся с запасом: «эффективные»
94
+ * токенизаторы (например, `omn.qwen3.8:27b`) дают ratio ≈ 11.7.
95
+ */
96
+ export declare const MAX_CHARS_PER_TOKEN = 16;
97
+ /** Минимальный `usage.inputTokens` для калибровки — меньшие значения шумные. */
98
+ export declare const MIN_CALIBRATION_INPUT_TOKENS = 500;
99
+ /**
100
+ * ADR-071 §2.6: строка таблицы «Встроенные инструменты» в панели статистики.
101
+ * Отдаётся `GET /sessions/:id/prompt` полем `toolsDetail` (аддитивно).
102
+ */
103
+ export interface PromptToolDetail {
104
+ name: string;
105
+ capabilities: string[];
106
+ /** Доступен ли тул текущему режиму/роли (`computeToolAvailability`). */
107
+ available: boolean;
108
+ /**
109
+ * Причина недоступности: `mode` (переключить режим), `role` (делегировать),
110
+ * `admin_disabled` (жёстко отключён администратором через `tools.disabled`),
111
+ * `dependency` (в окружении нет нужной программы — git/rg/sh),
112
+ * `workspace` (не задан рабочий каталог проекта),
113
+ * `storage` (хранилище недоступно — деградированный read-only режим, PROP-032).
114
+ */
115
+ reason?: 'mode' | 'role' | 'admin_disabled' | 'dependency' | 'workspace' | 'storage';
116
+ /** ADR-071 §2.1: источник инструмента (`built-in` — слой `tools`). */
117
+ source: 'built-in';
118
+ /** ADR-071 §2.6: длина `JSON.stringify` LLM-определения тула (как слой `tools`). */
119
+ chars?: number;
120
+ /** ADR-071 §2.6: оценка токенов (`ceil(chars / ratio)`) — значение оценочное. */
121
+ estTokens?: number;
122
+ /** ADR-071 §2.6: chars-per-token, применённый к оценке (4 — без калибровки). */
123
+ ratio?: number;
124
+ /** ADR-071 §2.6: тул жёстко отключён администратором (`tools.disabled`). */
125
+ adminDisabled?: boolean;
126
+ }
127
+ /** ADR-071 §2.6: строка тула MCP-сервера с оценкой токенов. */
128
+ export interface McpToolDetail {
129
+ name: string;
130
+ /** Длина `JSON.stringify` LLM-определения тула (имя с префиксом сервера). */
131
+ chars: number;
132
+ estTokens: number;
133
+ ratio: number;
134
+ /** ADR-071 §2.6: тул отключён администратором (`tools.disabled`). */
135
+ adminDisabled?: boolean;
136
+ }
137
+ /** ADR-070 §2.5: state-сообщения истории, сгруппированные по типу. */
138
+ export interface PromptHistoryStateMessage {
139
+ type: string;
140
+ count: number;
141
+ chars: number;
142
+ estTokens: number;
143
+ }
144
+ /** ADR-070 §2.5: состав слоя истории (`messages`), зеркалит реальную отправку. */
145
+ export interface PromptHistoryInfo {
146
+ /** Реально отправляемые сообщения (после фильтрации), суммарно. */
147
+ messages: {
148
+ count: number;
149
+ chars: number;
150
+ estTokens: number;
151
+ };
152
+ /** Chronological state-сообщения (mode_change/agent_switch/plan_updated/todos_updated/…), сгруппированы по type. */
153
+ stateMessages: PromptHistoryStateMessage[];
154
+ /** Что НЕ уходит в LLM. */
155
+ excluded: {
156
+ disabled: number;
157
+ hidden: number;
158
+ info: number;
159
+ };
160
+ /** Мультимодальные части (не text). */
161
+ attachments: {
162
+ count: number;
163
+ chars: number;
164
+ };
165
+ /** Число плейсхолдеров секретов ⟦SYNTH_SECRET_N⟧ в отправляемых сообщениях (ADR-036). */
166
+ secretPlaceholders: number;
167
+ }
168
+ /**
169
+ * Статистика по агенту в рамках сессии (`GET /sessions/:id/stats`).
170
+ * Итоги (`input_tokens`/`output_tokens`/`cache_*`/`reasoning_tokens`/`cost_usd`)
171
+ * включают usage/cost сабагентов (own + все потомки); `subagent_*` — детализация
172
+ * только по дочерним сессиям (tool `task`), инициированным агентом.
173
+ */
174
+ export interface SessionAgentStats {
175
+ agent_role: string;
176
+ messages: number;
177
+ input_tokens: number;
178
+ output_tokens: number;
179
+ cache_read_tokens: number;
180
+ cache_write_tokens: number;
181
+ reasoning_tokens: number;
182
+ /**
183
+ * Номинальная сумма всех валют (обратная совместимость). Мультивалютная
184
+ * разбивка — в `cost_by_currency`; здесь значение равно её сумме.
185
+ */
186
+ cost_usd: number;
187
+ /** Разбивка стоимости по валютам (код валюты → сумма, напр. `{ USD: 0.5, RUB: 42 }`). */
188
+ cost_by_currency?: Record<string, number>;
189
+ /** cache_read / input (0 при input = 0). */
190
+ cache_hit_rate: number;
191
+ duration_ms: number;
192
+ /** output_tokens / (duration_ms / 1000); 0 при отсутствии длительности. */
193
+ output_tps: number;
194
+ subagent_sessions: number;
195
+ subagent_tokens: number;
196
+ }
197
+ /** Статистика по автору user-сообщений (атрибуция usage последующего ответа). */
198
+ export interface SessionUserStats {
199
+ author: string;
200
+ /** Display name профиля автора; при отсутствии профиля/имени — не задаётся. */
201
+ display_name?: string;
202
+ messages: number;
203
+ input_tokens: number;
204
+ output_tokens: number;
205
+ cache_read_tokens: number;
206
+ cache_write_tokens: number;
207
+ reasoning_tokens: number;
208
+ cost_usd: number;
209
+ /** Разбивка стоимости по валютам (код валюты → сумма). */
210
+ cost_by_currency?: Record<string, number>;
211
+ cache_hit_rate: number;
212
+ }
213
+ /**
214
+ * Сводка по сабагентам сессии (рекурсивно, tool `task`). Отдельный блок:
215
+ * `SessionAgentStats` уже включает usage детей в свои итоги, а здесь — только
216
+ * суммарная детализация по всем дочерним сессиям (в контекстное окно родителя
217
+ * их usage не входит, ADR-070 §2.6).
218
+ */
219
+ export interface SessionSubagentStats {
220
+ sessions: number;
221
+ input_tokens: number;
222
+ output_tokens: number;
223
+ cache_read_tokens: number;
224
+ cache_write_tokens: number;
225
+ reasoning_tokens: number;
226
+ cost_usd: number;
227
+ /** Разбивка стоимости по валютам (код валюты → сумма). */
228
+ cost_by_currency?: Record<string, number>;
229
+ }
230
+ /** Ответ `GET /api/v2/sessions/:id/stats`. */
231
+ export interface SessionStats {
232
+ session_id: string;
233
+ agents: SessionAgentStats[];
234
+ users: SessionUserStats[];
235
+ /** Суммарная статистика дочерних сессий сабагентов (отдельно от ответа). */
236
+ subagents: SessionSubagentStats;
237
+ }
@@ -0,0 +1,15 @@
1
+ // --- Оценка токенов по символам (ADR-071 §2.6) ---
2
+ /** Дефолтный chars-per-token, если калибровки для модели нет. */
3
+ export const DEFAULT_CHARS_PER_TOKEN = 4;
4
+ /**
5
+ * Нижняя граница разумного chars-per-token (аномальные семплы отбрасываются).
6
+ * CJK/эффективные BPE дают ~1–2 символа на токен, поэтому допускаем 1.5.
7
+ */
8
+ export const MIN_CHARS_PER_TOKEN = 1.5;
9
+ /**
10
+ * Верхняя граница разумного chars-per-token. Берётся с запасом: «эффективные»
11
+ * токенизаторы (например, `omn.qwen3.8:27b`) дают ratio ≈ 11.7.
12
+ */
13
+ export const MAX_CHARS_PER_TOKEN = 16;
14
+ /** Минимальный `usage.inputTokens` для калибровки — меньшие значения шумные. */
15
+ export const MIN_CALIBRATION_INPUT_TOKENS = 500;
@@ -0,0 +1,84 @@
1
+ /** Валюта цен моделей. Отсутствует у модели → валюта провайдера → USD. */
2
+ export declare const CURRENCIES: readonly ["RUB", "USD", "CNY"];
3
+ export type Currency = (typeof CURRENCIES)[number];
4
+ /** Проверка, что значение — допустимая валюта (RUB/USD/CNY). */
5
+ export declare function isCurrency(value: unknown): value is Currency;
6
+ /** Ленивый разбор валюты: неизвестное значение → undefined. */
7
+ export declare function parseCurrency(value: unknown): Currency | undefined;
8
+ /** Результат строгого разбора поля `currency` из тела запроса. */
9
+ export type CurrencyInputResult = {
10
+ ok: true;
11
+ currency: Currency | undefined;
12
+ } | {
13
+ ok: false;
14
+ };
15
+ /**
16
+ * Строгий разбор поля `currency`:
17
+ * - `undefined` — поле не передано (сохранить existing);
18
+ * - `null`/`''` — явно очистить (undefined);
19
+ * - валидная валюта — принять;
20
+ * - иная непустая строка — ошибка (`ok: false`), чтобы не терять значение молча.
21
+ */
22
+ export declare function parseCurrencyInput(raw: unknown, existing?: Currency): CurrencyInputResult;
23
+ /** Присутствуют ли в теле запроса ценовые поля (snake_case или camelCase). */
24
+ export declare function hasPriceInput(body: unknown): boolean;
25
+ export interface ProviderConfig {
26
+ name: string;
27
+ type: string;
28
+ baseUrl?: string;
29
+ apiKey?: string;
30
+ defaultModel?: string;
31
+ timeout?: number;
32
+ enabled?: boolean;
33
+ icon?: string;
34
+ /** Валюта по умолчанию для моделей провайдера. Отсутствует → USD. */
35
+ currency?: Currency;
36
+ /**
37
+ * Размер контекстного окна провайдера (`num_ctx` Ollama). Опционально;
38
+ * приоритетнее `ModelConfig.contextWindow`. Применяется только нативным
39
+ * путём Ollama (`/api/chat`).
40
+ */
41
+ numCtx?: number;
42
+ }
43
+ export type ContextSource = 'api' | 'reference' | 'manual' | 'unknown';
44
+ /**
45
+ * Источник цен модели: `api` — получены синхронизацией с провайдером,
46
+ * `manual` — заданы пользователем вручную, `unknown` — не определены.
47
+ */
48
+ export type PriceSource = 'api' | 'manual' | 'unknown';
49
+ export type ContextCategory = 'user' | 'role' | 'system';
50
+ export interface ContextFileInfo {
51
+ filename: string;
52
+ isSystem: boolean;
53
+ isOverridden: boolean;
54
+ category: ContextCategory;
55
+ size: number;
56
+ modifiedAt?: number;
57
+ enabled?: boolean;
58
+ }
59
+ export interface ContextFileContent {
60
+ filename: string;
61
+ content: string;
62
+ isSystem: boolean;
63
+ isOverridden: boolean;
64
+ category: ContextCategory;
65
+ }
66
+ export interface ModelConfig {
67
+ id: string;
68
+ name: string;
69
+ provider: string;
70
+ description?: string;
71
+ enabled: boolean;
72
+ isDefault?: boolean;
73
+ contextWindow?: number;
74
+ contextSource?: ContextSource;
75
+ maxOutputTokens?: number;
76
+ inputPrice?: number;
77
+ outputPrice?: number;
78
+ cacheReadPrice?: number;
79
+ cacheWritePrice?: number;
80
+ /** Откуда взяты цены: `api` — синхронизация, `manual` — ручной ввод. */
81
+ priceSource?: PriceSource;
82
+ /** Валюта цен модели; отсутствует → валюта провайдера → USD. */
83
+ currency?: Currency;
84
+ }
@@ -0,0 +1,35 @@
1
+ // --- Currency ---
2
+ /** Валюта цен моделей. Отсутствует у модели → валюта провайдера → USD. */
3
+ export const CURRENCIES = ['RUB', 'USD', 'CNY'];
4
+ /** Проверка, что значение — допустимая валюта (RUB/USD/CNY). */
5
+ export function isCurrency(value) {
6
+ return typeof value === 'string' && CURRENCIES.includes(value);
7
+ }
8
+ /** Ленивый разбор валюты: неизвестное значение → undefined. */
9
+ export function parseCurrency(value) {
10
+ return isCurrency(value) ? value : undefined;
11
+ }
12
+ /**
13
+ * Строгий разбор поля `currency`:
14
+ * - `undefined` — поле не передано (сохранить existing);
15
+ * - `null`/`''` — явно очистить (undefined);
16
+ * - валидная валюта — принять;
17
+ * - иная непустая строка — ошибка (`ok: false`), чтобы не терять значение молча.
18
+ */
19
+ export function parseCurrencyInput(raw, existing) {
20
+ if (raw === null || raw === '')
21
+ return { ok: true, currency: undefined };
22
+ if (raw === undefined)
23
+ return { ok: true, currency: existing };
24
+ return isCurrency(raw) ? { ok: true, currency: raw } : { ok: false };
25
+ }
26
+ /** Присутствуют ли в теле запроса ценовые поля (snake_case или camelCase). */
27
+ export function hasPriceInput(body) {
28
+ if (!body || typeof body !== 'object')
29
+ return false;
30
+ const b = body;
31
+ return 'input_price' in b || 'inputPrice' in b
32
+ || 'output_price' in b || 'outputPrice' in b
33
+ || 'cache_read_price' in b || 'cacheReadPrice' in b
34
+ || 'cache_write_price' in b || 'cacheWritePrice' in b;
35
+ }
@@ -1,5 +1,5 @@
1
1
  /**
2
- * AD-051 (минимальный срез) / AD-089: контракты планировщика расписаний.
2
+ * ADR-051 (минимальный срез) / ADR-089: контракты планировщика расписаний.
3
3
  *
4
4
  * Шедулер не создаёт сессии сам: срабатывание публикует нормализованное событие
5
5
  * (`source: 'cron'`, `type: 'schedule_fired'`) через `EventIngress`, а
@@ -7,7 +7,7 @@
7
7
  * Здесь только типы без бизнес-логики; cron/interval-парсеры живут в core.
8
8
  */
9
9
  /**
10
- * AD-051/AD-089: цель срабатывания расписания.
10
+ * ADR-051/ADR-089: цель срабатывания расписания.
11
11
  * - `bound` — постоянная сессия (событие уходит в неё);
12
12
  * - `ephemeral` — разовая сессия с TTL и авто-архивом;
13
13
  * - `queue` — не запускать сразу, отложить владельцу.
@@ -24,17 +24,17 @@ export type ScheduleTarget = {
24
24
  mode: 'queue';
25
25
  sessionId: string;
26
26
  };
27
- /** AD-051/AD-089: статус последнего запуска расписания. */
27
+ /** ADR-051/ADR-089: статус последнего запуска расписания. */
28
28
  export type ScheduleRunStatus = 'ok' | 'error' | 'skipped';
29
29
  /**
30
- * AD-051: триггер срабатывания расписания.
30
+ * ADR-051: триггер срабатывания расписания.
31
31
  * - `cron` — обычный тик планировщика (или интервальное срабатывание);
32
32
  * - `manual` — принудительный запуск (`POST /:id/run`, force);
33
33
  * - `catchup` — догоняющее срабатывание после простоя.
34
34
  */
35
35
  export type ScheduleJobTrigger = 'cron' | 'manual' | 'catchup';
36
36
  /**
37
- * AD-051: запись Job-истории — результат одного срабатывания расписания.
37
+ * ADR-051: запись Job-истории — результат одного срабатывания расписания.
38
38
  *
39
39
  * Append-only JSONL `{dataDir}/scheduler/jobs.jsonl`. `decision` — итог
40
40
  * маршрутизации события (`RouteDecision['kind']`), `reason` — причина
@@ -65,7 +65,7 @@ export interface ScheduleJob {
65
65
  error?: string;
66
66
  }
67
67
  /**
68
- * AD-051/AD-089: расписание запуска промпта/события.
68
+ * ADR-051/ADR-089: расписание запуска промпта/события.
69
69
  *
70
70
  * Ровно одно из `cron` (5 полей) / `every` (интервал) задано; время cron
71
71
  * считается в UTC. `payload` домешивается в тело события, `prompt` — текст
@@ -88,7 +88,7 @@ export interface Schedule {
88
88
  /** Владелец расписания (попадает в `identity.principalId`). */
89
89
  ownerId?: string;
90
90
  /**
91
- * AD-051: поведение при пропущенном срабатывании на старте процесса
91
+ * ADR-051: поведение при пропущенном срабатывании на старте процесса
92
92
  * (`skip` — пропустить, `once` — одно догоняющее). Не задано — дефолт из
93
93
  * конфига `scheduler.catchUp`.
94
94
  */
@@ -103,7 +103,7 @@ export interface Schedule {
103
103
  lastError?: string;
104
104
  }
105
105
  /**
106
- * AD-051/AD-089: вход создания/обновления расписания — без служебных полей,
106
+ * ADR-051/ADR-089: вход создания/обновления расписания — без служебных полей,
107
107
  * которыми управляет хранилище/сервис (`id`, таймстемпы, статус последнего запуска).
108
108
  */
109
109
  export type ScheduleInput = Omit<Schedule, 'id' | 'createdAt' | 'updatedAt' | 'lastRunAt' | 'nextRunAt' | 'lastStatus' | 'lastError'>;
@@ -1,5 +1,5 @@
1
1
  /**
2
- * AD-051 (минимальный срез) / AD-089: контракты планировщика расписаний.
2
+ * ADR-051 (минимальный срез) / ADR-089: контракты планировщика расписаний.
3
3
  *
4
4
  * Шедулер не создаёт сессии сам: срабатывание публикует нормализованное событие
5
5
  * (`source: 'cron'`, `type: 'schedule_fired'`) через `EventIngress`, а
@@ -1,5 +1,5 @@
1
1
  /**
2
- * AD-052 (этап I): service-key — независимый от binding-key (AD-089) ключ
2
+ * ADR-052 (этап I): service-key — независимый от binding-key (ADR-089) ключ
3
3
  * инстанса для внешних сервисов со **скоупами** (`scopes`) и **проектной
4
4
  * проекцией** (`allowedProjects`). Здесь только контракты и browser-safe
5
5
  * матчер скоупов; хранилище и enforcement живут в core.
@@ -7,16 +7,16 @@
7
7
  import type { GlobalRole } from './index.js';
8
8
  /**
9
9
  * Семейства скоупов с wildcard-поддержкой. Глобальный `*` намеренно не вводится
10
- * (AD-052 §«Scopes»): `events:*` покрывает все `events:*`, но не `bindings:*`.
10
+ * (ADR-052; каталог — `docs/API_V2.md` §1): `events:*` покрывает все `events:*`, но не `bindings:*`.
11
11
  */
12
12
  export declare const SERVICE_SCOPE_FAMILIES: readonly ["events", "bindings", "keys", "routes", "sessions", "schedules"];
13
13
  export type ServiceScopeFamily = (typeof SERVICE_SCOPE_FAMILIES)[number];
14
14
  /**
15
- * Каталог скоупов service-key (AD-052 §«Scopes», уточняется на этапе I).
15
+ * Каталог скоупов service-key (ADR-052; `docs/API_V2.md` §1).
16
16
  * Точечные скоупы вне wildcard-семейств:
17
17
  * - `llm:chat` — LLM-прокси (роут без проектного измерения);
18
18
  * - `addons:install` — зонтичный скоуп installer-ключа: установка/обновление
19
- * MCP-реестра и скиллов (AD-090 installer);
19
+ * MCP-реестра и скиллов (PROP-090 installer);
20
20
  * - `users:read` — чтение пользователей/идентичностей машинной кредой
21
21
  * (консент-сервисы аддонов).
22
22
  */
@@ -37,7 +37,7 @@ export declare function isKnownScope(scope: string): boolean;
37
37
  */
38
38
  export declare function hasServiceScope(granted: readonly string[], required: string): boolean;
39
39
  /**
40
- * AD-052: service-key инстанса.
40
+ * ADR-052: service-key инстанса.
41
41
  *
42
42
  * Секрет (`synth_svc_<base64url>`) не хранится в этой сущности: at-rest лежит
43
43
  * только sha256-хеш (внутренняя запись хранилища), наружу отдаётся `prefix`.
@@ -54,11 +54,11 @@ export interface ServiceApiKey {
54
54
  * managed-режима / доступность эндпоинтов).
55
55
  */
56
56
  roles: GlobalRole[];
57
- /** Выданные скоупы (каталог + wildcard-семейства, AD-052 §«Scopes»). */
57
+ /** Выданные скоупы (каталог + wildcard-семейства; ADR-052, `docs/API_V2.md` §1). */
58
58
  scopes: string[];
59
59
  /**
60
60
  * Проектная проекция: ключ ограничен подмножеством проектов инстанса
61
- * (AD-014). Пусто/отсутствует — ключ действует по политике инстанса.
61
+ * (ADR-014). Пусто/отсутствует — ключ действует по политике инстанса.
62
62
  */
63
63
  allowedProjects?: string[];
64
64
  /** Лимит запросов/мин (0 — без лимита); не задан — без лимита. */
@@ -76,12 +76,12 @@ export interface ServiceApiKey {
76
76
  /** Префикс секрета для идентификации в UI (plaintext наружу не отдаётся). */
77
77
  prefix: string;
78
78
  }
79
- /** AD-052: ответ создания service-key — метаданные + однократно показываемый секрет. */
79
+ /** ADR-052: ответ создания service-key — метаданные + однократно показываемый секрет. */
80
80
  export interface ServiceApiKeyCreated extends ServiceApiKey {
81
81
  /** Plaintext-секрет `synth_svc_<base64url>`; возвращается единственный раз. */
82
82
  key: string;
83
83
  }
84
- /** AD-052: тело создания service-key (`POST /api/v2/service-keys`). */
84
+ /** ADR-052: тело создания service-key (`POST /api/v2/service-keys`). */
85
85
  export interface CreateServiceApiKeyInput {
86
86
  label: string;
87
87
  description?: string;
@@ -92,7 +92,7 @@ export interface CreateServiceApiKeyInput {
92
92
  expiresAt?: string;
93
93
  }
94
94
  /**
95
- * AD-052: тело обновления service-key (`PATCH /api/v2/service-keys/:id`).
95
+ * ADR-052: тело обновления service-key (`PATCH /api/v2/service-keys/:id`).
96
96
  * `undefined` — не трогать; `null` — сбросить опциональное значение.
97
97
  */
98
98
  export interface UpdateServiceApiKeyPatch {
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Семейства скоупов с wildcard-поддержкой. Глобальный `*` намеренно не вводится
3
- * (AD-052 §«Scopes»): `events:*` покрывает все `events:*`, но не `bindings:*`.
3
+ * (ADR-052; каталог — `docs/API_V2.md` §1): `events:*` покрывает все `events:*`, но не `bindings:*`.
4
4
  */
5
5
  export const SERVICE_SCOPE_FAMILIES = [
6
6
  'events',
@@ -11,11 +11,11 @@ export const SERVICE_SCOPE_FAMILIES = [
11
11
  'schedules',
12
12
  ];
13
13
  /**
14
- * Каталог скоупов service-key (AD-052 §«Scopes», уточняется на этапе I).
14
+ * Каталог скоупов service-key (ADR-052; `docs/API_V2.md` §1).
15
15
  * Точечные скоупы вне wildcard-семейств:
16
16
  * - `llm:chat` — LLM-прокси (роут без проектного измерения);
17
17
  * - `addons:install` — зонтичный скоуп installer-ключа: установка/обновление
18
- * MCP-реестра и скиллов (AD-090 installer);
18
+ * MCP-реестра и скиллов (PROP-090 installer);
19
19
  * - `users:read` — чтение пользователей/идентичностей машинной кредой
20
20
  * (консент-сервисы аддонов).
21
21
  */