@itphx/synth-shared 0.11.3 → 0.12.3
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 +126 -3
- package/dist/config/env-overrides.d.ts +29 -0
- package/dist/config/env-overrides.js +155 -2
- package/dist/config/execution.d.ts +66 -0
- package/dist/config/execution.js +146 -0
- package/dist/config/index.d.ts +1 -0
- package/dist/config/index.js +1 -0
- package/dist/config/proxy.js +3 -1
- package/dist/config/resolve.d.ts +8 -8
- package/dist/config/resolve.js +7 -7
- package/dist/config/types.d.ts +1287 -4037
- package/dist/config/types.js +461 -68
- package/dist/i18n/index.d.ts +1 -1
- package/dist/i18n/index.js +277 -0
- package/dist/index.d.ts +14 -2
- package/dist/index.js +16 -2
- package/dist/model-metadata.d.ts +10 -0
- package/dist/schemas/index.d.ts +980 -2322
- package/dist/schemas/index.js +183 -22
- package/dist/types/analytics.d.ts +6 -6
- package/dist/types/analytics.js +4 -4
- package/dist/types/authority.d.ts +464 -0
- package/dist/types/authority.js +445 -0
- package/dist/types/background.d.ts +96 -0
- package/dist/types/background.js +24 -0
- package/dist/types/bus-events.d.ts +23 -1
- package/dist/types/catalog.d.ts +349 -0
- package/dist/types/catalog.js +393 -0
- package/dist/types/decision.d.ts +28 -337
- package/dist/types/egress.d.ts +1 -1
- package/dist/types/egress.js +1 -1
- package/dist/types/events.d.ts +54 -1
- package/dist/types/external-credentials.d.ts +352 -0
- package/dist/types/external-credentials.js +200 -0
- package/dist/types/hooks.d.ts +33 -12
- package/dist/types/index.d.ts +20 -0
- package/dist/types/index.js +50 -1
- package/dist/types/llm-filters.d.ts +150 -0
- package/dist/types/llm-filters.js +54 -0
- package/dist/types/mcp.d.ts +33 -2
- package/dist/types/mcp.js +44 -1
- package/dist/types/message.d.ts +45 -1
- package/dist/types/pack.d.ts +1102 -0
- package/dist/types/pack.js +1003 -0
- package/dist/types/permission.d.ts +25 -11
- package/dist/types/permission.js +1 -1
- package/dist/types/pipeline-engine.d.ts +453 -0
- package/dist/types/pipeline-engine.js +440 -0
- package/dist/types/pipeline.d.ts +275 -0
- package/dist/types/pipeline.js +212 -0
- package/dist/types/plugin-audit.d.ts +110 -0
- package/dist/types/plugin-audit.js +185 -0
- package/dist/types/plugin-hybrid.d.ts +85 -0
- package/dist/types/plugin-hybrid.js +68 -0
- package/dist/types/plugin-lock.d.ts +95 -0
- package/dist/types/plugin-lock.js +1 -0
- package/dist/types/plugin-protocol.d.ts +221 -0
- package/dist/types/plugin-protocol.js +322 -0
- package/dist/types/plugin-runtime.d.ts +25 -0
- package/dist/types/plugin-runtime.js +11 -0
- package/dist/types/plugin-scan.d.ts +159 -0
- package/dist/types/plugin-scan.js +166 -0
- package/dist/types/plugin-tools.d.ts +51 -0
- package/dist/types/plugin-tools.js +72 -0
- package/dist/types/project.d.ts +14 -0
- package/dist/types/prompt-blocks.d.ts +102 -0
- package/dist/types/prompt-blocks.js +24 -0
- package/dist/types/prompt.d.ts +45 -3
- package/dist/types/provider.d.ts +11 -0
- package/dist/types/question.d.ts +153 -0
- package/dist/types/question.js +65 -0
- package/dist/types/schedules.d.ts +26 -3
- package/dist/types/semver.d.ts +48 -0
- package/dist/types/semver.js +218 -0
- package/dist/types/service-keys.d.ts +41 -3
- package/dist/types/service-keys.js +44 -2
- package/dist/types/session.d.ts +54 -0
- package/dist/types/steering.d.ts +74 -0
- package/dist/types/steering.js +75 -0
- package/dist/types/tools.d.ts +125 -5
- package/dist/types/tools.js +75 -0
- package/dist/types/trust.d.ts +31 -0
- package/dist/types/trust.js +27 -0
- package/dist/types/worktree.d.ts +170 -0
- package/dist/types/worktree.js +101 -0
- package/dist/utils/index.d.ts +31 -1
- package/dist/utils/index.js +92 -12
- package/dist/utils/reasoning.d.ts +16 -0
- package/dist/utils/reasoning.js +37 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +2 -2
|
@@ -1,6 +1,11 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Семейства скоупов с wildcard-поддержкой. Глобальный `*` намеренно не вводится
|
|
3
3
|
* (ADR-052; каталог — `docs/API_V2.md` §1): `events:*` покрывает все `events:*`, но не `bindings:*`.
|
|
4
|
+
*
|
|
5
|
+
* `automation` в семейства **не** входит: `automation:install` — зонтичный скоуп
|
|
6
|
+
* установки пакета расширений, а не ресурсное семейство. Wildcard `automation:*`
|
|
7
|
+
* не вводится намеренно — иначе он молча покрывал бы будущие `automation:*`-скоупы
|
|
8
|
+
* (напр. запуск/удаление), не связанные с установкой пакета.
|
|
4
9
|
*/
|
|
5
10
|
export const SERVICE_SCOPE_FAMILIES = [
|
|
6
11
|
'events',
|
|
@@ -15,9 +20,17 @@ export const SERVICE_SCOPE_FAMILIES = [
|
|
|
15
20
|
* Точечные скоупы вне wildcard-семейств:
|
|
16
21
|
* - `llm:chat` — LLM-прокси (роут без проектного измерения);
|
|
17
22
|
* - `addons:install` — зонтичный скоуп installer-ключа: установка/обновление
|
|
18
|
-
* MCP-реестра и скиллов (
|
|
23
|
+
* MCP-реестра и скиллов (ADR-090 installer);
|
|
24
|
+
* - `automation:install` — зонтичный скоуп **установщика пакетов расширений**:
|
|
25
|
+
* агенты и их ролевые промпты, пайплайны, а также порождаемые пакетом
|
|
26
|
+
* правила маршрутизации и расписания. Для установщика пакета заменяет
|
|
27
|
+
* `addons:install`, `routes:write` и `schedules:write` (см. `SERVICE_SCOPE_SETS`);
|
|
28
|
+
* `addons:install` при этом **не** открывает создание агентов;
|
|
19
29
|
* - `users:read` — чтение пользователей/идентичностей машинной кредой
|
|
20
|
-
* (консент-сервисы аддонов)
|
|
30
|
+
* (консент-сервисы аддонов);
|
|
31
|
+
* - `plugins:invoke` — server-scoped токен плагина (ADR-090 Ф7, Уровень 2):
|
|
32
|
+
* ключ, привязанный к `plugin_id`; без этого scope сервер отвергает такой
|
|
33
|
+
* ключ (fail-closed).
|
|
21
34
|
*/
|
|
22
35
|
export const SERVICE_SCOPES = [
|
|
23
36
|
'events:ingest',
|
|
@@ -35,8 +48,27 @@ export const SERVICE_SCOPES = [
|
|
|
35
48
|
'schedules:write',
|
|
36
49
|
'llm:chat',
|
|
37
50
|
'addons:install',
|
|
51
|
+
'automation:install',
|
|
38
52
|
'users:read',
|
|
53
|
+
'plugins:invoke',
|
|
39
54
|
];
|
|
55
|
+
/**
|
|
56
|
+
* ADR-052: «любой из»-наборы скоупов для гейтов, где зонтичный
|
|
57
|
+
* `automation:install` (установщик пакета) заменяет ресурсный скоуп.
|
|
58
|
+
*
|
|
59
|
+
* Это единственное место, где выражено «замещение»: guard проверяет, что
|
|
60
|
+
* покрыт **хотя бы один** элемент набора. `routes:write`/`schedules:write`
|
|
61
|
+
* остаются самостоятельными (правка чужих правил/расписаний), а
|
|
62
|
+
* `automation:install` — доступ установщика пакета к тем же точкам.
|
|
63
|
+
*/
|
|
64
|
+
export const SERVICE_SCOPE_SETS = {
|
|
65
|
+
/** Запись правил маршрутизации: `routes:write` или установщик пакета. */
|
|
66
|
+
routesWrite: ['routes:write', 'automation:install'],
|
|
67
|
+
/** Запись расписаний: `schedules:write` или установщик пакета. */
|
|
68
|
+
schedulesWrite: ['schedules:write', 'automation:install'],
|
|
69
|
+
/** Установка агентов и их ролевых промптов: установщик пакета. */
|
|
70
|
+
agentsWrite: ['automation:install'],
|
|
71
|
+
};
|
|
40
72
|
/**
|
|
41
73
|
* `true`, если строка — известный скоуп: элемент каталога либо wildcard
|
|
42
74
|
* семейства (`<family>:*`, напр. `events:*`). Глобальный `*` не принимается.
|
|
@@ -70,3 +102,13 @@ export function hasServiceScope(granted, required) {
|
|
|
70
102
|
const family = required.slice(0, idx);
|
|
71
103
|
return granted.includes(`${family}:*`);
|
|
72
104
|
}
|
|
105
|
+
/**
|
|
106
|
+
* Проверка «достаточно любого из»: покрыт **хотя бы один** элемент `required`
|
|
107
|
+
* (точное совпадение или wildcard-семейство, `hasServiceScope`). Пустой
|
|
108
|
+
* `required` ничего не открывает (fail-closed).
|
|
109
|
+
*/
|
|
110
|
+
export function hasAnyServiceScope(granted, required) {
|
|
111
|
+
if (!Array.isArray(granted) || !Array.isArray(required) || required.length === 0)
|
|
112
|
+
return false;
|
|
113
|
+
return required.some((scope) => hasServiceScope(granted, scope));
|
|
114
|
+
}
|
package/dist/types/session.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type { PermissionConfig, McpServerToolSettings } from './permission.js';
|
|
2
2
|
import type { Message } from './message.js';
|
|
3
3
|
import type { PromptState } from './prompt.js';
|
|
4
|
+
import type { SessionWorktree } from './worktree.js';
|
|
4
5
|
export type SessionOrigin = 'user' | 'fork' | 'subagent';
|
|
5
6
|
export interface SessionStatus {
|
|
6
7
|
blocked?: string;
|
|
@@ -199,6 +200,30 @@ export interface SessionReference {
|
|
|
199
200
|
autoSummary?: string;
|
|
200
201
|
createdAt: string;
|
|
201
202
|
}
|
|
203
|
+
/**
|
|
204
|
+
* ADR-106 Ф4: роль участника сессии — потолок хода по роли.
|
|
205
|
+
*
|
|
206
|
+
* Значения совпадают с ролями участника проекта (`ProjectRole`): `owner`
|
|
207
|
+
* мутирует всё, `editor` мутирует, `viewer` — только чтение (инвариант 21:
|
|
208
|
+
* право чтения не расширяет права на изменение).
|
|
209
|
+
*/
|
|
210
|
+
export type SessionParticipantRole = 'viewer' | 'editor' | 'owner';
|
|
211
|
+
/**
|
|
212
|
+
* ADR-106 Ф4: участник сессии.
|
|
213
|
+
*
|
|
214
|
+
* Поле **аддитивное**: его отсутствие = прежнее поведение (участников нет,
|
|
215
|
+
* потолок хода не сужается по роли). Для проектной сессии участники
|
|
216
|
+
* **выводятся** из проекта (владелец + участники) при чтении — дублировать
|
|
217
|
+
* вручную не нужно; для личной сессии участник — только владелец.
|
|
218
|
+
*/
|
|
219
|
+
export interface SessionParticipant {
|
|
220
|
+
/** Идентификатор пользователя (тот же id, что у владельца сессии/проекта). */
|
|
221
|
+
userId: string;
|
|
222
|
+
/** Роль участника (потолок хода). */
|
|
223
|
+
role: SessionParticipantRole;
|
|
224
|
+
/** ISO-8601 — когда участник добавлен (для явного списка). */
|
|
225
|
+
addedAt?: string;
|
|
226
|
+
}
|
|
202
227
|
export interface Session {
|
|
203
228
|
id: string;
|
|
204
229
|
title?: string;
|
|
@@ -213,6 +238,16 @@ export interface Session {
|
|
|
213
238
|
planApproved?: boolean;
|
|
214
239
|
/** Текущий runtime-режим сессии (ADR-025): 'plan' — только чтение, 'act' — полный доступ. */
|
|
215
240
|
mode?: SessionMode;
|
|
241
|
+
/**
|
|
242
|
+
* ADR-106 Ф4 (шаг C): режим **по принципалу** — переопределения режима сессии
|
|
243
|
+
* для отдельных участников (ключ — id пользователя-участника).
|
|
244
|
+
*
|
|
245
|
+
* Режим — свойство хода, а не только сессии: `yolo`, выставленный одним
|
|
246
|
+
* участником, действует **только на его ходы** и не снимает подтверждения у
|
|
247
|
+
* других участников. Пусто/отсутствует — у всех участников режим сессии
|
|
248
|
+
* (`mode`), т.е. прежнее поведение.
|
|
249
|
+
*/
|
|
250
|
+
modeByPrincipal?: Record<string, SessionMode>;
|
|
216
251
|
/** Todo-список сессии (тул todo_write), как в OpenCode. */
|
|
217
252
|
todos?: TodoItem[];
|
|
218
253
|
/**
|
|
@@ -225,8 +260,27 @@ export interface Session {
|
|
|
225
260
|
userId?: string;
|
|
226
261
|
ownerId?: string;
|
|
227
262
|
projectId?: string;
|
|
263
|
+
/**
|
|
264
|
+
* ADR-114: привязка сессии к git-worktree — рабочий каталог сессии.
|
|
265
|
+
* Аддитивное поле: сессии, созданные до ADR-114, его не имеют и работают
|
|
266
|
+
* как прежде (каталог — `project.workspace`).
|
|
267
|
+
*/
|
|
268
|
+
worktree?: SessionWorktree;
|
|
269
|
+
/**
|
|
270
|
+
* ADR-106 Ф4: участники сессии (потолок хода по роли). Аддитивное поле:
|
|
271
|
+
* отсутствие = прежнее поведение. Для проектной сессии участники выводятся
|
|
272
|
+
* из проекта при чтении (`engine/authority/participants.ts`).
|
|
273
|
+
*/
|
|
274
|
+
participants?: SessionParticipant[];
|
|
228
275
|
messages: Message[];
|
|
229
276
|
pendingMessages: Message[];
|
|
277
|
+
/**
|
|
278
|
+
* ADR-104: очередь инъекций (steering) — сообщения, отправленные во время
|
|
279
|
+
* активного хода (`mode: 'steer'`). Отдельно от `pendingMessages`: оркестратор
|
|
280
|
+
* вычитывает её на границе шага и вплетает в контекст текущего хода.
|
|
281
|
+
* Необязательное поле — сессии, созданные до ADR-104, его не имеют.
|
|
282
|
+
*/
|
|
283
|
+
steerInbox?: Message[];
|
|
230
284
|
status: SessionStatus;
|
|
231
285
|
settings: SessionSettings;
|
|
232
286
|
mcpServers?: string[];
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-104: форсированная отправка сообщения во время хода (steering).
|
|
3
|
+
*
|
|
4
|
+
* Контракт режима отправки `POST /api/v2/sessions/:id/prompt`:
|
|
5
|
+
* - `queue` — текущее поведение (по умолчанию): сообщение ждёт окончания хода;
|
|
6
|
+
* - `steer` — инъекция в активный ход без прерывания генерации;
|
|
7
|
+
* - `interrupt` — прерывание текущей генерации с продолжением того же хода:
|
|
8
|
+
* стрим обрывается (событие `stream.interrupted`), ход НЕ завершается —
|
|
9
|
+
* сообщение вплетается на ближайшей безопасной границе шага.
|
|
10
|
+
*
|
|
11
|
+
* Модуль browser-safe (только типы и чистые функции) — используется в UI.
|
|
12
|
+
*/
|
|
13
|
+
/** Режимы отправки сообщения (ADR-104 §«Решение»). */
|
|
14
|
+
export declare const STEER_MODES: readonly ["queue", "steer", "interrupt"];
|
|
15
|
+
/** Режим отправки сообщения. */
|
|
16
|
+
export type SteerMode = (typeof STEER_MODES)[number];
|
|
17
|
+
/** Режим по умолчанию — обратная совместимость (поле `mode` необязательное). */
|
|
18
|
+
export declare const DEFAULT_STEER_MODE: SteerMode;
|
|
19
|
+
/** Проверка значения режима (значение из тела запроса). */
|
|
20
|
+
export declare function isSteerMode(value: unknown): value is SteerMode;
|
|
21
|
+
/**
|
|
22
|
+
* Лимит инъекций на ход (ADR-104 §«Модель исполнения»): столько сообщений
|
|
23
|
+
* можно вбросить в один ход; превышение — понятная ошибка + событие
|
|
24
|
+
* `steer.dropped`.
|
|
25
|
+
*/
|
|
26
|
+
export declare const MAX_STEER_INJECTIONS_PER_TURN = 5;
|
|
27
|
+
/**
|
|
28
|
+
* Признак инъекции в `metadata` сообщения: `metadata.steer === true`.
|
|
29
|
+
* Тип `Message` не меняется — `metadata` уже свободная карта.
|
|
30
|
+
*/
|
|
31
|
+
export declare const STEER_METADATA_KEY = "steer";
|
|
32
|
+
/**
|
|
33
|
+
* Признак инъекции в режиме `interrupt` (ADR-104, этап 2):
|
|
34
|
+
* `metadata.interrupt === true` (вместе с `metadata.steer === true`).
|
|
35
|
+
* UI рисует такой ввод отдельным маркером — «ход прерван», а не «остановлен».
|
|
36
|
+
*/
|
|
37
|
+
export declare const STEER_INTERRUPT_METADATA_KEY = "interrupt";
|
|
38
|
+
/**
|
|
39
|
+
* Признак прерванной генерации в `metadata` assistant-сообщения:
|
|
40
|
+
* `metadata.interrupted === true` (частичный ответ прерванного стрима).
|
|
41
|
+
*/
|
|
42
|
+
export declare const STEER_INTERRUPTED_METADATA_KEY = "interrupted";
|
|
43
|
+
/**
|
|
44
|
+
* Классы инъекций по приоритету применения (ADR-104, этап 3).
|
|
45
|
+
*
|
|
46
|
+
* Порядок классов — это порядок применения: `interrupt` (прерывание
|
|
47
|
+
* генерации) вплетается раньше `steer` (вмешательство без прерывания);
|
|
48
|
+
* внутри класса порядок — FIFO (порядок постановки в очередь).
|
|
49
|
+
*/
|
|
50
|
+
export declare const STEER_INJECTION_CLASSES: readonly ["interrupt", "steer"];
|
|
51
|
+
/** Класс инъекции (`interrupt` | `steer`). */
|
|
52
|
+
export type SteerInjectionClass = (typeof STEER_INJECTION_CLASSES)[number];
|
|
53
|
+
/** Минимальный вид сообщения, по которому определяется класс инъекции. */
|
|
54
|
+
export interface SteerInjectionLike {
|
|
55
|
+
metadata?: Record<string, unknown> | undefined;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* Класс инъекции по маркеру `metadata.interrupt` (ADR-104, этап 3).
|
|
59
|
+
* Всё, что не помечено как прерывание, — обычное вмешательство (`steer`).
|
|
60
|
+
*/
|
|
61
|
+
export declare function steerInjectionClass(message: SteerInjectionLike): SteerInjectionClass;
|
|
62
|
+
/**
|
|
63
|
+
* Порядок применения инъекций (ADR-104, этап 3): сначала класс `interrupt`,
|
|
64
|
+
* затем `steer`; внутри класса — FIFO. Возвращает НОВЫЙ массив (вход не
|
|
65
|
+
* мутируется) — порядок предсказуем и не зависит от момента постановки.
|
|
66
|
+
*/
|
|
67
|
+
export declare function orderSteerInjections<T extends SteerInjectionLike>(messages: readonly T[]): T[];
|
|
68
|
+
/** Машинные коды ошибок steering (контракт ошибок API v2). */
|
|
69
|
+
export declare const STEERING_ERROR_CODES: {
|
|
70
|
+
/** Превышен лимит инъекций на ход. */
|
|
71
|
+
readonly limitExceeded: "STEER_LIMIT_EXCEEDED";
|
|
72
|
+
};
|
|
73
|
+
/** Машинный код ошибки steering. */
|
|
74
|
+
export type SteeringErrorCode = (typeof STEERING_ERROR_CODES)[keyof typeof STEERING_ERROR_CODES];
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-104: форсированная отправка сообщения во время хода (steering).
|
|
3
|
+
*
|
|
4
|
+
* Контракт режима отправки `POST /api/v2/sessions/:id/prompt`:
|
|
5
|
+
* - `queue` — текущее поведение (по умолчанию): сообщение ждёт окончания хода;
|
|
6
|
+
* - `steer` — инъекция в активный ход без прерывания генерации;
|
|
7
|
+
* - `interrupt` — прерывание текущей генерации с продолжением того же хода:
|
|
8
|
+
* стрим обрывается (событие `stream.interrupted`), ход НЕ завершается —
|
|
9
|
+
* сообщение вплетается на ближайшей безопасной границе шага.
|
|
10
|
+
*
|
|
11
|
+
* Модуль browser-safe (только типы и чистые функции) — используется в UI.
|
|
12
|
+
*/
|
|
13
|
+
/** Режимы отправки сообщения (ADR-104 §«Решение»). */
|
|
14
|
+
export const STEER_MODES = ['queue', 'steer', 'interrupt'];
|
|
15
|
+
/** Режим по умолчанию — обратная совместимость (поле `mode` необязательное). */
|
|
16
|
+
export const DEFAULT_STEER_MODE = 'queue';
|
|
17
|
+
/** Проверка значения режима (значение из тела запроса). */
|
|
18
|
+
export function isSteerMode(value) {
|
|
19
|
+
return typeof value === 'string' && STEER_MODES.includes(value);
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Лимит инъекций на ход (ADR-104 §«Модель исполнения»): столько сообщений
|
|
23
|
+
* можно вбросить в один ход; превышение — понятная ошибка + событие
|
|
24
|
+
* `steer.dropped`.
|
|
25
|
+
*/
|
|
26
|
+
export const MAX_STEER_INJECTIONS_PER_TURN = 5;
|
|
27
|
+
/**
|
|
28
|
+
* Признак инъекции в `metadata` сообщения: `metadata.steer === true`.
|
|
29
|
+
* Тип `Message` не меняется — `metadata` уже свободная карта.
|
|
30
|
+
*/
|
|
31
|
+
export const STEER_METADATA_KEY = 'steer';
|
|
32
|
+
/**
|
|
33
|
+
* Признак инъекции в режиме `interrupt` (ADR-104, этап 2):
|
|
34
|
+
* `metadata.interrupt === true` (вместе с `metadata.steer === true`).
|
|
35
|
+
* UI рисует такой ввод отдельным маркером — «ход прерван», а не «остановлен».
|
|
36
|
+
*/
|
|
37
|
+
export const STEER_INTERRUPT_METADATA_KEY = 'interrupt';
|
|
38
|
+
/**
|
|
39
|
+
* Признак прерванной генерации в `metadata` assistant-сообщения:
|
|
40
|
+
* `metadata.interrupted === true` (частичный ответ прерванного стрима).
|
|
41
|
+
*/
|
|
42
|
+
export const STEER_INTERRUPTED_METADATA_KEY = 'interrupted';
|
|
43
|
+
/**
|
|
44
|
+
* Классы инъекций по приоритету применения (ADR-104, этап 3).
|
|
45
|
+
*
|
|
46
|
+
* Порядок классов — это порядок применения: `interrupt` (прерывание
|
|
47
|
+
* генерации) вплетается раньше `steer` (вмешательство без прерывания);
|
|
48
|
+
* внутри класса порядок — FIFO (порядок постановки в очередь).
|
|
49
|
+
*/
|
|
50
|
+
export const STEER_INJECTION_CLASSES = ['interrupt', 'steer'];
|
|
51
|
+
/**
|
|
52
|
+
* Класс инъекции по маркеру `metadata.interrupt` (ADR-104, этап 3).
|
|
53
|
+
* Всё, что не помечено как прерывание, — обычное вмешательство (`steer`).
|
|
54
|
+
*/
|
|
55
|
+
export function steerInjectionClass(message) {
|
|
56
|
+
return message.metadata?.[STEER_INTERRUPT_METADATA_KEY] === true ? 'interrupt' : 'steer';
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Порядок применения инъекций (ADR-104, этап 3): сначала класс `interrupt`,
|
|
60
|
+
* затем `steer`; внутри класса — FIFO. Возвращает НОВЫЙ массив (вход не
|
|
61
|
+
* мутируется) — порядок предсказуем и не зависит от момента постановки.
|
|
62
|
+
*/
|
|
63
|
+
export function orderSteerInjections(messages) {
|
|
64
|
+
const interrupts = [];
|
|
65
|
+
const steers = [];
|
|
66
|
+
for (const message of messages) {
|
|
67
|
+
(steerInjectionClass(message) === 'interrupt' ? interrupts : steers).push(message);
|
|
68
|
+
}
|
|
69
|
+
return [...interrupts, ...steers];
|
|
70
|
+
}
|
|
71
|
+
/** Машинные коды ошибок steering (контракт ошибок API v2). */
|
|
72
|
+
export const STEERING_ERROR_CODES = {
|
|
73
|
+
/** Превышен лимит инъекций на ход. */
|
|
74
|
+
limitExceeded: 'STEER_LIMIT_EXCEEDED',
|
|
75
|
+
};
|
package/dist/types/tools.d.ts
CHANGED
|
@@ -11,6 +11,60 @@ export declare const ToolCapability: {
|
|
|
11
11
|
readonly MCP: "mcp";
|
|
12
12
|
readonly RUNTIME: "runtime";
|
|
13
13
|
readonly USER: "user";
|
|
14
|
+
/**
|
|
15
|
+
* Память (ADR-107, PROP-047): тулы плагина памяти (`memory_search`/
|
|
16
|
+
* `memory_write`/`memory_forget`).
|
|
17
|
+
*
|
|
18
|
+
* Отдельная capability, а не `search`/`file_write`: память работает **всегда** —
|
|
19
|
+
* она не привязана к рабочему каталогу проекта (`WORKSPACE_CAPABILITIES`),
|
|
20
|
+
* поэтому в сессии без `project.workspace` тулы памяти остаются доступны.
|
|
21
|
+
*/
|
|
22
|
+
readonly MEMORY: "memory";
|
|
23
|
+
/**
|
|
24
|
+
* Пайплайны (ADR-101): тулы работы с пайплайнами проекта и прогонами.
|
|
25
|
+
*
|
|
26
|
+
* Отдельная capability, а не `runtime`: пайплайн — доменный ресурс проекта
|
|
27
|
+
* (спецификация с версиями + прогоны), а не примитив ядра. Capability
|
|
28
|
+
* отключается админом через `tools.disabled` (группа `pipeline`).
|
|
29
|
+
*/
|
|
30
|
+
readonly PIPELINE: "pipeline";
|
|
31
|
+
/**
|
|
32
|
+
* Расписания (ADR-051): тулы работы с расписаниями планировщика.
|
|
33
|
+
*
|
|
34
|
+
* Отдельная capability по той же причине, что и `pipeline`: расписание —
|
|
35
|
+
* доменный ресурс, а не примитив ядра.
|
|
36
|
+
*/
|
|
37
|
+
readonly SCHEDULE: "schedule";
|
|
38
|
+
/**
|
|
39
|
+
* Вопрос пользователю (этап 1 roadmap 0.13 — блок 1.3): тулы, задающие
|
|
40
|
+
* пользователю вопрос и ждущие ответа.
|
|
41
|
+
*
|
|
42
|
+
* Отдельная capability по той же причине, что и `pipeline`/`schedule`:
|
|
43
|
+
* вопрос — доменный ресурс (персистентная запись вопроса), а не примитив
|
|
44
|
+
* ядра. Capability **не** привязана к рабочему каталогу проекта
|
|
45
|
+
* (`WORKSPACE_CAPABILITIES`) — вопрос задаётся и без workspace.
|
|
46
|
+
*/
|
|
47
|
+
readonly QUESTION: "question";
|
|
48
|
+
/**
|
|
49
|
+
* Реестр фоновых прогонов (ADR-111/PROP-097): тулы чтения реестра и логов
|
|
50
|
+
* фоновых процессов (`process_list`/`process_logs`).
|
|
51
|
+
*
|
|
52
|
+
* Отдельная capability по той же причине, что и `pipeline`/`schedule`/
|
|
53
|
+
* `question`: реестр фоновой работы — доменный ресурс, а не примитив ядра.
|
|
54
|
+
* Capability **не** привязана к рабочему каталогу проекта
|
|
55
|
+
* (`WORKSPACE_CAPABILITIES`) — реестр доступен и без workspace.
|
|
56
|
+
*/
|
|
57
|
+
readonly PROCESS: "process";
|
|
58
|
+
/**
|
|
59
|
+
* Каталог моделей (ADR-115): тул `list_models` — модели инстанса с
|
|
60
|
+
* модальностями, текущая пара и назначения aux-моделей.
|
|
61
|
+
*
|
|
62
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/`process`:
|
|
63
|
+
* каталог — доменный ресурс инстанса, а не примитив ядра. Capability **не**
|
|
64
|
+
* привязана к рабочему каталогу проекта (`WORKSPACE_CAPABILITIES`) — каталог
|
|
65
|
+
* доступен и без workspace, и разрешён в plan-режиме (только чтение).
|
|
66
|
+
*/
|
|
67
|
+
readonly MODELS: "models";
|
|
14
68
|
};
|
|
15
69
|
export type ToolCapability = (typeof ToolCapability)[keyof typeof ToolCapability];
|
|
16
70
|
export declare const TOOL_CAPABILITY_META: Record<string, {
|
|
@@ -22,33 +76,99 @@ export interface ToolContext {
|
|
|
22
76
|
messageId: string;
|
|
23
77
|
abortSignal?: AbortSignal;
|
|
24
78
|
agentRole?: string;
|
|
79
|
+
/**
|
|
80
|
+
* Проект сессии — метаданные хода, а не internals ядра.
|
|
81
|
+
*
|
|
82
|
+
* Нужен плагину, который сужает контекст (ADR-107): без него плагинный тул
|
|
83
|
+
* не знает, чей это проект, и не может ограничить себя его данными.
|
|
84
|
+
*/
|
|
85
|
+
projectId?: string;
|
|
25
86
|
workingDir: string;
|
|
87
|
+
/**
|
|
88
|
+
* ADR-114: привязка сессии к git-worktree.
|
|
89
|
+
*
|
|
90
|
+
* `worktreeId` — id записи worktree (пусто — сессия не привязана: рабочий
|
|
91
|
+
* каталог = `project.workspace`). `worktreeRepoPath` — репозиторий worktree
|
|
92
|
+
* **относительно `project.workspace`** (`.` — репозиторий в корне
|
|
93
|
+
* workspace); по нему git-тулы ищут запись реестра `project.repos`
|
|
94
|
+
* (ADR-076), потому что каталог worktree лежит вне `project.workspace`.
|
|
95
|
+
*/
|
|
96
|
+
worktreeId?: string;
|
|
97
|
+
worktreeRepoPath?: string;
|
|
26
98
|
dataDir?: string;
|
|
27
99
|
extra?: Record<string, unknown>;
|
|
28
100
|
}
|
|
101
|
+
/**
|
|
102
|
+
* ADR-115 §«Медиа из инструментов»: ссылка на вложение, которое тул положил в
|
|
103
|
+
* blob-хранилище и хочет показать модели.
|
|
104
|
+
*
|
|
105
|
+
* Тул **не** возвращает байты: в результате — только адрес объекта и
|
|
106
|
+
* метаданные (та же content-addressed схема, что у вложений сообщений).
|
|
107
|
+
* Оркестратор вставляет ссылки в текущий ход отдельной user-репликой, и
|
|
108
|
+
* модель получает их штатной гидратацией на следующей итерации.
|
|
109
|
+
*
|
|
110
|
+
* Поля обязательные (кроме `name`): `blobPath` — путь порта `BlobStore`,
|
|
111
|
+
* `sha256` — 64 hex-символа, `mime`, `size` > 0. Невалидные ссылки
|
|
112
|
+
* отбрасываются с логом (текст результата тула модель всё равно получит).
|
|
113
|
+
*/
|
|
114
|
+
export interface ToolAttachmentRef {
|
|
115
|
+
/** Путь объекта в blob-хранилище (обязан быть под `attachments/`). */
|
|
116
|
+
blobPath: string;
|
|
117
|
+
/** SHA-256 объекта (64 hex). */
|
|
118
|
+
sha256: string;
|
|
119
|
+
/** MIME-тип по содержимому (sniff сервиса вложений). */
|
|
120
|
+
mime: string;
|
|
121
|
+
/** Размер в байтах (> 0). */
|
|
122
|
+
size: number;
|
|
123
|
+
/** Имя файла для модели/UI (необязательно). */
|
|
124
|
+
name?: string;
|
|
125
|
+
}
|
|
29
126
|
export interface ToolResult {
|
|
30
127
|
content: string;
|
|
31
128
|
isError?: boolean;
|
|
32
129
|
metadata?: Record<string, unknown>;
|
|
130
|
+
/**
|
|
131
|
+
* ADR-115: вложения результата тула (ссылки на объекты blob-хранилища).
|
|
132
|
+
*
|
|
133
|
+
* Аддитивное поле: тулы, которые умеют отдавать медиа (например
|
|
134
|
+
* `web_fetch` с `include_media`), складывают сюда ссылки; оркестратор
|
|
135
|
+
* превращает их в user-реплику текущего хода. Тул без поля работает как
|
|
136
|
+
* прежде — результат остаётся текстом.
|
|
137
|
+
*/
|
|
138
|
+
attachments?: ToolAttachmentRef[];
|
|
33
139
|
}
|
|
34
140
|
export type ToolExecutor = (params: unknown, ctx: ToolContext) => Promise<ToolResult>;
|
|
35
141
|
/**
|
|
36
|
-
* ADR-071 §2.1: источник инструмента.
|
|
37
|
-
*
|
|
142
|
+
* ADR-071 §2.1 + ADR-090: источник инструмента.
|
|
143
|
+
*
|
|
144
|
+
* - `builtin` — встроенный (слой `tools`, `stable`);
|
|
145
|
+
* - `mcp` — инструмент MCP-сервера (слой `mcp.tools`, `volatile`);
|
|
146
|
+
* - `plugin` — инструмент, зарегистрированный плагином через
|
|
147
|
+
* `PluginFacade.registerTool` (ADR-090, Ф3в): в промпте идёт после
|
|
148
|
+
* встроенных (вне stable-префикса — плагин можно снять в runtime).
|
|
149
|
+
*
|
|
38
150
|
* Для встроенных проставляется по умолчанию в `ToolRegistry.register`.
|
|
39
151
|
*/
|
|
40
|
-
export type ToolSource = 'builtin' | 'mcp';
|
|
152
|
+
export type ToolSource = 'builtin' | 'mcp' | 'plugin';
|
|
41
153
|
export interface ToolDefinition {
|
|
42
154
|
name: string;
|
|
43
155
|
description: string;
|
|
44
|
-
parameters: z.ZodTypeAny
|
|
156
|
+
parameters: z.ZodTypeAny<any>;
|
|
45
157
|
capabilities: ToolCapability[];
|
|
46
158
|
execute: ToolExecutor;
|
|
47
159
|
jsonSchema?: Record<string, unknown>;
|
|
48
|
-
/** ADR-071 §2.1: источник инструмента (builtin/mcp). */
|
|
160
|
+
/** ADR-071 §2.1: источник инструмента (builtin/mcp/plugin). */
|
|
49
161
|
source?: ToolSource;
|
|
50
162
|
/** ADR-071 §2.1: имя MCP-сервера для `source: 'mcp'`. */
|
|
51
163
|
mcpServer?: string;
|
|
164
|
+
/**
|
|
165
|
+
* ADR-090: имя плагина-владельца для `source: 'plugin'`.
|
|
166
|
+
*
|
|
167
|
+
* Имя тула в реестре — с namespace (`plugin_<plugin>_<tool>`,
|
|
168
|
+
* `pluginToolFullName`), локальное имя хранится только здесь и в манифесте
|
|
169
|
+
* (`provides.tools[]`).
|
|
170
|
+
*/
|
|
171
|
+
pluginName?: string;
|
|
52
172
|
}
|
|
53
173
|
export interface ToolForLLM {
|
|
54
174
|
type: 'function';
|
package/dist/types/tools.js
CHANGED
|
@@ -10,6 +10,60 @@ export const ToolCapability = {
|
|
|
10
10
|
MCP: 'mcp',
|
|
11
11
|
RUNTIME: 'runtime',
|
|
12
12
|
USER: 'user',
|
|
13
|
+
/**
|
|
14
|
+
* Память (ADR-107, PROP-047): тулы плагина памяти (`memory_search`/
|
|
15
|
+
* `memory_write`/`memory_forget`).
|
|
16
|
+
*
|
|
17
|
+
* Отдельная capability, а не `search`/`file_write`: память работает **всегда** —
|
|
18
|
+
* она не привязана к рабочему каталогу проекта (`WORKSPACE_CAPABILITIES`),
|
|
19
|
+
* поэтому в сессии без `project.workspace` тулы памяти остаются доступны.
|
|
20
|
+
*/
|
|
21
|
+
MEMORY: 'memory',
|
|
22
|
+
/**
|
|
23
|
+
* Пайплайны (ADR-101): тулы работы с пайплайнами проекта и прогонами.
|
|
24
|
+
*
|
|
25
|
+
* Отдельная capability, а не `runtime`: пайплайн — доменный ресурс проекта
|
|
26
|
+
* (спецификация с версиями + прогоны), а не примитив ядра. Capability
|
|
27
|
+
* отключается админом через `tools.disabled` (группа `pipeline`).
|
|
28
|
+
*/
|
|
29
|
+
PIPELINE: 'pipeline',
|
|
30
|
+
/**
|
|
31
|
+
* Расписания (ADR-051): тулы работы с расписаниями планировщика.
|
|
32
|
+
*
|
|
33
|
+
* Отдельная capability по той же причине, что и `pipeline`: расписание —
|
|
34
|
+
* доменный ресурс, а не примитив ядра.
|
|
35
|
+
*/
|
|
36
|
+
SCHEDULE: 'schedule',
|
|
37
|
+
/**
|
|
38
|
+
* Вопрос пользователю (этап 1 roadmap 0.13 — блок 1.3): тулы, задающие
|
|
39
|
+
* пользователю вопрос и ждущие ответа.
|
|
40
|
+
*
|
|
41
|
+
* Отдельная capability по той же причине, что и `pipeline`/`schedule`:
|
|
42
|
+
* вопрос — доменный ресурс (персистентная запись вопроса), а не примитив
|
|
43
|
+
* ядра. Capability **не** привязана к рабочему каталогу проекта
|
|
44
|
+
* (`WORKSPACE_CAPABILITIES`) — вопрос задаётся и без workspace.
|
|
45
|
+
*/
|
|
46
|
+
QUESTION: 'question',
|
|
47
|
+
/**
|
|
48
|
+
* Реестр фоновых прогонов (ADR-111/PROP-097): тулы чтения реестра и логов
|
|
49
|
+
* фоновых процессов (`process_list`/`process_logs`).
|
|
50
|
+
*
|
|
51
|
+
* Отдельная capability по той же причине, что и `pipeline`/`schedule`/
|
|
52
|
+
* `question`: реестр фоновой работы — доменный ресурс, а не примитив ядра.
|
|
53
|
+
* Capability **не** привязана к рабочему каталогу проекта
|
|
54
|
+
* (`WORKSPACE_CAPABILITIES`) — реестр доступен и без workspace.
|
|
55
|
+
*/
|
|
56
|
+
PROCESS: 'process',
|
|
57
|
+
/**
|
|
58
|
+
* Каталог моделей (ADR-115): тул `list_models` — модели инстанса с
|
|
59
|
+
* модальностями, текущая пара и назначения aux-моделей.
|
|
60
|
+
*
|
|
61
|
+
* Отдельная capability по той же причине, что `pipeline`/`schedule`/`process`:
|
|
62
|
+
* каталог — доменный ресурс инстанса, а не примитив ядра. Capability **не**
|
|
63
|
+
* привязана к рабочему каталогу проекта (`WORKSPACE_CAPABILITIES`) — каталог
|
|
64
|
+
* доступен и без workspace, и разрешён в plan-режиме (только чтение).
|
|
65
|
+
*/
|
|
66
|
+
MODELS: 'models',
|
|
13
67
|
};
|
|
14
68
|
export const TOOL_CAPABILITY_META = {
|
|
15
69
|
[ToolCapability.FILE_READ]: { label: 'Чтение файлов', description: 'read_file, list_directory, glob' },
|
|
@@ -23,4 +77,25 @@ export const TOOL_CAPABILITY_META = {
|
|
|
23
77
|
[ToolCapability.MCP]: { label: 'MCP-инструменты', description: 'внешние MCP-серверы' },
|
|
24
78
|
[ToolCapability.RUNTIME]: { label: 'Управление сессией', description: 'classify_conversation' },
|
|
25
79
|
[ToolCapability.USER]: { label: 'Работа с пользователем', description: 'profile_update' },
|
|
80
|
+
[ToolCapability.MEMORY]: { label: 'Память', description: 'memory_search, memory_write, memory_forget' },
|
|
81
|
+
[ToolCapability.PIPELINE]: {
|
|
82
|
+
label: 'Пайплайны',
|
|
83
|
+
description: 'pipeline_list, pipeline_get, pipeline_save, pipeline_publish, pipeline_delete, pipeline_run, pipeline_run_status, pipeline_run_list, pipeline_run_resume, pipeline_run_cancel, pipeline_templates, pipeline_instantiate',
|
|
84
|
+
},
|
|
85
|
+
[ToolCapability.SCHEDULE]: {
|
|
86
|
+
label: 'Расписания',
|
|
87
|
+
description: 'schedule_list, schedule_get, schedule_save, schedule_delete, schedule_run, schedule_jobs',
|
|
88
|
+
},
|
|
89
|
+
[ToolCapability.QUESTION]: {
|
|
90
|
+
label: 'Вопрос пользователю',
|
|
91
|
+
description: 'question',
|
|
92
|
+
},
|
|
93
|
+
[ToolCapability.PROCESS]: {
|
|
94
|
+
label: 'Фоновые процессы',
|
|
95
|
+
description: 'process_list, process_logs',
|
|
96
|
+
},
|
|
97
|
+
[ToolCapability.MODELS]: {
|
|
98
|
+
label: 'Модели',
|
|
99
|
+
description: 'list_models',
|
|
100
|
+
},
|
|
26
101
|
};
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PROP-068 §4.1 / ADR-090: уровни доверия расширений — **единственный**
|
|
3
|
+
* перечень в пакете `@itphx/synth-shared`.
|
|
4
|
+
*
|
|
5
|
+
* Модуль выделен отдельно, чтобы перечень не зависел от модулей, которые сами
|
|
6
|
+
* от него зависят: `types/catalog.ts` (карточка записи каталога) и
|
|
7
|
+
* `types/pack.ts` (манифест `synth.pack`) используют один и тот же список, а
|
|
8
|
+
* `catalog.ts` импортирует схемы из `pack.ts` — прямой импорт наоборот дал бы
|
|
9
|
+
* цикл (использование `const` на этапе инициализации модуля).
|
|
10
|
+
*
|
|
11
|
+
* Иерархия (от старшего к младшему): `builtin` → `verified` → `trusted` →
|
|
12
|
+
* `community`. Уровень `agent-created` (ADR-090) в каталоге расширений не
|
|
13
|
+
* используется — записи каталога публикуются из репозиториев (PROP-068 §4.1).
|
|
14
|
+
*
|
|
15
|
+
* Модуль browser-safe (`zod` + локальные типы).
|
|
16
|
+
*/
|
|
17
|
+
import { z } from 'zod';
|
|
18
|
+
/** Уровни доверия (PROP-068 §4.1). */
|
|
19
|
+
export declare const CATALOG_TRUST_LEVELS: readonly ["builtin", "verified", "trusted", "community"];
|
|
20
|
+
export type CatalogTrustLevel = (typeof CATALOG_TRUST_LEVELS)[number];
|
|
21
|
+
export declare const catalogTrustLevelSchema: z.ZodEnum<{
|
|
22
|
+
builtin: "builtin";
|
|
23
|
+
verified: "verified";
|
|
24
|
+
trusted: "trusted";
|
|
25
|
+
community: "community";
|
|
26
|
+
}>;
|
|
27
|
+
/**
|
|
28
|
+
* Позиция уровня в иерархии доверия (0 — старший). Используется для
|
|
29
|
+
* сравнения «не выше порога» (ADR-090: trust-floor плагина = `trusted`).
|
|
30
|
+
*/
|
|
31
|
+
export declare function trustLevelRank(level: CatalogTrustLevel): number;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PROP-068 §4.1 / ADR-090: уровни доверия расширений — **единственный**
|
|
3
|
+
* перечень в пакете `@itphx/synth-shared`.
|
|
4
|
+
*
|
|
5
|
+
* Модуль выделен отдельно, чтобы перечень не зависел от модулей, которые сами
|
|
6
|
+
* от него зависят: `types/catalog.ts` (карточка записи каталога) и
|
|
7
|
+
* `types/pack.ts` (манифест `synth.pack`) используют один и тот же список, а
|
|
8
|
+
* `catalog.ts` импортирует схемы из `pack.ts` — прямой импорт наоборот дал бы
|
|
9
|
+
* цикл (использование `const` на этапе инициализации модуля).
|
|
10
|
+
*
|
|
11
|
+
* Иерархия (от старшего к младшему): `builtin` → `verified` → `trusted` →
|
|
12
|
+
* `community`. Уровень `agent-created` (ADR-090) в каталоге расширений не
|
|
13
|
+
* используется — записи каталога публикуются из репозиториев (PROP-068 §4.1).
|
|
14
|
+
*
|
|
15
|
+
* Модуль browser-safe (`zod` + локальные типы).
|
|
16
|
+
*/
|
|
17
|
+
import { z } from 'zod';
|
|
18
|
+
/** Уровни доверия (PROP-068 §4.1). */
|
|
19
|
+
export const CATALOG_TRUST_LEVELS = ['builtin', 'verified', 'trusted', 'community'];
|
|
20
|
+
export const catalogTrustLevelSchema = z.enum(CATALOG_TRUST_LEVELS);
|
|
21
|
+
/**
|
|
22
|
+
* Позиция уровня в иерархии доверия (0 — старший). Используется для
|
|
23
|
+
* сравнения «не выше порога» (ADR-090: trust-floor плагина = `trusted`).
|
|
24
|
+
*/
|
|
25
|
+
export function trustLevelRank(level) {
|
|
26
|
+
return CATALOG_TRUST_LEVELS.indexOf(level);
|
|
27
|
+
}
|