@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
|
@@ -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
|
+
}
|
package/dist/types/message.d.ts
CHANGED
|
@@ -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
|
}
|
package/dist/types/pack.d.ts
CHANGED
|
@@ -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
|
}>;
|