@itphx/synth-shared 0.13.8 → 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 +74 -2
- package/dist/config/env-overrides.d.ts +16 -0
- package/dist/config/env-overrides.js +103 -3
- 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 +2 -0
- package/dist/config/index.js +2 -0
- package/dist/config/security.d.ts +77 -0
- package/dist/config/security.js +116 -0
- package/dist/config/types.d.ts +466 -34
- package/dist/config/types.js +317 -33
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +196 -13
- package/dist/index.d.ts +5 -4
- package/dist/index.js +15 -2
- package/dist/schemas/index.d.ts +156 -19
- package/dist/schemas/index.js +126 -15
- 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 +87 -1
- 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 +48 -0
- package/dist/types/index.d.ts +6 -0
- package/dist/types/index.js +18 -2
- package/dist/types/mentions.d.ts +96 -0
- package/dist/types/mentions.js +9 -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 +8 -1
- 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 +59 -2
- package/dist/types/project.js +20 -0
- 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 +12 -2
- package/dist/types/service-keys.js +13 -0
- package/dist/types/session.d.ts +60 -3
- package/dist/types/skills.d.ts +15 -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 +124 -1
- package/dist/types/tools.js +22 -0
- package/dist/types/user.d.ts +17 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +2 -2
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { SynthConfig } from './types.js';
|
|
2
|
-
import { type ExecutionFailMode, type ExecutionMode } from './types.js';
|
|
2
|
+
import { type ExecutionFailMode, type ExecutionFallback, type ExecutionMcpServer, type ExecutionMode, type ExecutionPooling, type ExecutionPoolProviderKind, type ExecutionProfileClass, type ExecutionProfileNetwork, type ExecutionProfileOrigin, type ExecutionProfileResources, type ExecutionProfileToleration } from './types.js';
|
|
3
3
|
/** Env-имена секции `execution` (ADR-077). */
|
|
4
4
|
export declare const EXECUTION_ENV: {
|
|
5
5
|
readonly mode: "SYNTH_EXECUTION_MODE";
|
|
@@ -8,6 +8,28 @@ export declare const EXECUTION_ENV: {
|
|
|
8
8
|
readonly timeoutMs: "SYNTH_EXECUTION_TIMEOUT_MS";
|
|
9
9
|
readonly concurrency: "SYNTH_EXECUTION_CONCURRENCY";
|
|
10
10
|
readonly failMode: "SYNTH_EXECUTION_FAIL_MODE";
|
|
11
|
+
/** PROP-135 Ф4a: режим пула (`instance`|`project`|`session`). */
|
|
12
|
+
readonly pooling: "SYNTH_EXECUTION_POOLING";
|
|
13
|
+
/** PROP-135 Ф4a: имя профиля по умолчанию. */
|
|
14
|
+
readonly defaultProfile: "SYNTH_EXECUTION_DEFAULT_PROFILE";
|
|
15
|
+
/** Профиль пула класса `browser` (браузер — свой образ/профиль). */
|
|
16
|
+
readonly browserProfile: "SYNTH_EXECUTION_BROWSER_PROFILE";
|
|
17
|
+
/** Браузерный контур: явный каталог браузерных профилей (csv). */
|
|
18
|
+
readonly browserProfiles: "SYNTH_EXECUTION_BROWSER_PROFILES";
|
|
19
|
+
/** Имя MCP-сервера браузера в поде исполнителя. */
|
|
20
|
+
readonly browserMcpServer: "SYNTH_EXECUTION_BROWSER_MCP_SERVER";
|
|
21
|
+
/** Таймаут одного вызова браузерного MCP-инструмента, мс. */
|
|
22
|
+
readonly browserTimeoutMs: "SYNTH_EXECUTION_BROWSER_TIMEOUT_MS";
|
|
23
|
+
/** PROP-135 Ф4a: поведение при непригодном профиле (`instance`|`fail`). */
|
|
24
|
+
readonly fallback: "SYNTH_EXECUTION_FALLBACK";
|
|
25
|
+
/** PROP-135 Ф4b-1: провайдер пулов (`static`|`http`). */
|
|
26
|
+
readonly provider: "SYNTH_EXECUTION_PROVIDER";
|
|
27
|
+
/** PROP-135 Ф4b-1: адрес provisioner'а пулов. */
|
|
28
|
+
readonly provisionerUrl: "SYNTH_EXECUTION_PROVISIONER_URL";
|
|
29
|
+
/** PROP-135 Ф4b-1: путь/ссылка на токен provisioner'а (НЕ значение). */
|
|
30
|
+
readonly provisionerToken: "SYNTH_EXECUTION_PROVISIONER_TOKEN";
|
|
31
|
+
/** PROP-135 Ф4b-1: таймаут обращения к provisioner'у, мс. */
|
|
32
|
+
readonly provisionerTimeoutMs: "SYNTH_EXECUTION_PROVISIONER_TIMEOUT_MS";
|
|
11
33
|
};
|
|
12
34
|
/** Имя CLI-флага переключателя топологии (`synth serve --execution-mode`). */
|
|
13
35
|
export declare const EXECUTION_MODE_CLI_FLAG = "--execution-mode";
|
|
@@ -17,6 +39,71 @@ export declare const EXECUTION_MODE_CLI_FLAG = "--execution-mode";
|
|
|
17
39
|
* `os.cpus().length`.
|
|
18
40
|
*/
|
|
19
41
|
export declare function defaultExecutionConcurrency(): number;
|
|
42
|
+
/**
|
|
43
|
+
* Эффективные параметры **профиля** исполнения (PROP-135 Ф4a).
|
|
44
|
+
*
|
|
45
|
+
* Профиль — «поверх» общих параметров секции: незаданное поле наследует
|
|
46
|
+
* общее (`execution.remote.*`). Пустой `url` профиля наследует общий
|
|
47
|
+
* `execution.remote.url`; если и он пуст — профиль непригоден (решает
|
|
48
|
+
* `execution.remote.fallback`).
|
|
49
|
+
*/
|
|
50
|
+
export interface ResolvedExecutionProfile {
|
|
51
|
+
/** Адреса исполнителей профиля (пусто — непригоден). */
|
|
52
|
+
url: string[];
|
|
53
|
+
/** Таймаут exec-вызова, мс. */
|
|
54
|
+
timeoutMs: number;
|
|
55
|
+
/** Лимит одновременных exec-вызовов. */
|
|
56
|
+
concurrency: number;
|
|
57
|
+
/** Поведение при недоступном исполнителе. */
|
|
58
|
+
failMode: ExecutionFailMode;
|
|
59
|
+
/**
|
|
60
|
+
* Метаданные профиля (PROP-135, для admin-API/UI). На маршрутизацию и
|
|
61
|
+
* создание портов не влияют; незаданное поле отсутствует.
|
|
62
|
+
*/
|
|
63
|
+
description?: string;
|
|
64
|
+
image?: string;
|
|
65
|
+
network?: ExecutionProfileNetwork;
|
|
66
|
+
resources?: ExecutionProfileResources;
|
|
67
|
+
runtimeClass?: string;
|
|
68
|
+
/**
|
|
69
|
+
* Произвольные аннотации пода (`metadata.annotations`).
|
|
70
|
+
*
|
|
71
|
+
* Служебные аннотации provisioner'а (`synth.io/*`) приоритетнее: конфликт
|
|
72
|
+
* решается в пользу служебных (иначе под перестал бы усыновляться).
|
|
73
|
+
*/
|
|
74
|
+
annotations?: Record<string, string>;
|
|
75
|
+
/** Пользовательские метки пода (`metadata.labels`). */
|
|
76
|
+
labels?: Record<string, string>;
|
|
77
|
+
/** `spec.nodeSelector` пода — отбор нод по меткам. */
|
|
78
|
+
nodeSelector?: Record<string, string>;
|
|
79
|
+
/** `spec.tolerations` пода — правила размещения на «tainted» нодах. */
|
|
80
|
+
tolerations?: ExecutionProfileToleration[];
|
|
81
|
+
/** `spec.affinity` пода — passthrough (JSON, ≤8 КиБ). */
|
|
82
|
+
affinity?: Record<string, unknown>;
|
|
83
|
+
/** Read-only корневая ФС контейнера пула (ADR-137). */
|
|
84
|
+
readOnlyRootFilesystem?: boolean;
|
|
85
|
+
/**
|
|
86
|
+
* Дополнительные переменные окружения пула (ADR-135, runtime-каталог).
|
|
87
|
+
* **Секретов здесь быть не должно** (инвариант 13) — наружу не отдаются
|
|
88
|
+
* (`GET /api/v2/execution/profiles` отдаёт только метаданные профиля).
|
|
89
|
+
*/
|
|
90
|
+
env?: Record<string, string>;
|
|
91
|
+
/**
|
|
92
|
+
* **Объявленный** класс профиля (ADR-135, аддендум §11): `exec` | `browser` |
|
|
93
|
+
* `both`. Не задан — класс выводится (legacy-список `browserProfiles` и
|
|
94
|
+
* профиль по умолчанию `browserProfile` → `browser`, иначе `exec`); см.
|
|
95
|
+
* `effectiveProfileClass`.
|
|
96
|
+
*/
|
|
97
|
+
class?: ExecutionProfileClass;
|
|
98
|
+
/**
|
|
99
|
+
* MCP-серверы профиля (имя + команда, если известна).
|
|
100
|
+
*
|
|
101
|
+
* Config-уровень хранит только **имена** (`{ name }`); runtime-каталог —
|
|
102
|
+
* полное описание (команда нужна provisioner'у, чтобы запустить сервер в
|
|
103
|
+
* поде).
|
|
104
|
+
*/
|
|
105
|
+
mcpServers?: ExecutionMcpServer[];
|
|
106
|
+
}
|
|
20
107
|
/** Эффективные параметры удалённого исполнителя. */
|
|
21
108
|
export interface ResolvedExecutionRemoteConfig {
|
|
22
109
|
/** Список адресов исполнителей (пусто — при `remote` fail-closed на старте). */
|
|
@@ -29,6 +116,65 @@ export interface ResolvedExecutionRemoteConfig {
|
|
|
29
116
|
failMode: ExecutionFailMode;
|
|
30
117
|
/** Путь/ссылка на токен исполнителя (НЕ значение — инвариант 13). */
|
|
31
118
|
tokenSecret: string;
|
|
119
|
+
/** Режим пула исполнителей (PROP-135 Ф4a). */
|
|
120
|
+
pooling: ExecutionPooling;
|
|
121
|
+
/** Имя профиля по умолчанию (PROP-135 Ф4a). */
|
|
122
|
+
defaultProfile: string;
|
|
123
|
+
/**
|
|
124
|
+
* Имя профиля для пула класса `browser`: браузер — проектный пул со своим
|
|
125
|
+
* образом, поэтому `class: 'browser'` не наследует `defaultProfile`.
|
|
126
|
+
*/
|
|
127
|
+
browserProfile: string;
|
|
128
|
+
/**
|
|
129
|
+
* PROP-135 (браузерный контур): явный каталог браузерных профилей.
|
|
130
|
+
* Пусто — эффективный каталог равен `[browserProfile]` (см.
|
|
131
|
+
* `resolveBrowserProfileNames`).
|
|
132
|
+
*/
|
|
133
|
+
browserProfiles: string[];
|
|
134
|
+
/**
|
|
135
|
+
* Отключённые профили config-базы (ADR-135, аддендум §11): имена,
|
|
136
|
+
* скрытые из эффективного каталога. Пусто — отключённых нет.
|
|
137
|
+
*/
|
|
138
|
+
disabledProfiles?: string[];
|
|
139
|
+
/**
|
|
140
|
+
* Происхождение профилей эффективного каталога (ADR-135, аддендум §11):
|
|
141
|
+
* `config` — профиль из `config.yaml` (его можно отключить), `runtime` —
|
|
142
|
+
* создан в runtime-каталоге (удаляется удалением из `profiles`).
|
|
143
|
+
*
|
|
144
|
+
* Аддитивное поле для UI; в схему runtime-секции **не** входит.
|
|
145
|
+
*/
|
|
146
|
+
profileOrigins?: Record<string, ExecutionProfileOrigin>;
|
|
147
|
+
/** Имя MCP-сервера браузера в поде исполнителя (встроенные `browser_*`). */
|
|
148
|
+
browserMcpServer: string;
|
|
149
|
+
/**
|
|
150
|
+
* Таймаут одного вызова браузерного MCP-инструмента, мс.
|
|
151
|
+
*
|
|
152
|
+
* Общая настройка секции (профили её не переопределяют). Не задана —
|
|
153
|
+
* дефолт клиента удалённого порта (`BROWSER_MCP_CALL_TIMEOUT_MS`).
|
|
154
|
+
*/
|
|
155
|
+
browserTimeoutMs?: number;
|
|
156
|
+
/** Эффективные параметры профилей (PROP-135 Ф4a) — по имени профиля. */
|
|
157
|
+
profiles: Record<string, ResolvedExecutionProfile>;
|
|
158
|
+
/** Поведение при непригодном профиле (PROP-135 Ф4a). */
|
|
159
|
+
fallback: ExecutionFallback;
|
|
160
|
+
/** Провайдер пулов (PROP-135 Ф4b-1): `static` — из конфигурации, `http` — provisioner. */
|
|
161
|
+
provider: ExecutionPoolProviderKind;
|
|
162
|
+
/** Параметры provisioner'а пулов (PROP-135 Ф4b-1). */
|
|
163
|
+
provisioner: ResolvedExecutionProvisioner;
|
|
164
|
+
}
|
|
165
|
+
/**
|
|
166
|
+
* Эффективные параметры provisioner'а пулов (PROP-135 Ф4b-1).
|
|
167
|
+
*
|
|
168
|
+
* `tokenSecret` — **путь/ссылка**, НЕ значение (инвариант 13): значение
|
|
169
|
+
* читается из файла в момент обращения к provisioner'у.
|
|
170
|
+
*/
|
|
171
|
+
export interface ResolvedExecutionProvisioner {
|
|
172
|
+
/** Адрес provisioner'а (пусто при `provider: http` → fail-closed на старте). */
|
|
173
|
+
url: string;
|
|
174
|
+
/** Путь/ссылка на токен provisioner'а (НЕ значение). */
|
|
175
|
+
tokenSecret: string;
|
|
176
|
+
/** Таймаут обращения к provisioner'у, мс. */
|
|
177
|
+
timeoutMs: number;
|
|
32
178
|
}
|
|
33
179
|
/** Эффективная секция `execution`. */
|
|
34
180
|
export interface ResolvedExecutionConfig {
|
|
@@ -42,11 +188,66 @@ export interface ExecutionCliOverride {
|
|
|
42
188
|
}
|
|
43
189
|
export declare function isExecutionMode(value: unknown): value is ExecutionMode;
|
|
44
190
|
export declare function isExecutionFailMode(value: unknown): value is ExecutionFailMode;
|
|
191
|
+
/** Предикат режима пула (PROP-135 Ф4a). */
|
|
192
|
+
export declare function isExecutionPooling(value: unknown): value is ExecutionPooling;
|
|
193
|
+
/** Предикат поведения при непригодном профиле (PROP-135 Ф4a). */
|
|
194
|
+
export declare function isExecutionFallback(value: unknown): value is ExecutionFallback;
|
|
195
|
+
/** Предикат провайдера пулов (PROP-135 Ф4b-1). */
|
|
196
|
+
export declare function isExecutionPoolProvider(value: unknown): value is ExecutionPoolProviderKind;
|
|
45
197
|
/**
|
|
46
198
|
* Разбор списка адресов исполнителей: строка через запятую (`a, b`) — как у
|
|
47
199
|
* прочих списков конфигурации (`proxy.noProxy`). Пустые элементы отбрасываются.
|
|
48
200
|
*/
|
|
49
201
|
export declare function parseExecutionUrlList(raw: string): string[];
|
|
202
|
+
/**
|
|
203
|
+
* Нормализация списка имён профилей: trim, пустые отбрасываются, дубликаты
|
|
204
|
+
* схлопываются (порядок первого вхождения сохраняется).
|
|
205
|
+
*/
|
|
206
|
+
export declare function normalizeProfileNameList(names: readonly string[] | undefined): string[];
|
|
207
|
+
/**
|
|
208
|
+
* Эффективный класс профиля (ADR-135, аддендум §11).
|
|
209
|
+
*
|
|
210
|
+
* Порядок:
|
|
211
|
+
* 1. **объявленный** класс профиля (`class`) — важнее всего;
|
|
212
|
+
* 2. legacy-список `browserProfiles` — профиль из списка браузерный;
|
|
213
|
+
* 3. профиль по умолчанию `browserProfile` — браузерный (у браузера свой
|
|
214
|
+
* образ/MCP-сервер);
|
|
215
|
+
* 4. иначе — `exec`.
|
|
216
|
+
*
|
|
217
|
+
* Класс определяет каталоги: exec — `exec|both`, браузерный — `browser|both`.
|
|
218
|
+
*/
|
|
219
|
+
export declare function effectiveProfileClass(profile: {
|
|
220
|
+
class?: ExecutionProfileClass;
|
|
221
|
+
} | undefined, name: string, browserProfiles: readonly string[] | undefined, browserProfile: string | undefined): ExecutionProfileClass;
|
|
222
|
+
/**
|
|
223
|
+
* Эффективный каталог **браузерных** профилей (PROP-135, браузерный контур).
|
|
224
|
+
*
|
|
225
|
+
* Состав:
|
|
226
|
+
* - профили с классом `browser`/`both`;
|
|
227
|
+
* - legacy-список `execution.remote.browserProfiles` (подсказка класса);
|
|
228
|
+
* - профиль по умолчанию `browserProfile`.
|
|
229
|
+
*
|
|
230
|
+
* Пустой каталог — когда не задано ни одного имени (браузер не настроен).
|
|
231
|
+
*/
|
|
232
|
+
export declare function resolveBrowserProfileNames(remote: {
|
|
233
|
+
browserProfiles?: readonly string[];
|
|
234
|
+
browserProfile?: string;
|
|
235
|
+
profiles?: Record<string, {
|
|
236
|
+
class?: ExecutionProfileClass;
|
|
237
|
+
}>;
|
|
238
|
+
} | undefined): string[];
|
|
239
|
+
/**
|
|
240
|
+
* Каталог профилей **исполнения** (exec) — без имён браузерного каталога.
|
|
241
|
+
*
|
|
242
|
+
* В каталог входят профили с классом `exec`/`both` плюс профиль по умолчанию
|
|
243
|
+
* (`defaultProfile` — единственная точка отката exec-контура, даже если он
|
|
244
|
+
* браузерный). Имена из legacy-списка `browserProfiles` и браузерный профиль
|
|
245
|
+
* по умолчанию в exec-каталог **не** входят.
|
|
246
|
+
*/
|
|
247
|
+
export declare function resolveExecutionProfileNames(remote: Pick<ResolvedExecutionRemoteConfig, 'profiles' | 'defaultProfile'> & {
|
|
248
|
+
browserProfiles?: readonly string[];
|
|
249
|
+
browserProfile?: string;
|
|
250
|
+
}): string[];
|
|
50
251
|
/**
|
|
51
252
|
* Резолвит режим исполнения. Приоритет: CLI-флаг > env `SYNTH_EXECUTION_MODE` >
|
|
52
253
|
* `config.execution.mode` > `inline`.
|