@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.
Files changed (67) hide show
  1. package/dist/config/defaults.js +125 -5
  2. package/dist/config/env-overrides.d.ts +23 -4
  3. package/dist/config/env-overrides.js +103 -4
  4. package/dist/config/index.d.ts +1 -0
  5. package/dist/config/index.js +1 -0
  6. package/dist/config/loader.d.ts +8 -0
  7. package/dist/config/loader.js +6 -1
  8. package/dist/config/redact.d.ts +22 -0
  9. package/dist/config/redact.js +53 -0
  10. package/dist/config/resolve.d.ts +17 -0
  11. package/dist/config/resolve.js +40 -1
  12. package/dist/config/tls.d.ts +7 -4
  13. package/dist/config/tls.js +10 -23
  14. package/dist/config/types.d.ts +496 -11
  15. package/dist/config/types.js +348 -6
  16. package/dist/i18n/index.d.ts +1 -1
  17. package/dist/i18n/index.js +317 -3
  18. package/dist/index.d.ts +4 -4
  19. package/dist/index.js +4 -4
  20. package/dist/model-metadata.d.ts +10 -0
  21. package/dist/model-metadata.js +10 -0
  22. package/dist/schemas/index.d.ts +378 -21
  23. package/dist/schemas/index.js +282 -5
  24. package/dist/types/agent.d.ts +8 -1
  25. package/dist/types/bus-events.d.ts +60 -2
  26. package/dist/types/egress.d.ts +2 -2
  27. package/dist/types/egress.js +2 -2
  28. package/dist/types/file-kind.d.ts +40 -0
  29. package/dist/types/file-kind.js +157 -0
  30. package/dist/types/fs.d.ts +54 -1
  31. package/dist/types/fs.js +43 -0
  32. package/dist/types/git.d.ts +88 -0
  33. package/dist/types/git.js +101 -1
  34. package/dist/types/host-pattern.d.ts +41 -0
  35. package/dist/types/host-pattern.js +143 -0
  36. package/dist/types/index.d.ts +4 -0
  37. package/dist/types/index.js +13 -1
  38. package/dist/types/llm.d.ts +95 -0
  39. package/dist/types/llm.js +58 -0
  40. package/dist/types/maintenance.d.ts +1 -1
  41. package/dist/types/mcp.d.ts +90 -0
  42. package/dist/types/mcp.js +11 -0
  43. package/dist/types/message-stream.d.ts +389 -0
  44. package/dist/types/message-stream.js +41 -0
  45. package/dist/types/message.d.ts +49 -0
  46. package/dist/types/pack.d.ts +6 -6
  47. package/dist/types/permission.d.ts +39 -3
  48. package/dist/types/pipeline-engine.d.ts +2 -2
  49. package/dist/types/project.d.ts +30 -0
  50. package/dist/types/project.js +16 -0
  51. package/dist/types/prompt.d.ts +4 -2
  52. package/dist/types/provider.d.ts +280 -0
  53. package/dist/types/provider.js +289 -0
  54. package/dist/types/service-keys.d.ts +6 -3
  55. package/dist/types/service-keys.js +6 -1
  56. package/dist/types/session.d.ts +178 -3
  57. package/dist/types/skills.d.ts +6 -0
  58. package/dist/types/tools.d.ts +57 -0
  59. package/dist/types/tools.js +49 -1
  60. package/dist/types/user.d.ts +7 -0
  61. package/dist/types/worktree.d.ts +1 -1
  62. package/dist/utils/index.js +1 -1
  63. package/dist/utils/reasoning.d.ts +18 -2
  64. package/dist/utils/reasoning.js +16 -7
  65. package/dist/version.d.ts +1 -1
  66. package/dist/version.js +1 -1
  67. package/package.json +4 -3
@@ -22,7 +22,31 @@ export interface ProjectLogEntry {
22
22
  createdAt: string;
23
23
  sessionId?: string;
24
24
  author?: string;
25
+ /**
26
+ * PROP-054: аддитивные поля правки записи журнала — кто и когда изменил
27
+ * текст. Старые записи их не имеют (необязательные).
28
+ */
29
+ updatedAt?: string;
30
+ updatedBy?: string;
25
31
  }
32
+ /**
33
+ * PROP-054: лимиты Markdown-полей проекта/сессии (в **байтах**).
34
+ *
35
+ * Единый источник истины для HTTP-роутов и инструментов: превышение →
36
+ * `400 VALIDATION_ERROR`. Значения:
37
+ * - `invariants` — 64 КиБ (инварианты попадают в системный промпт);
38
+ * - `journalEntry` — 16 КиБ (запись журнала проекта);
39
+ * - `planDescription` — 16 КиБ (описание пункта плана);
40
+ * - `todoContent` — 4 КиБ (текст пункта ToDo сессии).
41
+ */
42
+ export declare const MARKDOWN_LIMITS: {
43
+ readonly invariants: number;
44
+ readonly journalEntry: number;
45
+ readonly planDescription: number;
46
+ readonly todoContent: number;
47
+ };
48
+ /** Имя поля Markdown-лимита (ключ `MARKDOWN_LIMITS`). */
49
+ export type MarkdownLimitKey = keyof typeof MARKDOWN_LIMITS;
26
50
  /**
27
51
  * ADR-071 §2.4/§2.5: проектный скоуп MCP — ссылки на записи единого реестра по
28
52
  * имени.
@@ -35,6 +59,12 @@ export interface ProjectLogEntry {
35
59
  export interface ProjectMcpSettings {
36
60
  enabled: string[];
37
61
  defaultOn: string[];
62
+ /**
63
+ * PROP-125: имена серверных MCP-дефолтов, уже применённых к проекту при
64
+ * подключении гибрида (идемпотентный авто-сид). Выключенный пользователем
65
+ * сервер повторно не добавляется.
66
+ */
67
+ remoteSeeded?: string[];
38
68
  }
39
69
  /**
40
70
  * ADR-046 §4.5: проектный скоуп скиллов (owner/lead) — аналог `ProjectMcpSettings`.
@@ -12,6 +12,22 @@ export var StatusMessageType;
12
12
  StatusMessageType["ERROR"] = "error";
13
13
  StatusMessageType["STREAM"] = "stream";
14
14
  })(StatusMessageType || (StatusMessageType = {}));
15
+ /**
16
+ * PROP-054: лимиты Markdown-полей проекта/сессии (в **байтах**).
17
+ *
18
+ * Единый источник истины для HTTP-роутов и инструментов: превышение →
19
+ * `400 VALIDATION_ERROR`. Значения:
20
+ * - `invariants` — 64 КиБ (инварианты попадают в системный промпт);
21
+ * - `journalEntry` — 16 КиБ (запись журнала проекта);
22
+ * - `planDescription` — 16 КиБ (описание пункта плана);
23
+ * - `todoContent` — 4 КиБ (текст пункта ToDo сессии).
24
+ */
25
+ export const MARKDOWN_LIMITS = {
26
+ invariants: 64 * 1024,
27
+ journalEntry: 16 * 1024,
28
+ planDescription: 16 * 1024,
29
+ todoContent: 4 * 1024,
30
+ };
15
31
  /**
16
32
  * Канонические ключи иконок проектов и сессий (единый список для server и UI).
17
33
  * Значения — только ключи реестра (загружаемые картинки не поддерживаются).
@@ -152,9 +152,11 @@ export interface PromptToolDetail {
152
152
  * `admin_disabled` (жёстко отключён администратором через `tools.disabled`),
153
153
  * `dependency` (в окружении нет нужной программы — git/rg/sh),
154
154
  * `workspace` (не задан рабочий каталог проекта),
155
- * `storage` (хранилище недоступно — деградированный read-only режим, ADR-098).
155
+ * `storage` (хранилище недоступно — деградированный read-only режим, ADR-098),
156
+ * `policy` (политика инстанса запрещает тул в текущем режиме — PROP-124 §0:
157
+ * адресные ssh-тулы в режиме `ssh.mode = 'agent'`).
156
158
  */
157
- reason?: 'mode' | 'role' | 'admin_disabled' | 'dependency' | 'workspace' | 'storage';
159
+ reason?: 'mode' | 'role' | 'admin_disabled' | 'dependency' | 'workspace' | 'storage' | 'policy';
158
160
  /** ADR-071 §2.1: источник инструмента (`built-in` — слой `tools`). */
159
161
  source: 'built-in';
160
162
  /** ADR-071 §2.6: длина `JSON.stringify` LLM-определения тула (как слой `tools`). */
@@ -23,6 +23,266 @@ export type CurrencyInputResult = {
23
23
  export declare function parseCurrencyInput(raw: unknown, existing?: Currency): CurrencyInputResult;
24
24
  /** Присутствуют ли в теле запроса ценовые поля (snake_case или camelCase). */
25
25
  export declare function hasPriceInput(body: unknown): boolean;
26
+ /**
27
+ * Поле лимита вывода в теле запроса OpenAI-совместимого протокола.
28
+ *
29
+ * Наш дефолт — `max_tokens` (намеренное отличие от opencode, где дефолт
30
+ * `max_completion_tokens`): локальные и кастомные OpenAI-совместимые серверы
31
+ * часто не знают `max_completion_tokens`, и молчаливая смена дефолта ломала бы
32
+ * их. `max_completion_tokens` отправляется только при **явном** значении.
33
+ */
34
+ export type MaxTokensField = 'max_tokens' | 'max_completion_tokens';
35
+ /**
36
+ * Формат inline-маркеров prompt-cache в теле OpenAI-совместимого запроса
37
+ * (`cache_control: { type: 'ephemeral' }` на частях контента и на
38
+ * tool-дефинишнах) — аналог `cacheFormat` в opencode
39
+ * (`packages/ai/src/cache-policy.ts`).
40
+ *
41
+ * - `anthropic` — полный AUTO-набор: последний tool-дефинишн, system-блок и
42
+ * граница последнего сообщения (`tail: 1`);
43
+ * - `alibaba` — QWEN-набор: system-блок и граница последнего сообщения,
44
+ * **без** маркера на tools (Qwen кеширует tools вместе с system-промптом и
45
+ * игнорирует маркеры на дефинишнах).
46
+ *
47
+ * Не задан — inline-маркеры не ставятся, работает прежний механизм:
48
+ * implicit prefix caching через `prompt_cache_key`.
49
+ */
50
+ export type CacheFormat = 'anthropic' | 'alibaba';
51
+ /** Канонические значения `cacheFormat` (для валидации входных данных API). */
52
+ export declare const CACHE_FORMATS: readonly ["anthropic", "alibaba"];
53
+ /** Проверка, что значение — допустимый формат inline-маркеров кэша. */
54
+ export declare function isCacheFormat(value: unknown): value is CacheFormat;
55
+ /**
56
+ * Аудио-контейнеры, которые транспорт провайдера принимает **нативно**
57
+ * (блок `input_audio`/`audio` в теле запроса — без aux-модели и конвертации).
58
+ *
59
+ * ADR-115 × ADR-117: перечень приходит **данными** (`compatibility`), а не из
60
+ * URL провайдера. Значение по умолчанию — эвристика по типу/хосту, но любая
61
+ * запись каталога может перекрыть его явно.
62
+ */
63
+ export type NativeAudioFormat = 'wav' | 'mp3' | 'ogg';
64
+ /** Канонический набор нативных аудио-форматов (для валидации и UI). */
65
+ export declare const NATIVE_AUDIO_FORMATS: readonly ["wav", "mp3", "ogg"];
66
+ /**
67
+ * Явные особенности протокола провайдера/модели (аналог `Compatibility` в
68
+ * opencode, `packages/schema/src/model-compatibility.ts`).
69
+ *
70
+ * Один и тот же контракт объявлен на двух уровнях: `ProviderConfig.compatibility`
71
+ * (дефолты для всех моделей провайдера) и `ModelConfig.compatibility`
72
+ * (перекрывает провайдерские поля точечно).
73
+ */
74
+ export interface ModelCompatibility {
75
+ /**
76
+ * Имя поля reasoning в assistant-сообщениях openai-chat.
77
+ * По умолчанию `'reasoning_content'` (DeepSeek); OpenRouter/RouterAI — `'reasoning'`.
78
+ */
79
+ reasoningField?: string;
80
+ /**
81
+ * Требовать поле reasoning у **каждого** assistant-сообщения, даже пустым
82
+ * (thinking-режим DeepSeek: `reasoning_content` обязателен в истории).
83
+ */
84
+ requireReasoning?: boolean;
85
+ /** Поле лимита вывода: `max_tokens` (дефолт) | `max_completion_tokens` (только явно). */
86
+ maxTokensField?: MaxTokensField;
87
+ /** Провайдеру нужен assistant-турн после tool-результатов (Mistral-семейство). */
88
+ requireAssistantAfterTool?: boolean;
89
+ /**
90
+ * Отправлять `stream_options: {include_usage: true}` в стриме
91
+ * (OpenAI-совместимые). Дефолт `true` — как в opencode.
92
+ */
93
+ streamUsage?: boolean;
94
+ /**
95
+ * Провайдер понимает `tool_choice`. Дефолт `true`; для нативного Ollama
96
+ * `/api/chat` — `false` (эвристика по `type: 'ollama'`).
97
+ */
98
+ supportsToolChoice?: boolean;
99
+ /**
100
+ * Формат inline-маркеров prompt-cache (`cache_control`). Не задан — маркеры
101
+ * не ставятся, кэш работает через implicit prefix caching
102
+ * (`prompt_cache_key`). Задан — маркеры ставятся, а `prompt_cache_key` **не
103
+ * отправляется**: это разные механизмы, и провайдер, ориентированный на
104
+ * inline-маркеры, полагается только на них (как в opencode).
105
+ *
106
+ * Бюджет — не больше 4 breakpoint'ов на запрос (как `BREAKPOINT_CAP`).
107
+ */
108
+ cacheFormat?: CacheFormat;
109
+ /**
110
+ * Требовать `finish_reason` в стриме OpenAI-совместимого протокола.
111
+ * Дефолт **`true`** (как в opencode, `packages/ai/src/protocols/openai-chat.ts`):
112
+ * провайдер, закрывший стрим без `finish_reason`, — недописанный ответ
113
+ * (incomplete-stream). `false` — прежнее толерантное поведение (стрим
114
+ * считается завершённым).
115
+ */
116
+ requireFinishReason?: boolean;
117
+ /**
118
+ * Anthropic 5.x: модель принимает `output_config.effort` (тир усилия,
119
+ * `EffortLevel`). Включение — **только явным значением** (дефолт `false`,
120
+ * авто-эвристики нет): иначе существующие записи каталога начали бы слать
121
+ * поле шлюзам, которые его не знают. При `true` провайдер отправляет
122
+ * `output_config.effort` (из `ChatOptions.effort` либо из `reasoningLevel`)
123
+ * и **не** отправляет `thinking` — у effort-моделей это другой режим
124
+ * (ADR-117).
125
+ */
126
+ supportsEffortUpdates?: boolean;
127
+ /**
128
+ * ADR-115 × ADR-117: транспорт принимает **видеофайл** нативно (блок
129
+ * `video_url` в OpenAI-протоколе), без разбивки на кадры через aux-модель.
130
+ *
131
+ * Дефолт — эвристика по типу/хосту провайдера (RouterAI-совместимые шлюзы);
132
+ * явное `true`/`false` перекрывает её (в т.ч. для не-routerai прокси, который
133
+ * видео тоже понимает — например `itphx`, проверено живым тестом 2026-11-03).
134
+ */
135
+ supportsNativeVideo?: boolean;
136
+ /**
137
+ * ADR-115 × ADR-117: аудио-контейнеры, которые транспорт принимает нативно
138
+ * (блок `input_audio`/`audio`).
139
+ *
140
+ * Явный **пустой массив** — осмысленное значение «ни одного формата» (не
141
+ * «не задано»): перекрывает эвристику, аудио уходит только через aux-модель.
142
+ */
143
+ nativeAudioFormats?: NativeAudioFormat[];
144
+ }
145
+ /**
146
+ * Дефолты провайдера, наследуемые моделями. Набор полей совпадает с
147
+ * `ModelCompatibility`; отдельный алиас оставлен, чтобы смысл был явным.
148
+ */
149
+ export type ProviderCompatibility = ModelCompatibility;
150
+ /**
151
+ * Полностью разрешённая совместимость: каждое поле заполнено — явное значение
152
+ * модели → явное значение провайдера → эвристика (или встроенный дефолт).
153
+ */
154
+ export interface ResolvedModelCompatibility {
155
+ reasoningField: string;
156
+ requireReasoning: boolean;
157
+ maxTokensField: MaxTokensField;
158
+ requireAssistantAfterTool: boolean;
159
+ streamUsage: boolean;
160
+ supportsToolChoice: boolean;
161
+ requireFinishReason: boolean;
162
+ /**
163
+ * Anthropic: слать `output_config.effort` вместо `thinking`. Дефолт `false`
164
+ * (только явное включение — ADR-117).
165
+ */
166
+ supportsEffortUpdates: boolean;
167
+ /**
168
+ * Формат inline-маркеров кэша; `undefined` — маркеры не ставятся (в отличие
169
+ * от прочих полей, «не задано» здесь — осмысленное состояние, а не дефолт).
170
+ */
171
+ cacheFormat?: CacheFormat;
172
+ /**
173
+ * ADR-115: транспорт принимает видеофайл нативно (`video_url`).
174
+ * Дефолт — эвристика (RouterAI-совместимые шлюзы), иначе `false`.
175
+ */
176
+ supportsNativeVideo: boolean;
177
+ /**
178
+ * ADR-115: аудио-контейнеры нативного пути (`input_audio`/`audio`).
179
+ * Дефолт — эвристика; пустой массив — «ни одного формата».
180
+ */
181
+ nativeAudioFormats: NativeAudioFormat[];
182
+ }
183
+ /** Контекст, по которому считаются эвристики совместимости. */
184
+ export interface CompatibilityContext {
185
+ /** Тип провайдера (`openai`/`ollama`/`deepseek`/…). */
186
+ providerType?: string;
187
+ /** Имя провайдера как в конфиге. */
188
+ providerName?: string;
189
+ /** Базовый URL (для эвристик вида `deepseek.com`). */
190
+ baseUrl?: string;
191
+ /** Идентификатор модели. */
192
+ modelId?: string;
193
+ }
194
+ /** Эвристические значения совместимости (применяются только без явных). */
195
+ export type CompatibilityHeuristics = Partial<ResolvedModelCompatibility>;
196
+ /** Ключи контракта — для валидации входных данных API. */
197
+ export declare const MODEL_COMPATIBILITY_KEYS: readonly ["reasoningField", "requireReasoning", "maxTokensField", "requireAssistantAfterTool", "streamUsage", "supportsToolChoice", "cacheFormat", "requireFinishReason", "supportsEffortUpdates", "supportsNativeVideo", "nativeAudioFormats"];
198
+ /**
199
+ * RouterAI — прокси с расширениями протоколов (нативное аудио/видео).
200
+ *
201
+ * Единственный носитель host-знания в слое совместимости: **эвристика**
202
+ * умолчания для `supportsNativeVideo`/`nativeAudioFormats`. Сами значения
203
+ * приходят данными (`compatibility`) — этот предикат лишь задаёт дефолт,
204
+ * который любая запись каталога перекрывает явно (ADR-117).
205
+ *
206
+ * Функция чистая (только строка) — `node:*` в shared не тащим.
207
+ */
208
+ export declare function isRouterAiUrl(url: string): boolean;
209
+ /**
210
+ * Нативный аудио-контейнер по MIME (ADR-115): `wav`/`mp3`/`ogg`.
211
+ * Прочие MIME (в т.ч. не-аудио) → `null`.
212
+ */
213
+ export declare function nativeAudioFormatForMime(mime: string): NativeAudioFormat | null;
214
+ /**
215
+ * Эвристики совместимости — те же, что в opencode
216
+ * (`packages/ai/src/protocols/openai-chat.ts`):
217
+ *
218
+ * - `requireReasoning`: тип/имя провайдера `deepseek`, URL ~ `deepseek.com`,
219
+ * модель ~ `deepseek`; провайдер `minimax` или URL ~ `minimax`
220
+ * (adaptive thinking у MiniMax идёт в тот же бюджет вывода);
221
+ * - `requireAssistantAfterTool`: Mistral-семейство (`mistral`, `devstral`,
222
+ * `codestral`, `pixtral`, `mixtral`);
223
+ * - `supportsToolChoice`: `false` для нативного Ollama (`type: 'ollama'`).
224
+ *
225
+ * `maxTokensField` намеренно **не** эвристируется: наш дефолт — `max_tokens`,
226
+ * `max_completion_tokens` только при явном значении (локальные серверы).
227
+ *
228
+ * **Нативные медиа (ADR-115 × ADR-117).** Матрица «тип провайдера ×
229
+ * RouterAI-совместимый хост» — дефолт для `nativeAudioFormats`/
230
+ * `supportsNativeVideo`:
231
+ *
232
+ * | тип | RouterAI | nativeAudioFormats | supportsNativeVideo |
233
+ * |--------------|----------|--------------------|---------------------|
234
+ * | openai/generic| да | wav, mp3, ogg | `true` |
235
+ * | openai/generic| нет | wav, mp3 | `false` |
236
+ * | anthropic | да | wav | `false` |
237
+ * | anthropic | нет | — | `false` |
238
+ * | прочие | любой | — | `false` |
239
+ *
240
+ * Основание — прежнее поведение по хосту: `anthropic` принимает аудио только в
241
+ * `wav` и только у RouterAI (Anthropic-совместимый шлюз на ogg/mp3 отвечает 200,
242
+ * но модель аудио не слышит — такие форматы идут через aux-модель); OpenAI-протокол
243
+ * принимает wav/mp3 всегда, ogg — расширение RouterAI; блок `video_url` знает
244
+ * только RouterAI-совместимый OpenAI-протокол.
245
+ *
246
+ * Живой тест 2026-11-03: не-routerai прокси `itphx`
247
+ * (`https://ai.itphx.ru/api/`) нативное видео **умеет** — старый предикат по
248
+ * хосту давал ложноотрицательный ответ. Отсюда правило: дефолт по хосту —
249
+ * лишь эвристика, а решение принимают **данные** (`compatibility`), которыми
250
+ * провайдер/модель перекрывают эвристику явно.
251
+ */
252
+ export declare function detectCompatibilityHeuristics(context: CompatibilityContext): CompatibilityHeuristics;
253
+ /**
254
+ * Наложение слоёв совместимости: `undefined`-поля не перетирают значение.
255
+ * Поздние слои приоритетнее (провайдер → shorthand → модель).
256
+ */
257
+ export declare function mergeModelCompatibility(...layers: Array<ModelCompatibility | undefined>): ModelCompatibility;
258
+ /**
259
+ * Разрешение итоговой совместимости.
260
+ *
261
+ * Порядок: **явное значение модели → явное значение провайдера → эвристика →
262
+ * встроенный дефолт**. `reasoningField`, заданный явно на любом уровне, сам по
263
+ * себе означает `requireReasoning: true` (как в opencode) — если
264
+ * `requireReasoning` не переопределён явно (в т.ч. `false`).
265
+ */
266
+ export declare function resolveModelCompatibility(providerCompat?: ModelCompatibility, modelCompat?: ModelCompatibility, heuristics?: CompatibilityHeuristics): ResolvedModelCompatibility;
267
+ /** Результат строгого разбора поля `compatibility` из тела запроса. */
268
+ export type CompatibilityInputResult = {
269
+ ok: true;
270
+ value: ModelCompatibility | undefined;
271
+ } | {
272
+ ok: false;
273
+ reason: string;
274
+ };
275
+ /**
276
+ * Строгий разбор `compatibility` из тела API. Семантика — **замена**:
277
+ * - `undefined` — поле не передано (сохранить existing);
278
+ * - `null` — явно сбросить;
279
+ * - объект — **заменить** значение целиком (UI присылает полный объект из
280
+ * черновика, поэтому отсутствующее в объекте поле означает «авто», а не
281
+ * «оставить как было»); пустой объект равнозначен сбросу;
282
+ * - неизвестные поля и значения неверного типа — ошибка (не терять опечатки
283
+ * молча); иное — ошибка.
284
+ */
285
+ export declare function parseModelCompatibilityInput(raw: unknown, existing?: ModelCompatibility): CompatibilityInputResult;
26
286
  export interface ProviderConfig {
27
287
  name: string;
28
288
  type: string;
@@ -40,6 +300,12 @@ export interface ProviderConfig {
40
300
  * путём Ollama (`/api/chat`).
41
301
  */
42
302
  numCtx?: number;
303
+ /**
304
+ * Особенности протокола провайдера (дефолты для всех его моделей):
305
+ * поле reasoning, лимит вывода, `stream_options`, поддержка `tool_choice`.
306
+ * Модель перекрывает поля точечно (`ModelConfig.compatibility`).
307
+ */
308
+ compatibility?: ModelCompatibility;
43
309
  }
44
310
  export type ContextSource = 'api' | 'reference' | 'manual' | 'unknown';
45
311
  /**
@@ -92,4 +358,18 @@ export interface ModelConfig {
92
358
  * захардкоженного справочника модальностей нет (решение 2026-10-27).
93
359
  */
94
360
  modalities?: AttachmentModality[];
361
+ /**
362
+ * Особенности протокола модели (перекрывает `ProviderConfig.compatibility`
363
+ * по каждому полю). Например, для одной модели провайдера нужен
364
+ * `max_completion_tokens`, для остальных — дефолт.
365
+ */
366
+ compatibility?: ModelCompatibility;
367
+ /**
368
+ * Shorthand для `compatibility.requireReasoning` (thinking-модели DeepSeek):
369
+ * провайдер требует `reasoning_content` у assistant-сообщений;
370
+ * `undefined` — автоопределение по провайдеру/имени модели, `false` —
371
+ * принудительно выключить. Нормализация:
372
+ * `compatibility.requireReasoning ?? requiresReasoning`.
373
+ */
374
+ requiresReasoning?: boolean;
95
375
  }