@itphx/synth-shared 0.12.3 → 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,11 +1,20 @@
1
1
  import type { PermissionConfig, McpServerToolSettings } from './permission.js';
2
- import type { Message } from './message.js';
2
+ import type { Message, Part } from './message.js';
3
3
  import type { PromptState } from './prompt.js';
4
4
  import type { SessionWorktree } from './worktree.js';
5
+ import type { EffortLevel } from './llm.js';
5
6
  export type SessionOrigin = 'user' | 'fork' | 'subagent';
6
7
  export interface SessionStatus {
7
8
  blocked?: string;
8
9
  blockedAt?: string;
10
+ /**
11
+ * Идентификатор процесса инстанса, поставившего блокировку
12
+ * (`SessionManager.instanceId`). Аддитивное поле: по нему восстановление
13
+ * после рестарта отличает живую блокировку текущего процесса от маркера,
14
+ * оставшегося от убитого (rolling update). Отсутствие = legacy-запись,
15
+ * считается чужой.
16
+ */
17
+ blockedOwner?: string;
9
18
  /**
10
19
  * Персистентный флаг запроса отмены генерации (кнопка «Стоп», `/stop`).
11
20
  * Живёт в JSON-хранилище (ADR-005): позволяет остановить сессию, когда
@@ -15,11 +24,64 @@ export interface SessionStatus {
15
24
  cancelRequested?: boolean;
16
25
  /** Время запроса отмены (ISO) — для диагностики/аудита. */
17
26
  cancelRequestedAt?: string;
27
+ /**
28
+ * Обработка очереди осознанно остановлена: «Стоп» при непустой очереди или
29
+ * `queue.stalled` (потеря процессора). После рестарта такие сессии **не**
30
+ * автозапускаются — пользователь возобновляет вручную
31
+ * (`POST /queue/:id/resume` или новое сообщение).
32
+ */
33
+ queueStopped?: boolean;
34
+ /** Время остановки обработки очереди (ISO) — для диагностики/аудита. */
35
+ queueStoppedAt?: string;
18
36
  }
19
37
  export declare const PLAN_MODES: readonly ["auto", "strict", "off"];
20
38
  export type PlanMode = (typeof PLAN_MODES)[number];
21
39
  export declare const SESSION_MODES: readonly ["plan", "act", "yolo"];
22
40
  export type SessionMode = (typeof SESSION_MODES)[number];
41
+ /**
42
+ * Instance-wide дефолты оптимизации контекста для **новых** сессий.
43
+ *
44
+ * Источник — `context.defaults` (config.yaml) с runtime-override
45
+ * (`/api/v2/settings/context-defaults`). Применяются только при создании
46
+ * сессии: явные `settings` запроса приоритетнее, существующие сессии не
47
+ * меняются.
48
+ */
49
+ export interface ContextDefaults {
50
+ /**
51
+ * Режим сжатия контекста:
52
+ * - `summarization` — итоги беседы (обобщённые выводы, в т.ч. по tool-вызовам);
53
+ * - `compaction` — рабочее состояние по коду/проекту (детали, пути, команды);
54
+ * - `none`/`sliding_window` — без сжатия в SUMMARY.
55
+ *
56
+ * `sticky_notes` — legacy-значение сессий, в дефолтах и UI не предлагается:
57
+ * заметки работают независимо от стратегии.
58
+ */
59
+ contextOptimization: 'none' | 'sliding_window' | 'summarization' | 'compaction';
60
+ summarizationEnabled: boolean;
61
+ summarizationTriggerMode: 'messages' | 'tokens';
62
+ /** Число сообщений до запуска суммаризации. */
63
+ summarizeAfterN: number;
64
+ /** Порог суммаризации в процентах окна модели (1..100). */
65
+ summarizeTokenThreshold: number;
66
+ /**
67
+ * @deprecated Новый движок сжатия не использует head/tail: граница хвоста
68
+ * считается по токенам (`summarizationKeepTokens`/`compactionKeepTokens`).
69
+ * Поле оставлено для обратной совместимости схем/сохранённых настроек.
70
+ */
71
+ summarizationHeadMessages: number;
72
+ /** @deprecated См. `summarizationHeadMessages`. */
73
+ summarizationTailMessages: number;
74
+ /** Хвост дословно для режима суммаризации (токены); `0` — без хвоста. */
75
+ summarizationKeepTokens: number;
76
+ /** Хвост дословно для режима компактизации (токены). */
77
+ compactionKeepTokens: number;
78
+ /** Порог компактизации в процентах окна модели (1..100). */
79
+ compactionTokenThreshold: number;
80
+ slidingWindowMode: 'messages' | 'tokens';
81
+ slidingWindowMessageLimit: number;
82
+ /** Порог скользящего окна в процентах окна модели (1..100). */
83
+ slidingWindowTokenThreshold: number;
84
+ }
23
85
  /**
24
86
  * ADR-071 §2.3: политика включения инструментов в запрос.
25
87
  * - `consistency` — в запрос идут все определения, недоступность кодируется
@@ -48,7 +110,22 @@ export interface SessionSettings {
48
110
  model?: string;
49
111
  /** Уровень размышлений модели. Для openai/generic — reasoning_effort, anthropic — thinking, ollama — think. */
50
112
  reasoningLevel?: ReasoningLevel;
51
- temperature: number;
113
+ /**
114
+ * ADR-117: явный тир усилия (effort) сессии — `low|medium|high|xhigh|max`.
115
+ *
116
+ * Приоритет при выборе тира на LLM-вызов:
117
+ * `ChatOptions.effort` → `agent.effort` → это поле →
118
+ * `effortForReasoningLevel(agent.reasoningLevel ?? reasoningLevel)`.
119
+ * Нужен для `xhigh`/`max`: из `reasoningLevel` они не выводятся (шкалы не
120
+ * совпадают). Параметр уходит провайдеру только при
121
+ * `compatibility.supportsEffortUpdates` у модели.
122
+ */
123
+ effort?: EffortLevel;
124
+ /**
125
+ * Температура генерации. `undefined` — дефолт модели: поле `temperature`
126
+ * вообще не отправляется провайдеру (не подменяется на 0.7).
127
+ */
128
+ temperature?: number;
52
129
  maxTokens: number;
53
130
  systemPrompt?: string;
54
131
  debugEnabled: boolean;
@@ -67,7 +144,12 @@ export interface SessionSettings {
67
144
  * Изменение дефолта проекта/системы не влияет на существующие сессии.
68
145
  */
69
146
  mcpDefaultOn?: string[];
70
- contextOptimization: 'none' | 'sliding_window' | 'summarization' | 'sticky_notes';
147
+ /**
148
+ * `sticky_notes` — legacy-значение сессий (сохранённые сессии продолжают
149
+ * валидироваться), в дефолтах и UI не предлагается: заметки работают
150
+ * независимо от стратегии.
151
+ */
152
+ contextOptimization: 'none' | 'sliding_window' | 'summarization' | 'compaction' | 'sticky_notes';
71
153
  slidingWindowMode: 'messages' | 'tokens';
72
154
  slidingWindowMessageLimit: number;
73
155
  slidingWindowTokenThreshold: number;
@@ -75,8 +157,16 @@ export interface SessionSettings {
75
157
  summarizationTriggerMode: 'messages' | 'tokens';
76
158
  summarizeAfterN: number;
77
159
  summarizeTokenThreshold: number;
160
+ /** @deprecated Новый движок сжатия не использует head/tail (см. `summarizationKeepTokens`). */
78
161
  summarizationHeadMessages: number;
162
+ /** @deprecated См. `summarizationHeadMessages`. */
79
163
  summarizationTailMessages: number;
164
+ /** Хвост дословно для режима суммаризации (токены); `0` — без хвоста. */
165
+ summarizationKeepTokens: number;
166
+ /** Хвост дословно для режима компактизации (токены). */
167
+ compactionKeepTokens: number;
168
+ /** Порог компактизации в процентах окна модели (1..100). */
169
+ compactionTokenThreshold: number;
80
170
  showInterview: boolean;
81
171
  websocketEnabled: boolean;
82
172
  language?: string;
@@ -171,6 +261,65 @@ export interface StreamInfo {
171
261
  agentRole?: string;
172
262
  startedAt: string;
173
263
  cancelled: boolean;
264
+ /**
265
+ * ADR-118 §10: идентификатор хода (`turn_...`), которому принадлежит
266
+ * живой стрим. UI восстанавливает ход после перезагрузки страницы по этой
267
+ * метке (в DTO — `current_stream.turn_id`); без неё группировка сегментов
268
+ * хода и индикаторы «ход идёт» после reload ломаются.
269
+ */
270
+ turnId?: string;
271
+ /**
272
+ * Идентификатор процесса инстанса, ведущего стрим (`SessionManager.instanceId`).
273
+ * Аддитивное поле: восстановление после рестарта снимает маркеры только
274
+ * чужого процесса. Отсутствие = legacy-запись, считается чужой.
275
+ */
276
+ owner?: string;
277
+ }
278
+ /**
279
+ * ADR-118 §5: снимок **живого шага** (in-memory, отдаётся в
280
+ * `GET /api/v2/sessions/:id` → `current_stream.live`).
281
+ *
282
+ * Пока шаг стримится, его содержимое у клиента складывается из дельт. Снимок
283
+ * позволяет открыть сессию посреди хода и увидеть всё до текущего момента, не
284
+ * ожидая следующей дельты. `parts` — те же части, что в `part.delta`/
285
+ * `part.updated` (детерминированные id), поэтому клиент мержит их без дублей.
286
+ */
287
+ export interface StreamLiveSnapshot {
288
+ /** Id сообщения шага (assistant). */
289
+ messageId: string;
290
+ /** Индекс шага в ходе. */
291
+ stepIndex?: number;
292
+ /** Id хода (`turn_...`), если известен. */
293
+ turnId?: string;
294
+ /** Накопленный текст шага. */
295
+ content: string;
296
+ /** Накопленные рассуждения шага. */
297
+ reasoning?: string;
298
+ /** Части шага (текст/reasoning/вызовы инструментов). */
299
+ parts: Part[];
300
+ /** Момент последнего обновления (ISO). */
301
+ updatedAt: string;
302
+ }
303
+ /**
304
+ * Персистентное состояние ретрая сессии (LLM-вызов упал с восстанавливаемой
305
+ * ошибкой, процессор ждёт backoff перед следующей попыткой).
306
+ *
307
+ * Хранится вместе с сессией (файловое хранилище — поле `retry`; PostgreSQL —
308
+ * jsonb-колонка `sessions.retry`), поэтому после перезагрузки страницы или
309
+ * рестарта сервера клиент видит «повтор», а не «пусто». Снимается при новом
310
+ * `stream.start`, успехе, терминальной ошибке и отмене/сбросе очереди.
311
+ */
312
+ export interface SessionRetryState {
313
+ /** Идентификатор стрима, чья попытка повторяется. */
314
+ streamId: string;
315
+ /** Номер попытки (1-based) — уже совершённых неудачных попыток. */
316
+ attempt: number;
317
+ /** Предел попыток (`LLM_MAX_ATTEMPTS`). */
318
+ maxRetries: number;
319
+ /** ISO — когда будет следующая попытка. */
320
+ retryAt: string;
321
+ /** Текст последней ошибки (может содержать детали провайдера). */
322
+ error?: string;
174
323
  }
175
324
  export interface Branch {
176
325
  id: string;
@@ -192,6 +341,19 @@ export interface StickyNote {
192
341
  updatedAt: string;
193
342
  disabled: boolean;
194
343
  }
344
+ /**
345
+ * Instance-wide лимиты заметок сессии (`context.stickyNotes`).
346
+ *
347
+ * Это **ограничения инстанса**, а не дефолты сессии: применяются ко всем
348
+ * сессиям при создании/изменении заметки. Уже существующие заметки не
349
+ * удаляются и не обрезаются — лимит действует только на новые записи.
350
+ */
351
+ export interface StickyNotesLimits {
352
+ /** Максимум заметок на сессию (1..1000, дефолт 50). */
353
+ maxCount: number;
354
+ /** Максимум символов в одной заметке (1..100000, дефолт 2000). */
355
+ maxChars: number;
356
+ }
195
357
  export interface SessionReference {
196
358
  type: 'session_reference';
197
359
  sessionId: string;
@@ -288,6 +450,11 @@ export interface Session {
288
450
  stickyNotes: StickyNote[];
289
451
  references: SessionReference[];
290
452
  currentStream?: StreamInfo;
453
+ /**
454
+ * Состояние ретрая сессии (персистентное) — см. `SessionRetryState`.
455
+ * Поле аддитивное: его отсутствие = «ретрая нет».
456
+ */
457
+ retry?: SessionRetryState;
291
458
  summarizationPending: boolean;
292
459
  canSummarize: boolean;
293
460
  createdAt: string;
@@ -84,6 +84,18 @@ export interface ToolContext {
84
84
  */
85
85
  projectId?: string;
86
86
  workingDir: string;
87
+ /**
88
+ * Дополнительные абсолютные корни, внутри которых файловые/поисковые/shell-
89
+ * и git-тулы считаются «своими» (perimeter сессии).
90
+ *
91
+ * `workingDir` остаётся **базой для относительных** путей (и каталогом
92
+ * исполнения shell/git): относительный путь резолвится от него. Containment
93
+ * же проверяется по `workingDir` + `allowedRoots` — так сессия в git-worktree
94
+ * (ADR-114) видит и рабочий каталог worktree, и корень проекта
95
+ * (`project.workspace`), как в opencode (`FileAccess.resolve`:
96
+ * internal = location.directory ИЛИ project worktree).
97
+ */
98
+ allowedRoots?: string[];
87
99
  /**
88
100
  * ADR-114: привязка сессии к git-worktree.
89
101
  *
@@ -157,6 +169,15 @@ export interface ToolDefinition {
157
169
  capabilities: ToolCapability[];
158
170
  execute: ToolExecutor;
159
171
  jsonSchema?: Record<string, unknown>;
172
+ /**
173
+ * Нормализация аргументов **до** zod-валидации — терпимость к типовым обёрткам
174
+ * слабых моделей (`{todos: {item: …}}` вместо `{todos: …}`).
175
+ *
176
+ * На JSON Schema не влияет (схема для модели остаётся прежней); вызывается
177
+ * один раз в `executeToolDef` перед `safeParse`, возвращает аргументы для
178
+ * проверки. Аддитивное поле: тул без него работает как прежде.
179
+ */
180
+ normalizeArgs?: (args: Record<string, unknown>) => Record<string, unknown>;
160
181
  /** ADR-071 §2.1: источник инструмента (builtin/mcp/plugin). */
161
182
  source?: ToolSource;
162
183
  /** ADR-071 §2.1: имя MCP-сервера для `source: 'mcp'`. */
@@ -92,7 +92,7 @@ export const TOOL_CAPABILITY_META = {
92
92
  },
93
93
  [ToolCapability.PROCESS]: {
94
94
  label: 'Фоновые процессы',
95
- description: 'process_list, process_logs',
95
+ description: 'process_list, process_logs, process_stop, process_delete',
96
96
  },
97
97
  [ToolCapability.MODELS]: {
98
98
  label: 'Модели',
@@ -1,7 +1,19 @@
1
- /** Блок рассуждений: текст и итерация Tool Use, к которой он относится. */
1
+ /**
2
+ * Блок рассуждений: текст и итерация Tool Use, к которой он относится.
3
+ * `signature`/`redacted` — служебные данные Anthropic-протокола: подпись
4
+ * thinking-блока и opaque-данные `redacted_thinking` (аддитивные поля,
5
+ * остальные провайдеры их не заполняют).
6
+ */
2
7
  export interface ReasoningBlock {
3
8
  text: string;
4
9
  iteration: number;
10
+ signature?: string;
11
+ redacted?: string;
12
+ }
13
+ /** Служебная подпись блока (передаётся в `appendReasoningBlock`). */
14
+ export interface ReasoningBlockMeta {
15
+ signature?: string;
16
+ redacted?: string;
5
17
  }
6
18
  /**
7
19
  * Накопить блок рассуждений: текст от провайдера кумулятивный, поэтому
@@ -11,6 +23,10 @@ export interface ReasoningBlock {
11
23
  * проверяется раньше дедупа — иначе каждый следующий кумулятивный чанк давал бы
12
24
  * новый блок, а рестарт попытки (текст снова с нуля) — блок-дубль.
13
25
  *
26
+ * Блок без текста, но с подписью/redacted (`signature: ""`, `redacted_thinking`)
27
+ * — валидный и добавляется отдельным элементом: подпись принадлежит своему
28
+ * блоку, терять её нельзя.
29
+ *
14
30
  * Вход не мутируется: изменённые ветки возвращают новый массив.
15
31
  */
16
- export declare function appendReasoningBlock(blocks: readonly ReasoningBlock[], text: string, iteration: number): ReasoningBlock[];
32
+ export declare function appendReasoningBlock(blocks: readonly ReasoningBlock[], text: string, iteration: number, meta?: ReasoningBlockMeta): ReasoningBlock[];
@@ -7,15 +7,24 @@
7
7
  * проверяется раньше дедупа — иначе каждый следующий кумулятивный чанк давал бы
8
8
  * новый блок, а рестарт попытки (текст снова с нуля) — блок-дубль.
9
9
  *
10
+ * Блок без текста, но с подписью/redacted (`signature: ""`, `redacted_thinking`)
11
+ * — валидный и добавляется отдельным элементом: подпись принадлежит своему
12
+ * блоку, терять её нельзя.
13
+ *
10
14
  * Вход не мутируется: изменённые ветки возвращают новый массив.
11
15
  */
12
- export function appendReasoningBlock(blocks, text, iteration) {
13
- // 1. Пустой/пробельный текст состояния не меняет.
14
- if (!text || !text.trim())
15
- return [...blocks];
16
+ export function appendReasoningBlock(blocks, text, iteration, meta) {
17
+ const hasMeta = meta !== undefined
18
+ && (meta.signature !== undefined || meta.redacted !== undefined);
19
+ // 1. Пустой/пробельный текст без метаданных состояния не меняет.
20
+ if (!text || !text.trim()) {
21
+ if (!hasMeta)
22
+ return [...blocks];
23
+ return [...blocks, { text: text ?? '', iteration, ...meta }];
24
+ }
16
25
  // 2. Первый блок.
17
26
  if (blocks.length === 0)
18
- return [{ text, iteration }];
27
+ return [{ text, iteration, ...meta }];
19
28
  const last = blocks[blocks.length - 1];
20
29
  // 3. Тот же текст — ничего не меняем.
21
30
  if (text === last.text)
@@ -23,7 +32,7 @@ export function appendReasoningBlock(blocks, text, iteration) {
23
32
  // 4. Продолжение того же рассуждения (в т.ч. при смене итерации) — заменяем
24
33
  // последний блок, а не добавляем новый.
25
34
  if (text.startsWith(last.text)) {
26
- return [...blocks.slice(0, -1), { text, iteration }];
35
+ return [...blocks.slice(0, -1), { text, iteration, ...meta }];
27
36
  }
28
37
  // 5. Пришёл более короткий вариант — рестарт/повтор той же попытки, состояние
29
38
  // уже содержит более полный текст.
@@ -33,5 +42,5 @@ export function appendReasoningBlock(blocks, text, iteration) {
33
42
  if (blocks.some((block) => block.text === text))
34
43
  return [...blocks];
35
44
  // 7. Новое рассуждение.
36
- return [...blocks, { text, iteration }];
45
+ return [...blocks, { text, iteration, ...meta }];
37
46
  }
package/dist/version.d.ts CHANGED
@@ -1 +1 @@
1
- export declare const SYNTH_VERSION = "0.12.3";
1
+ export declare const SYNTH_VERSION = "0.13.4";
package/dist/version.js CHANGED
@@ -1 +1 @@
1
- export const SYNTH_VERSION = '0.12.3';
1
+ export const SYNTH_VERSION = '0.13.4';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@itphx/synth-shared",
3
- "version": "0.12.3",
3
+ "version": "0.13.4",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -47,7 +47,7 @@
47
47
  }
48
48
  },
49
49
  "dependencies": {
50
- "js-yaml": "^4.1.1",
50
+ "js-yaml": "^4.3.2",
51
51
  "zod": "^4.6.7"
52
52
  },
53
53
  "devDependencies": {