@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
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";
|
|
@@ -65,12 +66,151 @@ export declare const ToolCapability: {
|
|
|
65
66
|
* доступен и без workspace, и разрешён в plan-режиме (только чтение).
|
|
66
67
|
*/
|
|
67
68
|
readonly MODELS: "models";
|
|
69
|
+
/**
|
|
70
|
+
* Адресный SSH-доступ (PROP-124 §4): тулы, обращающиеся к удалённому хосту
|
|
71
|
+
* по SSH (`ssh_exec` и дальше `ssh_copy`/`ssh_tunnel`).
|
|
72
|
+
*
|
|
73
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/`process`:
|
|
74
|
+
* адресный SSH — доменный ресурс инстанса (реестр ключей + политика
|
|
75
|
+
* хостов/портов), а не примитив ядра. Capability **не** привязана к рабочему
|
|
76
|
+
* каталогу проекта, но **зависит от режима инстанса** `ssh.mode`: в режиме
|
|
77
|
+
* `agent` адресные тулы недоступны (`unavailable(policy)`), см.
|
|
78
|
+
* `engine/permission/availability.ts`.
|
|
79
|
+
*/
|
|
80
|
+
readonly SSH: "ssh";
|
|
81
|
+
/**
|
|
82
|
+
* Список задач сессии (ADR-039): тулы `todo_write`/`todo_list`/`todo_add`/
|
|
83
|
+
* `todo_update`/`todo_delete`.
|
|
84
|
+
*
|
|
85
|
+
* Это **операционный список задач сессии** (`session.todos`), а не план
|
|
86
|
+
* проекта (`project.plan`, тулы `plan_*`). Capability выдаётся **в
|
|
87
|
+
* дополнение** к `runtime` (совместимость с существующими/кастомными
|
|
88
|
+
* агентами): группа `runtime` продолжает матчить todo-тулы (имена остаются в
|
|
89
|
+
* `RUNTIME_TOOLS`), а правило `permission.rules.todo` работает по capability.
|
|
90
|
+
* Capability **не** привязана к рабочему каталогу проекта
|
|
91
|
+
* (`WORKSPACE_CAPABILITIES`) — список задач доступен и без workspace.
|
|
92
|
+
*/
|
|
93
|
+
readonly TODO: "todo";
|
|
94
|
+
/**
|
|
95
|
+
* Инстанс и MCP-реестр (read-only, Workstream A1): тулы `synth_info`,
|
|
96
|
+
* `synth_mcp_list`, `synth_mcp_test`.
|
|
97
|
+
*
|
|
98
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/
|
|
99
|
+
* `process`/`models`: инстанс и его MCP-реестр — доменный ресурс, а не
|
|
100
|
+
* примитив ядра. Capability **не** привязана к рабочему каталогу проекта
|
|
101
|
+
* (`WORKSPACE_CAPABILITIES`) — сведения об инстансе доступны и без workspace.
|
|
102
|
+
* Write-тулы (`synth_mcp_add`/…) — следующий шаг.
|
|
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";
|
|
68
123
|
};
|
|
69
124
|
export type ToolCapability = (typeof ToolCapability)[keyof typeof ToolCapability];
|
|
70
125
|
export declare const TOOL_CAPABILITY_META: Record<string, {
|
|
71
126
|
label: string;
|
|
72
127
|
description: string;
|
|
73
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
|
+
}
|
|
74
214
|
export interface ToolContext {
|
|
75
215
|
sessionId: string;
|
|
76
216
|
messageId: string;
|
|
@@ -109,6 +249,17 @@ export interface ToolContext {
|
|
|
109
249
|
worktreeRepoPath?: string;
|
|
110
250
|
dataDir?: string;
|
|
111
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;
|
|
112
263
|
}
|
|
113
264
|
/**
|
|
114
265
|
* ADR-115 §«Медиа из инструментов»: ссылка на вложение, которое тул положил в
|
|
@@ -165,7 +316,7 @@ export type ToolSource = 'builtin' | 'mcp' | 'plugin';
|
|
|
165
316
|
export interface ToolDefinition {
|
|
166
317
|
name: string;
|
|
167
318
|
description: string;
|
|
168
|
-
parameters: z.ZodTypeAny
|
|
319
|
+
parameters: z.ZodTypeAny;
|
|
169
320
|
capabilities: ToolCapability[];
|
|
170
321
|
execute: ToolExecutor;
|
|
171
322
|
jsonSchema?: Record<string, unknown>;
|
|
@@ -190,6 +341,14 @@ export interface ToolDefinition {
|
|
|
190
341
|
* (`provides.tools[]`).
|
|
191
342
|
*/
|
|
192
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;
|
|
193
352
|
}
|
|
194
353
|
export interface ToolForLLM {
|
|
195
354
|
type: 'function';
|
package/dist/types/tools.js
CHANGED
|
@@ -64,6 +64,60 @@ export const ToolCapability = {
|
|
|
64
64
|
* доступен и без workspace, и разрешён в plan-режиме (только чтение).
|
|
65
65
|
*/
|
|
66
66
|
MODELS: 'models',
|
|
67
|
+
/**
|
|
68
|
+
* Адресный SSH-доступ (PROP-124 §4): тулы, обращающиеся к удалённому хосту
|
|
69
|
+
* по SSH (`ssh_exec` и дальше `ssh_copy`/`ssh_tunnel`).
|
|
70
|
+
*
|
|
71
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/`process`:
|
|
72
|
+
* адресный SSH — доменный ресурс инстанса (реестр ключей + политика
|
|
73
|
+
* хостов/портов), а не примитив ядра. Capability **не** привязана к рабочему
|
|
74
|
+
* каталогу проекта, но **зависит от режима инстанса** `ssh.mode`: в режиме
|
|
75
|
+
* `agent` адресные тулы недоступны (`unavailable(policy)`), см.
|
|
76
|
+
* `engine/permission/availability.ts`.
|
|
77
|
+
*/
|
|
78
|
+
SSH: 'ssh',
|
|
79
|
+
/**
|
|
80
|
+
* Список задач сессии (ADR-039): тулы `todo_write`/`todo_list`/`todo_add`/
|
|
81
|
+
* `todo_update`/`todo_delete`.
|
|
82
|
+
*
|
|
83
|
+
* Это **операционный список задач сессии** (`session.todos`), а не план
|
|
84
|
+
* проекта (`project.plan`, тулы `plan_*`). Capability выдаётся **в
|
|
85
|
+
* дополнение** к `runtime` (совместимость с существующими/кастомными
|
|
86
|
+
* агентами): группа `runtime` продолжает матчить todo-тулы (имена остаются в
|
|
87
|
+
* `RUNTIME_TOOLS`), а правило `permission.rules.todo` работает по capability.
|
|
88
|
+
* Capability **не** привязана к рабочему каталогу проекта
|
|
89
|
+
* (`WORKSPACE_CAPABILITIES`) — список задач доступен и без workspace.
|
|
90
|
+
*/
|
|
91
|
+
TODO: 'todo',
|
|
92
|
+
/**
|
|
93
|
+
* Инстанс и MCP-реестр (read-only, Workstream A1): тулы `synth_info`,
|
|
94
|
+
* `synth_mcp_list`, `synth_mcp_test`.
|
|
95
|
+
*
|
|
96
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/
|
|
97
|
+
* `process`/`models`: инстанс и его MCP-реестр — доменный ресурс, а не
|
|
98
|
+
* примитив ядра. Capability **не** привязана к рабочему каталогу проекта
|
|
99
|
+
* (`WORKSPACE_CAPABILITIES`) — сведения об инстансе доступны и без workspace.
|
|
100
|
+
* Write-тулы (`synth_mcp_add`/…) — следующий шаг.
|
|
101
|
+
*/
|
|
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',
|
|
67
121
|
};
|
|
68
122
|
export const TOOL_CAPABILITY_META = {
|
|
69
123
|
[ToolCapability.FILE_READ]: { label: 'Чтение файлов', description: 'read_file, list_directory, glob' },
|
|
@@ -98,4 +152,20 @@ export const TOOL_CAPABILITY_META = {
|
|
|
98
152
|
label: 'Модели',
|
|
99
153
|
description: 'list_models',
|
|
100
154
|
},
|
|
155
|
+
[ToolCapability.SSH]: {
|
|
156
|
+
label: 'Удалённый SSH',
|
|
157
|
+
description: 'ssh_exec',
|
|
158
|
+
},
|
|
159
|
+
[ToolCapability.TODO]: {
|
|
160
|
+
label: 'Список задач сессии',
|
|
161
|
+
description: 'todo_write, todo_list, todo_add, todo_update, todo_delete',
|
|
162
|
+
},
|
|
163
|
+
[ToolCapability.INSTANCE]: {
|
|
164
|
+
label: 'Инстанс и MCP',
|
|
165
|
+
description: 'synth_info, synth_mcp_list, synth_mcp_test',
|
|
166
|
+
},
|
|
167
|
+
[ToolCapability.TERMINAL]: {
|
|
168
|
+
label: 'Терминалы',
|
|
169
|
+
description: 'terminal_list, terminal_open, terminal_read, terminal_write, terminal_close',
|
|
170
|
+
},
|
|
101
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;
|
|
@@ -26,6 +33,13 @@ export interface TestUser {
|
|
|
26
33
|
export interface AuthConfig {
|
|
27
34
|
debugMode: boolean;
|
|
28
35
|
apiKey?: string;
|
|
36
|
+
/**
|
|
37
|
+
* Роли, выдаваемые пользователю единого API-ключа (`auth.apiKey` /
|
|
38
|
+
* `SYNTH_API_KEY`) вне debug/OIDC. По умолчанию `['USER']` — права ADMIN
|
|
39
|
+
* выдаются только **явной** настройкой (`auth.apiKeyRoles` /
|
|
40
|
+
* `SYNTH_API_KEY_ROLES`), а не по факту наличия ключа.
|
|
41
|
+
*/
|
|
42
|
+
apiKeyRoles?: GlobalRole[];
|
|
29
43
|
testUsers?: TestUser[];
|
|
30
44
|
sessionMaxAgeMinutes: number;
|
|
31
45
|
oidc?: {
|
|
@@ -36,6 +50,16 @@ export interface AuthConfig {
|
|
|
36
50
|
redirectUri: string;
|
|
37
51
|
/** Public client_id для локального CLI/core (ROPC/device flow). Не секрет. */
|
|
38
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
|
+
};
|
|
39
63
|
};
|
|
40
64
|
}
|
|
41
65
|
/**
|
package/dist/types/worktree.d.ts
CHANGED
|
@@ -103,7 +103,7 @@ export interface SessionWorktree {
|
|
|
103
103
|
branch: string;
|
|
104
104
|
}
|
|
105
105
|
/**
|
|
106
|
-
* Что именно изменилось в инвентаре worktree
|
|
106
|
+
* Что именно изменилось в инвентаре worktree (ADR-114 §6) — значение
|
|
107
107
|
* `action` события `worktree.updated`.
|
|
108
108
|
*
|
|
109
109
|
* - `created` — создана запись (каталог + ветка);
|
package/dist/utils/index.js
CHANGED
|
@@ -39,7 +39,7 @@ export async function atomicWrite(writeFile, rename, targetPath, data) {
|
|
|
39
39
|
* строка возвращается, если NUL-байтов нет.
|
|
40
40
|
*/
|
|
41
41
|
export function stripNullBytes(value) {
|
|
42
|
-
return value.includes('\u0000') ? value.
|
|
42
|
+
return value.includes('\u0000') ? value.replaceAll('\u0000', '') : value;
|
|
43
43
|
}
|
|
44
44
|
/** Обычный объект-литерал (`{}` или `Object.create(null)`), не класс/Date/Buffer. */
|
|
45
45
|
function isPlainObjectValue(value) {
|
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",
|
|
@@ -60,6 +60,7 @@
|
|
|
60
60
|
"typecheck": "tsc --noEmit",
|
|
61
61
|
"test": "vitest run",
|
|
62
62
|
"test:watch": "vitest",
|
|
63
|
-
"clean": "rm -rf dist"
|
|
63
|
+
"clean": "rm -rf dist",
|
|
64
|
+
"lint": "eslint src/ --max-warnings 0"
|
|
64
65
|
}
|
|
65
66
|
}
|