@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.
Files changed (71) hide show
  1. package/dist/config/defaults.js +74 -2
  2. package/dist/config/env-overrides.d.ts +16 -0
  3. package/dist/config/env-overrides.js +103 -3
  4. package/dist/config/execution-runtime.d.ts +89 -0
  5. package/dist/config/execution-runtime.js +506 -0
  6. package/dist/config/execution.d.ts +202 -1
  7. package/dist/config/execution.js +459 -3
  8. package/dist/config/index.d.ts +2 -0
  9. package/dist/config/index.js +2 -0
  10. package/dist/config/security.d.ts +77 -0
  11. package/dist/config/security.js +116 -0
  12. package/dist/config/types.d.ts +466 -34
  13. package/dist/config/types.js +317 -33
  14. package/dist/i18n/index.d.ts +1 -1
  15. package/dist/i18n/index.js +196 -13
  16. package/dist/index.d.ts +5 -4
  17. package/dist/index.js +15 -2
  18. package/dist/schemas/index.d.ts +156 -19
  19. package/dist/schemas/index.js +126 -15
  20. package/dist/skills/frontmatter.js +1 -1
  21. package/dist/types/agent.d.ts +29 -1
  22. package/dist/types/authority.d.ts +10 -0
  23. package/dist/types/authority.js +8 -0
  24. package/dist/types/bus-events.d.ts +87 -1
  25. package/dist/types/catalog.d.ts +1 -1
  26. package/dist/types/catalog.js +1 -1
  27. package/dist/types/command-audit.d.ts +91 -0
  28. package/dist/types/command-audit.js +44 -0
  29. package/dist/types/commands.d.ts +29 -11
  30. package/dist/types/commands.js +2 -2
  31. package/dist/types/egress.d.ts +18 -3
  32. package/dist/types/egress.js +18 -3
  33. package/dist/types/events.d.ts +23 -2
  34. package/dist/types/execution.d.ts +424 -0
  35. package/dist/types/execution.js +355 -0
  36. package/dist/types/file-kind.d.ts +3 -2
  37. package/dist/types/file-kind.js +11 -2
  38. package/dist/types/git.d.ts +48 -0
  39. package/dist/types/index.d.ts +6 -0
  40. package/dist/types/index.js +18 -2
  41. package/dist/types/mentions.d.ts +96 -0
  42. package/dist/types/mentions.js +9 -0
  43. package/dist/types/message.d.ts +24 -1
  44. package/dist/types/message.js +13 -0
  45. package/dist/types/pack.d.ts +21 -21
  46. package/dist/types/pack.js +4 -4
  47. package/dist/types/permission.d.ts +8 -1
  48. package/dist/types/pipeline.d.ts +2 -2
  49. package/dist/types/plugin-protocol.d.ts +203 -4
  50. package/dist/types/plugin-protocol.js +77 -4
  51. package/dist/types/project-access.d.ts +94 -0
  52. package/dist/types/project-access.js +140 -0
  53. package/dist/types/project.d.ts +59 -2
  54. package/dist/types/project.js +20 -0
  55. package/dist/types/schedules.d.ts +49 -3
  56. package/dist/types/schedules.js +50 -1
  57. package/dist/types/scripts.d.ts +98 -0
  58. package/dist/types/scripts.js +14 -0
  59. package/dist/types/service-keys.d.ts +12 -2
  60. package/dist/types/service-keys.js +13 -0
  61. package/dist/types/session.d.ts +60 -3
  62. package/dist/types/skills.d.ts +15 -11
  63. package/dist/types/skills.js +6 -6
  64. package/dist/types/timers.d.ts +402 -0
  65. package/dist/types/timers.js +166 -0
  66. package/dist/types/tools.d.ts +124 -1
  67. package/dist/types/tools.js +22 -0
  68. package/dist/types/user.d.ts +17 -0
  69. package/dist/version.d.ts +1 -1
  70. package/dist/version.js +1 -1
  71. package/package.json +2 -2
@@ -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<any>;
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';
@@ -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
  };
@@ -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.8";
1
+ export declare const SYNTH_VERSION = "0.13.10";
package/dist/version.js CHANGED
@@ -1 +1 @@
1
- export const SYNTH_VERSION = '0.13.8';
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.8",
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 1"
64
+ "lint": "eslint src/ --max-warnings 0"
65
65
  }
66
66
  }