@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
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Единая семантика правил хоста (ADR-099 — TLS/proxy; PROP-124 — политика
|
|
3
|
+
* SSH-ключей).
|
|
4
|
+
*
|
|
5
|
+
* Модуль **browser-safe** (без `node:*`): его читают и роуты ядра, и UI
|
|
6
|
+
* (`@itphx/synth-shared/types`). Поэтому реализация `normalizeTlsHost` /
|
|
7
|
+
* `matchTlsHostPattern` живёт здесь, а `config/tls.ts` её переиспользует —
|
|
8
|
+
* второй матчер шаблонов хоста в кодовой базе не заводим (ADR-099: семантика
|
|
9
|
+
* шаблона хоста общая для TLS, egress-политики и SSH).
|
|
10
|
+
*
|
|
11
|
+
* Грамматика правила:
|
|
12
|
+
* - **точный hostname** (`git.example.com`);
|
|
13
|
+
* - **`*.suffix`** — только поддомены (сам `suffix` требует отдельного правила);
|
|
14
|
+
* - **IP-литерал** (`10.0.0.5`) и **CIDR** (`10.0.0.0/8`) — адресные правила,
|
|
15
|
+
* которые матчатся **только по IP-литералу** хоста (никогда по hostname);
|
|
16
|
+
* - одиночный **`*`** («любой хост») — **недопустим** в правилах политики
|
|
17
|
+
* (fail-closed): иначе исключение разрешило бы любой адрес. В TLS-профилях
|
|
18
|
+
* `*` допустим (см. `matchTlsHostPattern`) — там это явный выбор админа.
|
|
19
|
+
*/
|
|
20
|
+
/** Допустимый hostname (в т.ч. `*.suffix`): буквы/цифры/дефис/подчёркивание и точки. */
|
|
21
|
+
const HOSTNAME_RULE_RE = /^(\*\.)?[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?(?:\.[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)*\.?$/i;
|
|
22
|
+
/** Нормализует host (нижний регистр, без точки в конце и скобок IPv6). */
|
|
23
|
+
export function normalizeTlsHost(rawHost) {
|
|
24
|
+
if (typeof rawHost !== 'string')
|
|
25
|
+
return undefined;
|
|
26
|
+
let host = rawHost.trim().toLowerCase().replace(/\.$/, '');
|
|
27
|
+
if (host.startsWith('[') && host.endsWith(']'))
|
|
28
|
+
host = host.slice(1, -1);
|
|
29
|
+
return host === '' ? undefined : host;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Матчинг одного шаблона (`host` | `*.suffix` | `*`); регистронезависимо.
|
|
33
|
+
*
|
|
34
|
+
* `*` («любой хост») здесь допустим — им пользуются TLS-профили per-host
|
|
35
|
+
* (ADR-099). Для **политик** (`allowHosts` SSH-ключа) `*` недопустим —
|
|
36
|
+
* это проверяет `isValidHostRule`.
|
|
37
|
+
*/
|
|
38
|
+
export function matchTlsHostPattern(pattern, rawHost) {
|
|
39
|
+
const host = normalizeTlsHost(rawHost);
|
|
40
|
+
if (host === undefined)
|
|
41
|
+
return false;
|
|
42
|
+
const value = pattern.trim().toLowerCase().replace(/\.$/, '');
|
|
43
|
+
if (value === '*')
|
|
44
|
+
return true;
|
|
45
|
+
if (value.startsWith('*.')) {
|
|
46
|
+
const suffix = value.slice(2);
|
|
47
|
+
return suffix !== '' && host.endsWith(`.${suffix}`);
|
|
48
|
+
}
|
|
49
|
+
return host === value;
|
|
50
|
+
}
|
|
51
|
+
/** IPv4-литерал (`10.0.0.5`); ведущие нули не допускаются (как в `net.isIP`). */
|
|
52
|
+
function isIpv4Literal(value) {
|
|
53
|
+
const parts = value.split('.');
|
|
54
|
+
if (parts.length !== 4)
|
|
55
|
+
return false;
|
|
56
|
+
return parts.every((part) => /^\d{1,3}$/.test(part) &&
|
|
57
|
+
Number(part) <= 255 &&
|
|
58
|
+
(part === '0' || !part.startsWith('0')));
|
|
59
|
+
}
|
|
60
|
+
/**
|
|
61
|
+
* IPv6-литерал: восемь групп, сжатие `::` (хотя бы одну группу) и встроенный
|
|
62
|
+
* IPv4 в последней группе.
|
|
63
|
+
*/
|
|
64
|
+
function isIpv6Literal(value) {
|
|
65
|
+
if (!value.includes(':'))
|
|
66
|
+
return false;
|
|
67
|
+
const halves = value.split('::');
|
|
68
|
+
if (halves.length > 2)
|
|
69
|
+
return false;
|
|
70
|
+
const countGroups = (part) => {
|
|
71
|
+
if (part === '')
|
|
72
|
+
return 0;
|
|
73
|
+
const groups = part.split(':');
|
|
74
|
+
let count = 0;
|
|
75
|
+
for (let i = 0; i < groups.length; i++) {
|
|
76
|
+
const group = groups[i];
|
|
77
|
+
if (group.includes('.')) {
|
|
78
|
+
// Встроенный IPv4 допустим только в последней группе и занимает 2 группы.
|
|
79
|
+
if (i !== groups.length - 1)
|
|
80
|
+
return null;
|
|
81
|
+
if (!isIpv4Literal(group))
|
|
82
|
+
return null;
|
|
83
|
+
count += 2;
|
|
84
|
+
continue;
|
|
85
|
+
}
|
|
86
|
+
if (!/^[0-9a-fA-F]{1,4}$/.test(group))
|
|
87
|
+
return null;
|
|
88
|
+
count += 1;
|
|
89
|
+
}
|
|
90
|
+
return count;
|
|
91
|
+
};
|
|
92
|
+
const head = countGroups(halves[0]);
|
|
93
|
+
if (head === null)
|
|
94
|
+
return false;
|
|
95
|
+
if (halves.length === 1)
|
|
96
|
+
return head === 8;
|
|
97
|
+
const tail = countGroups(halves[1]);
|
|
98
|
+
if (tail === null)
|
|
99
|
+
return false;
|
|
100
|
+
// `::` обязан сжимать хотя бы одну группу из восьми.
|
|
101
|
+
return head + tail <= 7;
|
|
102
|
+
}
|
|
103
|
+
/** IP-литерал любого семейства. */
|
|
104
|
+
export function isIpLiteral(value) {
|
|
105
|
+
return isIpv4Literal(value) || isIpv6Literal(value);
|
|
106
|
+
}
|
|
107
|
+
/** CIDR-правило: адресная часть — IP-литерал, префикс — в границах семейства. */
|
|
108
|
+
function isCidrRule(value) {
|
|
109
|
+
const slash = value.lastIndexOf('/');
|
|
110
|
+
if (slash <= 0)
|
|
111
|
+
return false;
|
|
112
|
+
const address = value.slice(0, slash);
|
|
113
|
+
const prefixRaw = value.slice(slash + 1);
|
|
114
|
+
if (!/^\d{1,3}$/.test(prefixRaw))
|
|
115
|
+
return false;
|
|
116
|
+
const prefix = Number(prefixRaw);
|
|
117
|
+
if (isIpv4Literal(address))
|
|
118
|
+
return prefix <= 32;
|
|
119
|
+
if (isIpv6Literal(address))
|
|
120
|
+
return prefix <= 128;
|
|
121
|
+
return false;
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Валидна ли одна запись правила хоста: точный hostname, `*.suffix`, IP-литерал
|
|
125
|
+
* или CIDR. Пустые строки, regex-подобные записи и одиночный `*` — невалидны.
|
|
126
|
+
*
|
|
127
|
+
* Семантика — та же, что у egress-политики (`isValidEgressRule` в ядре), но
|
|
128
|
+
* реализация browser-safe: правило проверяется и в роутах ядра, и в UI.
|
|
129
|
+
*/
|
|
130
|
+
export function isValidHostRule(raw) {
|
|
131
|
+
if (typeof raw !== 'string')
|
|
132
|
+
return false;
|
|
133
|
+
const rule = raw.trim();
|
|
134
|
+
if (!rule)
|
|
135
|
+
return false;
|
|
136
|
+
if (rule.includes('/'))
|
|
137
|
+
return isCidrRule(rule);
|
|
138
|
+
if (isIpLiteral(rule))
|
|
139
|
+
return true;
|
|
140
|
+
return HOSTNAME_RULE_RE.test(rule);
|
|
141
|
+
}
|
|
142
|
+
/** Подсказка по допустимому виду правила — для сообщений об ошибке. */
|
|
143
|
+
export const HOST_RULE_FORMAT_HINT = 'ожидается hostname (git.example.com), поддомены (*.corp.example), IP-литерал или CIDR (10.0.0.0/8)';
|
package/dist/types/index.d.ts
CHANGED
|
@@ -8,13 +8,17 @@ export * from './plugin-protocol.js';
|
|
|
8
8
|
export * from './mcp.js';
|
|
9
9
|
export * from './project.js';
|
|
10
10
|
export * from './git.js';
|
|
11
|
+
export * from './host-pattern.js';
|
|
11
12
|
export * from './user.js';
|
|
12
13
|
export * from './agent.js';
|
|
13
14
|
export * from './provider.js';
|
|
14
15
|
export * from './llm.js';
|
|
15
16
|
export * from './bus-events.js';
|
|
17
|
+
export * from './message-stream.js';
|
|
16
18
|
export * from './steering.js';
|
|
17
19
|
export * from './fs.js';
|
|
20
|
+
export * from './file-kind.js';
|
|
21
|
+
export { DEFAULT_CONTEXT_WINDOW } from '../model-metadata.js';
|
|
18
22
|
export * from './tools.js';
|
|
19
23
|
export * from './permission.js';
|
|
20
24
|
export * from './skills.js';
|
package/dist/types/index.js
CHANGED
|
@@ -20,8 +20,11 @@ export * from './plugin-protocol.js';
|
|
|
20
20
|
export * from './mcp.js';
|
|
21
21
|
// Проекты, workspace-политика, иконки/цвета, план (ADR-039/075)
|
|
22
22
|
export * from './project.js';
|
|
23
|
-
// Git-репозитории и SSH-ключи (ADR-076)
|
|
23
|
+
// Git-репозитории и SSH-ключи (ADR-076, PROP-124)
|
|
24
24
|
export * from './git.js';
|
|
25
|
+
// Единая семантика правил хоста (ADR-099 — TLS/egress; PROP-124 — SSH-политика):
|
|
26
|
+
// browser-safe, поэтому читается и ядром, и UI.
|
|
27
|
+
export * from './host-pattern.js';
|
|
25
28
|
// Пользователи, auth и внешние идентичности (ADR-089)
|
|
26
29
|
export * from './user.js';
|
|
27
30
|
// Агенты (определения и режимы)
|
|
@@ -32,10 +35,19 @@ export * from './provider.js';
|
|
|
32
35
|
export * from './llm.js';
|
|
33
36
|
// EventType/BusEvent — шина событий сессии (ADR-009/024)
|
|
34
37
|
export * from './bus-events.js';
|
|
38
|
+
// ADR-118: контракт «Поток сообщений v2» — модель хода (Turn/Step/Part),
|
|
39
|
+
// контракт приёма `202 {messageId, mode, position}` и payload'ы новых событий.
|
|
40
|
+
export * from './message-stream.js';
|
|
35
41
|
// ADR-104: режимы отправки сообщения во время хода (steering)
|
|
36
42
|
export * from './steering.js';
|
|
37
43
|
// Файловая система (FS API v2)
|
|
38
44
|
export * from './fs.js';
|
|
45
|
+
// Классификация файла по расширению (kind/MIME, allow-list inline-предпросмотра)
|
|
46
|
+
// — browser-safe контракт для UI и ядра.
|
|
47
|
+
export * from './file-kind.js';
|
|
48
|
+
// Оценка контекстного окна при неизвестном окне модели — общая константа ядра
|
|
49
|
+
// и UI (browser-safe: без node:*; значение — см. `model-metadata.ts`).
|
|
50
|
+
export { DEFAULT_CONTEXT_WINDOW } from '../model-metadata.js';
|
|
39
51
|
// --- Реэкспорт существующих доменных модулей ---
|
|
40
52
|
// Tool types — re-exported from tools.ts
|
|
41
53
|
export * from './tools.js';
|
package/dist/types/llm.d.ts
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import type { ReasoningLevel } from './session.js';
|
|
2
|
+
import type { Currency } from './provider.js';
|
|
1
3
|
/**
|
|
2
4
|
* ADR-036/ADR-072: дефолт rate limit LLM Gateway. Единый источник для Zod-схемы
|
|
3
5
|
* конфига и runtime-дефолтов (settings-роуты, fallback'и backend/core).
|
|
@@ -6,6 +8,25 @@ export declare const DEFAULT_LLM_GATEWAY_RATE_LIMIT: {
|
|
|
6
8
|
readonly userPerMinute: 60;
|
|
7
9
|
readonly providerPerMinute: 120;
|
|
8
10
|
};
|
|
11
|
+
/**
|
|
12
|
+
* ADR-117: тир усилия модели (effort) — масштаб opencode
|
|
13
|
+
* (`packages/ai/src/schema/options.ts`). Anthropic 5.x принимает его в
|
|
14
|
+
* `output_config.effort`; передаётся из `ChatOptions.effort` (явно) либо
|
|
15
|
+
* выводится из `reasoningLevel` (`effortForReasoningLevel`).
|
|
16
|
+
*/
|
|
17
|
+
export declare const EFFORT_LEVELS: readonly ["low", "medium", "high", "xhigh", "max"];
|
|
18
|
+
export type EffortLevel = (typeof EFFORT_LEVELS)[number];
|
|
19
|
+
/** Проверка, что значение — допустимый тир effort. */
|
|
20
|
+
export declare function isEffortLevel(value: unknown): value is EffortLevel;
|
|
21
|
+
/**
|
|
22
|
+
* Маппинг `reasoningLevel` → `effort`.
|
|
23
|
+
*
|
|
24
|
+
* Только прямые соответствия `low|medium|high`; `default`/`none` — `undefined`
|
|
25
|
+
* (параметр не отправляется), потому что «выключить размышления» через
|
|
26
|
+
* effort-тир не выразить: у effort-моделей это другой режим, и выдумывать
|
|
27
|
+
* значение нельзя. `xhigh`/`max` существуют только как явный `ChatOptions.effort`.
|
|
28
|
+
*/
|
|
29
|
+
export declare function effortForReasoningLevel(level?: ReasoningLevel): EffortLevel | undefined;
|
|
9
30
|
export interface TokenUsage {
|
|
10
31
|
inputTokens: number;
|
|
11
32
|
outputTokens: number;
|
|
@@ -13,6 +34,46 @@ export interface TokenUsage {
|
|
|
13
34
|
cacheReadTokens?: number;
|
|
14
35
|
cacheWriteTokens?: number;
|
|
15
36
|
reasoningTokens?: number;
|
|
37
|
+
/**
|
|
38
|
+
* ADR-102/ADR-118 (паритет с opencode `Usage.cost`): стоимость вызова,
|
|
39
|
+
* если провайдер вернул её сам. Приоритетнее каталожной цены модели.
|
|
40
|
+
* `amount` в `currency`; `0` — достоверная нулевая стоимость.
|
|
41
|
+
*/
|
|
42
|
+
cost?: {
|
|
43
|
+
amount: number;
|
|
44
|
+
currency: Currency;
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Нормализованная причина завершения ответа модели (единый словарь для всех
|
|
49
|
+
* протоколов).
|
|
50
|
+
*
|
|
51
|
+
* Зачем: провайдеры сообщают причину по-разному (`stop_reason` у Anthropic,
|
|
52
|
+
* `finish_reason` у OpenAI-совместимых, `done_reason` у Ollama), а потребителю
|
|
53
|
+
* (оркестратору) нужно отличать «модель ничего не сказала» от «ответ срезан
|
|
54
|
+
* лимитом вывода»: при `max_tokens` пустой `content` — это не пустой ответ, а
|
|
55
|
+
* исчерпанный бюджет (например, adaptive thinking съел весь `max_tokens`).
|
|
56
|
+
*
|
|
57
|
+
* - `end_turn` — естественное завершение;
|
|
58
|
+
* - `tool_use` — модель просит вызвать инструмент;
|
|
59
|
+
* - `max_tokens` — ответ срезан лимитом вывода (в т.ч. весь ушёл в reasoning);
|
|
60
|
+
* - `stop_sequence` — сработала стоп-последовательность;
|
|
61
|
+
* - `length` — то же, что `max_tokens` (сырое значение Ollama/части API);
|
|
62
|
+
* - `content_filter` — завершение фильтром провайдера;
|
|
63
|
+
* - `error` — завершение по ошибке провайдера;
|
|
64
|
+
* - `unknown` — причина есть, но не распознана.
|
|
65
|
+
*/
|
|
66
|
+
export declare const LLM_FINISH_REASONS: readonly ["end_turn", "tool_use", "max_tokens", "stop_sequence", "length", "content_filter", "error", "unknown"];
|
|
67
|
+
export type LlmFinishReason = (typeof LLM_FINISH_REASONS)[number];
|
|
68
|
+
/**
|
|
69
|
+
* Anthropic-протокол: один блок размышлений ответа. `signature` — подпись
|
|
70
|
+
* thinking-блока, `redactedData` — opaque-данные `redacted_thinking`
|
|
71
|
+
* (блок без видимого текста). Порядок элементов — порядок блоков в ответе.
|
|
72
|
+
*/
|
|
73
|
+
export interface LLMReasoningBlock {
|
|
74
|
+
text: string;
|
|
75
|
+
signature?: string;
|
|
76
|
+
redactedData?: string;
|
|
16
77
|
}
|
|
17
78
|
export interface LLMChunk {
|
|
18
79
|
content: string;
|
|
@@ -20,7 +81,33 @@ export interface LLMChunk {
|
|
|
20
81
|
usage?: TokenUsage;
|
|
21
82
|
toolCalls?: Record<string, unknown>[];
|
|
22
83
|
reasoning?: string;
|
|
84
|
+
/**
|
|
85
|
+
* Anthropic: все блоки размышлений ответа (по блокам, с подписями).
|
|
86
|
+
* `reasoning` — накопленный текст для UI/учёта токенов; подпись валидна
|
|
87
|
+
* только для своего блока, поэтому при нескольких блоках реплей идёт отсюда.
|
|
88
|
+
*/
|
|
89
|
+
reasoningBlocks?: LLMReasoningBlock[];
|
|
90
|
+
/**
|
|
91
|
+
* Anthropic-протокол: подпись thinking-блока (`signature`). Без возврата этой
|
|
92
|
+
* подписи в историю Anthropic отвергает следующий запрос tool-loop
|
|
93
|
+
* («Expected `thinking`…»). Пустая строка — валидная подпись (RouterAI/qwen
|
|
94
|
+
* отдают `"signature": ""`). Аддитивное поле: остальные провайдеры его не
|
|
95
|
+
* заполняют.
|
|
96
|
+
*/
|
|
97
|
+
reasoningSignature?: string;
|
|
98
|
+
/**
|
|
99
|
+
* Anthropic-протокол: opaque-данные блоков `redacted_thinking` (verbatim
|
|
100
|
+
* `data`) — реплеятся в историю без изменений.
|
|
101
|
+
*/
|
|
102
|
+
reasoningRedacted?: string[];
|
|
23
103
|
model?: string;
|
|
104
|
+
/**
|
|
105
|
+
* Причина завершения ответа (нормализованный словарь `LlmFinishReason`).
|
|
106
|
+
* Аддитивное поле: заполняется адаптерами протоколов (Anthropic —
|
|
107
|
+
* `stop_reason`, OpenAI — `finish_reason`, Ollama — `done_reason`), иначе
|
|
108
|
+
* `undefined`. Значимо в финальном чанке (`isFinal: true`).
|
|
109
|
+
*/
|
|
110
|
+
finishReason?: LlmFinishReason;
|
|
24
111
|
}
|
|
25
112
|
export interface LLMResponse {
|
|
26
113
|
content: string;
|
|
@@ -28,5 +115,13 @@ export interface LLMResponse {
|
|
|
28
115
|
usage: TokenUsage;
|
|
29
116
|
toolCalls?: Record<string, unknown>[];
|
|
30
117
|
reasoning?: string;
|
|
118
|
+
/** Anthropic: блоки размышлений ответа (см. `LLMChunk.reasoningBlocks`). */
|
|
119
|
+
reasoningBlocks?: LLMReasoningBlock[];
|
|
120
|
+
/** Anthropic: подпись thinking-блока (см. `LLMChunk.reasoningSignature`). */
|
|
121
|
+
reasoningSignature?: string;
|
|
122
|
+
/** Anthropic: opaque-данные `redacted_thinking` (см. `LLMChunk.reasoningRedacted`). */
|
|
123
|
+
reasoningRedacted?: string[];
|
|
124
|
+
/** Причина завершения ответа (см. `LLMChunk.finishReason`). */
|
|
125
|
+
finishReason?: LlmFinishReason;
|
|
31
126
|
debugInfo?: Record<string, unknown>;
|
|
32
127
|
}
|
package/dist/types/llm.js
CHANGED
|
@@ -6,3 +6,61 @@ export const DEFAULT_LLM_GATEWAY_RATE_LIMIT = {
|
|
|
6
6
|
userPerMinute: 60,
|
|
7
7
|
providerPerMinute: 120,
|
|
8
8
|
};
|
|
9
|
+
// --- LLM ---
|
|
10
|
+
/**
|
|
11
|
+
* ADR-117: тир усилия модели (effort) — масштаб opencode
|
|
12
|
+
* (`packages/ai/src/schema/options.ts`). Anthropic 5.x принимает его в
|
|
13
|
+
* `output_config.effort`; передаётся из `ChatOptions.effort` (явно) либо
|
|
14
|
+
* выводится из `reasoningLevel` (`effortForReasoningLevel`).
|
|
15
|
+
*/
|
|
16
|
+
export const EFFORT_LEVELS = ['low', 'medium', 'high', 'xhigh', 'max'];
|
|
17
|
+
/** Проверка, что значение — допустимый тир effort. */
|
|
18
|
+
export function isEffortLevel(value) {
|
|
19
|
+
return typeof value === 'string' && EFFORT_LEVELS.includes(value);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Маппинг `reasoningLevel` → `effort`.
|
|
23
|
+
*
|
|
24
|
+
* Только прямые соответствия `low|medium|high`; `default`/`none` — `undefined`
|
|
25
|
+
* (параметр не отправляется), потому что «выключить размышления» через
|
|
26
|
+
* effort-тир не выразить: у effort-моделей это другой режим, и выдумывать
|
|
27
|
+
* значение нельзя. `xhigh`/`max` существуют только как явный `ChatOptions.effort`.
|
|
28
|
+
*/
|
|
29
|
+
export function effortForReasoningLevel(level) {
|
|
30
|
+
if (level === 'low')
|
|
31
|
+
return 'low';
|
|
32
|
+
if (level === 'medium')
|
|
33
|
+
return 'medium';
|
|
34
|
+
if (level === 'high')
|
|
35
|
+
return 'high';
|
|
36
|
+
return undefined;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Нормализованная причина завершения ответа модели (единый словарь для всех
|
|
40
|
+
* протоколов).
|
|
41
|
+
*
|
|
42
|
+
* Зачем: провайдеры сообщают причину по-разному (`stop_reason` у Anthropic,
|
|
43
|
+
* `finish_reason` у OpenAI-совместимых, `done_reason` у Ollama), а потребителю
|
|
44
|
+
* (оркестратору) нужно отличать «модель ничего не сказала» от «ответ срезан
|
|
45
|
+
* лимитом вывода»: при `max_tokens` пустой `content` — это не пустой ответ, а
|
|
46
|
+
* исчерпанный бюджет (например, adaptive thinking съел весь `max_tokens`).
|
|
47
|
+
*
|
|
48
|
+
* - `end_turn` — естественное завершение;
|
|
49
|
+
* - `tool_use` — модель просит вызвать инструмент;
|
|
50
|
+
* - `max_tokens` — ответ срезан лимитом вывода (в т.ч. весь ушёл в reasoning);
|
|
51
|
+
* - `stop_sequence` — сработала стоп-последовательность;
|
|
52
|
+
* - `length` — то же, что `max_tokens` (сырое значение Ollama/части API);
|
|
53
|
+
* - `content_filter` — завершение фильтром провайдера;
|
|
54
|
+
* - `error` — завершение по ошибке провайдера;
|
|
55
|
+
* - `unknown` — причина есть, но не распознана.
|
|
56
|
+
*/
|
|
57
|
+
export const LLM_FINISH_REASONS = [
|
|
58
|
+
'end_turn',
|
|
59
|
+
'tool_use',
|
|
60
|
+
'max_tokens',
|
|
61
|
+
'stop_sequence',
|
|
62
|
+
'length',
|
|
63
|
+
'content_filter',
|
|
64
|
+
'error',
|
|
65
|
+
'unknown',
|
|
66
|
+
];
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
* `{dataDir}/audit/maintenance.jsonl`.
|
|
10
10
|
*/
|
|
11
11
|
/** ADR-092: вид операции обслуживания инстанса. */
|
|
12
|
-
export type MaintenanceAuditOp = 'backup.created' | 'backup.failed' | 'backup.deleted' | 'restore.scheduled' | 'restore.cancelled' | 'restore.applied' | 'restore.failed' | 'migrate.applied' | 'migrate.failed' | 'update.applied' | 'rollback.applied' | 'update.failed' | 'uninstall.purge' | 'export.created' | 'import.applied' | 'restart.requested';
|
|
12
|
+
export type MaintenanceAuditOp = 'backup.created' | 'backup.failed' | 'backup.deleted' | 'restore.scheduled' | 'restore.cancelled' | 'restore.applied' | 'restore.failed' | 'migrate.applied' | 'migrate.failed' | 'update.applied' | 'update.checked' | 'rollback.applied' | 'update.failed' | 'uninstall.purge' | 'export.created' | 'import.applied' | 'restart.requested';
|
|
13
13
|
/** ADR-092: итог операции обслуживания. */
|
|
14
14
|
export type MaintenanceAuditStatus = 'ok' | 'failed' | 'scheduled';
|
|
15
15
|
/**
|
package/dist/types/mcp.d.ts
CHANGED
|
@@ -6,6 +6,18 @@ export declare const MCP_REGISTRY_ORIGINS: readonly ["instance", "user"];
|
|
|
6
6
|
export type McpRegistryOrigin = (typeof MCP_REGISTRY_ORIGINS)[number];
|
|
7
7
|
export declare const MCP_REGISTRY_TRUST_LEVELS: readonly ["builtin", "community"];
|
|
8
8
|
export type McpRegistryTrust = (typeof MCP_REGISTRY_TRUST_LEVELS)[number];
|
|
9
|
+
/**
|
|
10
|
+
* PROP-125: режим доставки серверного MCP-сервера в локальные сессии гибрида.
|
|
11
|
+
*
|
|
12
|
+
* - `auto` — `relay` для `http`/`sse`, `tools` для `stdio` (дефолт);
|
|
13
|
+
* - `relay` — полноценный MCP-клиент через backend (`/api/v2/mcp/relay/:name`);
|
|
14
|
+
* - `tools` — tool-level proxy (`/api/v2/mcp/remote/*`).
|
|
15
|
+
*
|
|
16
|
+
* Неудачный relay **всегда** деградирует в `tools` (с причиной в статусе) —
|
|
17
|
+
* отказа и «тихого» исчезновения сервера нет.
|
|
18
|
+
*/
|
|
19
|
+
export declare const MCP_REMOTE_MODES: readonly ["auto", "relay", "tools"];
|
|
20
|
+
export type McpRemoteMode = (typeof MCP_REMOTE_MODES)[number];
|
|
9
21
|
/** Автор записи реестра (кто добавил сервер). */
|
|
10
22
|
export interface McpRegistryAuthor {
|
|
11
23
|
userId: string;
|
|
@@ -38,6 +50,11 @@ export interface McpRegistryEntry {
|
|
|
38
50
|
* изменение не влияет на ранее созданные проекты/сессии.
|
|
39
51
|
*/
|
|
40
52
|
enabledByDefault: boolean;
|
|
53
|
+
/**
|
|
54
|
+
* PROP-125: как доставлять сервер в локальные сессии гибрида.
|
|
55
|
+
* Отсутствие поля = `auto` (записи, созданные до PROP-125).
|
|
56
|
+
*/
|
|
57
|
+
remoteMode?: McpRemoteMode;
|
|
41
58
|
createdAt: string;
|
|
42
59
|
updatedAt: string;
|
|
43
60
|
}
|
|
@@ -148,12 +165,26 @@ export interface McpServerEffective {
|
|
|
148
165
|
connected?: boolean;
|
|
149
166
|
origin: McpRegistryOrigin;
|
|
150
167
|
trust: McpRegistryTrust;
|
|
168
|
+
/**
|
|
169
|
+
* PROP-125: источник для UI — локальный инстанс или сервер гибрида.
|
|
170
|
+
* Не путать с `origin` (про реестр записи: instance/user).
|
|
171
|
+
*/
|
|
172
|
+
source?: 'local' | 'server';
|
|
151
173
|
/**
|
|
152
174
|
* ADR-071 §2.2/§2.6: транспортный статус для таблицы «MCP» в статистике:
|
|
153
175
|
* `disabled` — выключен в эффективном наборе, `connected`/`error`/`circuit-open`
|
|
154
176
|
* — состояние подключения активного сервера.
|
|
155
177
|
*/
|
|
156
178
|
status?: 'connected' | 'error' | 'disabled' | 'circuit-open';
|
|
179
|
+
/**
|
|
180
|
+
* PROP-125: причина недоступности/деградации сервера (без секретов).
|
|
181
|
+
*
|
|
182
|
+
* Для серверных MCP-серверов гибрида — причина, по которой сервер не
|
|
183
|
+
* работает: backend офлайн, сервер упал или relay не поднялся и клиент
|
|
184
|
+
* деградировал в режим `tools`. Для локальных серверов поле отсутствует —
|
|
185
|
+
* ошибки там не ведутся.
|
|
186
|
+
*/
|
|
187
|
+
error?: string;
|
|
157
188
|
/** ADR-071 §2.5/§2.6: автор записи реестра (null для instance/config-серверов). */
|
|
158
189
|
author?: McpRegistryAuthor | null;
|
|
159
190
|
/** ADR-071 §2.2/§2.6: имена инструментов сервера (пусто, если не подключён). */
|
|
@@ -167,6 +198,65 @@ export interface McpServerEffective {
|
|
|
167
198
|
/** ADR-071 §2.6: пер-тульные chars/estTokens/ratio + признак admin_disabled. */
|
|
168
199
|
toolDetails?: McpToolDetail[];
|
|
169
200
|
}
|
|
201
|
+
/**
|
|
202
|
+
* PROP-125: вложение в результате удалённого MCP-вызова (base64, как в
|
|
203
|
+
* протоколе исполнителя 5 — ADR-077).
|
|
204
|
+
*/
|
|
205
|
+
export interface McpRemoteAttachment {
|
|
206
|
+
mime: string;
|
|
207
|
+
name?: string;
|
|
208
|
+
base64: string;
|
|
209
|
+
}
|
|
210
|
+
/**
|
|
211
|
+
* PROP-125: описание серверного MCP-сервера для локального клиента.
|
|
212
|
+
*
|
|
213
|
+
* Секреты и URL с креденшелами в выдачу не попадают (ADR-105).
|
|
214
|
+
*/
|
|
215
|
+
export interface RemoteMcpServerInfo {
|
|
216
|
+
name: string;
|
|
217
|
+
type: 'stdio' | 'sse' | 'http';
|
|
218
|
+
origin: 'instance' | 'user';
|
|
219
|
+
trust: McpRegistryTrust;
|
|
220
|
+
/** Системный мастер-флаг (hard-gate): `false` — сервер недоступен нигде. */
|
|
221
|
+
enabled: boolean;
|
|
222
|
+
/** «Включён по умолчанию для новых проектов» (сид `project.mcp`). */
|
|
223
|
+
enabledByDefault: boolean;
|
|
224
|
+
/** Фактический режим доставки в локальные сессии (PROP-125). */
|
|
225
|
+
remoteMode: McpRemoteMode;
|
|
226
|
+
status: 'idle' | 'up' | 'down';
|
|
227
|
+
toolCount: number;
|
|
228
|
+
error?: string;
|
|
229
|
+
instructions?: string;
|
|
230
|
+
}
|
|
231
|
+
/** PROP-125: описание одного инструмента удалённого MCP-сервера. */
|
|
232
|
+
export interface RemoteMcpToolInfo {
|
|
233
|
+
server: string;
|
|
234
|
+
name: string;
|
|
235
|
+
description: string;
|
|
236
|
+
inputSchema: Record<string, unknown>;
|
|
237
|
+
}
|
|
238
|
+
/** PROP-125: ответ `GET /api/v2/mcp/remote/tools?server=…`. */
|
|
239
|
+
export interface RemoteMcpToolsResponse {
|
|
240
|
+
server: string;
|
|
241
|
+
instructions?: string;
|
|
242
|
+
tools: RemoteMcpToolInfo[];
|
|
243
|
+
}
|
|
244
|
+
/** PROP-125: тело `POST /api/v2/mcp/remote/call`. */
|
|
245
|
+
export interface RemoteMcpCallRequest {
|
|
246
|
+
server: string;
|
|
247
|
+
tool: string;
|
|
248
|
+
arguments?: Record<string, unknown>;
|
|
249
|
+
meta?: Record<string, unknown>;
|
|
250
|
+
}
|
|
251
|
+
/**
|
|
252
|
+
* PROP-125: результат удалённого MCP-вызова — тот же шейп, что у протокола
|
|
253
|
+
* исполнителя 5 (`docs/EXECUTION.md`): один формат на два «MCP вне процесса».
|
|
254
|
+
*/
|
|
255
|
+
export interface RemoteMcpCallResult {
|
|
256
|
+
content: string;
|
|
257
|
+
isError: boolean;
|
|
258
|
+
attachments?: McpRemoteAttachment[];
|
|
259
|
+
}
|
|
170
260
|
/**
|
|
171
261
|
* Машинно-читаемый код ошибки записи реестра MCP с plaintext-секретом
|
|
172
262
|
* в заголовках (ADR-105 §5, Ф3).
|
package/dist/types/mcp.js
CHANGED
|
@@ -3,6 +3,17 @@
|
|
|
3
3
|
export const MCP_REGISTRY_SCHEMA_VERSION = 1;
|
|
4
4
|
export const MCP_REGISTRY_ORIGINS = ['instance', 'user'];
|
|
5
5
|
export const MCP_REGISTRY_TRUST_LEVELS = ['builtin', 'community'];
|
|
6
|
+
/**
|
|
7
|
+
* PROP-125: режим доставки серверного MCP-сервера в локальные сессии гибрида.
|
|
8
|
+
*
|
|
9
|
+
* - `auto` — `relay` для `http`/`sse`, `tools` для `stdio` (дефолт);
|
|
10
|
+
* - `relay` — полноценный MCP-клиент через backend (`/api/v2/mcp/relay/:name`);
|
|
11
|
+
* - `tools` — tool-level proxy (`/api/v2/mcp/remote/*`).
|
|
12
|
+
*
|
|
13
|
+
* Неудачный relay **всегда** деградирует в `tools` (с причиной в статусе) —
|
|
14
|
+
* отказа и «тихого» исчезновения сервера нет.
|
|
15
|
+
*/
|
|
16
|
+
export const MCP_REMOTE_MODES = ['auto', 'relay', 'tools'];
|
|
6
17
|
export const MCP_NETWORK_POLICY_MODES = ['allow', 'deny'];
|
|
7
18
|
/**
|
|
8
19
|
* Служебные/специальные адресные диапазоны, запрещённые по умолчанию (SSRF/egress).
|