@itphx/synth-shared 0.12.4 → 0.13.4
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 +97 -4
- package/dist/config/env-overrides.js +29 -0
- package/dist/config/resolve.d.ts +17 -0
- package/dist/config/resolve.js +40 -1
- package/dist/config/types.d.ts +394 -7
- package/dist/config/types.js +275 -6
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +188 -3
- package/dist/index.d.ts +2 -2
- package/dist/index.js +2 -2
- package/dist/schemas/index.d.ts +90 -10
- package/dist/schemas/index.js +55 -4
- package/dist/types/agent.d.ts +8 -1
- package/dist/types/bus-events.d.ts +59 -1
- package/dist/types/egress.d.ts +1 -1
- package/dist/types/egress.js +1 -1
- 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 +5 -0
- package/dist/types/index.d.ts +2 -0
- package/dist/types/index.js +6 -0
- package/dist/types/llm.d.ts +95 -0
- package/dist/types/llm.js +58 -0
- package/dist/types/message-stream.d.ts +348 -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 +26 -0
- package/dist/types/pipeline-engine.d.ts +2 -2
- package/dist/types/provider.d.ts +280 -0
- package/dist/types/provider.js +289 -0
- package/dist/types/session.d.ts +170 -3
- package/dist/types/tools.d.ts +21 -0
- package/dist/types/tools.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 +2 -2
package/dist/config/defaults.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
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';
|
|
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: смена
|
|
@@ -51,6 +53,7 @@ export const defaultConfig = {
|
|
|
51
53
|
defaultModel: '',
|
|
52
54
|
maxRetries: 3,
|
|
53
55
|
timeout: 60,
|
|
56
|
+
maxTokens: 8192,
|
|
54
57
|
cache: 'auto',
|
|
55
58
|
},
|
|
56
59
|
core: {
|
|
@@ -98,9 +101,42 @@ export const defaultConfig = {
|
|
|
98
101
|
},
|
|
99
102
|
session: {
|
|
100
103
|
planMode: 'auto',
|
|
104
|
+
// Авто-заголовок сессии: включён, приветствие откладывает именование,
|
|
105
|
+
// ждём до 2 реплик, «сигналом задачи» считаем сообщение от 30 символов.
|
|
106
|
+
autoTitle: {
|
|
107
|
+
enabled: true,
|
|
108
|
+
deferOnChatter: true,
|
|
109
|
+
maxAttempts: 2,
|
|
110
|
+
minSignalChars: 30,
|
|
111
|
+
},
|
|
101
112
|
},
|
|
102
113
|
context: {
|
|
103
114
|
enabledFiles: ['SOUL.md', 'COMPANY.md', 'ABOUT.md'],
|
|
115
|
+
// Политика контекстного окна: по умолчанию только предупреждать (блокировка — opt-in).
|
|
116
|
+
windowPolicy: 'warn',
|
|
117
|
+
// Дефолты оптимизации контекста для новых сессий (совпадают с прежними
|
|
118
|
+
// литералами `SessionManager.createSession`).
|
|
119
|
+
defaults: {
|
|
120
|
+
contextOptimization: 'compaction',
|
|
121
|
+
summarizationEnabled: true,
|
|
122
|
+
summarizationTriggerMode: 'messages',
|
|
123
|
+
summarizeAfterN: 10,
|
|
124
|
+
summarizeTokenThreshold: 50,
|
|
125
|
+
summarizationHeadMessages: 2,
|
|
126
|
+
summarizationTailMessages: 3,
|
|
127
|
+
summarizationKeepTokens: 5000,
|
|
128
|
+
compactionKeepTokens: 15000,
|
|
129
|
+
compactionTokenThreshold: 85,
|
|
130
|
+
slidingWindowMode: 'messages',
|
|
131
|
+
slidingWindowMessageLimit: 10,
|
|
132
|
+
slidingWindowTokenThreshold: 80,
|
|
133
|
+
},
|
|
134
|
+
// Instance-wide лимиты заметок сессии (`context.stickyNotes`): ограничения
|
|
135
|
+
// инстанса, не дефолты сессии. Существующие заметки не обрезаются.
|
|
136
|
+
stickyNotes: {
|
|
137
|
+
maxCount: 50,
|
|
138
|
+
maxChars: 2000,
|
|
139
|
+
},
|
|
104
140
|
},
|
|
105
141
|
summarization: {
|
|
106
142
|
provider: '',
|
|
@@ -123,6 +159,10 @@ export const defaultConfig = {
|
|
|
123
159
|
capabilities: [],
|
|
124
160
|
tools: [],
|
|
125
161
|
},
|
|
162
|
+
// Общий предел вывода инструментов (строк/байт) — усечение результата
|
|
163
|
+
// с пометкой «показано N из M».
|
|
164
|
+
outputMaxLines: 2000,
|
|
165
|
+
outputMaxBytes: 51_200,
|
|
126
166
|
},
|
|
127
167
|
skills: {
|
|
128
168
|
paths: [],
|
|
@@ -189,6 +229,18 @@ export const defaultConfig = {
|
|
|
189
229
|
// ADR-102: срок хранения суточных роллапов — 400 дней (<= 0 — без ограничения).
|
|
190
230
|
retentionDays: 400,
|
|
191
231
|
},
|
|
232
|
+
git: {
|
|
233
|
+
// ADR-076: таймауты сетевых git-операций. 5 минут: сеть git может идти
|
|
234
|
+
// минутами (большой репозиторий/медленный remote), но «зависший» вызов не
|
|
235
|
+
// должен держать ход агента бесконечно; 0 — без таймаута.
|
|
236
|
+
cloneTimeoutMs: 300_000,
|
|
237
|
+
fetchTimeoutMs: 300_000,
|
|
238
|
+
// Таймауты git-тулов агента по классам операции: локальные изменяющие
|
|
239
|
+
// (commit/checkout/stash) — 2 минуты, сетевые (push/pull) — 5 минут.
|
|
240
|
+
// Read-only операции имеют фиксированный предел 30 с. 0 — без таймаута.
|
|
241
|
+
localTimeoutMs: 120_000,
|
|
242
|
+
networkTimeoutMs: 300_000,
|
|
243
|
+
},
|
|
192
244
|
questions: {
|
|
193
245
|
// Этап 1 roadmap 0.13 (блок 3): срок ожидания ответа пользователя на вопрос —
|
|
194
246
|
// по умолчанию **без таймаута** (0): вопрос ждёт, пока ответят или отменят
|
|
@@ -207,13 +259,23 @@ export const defaultConfig = {
|
|
|
207
259
|
maxSubagentsPerSession: 2,
|
|
208
260
|
// Максимум одновременно идущих фоновых шелл-процессов на сессию-владельца.
|
|
209
261
|
maxProcessesPerSession: 5,
|
|
210
|
-
// Максимум
|
|
262
|
+
// Максимум одновременно идущих прогонов любого вида на сессию-владельца
|
|
263
|
+
// (история реестра лимитом не считается — её чистит retention).
|
|
211
264
|
maxRunsPerSession: 10,
|
|
212
265
|
// Предел размера лога фонового процесса, байт (10 МиБ; 0 — без ограничения).
|
|
213
266
|
logMaxBytes: 10_485_760,
|
|
214
267
|
// Срок хранения терминальных записей реестра (дни; <= 0 — без ограничения).
|
|
215
268
|
retentionDays: 7,
|
|
216
269
|
},
|
|
270
|
+
agents: {
|
|
271
|
+
// Предохранитель по объёму промпта саб-агента (не окно модели): при
|
|
272
|
+
// превышении оценка бюджета завершает прогон детерминированным отчётом.
|
|
273
|
+
// 0 — без ограничения.
|
|
274
|
+
subagentMaxInputTokens: 0,
|
|
275
|
+
// Лимит глубины вложенности саб-агентов (по цепочке `parentId` сессий:
|
|
276
|
+
// текущая — 0, родитель — 1, …). 0 — без ограничения.
|
|
277
|
+
subagentDepth: 1,
|
|
278
|
+
},
|
|
217
279
|
attachments: {
|
|
218
280
|
// ADR-115: вложения сообщений. Мастер-выключатель, семейства MIME,
|
|
219
281
|
// лимиты (байты на файл, число файлов в сообщении, суммарный объём на
|
|
@@ -221,7 +283,7 @@ export const defaultConfig = {
|
|
|
221
283
|
// хранения осиротевших объектов.
|
|
222
284
|
enabled: true,
|
|
223
285
|
modalities: { image: true, pdf: true, audio: true, video: true },
|
|
224
|
-
maxBytesPerFile:
|
|
286
|
+
maxBytesPerFile: 100 * 1024 * 1024,
|
|
225
287
|
maxFilesPerMessage: 10,
|
|
226
288
|
maxBytesPerSession: 1024 * 1024 * 1024,
|
|
227
289
|
allowedMimePrefixes: ['image/', 'audio/', 'video/', 'application/pdf', 'text/'],
|
|
@@ -231,6 +293,35 @@ export const defaultConfig = {
|
|
|
231
293
|
// с путём в workspace (текущее поведение).
|
|
232
294
|
modalityModels: {},
|
|
233
295
|
gcDays: 30,
|
|
296
|
+
// ADR-115: сжатие — только на границе отправки провайдеру (в blob лежит
|
|
297
|
+
// оригинал). Пределы сторон/битрейты — разумные дефолты для чата; пороги
|
|
298
|
+
// `minBytes` не дают перекодировать мелкие файлы.
|
|
299
|
+
compression: {
|
|
300
|
+
enabled: true,
|
|
301
|
+
image: { enabled: true, maxSidePx: 2048, quality: 85, minBytes: 1024 * 1024 },
|
|
302
|
+
video: {
|
|
303
|
+
enabled: true,
|
|
304
|
+
maxHeightPx: 720,
|
|
305
|
+
bitrateKbps: 2000,
|
|
306
|
+
audioBitrateKbps: 96,
|
|
307
|
+
minBytes: 8 * 1024 * 1024,
|
|
308
|
+
},
|
|
309
|
+
audio: {
|
|
310
|
+
enabled: true,
|
|
311
|
+
bitrateKbps: 64,
|
|
312
|
+
channels: 1,
|
|
313
|
+
sampleRateHz: 16000,
|
|
314
|
+
minBytes: 4 * 1024 * 1024,
|
|
315
|
+
},
|
|
316
|
+
},
|
|
317
|
+
// ADR-115: серверные миниатюры для UI (производный JPEG в blob).
|
|
318
|
+
thumbnail: { enabled: true, maxWidthPx: 512 },
|
|
319
|
+
// Предел одной части chunked-загрузки, байт (8 МиБ).
|
|
320
|
+
maxChunkBytes: 8 * 1024 * 1024,
|
|
321
|
+
// Пределы числа незавершённых chunked-загрузок: одной сессии и инстанса
|
|
322
|
+
// (включая staging-контур без привязки к сессии).
|
|
323
|
+
maxActiveUploadsPerSession: 16,
|
|
324
|
+
maxActiveUploads: 256,
|
|
234
325
|
},
|
|
235
326
|
metrics: {
|
|
236
327
|
// ADR-094: экспорт Prometheus-метрик выключен по умолчанию (`GET /metrics` → 404).
|
|
@@ -414,7 +505,9 @@ export const defaultConfig = {
|
|
|
414
505
|
},
|
|
415
506
|
permission: {
|
|
416
507
|
rules: {},
|
|
417
|
-
|
|
508
|
+
// ADR-029: срок ожидания подтверждения `ask` (по истечении — авто-отказ).
|
|
509
|
+
// 5 минут: пользователь должен успеть увидеть запрос и ответить.
|
|
510
|
+
askTimeoutMs: 300_000,
|
|
418
511
|
},
|
|
419
512
|
security: {
|
|
420
513
|
promptInjection: {
|
|
@@ -20,6 +20,16 @@ import { bootstrapServiceKeysSchema, oauthProvidersSchema } from './types.js';
|
|
|
20
20
|
* плоского строкового представления — они остаются в config.yaml.
|
|
21
21
|
*/
|
|
22
22
|
export const ENV_OVERRIDES = [
|
|
23
|
+
// llm: лимит вывода по умолчанию (0 — авто-дефолт ядра).
|
|
24
|
+
{ section: 'llm', key: 'maxTokens', type: 'number' },
|
|
25
|
+
// session.autoTitle: авто-именование сессии (мастер-флаг, отсрочка на
|
|
26
|
+
// приветствии, число реплик, порог «сигнала задачи»).
|
|
27
|
+
{ section: 'session', key: 'autoTitle.enabled', type: 'boolean' },
|
|
28
|
+
{ section: 'session', key: 'autoTitle.deferOnChatter', type: 'boolean' },
|
|
29
|
+
{ section: 'session', key: 'autoTitle.maxAttempts', type: 'number' },
|
|
30
|
+
{ section: 'session', key: 'autoTitle.minSignalChars', type: 'number' },
|
|
31
|
+
// context: политика ограничения контекстного окна (`off`|`warn`|`enforce`).
|
|
32
|
+
{ section: 'context', key: 'windowPolicy', type: 'string' },
|
|
23
33
|
// events (ADR-089)
|
|
24
34
|
{ section: 'events', key: 'enabled', type: 'boolean' },
|
|
25
35
|
{ section: 'events', key: 'defaultMode', type: 'string' },
|
|
@@ -61,6 +71,12 @@ export const ENV_OVERRIDES = [
|
|
|
61
71
|
{ section: 'decision', key: 'escalationModel', type: 'string' },
|
|
62
72
|
// analytics (ADR-102)
|
|
63
73
|
{ section: 'analytics', key: 'retentionDays', type: 'number' },
|
|
74
|
+
// git (ADR-076): таймауты сетевых git-операций (0 — без таймаута).
|
|
75
|
+
{ section: 'git', key: 'cloneTimeoutMs', type: 'number' },
|
|
76
|
+
{ section: 'git', key: 'fetchTimeoutMs', type: 'number' },
|
|
77
|
+
// git-тулы агента: локальные изменяющие операции и сетевые (0 — без таймаута).
|
|
78
|
+
{ section: 'git', key: 'localTimeoutMs', type: 'number' },
|
|
79
|
+
{ section: 'git', key: 'networkTimeoutMs', type: 'number' },
|
|
64
80
|
// questions (этап 1 roadmap 0.13 — блок 3): таймаут ответа + retention.
|
|
65
81
|
{ section: 'questions', key: 'timeoutMs', type: 'number' },
|
|
66
82
|
{ section: 'questions', key: 'retentionDays', type: 'number' },
|
|
@@ -71,6 +87,10 @@ export const ENV_OVERRIDES = [
|
|
|
71
87
|
{ section: 'background', key: 'maxRunsPerSession', type: 'number' },
|
|
72
88
|
{ section: 'background', key: 'logMaxBytes', type: 'number' },
|
|
73
89
|
{ section: 'background', key: 'retentionDays', type: 'number' },
|
|
90
|
+
// agents: предохранитель по объёму промпта саб-агента (не окно модели).
|
|
91
|
+
{ section: 'agents', key: 'subagentMaxInputTokens', type: 'number' },
|
|
92
|
+
// agents: лимит глубины вложенности саб-агентов (0 — без ограничения).
|
|
93
|
+
{ section: 'agents', key: 'subagentDepth', type: 'number' },
|
|
74
94
|
// attachments (ADR-115): вложения сообщений. Семейства MIME
|
|
75
95
|
// (`SYNTH_ATTACHMENTS_MODALITIES`, csv) — объектный ключ, обрабатывается
|
|
76
96
|
// отдельно (`applyAttachmentsModalitiesEnvOverride`); список префиксов
|
|
@@ -81,8 +101,17 @@ export const ENV_OVERRIDES = [
|
|
|
81
101
|
{ section: 'attachments', key: 'maxFilesPerMessage', type: 'number' },
|
|
82
102
|
{ section: 'attachments', key: 'maxBytesPerSession', type: 'number' },
|
|
83
103
|
{ section: 'attachments', key: 'gcDays', type: 'number' },
|
|
104
|
+
// attachments: размер части chunked-загрузки, байт (схема: ≥ 1024;
|
|
105
|
+
// невалидное значение ниже порога отбрасывает резолвер core).
|
|
106
|
+
{ section: 'attachments', key: 'maxChunkBytes', type: 'number' },
|
|
107
|
+
// attachments: число одновременных chunked-загрузок — на сессию и глобально.
|
|
108
|
+
{ section: 'attachments', key: 'maxActiveUploadsPerSession', type: 'number' },
|
|
109
|
+
{ section: 'attachments', key: 'maxActiveUploads', type: 'number' },
|
|
84
110
|
// metrics (ADR-094): Helm ставит `SYNTH_METRICS_ENABLED` — имя должно совпадать.
|
|
85
111
|
{ section: 'metrics', key: 'enabled', type: 'boolean' },
|
|
112
|
+
// tools: общий предел вывода инструментов (строк/байт).
|
|
113
|
+
{ section: 'tools', key: 'outputMaxLines', type: 'number' },
|
|
114
|
+
{ section: 'tools', key: 'outputMaxBytes', type: 'number' },
|
|
86
115
|
// authority (ADR-106 Ф1): мастер-выключатель слоя и режим наблюдения.
|
|
87
116
|
{ section: 'authority', key: 'enabled', type: 'boolean' },
|
|
88
117
|
{ section: 'authority', key: 'shadow', type: 'boolean' },
|
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'`.
|