@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
package/dist/types/tools.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { z } from 'zod';
|
|
2
|
+
import type { CatalogTrustLevel } from './trust.js';
|
|
2
3
|
export declare const ToolCapability: {
|
|
3
4
|
readonly FILE_READ: "file_read";
|
|
4
5
|
readonly FILE_WRITE: "file_write";
|
|
@@ -101,12 +102,115 @@ export declare const ToolCapability: {
|
|
|
101
102
|
* Write-тулы (`synth_mcp_add`/…) — следующий шаг.
|
|
102
103
|
*/
|
|
103
104
|
readonly INSTANCE: "instance";
|
|
105
|
+
/**
|
|
106
|
+
* Интерактивные терминалы (PROP-132, Ф5): тулы `terminal_list`/
|
|
107
|
+
* `terminal_open`/`terminal_read`/`terminal_write`/`terminal_close`.
|
|
108
|
+
*
|
|
109
|
+
* Отдельная capability, а не `shell`: терминал — **доменный ресурс
|
|
110
|
+
* инстанса** (реестр живых терминалов в памяти процесса + PTY на точке
|
|
111
|
+
* исполнения), а не примитив ядра. Capability **не** привязана к рабочему
|
|
112
|
+
* каталогу проекта (`WORKSPACE_CAPABILITIES`) — терминал открывается в
|
|
113
|
+
* каталоге, который вычисляет сервер (`session.worktree.directory` →
|
|
114
|
+
* `project.workspace`).
|
|
115
|
+
*
|
|
116
|
+
* Доступность — по **мастер-выключателю инстанса** `terminal.enabled`:
|
|
117
|
+
* выключен → тулы недоступны модели (`unavailable(policy)`), а не «deny в
|
|
118
|
+
* момент вызова». В plan-режиме разрешены только чтение (`terminal_list`/
|
|
119
|
+
* `terminal_read`); `terminal_open`/`terminal_write`/`terminal_close`
|
|
120
|
+
* заблокированы (план ничего не исполняет).
|
|
121
|
+
*/
|
|
122
|
+
readonly TERMINAL: "terminal";
|
|
104
123
|
};
|
|
105
124
|
export type ToolCapability = (typeof ToolCapability)[keyof typeof ToolCapability];
|
|
106
125
|
export declare const TOOL_CAPABILITY_META: Record<string, {
|
|
107
126
|
label: string;
|
|
108
127
|
description: string;
|
|
109
128
|
}>;
|
|
129
|
+
/**
|
|
130
|
+
* PROP-138 (Ф1): узкий runtime плагинного тула — команды и файловые операции
|
|
131
|
+
* **через порт исполнения сессии**.
|
|
132
|
+
*
|
|
133
|
+
* ## Зачем
|
|
134
|
+
*
|
|
135
|
+
* Плагинный тул с capability `file_read`/`file_write`/`shell`/`search`/
|
|
136
|
+
* `git_read`/`git_write` должен работать в контуре исполнителя сессии, а не
|
|
137
|
+
* в control plane: в split-топологии рабочий каталог живёт на исполнителе
|
|
138
|
+
* (PROP-135), а прямой доступ к ФС control plane — неподдерживаемый путь.
|
|
139
|
+
*
|
|
140
|
+
* ## Что это НЕ
|
|
141
|
+
*
|
|
142
|
+
* - Не «второй `ToolContext`» и не замена `extra`: `extra`/`dataDir` плагину
|
|
143
|
+
* по-прежнему **не передаются** (ADR-090) — здесь только два явно
|
|
144
|
+
* перечисленных метода работы с окружением;
|
|
145
|
+
* - не обход permission-слоя: runtime — это транспорт, а право на операцию
|
|
146
|
+
* решает хост (в capability-гейте — по capability тула).
|
|
147
|
+
*
|
|
148
|
+
* ## Контракт
|
|
149
|
+
*
|
|
150
|
+
* - `exec` — **argv без shell**: `[file, ...args]`. Значения аргументов не
|
|
151
|
+
* проходят через shell, поэтому классическая инъекция невозможна;
|
|
152
|
+
* - `fs` — файловые операции в том же контуре, что и команды; пути
|
|
153
|
+
* **абсолютные** (относительные резолвит вызывающий тул — от
|
|
154
|
+
* `ctx.workingDir`).
|
|
155
|
+
*/
|
|
156
|
+
export interface PluginRuntimeExecOptions {
|
|
157
|
+
/** Рабочий каталог команды (точка исполнения — исполнитель, а не control plane). */
|
|
158
|
+
cwd?: string;
|
|
159
|
+
/** Таймаут вызова, мс. Не задан — без таймаута. */
|
|
160
|
+
timeoutMs?: number;
|
|
161
|
+
}
|
|
162
|
+
/** Результат команды плагинного runtime. */
|
|
163
|
+
export interface PluginRuntimeExecResult {
|
|
164
|
+
/** Стандартный вывод. */
|
|
165
|
+
stdout: string;
|
|
166
|
+
/** Стандартный вывод ошибок. */
|
|
167
|
+
stderr: string;
|
|
168
|
+
/** Код завершения. */
|
|
169
|
+
exitCode: number;
|
|
170
|
+
}
|
|
171
|
+
/** Файловые операции плагинного runtime (через порт исполнения сессии). */
|
|
172
|
+
export interface PluginRuntimeFs {
|
|
173
|
+
/**
|
|
174
|
+
* Прочитать файл.
|
|
175
|
+
*
|
|
176
|
+
* @param path — абсолютный путь на точке исполнения.
|
|
177
|
+
* @param maxBytes — потолок размера; не задан — дефолт runtime.
|
|
178
|
+
*/
|
|
179
|
+
readFile(path: string, maxBytes?: number): Promise<Buffer>;
|
|
180
|
+
/** Записать файл (перезапись существующего — штатный режим). */
|
|
181
|
+
writeFile(path: string, data: Buffer | string): Promise<void>;
|
|
182
|
+
/** Сведения о файле/каталоге. */
|
|
183
|
+
stat(path: string): Promise<{
|
|
184
|
+
kind: 'file' | 'directory' | 'other';
|
|
185
|
+
size: number;
|
|
186
|
+
mtimeMs: number;
|
|
187
|
+
}>;
|
|
188
|
+
/** Записи каталога. */
|
|
189
|
+
readdir(path: string): Promise<Array<{
|
|
190
|
+
name: string;
|
|
191
|
+
kind: 'file' | 'directory' | 'other';
|
|
192
|
+
size: number;
|
|
193
|
+
}>>;
|
|
194
|
+
/** Канонический путь (симлинки разыменовываются). */
|
|
195
|
+
realpath(path: string): Promise<string>;
|
|
196
|
+
}
|
|
197
|
+
/**
|
|
198
|
+
* Узкий runtime плагинного тула (PROP-138, Ф1).
|
|
199
|
+
*
|
|
200
|
+
* Инжектится хостом в `ToolContext.runtime` **только** для тулов с
|
|
201
|
+
* `source: 'plugin'`. Встроенные и MCP-тулы получают контекст без изменений.
|
|
202
|
+
*/
|
|
203
|
+
export interface PluginRuntime {
|
|
204
|
+
/**
|
|
205
|
+
* Выполнить команду в контуре исполнителя сессии.
|
|
206
|
+
*
|
|
207
|
+
* @param argv — `[file, ...args]`, **без shell**.
|
|
208
|
+
* @param opts — рабочий каталог и таймаут (необязательны).
|
|
209
|
+
*/
|
|
210
|
+
exec(argv: string[], opts?: PluginRuntimeExecOptions): Promise<PluginRuntimeExecResult>;
|
|
211
|
+
/** Файловые операции в том же контуре. */
|
|
212
|
+
fs: PluginRuntimeFs;
|
|
213
|
+
}
|
|
110
214
|
export interface ToolContext {
|
|
111
215
|
sessionId: string;
|
|
112
216
|
messageId: string;
|
|
@@ -145,6 +249,17 @@ export interface ToolContext {
|
|
|
145
249
|
worktreeRepoPath?: string;
|
|
146
250
|
dataDir?: string;
|
|
147
251
|
extra?: Record<string, unknown>;
|
|
252
|
+
/**
|
|
253
|
+
* PROP-138 (Ф1): узкий runtime плагинного тула (команды и файловые операции
|
|
254
|
+
* через порт исполнения сессии).
|
|
255
|
+
*
|
|
256
|
+
* Поле **аддитивное** и заполняется хостом **только** для тулов с
|
|
257
|
+
* `source: 'plugin'`; встроенные и MCP-тулы его не видят (у них
|
|
258
|
+
* `ctx.extra` — полный контекст ядра). Плагину runtime даёт ровно то, что
|
|
259
|
+
* нужно capability-зависимым тулам (`file_read`/`file_write`/`shell`/
|
|
260
|
+
* `search`/`git_read`/`git_write`), и **не** даёт доступа к internals ядра.
|
|
261
|
+
*/
|
|
262
|
+
runtime?: PluginRuntime;
|
|
148
263
|
}
|
|
149
264
|
/**
|
|
150
265
|
* ADR-115 §«Медиа из инструментов»: ссылка на вложение, которое тул положил в
|
|
@@ -201,7 +316,7 @@ export type ToolSource = 'builtin' | 'mcp' | 'plugin';
|
|
|
201
316
|
export interface ToolDefinition {
|
|
202
317
|
name: string;
|
|
203
318
|
description: string;
|
|
204
|
-
parameters: z.ZodTypeAny
|
|
319
|
+
parameters: z.ZodTypeAny;
|
|
205
320
|
capabilities: ToolCapability[];
|
|
206
321
|
execute: ToolExecutor;
|
|
207
322
|
jsonSchema?: Record<string, unknown>;
|
|
@@ -226,6 +341,14 @@ export interface ToolDefinition {
|
|
|
226
341
|
* (`provides.tools[]`).
|
|
227
342
|
*/
|
|
228
343
|
pluginName?: string;
|
|
344
|
+
/**
|
|
345
|
+
* ADR-090 × IPI: фактический уровень доверия установки плагина на момент
|
|
346
|
+
* регистрации тула (`CatalogTrustLevel`). Матрица доверия контента
|
|
347
|
+
* (`engine/security/trust.ts`) считает результат плагинного тула
|
|
348
|
+
* `trusted` только при уровне не ниже `trusted`; не задан — `untrusted`
|
|
349
|
+
* (fail-closed). Аддитивное поле: тул без него работает как прежде.
|
|
350
|
+
*/
|
|
351
|
+
pluginTrust?: CatalogTrustLevel;
|
|
229
352
|
}
|
|
230
353
|
export interface ToolForLLM {
|
|
231
354
|
type: 'function';
|
package/dist/types/tools.js
CHANGED
|
@@ -100,6 +100,24 @@ export const ToolCapability = {
|
|
|
100
100
|
* Write-тулы (`synth_mcp_add`/…) — следующий шаг.
|
|
101
101
|
*/
|
|
102
102
|
INSTANCE: 'instance',
|
|
103
|
+
/**
|
|
104
|
+
* Интерактивные терминалы (PROP-132, Ф5): тулы `terminal_list`/
|
|
105
|
+
* `terminal_open`/`terminal_read`/`terminal_write`/`terminal_close`.
|
|
106
|
+
*
|
|
107
|
+
* Отдельная capability, а не `shell`: терминал — **доменный ресурс
|
|
108
|
+
* инстанса** (реестр живых терминалов в памяти процесса + PTY на точке
|
|
109
|
+
* исполнения), а не примитив ядра. Capability **не** привязана к рабочему
|
|
110
|
+
* каталогу проекта (`WORKSPACE_CAPABILITIES`) — терминал открывается в
|
|
111
|
+
* каталоге, который вычисляет сервер (`session.worktree.directory` →
|
|
112
|
+
* `project.workspace`).
|
|
113
|
+
*
|
|
114
|
+
* Доступность — по **мастер-выключателю инстанса** `terminal.enabled`:
|
|
115
|
+
* выключен → тулы недоступны модели (`unavailable(policy)`), а не «deny в
|
|
116
|
+
* момент вызова». В plan-режиме разрешены только чтение (`terminal_list`/
|
|
117
|
+
* `terminal_read`); `terminal_open`/`terminal_write`/`terminal_close`
|
|
118
|
+
* заблокированы (план ничего не исполняет).
|
|
119
|
+
*/
|
|
120
|
+
TERMINAL: 'terminal',
|
|
103
121
|
};
|
|
104
122
|
export const TOOL_CAPABILITY_META = {
|
|
105
123
|
[ToolCapability.FILE_READ]: { label: 'Чтение файлов', description: 'read_file, list_directory, glob' },
|
|
@@ -146,4 +164,8 @@ export const TOOL_CAPABILITY_META = {
|
|
|
146
164
|
label: 'Инстанс и MCP',
|
|
147
165
|
description: 'synth_info, synth_mcp_list, synth_mcp_test',
|
|
148
166
|
},
|
|
167
|
+
[ToolCapability.TERMINAL]: {
|
|
168
|
+
label: 'Терминалы',
|
|
169
|
+
description: 'terminal_list, terminal_open, terminal_read, terminal_write, terminal_close',
|
|
170
|
+
},
|
|
149
171
|
};
|
package/dist/types/user.d.ts
CHANGED
|
@@ -9,6 +9,13 @@ export interface User {
|
|
|
9
9
|
username: string;
|
|
10
10
|
email?: string;
|
|
11
11
|
roles: string[];
|
|
12
|
+
/**
|
|
13
|
+
* ADR-140: снимок групп IdP на момент логина (claim `groups`, отфильтрованный
|
|
14
|
+
* allowlist'ом `auth.oidc.groups.allow`). На права влияет **только** через
|
|
15
|
+
* `resolveProjectAccess` (гранты по группам); само поле — пассивный снимок,
|
|
16
|
+
* не источник прав. Пустое/отсутствующее поле — групп нет (fail-closed).
|
|
17
|
+
*/
|
|
18
|
+
groups?: string[];
|
|
12
19
|
preferredLanguage: string;
|
|
13
20
|
createdAt: string;
|
|
14
21
|
teamRole: string;
|
|
@@ -43,6 +50,16 @@ export interface AuthConfig {
|
|
|
43
50
|
redirectUri: string;
|
|
44
51
|
/** Public client_id для локального CLI/core (ROPC/device flow). Не секрет. */
|
|
45
52
|
cliClientId?: string;
|
|
53
|
+
/**
|
|
54
|
+
* ADR-140: источник групп пользователя — claim IdP и allowlist имён.
|
|
55
|
+
* Пустой allowlist — групп нет (fail-closed): «принять все» невозможно.
|
|
56
|
+
*/
|
|
57
|
+
groups?: {
|
|
58
|
+
/** Имя claim'а с группами (Keycloak — `groups`). */
|
|
59
|
+
claim?: string;
|
|
60
|
+
/** Allowlist имён групп; пусто — ни одна группа не принимается. */
|
|
61
|
+
allow?: string[];
|
|
62
|
+
};
|
|
46
63
|
};
|
|
47
64
|
}
|
|
48
65
|
/**
|
package/dist/version.d.ts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const SYNTH_VERSION = "0.13.
|
|
1
|
+
export declare const SYNTH_VERSION = "0.13.10";
|
package/dist/version.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
export const SYNTH_VERSION = '0.13.
|
|
1
|
+
export const SYNTH_VERSION = '0.13.10';
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@itphx/synth-shared",
|
|
3
|
-
"version": "0.13.
|
|
3
|
+
"version": "0.13.10",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -61,6 +61,6 @@
|
|
|
61
61
|
"test": "vitest run",
|
|
62
62
|
"test:watch": "vitest",
|
|
63
63
|
"clean": "rm -rf dist",
|
|
64
|
-
"lint": "eslint src/ --max-warnings
|
|
64
|
+
"lint": "eslint src/ --max-warnings 0"
|
|
65
65
|
}
|
|
66
66
|
}
|