@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.
Files changed (41) hide show
  1. package/dist/config/defaults.js +97 -4
  2. package/dist/config/env-overrides.js +29 -0
  3. package/dist/config/resolve.d.ts +17 -0
  4. package/dist/config/resolve.js +40 -1
  5. package/dist/config/types.d.ts +394 -7
  6. package/dist/config/types.js +275 -6
  7. package/dist/i18n/index.d.ts +1 -1
  8. package/dist/i18n/index.js +188 -3
  9. package/dist/index.d.ts +2 -2
  10. package/dist/index.js +2 -2
  11. package/dist/schemas/index.d.ts +90 -10
  12. package/dist/schemas/index.js +55 -4
  13. package/dist/types/agent.d.ts +8 -1
  14. package/dist/types/bus-events.d.ts +59 -1
  15. package/dist/types/egress.d.ts +1 -1
  16. package/dist/types/egress.js +1 -1
  17. package/dist/types/file-kind.d.ts +40 -0
  18. package/dist/types/file-kind.js +157 -0
  19. package/dist/types/fs.d.ts +54 -1
  20. package/dist/types/fs.js +43 -0
  21. package/dist/types/git.d.ts +5 -0
  22. package/dist/types/index.d.ts +2 -0
  23. package/dist/types/index.js +6 -0
  24. package/dist/types/llm.d.ts +95 -0
  25. package/dist/types/llm.js +58 -0
  26. package/dist/types/message-stream.d.ts +348 -0
  27. package/dist/types/message-stream.js +41 -0
  28. package/dist/types/message.d.ts +49 -0
  29. package/dist/types/pack.d.ts +6 -6
  30. package/dist/types/permission.d.ts +26 -0
  31. package/dist/types/pipeline-engine.d.ts +2 -2
  32. package/dist/types/provider.d.ts +280 -0
  33. package/dist/types/provider.js +289 -0
  34. package/dist/types/session.d.ts +170 -3
  35. package/dist/types/tools.d.ts +21 -0
  36. package/dist/types/tools.js +1 -1
  37. package/dist/utils/reasoning.d.ts +18 -2
  38. package/dist/utils/reasoning.js +16 -7
  39. package/dist/version.d.ts +1 -1
  40. package/dist/version.js +1 -1
  41. package/package.json +2 -2
@@ -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
- // Максимум записей реестра на сессию-владельца (чистится retention-ом).
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: 25 * 1024 * 1024,
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
- askTimeoutMs: 30_000,
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' },
@@ -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'`.
@@ -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'`.