@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
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Версия правил сканера (`PLUGIN_SCAN_RULES` в ядре).
|
|
3
|
+
*
|
|
4
|
+
* Входит в **ключ кэша сканов**: при изменении правил (новые категории,
|
|
5
|
+
* другие severity) старый вердикт из кэша нельзя переиспользовать — иначе
|
|
6
|
+
* бандл, признанный безопасным по старым правилам, получил бы «зелёный»
|
|
7
|
+
* вердикт по новым. Правило: **любое изменение правил сканера поднимает
|
|
8
|
+
* версию**.
|
|
9
|
+
*/
|
|
10
|
+
export const PLUGIN_SCAN_RULES_VERSION = '1';
|
|
11
|
+
/**
|
|
12
|
+
* Категории находок сканера (PROP-068 §4.3).
|
|
13
|
+
*
|
|
14
|
+
* Шесть базовых категорий + отдельная `invisible_unicode` (скрытие инструкций
|
|
15
|
+
* для LLM). Категория — **ось классификации**, а не severity: severity
|
|
16
|
+
* определяет вердикт.
|
|
17
|
+
*/
|
|
18
|
+
export const PLUGIN_SCAN_CATEGORIES = [
|
|
19
|
+
'exfiltration',
|
|
20
|
+
'injection',
|
|
21
|
+
'destructive',
|
|
22
|
+
'persistence',
|
|
23
|
+
'network',
|
|
24
|
+
'obfuscation',
|
|
25
|
+
'invisible_unicode',
|
|
26
|
+
];
|
|
27
|
+
/** Уровни серьёзности находки (PROP-068 §4.3). */
|
|
28
|
+
export const PLUGIN_SCAN_SEVERITIES = ['info', 'low', 'medium', 'high', 'critical'];
|
|
29
|
+
/**
|
|
30
|
+
* Границы `severity → verdict` (канон — PROP-068 §4.3).
|
|
31
|
+
*
|
|
32
|
+
* `info|low → safe`, `medium → caution`, `high|critical → dangerous`.
|
|
33
|
+
* Вердикт бандла — **максимум** severity по находкам.
|
|
34
|
+
*/
|
|
35
|
+
export const PLUGIN_SCAN_SEVERITY_VERDICTS = {
|
|
36
|
+
info: 'safe',
|
|
37
|
+
low: 'safe',
|
|
38
|
+
medium: 'caution',
|
|
39
|
+
high: 'dangerous',
|
|
40
|
+
critical: 'dangerous',
|
|
41
|
+
};
|
|
42
|
+
/** Вердикт по серьёзности одной находки. */
|
|
43
|
+
export function severityToVerdict(severity) {
|
|
44
|
+
return PLUGIN_SCAN_SEVERITY_VERDICTS[severity];
|
|
45
|
+
}
|
|
46
|
+
/** Порядок вердиктов — от «мягкого» к «блокирующему». */
|
|
47
|
+
const VERDICT_ORDER = ['safe', 'caution', 'dangerous'];
|
|
48
|
+
/** Ранг вердикта (больше — жёстче). */
|
|
49
|
+
export function verdictRank(verdict) {
|
|
50
|
+
return VERDICT_ORDER.indexOf(verdict);
|
|
51
|
+
}
|
|
52
|
+
/**
|
|
53
|
+
* Вердикт бандла — **максимум** severity по находкам (PROP-068 §4.3).
|
|
54
|
+
*
|
|
55
|
+
* Находок нет — `safe`.
|
|
56
|
+
*/
|
|
57
|
+
export function verdictFromFindings(findings) {
|
|
58
|
+
let worst = 'safe';
|
|
59
|
+
for (const finding of findings) {
|
|
60
|
+
const verdict = severityToVerdict(finding.severity);
|
|
61
|
+
if (verdictRank(verdict) > verdictRank(worst))
|
|
62
|
+
worst = verdict;
|
|
63
|
+
}
|
|
64
|
+
return worst;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Квоты структуры бандла (PROP-068 §4.3).
|
|
68
|
+
*
|
|
69
|
+
* - `maxFileCount` / `maxTotalSizeKb` — превышение → минимум `caution`;
|
|
70
|
+
* - `maxSingleFileKb` — превышение лимита **одного** файла → `dangerous`.
|
|
71
|
+
*/
|
|
72
|
+
export const PLUGIN_SCAN_QUOTAS = {
|
|
73
|
+
/** Максимум файлов в бандле. */
|
|
74
|
+
maxFileCount: 50,
|
|
75
|
+
/** Максимум суммарного размера бандла, КиБ. */
|
|
76
|
+
maxTotalSizeKb: 1024,
|
|
77
|
+
/** Максимум размера одного файла, КиБ. */
|
|
78
|
+
maxSingleFileKb: 256,
|
|
79
|
+
};
|
|
80
|
+
/** Квоты по умолчанию. */
|
|
81
|
+
export const DEFAULT_PLUGIN_SCAN_QUOTAS = { ...PLUGIN_SCAN_QUOTAS };
|
|
82
|
+
/**
|
|
83
|
+
* Серьёзность нарушения квоты структуры бандла (PROP-068 §4.3).
|
|
84
|
+
*
|
|
85
|
+
* Канон — здесь, чтобы сканер (core) и проверки не разъезжались:
|
|
86
|
+
* - превышение **числа файлов** или **суммарного размера** → `medium`
|
|
87
|
+
* (вердикт не выше `caution` — подтверждение владельца);
|
|
88
|
+
* - превышение размера **одного** файла → `high` (вердикт `dangerous` —
|
|
89
|
+
* установка блокируется).
|
|
90
|
+
*/
|
|
91
|
+
export const PLUGIN_SCAN_QUOTA_SEVERITIES = {
|
|
92
|
+
/** Превышено число файлов в бандле. */
|
|
93
|
+
fileCount: 'medium',
|
|
94
|
+
/** Превышен суммарный размер бандла. */
|
|
95
|
+
totalSize: 'medium',
|
|
96
|
+
/** Превышен размер одного файла. */
|
|
97
|
+
singleFile: 'high',
|
|
98
|
+
};
|
|
99
|
+
// ── Install-policy (PROP-068 §4.2 + новая ячейка `kind: plugin`) ──────────
|
|
100
|
+
/** Исход install-policy. */
|
|
101
|
+
export const INSTALL_POLICY_ACTIONS = ['allow', 'ask', 'block'];
|
|
102
|
+
/**
|
|
103
|
+
* Уровни доверия в install-policy (PROP-068 §4.2).
|
|
104
|
+
*
|
|
105
|
+
* Шире `CATALOG_TRUST_LEVELS`: матрица включает `agent-created` (создано
|
|
106
|
+
* агентом) — в каталоге расширений этот уровень не используется, но в
|
|
107
|
+
* install-policy ячейка обязательна (PROP-068 §4.2).
|
|
108
|
+
*/
|
|
109
|
+
export const INSTALL_POLICY_TRUST_LEVELS = [
|
|
110
|
+
'builtin',
|
|
111
|
+
'verified',
|
|
112
|
+
'trusted',
|
|
113
|
+
'community',
|
|
114
|
+
'agent-created',
|
|
115
|
+
];
|
|
116
|
+
/**
|
|
117
|
+
* Матрица `trust × verdict` (PROP-068 §4.2).
|
|
118
|
+
*
|
|
119
|
+
* Содержимое (`kind: 'content'`):
|
|
120
|
+
*
|
|
121
|
+
* | Trust \ Вердикт | `safe` | `caution` | `dangerous` |
|
|
122
|
+
* |---|---|---|---|
|
|
123
|
+
* | `builtin` | allow | allow | allow |
|
|
124
|
+
* | `verified` | allow | allow | block |
|
|
125
|
+
* | `trusted` | allow | allow | block |
|
|
126
|
+
* | `community` | allow | block | block |
|
|
127
|
+
* | `agent-created` | allow | allow | ask |
|
|
128
|
+
*
|
|
129
|
+
* Плагин (`kind: 'plugin'`) — **новая ячейка** (ADR-090): блокирующий
|
|
130
|
+
* вердикт — `dangerous` (→ `block`), `caution` → `ask` (явное подтверждение
|
|
131
|
+
* владельца), `safe` → `allow`. Ячейка не зависит от уровня доверия.
|
|
132
|
+
*/
|
|
133
|
+
const CONTENT_POLICY = {
|
|
134
|
+
builtin: { safe: 'allow', caution: 'allow', dangerous: 'allow' },
|
|
135
|
+
verified: { safe: 'allow', caution: 'allow', dangerous: 'block' },
|
|
136
|
+
trusted: { safe: 'allow', caution: 'allow', dangerous: 'block' },
|
|
137
|
+
community: { safe: 'allow', caution: 'block', dangerous: 'block' },
|
|
138
|
+
'agent-created': { safe: 'allow', caution: 'allow', dangerous: 'ask' },
|
|
139
|
+
};
|
|
140
|
+
/** Ячейка матрицы для плагинов (любой уровень доверия). */
|
|
141
|
+
const PLUGIN_POLICY = {
|
|
142
|
+
safe: 'allow',
|
|
143
|
+
caution: 'ask',
|
|
144
|
+
dangerous: 'block',
|
|
145
|
+
};
|
|
146
|
+
/**
|
|
147
|
+
* Решение install-policy по матрице `trust × verdict`.
|
|
148
|
+
*
|
|
149
|
+
* Одна функция на оба класса расширений (плагины и, в перспективе,
|
|
150
|
+
* контент-паки) — матрица не дублируется по подсистемам.
|
|
151
|
+
*
|
|
152
|
+
* **Порядок вызовов (важно):** trust-floor проверяется **до** install-policy —
|
|
153
|
+
* плагин ниже `plugins.trustFloor` не активируется ни при каком вердикте
|
|
154
|
+
* (`plugin.trust_below_floor`). Матрица отвечает только на вопрос «можно ли
|
|
155
|
+
* ставить/активировать по вердикту скана».
|
|
156
|
+
*/
|
|
157
|
+
export function installPolicyDecision(input) {
|
|
158
|
+
const kind = input.kind ?? 'content';
|
|
159
|
+
if (kind === 'plugin')
|
|
160
|
+
return PLUGIN_POLICY[input.verdict];
|
|
161
|
+
const row = CONTENT_POLICY[input.trust];
|
|
162
|
+
// Неизвестный уровень доверия — fail-closed: трактуем как `community`.
|
|
163
|
+
return (row ?? CONTENT_POLICY.community)[input.verdict];
|
|
164
|
+
}
|
|
165
|
+
// ── Lock (PROP-068 §4.4 / ADR-090) ───────────────────────────────────
|
|
166
|
+
// Запись lock-файла вынесена в отдельный модуль `plugin-lock.ts`.
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-090: namespace инструментов плагина.
|
|
3
|
+
*
|
|
4
|
+
* Модуль browser-safe (только типы и чистые функции) — его используют и ядро
|
|
5
|
+
* (`ToolRegistry`, фасад `PluginHost`), и будущий пакет `@itphx/synth-plugin`.
|
|
6
|
+
*
|
|
7
|
+
* **Зачем namespace.** Общий `ToolRegistry` держит встроенные (`builtin`),
|
|
8
|
+
* MCP- (`{serverName}_{toolName}`) и плагинные инструменты. Плагин — чужой
|
|
9
|
+
* код: без префикса он мог бы занять имя встроенного тула (`read_file`) и
|
|
10
|
+
* подменить его поведение. Поэтому имя тула плагина — всегда
|
|
11
|
+
* `plugin_<pluginNamespace>_<toolName>`, а в манифесте (`provides.tools[]`)
|
|
12
|
+
* объявляется **локальное** имя (без префикса) — так пример манифеста из
|
|
13
|
+
* ADR-090 (`"tools": ["memory_search"]`) остаётся валидным.
|
|
14
|
+
*
|
|
15
|
+
* Сверка `provides.tools[]` ↔ фактические регистрации идёт по **локальным**
|
|
16
|
+
* именам (`pluginToolLocalName`): префикс — деталь реестра, а не контракта.
|
|
17
|
+
*/
|
|
18
|
+
/** Префикс имени плагинного инструмента (`plugin_…`). */
|
|
19
|
+
export declare const PLUGIN_TOOL_NAME_PREFIX = "plugin";
|
|
20
|
+
/**
|
|
21
|
+
* Namespace плагина в имени тула: имя расширения в нижнем регистре, все
|
|
22
|
+
* небуквенно-цифровые символы → `_`.
|
|
23
|
+
*
|
|
24
|
+
* Пример: `@acme/synth-plugin-memory` → `acme_synth_plugin_memory`,
|
|
25
|
+
* `demo-plugin` → `demo_plugin`. Namespace не пуст даже для имени из
|
|
26
|
+
* недопустимых символов (fallback — `plugin`) — имя тула обязано оставаться
|
|
27
|
+
* валидным идентификатором.
|
|
28
|
+
*/
|
|
29
|
+
export declare function pluginToolNamespace(pluginName: string): string;
|
|
30
|
+
/**
|
|
31
|
+
* Полное имя тула плагина в `ToolRegistry`: `plugin_<namespace>_<toolName>`.
|
|
32
|
+
*
|
|
33
|
+
* @example pluginToolFullName('demo-plugin', 'memory_search')
|
|
34
|
+
* // 'plugin_demo_plugin_memory_search'
|
|
35
|
+
*/
|
|
36
|
+
export declare function pluginToolFullName(pluginName: string, toolName: string): string;
|
|
37
|
+
/**
|
|
38
|
+
* Локальное имя тула (без namespace) по полному имени реестра.
|
|
39
|
+
*
|
|
40
|
+
* `undefined` — имя не принадлежит этому плагину (чужой префикс): сверка
|
|
41
|
+
* `provides.tools[]` такие имена не принимает.
|
|
42
|
+
*/
|
|
43
|
+
export declare function pluginToolLocalName(fullName: string, pluginName: string): string | undefined;
|
|
44
|
+
/**
|
|
45
|
+
* Локальное имя тула плагина — допустимый идентификатор: латиница/цифры,
|
|
46
|
+
* `_`/`-`, начинается с буквы или цифры. Пробелы, точки и `plugin_`-префикс
|
|
47
|
+
* (зарезервированный namespace) недопустимы.
|
|
48
|
+
*/
|
|
49
|
+
export declare const PLUGIN_TOOL_LOCAL_NAME_REGEX: RegExp;
|
|
50
|
+
/** Локальное имя тула плагина валидно (см. `PLUGIN_TOOL_LOCAL_NAME_REGEX`). */
|
|
51
|
+
export declare function isValidPluginToolLocalName(name: string): boolean;
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-090: namespace инструментов плагина.
|
|
3
|
+
*
|
|
4
|
+
* Модуль browser-safe (только типы и чистые функции) — его используют и ядро
|
|
5
|
+
* (`ToolRegistry`, фасад `PluginHost`), и будущий пакет `@itphx/synth-plugin`.
|
|
6
|
+
*
|
|
7
|
+
* **Зачем namespace.** Общий `ToolRegistry` держит встроенные (`builtin`),
|
|
8
|
+
* MCP- (`{serverName}_{toolName}`) и плагинные инструменты. Плагин — чужой
|
|
9
|
+
* код: без префикса он мог бы занять имя встроенного тула (`read_file`) и
|
|
10
|
+
* подменить его поведение. Поэтому имя тула плагина — всегда
|
|
11
|
+
* `plugin_<pluginNamespace>_<toolName>`, а в манифесте (`provides.tools[]`)
|
|
12
|
+
* объявляется **локальное** имя (без префикса) — так пример манифеста из
|
|
13
|
+
* ADR-090 (`"tools": ["memory_search"]`) остаётся валидным.
|
|
14
|
+
*
|
|
15
|
+
* Сверка `provides.tools[]` ↔ фактические регистрации идёт по **локальным**
|
|
16
|
+
* именам (`pluginToolLocalName`): префикс — деталь реестра, а не контракта.
|
|
17
|
+
*/
|
|
18
|
+
/** Префикс имени плагинного инструмента (`plugin_…`). */
|
|
19
|
+
export const PLUGIN_TOOL_NAME_PREFIX = 'plugin';
|
|
20
|
+
/**
|
|
21
|
+
* Namespace плагина в имени тула: имя расширения в нижнем регистре, все
|
|
22
|
+
* небуквенно-цифровые символы → `_`.
|
|
23
|
+
*
|
|
24
|
+
* Пример: `@acme/synth-plugin-memory` → `acme_synth_plugin_memory`,
|
|
25
|
+
* `demo-plugin` → `demo_plugin`. Namespace не пуст даже для имени из
|
|
26
|
+
* недопустимых символов (fallback — `plugin`) — имя тула обязано оставаться
|
|
27
|
+
* валидным идентификатором.
|
|
28
|
+
*/
|
|
29
|
+
export function pluginToolNamespace(pluginName) {
|
|
30
|
+
const slug = (pluginName ?? '')
|
|
31
|
+
.toLowerCase()
|
|
32
|
+
.replace(/[^a-z0-9]+/g, '_')
|
|
33
|
+
.replace(/^_+|_+$/g, '');
|
|
34
|
+
return slug || PLUGIN_TOOL_NAME_PREFIX;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Полное имя тула плагина в `ToolRegistry`: `plugin_<namespace>_<toolName>`.
|
|
38
|
+
*
|
|
39
|
+
* @example pluginToolFullName('demo-plugin', 'memory_search')
|
|
40
|
+
* // 'plugin_demo_plugin_memory_search'
|
|
41
|
+
*/
|
|
42
|
+
export function pluginToolFullName(pluginName, toolName) {
|
|
43
|
+
return `${PLUGIN_TOOL_NAME_PREFIX}_${pluginToolNamespace(pluginName)}_${toolName}`;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Локальное имя тула (без namespace) по полному имени реестра.
|
|
47
|
+
*
|
|
48
|
+
* `undefined` — имя не принадлежит этому плагину (чужой префикс): сверка
|
|
49
|
+
* `provides.tools[]` такие имена не принимает.
|
|
50
|
+
*/
|
|
51
|
+
export function pluginToolLocalName(fullName, pluginName) {
|
|
52
|
+
const prefix = `${PLUGIN_TOOL_NAME_PREFIX}_${pluginToolNamespace(pluginName)}_`;
|
|
53
|
+
const name = fullName ?? '';
|
|
54
|
+
if (!name.startsWith(prefix))
|
|
55
|
+
return undefined;
|
|
56
|
+
const local = name.slice(prefix.length);
|
|
57
|
+
return local === '' ? undefined : local;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Локальное имя тула плагина — допустимый идентификатор: латиница/цифры,
|
|
61
|
+
* `_`/`-`, начинается с буквы или цифры. Пробелы, точки и `plugin_`-префикс
|
|
62
|
+
* (зарезервированный namespace) недопустимы.
|
|
63
|
+
*/
|
|
64
|
+
export const PLUGIN_TOOL_LOCAL_NAME_REGEX = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
|
|
65
|
+
/** Локальное имя тула плагина валидно (см. `PLUGIN_TOOL_LOCAL_NAME_REGEX`). */
|
|
66
|
+
export function isValidPluginToolLocalName(name) {
|
|
67
|
+
if (!PLUGIN_TOOL_LOCAL_NAME_REGEX.test(name ?? ''))
|
|
68
|
+
return false;
|
|
69
|
+
// Namespace зарезервирован: `plugin_` в локальном имени означал бы двойной
|
|
70
|
+
// префикс и делал бы сверку `provides` неоднозначной.
|
|
71
|
+
return !(name ?? '').toLowerCase().startsWith(`${PLUGIN_TOOL_NAME_PREFIX}_`);
|
|
72
|
+
}
|
package/dist/types/project.d.ts
CHANGED
|
@@ -47,6 +47,13 @@ export interface ProjectSkillSettings {
|
|
|
47
47
|
enabled: string[];
|
|
48
48
|
defaultOn: string[];
|
|
49
49
|
}
|
|
50
|
+
/**
|
|
51
|
+
* ADR-107: память проекта (undefined — наследует политику инстанса/включена).
|
|
52
|
+
*/
|
|
53
|
+
export interface ProjectMemorySettings {
|
|
54
|
+
/** false — блоки памяти и тулы памяти выключены для проекта; данные сохраняются. */
|
|
55
|
+
enabled?: boolean;
|
|
56
|
+
}
|
|
50
57
|
/**
|
|
51
58
|
* ADR-075: политика для абсолютного `project.workspace` вне `workspacesRoot`.
|
|
52
59
|
* - `confirm` — путь разрешён только с явным подтверждением (`confirmOutsideRoot`);
|
|
@@ -79,10 +86,17 @@ export interface Project {
|
|
|
79
86
|
color?: string;
|
|
80
87
|
workspace?: string;
|
|
81
88
|
repos?: GitRepoConfig[];
|
|
89
|
+
/**
|
|
90
|
+
* ADR-114 §7.6: команда, выполняемая один раз после создания worktree
|
|
91
|
+
* (env `SYNTH_WORKTREE_BASE`/`SYNTH_WORKTREE_PATH`). Аддитивное поле.
|
|
92
|
+
*/
|
|
93
|
+
worktreeSetupScript?: string;
|
|
82
94
|
/** ADR-071 §2.4: проектный скоуп MCP (owner/lead). */
|
|
83
95
|
mcp?: ProjectMcpSettings;
|
|
84
96
|
/** ADR-046 §4.5: проектный скоуп скиллов (owner/lead). */
|
|
85
97
|
skills?: ProjectSkillSettings;
|
|
98
|
+
/** ADR-107: память проекта (undefined — наследует политику инстанса/включена). */
|
|
99
|
+
memory?: ProjectMemorySettings;
|
|
86
100
|
statusMessages: StatusMessage[];
|
|
87
101
|
/** Kanban-план проекта (ADR-039). Владеет проектом, а не сессией. */
|
|
88
102
|
plan?: ProjectPlan;
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR-090: контракт провайдера блока системного
|
|
3
|
+
* промпта.
|
|
4
|
+
*
|
|
5
|
+
* Модуль browser-safe (только типы и чистые функции) — его используют и ядро
|
|
6
|
+
* (`SystemPromptComposer`), и будущий пакет `@itphx/synth-plugin`.
|
|
7
|
+
*
|
|
8
|
+
* **Граница prompt-cache.** Тир `stable` провайдеру **запрещён**: `stablePrefix`
|
|
9
|
+
* — склейка только stable-блоков (ADR-070 §2.1), а плагинный блок в `stable`
|
|
10
|
+
* ломал бы prompt-cache и инвалидировал бы префикс на каждой сборке. Поэтому
|
|
11
|
+
* тир провайдера ограничен `context|volatile` **на уровне типа**, а не только
|
|
12
|
+
* проверкой в рантайме.
|
|
13
|
+
*
|
|
14
|
+
* **Контекст — узкий.** Провайдер получает DTO (`PromptBlockContext`), а не
|
|
15
|
+
* историю сессии: иначе контракт перестаёт быть сериализуемым (ADR-090) и
|
|
16
|
+
* провайдер получал бы весь диалог вместо вопроса хода.
|
|
17
|
+
*/
|
|
18
|
+
import type { PromptManifestStatus } from './prompt.js';
|
|
19
|
+
/**
|
|
20
|
+
* Тиры блока, доступные провайдеру точки `promptBlocks`.
|
|
21
|
+
*
|
|
22
|
+
* `stable` **не входит** — см. шапку модуля (граница prompt-cache, ADR-070).
|
|
23
|
+
*/
|
|
24
|
+
export declare const PROMPT_BLOCK_PROVIDER_TIERS: readonly ["context", "volatile"];
|
|
25
|
+
export type PromptBlockProviderTier = (typeof PROMPT_BLOCK_PROVIDER_TIERS)[number];
|
|
26
|
+
/**
|
|
27
|
+
* Префикс ключа блока, зарегистрированного плагином: `plugin.<pluginName>.<slot>`.
|
|
28
|
+
*
|
|
29
|
+
* По префиксу видно источник блока (в манифесте промпта и в состоянии
|
|
30
|
+
* промпта) без отдельного реестра.
|
|
31
|
+
*/
|
|
32
|
+
export declare const PLUGIN_PROMPT_BLOCK_KEY_PREFIX = "plugin.";
|
|
33
|
+
/**
|
|
34
|
+
* Бюджет символов одного блока промпта по умолчанию (`plugins.promptBlockMaxChars`).
|
|
35
|
+
*
|
|
36
|
+
* Единый источник истины для конфига (`config/defaults.ts`) и для хоста
|
|
37
|
+
* (обрезка блока, когда провайдер не уложился в бюджет).
|
|
38
|
+
*/
|
|
39
|
+
export declare const DEFAULT_PROMPT_BLOCK_MAX_CHARS = 4000;
|
|
40
|
+
/**
|
|
41
|
+
* Контекст вызова провайдера блока (узкий DTO — без портов и функций).
|
|
42
|
+
*
|
|
43
|
+
* Все «ходовые» поля **опциональные**: шаг пайплайна (ADR-101) и саб-агент
|
|
44
|
+
* (`task`) работают с суженным контрактом, и «вопроса хода» у них нет.
|
|
45
|
+
*/
|
|
46
|
+
export interface PromptBlockContext {
|
|
47
|
+
/** Идентификатор сессии (для шага пайплайна — `pipeline:<runId>:<nodeId>`). */
|
|
48
|
+
readonly sessionId: string;
|
|
49
|
+
/** Эффективная роль агента. */
|
|
50
|
+
readonly agentRole: string;
|
|
51
|
+
/** Язык сессии (`ru`/`en`). */
|
|
52
|
+
readonly language: string;
|
|
53
|
+
/** Проект сессии (не задан — сессия без проекта, ADR-040). */
|
|
54
|
+
readonly projectId?: string;
|
|
55
|
+
/** Режим сессии (ADR-025). */
|
|
56
|
+
readonly mode: 'plan' | 'act' | 'yolo';
|
|
57
|
+
/**
|
|
58
|
+
* Текст последнего сообщения пользователя — «вопрос хода», по которому идёт
|
|
59
|
+
* retrieval. Не задан — вопроса хода нет (шаг пайплайна, саб-агент).
|
|
60
|
+
*/
|
|
61
|
+
readonly query?: string;
|
|
62
|
+
/** Идентификатор хода (`streamId`) — для мемоизации/кэша провайдера. */
|
|
63
|
+
readonly turnId?: string;
|
|
64
|
+
/** Метка времени хода (ISO 8601) — для оценки «свежести» фактов. */
|
|
65
|
+
readonly timestamp?: string;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Содержимое блока, возвращаемое провайдером (расширенная форма).
|
|
69
|
+
*
|
|
70
|
+
* `provenance` — источник блока (для плагина — `plugin:<name>`), `status` —
|
|
71
|
+
* статус манифеста (`loaded`/`empty`/`truncated`).
|
|
72
|
+
*/
|
|
73
|
+
export interface PromptBlockContent {
|
|
74
|
+
content: string;
|
|
75
|
+
provenance?: string;
|
|
76
|
+
status?: PromptManifestStatus;
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Провайдер блока системного промпта (точка расширения `promptBlocks`).
|
|
80
|
+
*
|
|
81
|
+
* Провайдер вызывается **раз в ход** при сборке промпта (`compose()`) и при
|
|
82
|
+
* построении манифеста (`manifest()`).
|
|
83
|
+
*/
|
|
84
|
+
export interface PromptBlockProvider {
|
|
85
|
+
/**
|
|
86
|
+
* Ключ блока. Уникален в инстансе; для плагина — `plugin.<pluginName>.<slot>`.
|
|
87
|
+
*/
|
|
88
|
+
readonly key: string;
|
|
89
|
+
/** Тир блока: только `context`/`volatile` (`stable` запрещён). */
|
|
90
|
+
readonly tier: PromptBlockProviderTier;
|
|
91
|
+
/** Порядок внутри тира (для плагинов рекомендуется `>= 100`). */
|
|
92
|
+
readonly order: number;
|
|
93
|
+
/** Человекочитаемая подпись для манифеста промпта. */
|
|
94
|
+
readonly title?: string;
|
|
95
|
+
/**
|
|
96
|
+
* Содержимое блока. `null`/`''` — блок пуст (`status: 'empty'`, в промпт
|
|
97
|
+
* не попадает). Ошибка провайдера деградирует: блок пустой, ход не падает.
|
|
98
|
+
*/
|
|
99
|
+
load(ctx: PromptBlockContext): Promise<PromptBlockContent | string | null> | PromptBlockContent | string | null;
|
|
100
|
+
}
|
|
101
|
+
/** Ключ блока относится к плагину (по префиксу `plugin.`). */
|
|
102
|
+
export declare function isPluginPromptBlockKey(key: string): boolean;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Тиры блока, доступные провайдеру точки `promptBlocks`.
|
|
3
|
+
*
|
|
4
|
+
* `stable` **не входит** — см. шапку модуля (граница prompt-cache, ADR-070).
|
|
5
|
+
*/
|
|
6
|
+
export const PROMPT_BLOCK_PROVIDER_TIERS = ['context', 'volatile'];
|
|
7
|
+
/**
|
|
8
|
+
* Префикс ключа блока, зарегистрированного плагином: `plugin.<pluginName>.<slot>`.
|
|
9
|
+
*
|
|
10
|
+
* По префиксу видно источник блока (в манифесте промпта и в состоянии
|
|
11
|
+
* промпта) без отдельного реестра.
|
|
12
|
+
*/
|
|
13
|
+
export const PLUGIN_PROMPT_BLOCK_KEY_PREFIX = 'plugin.';
|
|
14
|
+
/**
|
|
15
|
+
* Бюджет символов одного блока промпта по умолчанию (`plugins.promptBlockMaxChars`).
|
|
16
|
+
*
|
|
17
|
+
* Единый источник истины для конфига (`config/defaults.ts`) и для хоста
|
|
18
|
+
* (обрезка блока, когда провайдер не уложился в бюджет).
|
|
19
|
+
*/
|
|
20
|
+
export const DEFAULT_PROMPT_BLOCK_MAX_CHARS = 4000;
|
|
21
|
+
/** Ключ блока относится к плагину (по префиксу `plugin.`). */
|
|
22
|
+
export function isPluginPromptBlockKey(key) {
|
|
23
|
+
return key.startsWith(PLUGIN_PROMPT_BLOCK_KEY_PREFIX);
|
|
24
|
+
}
|
package/dist/types/prompt.d.ts
CHANGED
|
@@ -4,6 +4,15 @@ export interface PromptBlockState {
|
|
|
4
4
|
key: string;
|
|
5
5
|
hash: string;
|
|
6
6
|
chars: number;
|
|
7
|
+
/**
|
|
8
|
+
* Блок пришёл от провайдера точки `promptBlocks` (ADR-090), а не от
|
|
9
|
+
* встроенного источника Composer'а.
|
|
10
|
+
*
|
|
11
|
+
* Нужен для инвалидации состояния промпта: такие блоки лежат вне тира
|
|
12
|
+
* `stable`, поэтому смена их содержимого не видна `isPrefixUnchanged` —
|
|
13
|
+
* трек ведётся отдельно, по образцу блока `instructions` (ADR-069 §11).
|
|
14
|
+
*/
|
|
15
|
+
provider?: boolean;
|
|
7
16
|
}
|
|
8
17
|
/**
|
|
9
18
|
* ADR-070 §2.4: состояние системного промпта per-agent. Хранится в сессии
|
|
@@ -21,6 +30,32 @@ export interface PromptState {
|
|
|
21
30
|
reason: 'init' | 'compaction' | 'generation-change' | 'override' | 'agent-change';
|
|
22
31
|
updatedAt: string;
|
|
23
32
|
}
|
|
33
|
+
/**
|
|
34
|
+
* ADR-107: блок памяти, фактически переданный в промпт последнего хода.
|
|
35
|
+
*
|
|
36
|
+
* Оценка токенов — эвристика проекта (`Math.ceil(chars / 4)`), как и в
|
|
37
|
+
* манифесте промпта (ADR-070 §2.5).
|
|
38
|
+
*/
|
|
39
|
+
export interface PromptMemoryBlock {
|
|
40
|
+
/** Сколько символов блока ушло в промпт. */
|
|
41
|
+
chars: number;
|
|
42
|
+
/** Оценка токенов (`ceil(chars / 4)`) — значение оценочное. */
|
|
43
|
+
estTokens: number;
|
|
44
|
+
/** Статус блока в манифесте промпта (`loaded`/`truncated`/`empty`/…). */
|
|
45
|
+
status: PromptManifestStatus;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* ADR-107: память в промпте последнего хода — по блокам.
|
|
49
|
+
*
|
|
50
|
+
* Поля отсутствуют, если блок не передавался (плагин памяти не активен или
|
|
51
|
+
* блок пуст) — аддитивно, старые записи остаются валидными.
|
|
52
|
+
*/
|
|
53
|
+
export interface PromptMemoryMeta {
|
|
54
|
+
/** Блок фактов памяти (`plugin.synth-plugin-memory.facts`). */
|
|
55
|
+
facts?: PromptMemoryBlock;
|
|
56
|
+
/** Блок recall-контекста (`plugin.synth-plugin-memory.recall`). */
|
|
57
|
+
recall?: PromptMemoryBlock;
|
|
58
|
+
}
|
|
24
59
|
/** ADR-070 §2.4: компактная мета промпта, кладётся в assistant-сообщение. */
|
|
25
60
|
export interface PromptMeta {
|
|
26
61
|
/** agentKey, к которому относится ход (agentRole или `__default__`). */
|
|
@@ -32,6 +67,12 @@ export interface PromptMeta {
|
|
|
32
67
|
cachedTokens: number;
|
|
33
68
|
/** expected подтверждён/опровергнут фактом. */
|
|
34
69
|
validated: boolean;
|
|
70
|
+
/**
|
|
71
|
+
* ADR-107: блоки памяти, реально попавшие в промпт хода.
|
|
72
|
+
*
|
|
73
|
+
* Не задано — память в промпте не участвовала.
|
|
74
|
+
*/
|
|
75
|
+
memory?: PromptMemoryMeta;
|
|
35
76
|
}
|
|
36
77
|
/** Тир консистентности блока системного промпта (ADR-070 §2.1). */
|
|
37
78
|
export type PromptTier = 'stable' | 'context' | 'volatile';
|
|
@@ -52,10 +93,11 @@ export interface PromptManifestEntry {
|
|
|
52
93
|
/**
|
|
53
94
|
* Источник записи: `system` — блок системного промпта, `tools` — слой
|
|
54
95
|
* встроенных инструментов (stable, ADR-070 §2.5), `mcp.tools` — слой
|
|
55
|
-
* MCP-инструментов (volatile, ADR-071 §2.1).
|
|
96
|
+
* MCP-инструментов (volatile, ADR-071 §2.1), `plugin.tools` — слой
|
|
97
|
+
* инструментов плагинов (volatile, ADR-090). Слои инструментов не входят в
|
|
56
98
|
* system-текст, но отражаются в манифесте и размерах.
|
|
57
99
|
*/
|
|
58
|
-
source?: 'system' | 'tools' | 'mcp.tools';
|
|
100
|
+
source?: 'system' | 'tools' | 'mcp.tools' | 'plugin.tools';
|
|
59
101
|
}
|
|
60
102
|
/** ADR-070 §2.5: манифест состава системного промпта (для API/UI/тестов). */
|
|
61
103
|
export interface PromptManifest {
|
|
@@ -110,7 +152,7 @@ export interface PromptToolDetail {
|
|
|
110
152
|
* `admin_disabled` (жёстко отключён администратором через `tools.disabled`),
|
|
111
153
|
* `dependency` (в окружении нет нужной программы — git/rg/sh),
|
|
112
154
|
* `workspace` (не задан рабочий каталог проекта),
|
|
113
|
-
* `storage` (хранилище недоступно — деградированный read-only режим,
|
|
155
|
+
* `storage` (хранилище недоступно — деградированный read-only режим, ADR-098).
|
|
114
156
|
*/
|
|
115
157
|
reason?: 'mode' | 'role' | 'admin_disabled' | 'dependency' | 'workspace' | 'storage';
|
|
116
158
|
/** ADR-071 §2.1: источник инструмента (`built-in` — слой `tools`). */
|
package/dist/types/provider.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import type { AttachmentModality } from '../model-metadata.js';
|
|
1
2
|
/** Валюта цен моделей. Отсутствует у модели → валюта провайдера → USD. */
|
|
2
3
|
export declare const CURRENCIES: readonly ["RUB", "USD", "CNY"];
|
|
3
4
|
export type Currency = (typeof CURRENCIES)[number];
|
|
@@ -81,4 +82,14 @@ export interface ModelConfig {
|
|
|
81
82
|
priceSource?: PriceSource;
|
|
82
83
|
/** Валюта цен модели; отсутствует → валюта провайдера → USD. */
|
|
83
84
|
currency?: Currency;
|
|
85
|
+
/**
|
|
86
|
+
* ADR-115: модальности входа модели (какие вложения она принимает).
|
|
87
|
+
*
|
|
88
|
+
* Источник истины — каталог провайдера (`architecture.input_modalities` при
|
|
89
|
+
* синхронизации моделей, `POST /api/v2/models/fetch`) либо ручной override
|
|
90
|
+
* (`POST /api/v2/models`). Не задано — модальности неизвестны: вложения
|
|
91
|
+
* **не фильтруются** (ошибку непринятого типа вернёт провайдер);
|
|
92
|
+
* захардкоженного справочника модальностей нет (решение 2026-10-27).
|
|
93
|
+
*/
|
|
94
|
+
modalities?: AttachmentModality[];
|
|
84
95
|
}
|