@itphx/synth-shared 0.12.4 → 0.13.8
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 +125 -5
- package/dist/config/env-overrides.d.ts +23 -4
- package/dist/config/env-overrides.js +103 -4
- package/dist/config/index.d.ts +1 -0
- package/dist/config/index.js +1 -0
- package/dist/config/loader.d.ts +8 -0
- package/dist/config/loader.js +6 -1
- package/dist/config/redact.d.ts +22 -0
- package/dist/config/redact.js +53 -0
- package/dist/config/resolve.d.ts +17 -0
- package/dist/config/resolve.js +40 -1
- package/dist/config/tls.d.ts +7 -4
- package/dist/config/tls.js +10 -23
- package/dist/config/types.d.ts +496 -11
- package/dist/config/types.js +348 -6
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +317 -3
- package/dist/index.d.ts +4 -4
- package/dist/index.js +4 -4
- package/dist/model-metadata.d.ts +10 -0
- package/dist/model-metadata.js +10 -0
- package/dist/schemas/index.d.ts +378 -21
- package/dist/schemas/index.js +282 -5
- package/dist/types/agent.d.ts +8 -1
- package/dist/types/bus-events.d.ts +60 -2
- package/dist/types/egress.d.ts +2 -2
- package/dist/types/egress.js +2 -2
- 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 +88 -0
- package/dist/types/git.js +101 -1
- package/dist/types/host-pattern.d.ts +41 -0
- package/dist/types/host-pattern.js +143 -0
- package/dist/types/index.d.ts +4 -0
- package/dist/types/index.js +13 -1
- package/dist/types/llm.d.ts +95 -0
- package/dist/types/llm.js +58 -0
- package/dist/types/maintenance.d.ts +1 -1
- package/dist/types/mcp.d.ts +90 -0
- package/dist/types/mcp.js +11 -0
- package/dist/types/message-stream.d.ts +389 -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 +39 -3
- package/dist/types/pipeline-engine.d.ts +2 -2
- package/dist/types/project.d.ts +30 -0
- package/dist/types/project.js +16 -0
- package/dist/types/prompt.d.ts +4 -2
- package/dist/types/provider.d.ts +280 -0
- package/dist/types/provider.js +289 -0
- package/dist/types/service-keys.d.ts +6 -3
- package/dist/types/service-keys.js +6 -1
- package/dist/types/session.d.ts +178 -3
- package/dist/types/skills.d.ts +6 -0
- package/dist/types/tools.d.ts +57 -0
- package/dist/types/tools.js +49 -1
- package/dist/types/user.d.ts +7 -0
- package/dist/types/worktree.d.ts +1 -1
- package/dist/utils/index.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 +4 -3
package/dist/types/provider.js
CHANGED
|
@@ -33,3 +33,292 @@ export function hasPriceInput(body) {
|
|
|
33
33
|
|| 'cache_read_price' in b || 'cacheReadPrice' in b
|
|
34
34
|
|| 'cache_write_price' in b || 'cacheWritePrice' in b;
|
|
35
35
|
}
|
|
36
|
+
/** Канонические значения `cacheFormat` (для валидации входных данных API). */
|
|
37
|
+
export const CACHE_FORMATS = ['anthropic', 'alibaba'];
|
|
38
|
+
/** Проверка, что значение — допустимый формат inline-маркеров кэша. */
|
|
39
|
+
export function isCacheFormat(value) {
|
|
40
|
+
return typeof value === 'string' && CACHE_FORMATS.includes(value);
|
|
41
|
+
}
|
|
42
|
+
/** Канонический набор нативных аудио-форматов (для валидации и UI). */
|
|
43
|
+
export const NATIVE_AUDIO_FORMATS = ['wav', 'mp3', 'ogg'];
|
|
44
|
+
/** Ключи контракта — для валидации входных данных API. */
|
|
45
|
+
export const MODEL_COMPATIBILITY_KEYS = [
|
|
46
|
+
'reasoningField',
|
|
47
|
+
'requireReasoning',
|
|
48
|
+
'maxTokensField',
|
|
49
|
+
'requireAssistantAfterTool',
|
|
50
|
+
'streamUsage',
|
|
51
|
+
'supportsToolChoice',
|
|
52
|
+
'cacheFormat',
|
|
53
|
+
'requireFinishReason',
|
|
54
|
+
'supportsEffortUpdates',
|
|
55
|
+
'supportsNativeVideo',
|
|
56
|
+
'nativeAudioFormats',
|
|
57
|
+
];
|
|
58
|
+
/**
|
|
59
|
+
* RouterAI — прокси с расширениями протоколов (нативное аудио/видео).
|
|
60
|
+
*
|
|
61
|
+
* Единственный носитель host-знания в слое совместимости: **эвристика**
|
|
62
|
+
* умолчания для `supportsNativeVideo`/`nativeAudioFormats`. Сами значения
|
|
63
|
+
* приходят данными (`compatibility`) — этот предикат лишь задаёт дефолт,
|
|
64
|
+
* который любая запись каталога перекрывает явно (ADR-117).
|
|
65
|
+
*
|
|
66
|
+
* Функция чистая (только строка) — `node:*` в shared не тащим.
|
|
67
|
+
*/
|
|
68
|
+
export function isRouterAiUrl(url) {
|
|
69
|
+
try {
|
|
70
|
+
const host = new URL(url).hostname.toLowerCase();
|
|
71
|
+
return host === 'routerai.ru' || host.endsWith('.routerai.ru');
|
|
72
|
+
}
|
|
73
|
+
catch {
|
|
74
|
+
return false;
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* Нативный аудио-контейнер по MIME (ADR-115): `wav`/`mp3`/`ogg`.
|
|
79
|
+
* Прочие MIME (в т.ч. не-аудио) → `null`.
|
|
80
|
+
*/
|
|
81
|
+
export function nativeAudioFormatForMime(mime) {
|
|
82
|
+
const normalized = (mime ?? '').toLowerCase().split(';')[0].trim();
|
|
83
|
+
if (normalized === 'audio/wav' || normalized === 'audio/x-wav' || normalized === 'audio/wave')
|
|
84
|
+
return 'wav';
|
|
85
|
+
if (normalized === 'audio/mpeg' || normalized === 'audio/mp3')
|
|
86
|
+
return 'mp3';
|
|
87
|
+
if (normalized === 'audio/ogg' || normalized === 'audio/opus' || normalized === 'audio/oga')
|
|
88
|
+
return 'ogg';
|
|
89
|
+
return null;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Эвристики совместимости — те же, что в opencode
|
|
93
|
+
* (`packages/ai/src/protocols/openai-chat.ts`):
|
|
94
|
+
*
|
|
95
|
+
* - `requireReasoning`: тип/имя провайдера `deepseek`, URL ~ `deepseek.com`,
|
|
96
|
+
* модель ~ `deepseek`; провайдер `minimax` или URL ~ `minimax`
|
|
97
|
+
* (adaptive thinking у MiniMax идёт в тот же бюджет вывода);
|
|
98
|
+
* - `requireAssistantAfterTool`: Mistral-семейство (`mistral`, `devstral`,
|
|
99
|
+
* `codestral`, `pixtral`, `mixtral`);
|
|
100
|
+
* - `supportsToolChoice`: `false` для нативного Ollama (`type: 'ollama'`).
|
|
101
|
+
*
|
|
102
|
+
* `maxTokensField` намеренно **не** эвристируется: наш дефолт — `max_tokens`,
|
|
103
|
+
* `max_completion_tokens` только при явном значении (локальные серверы).
|
|
104
|
+
*
|
|
105
|
+
* **Нативные медиа (ADR-115 × ADR-117).** Матрица «тип провайдера ×
|
|
106
|
+
* RouterAI-совместимый хост» — дефолт для `nativeAudioFormats`/
|
|
107
|
+
* `supportsNativeVideo`:
|
|
108
|
+
*
|
|
109
|
+
* | тип | RouterAI | nativeAudioFormats | supportsNativeVideo |
|
|
110
|
+
* |--------------|----------|--------------------|---------------------|
|
|
111
|
+
* | openai/generic| да | wav, mp3, ogg | `true` |
|
|
112
|
+
* | openai/generic| нет | wav, mp3 | `false` |
|
|
113
|
+
* | anthropic | да | wav | `false` |
|
|
114
|
+
* | anthropic | нет | — | `false` |
|
|
115
|
+
* | прочие | любой | — | `false` |
|
|
116
|
+
*
|
|
117
|
+
* Основание — прежнее поведение по хосту: `anthropic` принимает аудио только в
|
|
118
|
+
* `wav` и только у RouterAI (Anthropic-совместимый шлюз на ogg/mp3 отвечает 200,
|
|
119
|
+
* но модель аудио не слышит — такие форматы идут через aux-модель); OpenAI-протокол
|
|
120
|
+
* принимает wav/mp3 всегда, ogg — расширение RouterAI; блок `video_url` знает
|
|
121
|
+
* только RouterAI-совместимый OpenAI-протокол.
|
|
122
|
+
*
|
|
123
|
+
* Живой тест 2026-11-03: не-routerai прокси `itphx`
|
|
124
|
+
* (`https://ai.itphx.ru/api/`) нативное видео **умеет** — старый предикат по
|
|
125
|
+
* хосту давал ложноотрицательный ответ. Отсюда правило: дефолт по хосту —
|
|
126
|
+
* лишь эвристика, а решение принимают **данные** (`compatibility`), которыми
|
|
127
|
+
* провайдер/модель перекрывают эвристику явно.
|
|
128
|
+
*/
|
|
129
|
+
export function detectCompatibilityHeuristics(context) {
|
|
130
|
+
const type = (context.providerType ?? '').toLowerCase();
|
|
131
|
+
const name = (context.providerName ?? '').toLowerCase();
|
|
132
|
+
const url = (context.baseUrl ?? '').toLowerCase();
|
|
133
|
+
const model = (context.modelId ?? '').toLowerCase();
|
|
134
|
+
const requireReasoning = type === 'deepseek'
|
|
135
|
+
|| name === 'deepseek'
|
|
136
|
+
|| url.includes('deepseek.com')
|
|
137
|
+
|| model.includes('deepseek')
|
|
138
|
+
// MiniMax: adaptive thinking включён на стороне модели и расходует тот же
|
|
139
|
+
// `max_tokens` — без запаса вывода ответ приходит пустым. Определяем по
|
|
140
|
+
// провайдеру/URL, а не по модели: имя `minimax` носят сторонние видео-модели.
|
|
141
|
+
|| name === 'minimax'
|
|
142
|
+
|| url.includes('minimax');
|
|
143
|
+
const mistral = ['mistral', 'devstral', 'codestral', 'pixtral', 'mixtral']
|
|
144
|
+
.some((family) => model.includes(family));
|
|
145
|
+
// ADR-115: нативные медиа — дефолт по типу протокола и RouterAI-совместимому
|
|
146
|
+
// хосту (см. матрицу в докстринге). Явные значения `compatibility` перекрывают.
|
|
147
|
+
const routerAi = isRouterAiUrl(context.baseUrl ?? '');
|
|
148
|
+
const openAiLike = type === 'openai' || type === 'generic';
|
|
149
|
+
const nativeAudioFormats = openAiLike
|
|
150
|
+
? (routerAi ? ['wav', 'mp3', 'ogg'] : ['wav', 'mp3'])
|
|
151
|
+
: type === 'anthropic'
|
|
152
|
+
? (routerAi ? ['wav'] : [])
|
|
153
|
+
: [];
|
|
154
|
+
const supportsNativeVideo = openAiLike && routerAi;
|
|
155
|
+
return {
|
|
156
|
+
requireReasoning,
|
|
157
|
+
requireAssistantAfterTool: mistral,
|
|
158
|
+
supportsToolChoice: type !== 'ollama',
|
|
159
|
+
nativeAudioFormats,
|
|
160
|
+
supportsNativeVideo,
|
|
161
|
+
};
|
|
162
|
+
}
|
|
163
|
+
/**
|
|
164
|
+
* Наложение слоёв совместимости: `undefined`-поля не перетирают значение.
|
|
165
|
+
* Поздние слои приоритетнее (провайдер → shorthand → модель).
|
|
166
|
+
*/
|
|
167
|
+
export function mergeModelCompatibility(...layers) {
|
|
168
|
+
const merged = {};
|
|
169
|
+
for (const layer of layers) {
|
|
170
|
+
if (!layer)
|
|
171
|
+
continue;
|
|
172
|
+
for (const [key, value] of Object.entries(layer)) {
|
|
173
|
+
if (value !== undefined)
|
|
174
|
+
merged[key] = value;
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
return merged;
|
|
178
|
+
}
|
|
179
|
+
/**
|
|
180
|
+
* Разрешение итоговой совместимости.
|
|
181
|
+
*
|
|
182
|
+
* Порядок: **явное значение модели → явное значение провайдера → эвристика →
|
|
183
|
+
* встроенный дефолт**. `reasoningField`, заданный явно на любом уровне, сам по
|
|
184
|
+
* себе означает `requireReasoning: true` (как в opencode) — если
|
|
185
|
+
* `requireReasoning` не переопределён явно (в т.ч. `false`).
|
|
186
|
+
*/
|
|
187
|
+
export function resolveModelCompatibility(providerCompat, modelCompat, heuristics = {}) {
|
|
188
|
+
const explicitReasoningField = modelCompat?.reasoningField ?? providerCompat?.reasoningField;
|
|
189
|
+
const explicitRequireReasoning = modelCompat?.requireReasoning ?? providerCompat?.requireReasoning;
|
|
190
|
+
const requireReasoning = explicitRequireReasoning
|
|
191
|
+
?? (explicitReasoningField !== undefined ? true : (heuristics.requireReasoning ?? false));
|
|
192
|
+
return {
|
|
193
|
+
reasoningField: explicitReasoningField ?? heuristics.reasoningField ?? 'reasoning_content',
|
|
194
|
+
requireReasoning,
|
|
195
|
+
maxTokensField: modelCompat?.maxTokensField
|
|
196
|
+
?? providerCompat?.maxTokensField
|
|
197
|
+
?? heuristics.maxTokensField
|
|
198
|
+
?? 'max_tokens',
|
|
199
|
+
requireAssistantAfterTool: modelCompat?.requireAssistantAfterTool
|
|
200
|
+
?? providerCompat?.requireAssistantAfterTool
|
|
201
|
+
?? heuristics.requireAssistantAfterTool
|
|
202
|
+
?? false,
|
|
203
|
+
streamUsage: modelCompat?.streamUsage
|
|
204
|
+
?? providerCompat?.streamUsage
|
|
205
|
+
?? heuristics.streamUsage
|
|
206
|
+
?? true,
|
|
207
|
+
supportsToolChoice: modelCompat?.supportsToolChoice
|
|
208
|
+
?? providerCompat?.supportsToolChoice
|
|
209
|
+
?? heuristics.supportsToolChoice
|
|
210
|
+
?? true,
|
|
211
|
+
// Дефолт — `true` (как в opencode): стрим без `finish_reason` считается
|
|
212
|
+
// недописанным. Явный `false` возвращает толерантное поведение.
|
|
213
|
+
requireFinishReason: modelCompat?.requireFinishReason
|
|
214
|
+
?? providerCompat?.requireFinishReason
|
|
215
|
+
?? heuristics.requireFinishReason
|
|
216
|
+
?? true,
|
|
217
|
+
// Effort-режим Anthropic — только явным значением (без авто-эвристики):
|
|
218
|
+
// включение меняет тело запроса (output_config вместо thinking), и
|
|
219
|
+
// угадывание по модели сломало бы шлюзы без поддержки поля.
|
|
220
|
+
supportsEffortUpdates: modelCompat?.supportsEffortUpdates
|
|
221
|
+
?? providerCompat?.supportsEffortUpdates
|
|
222
|
+
?? heuristics.supportsEffortUpdates
|
|
223
|
+
?? false,
|
|
224
|
+
// Inline-маркеры кэша — только явным значением: эвристики по типу
|
|
225
|
+
// провайдера не ставятся, иначе менялось бы поведение существующих записей.
|
|
226
|
+
cacheFormat: modelCompat?.cacheFormat ?? providerCompat?.cacheFormat ?? heuristics.cacheFormat,
|
|
227
|
+
// ADR-115: нативные медиа — тот же порядок «модель → провайдер → эвристика».
|
|
228
|
+
// Важно: `??` не схлопывает пустой массив (`[]` — не null/undefined), поэтому
|
|
229
|
+
// явный пустой перечень форматов перекрывает эвристику («ни одного»).
|
|
230
|
+
nativeAudioFormats: modelCompat?.nativeAudioFormats
|
|
231
|
+
?? providerCompat?.nativeAudioFormats
|
|
232
|
+
?? heuristics.nativeAudioFormats
|
|
233
|
+
?? [],
|
|
234
|
+
supportsNativeVideo: modelCompat?.supportsNativeVideo
|
|
235
|
+
?? providerCompat?.supportsNativeVideo
|
|
236
|
+
?? heuristics.supportsNativeVideo
|
|
237
|
+
?? false,
|
|
238
|
+
};
|
|
239
|
+
}
|
|
240
|
+
/**
|
|
241
|
+
* Строгий разбор `compatibility` из тела API. Семантика — **замена**:
|
|
242
|
+
* - `undefined` — поле не передано (сохранить existing);
|
|
243
|
+
* - `null` — явно сбросить;
|
|
244
|
+
* - объект — **заменить** значение целиком (UI присылает полный объект из
|
|
245
|
+
* черновика, поэтому отсутствующее в объекте поле означает «авто», а не
|
|
246
|
+
* «оставить как было»); пустой объект равнозначен сбросу;
|
|
247
|
+
* - неизвестные поля и значения неверного типа — ошибка (не терять опечатки
|
|
248
|
+
* молча); иное — ошибка.
|
|
249
|
+
*/
|
|
250
|
+
export function parseModelCompatibilityInput(raw, existing) {
|
|
251
|
+
if (raw === undefined)
|
|
252
|
+
return { ok: true, value: existing };
|
|
253
|
+
if (raw === null)
|
|
254
|
+
return { ok: true, value: undefined };
|
|
255
|
+
if (typeof raw !== 'object' || Array.isArray(raw)) {
|
|
256
|
+
return { ok: false, reason: 'compatibility должен быть объектом или null' };
|
|
257
|
+
}
|
|
258
|
+
const input = raw;
|
|
259
|
+
for (const key of Object.keys(input)) {
|
|
260
|
+
if (!MODEL_COMPATIBILITY_KEYS.includes(key)) {
|
|
261
|
+
return { ok: false, reason: `compatibility: неизвестное поле «${key}»` };
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
// Присланный объект — полное новое значение: прежние поля не наследуются.
|
|
265
|
+
const replaced = {};
|
|
266
|
+
if ('reasoningField' in input) {
|
|
267
|
+
const value = input.reasoningField;
|
|
268
|
+
if (typeof value !== 'string' || value.trim() === '') {
|
|
269
|
+
return { ok: false, reason: 'compatibility.reasoningField должен быть непустой строкой' };
|
|
270
|
+
}
|
|
271
|
+
replaced.reasoningField = value.trim();
|
|
272
|
+
}
|
|
273
|
+
if ('maxTokensField' in input) {
|
|
274
|
+
const value = input.maxTokensField;
|
|
275
|
+
if (value !== 'max_tokens' && value !== 'max_completion_tokens') {
|
|
276
|
+
return { ok: false, reason: 'compatibility.maxTokensField должен быть max_tokens или max_completion_tokens' };
|
|
277
|
+
}
|
|
278
|
+
replaced.maxTokensField = value;
|
|
279
|
+
}
|
|
280
|
+
if ('cacheFormat' in input) {
|
|
281
|
+
const value = input.cacheFormat;
|
|
282
|
+
if (!isCacheFormat(value)) {
|
|
283
|
+
return { ok: false, reason: 'compatibility.cacheFormat должен быть anthropic или alibaba' };
|
|
284
|
+
}
|
|
285
|
+
replaced.cacheFormat = value;
|
|
286
|
+
}
|
|
287
|
+
for (const key of [
|
|
288
|
+
'requireReasoning',
|
|
289
|
+
'requireAssistantAfterTool',
|
|
290
|
+
'streamUsage',
|
|
291
|
+
'supportsToolChoice',
|
|
292
|
+
'requireFinishReason',
|
|
293
|
+
'supportsEffortUpdates',
|
|
294
|
+
'supportsNativeVideo',
|
|
295
|
+
]) {
|
|
296
|
+
if (!(key in input))
|
|
297
|
+
continue;
|
|
298
|
+
const value = input[key];
|
|
299
|
+
if (typeof value !== 'boolean') {
|
|
300
|
+
return { ok: false, reason: `compatibility.${key} должен быть boolean` };
|
|
301
|
+
}
|
|
302
|
+
replaced[key] = value;
|
|
303
|
+
}
|
|
304
|
+
if ('nativeAudioFormats' in input) {
|
|
305
|
+
const value = input.nativeAudioFormats;
|
|
306
|
+
if (!Array.isArray(value)) {
|
|
307
|
+
return { ok: false, reason: 'compatibility.nativeAudioFormats должен быть массивом' };
|
|
308
|
+
}
|
|
309
|
+
const formats = [];
|
|
310
|
+
for (const item of value) {
|
|
311
|
+
if (typeof item !== 'string' || !NATIVE_AUDIO_FORMATS.includes(item)) {
|
|
312
|
+
return {
|
|
313
|
+
ok: false,
|
|
314
|
+
reason: `compatibility.nativeAudioFormats: неизвестный формат «${String(item)}» (допустимы ${NATIVE_AUDIO_FORMATS.join(', ')})`,
|
|
315
|
+
};
|
|
316
|
+
}
|
|
317
|
+
if (!formats.includes(item))
|
|
318
|
+
formats.push(item);
|
|
319
|
+
}
|
|
320
|
+
// Пустой массив — валидное явное значение («ни одного формата»).
|
|
321
|
+
replaced.nativeAudioFormats = formats;
|
|
322
|
+
}
|
|
323
|
+
return { ok: true, value: Object.keys(replaced).length > 0 ? replaced : undefined };
|
|
324
|
+
}
|
|
@@ -14,7 +14,7 @@ import type { GlobalRole } from './index.js';
|
|
|
14
14
|
* не вводится намеренно — иначе он молча покрывал бы будущие `automation:*`-скоупы
|
|
15
15
|
* (напр. запуск/удаление), не связанные с установкой пакета.
|
|
16
16
|
*/
|
|
17
|
-
export declare const SERVICE_SCOPE_FAMILIES: readonly ["events", "bindings", "keys", "routes", "sessions", "schedules"];
|
|
17
|
+
export declare const SERVICE_SCOPE_FAMILIES: readonly ["events", "bindings", "keys", "routes", "sessions", "schedules", "mcp"];
|
|
18
18
|
export type ServiceScopeFamily = (typeof SERVICE_SCOPE_FAMILIES)[number];
|
|
19
19
|
/**
|
|
20
20
|
* Каталог скоупов service-key (ADR-052; `docs/API_V2.md` §1).
|
|
@@ -31,9 +31,12 @@ export type ServiceScopeFamily = (typeof SERVICE_SCOPE_FAMILIES)[number];
|
|
|
31
31
|
* (консент-сервисы аддонов);
|
|
32
32
|
* - `plugins:invoke` — server-scoped токен плагина (ADR-090 Ф7, Уровень 2):
|
|
33
33
|
* ключ, привязанный к `plugin_id`; без этого scope сервер отвергает такой
|
|
34
|
-
* ключ (fail-closed)
|
|
34
|
+
* ключ (fail-closed);
|
|
35
|
+
* - `mcp:invoke` — вызов серверных MCP-серверов из гибрида (PROP-125):
|
|
36
|
+
* удалённый вызов инструмента серверного MCP-сервера; интерактивный
|
|
37
|
+
* пользователь гибрида авторизуется `requireAuth` (ADR-043).
|
|
35
38
|
*/
|
|
36
|
-
export declare const SERVICE_SCOPES: readonly ["events:ingest", "events:watch", "bindings:read", "bindings:write", "keys:read", "keys:write", "routes:read", "routes:write", "sessions:create", "sessions:read", "sessions:prompt", "schedules:read", "schedules:write", "llm:chat", "addons:install", "automation:install", "users:read", "plugins:invoke"];
|
|
39
|
+
export declare const SERVICE_SCOPES: readonly ["events:ingest", "events:watch", "bindings:read", "bindings:write", "keys:read", "keys:write", "routes:read", "routes:write", "sessions:create", "sessions:read", "sessions:prompt", "schedules:read", "schedules:write", "llm:chat", "addons:install", "automation:install", "users:read", "plugins:invoke", "mcp:invoke"];
|
|
37
40
|
export type ServiceScope = (typeof SERVICE_SCOPES)[number];
|
|
38
41
|
/**
|
|
39
42
|
* ADR-052: «любой из»-наборы скоупов для гейтов, где зонтичный
|
|
@@ -14,6 +14,7 @@ export const SERVICE_SCOPE_FAMILIES = [
|
|
|
14
14
|
'routes',
|
|
15
15
|
'sessions',
|
|
16
16
|
'schedules',
|
|
17
|
+
'mcp',
|
|
17
18
|
];
|
|
18
19
|
/**
|
|
19
20
|
* Каталог скоупов service-key (ADR-052; `docs/API_V2.md` §1).
|
|
@@ -30,7 +31,10 @@ export const SERVICE_SCOPE_FAMILIES = [
|
|
|
30
31
|
* (консент-сервисы аддонов);
|
|
31
32
|
* - `plugins:invoke` — server-scoped токен плагина (ADR-090 Ф7, Уровень 2):
|
|
32
33
|
* ключ, привязанный к `plugin_id`; без этого scope сервер отвергает такой
|
|
33
|
-
* ключ (fail-closed)
|
|
34
|
+
* ключ (fail-closed);
|
|
35
|
+
* - `mcp:invoke` — вызов серверных MCP-серверов из гибрида (PROP-125):
|
|
36
|
+
* удалённый вызов инструмента серверного MCP-сервера; интерактивный
|
|
37
|
+
* пользователь гибрида авторизуется `requireAuth` (ADR-043).
|
|
34
38
|
*/
|
|
35
39
|
export const SERVICE_SCOPES = [
|
|
36
40
|
'events:ingest',
|
|
@@ -51,6 +55,7 @@ export const SERVICE_SCOPES = [
|
|
|
51
55
|
'automation:install',
|
|
52
56
|
'users:read',
|
|
53
57
|
'plugins:invoke',
|
|
58
|
+
'mcp:invoke',
|
|
54
59
|
];
|
|
55
60
|
/**
|
|
56
61
|
* ADR-052: «любой из»-наборы скоупов для гейтов, где зонтичный
|
package/dist/types/session.d.ts
CHANGED
|
@@ -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
|
-
|
|
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
|
-
|
|
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;
|
|
@@ -260,6 +422,14 @@ export interface Session {
|
|
|
260
422
|
userId?: string;
|
|
261
423
|
ownerId?: string;
|
|
262
424
|
projectId?: string;
|
|
425
|
+
/**
|
|
426
|
+
* Маркер источника при переносе между инстансами (publish/import): id сессии
|
|
427
|
+
* в исходном мире. Используется как **ключ дедупликации повторного импорта** —
|
|
428
|
+
* повторная загрузка той же сессии в тот же проект обновляет существующую
|
|
429
|
+
* запись, а не создаёт дубль. Поле аддитивное: у сессий, созданных локально
|
|
430
|
+
* (и у записей до появления поля), оно отсутствует.
|
|
431
|
+
*/
|
|
432
|
+
sourceSessionId?: string;
|
|
263
433
|
/**
|
|
264
434
|
* ADR-114: привязка сессии к git-worktree — рабочий каталог сессии.
|
|
265
435
|
* Аддитивное поле: сессии, созданные до ADR-114, его не имеют и работают
|
|
@@ -288,6 +458,11 @@ export interface Session {
|
|
|
288
458
|
stickyNotes: StickyNote[];
|
|
289
459
|
references: SessionReference[];
|
|
290
460
|
currentStream?: StreamInfo;
|
|
461
|
+
/**
|
|
462
|
+
* Состояние ретрая сессии (персистентное) — см. `SessionRetryState`.
|
|
463
|
+
* Поле аддитивное: его отсутствие = «ретрая нет».
|
|
464
|
+
*/
|
|
465
|
+
retry?: SessionRetryState;
|
|
291
466
|
summarizationPending: boolean;
|
|
292
467
|
canSummarize: boolean;
|
|
293
468
|
createdAt: string;
|
package/dist/types/skills.d.ts
CHANGED
|
@@ -111,6 +111,12 @@ export interface SkillSummary {
|
|
|
111
111
|
*/
|
|
112
112
|
available: boolean;
|
|
113
113
|
unavailableReason?: 'capabilities';
|
|
114
|
+
/**
|
|
115
|
+
* Каких именно capabilities не хватает (`available: false`, причина
|
|
116
|
+
* `capabilities`). Аддитивно: используется UI для подсказки «Не хватает
|
|
117
|
+
* возможностей: …»; при доступном скилле поля нет.
|
|
118
|
+
*/
|
|
119
|
+
missingCapabilities?: string[];
|
|
114
120
|
}
|
|
115
121
|
/** Детали скилла (тело + supporting-файлы). */
|
|
116
122
|
export interface SkillDetail extends SkillSummary {
|