@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
@@ -0,0 +1,348 @@
1
+ /**
2
+ * ADR-118 «Поток сообщений v2» — контрактная часть: модель хода
3
+ * (Turn → Step → Part), контракт приёма сообщения и payload'ы новых событий
4
+ * шины сессии.
5
+ *
6
+ * Модуль browser-safe: только типы и чистые функции, без node-зависимостей —
7
+ * используется и в ядре, и в UI (сверка возможностей инстанса).
8
+ *
9
+ * Решения ADR-118, которые здесь закреплены:
10
+ * - п. 3 — `POST /api/v2/sessions/:id/prompt` всегда отвечает `202
11
+ * {messageId, mode, position}` (см. `PromptAcceptedResponse`);
12
+ * - п. 4 — набор новых событий (`message.accepted`/`queue.state`/
13
+ * `message.delivered`/`turn.*`/`step.*`/`part.*`) с payload'ами ниже;
14
+ * - п. 5 — «финал» = смена статуса сообщения (`MessageStatus`), а не замена
15
+ * объекта;
16
+ * - п. 8 — сверка возможностей клиента и сервера (fail-closed) через
17
+ * `GET /api/v2/meta` → `InstanceCapabilities`.
18
+ */
19
+ import type { TokenUsage } from './llm.js';
20
+ import type { AuthorityPrincipal } from './authority.js';
21
+ import type { MessageRole, Part } from './message.js';
22
+ /**
23
+ * ADR-118 §5: статус сообщения-хода. Assistant-сообщение создаётся на
24
+ * `step.started` и живёт до `step.finished`; «финал» — это смена статуса.
25
+ */
26
+ export type MessageStatus = 'streaming' | 'completed' | 'cancelled' | 'error';
27
+ /**
28
+ * ADR-118 §3 / ADR-104: режим приёма сообщения.
29
+ * - `queue` — по умолчанию: сообщение ждёт окончания текущего хода;
30
+ * - `steer` — вмешательство в активный ход (применяется на границе шага);
31
+ * - `interrupt` — прерывание генерации с продолжением того же хода.
32
+ */
33
+ export type PromptMode = 'queue' | 'steer' | 'interrupt';
34
+ /**
35
+ * ADR-118 §1: терминальный статус хода (`turn.finished`).
36
+ * `stopped` — ход остановлен без ошибки (например, пустой содержательный ответ).
37
+ */
38
+ export type TurnStatus = 'completed' | 'cancelled' | 'error' | 'stopped';
39
+ /**
40
+ * ADR-118 §3: ответ `202` на `POST /api/v2/sessions/:id/prompt`.
41
+ *
42
+ * `position` — позиция в очереди; `null`, если сообщение уже материализовано
43
+ * в истории (тогда `ord` уже выдан).
44
+ */
45
+ export type PromptAcceptedResponse = {
46
+ /** Идентификатор сообщения (выдаётся при приёме, ADR-118 §«Порядок»). */
47
+ messageId: string;
48
+ /** Режим приёма. */
49
+ mode: PromptMode;
50
+ /** Позиция в очереди либо `null` (сообщение уже в истории). */
51
+ position: number | null;
52
+ };
53
+ /**
54
+ * ADR-118 §4: payload адресного события `message.accepted`
55
+ * (доставляется подписчику с `recipient === userId` отправителя).
56
+ */
57
+ export type MessageAcceptedPayload = {
58
+ messageId: string;
59
+ mode: PromptMode;
60
+ position: number | null;
61
+ };
62
+ /**
63
+ * ADR-118 §4: элемент очереди сессии — **только идентификатор и состояние**
64
+ * (`queued` — ждёт; `starting` — взят в работу). Ни текста, ни автора (утечки
65
+ * нет — как и у счётчиков).
66
+ */
67
+ export type QueueItemState = {
68
+ id: string;
69
+ status: 'queued' | 'starting';
70
+ };
71
+ /**
72
+ * ADR-118 §4: payload события `queue.state` (канал сессии).
73
+ * Несёт **только счётчики** — ни текста, ни автора (устранение утечки
74
+ * `message.queued`).
75
+ */
76
+ export type QueueStatePayload = {
77
+ /** Сообщений в очереди. */
78
+ pendingCount: number;
79
+ /** Сообщений-вмешательств (`steer`/`interrupt`), ждущих применения. */
80
+ steerCount: number;
81
+ /**
82
+ * Элементы очереди с их состоянием (`queued`/`starting`) — аддитивно.
83
+ *
84
+ * `id` — идентификатор элемента: идентификатор потока сообщения
85
+ * (`metadata.stream_id`), по которому клиент связывает элемент с живым
86
+ * ходом (`current_stream.stream_id`); для обрабатываемого сообщения он
87
+ * совпадает с `current_stream.stream_id`.
88
+ */
89
+ items?: QueueItemState[];
90
+ };
91
+ /**
92
+ * ADR-118 §4: payload события `message.delivered` (канал сессии) —
93
+ * сообщение материализовано в истории сессии.
94
+ */
95
+ export type MessageDeliveredPayload = {
96
+ /** Идентификатор сообщения. */
97
+ messageId: string;
98
+ /** Монотонный порядок записи (`Message.ord`). */
99
+ ord: number;
100
+ /** Роль сообщения. */
101
+ role: MessageRole;
102
+ /** Автор (display-строка) — для видимости очереди/вмешательств. */
103
+ author?: string;
104
+ /** Принципал ввода (ADR-106) — машиночитаемая атрибуция. */
105
+ principal?: AuthorityPrincipal;
106
+ /**
107
+ * Идентификатор хода (`turn_id`), которому принадлежит сообщение.
108
+ *
109
+ * Аддитивно: поле появляется там, где сервер знает ход в момент
110
+ * материализации (вмешательство, применённое на границе шага). Для реплики,
111
+ * с которой ход только начинается, ход выдаётся позже оркестратором —
112
+ * тогда `turnId` отсутствует, и клиент берёт его из `turn.started`.
113
+ */
114
+ turnId?: string;
115
+ };
116
+ /**
117
+ * ADR-118 §4: снимок сообщения в событии `message.enqueued`.
118
+ *
119
+ * Те же поля, что отдаёт список сообщений, но **без `ord`**: сообщение ещё не
120
+ * материализовано в истории — `ord` выдаётся только при записи.
121
+ *
122
+ * Снимок **уже обфусцирован** (обфускация выполняется в `enqueueUserMessage`
123
+ * до постановки в очередь, ADR-036), а реальные значения секретов из
124
+ * `metadata.secrets` вырезаются — в событии их быть не должно.
125
+ */
126
+ export type EnqueuedMessageSnapshot = {
127
+ /** Идентификатор сообщения (стабильный, выдаётся при приёме). */
128
+ id: string;
129
+ /** Роль сообщения. */
130
+ role: MessageRole;
131
+ /** Автор (display-строка). */
132
+ author?: string;
133
+ /** Текст сообщения. */
134
+ content: string;
135
+ /** Части сообщения (медиа — ссылка на blob, ADR-115). */
136
+ parts?: Part[];
137
+ /** Метаданные сообщения (маркеры `steer`/`interrupt`, тип фоновой работы). */
138
+ metadata?: Record<string, unknown> | null;
139
+ /** Время постановки в очередь (ISO). */
140
+ created_at: string;
141
+ };
142
+ /**
143
+ * ADR-118 §4: payload адресного события `message.enqueued` — сообщение
144
+ * поставлено в очередь (или в очередь вмешательств) и ждёт материализации.
145
+ *
146
+ * Событие **адресное** (как `message.accepted`): `recipient` — владелец
147
+ * сессии. В standalone пользователь один, поэтому видно всем локальным
148
+ * клиентам — известное ограничение ADR-118.
149
+ */
150
+ export type MessageEnqueuedPayload = {
151
+ /** Идентификатор принятого сообщения (тот же, что в `202`/`message.accepted`). */
152
+ messageId: string;
153
+ /** Куда поставлено: `queue` — обычная очередь, `steer` — очередь вмешательств. */
154
+ delivery: 'queue' | 'steer';
155
+ /** Позиция в очереди (1-based); `null` — вмешательство очередь не занимает. */
156
+ position: number | null;
157
+ /** Снимок сообщения (уже обфусцированный). */
158
+ message: EnqueuedMessageSnapshot;
159
+ };
160
+ /**
161
+ * ADR-118 §1/§4: payload события `turn.started` (канал сессии) —
162
+ * ход начался.
163
+ */
164
+ export type TurnStartedPayload = {
165
+ /** Идентификатор хода. */
166
+ turnId: string;
167
+ /** Сообщение, которым ход начат (реплика пользователя). */
168
+ messageId: string;
169
+ };
170
+ /**
171
+ * ADR-118 §1/§4: payload события `turn.finished` (канал сессии) —
172
+ * ход завершён терминальным статусом.
173
+ */
174
+ export type TurnFinishedPayload = {
175
+ turnId: string;
176
+ status: TurnStatus;
177
+ };
178
+ /**
179
+ * ADR-118 §1/§4: payload события `step.started` (канал сессии) —
180
+ * шаг (один вызов LLM) начался; assistant-сообщение создаётся здесь.
181
+ */
182
+ export type StepStartedPayload = {
183
+ turnId: string;
184
+ /** Индекс шага внутри хода (0-based). */
185
+ stepIndex: number;
186
+ /** Сообщение шага. */
187
+ messageId: string;
188
+ };
189
+ /**
190
+ * ADR-118 §4: payload аддитивных событий `step.tools.started` /
191
+ * `step.tools.finished` (канал сессии) — **исполнение инструментов шага**.
192
+ *
193
+ * Уточняет смысл `step.finished`: он остаётся «вызов LLM завершён» (ответ
194
+ * получен и закрыт), а `step.tools.*` явно говорят UI, что шаг ещё работает —
195
+ * инструменты его вызовов исполняются. Публикуются только для шагов с
196
+ * непустым набором вызовов: ровно один `started` и один `finished`.
197
+ */
198
+ export type StepToolsPayload = {
199
+ turnId: string;
200
+ /** Индекс шага внутри хода (0-based). */
201
+ stepIndex: number;
202
+ /** Сообщение шага (то же, что у `step.started`/`step.finished`). */
203
+ messageId: string;
204
+ /** `callId` исполняемых вызовов (порядок — как у модели). */
205
+ callIds: string[];
206
+ };
207
+ /**
208
+ * ADR-118 §4: вложение ответа шага (ADR-115, outbound) — **метаданные**
209
+ * объекта, без байтов. Шлюз (Telegram/VK) забирает байты по sha256
210
+ * (`GET /api/v2/attachments/:sha256`) и не обращается к сессии.
211
+ */
212
+ export type StepAttachmentRef = {
213
+ /** SHA-256 содержимого (адрес объекта в контуре вложений). */
214
+ sha256: string;
215
+ /** MIME по содержимому. */
216
+ mime: string;
217
+ /** Размер в байтах. */
218
+ size: number;
219
+ /** Имя файла (санитайз), если известно. */
220
+ name?: string;
221
+ };
222
+ /**
223
+ * ADR-118 §4: тайминги шага — снимок счётчика чанков на момент финала шага.
224
+ * Число чанков и моменты первого/последнего чанка (мс от старта хода).
225
+ */
226
+ export type StepTimings = {
227
+ /** Число чанков шага. */
228
+ chunks: number;
229
+ /** Мс от старта хода до первого чанка. */
230
+ firstChunkMs?: number;
231
+ /** Мс от старта хода до последнего чанка. */
232
+ lastChunkMs?: number;
233
+ };
234
+ /**
235
+ * ADR-118 §4/§5: payload события `step.finished` (канал сессии) —
236
+ * шаг завершён: статус сообщения + учёт токенов.
237
+ *
238
+ * Аддитивные поля `provider`/`model`/`costUsd`/`costCurrency` — данные для
239
+ * наблюдаемости (ADR-094): счётчика ретраев (`synth_llm_retries_total`) и
240
+ * стоимости (`synth_llm_cost_total`) больше нечего читать из удалённого
241
+ * `stream.usage`/`stream.done` — шаг несёт их сам (один шаг = один вызов LLM,
242
+ * поэтому сумма по шагам равна стоимости хода).
243
+ *
244
+ * `attachments`/`debugInfo`/`timings`/`agentRole` — перенос данных удалённых
245
+ * `stream.done` в шаг: вложения ответа (ADR-115), отладочные данные
246
+ * (ADR-070), тайминги чанков и роль агента.
247
+ */
248
+ export type StepFinishedPayload = {
249
+ turnId: string;
250
+ stepIndex: number;
251
+ messageId: string;
252
+ /** Статус сообщения шага («финал» = смена статуса, ADR-118 §5). */
253
+ status: MessageStatus;
254
+ /** Расход токенов шага (замена `stream.usage`). */
255
+ usage?: TokenUsage;
256
+ /** Провайдер шага — для метрик (ретраи/стоимость), ADR-094. */
257
+ provider?: string;
258
+ /** Модель шага — для метрик (ретраи), ADR-094. */
259
+ model?: string;
260
+ /** Стоимость шага (в валюте `costCurrency`) — для `synth_llm_cost_total`. */
261
+ costUsd?: number;
262
+ /** Валюта стоимости шага (по умолчанию — USD). */
263
+ costCurrency?: string;
264
+ /** Роль агента шага — атрибуция в UI/аналитике. */
265
+ agentRole?: string;
266
+ /** Вложения ответа шага (ADR-115, outbound) — метаданные без байтов. */
267
+ attachments?: StepAttachmentRef[];
268
+ /** Отладочные данные шага (ADR-070) — payload debug-коллектора. */
269
+ debugInfo?: Record<string, unknown>;
270
+ /** Тайминги шага (число чанков, моменты первого/последнего). */
271
+ timings?: StepTimings;
272
+ };
273
+ /**
274
+ * ADR-118 §4: payload события `part.delta` (канал сессии) —
275
+ * дельта одной части сообщения. Доставка — **upsert** по
276
+ * `{messageId, partId}`, а не append (ADR-118 §«Идемпотентность доставки»).
277
+ */
278
+ export type PartDeltaPayload = {
279
+ messageId: string;
280
+ partId: string;
281
+ /** Поле части, которого касается дельта. */
282
+ field: 'text' | 'raw';
283
+ delta: string;
284
+ };
285
+ /**
286
+ * ADR-118 §4: payload события `part.updated` (канал сессии) —
287
+ * часть сообщения обновлена целиком (upsert по `{messageId, partId}`).
288
+ */
289
+ export type PartUpdatedPayload = {
290
+ messageId: string;
291
+ partId: string;
292
+ part: Part;
293
+ };
294
+ /**
295
+ * ADR-118 §8: версия модели сообщений/потока, которую понимает клиент.
296
+ * Инстанс сообщает свою версию в `GET /api/v2/meta`
297
+ * (`InstanceCapabilities.messageModel`).
298
+ */
299
+ export declare const MESSAGE_MODEL_VERSION = 2;
300
+ /**
301
+ * ADR-118 §8: имя query-параметра, которым клиент заявляет свою модель
302
+ * сообщений (`GET /api/v2/events?messageModel=2`).
303
+ *
304
+ * Константа живёт в `shared`, потому что её знают и клиент (UI/SDK), и
305
+ * сервер (гибридный мост `RemoteEventBridge`, `remote/event-bridge.ts`).
306
+ */
307
+ export declare const MESSAGE_MODEL_QUERY_PARAM = "messageModel";
308
+ /**
309
+ * ADR-115: эффективные лимиты вложений инстанса (`GET /api/v2/meta`).
310
+ *
311
+ * Источник — секция `attachments.*` с приоритетом env > runtime > config >
312
+ * defaults (тот же резолвер, что у `AttachmentService`). Клиент использует
313
+ * значения для предпроверки и текстов ошибок; истина — сервер.
314
+ */
315
+ export type InstanceAttachmentCapabilities = {
316
+ enabled: boolean;
317
+ modalities: {
318
+ image: boolean;
319
+ pdf: boolean;
320
+ audio: boolean;
321
+ video: boolean;
322
+ };
323
+ maxBytesPerFile: number;
324
+ maxFilesPerMessage: number;
325
+ maxBytesPerSession: number;
326
+ };
327
+ /**
328
+ * ADR-118 §8: возможности инстанса (`GET /api/v2/meta`).
329
+ *
330
+ * `messageModel` — версия модели сообщений; `eventSeq` — события нумеруются
331
+ * глобально в пределах инстанса (догон по `Last-Event-ID`/`?since`); `replay` —
332
+ * доступен догон по журналу событий; `version` — версия инстанса.
333
+ */
334
+ export type InstanceCapabilities = {
335
+ messageModel: number;
336
+ eventSeq: boolean;
337
+ replay: boolean;
338
+ version: string;
339
+ /** ADR-115: эффективные лимиты вложений (аддитивно; старые клиенты игнорируют). */
340
+ attachments?: InstanceAttachmentCapabilities;
341
+ };
342
+ /**
343
+ * ADR-118 §8: поддерживает ли инстанс текущую модель сообщений.
344
+ *
345
+ * Сверка **fail-closed**: отсутствие поля `messageModel` (старый инстанс) или
346
+ * иное значение → `false` (отказ подключения, а не тихая деградация).
347
+ */
348
+ export declare function supportsMessageModel(capabilities: Partial<InstanceCapabilities> | null | undefined): boolean;
@@ -0,0 +1,41 @@
1
+ /**
2
+ * ADR-118 «Поток сообщений v2» — контрактная часть: модель хода
3
+ * (Turn → Step → Part), контракт приёма сообщения и payload'ы новых событий
4
+ * шины сессии.
5
+ *
6
+ * Модуль browser-safe: только типы и чистые функции, без node-зависимостей —
7
+ * используется и в ядре, и в UI (сверка возможностей инстанса).
8
+ *
9
+ * Решения ADR-118, которые здесь закреплены:
10
+ * - п. 3 — `POST /api/v2/sessions/:id/prompt` всегда отвечает `202
11
+ * {messageId, mode, position}` (см. `PromptAcceptedResponse`);
12
+ * - п. 4 — набор новых событий (`message.accepted`/`queue.state`/
13
+ * `message.delivered`/`turn.*`/`step.*`/`part.*`) с payload'ами ниже;
14
+ * - п. 5 — «финал» = смена статуса сообщения (`MessageStatus`), а не замена
15
+ * объекта;
16
+ * - п. 8 — сверка возможностей клиента и сервера (fail-closed) через
17
+ * `GET /api/v2/meta` → `InstanceCapabilities`.
18
+ */
19
+ /**
20
+ * ADR-118 §8: версия модели сообщений/потока, которую понимает клиент.
21
+ * Инстанс сообщает свою версию в `GET /api/v2/meta`
22
+ * (`InstanceCapabilities.messageModel`).
23
+ */
24
+ export const MESSAGE_MODEL_VERSION = 2;
25
+ /**
26
+ * ADR-118 §8: имя query-параметра, которым клиент заявляет свою модель
27
+ * сообщений (`GET /api/v2/events?messageModel=2`).
28
+ *
29
+ * Константа живёт в `shared`, потому что её знают и клиент (UI/SDK), и
30
+ * сервер (гибридный мост `RemoteEventBridge`, `remote/event-bridge.ts`).
31
+ */
32
+ export const MESSAGE_MODEL_QUERY_PARAM = 'messageModel';
33
+ /**
34
+ * ADR-118 §8: поддерживает ли инстанс текущую модель сообщений.
35
+ *
36
+ * Сверка **fail-closed**: отсутствие поля `messageModel` (старый инстанс) или
37
+ * иное значение → `false` (отказ подключения, а не тихая деградация).
38
+ */
39
+ export function supportsMessageModel(capabilities) {
40
+ return capabilities?.messageModel === MESSAGE_MODEL_VERSION;
41
+ }
@@ -1,6 +1,7 @@
1
1
  import type { TokenUsage } from './llm.js';
2
2
  import type { PromptMeta } from './prompt.js';
3
3
  import type { AuthorityPrincipal } from './authority.js';
4
+ import type { MessageStatus } from './message-stream.js';
4
5
  export declare enum MessageRole {
5
6
  SYSTEM = "system",
6
7
  USER = "user",
@@ -49,10 +50,24 @@ export interface MediaPartData {
49
50
  */
50
51
  transcript?: string;
51
52
  }
53
+ /**
54
+ * Метаданные части сообщения. Для `reasoning`-части — служебные данные
55
+ * Anthropic-протокола: подпись thinking-блока (`signature`) либо opaque-данные
56
+ * `redacted_thinking` (`redacted`). Поле аддитивное: старые сообщения его не
57
+ * имеют, а `data` остаётся текстом размышлений (UI/учёт токенов).
58
+ */
59
+ export interface PartMetadata {
60
+ /** Подпись thinking-блока (своя у каждого блока). */
61
+ signature?: string;
62
+ /** Opaque-данные `redacted_thinking` (блок без текста). */
63
+ redacted?: string;
64
+ }
52
65
  export interface Part {
53
66
  id: string;
54
67
  type: PartType;
55
68
  data: unknown;
69
+ /** Служебные метаданные части (Anthropic thinking: подпись/redacted). */
70
+ metadata?: PartMetadata;
56
71
  }
57
72
  export type MessageOrigin = 'local' | 'inherited' | 'merged' | 'crosspost';
58
73
  /**
@@ -89,6 +104,16 @@ export interface Message {
89
104
  providerType?: string;
90
105
  usage?: TokenUsage;
91
106
  reasoning?: string;
107
+ /**
108
+ * Anthropic-протокол: подпись thinking-блока и opaque-данные
109
+ * `redacted_thinking`. Аддитивные поля персистятся вместе с сообщением —
110
+ * без них следующий запрос tool-loop отвергается («thinking не возвращён в
111
+ * историю»). Поле `reasoning` остаётся текстом размышлений; подпись
112
+ * валидна только для того текста, с которым пришла (у финального сообщения
113
+ * с несколькими блоками подписи нет — она принадлежит последнему блоку).
114
+ */
115
+ reasoningSignature?: string;
116
+ reasoningRedacted?: string[];
92
117
  source?: 'web' | 'cli' | 'api';
93
118
  author?: string;
94
119
  /**
@@ -104,4 +129,28 @@ export interface Message {
104
129
  summaryOf?: number[];
105
130
  qa_pass?: boolean;
106
131
  qa_reason?: string;
132
+ /**
133
+ * ADR-118 §«Порядок и идемпотентность»: монотонный порядок записи в
134
+ * истории сессии. Выдаётся в момент материализации записи и **никогда не
135
+ * перенумеровывается** (вставка в середину нумерацию не сдвигает).
136
+ * `seq` остаётся **позиционным** (порядок в массиве истории) и этим полем
137
+ * не заменяется.
138
+ */
139
+ ord?: number;
140
+ /**
141
+ * ADR-118 §«Модель данных»: идентификатор хода (`Turn`). Ход — от реплики
142
+ * пользователя до терминального статуса; сообщения хода делят `turnId`.
143
+ */
144
+ turnId?: string;
145
+ /**
146
+ * ADR-118 §«Модель данных»: индекс шага внутри хода (0-based). Шаг = один
147
+ * вызов LLM = одно assistant-сообщение.
148
+ */
149
+ stepIndex?: number;
150
+ /**
151
+ * ADR-118 §5: статус сообщения-хода (`streaming` → `completed` /
152
+ * `cancelled` / `error`). «Финал» — это смена статуса, а не замена
153
+ * объекта сообщения.
154
+ */
155
+ status?: MessageStatus;
107
156
  }
@@ -130,12 +130,12 @@ export declare const packAgentProvideSchema: z.ZodObject<{
130
130
  description: z.ZodOptional<z.ZodString>;
131
131
  capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
132
132
  agentMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
133
- subagent: "subagent";
134
133
  system: "system";
134
+ subagent: "subagent";
135
135
  primary: "primary";
136
136
  }>, z.ZodArray<z.ZodEnum<{
137
- subagent: "subagent";
138
137
  system: "system";
138
+ subagent: "subagent";
139
139
  primary: "primary";
140
140
  }>>]>>;
141
141
  icon: z.ZodOptional<z.ZodString>;
@@ -582,12 +582,12 @@ export declare const packProvidesSchema: z.ZodObject<{
582
582
  description: z.ZodOptional<z.ZodString>;
583
583
  capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
584
584
  agentMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
585
- subagent: "subagent";
586
585
  system: "system";
586
+ subagent: "subagent";
587
587
  primary: "primary";
588
588
  }>, z.ZodArray<z.ZodEnum<{
589
- subagent: "subagent";
590
589
  system: "system";
590
+ subagent: "subagent";
591
591
  primary: "primary";
592
592
  }>>]>>;
593
593
  icon: z.ZodOptional<z.ZodString>;
@@ -806,12 +806,12 @@ export declare const packManifestSchema: z.ZodObject<{
806
806
  description: z.ZodOptional<z.ZodString>;
807
807
  capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
808
808
  agentMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
809
- subagent: "subagent";
810
809
  system: "system";
810
+ subagent: "subagent";
811
811
  primary: "primary";
812
812
  }>, z.ZodArray<z.ZodEnum<{
813
- subagent: "subagent";
814
813
  system: "system";
814
+ subagent: "subagent";
815
815
  primary: "primary";
816
816
  }>>]>>;
817
817
  icon: z.ZodOptional<z.ZodString>;
@@ -64,6 +64,32 @@ export interface PermissionDecision {
64
64
  reason: 'mode' | 'role' | 'dependency' | 'workspace' | 'storage';
65
65
  };
66
66
  }
67
+ /**
68
+ * Превью изменений в запросе подтверждения (ADR-029, аддитивно).
69
+ *
70
+ * Пользователь подтверждает запись — он должен видеть, ЧТО именно изменится,
71
+ * а не только сырые аргументы вызова. Превью — unified diff по файлам, которые
72
+ * тул собирается изменить.
73
+ *
74
+ * Поле **необязательное**: превью считается «по возможности» — бинарный или
75
+ * слишком большой файл, сбой расчёта → превью просто отсутствует, а запрос
76
+ * подтверждения работает как прежде.
77
+ */
78
+ export interface PermissionPreviewFile {
79
+ /** Путь файла (как его ввёл агент). */
80
+ path: string;
81
+ /** Unified diff: строки `+` (добавлено), `-` (удалено), пробел (контекст). */
82
+ diff: string;
83
+ /** Сколько строк добавлено. */
84
+ additions: number;
85
+ /** Сколько строк удалено. */
86
+ deletions: number;
87
+ }
88
+ /** Превью изменений по всем файлам запроса подтверждения. */
89
+ export interface PermissionPreview {
90
+ /** Изменяемые файлы (по одному на файл). */
91
+ files: PermissionPreviewFile[];
92
+ }
67
93
  /**
68
94
  * Доступность MCP-инструмента по режимам сессии (plan / act).
69
95
  * Используется в настройках сессии: mcpToolSettings[serverName].tools[toolName]
@@ -296,9 +296,9 @@ export type PipelineSpec = z.infer<typeof pipelineSpecSchema>;
296
296
  export declare const pipelineRunTriggerSchema: z.ZodObject<{
297
297
  kind: z.ZodEnum<{
298
298
  user: "user";
299
+ manual: "manual";
299
300
  tool: "tool";
300
301
  schedule: "schedule";
301
- manual: "manual";
302
302
  gateway: "gateway";
303
303
  webhook: "webhook";
304
304
  }>;
@@ -375,9 +375,9 @@ export declare const pipelineRunSchema: z.ZodObject<{
375
375
  trigger: z.ZodOptional<z.ZodObject<{
376
376
  kind: z.ZodEnum<{
377
377
  user: "user";
378
+ manual: "manual";
378
379
  tool: "tool";
379
380
  schedule: "schedule";
380
- manual: "manual";
381
381
  gateway: "gateway";
382
382
  webhook: "webhook";
383
383
  }>;