@itphx/synth-shared 0.13.4 → 0.13.10
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 +102 -3
- package/dist/config/env-overrides.d.ts +39 -4
- package/dist/config/env-overrides.js +174 -4
- package/dist/config/execution-runtime.d.ts +89 -0
- package/dist/config/execution-runtime.js +506 -0
- package/dist/config/execution.d.ts +202 -1
- package/dist/config/execution.js +459 -3
- package/dist/config/index.d.ts +3 -0
- package/dist/config/index.js +3 -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/security.d.ts +77 -0
- package/dist/config/security.js +116 -0
- package/dist/config/tls.d.ts +7 -4
- package/dist/config/tls.js +10 -23
- package/dist/config/types.d.ts +568 -38
- package/dist/config/types.js +390 -33
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +325 -13
- package/dist/index.d.ts +7 -6
- package/dist/index.js +17 -4
- package/dist/model-metadata.d.ts +10 -0
- package/dist/model-metadata.js +10 -0
- package/dist/schemas/index.d.ts +444 -30
- package/dist/schemas/index.js +354 -17
- package/dist/skills/frontmatter.js +1 -1
- package/dist/types/agent.d.ts +29 -1
- package/dist/types/authority.d.ts +10 -0
- package/dist/types/authority.js +8 -0
- package/dist/types/bus-events.d.ts +88 -2
- package/dist/types/catalog.d.ts +1 -1
- package/dist/types/catalog.js +1 -1
- package/dist/types/command-audit.d.ts +91 -0
- package/dist/types/command-audit.js +44 -0
- package/dist/types/commands.d.ts +29 -11
- package/dist/types/commands.js +2 -2
- package/dist/types/egress.d.ts +18 -3
- package/dist/types/egress.js +18 -3
- package/dist/types/events.d.ts +23 -2
- package/dist/types/execution.d.ts +424 -0
- package/dist/types/execution.js +355 -0
- package/dist/types/file-kind.d.ts +3 -2
- package/dist/types/file-kind.js +11 -2
- package/dist/types/git.d.ts +131 -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 +8 -0
- package/dist/types/index.js +25 -3
- 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/mentions.d.ts +96 -0
- package/dist/types/mentions.js +9 -0
- package/dist/types/message-stream.d.ts +41 -0
- package/dist/types/message.d.ts +24 -1
- package/dist/types/message.js +13 -0
- package/dist/types/pack.d.ts +21 -21
- package/dist/types/pack.js +4 -4
- package/dist/types/permission.d.ts +20 -3
- package/dist/types/pipeline.d.ts +2 -2
- package/dist/types/plugin-protocol.d.ts +203 -4
- package/dist/types/plugin-protocol.js +77 -4
- package/dist/types/project-access.d.ts +94 -0
- package/dist/types/project-access.js +140 -0
- package/dist/types/project.d.ts +89 -2
- package/dist/types/project.js +36 -0
- package/dist/types/prompt.d.ts +4 -2
- package/dist/types/schedules.d.ts +49 -3
- package/dist/types/schedules.js +50 -1
- package/dist/types/scripts.d.ts +98 -0
- package/dist/types/scripts.js +14 -0
- package/dist/types/service-keys.d.ts +16 -3
- package/dist/types/service-keys.js +19 -1
- package/dist/types/session.d.ts +68 -3
- package/dist/types/skills.d.ts +21 -11
- package/dist/types/skills.js +6 -6
- package/dist/types/timers.d.ts +402 -0
- package/dist/types/timers.js +166 -0
- package/dist/types/tools.d.ts +160 -1
- package/dist/types/tools.js +70 -0
- package/dist/types/user.d.ts +24 -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,355 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-135: контракты секции `execution` — канонические перечисления и
|
|
3
|
+
* runtime-каталог профилей исполнения.
|
|
4
|
+
*
|
|
5
|
+
* Модуль **browser-safe** (только типы, константы и Zod): его читают и ядро
|
|
6
|
+
* (`@itphx/synth-core`), и UI (админка «Исполнение»), поэтому канонические
|
|
7
|
+
* списки значений живут здесь, а не в `config/types.ts` (config — Node-подмодуль,
|
|
8
|
+
* в UI его брать нельзя).
|
|
9
|
+
*
|
|
10
|
+
* Runtime-каталог (`ExecutionRuntimeSettings`) — **admin-owned** секция
|
|
11
|
+
* runtime-настроек: администратор управляет каталогом профилей и дефолтами
|
|
12
|
+
* через `PUT /api/v2/settings/execution`; применяется при старте процесса
|
|
13
|
+
* (`execution` — параметр запуска, инвариант 24 → `restartRequired`).
|
|
14
|
+
*/
|
|
15
|
+
import { z } from 'zod';
|
|
16
|
+
/**
|
|
17
|
+
* Топология исполнения:
|
|
18
|
+
* - `inline` (дефолт) — исполнение в процессе control plane;
|
|
19
|
+
* - `remote` — отдельные исполнители (ADR-077).
|
|
20
|
+
*/
|
|
21
|
+
export const EXECUTION_MODES = ['inline', 'remote'];
|
|
22
|
+
/**
|
|
23
|
+
* Поведение при недоступном исполнителе:
|
|
24
|
+
* - `fail` (дефолт) — fail-closed: инструмент недоступен с явной причиной;
|
|
25
|
+
* - `inline-fallback` — backend исполняет команду сам; **только явной настройкой**
|
|
26
|
+
* (в managed-контуре это обход изоляции).
|
|
27
|
+
*/
|
|
28
|
+
export const EXECUTION_FAIL_MODES = ['fail', 'inline-fallback'];
|
|
29
|
+
/**
|
|
30
|
+
* Режим пула исполнителей (PROP-135, Ф4a).
|
|
31
|
+
*
|
|
32
|
+
* - `instance` (дефолт) — общий пул инстанса: один порт на процесс;
|
|
33
|
+
* - `project` — порт на профиль для проекта (проектный пул);
|
|
34
|
+
* - `session` — порт на профиль для сессии (эксклюзивный под).
|
|
35
|
+
*/
|
|
36
|
+
export const EXECUTION_POOLINGS = ['instance', 'project', 'session'];
|
|
37
|
+
/**
|
|
38
|
+
* Поведение роутера исполнения, когда профиль непригоден (PROP-135, Ф4a):
|
|
39
|
+
* - `instance` (дефолт) — откат на instance-порт (общий пул инстанса);
|
|
40
|
+
* - `fail` — fail-closed: старт прерывается с понятной причиной.
|
|
41
|
+
*/
|
|
42
|
+
export const EXECUTION_FALLBACKS = ['instance', 'fail'];
|
|
43
|
+
/**
|
|
44
|
+
* Провайдер пулов исполнения (PROP-135, Ф4b-1):
|
|
45
|
+
* - `static` (дефолт) — пулы **из конфигурации**;
|
|
46
|
+
* - `http` — пулы запрашиваются у provisioner'а по HTTP.
|
|
47
|
+
*/
|
|
48
|
+
export const EXECUTION_POOL_PROVIDERS = ['static', 'http'];
|
|
49
|
+
/**
|
|
50
|
+
* Сетевой класс профиля исполнения (PROP-135).
|
|
51
|
+
*
|
|
52
|
+
* **Метаданные**: описывают сетевой класс пула профиля (`none` — egress
|
|
53
|
+
* запрещён, `restricted` — allowlist, `full` — без ограничений). Маршрутизацию
|
|
54
|
+
* и создание портов значение **не** меняет.
|
|
55
|
+
*/
|
|
56
|
+
export const EXECUTION_PROFILE_NETWORKS = ['none', 'restricted', 'full'];
|
|
57
|
+
/**
|
|
58
|
+
* Класс профиля исполнения (ADR-135, аддендум §11).
|
|
59
|
+
*
|
|
60
|
+
* - `exec` (дефолт) — обычные команды: профиль адресуется exec-контуром;
|
|
61
|
+
* - `browser` — браузерный профиль (свой образ/MCP-сервер): адресуется только
|
|
62
|
+
* браузерным пулом (`class: 'browser'`);
|
|
63
|
+
* - `both` — профиль годится и туда, и туда (общий образ пулов).
|
|
64
|
+
*
|
|
65
|
+
* Класс определяет, в какой каталог попадает профиль: exec-каталог —
|
|
66
|
+
* `exec|both`, браузерный — `browser|both` (см. `resolveBrowserProfileNames`/
|
|
67
|
+
* `resolveExecutionProfileNames` в `@itphx/synth-shared/config`).
|
|
68
|
+
*/
|
|
69
|
+
export const EXECUTION_PROFILE_CLASSES = ['exec', 'browser', 'both'];
|
|
70
|
+
/**
|
|
71
|
+
* Оператор toleration пода (`Exists` | `Equal`).
|
|
72
|
+
*
|
|
73
|
+
* `Exists` — переносить на ноду с любым значением ключа; `Equal` — только с
|
|
74
|
+
* указанным значением (тогда `value` обязателен).
|
|
75
|
+
*/
|
|
76
|
+
export const EXECUTION_TOLERATION_OPERATORS = ['Exists', 'Equal'];
|
|
77
|
+
/**
|
|
78
|
+
* Эффект toleration пода (`NoSchedule` | `PreferNoSchedule` | `NoExecute`).
|
|
79
|
+
*/
|
|
80
|
+
export const EXECUTION_TOLERATION_EFFECTS = ['NoSchedule', 'PreferNoSchedule', 'NoExecute'];
|
|
81
|
+
/**
|
|
82
|
+
* Предел размера блока `affinity` (JSON) — 8 КиБ.
|
|
83
|
+
*
|
|
84
|
+
* `affinity` — **passthrough**: provisioner не интерпретирует структуру, но
|
|
85
|
+
* размер ограничен (иначе в pod spec уедет произвольный объект).
|
|
86
|
+
*/
|
|
87
|
+
export const EXECUTION_AFFINITY_MAX_BYTES = 8 * 1024;
|
|
88
|
+
/**
|
|
89
|
+
* Проверка значения ресурса — формат quantity Kubernetes
|
|
90
|
+
* (`500m`, `2`, `1.5`, `4Gi`, `512Mi`, `1e3`).
|
|
91
|
+
*
|
|
92
|
+
* Fail-closed: мусор в значении ресурса Kubernetes отверг бы под — значит,
|
|
93
|
+
* отвергаем его раньше (на разборе конфигурации).
|
|
94
|
+
*/
|
|
95
|
+
export function isValidResourceQuantity(value) {
|
|
96
|
+
const trimmed = value.trim();
|
|
97
|
+
if (trimmed === '')
|
|
98
|
+
return false;
|
|
99
|
+
return /^[+-]?\d+(?:\.\d+)?(?:[eE][+-]?\d+)?(?:m|k|M|G|T|P|E|Ki|Mi|Gi|Ti|Pi|Ei)?$/.test(trimmed);
|
|
100
|
+
}
|
|
101
|
+
/** Таймаут exec-вызова по умолчанию (30 с — как у нынешних тулов). */
|
|
102
|
+
export const DEFAULT_EXECUTION_TIMEOUT_MS = 30_000;
|
|
103
|
+
/** Таймаут обращения к provisioner'у пулов по умолчанию (10 с). */
|
|
104
|
+
export const DEFAULT_EXECUTION_PROVISIONER_TIMEOUT_MS = 10_000;
|
|
105
|
+
/**
|
|
106
|
+
* Таймаут одного вызова браузерного MCP-инструмента по умолчанию (2 мин).
|
|
107
|
+
*
|
|
108
|
+
* Как у MCP-вызова в core: навигация и снимок страницы бывают медленными,
|
|
109
|
+
* но зависший вызов не должен держать ход бесконечно.
|
|
110
|
+
*/
|
|
111
|
+
export const DEFAULT_EXECUTION_BROWSER_TIMEOUT_MS = 120_000;
|
|
112
|
+
/**
|
|
113
|
+
* Потолок таймаута одного вызова браузерного MCP-инструмента (10 мин).
|
|
114
|
+
*
|
|
115
|
+
* Явное значение (конфиг инстанса или параметр `timeout` у тула) выше
|
|
116
|
+
* потолка — **ошибка конфигурации** (fail-closed), а не тихая обрезка:
|
|
117
|
+
* оператор должен знать, что его значение не применится.
|
|
118
|
+
*/
|
|
119
|
+
export const MAX_EXECUTION_BROWSER_TIMEOUT_MS = 600_000;
|
|
120
|
+
/**
|
|
121
|
+
* Имя профиля исполнения для пула класса `browser` по умолчанию.
|
|
122
|
+
*
|
|
123
|
+
* Браузер — **проектный** пул (изоляция cookies между проектами), но профиль
|
|
124
|
+
* у него свой: образ с браузером и MCP-сервером, а не образ обычных команд.
|
|
125
|
+
*/
|
|
126
|
+
export const DEFAULT_EXECUTION_BROWSER_PROFILE = 'browser';
|
|
127
|
+
/**
|
|
128
|
+
* Имя MCP-сервера браузера в поде исполнителя по умолчанию (`playwright-mcp`).
|
|
129
|
+
*/
|
|
130
|
+
export const DEFAULT_EXECUTION_BROWSER_MCP_SERVER = 'playwright-mcp';
|
|
131
|
+
/** Предел длины имени профиля/сервера (RFC 1123 для имён Kubernetes). */
|
|
132
|
+
export const EXECUTION_RUNTIME_NAME_MAX = 253;
|
|
133
|
+
/** Предел длины описания профиля в runtime-каталоге. */
|
|
134
|
+
export const EXECUTION_RUNTIME_DESCRIPTION_MAX = 200;
|
|
135
|
+
/** Предел длины значения переменной окружения профиля. */
|
|
136
|
+
export const EXECUTION_RUNTIME_ENV_VALUE_MAX = 4096;
|
|
137
|
+
/** Предел длины команды MCP-сервера профиля. */
|
|
138
|
+
export const EXECUTION_RUNTIME_COMMAND_MAX = 512;
|
|
139
|
+
/**
|
|
140
|
+
* MCP-сервер профиля в runtime-форме (ADR-135, аддендум §11).
|
|
141
|
+
*
|
|
142
|
+
* Схема принимает **строковую** форму (legacy: старые runtime-записи хранили
|
|
143
|
+
* только имена) и нормализует её в объект `{ name }`.
|
|
144
|
+
*/
|
|
145
|
+
export const executionRuntimeMcpServerSchema = z
|
|
146
|
+
.object({
|
|
147
|
+
/** Имя MCP-сервера (уникально в профиле). */
|
|
148
|
+
name: z.string().trim().min(1).max(EXECUTION_RUNTIME_NAME_MAX),
|
|
149
|
+
/** Команда запуска сервера (legacy-запись — без команды). */
|
|
150
|
+
command: z.string().trim().min(1).max(EXECUTION_RUNTIME_COMMAND_MAX).optional(),
|
|
151
|
+
/** Аргументы команды. */
|
|
152
|
+
args: z.array(z.string().max(EXECUTION_RUNTIME_COMMAND_MAX)).optional(),
|
|
153
|
+
/** Переменные окружения сервера (без секретов — инвариант 13). */
|
|
154
|
+
env: z
|
|
155
|
+
.record(z.string().trim().min(1).max(EXECUTION_RUNTIME_NAME_MAX), z.string().max(EXECUTION_RUNTIME_ENV_VALUE_MAX))
|
|
156
|
+
.optional(),
|
|
157
|
+
})
|
|
158
|
+
.strict();
|
|
159
|
+
/**
|
|
160
|
+
* MCP-серверы профиля: строки (legacy) → объекты `{ name }`.
|
|
161
|
+
*
|
|
162
|
+
* Нормализация нужна для обратной совместимости: runtime-записи, сохранённые
|
|
163
|
+
* до аддендума §11, хранят только имена серверов.
|
|
164
|
+
*/
|
|
165
|
+
const executionRuntimeMcpServersSchema = z.preprocess((raw) => Array.isArray(raw)
|
|
166
|
+
? raw.map((entry) => (typeof entry === 'string' ? { name: entry.trim() } : entry))
|
|
167
|
+
: raw, z.array(executionRuntimeMcpServerSchema));
|
|
168
|
+
/**
|
|
169
|
+
* Ключ label/annotation Kubernetes (RFC 1123 с необязательным префиксом).
|
|
170
|
+
*
|
|
171
|
+
* Значение приходит из каталога профилей (администратора) — невалидный ключ
|
|
172
|
+
* API-сервер отверг бы под целиком, поэтому проверяем на разборе.
|
|
173
|
+
*/
|
|
174
|
+
export const executionPodKeySchema = z
|
|
175
|
+
.string()
|
|
176
|
+
.trim()
|
|
177
|
+
.min(1)
|
|
178
|
+
.max(253)
|
|
179
|
+
.regex(/^([a-z0-9]([-a-z0-9.]*[a-z0-9])?\/)?[A-Za-z0-9]([-A-Za-z0-9_.]*[A-Za-z0-9])?$/, { message: 'ожидается ключ label/annotation Kubernetes' });
|
|
180
|
+
/** Значение label Kubernetes (≤63 символов, `[A-Za-z0-9._-]`). */
|
|
181
|
+
export const executionLabelValueSchema = z
|
|
182
|
+
.string()
|
|
183
|
+
.trim()
|
|
184
|
+
.max(63)
|
|
185
|
+
.regex(/^([A-Za-z0-9]([-A-Za-z0-9_.]*[A-Za-z0-9])?)?$/, {
|
|
186
|
+
message: 'ожидается значение label Kubernetes (до 63 символов)',
|
|
187
|
+
});
|
|
188
|
+
/** Значение annotation Kubernetes — произвольная строка (длиннее label'а). */
|
|
189
|
+
export const executionAnnotationValueSchema = z.string().max(4096);
|
|
190
|
+
/** Значение ресурса — количество в формате Kubernetes. */
|
|
191
|
+
const resourceQuantitySchema = z
|
|
192
|
+
.string()
|
|
193
|
+
.trim()
|
|
194
|
+
.min(1)
|
|
195
|
+
.refine(isValidResourceQuantity, {
|
|
196
|
+
message: 'ожидается количество ресурса Kubernetes (например, 500m, 2, 4Gi)',
|
|
197
|
+
});
|
|
198
|
+
/**
|
|
199
|
+
* Список ресурсов контейнера (`requests`/`limits`).
|
|
200
|
+
*
|
|
201
|
+
* Известные ключи объявлены явно, **произвольные — через `catchall`**
|
|
202
|
+
* (`nvidia.com/gpu`, `example.com/fpga`): без них GPU-профиль не задать.
|
|
203
|
+
*/
|
|
204
|
+
export const executionResourceListSchema = z
|
|
205
|
+
.object({
|
|
206
|
+
cpu: resourceQuantitySchema.optional(),
|
|
207
|
+
memory: resourceQuantitySchema.optional(),
|
|
208
|
+
ephemeralStorage: resourceQuantitySchema.optional(),
|
|
209
|
+
})
|
|
210
|
+
.catchall(resourceQuantitySchema);
|
|
211
|
+
/** Toleration профиля (placement пода). */
|
|
212
|
+
export const executionTolerationSchema = z
|
|
213
|
+
.object({
|
|
214
|
+
/** Ключ taint'а ноды. */
|
|
215
|
+
key: z.string().trim().min(1).max(253).optional(),
|
|
216
|
+
/** Оператор сопоставления. */
|
|
217
|
+
operator: z.enum(EXECUTION_TOLERATION_OPERATORS).optional(),
|
|
218
|
+
/** Значение taint'а (для `Equal`). */
|
|
219
|
+
value: z.string().trim().max(63).optional(),
|
|
220
|
+
/** Эффект toleration. */
|
|
221
|
+
effect: z.enum(EXECUTION_TOLERATION_EFFECTS).optional(),
|
|
222
|
+
/** Срок жизни toleration для `NoExecute`, с. */
|
|
223
|
+
tolerationSeconds: z.number().int().min(0).optional(),
|
|
224
|
+
})
|
|
225
|
+
.strict();
|
|
226
|
+
/**
|
|
227
|
+
* `affinity` профиля — **passthrough** (структуру не интерпретируем), но с
|
|
228
|
+
* пределом размера: блок уезжает в pod spec как есть.
|
|
229
|
+
*/
|
|
230
|
+
export const executionAffinitySchema = z
|
|
231
|
+
.record(z.string().trim().min(1).max(253), z.unknown())
|
|
232
|
+
.refine((value) => (JSON.stringify(value)?.length ?? 0) <= EXECUTION_AFFINITY_MAX_BYTES, { message: `affinity: предел ${EXECUTION_AFFINITY_MAX_BYTES} байт` });
|
|
233
|
+
/**
|
|
234
|
+
* Профиль исполнения в runtime-каталоге (ADR-135).
|
|
235
|
+
*
|
|
236
|
+
* Модель — как у профиля provisioner'а (`SYNTH_PROVISIONER_PROFILES`): образ
|
|
237
|
+
* (`image`), адрес (`url`), сетевой класс, ресурсы, runtimeClass, read-only
|
|
238
|
+
* корневая ФС, переменные окружения и **имена** MCP-серверов.
|
|
239
|
+
*
|
|
240
|
+
* `env` — переменные окружения пула; **секреты сюда не кладутся** (инвариант 13):
|
|
241
|
+
* значения секретов задаются provisioner'у/исполнителю отдельно.
|
|
242
|
+
*/
|
|
243
|
+
export const executionRuntimeProfileSchema = z
|
|
244
|
+
.object({
|
|
245
|
+
/** Человекочитаемое описание (для админ-раздела «Исполнение»). */
|
|
246
|
+
description: z.string().trim().max(EXECUTION_RUNTIME_DESCRIPTION_MAX).optional(),
|
|
247
|
+
/** Образ пула (для `kubernetes`/динамических пулов). */
|
|
248
|
+
image: z.string().trim().min(1).max(512).optional(),
|
|
249
|
+
/** Адреса исполнителей профиля (для `static`). */
|
|
250
|
+
url: z.array(z.string().trim().min(1)).optional(),
|
|
251
|
+
/** Сетевой класс профиля. */
|
|
252
|
+
network: z.enum(EXECUTION_PROFILE_NETWORKS).optional(),
|
|
253
|
+
/** Ресурсы контейнера пула (произвольные ключи — например, `nvidia.com/gpu`). */
|
|
254
|
+
resources: z
|
|
255
|
+
.object({
|
|
256
|
+
requests: executionResourceListSchema.optional(),
|
|
257
|
+
limits: executionResourceListSchema.optional(),
|
|
258
|
+
})
|
|
259
|
+
.optional(),
|
|
260
|
+
/**
|
|
261
|
+
* Произвольные аннотации пода (`metadata.annotations`).
|
|
262
|
+
*
|
|
263
|
+
* Служебные аннотации provisioner'а (`synth.io/*`) приоритетнее: конфликт
|
|
264
|
+
* решается в пользу служебных — иначе под перестал бы усыновляться.
|
|
265
|
+
*/
|
|
266
|
+
annotations: z
|
|
267
|
+
.record(executionPodKeySchema, executionAnnotationValueSchema)
|
|
268
|
+
.optional(),
|
|
269
|
+
/**
|
|
270
|
+
* Пользовательские метки пода (`metadata.labels`).
|
|
271
|
+
*
|
|
272
|
+
* Служебные метки (`synth.io/*`, `app.kubernetes.io/*`) приоритетнее.
|
|
273
|
+
*/
|
|
274
|
+
labels: z.record(executionPodKeySchema, executionLabelValueSchema).optional(),
|
|
275
|
+
/** `spec.nodeSelector` пода — отбор нод по меткам. */
|
|
276
|
+
nodeSelector: z.record(executionPodKeySchema, executionLabelValueSchema).optional(),
|
|
277
|
+
/** `spec.tolerations` пода — правила размещения на «tainted» нодах. */
|
|
278
|
+
tolerations: z.array(executionTolerationSchema).optional(),
|
|
279
|
+
/** `spec.affinity` пода — passthrough (JSON, ≤8 КиБ). */
|
|
280
|
+
affinity: executionAffinitySchema.optional(),
|
|
281
|
+
/** `runtimeClassName` пода (например, `gvisor`, `kata`). */
|
|
282
|
+
runtimeClass: z.string().trim().min(1).max(EXECUTION_RUNTIME_NAME_MAX).optional(),
|
|
283
|
+
/** Read-only корневая ФС контейнера (ADR-137; по умолчанию — у дефолта). */
|
|
284
|
+
readOnlyRootFilesystem: z.boolean().optional(),
|
|
285
|
+
/** Дополнительные переменные окружения пула (без секретов — инвариант 13). */
|
|
286
|
+
env: z
|
|
287
|
+
.record(z.string().trim().min(1).max(EXECUTION_RUNTIME_NAME_MAX), z.string().max(EXECUTION_RUNTIME_ENV_VALUE_MAX))
|
|
288
|
+
.optional(),
|
|
289
|
+
/**
|
|
290
|
+
* Класс профиля (ADR-135, аддендум §11): `exec` (дефолт) | `browser` |
|
|
291
|
+
* `both`. Не задан — `exec`, кроме профилей из legacy-списка
|
|
292
|
+
* `browserProfiles` и профиля по умолчанию `browserProfile` (для них
|
|
293
|
+
* эффективный класс — `browser`).
|
|
294
|
+
*/
|
|
295
|
+
class: z.enum(EXECUTION_PROFILE_CLASSES).optional(),
|
|
296
|
+
/**
|
|
297
|
+
* MCP-серверы профиля: имя + команда (+ аргументы/env).
|
|
298
|
+
*
|
|
299
|
+
* Строковая форма (`['playwright-mcp']`) — legacy-записи: нормализуется
|
|
300
|
+
* в `{ name }` (см. `executionRuntimeMcpServersSchema`).
|
|
301
|
+
*/
|
|
302
|
+
mcpServers: executionRuntimeMcpServersSchema.optional(),
|
|
303
|
+
})
|
|
304
|
+
.strict();
|
|
305
|
+
/**
|
|
306
|
+
* Runtime-каталог профилей исполнения и дефолтов (ADR-135).
|
|
307
|
+
*
|
|
308
|
+
* Секция runtime-настроек инстанса (`settings.json`/PG), **admin-owned**:
|
|
309
|
+
* администратор управляет каталогом и дефолтами через
|
|
310
|
+
* `GET/PUT/DELETE /api/v2/settings/execution`.
|
|
311
|
+
*
|
|
312
|
+
* Приоритет эффективного значения: **env/CLI > runtime > config.yaml**
|
|
313
|
+
* (env/CLI разрешаются внутри `resolveExecutionConfig`, ADR-023).
|
|
314
|
+
*
|
|
315
|
+
* `profiles` — **merge** поверх каталога config.yaml (аддендум §11): запись
|
|
316
|
+
* runtime-слоя **переопределяет** одноимённую запись config целиком, а
|
|
317
|
+
* config-записи, которых нет в runtime, **сохраняются**. Профили из config
|
|
318
|
+
* **не удаляются** — их можно **отключить** (`disabledProfiles`); профиль,
|
|
319
|
+
* созданный в runtime (нет в config), удаляется удалением из `profiles`.
|
|
320
|
+
*/
|
|
321
|
+
export const executionRuntimeSettingsSchema = z
|
|
322
|
+
.object({
|
|
323
|
+
/** Имя профиля по умолчанию (должен быть в каталоге). */
|
|
324
|
+
defaultProfile: z.string().trim().min(1).max(EXECUTION_RUNTIME_NAME_MAX).optional(),
|
|
325
|
+
/** Профиль пула класса `browser` (браузер — свой образ/профиль). */
|
|
326
|
+
browserProfile: z.string().trim().min(1).max(EXECUTION_RUNTIME_NAME_MAX).optional(),
|
|
327
|
+
/**
|
|
328
|
+
* Legacy-подсказка класса: имена браузерных профилей (как `browserProfiles`
|
|
329
|
+
* в config.yaml). Профили из списка получают эффективный класс `browser`,
|
|
330
|
+
* если класс не задан явно. Новые записи его не используют — класс
|
|
331
|
+
* задаётся полем `class` профиля.
|
|
332
|
+
*/
|
|
333
|
+
browserProfiles: z
|
|
334
|
+
.array(z.string().trim().min(1).max(EXECUTION_RUNTIME_NAME_MAX))
|
|
335
|
+
.optional(),
|
|
336
|
+
/**
|
|
337
|
+
* Отключённые профили **config-базы** (ADR-135, аддендум §11).
|
|
338
|
+
*
|
|
339
|
+
* Имена только из config-каталога: профиль, созданный в runtime, удаляется
|
|
340
|
+
* удалением из `profiles`. Профиль по умолчанию и браузерный профиль
|
|
341
|
+
* отключить нельзя (400) — сначала назначьте другой.
|
|
342
|
+
*/
|
|
343
|
+
disabledProfiles: z
|
|
344
|
+
.array(z.string().trim().min(1).max(EXECUTION_RUNTIME_NAME_MAX))
|
|
345
|
+
.optional(),
|
|
346
|
+
/** Режим пула исполнителей. */
|
|
347
|
+
pooling: z.enum(EXECUTION_POOLINGS).optional(),
|
|
348
|
+
/** Поведение роутера при непригодном профиле. */
|
|
349
|
+
fallback: z.enum(EXECUTION_FALLBACKS).optional(),
|
|
350
|
+
/** Каталог профилей исполнения (merge поверх каталога config.yaml). */
|
|
351
|
+
profiles: z
|
|
352
|
+
.record(z.string().trim().min(1).max(EXECUTION_RUNTIME_NAME_MAX), executionRuntimeProfileSchema)
|
|
353
|
+
.optional(),
|
|
354
|
+
})
|
|
355
|
+
.strict();
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
* по расширению» (для выбора превью и MIME).
|
|
11
11
|
*/
|
|
12
12
|
/** Семейство файла (по расширению). */
|
|
13
|
-
export type FileKind = 'text' | 'markdown' | 'code' | 'image' | 'video' | 'audio' | 'pdf' | 'binary';
|
|
13
|
+
export type FileKind = 'text' | 'markdown' | 'html' | 'code' | 'image' | 'video' | 'audio' | 'pdf' | 'binary';
|
|
14
14
|
/**
|
|
15
15
|
* Семейство файла по расширению (регистронезависимо).
|
|
16
16
|
*
|
|
@@ -35,6 +35,7 @@ export declare function fileMime(path: string): string;
|
|
|
35
35
|
* HTML/CSS/JS и прочий текст/код **в списке нет** — иначе `text/html`
|
|
36
36
|
* исполнился бы в origin приложения (XSS). Правило — на сервере:
|
|
37
37
|
* `GET /api/v2/fs/raw` для kind вне списка отдаёт `application/octet-stream`
|
|
38
|
-
* + `Content-Disposition: attachment`.
|
|
38
|
+
* + `Content-Disposition: attachment`. HTML-документы (`kind: 'html'`) UI
|
|
39
|
+
* рендерит сам — в sandbox-iframe, а не через `/fs/raw`.
|
|
39
40
|
*/
|
|
40
41
|
export declare const INLINE_PREVIEW_KINDS: readonly FileKind[];
|
package/dist/types/file-kind.js
CHANGED
|
@@ -10,6 +10,12 @@
|
|
|
10
10
|
* по расширению» (для выбора превью и MIME).
|
|
11
11
|
*/
|
|
12
12
|
const MARKDOWN_EXTENSIONS = new Set(['.md', '.markdown', '.mdown']);
|
|
13
|
+
/**
|
|
14
|
+
* HTML-документы — отдельное семейство, а не `code`: такой файл рендерится в
|
|
15
|
+
* UI в sandbox-iframe (скрипты/формы/сеть отключены), а не показывается
|
|
16
|
+
* исходником и не отдаётся inline через `GET /api/v2/fs/raw`.
|
|
17
|
+
*/
|
|
18
|
+
const HTML_EXTENSIONS = new Set(['.html', '.htm']);
|
|
13
19
|
const IMAGE_EXTENSIONS = new Set([
|
|
14
20
|
'.png', '.jpg', '.jpeg', '.gif', '.webp', '.bmp', '.ico', '.svg',
|
|
15
21
|
'.avif', '.tif', '.tiff',
|
|
@@ -26,7 +32,7 @@ const CODE_EXTENSIONS = new Set([
|
|
|
26
32
|
'.c', '.h', '.cc', '.cpp', '.hpp', '.cs', '.php', '.lua', '.pl', '.pm',
|
|
27
33
|
'.sh', '.bash', '.zsh', '.fish', '.ps1', '.bat', '.cmd',
|
|
28
34
|
'.vue', '.svelte', '.astro',
|
|
29
|
-
'.
|
|
35
|
+
'.css', '.scss', '.sass', '.less',
|
|
30
36
|
'.sql', '.graphql', '.gql', '.proto', '.prisma',
|
|
31
37
|
'.tf', '.tfvars', '.gradle', '.m', '.mm',
|
|
32
38
|
'.ex', '.exs', '.erl', '.hs', '.clj', '.groovy', '.dart', '.r', '.jl', '.nim', '.zig',
|
|
@@ -59,6 +65,8 @@ export function fileKind(path) {
|
|
|
59
65
|
return 'binary';
|
|
60
66
|
if (MARKDOWN_EXTENSIONS.has(ext))
|
|
61
67
|
return 'markdown';
|
|
68
|
+
if (HTML_EXTENSIONS.has(ext))
|
|
69
|
+
return 'html';
|
|
62
70
|
if (IMAGE_EXTENSIONS.has(ext))
|
|
63
71
|
return 'image';
|
|
64
72
|
if (VIDEO_EXTENSIONS.has(ext))
|
|
@@ -152,6 +160,7 @@ export function fileMime(path) {
|
|
|
152
160
|
* HTML/CSS/JS и прочий текст/код **в списке нет** — иначе `text/html`
|
|
153
161
|
* исполнился бы в origin приложения (XSS). Правило — на сервере:
|
|
154
162
|
* `GET /api/v2/fs/raw` для kind вне списка отдаёт `application/octet-stream`
|
|
155
|
-
* + `Content-Disposition: attachment`.
|
|
163
|
+
* + `Content-Disposition: attachment`. HTML-документы (`kind: 'html'`) UI
|
|
164
|
+
* рендерит сам — в sandbox-iframe, а не через `/fs/raw`.
|
|
156
165
|
*/
|
|
157
166
|
export const INLINE_PREVIEW_KINDS = ['image', 'video', 'audio', 'pdf'];
|
package/dist/types/git.d.ts
CHANGED
|
@@ -14,6 +14,38 @@ export interface GitRepoConfig {
|
|
|
14
14
|
sshKeyId?: string;
|
|
15
15
|
lastFetch?: string;
|
|
16
16
|
}
|
|
17
|
+
/**
|
|
18
|
+
* PROP-124: способы использования SSH-ключа.
|
|
19
|
+
*
|
|
20
|
+
* - `git` — ключ подставляется в git-операции (`GIT_SSH_COMMAND`), как раньше;
|
|
21
|
+
* - `ssh` — ключ выдаётся командам вызова (режим инстанса `agent`) или
|
|
22
|
+
* адресным тулам (режим `tools`).
|
|
23
|
+
*
|
|
24
|
+
* Поле `usages` опционально ради обратной совместимости: у ключей, созданных
|
|
25
|
+
* до Ф1, его нет — при чтении нормализуется в `['git']` (fail-closed).
|
|
26
|
+
*/
|
|
27
|
+
export type SSHKeyUsage = 'git' | 'ssh';
|
|
28
|
+
/** Канонический список типов использования SSH-ключа (PROP-124). */
|
|
29
|
+
export declare const SSH_KEY_USAGES: readonly ["git", "ssh"];
|
|
30
|
+
/**
|
|
31
|
+
* PROP-124: режим работы инстанса с SSH-ключами.
|
|
32
|
+
*
|
|
33
|
+
* - `tools` — ключ попадает к потребителю через argv адресных тулов (`-i`),
|
|
34
|
+
* политика хостов/портов на ключе обязательна;
|
|
35
|
+
* - `agent` — ключ выдаётся через эфемерный `ssh-agent` на время вызова,
|
|
36
|
+
* фильтрация по хостам не применяется (ограничение — на стороне хоста,
|
|
37
|
+
* `authorized_keys`).
|
|
38
|
+
*
|
|
39
|
+
* Дефолт — `tools` (fail-closed: без явного выбора ключ в окружение команд не
|
|
40
|
+
* попадает).
|
|
41
|
+
*/
|
|
42
|
+
export type SshMode = 'tools' | 'agent';
|
|
43
|
+
/** Канонический список режимов инстанса (PROP-124). */
|
|
44
|
+
export declare const SSH_MODES: readonly ["tools", "agent"];
|
|
45
|
+
/** Предел числа хостов в политике ключа (PROP-124) — `allowHosts`. */
|
|
46
|
+
export declare const MAX_SSH_ALLOW_HOSTS = 50;
|
|
47
|
+
/** Предел числа портов в политике ключа (PROP-124) — `allowPorts`. */
|
|
48
|
+
export declare const MAX_SSH_ALLOW_PORTS = 10;
|
|
17
49
|
/**
|
|
18
50
|
* ADR-076: SSH-ключ агента — отдельная сущность реестра (не в
|
|
19
51
|
* `AgentDefinition`). Секреты `privateKey`/`passphrase` шифруются at-rest
|
|
@@ -28,11 +60,62 @@ export interface SSHKey {
|
|
|
28
60
|
passphrase?: string;
|
|
29
61
|
/** Привязка к агентам: один ключ может обслуживать несколько агентов. */
|
|
30
62
|
agentIds: string[];
|
|
63
|
+
/**
|
|
64
|
+
* PROP-124: способы использования ключа (`git`/`ssh`). Отсутствует у ключей,
|
|
65
|
+
* созданных до Ф1 → при чтении нормализуется в `['git']`.
|
|
66
|
+
*/
|
|
67
|
+
usages?: SSHKeyUsage[];
|
|
68
|
+
/**
|
|
69
|
+
* PROP-124: политика хостов (режим `tools`): точный hostname, `*.suffix`,
|
|
70
|
+
* IP-литерал или CIDR. В режиме `agent` не применяется.
|
|
71
|
+
*/
|
|
72
|
+
allowHosts?: string[];
|
|
73
|
+
/**
|
|
74
|
+
* PROP-124: политика портов (режим `tools`): 1..65535; пусто — 22 (ssh).
|
|
75
|
+
*/
|
|
76
|
+
allowPorts?: number[];
|
|
31
77
|
createdAt: string;
|
|
32
78
|
updatedAt?: string;
|
|
33
79
|
}
|
|
34
80
|
/** Публичное представление ключа (без `privateKey`/`passphrase`). */
|
|
35
81
|
export type SSHKeyMeta = Omit<SSHKey, 'privateKey' | 'passphrase'>;
|
|
82
|
+
/**
|
|
83
|
+
* PROP-124: нормализация типов использования ключа.
|
|
84
|
+
*
|
|
85
|
+
* Поле отсутствует (ключ создан до Ф1) → `['git']` (fail-closed: git-путь
|
|
86
|
+
* работает как раньше). Явно пустой массив сохраняется пустым — но записать
|
|
87
|
+
* его больше нельзя (см. `validateSshKeyPolicy`): в таких легаси-записях ключ
|
|
88
|
+
* не проходит гейт ни для git, ни для ssh.
|
|
89
|
+
*/
|
|
90
|
+
export declare function normalizeSshKeyUsages(usages: readonly SSHKeyUsage[] | undefined): SSHKeyUsage[];
|
|
91
|
+
/**
|
|
92
|
+
* PROP-124: нормализация списка хостов — отсутствует → `[]`; элементы
|
|
93
|
+
* обрезаются от пробелов, пустые отбрасываются.
|
|
94
|
+
*/
|
|
95
|
+
export declare function normalizeSshKeyAllowHosts(hosts: readonly string[] | undefined): string[];
|
|
96
|
+
/**
|
|
97
|
+
* PROP-124: нормализация списка портов — отсутствует → `[]`.
|
|
98
|
+
* Порты-дубликаты сохраняются (смысла дедуплицировать нет, порядок важен
|
|
99
|
+
* только для отображения).
|
|
100
|
+
*/
|
|
101
|
+
export declare function normalizeSshKeyAllowPorts(ports: readonly number[] | undefined): number[];
|
|
102
|
+
/** Результат проверки политики SSH-ключа (PROP-124). */
|
|
103
|
+
export type SshKeyPolicyValidation = {
|
|
104
|
+
ok: true;
|
|
105
|
+
} | {
|
|
106
|
+
ok: false;
|
|
107
|
+
message: string;
|
|
108
|
+
};
|
|
109
|
+
/**
|
|
110
|
+
* PROP-124: проверка политики ключа — типы использования, правила хостов и
|
|
111
|
+
* порты. Fail-closed: любое нарушение → отказ с понятным сообщением
|
|
112
|
+
* (`message` — для ответа API `400 VALIDATION_ERROR`).
|
|
113
|
+
*/
|
|
114
|
+
export declare function validateSshKeyPolicy(input: {
|
|
115
|
+
usages?: readonly SSHKeyUsage[];
|
|
116
|
+
allowHosts?: readonly string[];
|
|
117
|
+
allowPorts?: readonly number[];
|
|
118
|
+
}): SshKeyPolicyValidation;
|
|
36
119
|
export interface RepoStatus {
|
|
37
120
|
path: string;
|
|
38
121
|
isRepo: boolean;
|
|
@@ -66,3 +149,51 @@ export interface CommitDetail extends CommitInfo {
|
|
|
66
149
|
*/
|
|
67
150
|
diff_truncated?: boolean;
|
|
68
151
|
}
|
|
152
|
+
/**
|
|
153
|
+
* Вид изменения файла в рабочем дереве — нормализованный (из `XY` porcelain v2).
|
|
154
|
+
*
|
|
155
|
+
* `ignored` — отдельный вид: игнорируемые файлы не «изменены», но панель файлов
|
|
156
|
+
* показывает их приглушённо (поэтому они отделяются от `untracked`).
|
|
157
|
+
*/
|
|
158
|
+
export type GitFileStatusKind = 'added' | 'modified' | 'deleted' | 'renamed' | 'typechange' | 'conflict' | 'untracked' | 'ignored';
|
|
159
|
+
/** Файл в состоянии рабочего дерева (ADR-076, `GET /api/v2/git/status`). */
|
|
160
|
+
export interface GitWorktreeFile {
|
|
161
|
+
/** Путь относительно корня репозитория, всегда через `/`. */
|
|
162
|
+
path: string;
|
|
163
|
+
/** Прежний путь для rename/copy. */
|
|
164
|
+
orig_path?: string;
|
|
165
|
+
kind: GitFileStatusKind;
|
|
166
|
+
/** Изменение в индексе (staged). */
|
|
167
|
+
staged: boolean;
|
|
168
|
+
/** Изменение в рабочем дереве (unstaged). */
|
|
169
|
+
unstaged: boolean;
|
|
170
|
+
}
|
|
171
|
+
/** Состояние рабочего дерева одного репозитория проекта. */
|
|
172
|
+
export interface GitRepoWorktreeStatus {
|
|
173
|
+
/** Путь репозитория относительно workspace (`''` — корень). */
|
|
174
|
+
path: string;
|
|
175
|
+
branch?: string;
|
|
176
|
+
ahead?: number;
|
|
177
|
+
behind?: number;
|
|
178
|
+
files: GitWorktreeFile[];
|
|
179
|
+
/** Список обрезан по лимиту записей. */
|
|
180
|
+
truncated?: boolean;
|
|
181
|
+
/** Репозиторий реестра недоступен/не git — машинный код (`git.repo_missing`). */
|
|
182
|
+
error?: string;
|
|
183
|
+
}
|
|
184
|
+
/** Ответ `GET /api/v2/git/status`: состояние рабочего дерева всех репозиториев проекта. */
|
|
185
|
+
export interface GitWorktreeStatusResponse {
|
|
186
|
+
repos: GitRepoWorktreeStatus[];
|
|
187
|
+
}
|
|
188
|
+
/** Diff рабочего дерева одного файла (или сводный — без `path`). */
|
|
189
|
+
export interface GitWorktreeDiff {
|
|
190
|
+
repo_path: string;
|
|
191
|
+
/** Путь файла (репо-относительный) или отсутствует — сводный diff набора. */
|
|
192
|
+
path?: string;
|
|
193
|
+
kind?: GitFileStatusKind;
|
|
194
|
+
diff: string;
|
|
195
|
+
diff_truncated?: boolean;
|
|
196
|
+
binary?: boolean;
|
|
197
|
+
additions?: number;
|
|
198
|
+
deletions?: number;
|
|
199
|
+
}
|