@itphx/synth-shared 0.13.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 +28 -1
- package/dist/config/env-overrides.d.ts +23 -4
- package/dist/config/env-overrides.js +74 -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/tls.d.ts +7 -4
- package/dist/config/tls.js +10 -23
- package/dist/config/types.d.ts +102 -4
- package/dist/config/types.js +73 -0
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +129 -0
- package/dist/index.d.ts +3 -3
- package/dist/index.js +3 -3
- package/dist/model-metadata.d.ts +10 -0
- package/dist/model-metadata.js +10 -0
- package/dist/schemas/index.d.ts +288 -11
- package/dist/schemas/index.js +228 -2
- package/dist/types/bus-events.d.ts +2 -2
- package/dist/types/egress.d.ts +2 -2
- package/dist/types/egress.js +2 -2
- package/dist/types/git.d.ts +83 -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 +2 -0
- package/dist/types/index.js +7 -1
- 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 +41 -0
- package/dist/types/permission.d.ts +13 -3
- 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/service-keys.d.ts +6 -3
- package/dist/types/service-keys.js +6 -1
- package/dist/types/session.d.ts +8 -0
- package/dist/types/skills.d.ts +6 -0
- package/dist/types/tools.d.ts +36 -0
- package/dist/types/tools.js +48 -0
- 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/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +3 -2
|
@@ -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,6 +8,7 @@ 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';
|
|
@@ -17,6 +18,7 @@ export * from './message-stream.js';
|
|
|
17
18
|
export * from './steering.js';
|
|
18
19
|
export * from './fs.js';
|
|
19
20
|
export * from './file-kind.js';
|
|
21
|
+
export { DEFAULT_CONTEXT_WINDOW } from '../model-metadata.js';
|
|
20
22
|
export * from './tools.js';
|
|
21
23
|
export * from './permission.js';
|
|
22
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
|
// Агенты (определения и режимы)
|
|
@@ -42,6 +45,9 @@ export * from './fs.js';
|
|
|
42
45
|
// Классификация файла по расширению (kind/MIME, allow-list inline-предпросмотра)
|
|
43
46
|
// — browser-safe контракт для UI и ядра.
|
|
44
47
|
export * from './file-kind.js';
|
|
48
|
+
// Оценка контекстного окна при неизвестном окне модели — общая константа ядра
|
|
49
|
+
// и UI (browser-safe: без node:*; значение — см. `model-metadata.ts`).
|
|
50
|
+
export { DEFAULT_CONTEXT_WINDOW } from '../model-metadata.js';
|
|
45
51
|
// --- Реэкспорт существующих доменных модулей ---
|
|
46
52
|
// Tool types — re-exported from tools.ts
|
|
47
53
|
export * from './tools.js';
|
|
@@ -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).
|
|
@@ -175,6 +175,15 @@ export type TurnFinishedPayload = {
|
|
|
175
175
|
turnId: string;
|
|
176
176
|
status: TurnStatus;
|
|
177
177
|
};
|
|
178
|
+
/**
|
|
179
|
+
* ADR-119: вид служебного шага (`step.started`/`step.finished`).
|
|
180
|
+
*
|
|
181
|
+
* `compression` — шаг служебного хода сжатия контекста (суммаризация или
|
|
182
|
+
* компактизация). Такой шаг — не ответ агента: его `usage` — расход **вызова
|
|
183
|
+
* сжатия** (весь транскрипт на входе), а не занятость контекстного окна.
|
|
184
|
+
* Обычные шаги (ответ агента) вид не несут — поле необязательное.
|
|
185
|
+
*/
|
|
186
|
+
export type StepKind = 'compression';
|
|
178
187
|
/**
|
|
179
188
|
* ADR-118 §1/§4: payload события `step.started` (канал сессии) —
|
|
180
189
|
* шаг (один вызов LLM) начался; assistant-сообщение создаётся здесь.
|
|
@@ -185,6 +194,15 @@ export type StepStartedPayload = {
|
|
|
185
194
|
stepIndex: number;
|
|
186
195
|
/** Сообщение шага. */
|
|
187
196
|
messageId: string;
|
|
197
|
+
/**
|
|
198
|
+
* ADR-119: вид служебного шага (аддитивно, необязательно).
|
|
199
|
+
*
|
|
200
|
+
* `compression` — шаг служебного хода сжатия контекста (суммаризация/
|
|
201
|
+
* компактизация). Такой шаг — не ответ агента: его `usage` — расход
|
|
202
|
+
* **вызова сжатия**, а не занятость контекстного окна. Обычные шаги
|
|
203
|
+
* (ответ агента) поле не несут.
|
|
204
|
+
*/
|
|
205
|
+
kind?: StepKind;
|
|
188
206
|
};
|
|
189
207
|
/**
|
|
190
208
|
* ADR-118 §4: payload аддитивных событий `step.tools.started` /
|
|
@@ -249,6 +267,12 @@ export type StepFinishedPayload = {
|
|
|
249
267
|
turnId: string;
|
|
250
268
|
stepIndex: number;
|
|
251
269
|
messageId: string;
|
|
270
|
+
/**
|
|
271
|
+
* ADR-119: вид служебного шага (аддитивно, необязательно) — см.
|
|
272
|
+
* `StepStartedPayload.kind`. `compression` — шаг служебного хода сжатия
|
|
273
|
+
* контекста: его `usage` — расход вызова сжатия, а не занятость окна.
|
|
274
|
+
*/
|
|
275
|
+
kind?: StepKind;
|
|
252
276
|
/** Статус сообщения шага («финал» = смена статуса, ADR-118 §5). */
|
|
253
277
|
status: MessageStatus;
|
|
254
278
|
/** Расход токенов шага (замена `stream.usage`). */
|
|
@@ -338,6 +362,23 @@ export type InstanceCapabilities = {
|
|
|
338
362
|
version: string;
|
|
339
363
|
/** ADR-115: эффективные лимиты вложений (аддитивно; старые клиенты игнорируют). */
|
|
340
364
|
attachments?: InstanceAttachmentCapabilities;
|
|
365
|
+
/**
|
|
366
|
+
* PROP-125: возможности инстанса (аддитивно; старые клиенты игнорируют).
|
|
367
|
+
* `remoteMcp` — признак поддержки `/api/v2/mcp/remote/*` и relay-режима.
|
|
368
|
+
*
|
|
369
|
+
* `users` — признак, что инстанс **обслуживает `/api/v2/users*`**
|
|
370
|
+
* (управление пользователями):
|
|
371
|
+
* - managed backend — всегда `true` (маршрут смонтирован в backend);
|
|
372
|
+
* - core standalone (чистый) — `false` (маршрута нет, проксировать нечего);
|
|
373
|
+
* - core в гибриде — `true` **ровно тогда, когда удалённый backend
|
|
374
|
+
* подключён** (тогда локальный core проксирует `/api/v2/users` на него).
|
|
375
|
+
*
|
|
376
|
+
* Отсутствие поля/признака = «фичи нет» (fail-closed, как `remoteMcp`).
|
|
377
|
+
*/
|
|
378
|
+
features?: {
|
|
379
|
+
remoteMcp?: boolean;
|
|
380
|
+
users?: boolean;
|
|
381
|
+
};
|
|
341
382
|
};
|
|
342
383
|
/**
|
|
343
384
|
* ADR-118 §8: поддерживает ли инстанс текущую модель сообщений.
|
|
@@ -50,18 +50,28 @@ export interface PermissionDecision {
|
|
|
50
50
|
messageId?: string;
|
|
51
51
|
/** Параметры подстановки в сообщение ({{path}}, {{dir}}, {{command}}). */
|
|
52
52
|
params?: Record<string, string>;
|
|
53
|
+
/**
|
|
54
|
+
* Вид ask'а от shell-guard: dynamic/protected/mutation/cwd.
|
|
55
|
+
*
|
|
56
|
+
* Аддитивно: позволяет UI различать, ЧТО именно вызвало вопрос
|
|
57
|
+
* (непроверяемая динамика, защищённый путь, мутация вне периметра,
|
|
58
|
+
* неразрешённый cwd) — без разбора текста причины.
|
|
59
|
+
*/
|
|
60
|
+
askKind?: 'dynamic' | 'protected' | 'mutation' | 'cwd';
|
|
53
61
|
/**
|
|
54
62
|
* ADR-070 §2.9.1: тул недоступен не по жёсткому запрету, а из-за текущего
|
|
55
63
|
* режима (`mode`), роли агента (`role`), отсутствия внешней программы
|
|
56
64
|
* окружения (`dependency`), не заданного рабочего каталога проекта
|
|
57
|
-
* (`workspace`)
|
|
58
|
-
* деградированный read-only режим)
|
|
65
|
+
* (`workspace`), недоступного хранилища (`storage`, ADR-098 W5 —
|
|
66
|
+
* деградированный read-only режим) или политики инстанса (`policy` —
|
|
67
|
+
* PROP-124 §0: адресные ssh-тулы недоступны в режиме `ssh.mode = 'agent'`).
|
|
68
|
+
* Отличие от `deny`-политики: доступ
|
|
59
69
|
* открывается переключением режима / делегированием / установкой программы /
|
|
60
70
|
* заданием workspace / восстановлением хранилища, поэтому модель получает
|
|
61
71
|
* соответствующую подсказку (messageId).
|
|
62
72
|
*/
|
|
63
73
|
unavailable?: {
|
|
64
|
-
reason: 'mode' | 'role' | 'dependency' | 'workspace' | 'storage';
|
|
74
|
+
reason: 'mode' | 'role' | 'dependency' | 'workspace' | 'storage' | 'policy';
|
|
65
75
|
};
|
|
66
76
|
}
|
|
67
77
|
/**
|
package/dist/types/project.d.ts
CHANGED
|
@@ -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`.
|
package/dist/types/project.js
CHANGED
|
@@ -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
|
* Значения — только ключи реестра (загружаемые картинки не поддерживаются).
|
package/dist/types/prompt.d.ts
CHANGED
|
@@ -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`). */
|
|
@@ -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
|
@@ -422,6 +422,14 @@ export interface Session {
|
|
|
422
422
|
userId?: string;
|
|
423
423
|
ownerId?: string;
|
|
424
424
|
projectId?: string;
|
|
425
|
+
/**
|
|
426
|
+
* Маркер источника при переносе между инстансами (publish/import): id сессии
|
|
427
|
+
* в исходном мире. Используется как **ключ дедупликации повторного импорта** —
|
|
428
|
+
* повторная загрузка той же сессии в тот же проект обновляет существующую
|
|
429
|
+
* запись, а не создаёт дубль. Поле аддитивное: у сессий, созданных локально
|
|
430
|
+
* (и у записей до появления поля), оно отсутствует.
|
|
431
|
+
*/
|
|
432
|
+
sourceSessionId?: string;
|
|
425
433
|
/**
|
|
426
434
|
* ADR-114: привязка сессии к git-worktree — рабочий каталог сессии.
|
|
427
435
|
* Аддитивное поле: сессии, созданные до ADR-114, его не имеют и работают
|
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 {
|
package/dist/types/tools.d.ts
CHANGED
|
@@ -65,6 +65,42 @@ export declare const ToolCapability: {
|
|
|
65
65
|
* доступен и без workspace, и разрешён в plan-режиме (только чтение).
|
|
66
66
|
*/
|
|
67
67
|
readonly MODELS: "models";
|
|
68
|
+
/**
|
|
69
|
+
* Адресный SSH-доступ (PROP-124 §4): тулы, обращающиеся к удалённому хосту
|
|
70
|
+
* по SSH (`ssh_exec` и дальше `ssh_copy`/`ssh_tunnel`).
|
|
71
|
+
*
|
|
72
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/`process`:
|
|
73
|
+
* адресный SSH — доменный ресурс инстанса (реестр ключей + политика
|
|
74
|
+
* хостов/портов), а не примитив ядра. Capability **не** привязана к рабочему
|
|
75
|
+
* каталогу проекта, но **зависит от режима инстанса** `ssh.mode`: в режиме
|
|
76
|
+
* `agent` адресные тулы недоступны (`unavailable(policy)`), см.
|
|
77
|
+
* `engine/permission/availability.ts`.
|
|
78
|
+
*/
|
|
79
|
+
readonly SSH: "ssh";
|
|
80
|
+
/**
|
|
81
|
+
* Список задач сессии (ADR-039): тулы `todo_write`/`todo_list`/`todo_add`/
|
|
82
|
+
* `todo_update`/`todo_delete`.
|
|
83
|
+
*
|
|
84
|
+
* Это **операционный список задач сессии** (`session.todos`), а не план
|
|
85
|
+
* проекта (`project.plan`, тулы `plan_*`). Capability выдаётся **в
|
|
86
|
+
* дополнение** к `runtime` (совместимость с существующими/кастомными
|
|
87
|
+
* агентами): группа `runtime` продолжает матчить todo-тулы (имена остаются в
|
|
88
|
+
* `RUNTIME_TOOLS`), а правило `permission.rules.todo` работает по capability.
|
|
89
|
+
* Capability **не** привязана к рабочему каталогу проекта
|
|
90
|
+
* (`WORKSPACE_CAPABILITIES`) — список задач доступен и без workspace.
|
|
91
|
+
*/
|
|
92
|
+
readonly TODO: "todo";
|
|
93
|
+
/**
|
|
94
|
+
* Инстанс и MCP-реестр (read-only, Workstream A1): тулы `synth_info`,
|
|
95
|
+
* `synth_mcp_list`, `synth_mcp_test`.
|
|
96
|
+
*
|
|
97
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/
|
|
98
|
+
* `process`/`models`: инстанс и его MCP-реестр — доменный ресурс, а не
|
|
99
|
+
* примитив ядра. Capability **не** привязана к рабочему каталогу проекта
|
|
100
|
+
* (`WORKSPACE_CAPABILITIES`) — сведения об инстансе доступны и без workspace.
|
|
101
|
+
* Write-тулы (`synth_mcp_add`/…) — следующий шаг.
|
|
102
|
+
*/
|
|
103
|
+
readonly INSTANCE: "instance";
|
|
68
104
|
};
|
|
69
105
|
export type ToolCapability = (typeof ToolCapability)[keyof typeof ToolCapability];
|
|
70
106
|
export declare const TOOL_CAPABILITY_META: Record<string, {
|