@itphx/synth-shared 0.12.4 → 0.13.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/config/defaults.js +125 -5
- package/dist/config/env-overrides.d.ts +23 -4
- package/dist/config/env-overrides.js +103 -4
- package/dist/config/index.d.ts +1 -0
- package/dist/config/index.js +1 -0
- package/dist/config/loader.d.ts +8 -0
- package/dist/config/loader.js +6 -1
- package/dist/config/redact.d.ts +22 -0
- package/dist/config/redact.js +53 -0
- package/dist/config/resolve.d.ts +17 -0
- package/dist/config/resolve.js +40 -1
- package/dist/config/tls.d.ts +7 -4
- package/dist/config/tls.js +10 -23
- package/dist/config/types.d.ts +496 -11
- package/dist/config/types.js +348 -6
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +317 -3
- package/dist/index.d.ts +4 -4
- package/dist/index.js +4 -4
- package/dist/model-metadata.d.ts +10 -0
- package/dist/model-metadata.js +10 -0
- package/dist/schemas/index.d.ts +378 -21
- package/dist/schemas/index.js +282 -5
- package/dist/types/agent.d.ts +8 -1
- package/dist/types/bus-events.d.ts +60 -2
- package/dist/types/egress.d.ts +2 -2
- package/dist/types/egress.js +2 -2
- package/dist/types/file-kind.d.ts +40 -0
- package/dist/types/file-kind.js +157 -0
- package/dist/types/fs.d.ts +54 -1
- package/dist/types/fs.js +43 -0
- package/dist/types/git.d.ts +88 -0
- package/dist/types/git.js +101 -1
- package/dist/types/host-pattern.d.ts +41 -0
- package/dist/types/host-pattern.js +143 -0
- package/dist/types/index.d.ts +4 -0
- package/dist/types/index.js +13 -1
- package/dist/types/llm.d.ts +95 -0
- package/dist/types/llm.js +58 -0
- package/dist/types/maintenance.d.ts +1 -1
- package/dist/types/mcp.d.ts +90 -0
- package/dist/types/mcp.js +11 -0
- package/dist/types/message-stream.d.ts +389 -0
- package/dist/types/message-stream.js +41 -0
- package/dist/types/message.d.ts +49 -0
- package/dist/types/pack.d.ts +6 -6
- package/dist/types/permission.d.ts +39 -3
- package/dist/types/pipeline-engine.d.ts +2 -2
- package/dist/types/project.d.ts +30 -0
- package/dist/types/project.js +16 -0
- package/dist/types/prompt.d.ts +4 -2
- package/dist/types/provider.d.ts +280 -0
- package/dist/types/provider.js +289 -0
- package/dist/types/service-keys.d.ts +6 -3
- package/dist/types/service-keys.js +6 -1
- package/dist/types/session.d.ts +178 -3
- package/dist/types/skills.d.ts +6 -0
- package/dist/types/tools.d.ts +57 -0
- package/dist/types/tools.js +49 -1
- package/dist/types/user.d.ts +7 -0
- package/dist/types/worktree.d.ts +1 -1
- package/dist/utils/index.js +1 -1
- package/dist/utils/reasoning.d.ts +18 -2
- package/dist/utils/reasoning.js +16 -7
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +4 -3
package/dist/config/defaults.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, } from '../types/index.js';
|
|
2
|
-
import { DEFAULT_MAX_UPLOAD_BYTES } from '../types/index.js';
|
|
1
|
+
import { DEFAULT_MCP_PRIVATE_CIDRS, DEFAULT_EGRESS_TOOLS_POLICY, DEFAULT_EGRESS_WEBHOOKS_POLICY, DEFAULT_EGRESS_LOG, GlobalRole, } from '../types/index.js';
|
|
2
|
+
import { DEFAULT_MAX_UPLOAD_BYTES, DEFAULT_MAX_READ_BYTES, DEFAULT_MAX_PREVIEW_BYTES } from '../types/index.js';
|
|
3
3
|
import { DEFAULT_PROMPT_BLOCK_MAX_CHARS, DEFAULT_LLM_FILTER_TIMEOUT_MS } from '../types/index.js';
|
|
4
4
|
import { DEFAULT_EXECUTION_TIMEOUT_MS } from './types.js';
|
|
5
5
|
import { defaultExecutionConcurrency } from './execution.js';
|
|
@@ -22,6 +22,8 @@ export const defaultConfig = {
|
|
|
22
22
|
defaultWorkspace: '',
|
|
23
23
|
workspaceOutsideRoot: '',
|
|
24
24
|
maxUploadBytes: DEFAULT_MAX_UPLOAD_BYTES,
|
|
25
|
+
maxReadBytes: DEFAULT_MAX_READ_BYTES,
|
|
26
|
+
maxPreviewBytes: DEFAULT_MAX_PREVIEW_BYTES,
|
|
25
27
|
},
|
|
26
28
|
execution: {
|
|
27
29
|
// ADR-077: топология исполнения — параметр запуска (инвариант 24: смена
|
|
@@ -44,6 +46,9 @@ export const defaultConfig = {
|
|
|
44
46
|
},
|
|
45
47
|
auth: {
|
|
46
48
|
debugMode: false,
|
|
49
|
+
// Единый API-ключ выдаёт только базовую роль; ADMIN — явной настройкой
|
|
50
|
+
// (`auth.apiKeyRoles` / `SYNTH_API_KEY_ROLES`).
|
|
51
|
+
apiKeyRoles: [GlobalRole.USER],
|
|
47
52
|
sessionMaxAgeMinutes: 1440,
|
|
48
53
|
},
|
|
49
54
|
llm: {
|
|
@@ -51,6 +56,7 @@ export const defaultConfig = {
|
|
|
51
56
|
defaultModel: '',
|
|
52
57
|
maxRetries: 3,
|
|
53
58
|
timeout: 60,
|
|
59
|
+
maxTokens: 8192,
|
|
54
60
|
cache: 'auto',
|
|
55
61
|
},
|
|
56
62
|
core: {
|
|
@@ -98,9 +104,42 @@ export const defaultConfig = {
|
|
|
98
104
|
},
|
|
99
105
|
session: {
|
|
100
106
|
planMode: 'auto',
|
|
107
|
+
// Авто-заголовок сессии: включён, приветствие откладывает именование,
|
|
108
|
+
// ждём до 2 реплик, «сигналом задачи» считаем сообщение от 30 символов.
|
|
109
|
+
autoTitle: {
|
|
110
|
+
enabled: true,
|
|
111
|
+
deferOnChatter: true,
|
|
112
|
+
maxAttempts: 2,
|
|
113
|
+
minSignalChars: 30,
|
|
114
|
+
},
|
|
101
115
|
},
|
|
102
116
|
context: {
|
|
103
117
|
enabledFiles: ['SOUL.md', 'COMPANY.md', 'ABOUT.md'],
|
|
118
|
+
// Политика контекстного окна: по умолчанию только предупреждать (блокировка — opt-in).
|
|
119
|
+
windowPolicy: 'warn',
|
|
120
|
+
// Дефолты оптимизации контекста для новых сессий (совпадают с прежними
|
|
121
|
+
// литералами `SessionManager.createSession`).
|
|
122
|
+
defaults: {
|
|
123
|
+
contextOptimization: 'compaction',
|
|
124
|
+
summarizationEnabled: true,
|
|
125
|
+
summarizationTriggerMode: 'messages',
|
|
126
|
+
summarizeAfterN: 10,
|
|
127
|
+
summarizeTokenThreshold: 50,
|
|
128
|
+
summarizationHeadMessages: 2,
|
|
129
|
+
summarizationTailMessages: 3,
|
|
130
|
+
summarizationKeepTokens: 5000,
|
|
131
|
+
compactionKeepTokens: 15000,
|
|
132
|
+
compactionTokenThreshold: 85,
|
|
133
|
+
slidingWindowMode: 'messages',
|
|
134
|
+
slidingWindowMessageLimit: 10,
|
|
135
|
+
slidingWindowTokenThreshold: 80,
|
|
136
|
+
},
|
|
137
|
+
// Instance-wide лимиты заметок сессии (`context.stickyNotes`): ограничения
|
|
138
|
+
// инстанса, не дефолты сессии. Существующие заметки не обрезаются.
|
|
139
|
+
stickyNotes: {
|
|
140
|
+
maxCount: 50,
|
|
141
|
+
maxChars: 2000,
|
|
142
|
+
},
|
|
104
143
|
},
|
|
105
144
|
summarization: {
|
|
106
145
|
provider: '',
|
|
@@ -123,6 +162,10 @@ export const defaultConfig = {
|
|
|
123
162
|
capabilities: [],
|
|
124
163
|
tools: [],
|
|
125
164
|
},
|
|
165
|
+
// Общий предел вывода инструментов (строк/байт) — усечение результата
|
|
166
|
+
// с пометкой «показано N из M».
|
|
167
|
+
outputMaxLines: 2000,
|
|
168
|
+
outputMaxBytes: 51_200,
|
|
126
169
|
},
|
|
127
170
|
skills: {
|
|
128
171
|
paths: [],
|
|
@@ -189,6 +232,23 @@ export const defaultConfig = {
|
|
|
189
232
|
// ADR-102: срок хранения суточных роллапов — 400 дней (<= 0 — без ограничения).
|
|
190
233
|
retentionDays: 400,
|
|
191
234
|
},
|
|
235
|
+
git: {
|
|
236
|
+
// ADR-076: таймауты сетевых git-операций. 5 минут: сеть git может идти
|
|
237
|
+
// минутами (большой репозиторий/медленный remote), но «зависший» вызов не
|
|
238
|
+
// должен держать ход агента бесконечно; 0 — без таймаута.
|
|
239
|
+
cloneTimeoutMs: 300_000,
|
|
240
|
+
fetchTimeoutMs: 300_000,
|
|
241
|
+
// Таймауты git-тулов агента по классам операции: локальные изменяющие
|
|
242
|
+
// (commit/checkout/stash) — 2 минуты, сетевые (push/pull) — 5 минут.
|
|
243
|
+
// Read-only операции имеют фиксированный предел 30 с. 0 — без таймаута.
|
|
244
|
+
localTimeoutMs: 120_000,
|
|
245
|
+
networkTimeoutMs: 300_000,
|
|
246
|
+
},
|
|
247
|
+
ssh: {
|
|
248
|
+
// PROP-124: режим работы инстанса с SSH-ключами. `tools` — fail-closed:
|
|
249
|
+
// без явного выбора ключ не попадает в окружение команд.
|
|
250
|
+
mode: 'tools',
|
|
251
|
+
},
|
|
192
252
|
questions: {
|
|
193
253
|
// Этап 1 roadmap 0.13 (блок 3): срок ожидания ответа пользователя на вопрос —
|
|
194
254
|
// по умолчанию **без таймаута** (0): вопрос ждёт, пока ответят или отменят
|
|
@@ -207,13 +267,28 @@ export const defaultConfig = {
|
|
|
207
267
|
maxSubagentsPerSession: 2,
|
|
208
268
|
// Максимум одновременно идущих фоновых шелл-процессов на сессию-владельца.
|
|
209
269
|
maxProcessesPerSession: 5,
|
|
210
|
-
// Максимум
|
|
270
|
+
// Максимум одновременно идущих прогонов любого вида на сессию-владельца
|
|
271
|
+
// (история реестра лимитом не считается — её чистит retention).
|
|
211
272
|
maxRunsPerSession: 10,
|
|
212
273
|
// Предел размера лога фонового процесса, байт (10 МиБ; 0 — без ограничения).
|
|
213
274
|
logMaxBytes: 10_485_760,
|
|
214
275
|
// Срок хранения терминальных записей реестра (дни; <= 0 — без ограничения).
|
|
215
276
|
retentionDays: 7,
|
|
216
277
|
},
|
|
278
|
+
agents: {
|
|
279
|
+
// Предохранитель по объёму промпта саб-агента (не окно модели): при
|
|
280
|
+
// превышении оценка бюджета завершает прогон детерминированным отчётом.
|
|
281
|
+
// 0 — без ограничения.
|
|
282
|
+
subagentMaxInputTokens: 0,
|
|
283
|
+
// Лимит глубины вложенности саб-агентов (по цепочке `parentId` сессий:
|
|
284
|
+
// текущая — 0, родитель — 1, …). 0 — без ограничения.
|
|
285
|
+
subagentDepth: 1,
|
|
286
|
+
},
|
|
287
|
+
limits: {
|
|
288
|
+
// Лимит тяжёлых операций с сессиями (import/export/fork/merge) в минуту
|
|
289
|
+
// на креду. 0 — без ограничения.
|
|
290
|
+
sessionOpsPerMinute: 10,
|
|
291
|
+
},
|
|
217
292
|
attachments: {
|
|
218
293
|
// ADR-115: вложения сообщений. Мастер-выключатель, семейства MIME,
|
|
219
294
|
// лимиты (байты на файл, число файлов в сообщении, суммарный объём на
|
|
@@ -221,7 +296,7 @@ export const defaultConfig = {
|
|
|
221
296
|
// хранения осиротевших объектов.
|
|
222
297
|
enabled: true,
|
|
223
298
|
modalities: { image: true, pdf: true, audio: true, video: true },
|
|
224
|
-
maxBytesPerFile:
|
|
299
|
+
maxBytesPerFile: 100 * 1024 * 1024,
|
|
225
300
|
maxFilesPerMessage: 10,
|
|
226
301
|
maxBytesPerSession: 1024 * 1024 * 1024,
|
|
227
302
|
allowedMimePrefixes: ['image/', 'audio/', 'video/', 'application/pdf', 'text/'],
|
|
@@ -231,11 +306,54 @@ export const defaultConfig = {
|
|
|
231
306
|
// с путём в workspace (текущее поведение).
|
|
232
307
|
modalityModels: {},
|
|
233
308
|
gcDays: 30,
|
|
309
|
+
// ADR-115: сжатие — только на границе отправки провайдеру (в blob лежит
|
|
310
|
+
// оригинал). Пределы сторон/битрейты — разумные дефолты для чата; пороги
|
|
311
|
+
// `minBytes` не дают перекодировать мелкие файлы.
|
|
312
|
+
compression: {
|
|
313
|
+
enabled: true,
|
|
314
|
+
image: { enabled: true, maxSidePx: 2048, quality: 85, minBytes: 1024 * 1024 },
|
|
315
|
+
video: {
|
|
316
|
+
enabled: true,
|
|
317
|
+
maxHeightPx: 720,
|
|
318
|
+
bitrateKbps: 2000,
|
|
319
|
+
audioBitrateKbps: 96,
|
|
320
|
+
minBytes: 8 * 1024 * 1024,
|
|
321
|
+
},
|
|
322
|
+
audio: {
|
|
323
|
+
enabled: true,
|
|
324
|
+
bitrateKbps: 64,
|
|
325
|
+
channels: 1,
|
|
326
|
+
sampleRateHz: 16000,
|
|
327
|
+
minBytes: 4 * 1024 * 1024,
|
|
328
|
+
},
|
|
329
|
+
},
|
|
330
|
+
// ADR-115: серверные миниатюры для UI (производный JPEG в blob).
|
|
331
|
+
thumbnail: { enabled: true, maxWidthPx: 512 },
|
|
332
|
+
// Предел одной части chunked-загрузки, байт (8 МиБ).
|
|
333
|
+
maxChunkBytes: 8 * 1024 * 1024,
|
|
334
|
+
// Пределы числа незавершённых chunked-загрузок: одной сессии и инстанса
|
|
335
|
+
// (включая staging-контур без привязки к сессии).
|
|
336
|
+
maxActiveUploadsPerSession: 16,
|
|
337
|
+
maxActiveUploads: 256,
|
|
234
338
|
},
|
|
235
339
|
metrics: {
|
|
236
340
|
// ADR-094: экспорт Prometheus-метрик выключен по умолчанию (`GET /metrics` → 404).
|
|
237
341
|
enabled: false,
|
|
238
342
|
},
|
|
343
|
+
updates: {
|
|
344
|
+
// ADR-133: автопроверка обновлений **выключена по умолчанию** — инстанс не
|
|
345
|
+
// ходит в реестры без явного согласия владельца (офлайн/закрытый контур не
|
|
346
|
+
// шумит запросами). Явная проверка (`synth update --check`, `?force=1`) от
|
|
347
|
+
// этого флага не зависит.
|
|
348
|
+
check: false,
|
|
349
|
+
// Канал выводится из установленной версии (`-beta.` ⇒ beta), иначе stable.
|
|
350
|
+
channel: 'auto',
|
|
351
|
+
// TTL успешной проверки; ошибка кэшируется на 1 ч.
|
|
352
|
+
intervalHours: 24,
|
|
353
|
+
// Стабильный канал — npmjs; бета — npm-реестр Gitea (чтение без токена).
|
|
354
|
+
stableRegistry: 'https://registry.npmjs.org',
|
|
355
|
+
betaRegistry: 'https://git.itphx.ru/api/packages/itphx/npm/',
|
|
356
|
+
},
|
|
239
357
|
authority: {
|
|
240
358
|
// ADR-106 Ф1: Authority-слой выключен по умолчанию — права не меняются.
|
|
241
359
|
enabled: false,
|
|
@@ -414,7 +532,9 @@ export const defaultConfig = {
|
|
|
414
532
|
},
|
|
415
533
|
permission: {
|
|
416
534
|
rules: {},
|
|
417
|
-
|
|
535
|
+
// ADR-029: срок ожидания подтверждения `ask` (по истечении — авто-отказ).
|
|
536
|
+
// 5 минут: пользователь должен успеть увидеть запрос и ответить.
|
|
537
|
+
askTimeoutMs: 300_000,
|
|
418
538
|
},
|
|
419
539
|
security: {
|
|
420
540
|
promptInjection: {
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { GlobalRole } from '../types/user.js';
|
|
1
2
|
export type EnvOverrideType = 'boolean' | 'number' | 'string';
|
|
2
3
|
export interface EnvOverrideDefinition {
|
|
3
4
|
/** Секция верхнего уровня конфига (`events`, `scheduler`, `webhooks`, `decision`). */
|
|
@@ -18,6 +19,21 @@ export interface EnvOverrideDefinition {
|
|
|
18
19
|
export declare const ENV_OVERRIDES: readonly EnvOverrideDefinition[];
|
|
19
20
|
/** camelCase → SNAKE_CASE (`autoBind` → `AUTO_BIND`, `ephemeralTtl` → `EPHEMERAL_TTL`). */
|
|
20
21
|
export declare function toSnakeCase(value: string): string;
|
|
22
|
+
/**
|
|
23
|
+
* Роли пользователя единого API-ключа (`auth.apiKeyRoles`), csv: `ADMIN,USER`.
|
|
24
|
+
*
|
|
25
|
+
* Намеренно **fail-closed** (в отличие от прочих env-оверрайдов): неизвестная
|
|
26
|
+
* роль — ошибка конфигурации на загрузке, а не warn+игнор. Иначе опечатка в
|
|
27
|
+
* `SYNTH_API_KEY_ROLES` молча оставляла бы дефолт (`USER`) или, хуже, ключ без
|
|
28
|
+
* ожидаемых прав; для прав доступа это недопустимо.
|
|
29
|
+
*/
|
|
30
|
+
export declare const API_KEY_ROLES_ENV = "SYNTH_API_KEY_ROLES";
|
|
31
|
+
/**
|
|
32
|
+
* Разобрать csv ролей API-ключа (`ADMIN,USER`; регистр и пробелы не важны).
|
|
33
|
+
* Пустой список и неизвестная роль → `Error` (fail-closed, понятный текст).
|
|
34
|
+
* Дубликаты схлопываются с сохранением порядка.
|
|
35
|
+
*/
|
|
36
|
+
export declare function parseApiKeyRoles(raw: string): GlobalRole[];
|
|
21
37
|
/**
|
|
22
38
|
* Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
|
|
23
39
|
* вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
|
|
@@ -89,10 +105,13 @@ export declare const BOOTSTRAP_SERVICE_KEYS_ENV = "SYNTH_BOOTSTRAP_SERVICE_KEYS"
|
|
|
89
105
|
export declare const OAUTH_PROVIDERS_ENV = "SYNTH_OAUTH_PROVIDERS";
|
|
90
106
|
/**
|
|
91
107
|
* Применяет объектные env-оверрайды, у которых нет плоского строкового
|
|
92
|
-
* представления (
|
|
93
|
-
*
|
|
94
|
-
*
|
|
95
|
-
*
|
|
108
|
+
* представления (`auth.apiKeyRoles`, `attachments.modalities`, `oauth.providers`,
|
|
109
|
+
* `security.bootstrapServiceKeys`). Нескалярные значения парсятся здесь;
|
|
110
|
+
* `security.bootstrapServiceKeys` — JSON, валидируется схемой, при ошибке
|
|
111
|
+
* парсинга/валидации warn в console и игнор (fail-soft: кривой installer-ключ не
|
|
112
|
+
* должен ронять старт инстанса — ensure-логика приложения просто ничего не
|
|
113
|
+
* бутстрапит, оператор видит warn). Исключение — `auth.apiKeyRoles`: там
|
|
114
|
+
* неизвестная роль бросает `Error` (fail-closed, права доступа).
|
|
96
115
|
*
|
|
97
116
|
* Мутирует переданный объект (в `loadConfig` — свежий результат `deepMerge`) и
|
|
98
117
|
* возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
|
|
@@ -11,6 +11,7 @@
|
|
|
11
11
|
* Приоритет (ADR-023): CLI-флаги (`overrides`) > env (`SYNTH_*`) > config.yaml > defaults.
|
|
12
12
|
*/
|
|
13
13
|
import { bootstrapServiceKeysSchema, oauthProvidersSchema } from './types.js';
|
|
14
|
+
import { GlobalRole } from '../types/user.js';
|
|
14
15
|
/**
|
|
15
16
|
* Реестр env-оверрайдов скалярных ключей вложенных секций (ADR-023).
|
|
16
17
|
*
|
|
@@ -20,6 +21,20 @@ import { bootstrapServiceKeysSchema, oauthProvidersSchema } from './types.js';
|
|
|
20
21
|
* плоского строкового представления — они остаются в config.yaml.
|
|
21
22
|
*/
|
|
22
23
|
export const ENV_OVERRIDES = [
|
|
24
|
+
// llm: лимит вывода по умолчанию (0 — авто-дефолт ядра).
|
|
25
|
+
{ section: 'llm', key: 'maxTokens', type: 'number' },
|
|
26
|
+
// llmGateway (ADR-036): мастер-выключатель шлюза. Дефолт зависит от профиля
|
|
27
|
+
// (backend/managed — включён, standalone — выключен); env перебивает и его,
|
|
28
|
+
// и config.yaml, но ниже runtime-тумблера из UI (`settings.json`).
|
|
29
|
+
{ section: 'llmGateway', key: 'enabled', type: 'boolean' },
|
|
30
|
+
// session.autoTitle: авто-именование сессии (мастер-флаг, отсрочка на
|
|
31
|
+
// приветствии, число реплик, порог «сигнала задачи»).
|
|
32
|
+
{ section: 'session', key: 'autoTitle.enabled', type: 'boolean' },
|
|
33
|
+
{ section: 'session', key: 'autoTitle.deferOnChatter', type: 'boolean' },
|
|
34
|
+
{ section: 'session', key: 'autoTitle.maxAttempts', type: 'number' },
|
|
35
|
+
{ section: 'session', key: 'autoTitle.minSignalChars', type: 'number' },
|
|
36
|
+
// context: политика ограничения контекстного окна (`off`|`warn`|`enforce`).
|
|
37
|
+
{ section: 'context', key: 'windowPolicy', type: 'string' },
|
|
23
38
|
// events (ADR-089)
|
|
24
39
|
{ section: 'events', key: 'enabled', type: 'boolean' },
|
|
25
40
|
{ section: 'events', key: 'defaultMode', type: 'string' },
|
|
@@ -61,6 +76,17 @@ export const ENV_OVERRIDES = [
|
|
|
61
76
|
{ section: 'decision', key: 'escalationModel', type: 'string' },
|
|
62
77
|
// analytics (ADR-102)
|
|
63
78
|
{ section: 'analytics', key: 'retentionDays', type: 'number' },
|
|
79
|
+
// git (ADR-076): таймауты сетевых git-операций (0 — без таймаута).
|
|
80
|
+
{ section: 'git', key: 'cloneTimeoutMs', type: 'number' },
|
|
81
|
+
{ section: 'git', key: 'fetchTimeoutMs', type: 'number' },
|
|
82
|
+
// git-тулы агента: локальные изменяющие операции и сетевые (0 — без таймаута).
|
|
83
|
+
{ section: 'git', key: 'localTimeoutMs', type: 'number' },
|
|
84
|
+
{ section: 'git', key: 'networkTimeoutMs', type: 'number' },
|
|
85
|
+
// ssh (PROP-124): режим работы инстанса с SSH-ключами (`tools`|`agent`).
|
|
86
|
+
// Переменная `SYNTH_SSH_MODE` читается НЕ здесь, а дедикарованным
|
|
87
|
+
// резолвером `resolveSshMode` (core) — как `SYNTH_EXECUTION_MODE`/
|
|
88
|
+
// `SYNTH_STORAGE_BACKEND`: один путь чтения на переменную, невалидное
|
|
89
|
+
// значение — ошибка конфигурации (fail-closed), а не warn + дефолт.
|
|
64
90
|
// questions (этап 1 roadmap 0.13 — блок 3): таймаут ответа + retention.
|
|
65
91
|
{ section: 'questions', key: 'timeoutMs', type: 'number' },
|
|
66
92
|
{ section: 'questions', key: 'retentionDays', type: 'number' },
|
|
@@ -71,6 +97,12 @@ export const ENV_OVERRIDES = [
|
|
|
71
97
|
{ section: 'background', key: 'maxRunsPerSession', type: 'number' },
|
|
72
98
|
{ section: 'background', key: 'logMaxBytes', type: 'number' },
|
|
73
99
|
{ section: 'background', key: 'retentionDays', type: 'number' },
|
|
100
|
+
// agents: предохранитель по объёму промпта саб-агента (не окно модели).
|
|
101
|
+
{ section: 'agents', key: 'subagentMaxInputTokens', type: 'number' },
|
|
102
|
+
// agents: лимит глубины вложенности саб-агентов (0 — без ограничения).
|
|
103
|
+
{ section: 'agents', key: 'subagentDepth', type: 'number' },
|
|
104
|
+
// limits: лимит тяжёлых операций с сессиями в минуту (0 — без ограничения).
|
|
105
|
+
{ section: 'limits', key: 'sessionOpsPerMinute', type: 'number' },
|
|
74
106
|
// attachments (ADR-115): вложения сообщений. Семейства MIME
|
|
75
107
|
// (`SYNTH_ATTACHMENTS_MODALITIES`, csv) — объектный ключ, обрабатывается
|
|
76
108
|
// отдельно (`applyAttachmentsModalitiesEnvOverride`); список префиксов
|
|
@@ -81,8 +113,24 @@ export const ENV_OVERRIDES = [
|
|
|
81
113
|
{ section: 'attachments', key: 'maxFilesPerMessage', type: 'number' },
|
|
82
114
|
{ section: 'attachments', key: 'maxBytesPerSession', type: 'number' },
|
|
83
115
|
{ section: 'attachments', key: 'gcDays', type: 'number' },
|
|
116
|
+
// attachments: размер части chunked-загрузки, байт (схема: ≥ 1024;
|
|
117
|
+
// невалидное значение ниже порога отбрасывает резолвер core).
|
|
118
|
+
{ section: 'attachments', key: 'maxChunkBytes', type: 'number' },
|
|
119
|
+
// attachments: число одновременных chunked-загрузок — на сессию и глобально.
|
|
120
|
+
{ section: 'attachments', key: 'maxActiveUploadsPerSession', type: 'number' },
|
|
121
|
+
{ section: 'attachments', key: 'maxActiveUploads', type: 'number' },
|
|
84
122
|
// metrics (ADR-094): Helm ставит `SYNTH_METRICS_ENABLED` — имя должно совпадать.
|
|
85
123
|
{ section: 'metrics', key: 'enabled', type: 'boolean' },
|
|
124
|
+
// updates (ADR-133): каналы обновлений. `check` — автопроверка в фоне;
|
|
125
|
+
// `channel` — `auto`|`stable`|`beta`; интервал и реестры каналов.
|
|
126
|
+
{ section: 'updates', key: 'check', type: 'boolean' },
|
|
127
|
+
{ section: 'updates', key: 'channel', type: 'string' },
|
|
128
|
+
{ section: 'updates', key: 'intervalHours', type: 'number' },
|
|
129
|
+
{ section: 'updates', key: 'stableRegistry', type: 'string' },
|
|
130
|
+
{ section: 'updates', key: 'betaRegistry', type: 'string' },
|
|
131
|
+
// tools: общий предел вывода инструментов (строк/байт).
|
|
132
|
+
{ section: 'tools', key: 'outputMaxLines', type: 'number' },
|
|
133
|
+
{ section: 'tools', key: 'outputMaxBytes', type: 'number' },
|
|
86
134
|
// authority (ADR-106 Ф1): мастер-выключатель слоя и режим наблюдения.
|
|
87
135
|
{ section: 'authority', key: 'enabled', type: 'boolean' },
|
|
88
136
|
{ section: 'authority', key: 'shadow', type: 'boolean' },
|
|
@@ -111,6 +159,53 @@ export const ENV_OVERRIDES = [
|
|
|
111
159
|
export function toSnakeCase(value) {
|
|
112
160
|
return value.replace(/([a-z0-9])([A-Z])/g, '$1_$2').toUpperCase();
|
|
113
161
|
}
|
|
162
|
+
/**
|
|
163
|
+
* Роли пользователя единого API-ключа (`auth.apiKeyRoles`), csv: `ADMIN,USER`.
|
|
164
|
+
*
|
|
165
|
+
* Намеренно **fail-closed** (в отличие от прочих env-оверрайдов): неизвестная
|
|
166
|
+
* роль — ошибка конфигурации на загрузке, а не warn+игнор. Иначе опечатка в
|
|
167
|
+
* `SYNTH_API_KEY_ROLES` молча оставляла бы дефолт (`USER`) или, хуже, ключ без
|
|
168
|
+
* ожидаемых прав; для прав доступа это недопустимо.
|
|
169
|
+
*/
|
|
170
|
+
export const API_KEY_ROLES_ENV = 'SYNTH_API_KEY_ROLES';
|
|
171
|
+
const API_KEY_ROLE_VALUES = Object.values(GlobalRole);
|
|
172
|
+
/**
|
|
173
|
+
* Разобрать csv ролей API-ключа (`ADMIN,USER`; регистр и пробелы не важны).
|
|
174
|
+
* Пустой список и неизвестная роль → `Error` (fail-closed, понятный текст).
|
|
175
|
+
* Дубликаты схлопываются с сохранением порядка.
|
|
176
|
+
*/
|
|
177
|
+
export function parseApiKeyRoles(raw) {
|
|
178
|
+
const tokens = raw
|
|
179
|
+
.split(',')
|
|
180
|
+
.map((part) => part.trim().toUpperCase())
|
|
181
|
+
.filter((part) => part !== '');
|
|
182
|
+
if (tokens.length === 0) {
|
|
183
|
+
throw new Error(`[config] ${API_KEY_ROLES_ENV}: пустой список ролей; допустимо: ${API_KEY_ROLE_VALUES.join(', ')}`);
|
|
184
|
+
}
|
|
185
|
+
const roles = [];
|
|
186
|
+
for (const token of tokens) {
|
|
187
|
+
if (!API_KEY_ROLE_VALUES.includes(token)) {
|
|
188
|
+
throw new Error(`[config] ${API_KEY_ROLES_ENV}: неизвестная роль "${token}"; ` +
|
|
189
|
+
`допустимо: ${API_KEY_ROLE_VALUES.join(', ')}`);
|
|
190
|
+
}
|
|
191
|
+
const role = token;
|
|
192
|
+
if (!roles.includes(role))
|
|
193
|
+
roles.push(role);
|
|
194
|
+
}
|
|
195
|
+
return roles;
|
|
196
|
+
}
|
|
197
|
+
function applyApiKeyRolesEnvOverride(config, env) {
|
|
198
|
+
const raw = env[API_KEY_ROLES_ENV];
|
|
199
|
+
if (raw === undefined || raw === '')
|
|
200
|
+
return;
|
|
201
|
+
const roles = parseApiKeyRoles(raw);
|
|
202
|
+
const current = config.auth;
|
|
203
|
+
const auth = current !== null && typeof current === 'object' && !Array.isArray(current)
|
|
204
|
+
? { ...current }
|
|
205
|
+
: {};
|
|
206
|
+
auth.apiKeyRoles = roles;
|
|
207
|
+
config.auth = auth;
|
|
208
|
+
}
|
|
114
209
|
/**
|
|
115
210
|
* Полное env-имя определения: `SYNTH_<SECTION>_<KEY>`. Точки в ключе означают
|
|
116
211
|
* вложенность (`log.enabled` → `SYNTH_EGRESS_LOG_ENABLED`).
|
|
@@ -314,15 +409,19 @@ export const BOOTSTRAP_SERVICE_KEYS_ENV = 'SYNTH_BOOTSTRAP_SERVICE_KEYS';
|
|
|
314
409
|
export const OAUTH_PROVIDERS_ENV = 'SYNTH_OAUTH_PROVIDERS';
|
|
315
410
|
/**
|
|
316
411
|
* Применяет объектные env-оверрайды, у которых нет плоского строкового
|
|
317
|
-
* представления (
|
|
318
|
-
*
|
|
319
|
-
*
|
|
320
|
-
*
|
|
412
|
+
* представления (`auth.apiKeyRoles`, `attachments.modalities`, `oauth.providers`,
|
|
413
|
+
* `security.bootstrapServiceKeys`). Нескалярные значения парсятся здесь;
|
|
414
|
+
* `security.bootstrapServiceKeys` — JSON, валидируется схемой, при ошибке
|
|
415
|
+
* парсинга/валидации warn в console и игнор (fail-soft: кривой installer-ключ не
|
|
416
|
+
* должен ронять старт инстанса — ensure-логика приложения просто ничего не
|
|
417
|
+
* бутстрапит, оператор видит warn). Исключение — `auth.apiKeyRoles`: там
|
|
418
|
+
* неизвестная роль бросает `Error` (fail-closed, права доступа).
|
|
321
419
|
*
|
|
322
420
|
* Мутирует переданный объект (в `loadConfig` — свежий результат `deepMerge`) и
|
|
323
421
|
* возвращает его; секция `security` клонируется, чтобы не мутировать `defaultConfig`.
|
|
324
422
|
*/
|
|
325
423
|
export function applyObjectEnvOverrides(config, env = process.env) {
|
|
424
|
+
applyApiKeyRolesEnvOverride(config, env);
|
|
326
425
|
applyAttachmentsModalitiesEnvOverride(config, env);
|
|
327
426
|
applyOAuthProvidersEnvOverride(config, env);
|
|
328
427
|
const raw = env[BOOTSTRAP_SERVICE_KEYS_ENV];
|
package/dist/config/index.d.ts
CHANGED
package/dist/config/index.js
CHANGED
package/dist/config/loader.d.ts
CHANGED
|
@@ -6,5 +6,13 @@ export interface LoadConfigOptions {
|
|
|
6
6
|
overrides?: Partial<SynthConfig>;
|
|
7
7
|
/** ADR-023: источник env для оверрайдов; по умолчанию `process.env` (в тестах — свой env). */
|
|
8
8
|
env?: NodeJS.ProcessEnv;
|
|
9
|
+
/**
|
|
10
|
+
* Дефолты профиля (например, backend/managed): глубокий мёрж **после**
|
|
11
|
+
* общего `defaultConfig` и **до** `config.yaml`/env/CLI. Позволяет профилю
|
|
12
|
+
* поднять дефолт (`llmGateway.enabled: true`), не перебивая явную
|
|
13
|
+
* конфигурацию (приоритет: CLI > env > config.yaml > профиль-дефолт >
|
|
14
|
+
* общий дефолт).
|
|
15
|
+
*/
|
|
16
|
+
baseDefaults?: Record<string, unknown>;
|
|
9
17
|
}
|
|
10
18
|
export declare function loadConfig(options?: LoadConfigOptions): Promise<SynthConfig>;
|
package/dist/config/loader.js
CHANGED
|
@@ -74,7 +74,12 @@ export async function loadConfig(options = {}) {
|
|
|
74
74
|
}
|
|
75
75
|
}
|
|
76
76
|
warnLegacyKeys(fileConfig, options.env ?? process.env);
|
|
77
|
-
|
|
77
|
+
// Профильные дефолты (backend/managed) — выше общего `defaultConfig`, но ниже
|
|
78
|
+
// `config.yaml`/env/CLI: явная настройка всегда перебивает профиль.
|
|
79
|
+
const withBaseDefaults = options.baseDefaults
|
|
80
|
+
? deepMerge(defaultConfig, options.baseDefaults)
|
|
81
|
+
: defaultConfig;
|
|
82
|
+
const merged = deepMerge(withBaseDefaults, fileConfig);
|
|
78
83
|
// ADR-023: env-оверрайды скалярных ключей вложенных секций применяются одним
|
|
79
84
|
// местом — поверх defaults + config.yaml и ниже CLI-overrides
|
|
80
85
|
// (приоритет: CLI > env > config.yaml > defaults).
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Редактирование секретов в дампе конфигурации (`synth config show`).
|
|
3
|
+
*
|
|
4
|
+
* `SynthConfig` может содержать значения секретов (`core.apiKey`,
|
|
5
|
+
* `security.secretKey`, `remote.auth.apiKey`, `auth.oidc.clientSecret`,
|
|
6
|
+
* `storage.postgres.password` и т.п.). Печатать такой дамп целиком нельзя:
|
|
7
|
+
* это утечка в журнал/терминал/CI. Хелпер возвращает **глубокую копию** с
|
|
8
|
+
* замаскированными непустыми значениями секретных ключей — исходный объект не
|
|
9
|
+
* мутируется.
|
|
10
|
+
*
|
|
11
|
+
* Маскируются только ключи с **точным** (case-insensitive) именем из списка;
|
|
12
|
+
* `timeout`, `tokenizer`, `apiKeyRoles` и другие похожие по подстроке ключи
|
|
13
|
+
* остаются как есть. Значение-маска — строка `'***'`.
|
|
14
|
+
*/
|
|
15
|
+
import type { SynthConfig } from './types.js';
|
|
16
|
+
/**
|
|
17
|
+
* Вернуть копию конфигурации с замаскированными секретами.
|
|
18
|
+
*
|
|
19
|
+
* Копирование — `structuredClone` (конфиг состоит из JSON-совместимых данных);
|
|
20
|
+
* fallback на JSON-клон для сред без `structuredClone`.
|
|
21
|
+
*/
|
|
22
|
+
export declare function redactConfigSecrets(config: SynthConfig): SynthConfig;
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
/** Имена ключей, значения которых считаются секретами (без учёта регистра). */
|
|
2
|
+
const SECRET_KEY_NAMES = new Set([
|
|
3
|
+
'apiKey',
|
|
4
|
+
'tokenSecret',
|
|
5
|
+
'secretKey',
|
|
6
|
+
'password',
|
|
7
|
+
'token',
|
|
8
|
+
'clientSecret',
|
|
9
|
+
'privateKey',
|
|
10
|
+
'passphrase',
|
|
11
|
+
'secret',
|
|
12
|
+
'signingKey',
|
|
13
|
+
'webhookSecret',
|
|
14
|
+
].map((key) => key.toLowerCase()));
|
|
15
|
+
/** Строка-маска для скрытого значения. */
|
|
16
|
+
const MASK = '***';
|
|
17
|
+
/** Непустое значение (пустая строка/пробелы, null и undefined — не секрет). */
|
|
18
|
+
function isNonEmpty(value) {
|
|
19
|
+
if (value === undefined || value === null)
|
|
20
|
+
return false;
|
|
21
|
+
if (typeof value === 'string')
|
|
22
|
+
return value.trim().length > 0;
|
|
23
|
+
return true;
|
|
24
|
+
}
|
|
25
|
+
/** Рекурсивно замаскировать секретные ключи в копии значения. */
|
|
26
|
+
function maskSecrets(value) {
|
|
27
|
+
if (Array.isArray(value))
|
|
28
|
+
return value.map(maskSecrets);
|
|
29
|
+
if (value && typeof value === 'object') {
|
|
30
|
+
const source = value;
|
|
31
|
+
const result = {};
|
|
32
|
+
for (const [key, child] of Object.entries(source)) {
|
|
33
|
+
result[key] =
|
|
34
|
+
SECRET_KEY_NAMES.has(key.toLowerCase()) && isNonEmpty(child)
|
|
35
|
+
? MASK
|
|
36
|
+
: maskSecrets(child);
|
|
37
|
+
}
|
|
38
|
+
return result;
|
|
39
|
+
}
|
|
40
|
+
return value;
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Вернуть копию конфигурации с замаскированными секретами.
|
|
44
|
+
*
|
|
45
|
+
* Копирование — `structuredClone` (конфиг состоит из JSON-совместимых данных);
|
|
46
|
+
* fallback на JSON-клон для сред без `structuredClone`.
|
|
47
|
+
*/
|
|
48
|
+
export function redactConfigSecrets(config) {
|
|
49
|
+
const clone = typeof structuredClone === 'function'
|
|
50
|
+
? structuredClone(config)
|
|
51
|
+
: JSON.parse(JSON.stringify(config));
|
|
52
|
+
return maskSecrets(clone);
|
|
53
|
+
}
|
package/dist/config/resolve.d.ts
CHANGED
|
@@ -45,6 +45,23 @@ export declare function resolveWorkspaceOutsideRootPolicy(config: SynthConfig, e
|
|
|
45
45
|
* config/дефолт (fail-soft, как остальные env-резолверы; не падаем).
|
|
46
46
|
*/
|
|
47
47
|
export declare function resolveMaxUploadBytes(config: SynthConfig, env?: NodeJS.ProcessEnv): number;
|
|
48
|
+
/**
|
|
49
|
+
* Максимальный размер файла, отдаваемого `GET /api/v2/fs/read`, в байтах.
|
|
50
|
+
* Приоритет: env `SYNTH_MAX_READ_BYTES` > `config.storage.maxReadBytes` >
|
|
51
|
+
* `DEFAULT_MAX_READ_BYTES` (5 МиБ). Некорректное env-значение (не число или
|
|
52
|
+
* вне границ `MIN_READ_BYTES`…`MAX_READ_BYTES_LIMIT`) — warn и фолбэк на
|
|
53
|
+
* config/дефолт (fail-soft, как остальные env-резолверы; не падаем).
|
|
54
|
+
*/
|
|
55
|
+
export declare function resolveMaxReadBytes(config: SynthConfig, env?: NodeJS.ProcessEnv): number;
|
|
56
|
+
/**
|
|
57
|
+
* Максимальный размер файла, отдаваемого `GET /api/v2/fs/raw` (предпросмотр
|
|
58
|
+
* медиа), в байтах. Приоритет: env `SYNTH_MAX_PREVIEW_BYTES` >
|
|
59
|
+
* `config.storage.maxPreviewBytes` > `DEFAULT_MAX_PREVIEW_BYTES` (100 МиБ).
|
|
60
|
+
* Некорректное env-значение (не число или вне границ
|
|
61
|
+
* `MIN_PREVIEW_BYTES`…`MAX_PREVIEW_BYTES_LIMIT`) — warn и фолбэк на
|
|
62
|
+
* config/дефолт (fail-soft, как остальные env-резолверы; не падаем).
|
|
63
|
+
*/
|
|
64
|
+
export declare function resolveMaxPreviewBytes(config: SynthConfig, env?: NodeJS.ProcessEnv): number;
|
|
48
65
|
/**
|
|
49
66
|
* ADR-096: физический backend хранения. Приоритет (ADR-023): env
|
|
50
67
|
* `SYNTH_STORAGE_BACKEND` > `config.storage.backend` > `'file'`.
|
package/dist/config/resolve.js
CHANGED
|
@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from 'node:fs';
|
|
|
2
2
|
import { mkdir, writeFile } from 'node:fs/promises';
|
|
3
3
|
import { join, resolve } from 'node:path';
|
|
4
4
|
import { dump as dumpYaml } from 'js-yaml';
|
|
5
|
-
import { DEFAULT_MAX_UPLOAD_BYTES, MIN_UPLOAD_BYTES, MAX_UPLOAD_BYTES_LIMIT } from '../types/index.js';
|
|
5
|
+
import { DEFAULT_MAX_UPLOAD_BYTES, MIN_UPLOAD_BYTES, MAX_UPLOAD_BYTES_LIMIT, DEFAULT_MAX_READ_BYTES, MIN_READ_BYTES, MAX_READ_BYTES_LIMIT, DEFAULT_MAX_PREVIEW_BYTES, MIN_PREVIEW_BYTES, MAX_PREVIEW_BYTES_LIMIT, } from '../types/index.js';
|
|
6
6
|
import { defaultConfig } from './defaults.js';
|
|
7
7
|
import { normalizePostgresSslMode } from './tls.js';
|
|
8
8
|
const DATA_SUBDIRS = [
|
|
@@ -236,6 +236,45 @@ export function resolveMaxUploadBytes(config, env) {
|
|
|
236
236
|
}
|
|
237
237
|
return config.storage.maxUploadBytes ?? DEFAULT_MAX_UPLOAD_BYTES;
|
|
238
238
|
}
|
|
239
|
+
/**
|
|
240
|
+
* Максимальный размер файла, отдаваемого `GET /api/v2/fs/read`, в байтах.
|
|
241
|
+
* Приоритет: env `SYNTH_MAX_READ_BYTES` > `config.storage.maxReadBytes` >
|
|
242
|
+
* `DEFAULT_MAX_READ_BYTES` (5 МиБ). Некорректное env-значение (не число или
|
|
243
|
+
* вне границ `MIN_READ_BYTES`…`MAX_READ_BYTES_LIMIT`) — warn и фолбэк на
|
|
244
|
+
* config/дефолт (fail-soft, как остальные env-резолверы; не падаем).
|
|
245
|
+
*/
|
|
246
|
+
export function resolveMaxReadBytes(config, env) {
|
|
247
|
+
const raw = (env ?? process.env).SYNTH_MAX_READ_BYTES;
|
|
248
|
+
if (raw) {
|
|
249
|
+
const n = Number(raw);
|
|
250
|
+
if (Number.isFinite(n) && n >= MIN_READ_BYTES && n <= MAX_READ_BYTES_LIMIT) {
|
|
251
|
+
return Math.floor(n);
|
|
252
|
+
}
|
|
253
|
+
console.warn(`[config] невалидное значение SYNTH_MAX_READ_BYTES="${raw}" ` +
|
|
254
|
+
`(ожидается число от ${MIN_READ_BYTES} до ${MAX_READ_BYTES_LIMIT}) — игнорируется`);
|
|
255
|
+
}
|
|
256
|
+
return config.storage.maxReadBytes ?? DEFAULT_MAX_READ_BYTES;
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* Максимальный размер файла, отдаваемого `GET /api/v2/fs/raw` (предпросмотр
|
|
260
|
+
* медиа), в байтах. Приоритет: env `SYNTH_MAX_PREVIEW_BYTES` >
|
|
261
|
+
* `config.storage.maxPreviewBytes` > `DEFAULT_MAX_PREVIEW_BYTES` (100 МиБ).
|
|
262
|
+
* Некорректное env-значение (не число или вне границ
|
|
263
|
+
* `MIN_PREVIEW_BYTES`…`MAX_PREVIEW_BYTES_LIMIT`) — warn и фолбэк на
|
|
264
|
+
* config/дефолт (fail-soft, как остальные env-резолверы; не падаем).
|
|
265
|
+
*/
|
|
266
|
+
export function resolveMaxPreviewBytes(config, env) {
|
|
267
|
+
const raw = (env ?? process.env).SYNTH_MAX_PREVIEW_BYTES;
|
|
268
|
+
if (raw) {
|
|
269
|
+
const n = Number(raw);
|
|
270
|
+
if (Number.isFinite(n) && n >= MIN_PREVIEW_BYTES && n <= MAX_PREVIEW_BYTES_LIMIT) {
|
|
271
|
+
return Math.floor(n);
|
|
272
|
+
}
|
|
273
|
+
console.warn(`[config] невалидное значение SYNTH_MAX_PREVIEW_BYTES="${raw}" ` +
|
|
274
|
+
`(ожидается число от ${MIN_PREVIEW_BYTES} до ${MAX_PREVIEW_BYTES_LIMIT}) — игнорируется`);
|
|
275
|
+
}
|
|
276
|
+
return config.storage.maxPreviewBytes ?? DEFAULT_MAX_PREVIEW_BYTES;
|
|
277
|
+
}
|
|
239
278
|
/**
|
|
240
279
|
* ADR-096: физический backend хранения. Приоритет (ADR-023): env
|
|
241
280
|
* `SYNTH_STORAGE_BACKEND` > `config.storage.backend` > `'file'`.
|