@itphx/synth-shared 0.11.3 → 0.12.4

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 (92) hide show
  1. package/dist/config/defaults.js +126 -3
  2. package/dist/config/env-overrides.d.ts +29 -0
  3. package/dist/config/env-overrides.js +155 -2
  4. package/dist/config/execution.d.ts +66 -0
  5. package/dist/config/execution.js +146 -0
  6. package/dist/config/index.d.ts +1 -0
  7. package/dist/config/index.js +1 -0
  8. package/dist/config/proxy.js +3 -1
  9. package/dist/config/resolve.d.ts +8 -8
  10. package/dist/config/resolve.js +7 -7
  11. package/dist/config/types.d.ts +1287 -4037
  12. package/dist/config/types.js +461 -68
  13. package/dist/i18n/index.d.ts +1 -1
  14. package/dist/i18n/index.js +277 -0
  15. package/dist/index.d.ts +14 -2
  16. package/dist/index.js +16 -2
  17. package/dist/model-metadata.d.ts +10 -0
  18. package/dist/schemas/index.d.ts +980 -2322
  19. package/dist/schemas/index.js +183 -22
  20. package/dist/types/analytics.d.ts +6 -6
  21. package/dist/types/analytics.js +4 -4
  22. package/dist/types/authority.d.ts +464 -0
  23. package/dist/types/authority.js +445 -0
  24. package/dist/types/background.d.ts +96 -0
  25. package/dist/types/background.js +24 -0
  26. package/dist/types/bus-events.d.ts +23 -1
  27. package/dist/types/catalog.d.ts +349 -0
  28. package/dist/types/catalog.js +393 -0
  29. package/dist/types/decision.d.ts +28 -337
  30. package/dist/types/egress.d.ts +1 -1
  31. package/dist/types/egress.js +1 -1
  32. package/dist/types/events.d.ts +54 -1
  33. package/dist/types/external-credentials.d.ts +352 -0
  34. package/dist/types/external-credentials.js +200 -0
  35. package/dist/types/hooks.d.ts +33 -12
  36. package/dist/types/index.d.ts +20 -0
  37. package/dist/types/index.js +50 -1
  38. package/dist/types/llm-filters.d.ts +150 -0
  39. package/dist/types/llm-filters.js +54 -0
  40. package/dist/types/mcp.d.ts +33 -2
  41. package/dist/types/mcp.js +44 -1
  42. package/dist/types/message.d.ts +45 -1
  43. package/dist/types/pack.d.ts +1102 -0
  44. package/dist/types/pack.js +1003 -0
  45. package/dist/types/permission.d.ts +25 -11
  46. package/dist/types/permission.js +1 -1
  47. package/dist/types/pipeline-engine.d.ts +453 -0
  48. package/dist/types/pipeline-engine.js +440 -0
  49. package/dist/types/pipeline.d.ts +275 -0
  50. package/dist/types/pipeline.js +212 -0
  51. package/dist/types/plugin-audit.d.ts +110 -0
  52. package/dist/types/plugin-audit.js +185 -0
  53. package/dist/types/plugin-hybrid.d.ts +85 -0
  54. package/dist/types/plugin-hybrid.js +68 -0
  55. package/dist/types/plugin-lock.d.ts +95 -0
  56. package/dist/types/plugin-lock.js +1 -0
  57. package/dist/types/plugin-protocol.d.ts +221 -0
  58. package/dist/types/plugin-protocol.js +322 -0
  59. package/dist/types/plugin-runtime.d.ts +25 -0
  60. package/dist/types/plugin-runtime.js +11 -0
  61. package/dist/types/plugin-scan.d.ts +159 -0
  62. package/dist/types/plugin-scan.js +166 -0
  63. package/dist/types/plugin-tools.d.ts +51 -0
  64. package/dist/types/plugin-tools.js +72 -0
  65. package/dist/types/project.d.ts +14 -0
  66. package/dist/types/prompt-blocks.d.ts +102 -0
  67. package/dist/types/prompt-blocks.js +24 -0
  68. package/dist/types/prompt.d.ts +45 -3
  69. package/dist/types/provider.d.ts +11 -0
  70. package/dist/types/question.d.ts +153 -0
  71. package/dist/types/question.js +65 -0
  72. package/dist/types/schedules.d.ts +26 -3
  73. package/dist/types/semver.d.ts +48 -0
  74. package/dist/types/semver.js +218 -0
  75. package/dist/types/service-keys.d.ts +41 -3
  76. package/dist/types/service-keys.js +44 -2
  77. package/dist/types/session.d.ts +54 -0
  78. package/dist/types/steering.d.ts +74 -0
  79. package/dist/types/steering.js +75 -0
  80. package/dist/types/tools.d.ts +125 -5
  81. package/dist/types/tools.js +75 -0
  82. package/dist/types/trust.d.ts +31 -0
  83. package/dist/types/trust.js +27 -0
  84. package/dist/types/worktree.d.ts +170 -0
  85. package/dist/types/worktree.js +101 -0
  86. package/dist/utils/index.d.ts +31 -1
  87. package/dist/utils/index.js +92 -12
  88. package/dist/utils/reasoning.d.ts +16 -0
  89. package/dist/utils/reasoning.js +37 -0
  90. package/dist/version.d.ts +1 -1
  91. package/dist/version.js +1 -1
  92. package/package.json +2 -2
@@ -0,0 +1,1102 @@
1
+ /**
2
+ * ADR-086 §5 / ADR-090: единый манифест расширения `synth.pack`.
3
+ *
4
+ * Манифест — файл `synth.pack` (JSON) в корне репозитория расширения. Формат
5
+ * **общий** для всех классов расширений: Plugin (ADR-090), Gateway (ADR-087),
6
+ * Add-on (эталон — `synth-media`), контент-пак (PROP-068) и драйвер слоя
7
+ * хранения (`kind: 'storage'`, ADR-097).
8
+ *
9
+ * Здесь только контракт (типы + zod-схемы): загрузка, установка и активация
10
+ * расширений — в core (ADR-090 отложен до 2026-10-19). Модуль browser-safe
11
+ * (`zod` + локальные типы), в UI-бандл `node:*` не попадает.
12
+ */
13
+ import { z } from 'zod';
14
+ /**
15
+ * Классы расширений (ADR-086 §5):
16
+ * - `plugin` — код в процессе ядра (ADR-090);
17
+ * - `gateway` — внешний транспорт «внешний мир ↔ Synth» (ADR-087);
18
+ * - `addon` — внешний сервис-надстройка (эталон — `synth-media`);
19
+ * - `pack` — контент-пак;
20
+ * - `storage` — драйвер слоя хранения (ADR-097).
21
+ */
22
+ export declare const PACK_KINDS: readonly ["plugin", "gateway", "addon", "pack", "storage"];
23
+ export type PackKind = (typeof PACK_KINDS)[number];
24
+ export declare const packKindSchema: z.ZodEnum<{
25
+ storage: "storage";
26
+ pack: "pack";
27
+ plugin: "plugin";
28
+ gateway: "gateway";
29
+ addon: "addon";
30
+ }>;
31
+ /**
32
+ * Типы контент-пака (`kind: 'pack'`) — ADR-086 §5 / PROP-068.
33
+ *
34
+ * `packType` описывает **основной** вид вклада пака; фактический состав задаёт
35
+ * `provides`. Решение владельца: «контент-пак» = **набор `provides`**, поэтому
36
+ * `provides` у любого класса (в т.ч. у `addon` — у `synth-media` свой
37
+ * сервис-receiver, `kind` остаётся `addon`) может включать `agents` и
38
+ * `pipelines`; `packType` — только для `kind: 'pack'`.
39
+ */
40
+ export declare const PACK_TYPES: readonly ["skills", "agents", "mcp", "themes", "i18n", "providers", "prompts", "automation", "policies", "memory", "ui"];
41
+ export type PackType = (typeof PACK_TYPES)[number];
42
+ export declare const packTypeSchema: z.ZodEnum<{
43
+ mcp: "mcp";
44
+ agents: "agents";
45
+ memory: "memory";
46
+ skills: "skills";
47
+ providers: "providers";
48
+ ui: "ui";
49
+ i18n: "i18n";
50
+ themes: "themes";
51
+ prompts: "prompts";
52
+ automation: "automation";
53
+ policies: "policies";
54
+ }>;
55
+ /**
56
+ * Имя расширения: slug (`synth-media`) либо npm-имя со scope
57
+ * (`@itphx/synth-gateway-telegram`).
58
+ */
59
+ export declare const PACK_NAME_REGEX: RegExp;
60
+ export declare const packNameSchema: z.ZodString;
61
+ /** Semver версии расширения (`MAJOR.MINOR.PATCH`, с пре-релизом/сборкой). */
62
+ export declare const PACK_VERSION_REGEX: RegExp;
63
+ export declare const packVersionSchema: z.ZodString;
64
+ /**
65
+ * Диапазон версий host-приложения — semver-range, как `engines` в package.json
66
+ * (`^0.9.0`, `~1.2.3`, `>=1.0.0 <2.0.0`, `1.x`).
67
+ *
68
+ * Грамматика — единая для `host` и `contracts` манифеста (ADR-090):
69
+ * реализация и матчер — в `types/semver.ts`.
70
+ */
71
+ export declare const PACK_HOST_RANGE_REGEX: RegExp;
72
+ /** Проверяет, что значение — корректный semver-диапазон (host-версия). */
73
+ export declare function isPackHostRange(value: string): boolean;
74
+ export declare const packHostSchema: z.ZodString;
75
+ /**
76
+ * MCP-предоставление: MCP-сервер, который расширение регистрирует в инстансе
77
+ * (ADR-071). `transport: 'http'` — сервер в контуре расширения (адрес собирается
78
+ * из `url`/`port`+`path`), `transport: 'stdio'` — локальный процесс.
79
+ */
80
+ export declare const packMcpProvideSchema: z.ZodObject<{
81
+ name: z.ZodString;
82
+ transport: z.ZodEnum<{
83
+ stdio: "stdio";
84
+ http: "http";
85
+ }>;
86
+ port: z.ZodOptional<z.ZodNumber>;
87
+ path: z.ZodOptional<z.ZodString>;
88
+ url: z.ZodOptional<z.ZodString>;
89
+ description: z.ZodOptional<z.ZodString>;
90
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
91
+ }, z.core.$strip>;
92
+ export type PackMcpProvide = z.infer<typeof packMcpProvideSchema>;
93
+ /**
94
+ * Метаданные скилла в манифесте. Блок `metadata.synth` (ADR-046 §6.2:
95
+ * `agents`/`requires_capabilities`/`scope`/`trigger`/`groups`) произвольный по
96
+ * составу — схема его не детализирует, но и не отбрасывает.
97
+ */
98
+ export declare const packSkillMetadataSchema: z.ZodObject<{
99
+ synth: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
100
+ }, z.core.$catchall<z.ZodUnknown>>;
101
+ /** Скилл-предоставление (ADR-046): каталог скилла внутри пака. */
102
+ export declare const packSkillProvideSchema: z.ZodObject<{
103
+ name: z.ZodString;
104
+ path: z.ZodString;
105
+ metadata: z.ZodOptional<z.ZodObject<{
106
+ synth: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
107
+ }, z.core.$catchall<z.ZodUnknown>>>;
108
+ }, z.core.$strip>;
109
+ export type PackSkillProvide = z.infer<typeof packSkillProvideSchema>;
110
+ /** Режимы агента — зеркалят `AgentMode` (`types/agent.ts`). */
111
+ export declare const PACK_AGENT_MODES: readonly ["primary", "subagent", "system"];
112
+ export type PackAgentMode = (typeof PACK_AGENT_MODES)[number];
113
+ /**
114
+ * Агент-предоставление (PROP-068: agent-паки). Поля повторяют
115
+ * `AgentDefinition` (`types/agent.ts`), но без runtime-полей (`enabled`,
116
+ * `isOverridden`): манифест объявляет **предоставление**, а не состояние.
117
+ *
118
+ * `capabilities` — строки; принадлежность известному набору `ToolCapability`
119
+ * проверяет `validatePackManifest` (схема намеренно терпима: новые capability
120
+ * не должны ломать чтение манифеста).
121
+ */
122
+ export declare const packAgentProvideSchema: z.ZodObject<{
123
+ id: z.ZodString;
124
+ path: z.ZodOptional<z.ZodString>;
125
+ rolePrompt: z.ZodOptional<z.ZodObject<{
126
+ path: z.ZodOptional<z.ZodString>;
127
+ content: z.ZodOptional<z.ZodString>;
128
+ }, z.core.$strip>>;
129
+ displayName: z.ZodOptional<z.ZodString>;
130
+ description: z.ZodOptional<z.ZodString>;
131
+ capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
132
+ agentMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
133
+ subagent: "subagent";
134
+ system: "system";
135
+ primary: "primary";
136
+ }>, z.ZodArray<z.ZodEnum<{
137
+ subagent: "subagent";
138
+ system: "system";
139
+ primary: "primary";
140
+ }>>]>>;
141
+ icon: z.ZodOptional<z.ZodString>;
142
+ color: z.ZodOptional<z.ZodString>;
143
+ provider: z.ZodOptional<z.ZodString>;
144
+ model: z.ZodOptional<z.ZodString>;
145
+ groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
146
+ maxSteps: z.ZodOptional<z.ZodNumber>;
147
+ }, z.core.$strip>;
148
+ export type PackAgentProvide = z.infer<typeof packAgentProvideSchema>;
149
+ /**
150
+ * Пайплайн-предоставление (ADR-051/ADR-100): описание автомата. Либо файл
151
+ * (`path`), либо inline-определение (`definition` — тот же контракт, что и
152
+ * `pipelineDefinitionSchema`).
153
+ */
154
+ export declare const packPipelineProvideSchema: z.ZodObject<{
155
+ id: z.ZodString;
156
+ path: z.ZodOptional<z.ZodString>;
157
+ definition: z.ZodOptional<z.ZodObject<{
158
+ id: z.ZodString;
159
+ name: z.ZodString;
160
+ description: z.ZodOptional<z.ZodString>;
161
+ version: z.ZodOptional<z.ZodString>;
162
+ steps: z.ZodArray<z.ZodObject<{
163
+ id: z.ZodString;
164
+ kind: z.ZodDefault<z.ZodEnum<{
165
+ agent: "agent";
166
+ loop: "loop";
167
+ }>>;
168
+ title: z.ZodOptional<z.ZodString>;
169
+ agent: z.ZodOptional<z.ZodString>;
170
+ skill: z.ZodOptional<z.ZodString>;
171
+ prompt: z.ZodOptional<z.ZodString>;
172
+ waitsFor: z.ZodOptional<z.ZodObject<{
173
+ source: z.ZodOptional<z.ZodString>;
174
+ type: z.ZodOptional<z.ZodString>;
175
+ }, z.core.$strip>>;
176
+ artifact: z.ZodOptional<z.ZodObject<{
177
+ kind: z.ZodString;
178
+ id: z.ZodOptional<z.ZodString>;
179
+ from: z.ZodOptional<z.ZodString>;
180
+ source: z.ZodOptional<z.ZodString>;
181
+ type: z.ZodOptional<z.ZodString>;
182
+ path: z.ZodOptional<z.ZodString>;
183
+ mime: z.ZodOptional<z.ZodString>;
184
+ size: z.ZodOptional<z.ZodNumber>;
185
+ name: z.ZodOptional<z.ZodString>;
186
+ payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
187
+ }, z.core.$strip>>;
188
+ timeoutSec: z.ZodOptional<z.ZodNumber>;
189
+ }, z.core.$strip>>;
190
+ onError: z.ZodOptional<z.ZodEnum<{
191
+ fail: "fail";
192
+ retry: "retry";
193
+ rollback: "rollback";
194
+ }>>;
195
+ maxAttempts: z.ZodOptional<z.ZodNumber>;
196
+ ttl: z.ZodOptional<z.ZodString>;
197
+ }, z.core.$strip>>;
198
+ }, z.core.$strip>;
199
+ export type PackPipelineProvide = z.infer<typeof packPipelineProvideSchema>;
200
+ /**
201
+ * `provides.mcp` — массив MCP-серверов **или** одиночный объект.
202
+ *
203
+ * Объектная форма — обратная совместимость: уже выпущенные манифесты
204
+ * (`synth-media`, `synth-gateway-telegram`) объявляют `provides.mcp` объектом.
205
+ * Форма нормализуется в массив, чтобы один пак мог регистрировать несколько
206
+ * MCP-серверов; `normalizePackProvides` делает то же для сырого JSON.
207
+ */
208
+ export declare const packMcpProvidesSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
209
+ name: z.ZodString;
210
+ transport: z.ZodEnum<{
211
+ stdio: "stdio";
212
+ http: "http";
213
+ }>;
214
+ port: z.ZodOptional<z.ZodNumber>;
215
+ path: z.ZodOptional<z.ZodString>;
216
+ url: z.ZodOptional<z.ZodString>;
217
+ description: z.ZodOptional<z.ZodString>;
218
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
219
+ }, z.core.$strip>>, z.ZodObject<{
220
+ name: z.ZodString;
221
+ transport: z.ZodEnum<{
222
+ stdio: "stdio";
223
+ http: "http";
224
+ }>;
225
+ port: z.ZodOptional<z.ZodNumber>;
226
+ path: z.ZodOptional<z.ZodString>;
227
+ url: z.ZodOptional<z.ZodString>;
228
+ description: z.ZodOptional<z.ZodString>;
229
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
230
+ }, z.core.$strip>]>, z.ZodTransform<{
231
+ name: string;
232
+ transport: "stdio" | "http";
233
+ port?: number | undefined;
234
+ path?: string | undefined;
235
+ url?: string | undefined;
236
+ description?: string | undefined;
237
+ headers?: Record<string, string> | undefined;
238
+ }[], {
239
+ name: string;
240
+ transport: "stdio" | "http";
241
+ port?: number | undefined;
242
+ path?: string | undefined;
243
+ url?: string | undefined;
244
+ description?: string | undefined;
245
+ headers?: Record<string, string> | undefined;
246
+ } | {
247
+ name: string;
248
+ transport: "stdio" | "http";
249
+ port?: number | undefined;
250
+ path?: string | undefined;
251
+ url?: string | undefined;
252
+ description?: string | undefined;
253
+ headers?: Record<string, string> | undefined;
254
+ }[]>>;
255
+ /**
256
+ * ADR-090: режим исполнения плагина — `inline` (код в процессе core) или
257
+ * `remote` (отдельный процесс), `both` — оба транспорта.
258
+ *
259
+ * Поле допустимо **только** для `kind: 'plugin'` (у остальных классов режим
260
+ * исполнения не задаётся — см. `validatePackManifest`).
261
+ */
262
+ export declare const PACK_PLUGIN_MODES: readonly ["inline", "remote", "both"];
263
+ export type PackPluginMode = (typeof PACK_PLUGIN_MODES)[number];
264
+ export declare const packPluginModeSchema: z.ZodEnum<{
265
+ inline: "inline";
266
+ remote: "remote";
267
+ both: "both";
268
+ }>;
269
+ /**
270
+ * ADR-090: заявленные расширением доступы (`permissions`).
271
+ *
272
+ * - `network` — хосты, к которым плагин обращается (проверяются по
273
+ * egress-политике, ADR-099);
274
+ * - `secrets` — имена секретов, которые плагин запрашивает через API
275
+ * (at-rest по модели ADR-076; значение секрета в манифесте не хранится);
276
+ * - `tools` — имена встроенных тулов, которые плагин использует;
277
+ * - `hooks` — имена хуков, на которые плагин подписывается.
278
+ *
279
+ * Заявление прав — **не** само разрешение: фактический доступ определяется
280
+ * permission-слоем (ADR-025/ADR-028/ADR-029) и egress-политикой.
281
+ */
282
+ export declare const packPermissionsSchema: z.ZodObject<{
283
+ network: z.ZodDefault<z.ZodArray<z.ZodString>>;
284
+ secrets: z.ZodDefault<z.ZodArray<z.ZodString>>;
285
+ tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
286
+ hooks: z.ZodDefault<z.ZodArray<z.ZodString>>;
287
+ }, z.core.$strip>;
288
+ export type PackPermissions = z.infer<typeof packPermissionsSchema>;
289
+ /**
290
+ * ADR-090: заявленный автором уровень/источник доверия.
291
+ *
292
+ * **Заявленный уровень — только верхняя граница:** фактический trust
293
+ * резолвится по источнику/реестру (PROP-068 §4.1), манифест не может его
294
+ * повысить. Для `kind: 'plugin'` уровень не должен быть выше `trusted`
295
+ * (trust-floor плагина, ADR-090) — проверяется в `validatePackManifest`.
296
+ */
297
+ export declare const packTrustSchema: z.ZodObject<{
298
+ level: z.ZodOptional<z.ZodEnum<{
299
+ builtin: "builtin";
300
+ verified: "verified";
301
+ trusted: "trusted";
302
+ community: "community";
303
+ }>>;
304
+ source: z.ZodOptional<z.ZodString>;
305
+ }, z.core.$strip>;
306
+ export type PackTrust = z.infer<typeof packTrustSchema>;
307
+ /**
308
+ * ADR-090: `provides.tools[]` — имена тулов, которые регистрирует
309
+ * плагин (имя тула — `tool.name` в `ToolRegistry.register`).
310
+ *
311
+ * Имена уникальны в пределах манифеста; фактические регистрации обязаны
312
+ * совпадать с этим списком (сверка — `diffPackProvides`).
313
+ */
314
+ export declare const packToolsProvideSchema: z.ZodArray<z.ZodString>;
315
+ export type PackToolsProvide = z.infer<typeof packToolsProvideSchema>;
316
+ /**
317
+ * ADR-090: `provides.promptBlocks[]` — описание плагинных блоков
318
+ * системного промпта.
319
+ *
320
+ * - `key` — ключ блока (для плагина — `plugin.<pluginName>.<slot>`);
321
+ * - `tier` — тир блока: **только** `context`/`volatile`; `stable` запрещён
322
+ * (граница prompt-cache, ADR-070);
323
+ * - `order` — порядок внутри тира (число);
324
+ * - `title`/`provenance` — подпись для манифеста промпта и источник
325
+ * (`provenance` для плагинного блока — `plugin:<name>`).
326
+ *
327
+ * Схема **строгая** (`.strict()`): неизвестное поле — ошибка, а не молчаливое
328
+ * проигнорирование (иначе опечатка в манифесте проходит незамеченной).
329
+ */
330
+ export declare const packPromptBlockProvideSchema: z.ZodObject<{
331
+ key: z.ZodString;
332
+ tier: z.ZodEnum<{
333
+ context: "context";
334
+ volatile: "volatile";
335
+ }>;
336
+ order: z.ZodNumber;
337
+ title: z.ZodOptional<z.ZodString>;
338
+ provenance: z.ZodOptional<z.ZodString>;
339
+ }, z.core.$strict>;
340
+ export type PackPromptBlockProvide = z.infer<typeof packPromptBlockProvideSchema>;
341
+ /**
342
+ * ADR-090: `provides.llmFilters[]` — описание фильтров LLM-вызовов.
343
+ *
344
+ * - `id` — идентификатор фильтра (`plugin:<pluginName>:<filterName>`);
345
+ * - `phase` — фаза: `pre_request` / `post_response` / `embedding`
346
+ * (третья фаза — решение владельца 2026-10-22);
347
+ * - `failMode` — поведение при сбое/таймауте фильтра (`open` — пропустить,
348
+ * `closed` — заблокировать); не задан — по классу фильтра (блокирующий —
349
+ * `closed`, наблюдательный — `open`);
350
+ * - `timeoutMs` — бюджет времени на вызов фильтра (мс).
351
+ */
352
+ export declare const packLlmFilterProvideSchema: z.ZodObject<{
353
+ id: z.ZodString;
354
+ phase: z.ZodEnum<{
355
+ pre_request: "pre_request";
356
+ post_response: "post_response";
357
+ embedding: "embedding";
358
+ }>;
359
+ failMode: z.ZodOptional<z.ZodEnum<{
360
+ open: "open";
361
+ closed: "closed";
362
+ }>>;
363
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
364
+ }, z.core.$strict>;
365
+ export type PackLlmFilterProvide = z.infer<typeof packLlmFilterProvideSchema>;
366
+ /**
367
+ * ADR-106 §«Доменная нейтральность и доставка контентом»: агент, которому
368
+ * пакет поставляет роли и потолок.
369
+ *
370
+ * `roles[]` — роли агента (id из `provides.authority.roles[]`), `ceiling[]` —
371
+ * потолок агента (id действий из `provides.authority.actions[]`). Оба списка
372
+ * проверяются на объявленность — неизвестная роль/действие → отказ установки.
373
+ */
374
+ export declare const packAuthorityAgentProvideSchema: z.ZodObject<{
375
+ id: z.ZodString;
376
+ roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
377
+ ceiling: z.ZodDefault<z.ZodArray<z.ZodString>>;
378
+ }, z.core.$strict>;
379
+ export type PackAuthorityAgentProvide = z.infer<typeof packAuthorityAgentProvideSchema>;
380
+ /**
381
+ * ADR-106: `provides.authority` — **контент** полномочий: роли, действия,
382
+ * цели и агенты с ролями.
383
+ *
384
+ * Схема **строгая** (`.strict()`): неизвестное поле — ошибка, а не молчаливое
385
+ * игнорирование. Кросс-ссылки проверяются на разборе: грант на
386
+ * необъявленное действие, агент на необъявленную роль, шаблон цели на
387
+ * неизвестный вид цели → **отказ** (ADR-106 §«Валидация, а не каст»).
388
+ *
389
+ * Пакет **не выдаёт права сам себе**: объявленные роли становятся активными
390
+ * только после одобрения ADMIN и пересечения с политикой инстанса
391
+ * (ADR-106 §«Пересечение, не дарование»).
392
+ */
393
+ export declare const packAuthorityProvidesSchema: z.ZodObject<{
394
+ roles: z.ZodDefault<z.ZodArray<z.ZodObject<{
395
+ id: z.ZodString;
396
+ displayName: z.ZodOptional<z.ZodString>;
397
+ domain: z.ZodString;
398
+ grants: z.ZodDefault<z.ZodArray<z.ZodObject<{
399
+ action: z.ZodString;
400
+ targetPattern: z.ZodString;
401
+ effect: z.ZodEnum<{
402
+ allow: "allow";
403
+ deny: "deny";
404
+ ask: "ask";
405
+ }>;
406
+ constraints: z.ZodOptional<z.ZodObject<{
407
+ once: z.ZodOptional<z.ZodBoolean>;
408
+ ttlMs: z.ZodOptional<z.ZodNumber>;
409
+ maxCount: z.ZodOptional<z.ZodNumber>;
410
+ requireConfirm: z.ZodOptional<z.ZodBoolean>;
411
+ }, z.core.$strict>>;
412
+ }, z.core.$strict>>>;
413
+ }, z.core.$strict>>>;
414
+ actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
415
+ id: z.ZodString;
416
+ mutating: z.ZodBoolean;
417
+ requires: z.ZodDefault<z.ZodArray<z.ZodString>>;
418
+ }, z.core.$strict>>>;
419
+ targets: z.ZodDefault<z.ZodArray<z.ZodObject<{
420
+ kind: z.ZodString;
421
+ resolver: z.ZodOptional<z.ZodString>;
422
+ }, z.core.$strict>>>;
423
+ agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
424
+ id: z.ZodString;
425
+ roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
426
+ ceiling: z.ZodDefault<z.ZodArray<z.ZodString>>;
427
+ }, z.core.$strict>>>;
428
+ }, z.core.$strict>;
429
+ export type PackAuthorityProvides = z.infer<typeof packAuthorityProvidesSchema>;
430
+ /**
431
+ * ADR-106 Ф5: сводка контента полномочий пакета (`provides.authority`) —
432
+ * «**что именно** пакет приносит инстанцу».
433
+ *
434
+ * Сводка — **данные**, а не текст: показывает администратору состав пакета
435
+ * (`pending_approval` по существу — не только факт «есть capabilities»), и из
436
+ * неё же считается, что пакет добавит в политику инстанса. Мутирующие
437
+ * гранты помечены отдельно — по ним виден trust-floor (мутирующие роли
438
+ * активируются только при trust ≥ `trusted`).
439
+ */
440
+ /** Роль пакета в сводке. */
441
+ export interface PackAuthoritySummaryRole {
442
+ /** id роли (уникален в пределах пакета). */
443
+ id: string;
444
+ /** Отображаемое имя роли (если объявлено). */
445
+ displayName?: string;
446
+ /** Домен роли (`domain`). */
447
+ domain: string;
448
+ /** Число грантов роли. */
449
+ grants: number;
450
+ /** Число **мутирующих** грантов роли (действие меняет состояние). */
451
+ mutatingGrants: number;
452
+ }
453
+ /** Действие пакета в сводке. */
454
+ export interface PackAuthoritySummaryAction {
455
+ /** id доменного действия. */
456
+ id: string;
457
+ /** Заявленный признак мутирующего действия (информационный). */
458
+ mutating: boolean;
459
+ }
460
+ /** Вид цели пакета в сводке. */
461
+ export interface PackAuthoritySummaryTarget {
462
+ /** Вид цели (`kind`). */
463
+ kind: string;
464
+ /** Имя резолвера цели (если объявлен). */
465
+ resolver?: string;
466
+ }
467
+ /** Агент пакета в сводке (роли + потолок). */
468
+ export interface PackAuthoritySummaryAgent {
469
+ /** id агента. */
470
+ id: string;
471
+ /** Роли агента (id из `provides.authority.roles[]`). */
472
+ roles: string[];
473
+ /** Потолок агента (id действий из `provides.authority.actions[]`). */
474
+ ceiling: string[];
475
+ }
476
+ /** Сводка контента полномочий пакета. */
477
+ export interface PackAuthoritySummary {
478
+ /** Роли, которые пакет приносит. */
479
+ roles: PackAuthoritySummaryRole[];
480
+ /** Доменные действия, которые пакет объявляет. */
481
+ actions: PackAuthoritySummaryAction[];
482
+ /** Виды целей, которые пакет вводит. */
483
+ targets: PackAuthoritySummaryTarget[];
484
+ /** Агенты с ролями и потолком. */
485
+ agents: PackAuthoritySummaryAgent[];
486
+ /** Итоги — «сколько чего приносит пакет». */
487
+ totals: {
488
+ roles: number;
489
+ actions: number;
490
+ targets: number;
491
+ agents: number;
492
+ grants: number;
493
+ mutatingGrants: number;
494
+ };
495
+ }
496
+ /**
497
+ * Сводка контента полномочий пакета (`provides.authority`).
498
+ *
499
+ * Принимает **сырой** `provides` (как в сохранённом манифесте) — разбор
500
+ * defensive: неизвестные/битые элементы пропускаются, а не роняют ответ.
501
+ * Пустой контент → пустая сводка (нулевые итоги).
502
+ */
503
+ export declare function summarizePackAuthority(provides: unknown): PackAuthoritySummary;
504
+ /** Контент полномочий пакета непустой? (пустой контент — нечего активировать). */
505
+ export declare function hasPackAuthorityContent(provides: unknown): boolean;
506
+ /**
507
+ * Набор вкладов расширения. Списки нормализованы (отсутствующий список —
508
+ * пустой массив), неизвестные ключи сохраняются: виды вкладов расширяются
509
+ * без изменения формата манифеста.
510
+ *
511
+ * Ключи `tools`/`promptBlocks`/`llmFilters` (ADR-090) описаны **явными**
512
+ * схемами — без `.passthrough()`: иначе опечатка в манифесте (пустое имя тула,
513
+ * дубль, тир `stable`, неизвестная фаза фильтра) проходит молча, и правило
514
+ * «фактические регистрации обязаны совпадать с `provides`» нечем проверять.
515
+ *
516
+ * `authority` (ADR-106) — тоже **явная** схема: контент полномочий не
517
+ * проходит «как есть» (неизвестное действие/цель/роль → отказ разбора).
518
+ */
519
+ export declare const packProvidesSchema: z.ZodObject<{
520
+ mcp: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
521
+ name: z.ZodString;
522
+ transport: z.ZodEnum<{
523
+ stdio: "stdio";
524
+ http: "http";
525
+ }>;
526
+ port: z.ZodOptional<z.ZodNumber>;
527
+ path: z.ZodOptional<z.ZodString>;
528
+ url: z.ZodOptional<z.ZodString>;
529
+ description: z.ZodOptional<z.ZodString>;
530
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
531
+ }, z.core.$strip>>, z.ZodObject<{
532
+ name: z.ZodString;
533
+ transport: z.ZodEnum<{
534
+ stdio: "stdio";
535
+ http: "http";
536
+ }>;
537
+ port: z.ZodOptional<z.ZodNumber>;
538
+ path: z.ZodOptional<z.ZodString>;
539
+ url: z.ZodOptional<z.ZodString>;
540
+ description: z.ZodOptional<z.ZodString>;
541
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
542
+ }, z.core.$strip>]>, z.ZodTransform<{
543
+ name: string;
544
+ transport: "stdio" | "http";
545
+ port?: number | undefined;
546
+ path?: string | undefined;
547
+ url?: string | undefined;
548
+ description?: string | undefined;
549
+ headers?: Record<string, string> | undefined;
550
+ }[], {
551
+ name: string;
552
+ transport: "stdio" | "http";
553
+ port?: number | undefined;
554
+ path?: string | undefined;
555
+ url?: string | undefined;
556
+ description?: string | undefined;
557
+ headers?: Record<string, string> | undefined;
558
+ } | {
559
+ name: string;
560
+ transport: "stdio" | "http";
561
+ port?: number | undefined;
562
+ path?: string | undefined;
563
+ url?: string | undefined;
564
+ description?: string | undefined;
565
+ headers?: Record<string, string> | undefined;
566
+ }[]>>>;
567
+ skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
568
+ name: z.ZodString;
569
+ path: z.ZodString;
570
+ metadata: z.ZodOptional<z.ZodObject<{
571
+ synth: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
572
+ }, z.core.$catchall<z.ZodUnknown>>>;
573
+ }, z.core.$strip>>>;
574
+ agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
575
+ id: z.ZodString;
576
+ path: z.ZodOptional<z.ZodString>;
577
+ rolePrompt: z.ZodOptional<z.ZodObject<{
578
+ path: z.ZodOptional<z.ZodString>;
579
+ content: z.ZodOptional<z.ZodString>;
580
+ }, z.core.$strip>>;
581
+ displayName: z.ZodOptional<z.ZodString>;
582
+ description: z.ZodOptional<z.ZodString>;
583
+ capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
584
+ agentMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
585
+ subagent: "subagent";
586
+ system: "system";
587
+ primary: "primary";
588
+ }>, z.ZodArray<z.ZodEnum<{
589
+ subagent: "subagent";
590
+ system: "system";
591
+ primary: "primary";
592
+ }>>]>>;
593
+ icon: z.ZodOptional<z.ZodString>;
594
+ color: z.ZodOptional<z.ZodString>;
595
+ provider: z.ZodOptional<z.ZodString>;
596
+ model: z.ZodOptional<z.ZodString>;
597
+ groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
598
+ maxSteps: z.ZodOptional<z.ZodNumber>;
599
+ }, z.core.$strip>>>;
600
+ pipelines: z.ZodDefault<z.ZodArray<z.ZodObject<{
601
+ id: z.ZodString;
602
+ path: z.ZodOptional<z.ZodString>;
603
+ definition: z.ZodOptional<z.ZodObject<{
604
+ id: z.ZodString;
605
+ name: z.ZodString;
606
+ description: z.ZodOptional<z.ZodString>;
607
+ version: z.ZodOptional<z.ZodString>;
608
+ steps: z.ZodArray<z.ZodObject<{
609
+ id: z.ZodString;
610
+ kind: z.ZodDefault<z.ZodEnum<{
611
+ agent: "agent";
612
+ loop: "loop";
613
+ }>>;
614
+ title: z.ZodOptional<z.ZodString>;
615
+ agent: z.ZodOptional<z.ZodString>;
616
+ skill: z.ZodOptional<z.ZodString>;
617
+ prompt: z.ZodOptional<z.ZodString>;
618
+ waitsFor: z.ZodOptional<z.ZodObject<{
619
+ source: z.ZodOptional<z.ZodString>;
620
+ type: z.ZodOptional<z.ZodString>;
621
+ }, z.core.$strip>>;
622
+ artifact: z.ZodOptional<z.ZodObject<{
623
+ kind: z.ZodString;
624
+ id: z.ZodOptional<z.ZodString>;
625
+ from: z.ZodOptional<z.ZodString>;
626
+ source: z.ZodOptional<z.ZodString>;
627
+ type: z.ZodOptional<z.ZodString>;
628
+ path: z.ZodOptional<z.ZodString>;
629
+ mime: z.ZodOptional<z.ZodString>;
630
+ size: z.ZodOptional<z.ZodNumber>;
631
+ name: z.ZodOptional<z.ZodString>;
632
+ payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
633
+ }, z.core.$strip>>;
634
+ timeoutSec: z.ZodOptional<z.ZodNumber>;
635
+ }, z.core.$strip>>;
636
+ onError: z.ZodOptional<z.ZodEnum<{
637
+ fail: "fail";
638
+ retry: "retry";
639
+ rollback: "rollback";
640
+ }>>;
641
+ maxAttempts: z.ZodOptional<z.ZodNumber>;
642
+ ttl: z.ZodOptional<z.ZodString>;
643
+ }, z.core.$strip>>;
644
+ }, z.core.$strip>>>;
645
+ tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
646
+ promptBlocks: z.ZodDefault<z.ZodArray<z.ZodObject<{
647
+ key: z.ZodString;
648
+ tier: z.ZodEnum<{
649
+ context: "context";
650
+ volatile: "volatile";
651
+ }>;
652
+ order: z.ZodNumber;
653
+ title: z.ZodOptional<z.ZodString>;
654
+ provenance: z.ZodOptional<z.ZodString>;
655
+ }, z.core.$strict>>>;
656
+ llmFilters: z.ZodDefault<z.ZodArray<z.ZodObject<{
657
+ id: z.ZodString;
658
+ phase: z.ZodEnum<{
659
+ pre_request: "pre_request";
660
+ post_response: "post_response";
661
+ embedding: "embedding";
662
+ }>;
663
+ failMode: z.ZodOptional<z.ZodEnum<{
664
+ open: "open";
665
+ closed: "closed";
666
+ }>>;
667
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
668
+ }, z.core.$strict>>>;
669
+ authority: z.ZodPrefault<z.ZodObject<{
670
+ roles: z.ZodDefault<z.ZodArray<z.ZodObject<{
671
+ id: z.ZodString;
672
+ displayName: z.ZodOptional<z.ZodString>;
673
+ domain: z.ZodString;
674
+ grants: z.ZodDefault<z.ZodArray<z.ZodObject<{
675
+ action: z.ZodString;
676
+ targetPattern: z.ZodString;
677
+ effect: z.ZodEnum<{
678
+ allow: "allow";
679
+ deny: "deny";
680
+ ask: "ask";
681
+ }>;
682
+ constraints: z.ZodOptional<z.ZodObject<{
683
+ once: z.ZodOptional<z.ZodBoolean>;
684
+ ttlMs: z.ZodOptional<z.ZodNumber>;
685
+ maxCount: z.ZodOptional<z.ZodNumber>;
686
+ requireConfirm: z.ZodOptional<z.ZodBoolean>;
687
+ }, z.core.$strict>>;
688
+ }, z.core.$strict>>>;
689
+ }, z.core.$strict>>>;
690
+ actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
691
+ id: z.ZodString;
692
+ mutating: z.ZodBoolean;
693
+ requires: z.ZodDefault<z.ZodArray<z.ZodString>>;
694
+ }, z.core.$strict>>>;
695
+ targets: z.ZodDefault<z.ZodArray<z.ZodObject<{
696
+ kind: z.ZodString;
697
+ resolver: z.ZodOptional<z.ZodString>;
698
+ }, z.core.$strict>>>;
699
+ agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
700
+ id: z.ZodString;
701
+ roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
702
+ ceiling: z.ZodDefault<z.ZodArray<z.ZodString>>;
703
+ }, z.core.$strict>>>;
704
+ }, z.core.$strict>>;
705
+ }, z.core.$loose>;
706
+ export type PackProvides = z.infer<typeof packProvidesSchema>;
707
+ /**
708
+ * Инвариант `packType` — общий для манифеста (`packManifestSchema`) и карточки
709
+ * каталога расширений (`catalogEntrySchema`, PROP-068 §12):
710
+ * - `kind: 'pack'` **требует** `packType`;
711
+ * - `packType` запрещён у остальных `kind` (`addon`/`gateway`/`plugin`/
712
+ * `storage` — это классы кода/сервиса, а не контент-паки).
713
+ */
714
+ export declare function refinePackType(value: {
715
+ kind: PackKind;
716
+ packType?: PackType;
717
+ }, ctx: z.RefinementCtx): void;
718
+ /**
719
+ * Единый манифест расширения `synth.pack` (ADR-086 §5).
720
+ *
721
+ * Инварианты, зашитые в схему:
722
+ * - `kind: 'pack'` **требует** `packType`;
723
+ * - `packType` запрещён у остальных `kind` (`addon`/`gateway`/`plugin`/
724
+ * `storage` — это классы кода/сервиса, а не контент-паки).
725
+ *
726
+ * Поля `mode`/`permissions`/`trust` (ADR-090) — опциональные и
727
+ * **явные**: `z.object` выбрасывает неизвестные ключи, поэтому без них
728
+ * эти поля молча терялись при разборе манифеста.
729
+ */
730
+ export declare const packManifestSchema: z.ZodObject<{
731
+ name: z.ZodString;
732
+ version: z.ZodString;
733
+ kind: z.ZodEnum<{
734
+ storage: "storage";
735
+ pack: "pack";
736
+ plugin: "plugin";
737
+ gateway: "gateway";
738
+ addon: "addon";
739
+ }>;
740
+ host: z.ZodOptional<z.ZodString>;
741
+ contracts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
742
+ description: z.ZodString;
743
+ provides: z.ZodObject<{
744
+ mcp: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
745
+ name: z.ZodString;
746
+ transport: z.ZodEnum<{
747
+ stdio: "stdio";
748
+ http: "http";
749
+ }>;
750
+ port: z.ZodOptional<z.ZodNumber>;
751
+ path: z.ZodOptional<z.ZodString>;
752
+ url: z.ZodOptional<z.ZodString>;
753
+ description: z.ZodOptional<z.ZodString>;
754
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
755
+ }, z.core.$strip>>, z.ZodObject<{
756
+ name: z.ZodString;
757
+ transport: z.ZodEnum<{
758
+ stdio: "stdio";
759
+ http: "http";
760
+ }>;
761
+ port: z.ZodOptional<z.ZodNumber>;
762
+ path: z.ZodOptional<z.ZodString>;
763
+ url: z.ZodOptional<z.ZodString>;
764
+ description: z.ZodOptional<z.ZodString>;
765
+ headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
766
+ }, z.core.$strip>]>, z.ZodTransform<{
767
+ name: string;
768
+ transport: "stdio" | "http";
769
+ port?: number | undefined;
770
+ path?: string | undefined;
771
+ url?: string | undefined;
772
+ description?: string | undefined;
773
+ headers?: Record<string, string> | undefined;
774
+ }[], {
775
+ name: string;
776
+ transport: "stdio" | "http";
777
+ port?: number | undefined;
778
+ path?: string | undefined;
779
+ url?: string | undefined;
780
+ description?: string | undefined;
781
+ headers?: Record<string, string> | undefined;
782
+ } | {
783
+ name: string;
784
+ transport: "stdio" | "http";
785
+ port?: number | undefined;
786
+ path?: string | undefined;
787
+ url?: string | undefined;
788
+ description?: string | undefined;
789
+ headers?: Record<string, string> | undefined;
790
+ }[]>>>;
791
+ skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
792
+ name: z.ZodString;
793
+ path: z.ZodString;
794
+ metadata: z.ZodOptional<z.ZodObject<{
795
+ synth: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
796
+ }, z.core.$catchall<z.ZodUnknown>>>;
797
+ }, z.core.$strip>>>;
798
+ agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
799
+ id: z.ZodString;
800
+ path: z.ZodOptional<z.ZodString>;
801
+ rolePrompt: z.ZodOptional<z.ZodObject<{
802
+ path: z.ZodOptional<z.ZodString>;
803
+ content: z.ZodOptional<z.ZodString>;
804
+ }, z.core.$strip>>;
805
+ displayName: z.ZodOptional<z.ZodString>;
806
+ description: z.ZodOptional<z.ZodString>;
807
+ capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
808
+ agentMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
809
+ subagent: "subagent";
810
+ system: "system";
811
+ primary: "primary";
812
+ }>, z.ZodArray<z.ZodEnum<{
813
+ subagent: "subagent";
814
+ system: "system";
815
+ primary: "primary";
816
+ }>>]>>;
817
+ icon: z.ZodOptional<z.ZodString>;
818
+ color: z.ZodOptional<z.ZodString>;
819
+ provider: z.ZodOptional<z.ZodString>;
820
+ model: z.ZodOptional<z.ZodString>;
821
+ groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
822
+ maxSteps: z.ZodOptional<z.ZodNumber>;
823
+ }, z.core.$strip>>>;
824
+ pipelines: z.ZodDefault<z.ZodArray<z.ZodObject<{
825
+ id: z.ZodString;
826
+ path: z.ZodOptional<z.ZodString>;
827
+ definition: z.ZodOptional<z.ZodObject<{
828
+ id: z.ZodString;
829
+ name: z.ZodString;
830
+ description: z.ZodOptional<z.ZodString>;
831
+ version: z.ZodOptional<z.ZodString>;
832
+ steps: z.ZodArray<z.ZodObject<{
833
+ id: z.ZodString;
834
+ kind: z.ZodDefault<z.ZodEnum<{
835
+ agent: "agent";
836
+ loop: "loop";
837
+ }>>;
838
+ title: z.ZodOptional<z.ZodString>;
839
+ agent: z.ZodOptional<z.ZodString>;
840
+ skill: z.ZodOptional<z.ZodString>;
841
+ prompt: z.ZodOptional<z.ZodString>;
842
+ waitsFor: z.ZodOptional<z.ZodObject<{
843
+ source: z.ZodOptional<z.ZodString>;
844
+ type: z.ZodOptional<z.ZodString>;
845
+ }, z.core.$strip>>;
846
+ artifact: z.ZodOptional<z.ZodObject<{
847
+ kind: z.ZodString;
848
+ id: z.ZodOptional<z.ZodString>;
849
+ from: z.ZodOptional<z.ZodString>;
850
+ source: z.ZodOptional<z.ZodString>;
851
+ type: z.ZodOptional<z.ZodString>;
852
+ path: z.ZodOptional<z.ZodString>;
853
+ mime: z.ZodOptional<z.ZodString>;
854
+ size: z.ZodOptional<z.ZodNumber>;
855
+ name: z.ZodOptional<z.ZodString>;
856
+ payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
857
+ }, z.core.$strip>>;
858
+ timeoutSec: z.ZodOptional<z.ZodNumber>;
859
+ }, z.core.$strip>>;
860
+ onError: z.ZodOptional<z.ZodEnum<{
861
+ fail: "fail";
862
+ retry: "retry";
863
+ rollback: "rollback";
864
+ }>>;
865
+ maxAttempts: z.ZodOptional<z.ZodNumber>;
866
+ ttl: z.ZodOptional<z.ZodString>;
867
+ }, z.core.$strip>>;
868
+ }, z.core.$strip>>>;
869
+ tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
870
+ promptBlocks: z.ZodDefault<z.ZodArray<z.ZodObject<{
871
+ key: z.ZodString;
872
+ tier: z.ZodEnum<{
873
+ context: "context";
874
+ volatile: "volatile";
875
+ }>;
876
+ order: z.ZodNumber;
877
+ title: z.ZodOptional<z.ZodString>;
878
+ provenance: z.ZodOptional<z.ZodString>;
879
+ }, z.core.$strict>>>;
880
+ llmFilters: z.ZodDefault<z.ZodArray<z.ZodObject<{
881
+ id: z.ZodString;
882
+ phase: z.ZodEnum<{
883
+ pre_request: "pre_request";
884
+ post_response: "post_response";
885
+ embedding: "embedding";
886
+ }>;
887
+ failMode: z.ZodOptional<z.ZodEnum<{
888
+ open: "open";
889
+ closed: "closed";
890
+ }>>;
891
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
892
+ }, z.core.$strict>>>;
893
+ authority: z.ZodPrefault<z.ZodObject<{
894
+ roles: z.ZodDefault<z.ZodArray<z.ZodObject<{
895
+ id: z.ZodString;
896
+ displayName: z.ZodOptional<z.ZodString>;
897
+ domain: z.ZodString;
898
+ grants: z.ZodDefault<z.ZodArray<z.ZodObject<{
899
+ action: z.ZodString;
900
+ targetPattern: z.ZodString;
901
+ effect: z.ZodEnum<{
902
+ allow: "allow";
903
+ deny: "deny";
904
+ ask: "ask";
905
+ }>;
906
+ constraints: z.ZodOptional<z.ZodObject<{
907
+ once: z.ZodOptional<z.ZodBoolean>;
908
+ ttlMs: z.ZodOptional<z.ZodNumber>;
909
+ maxCount: z.ZodOptional<z.ZodNumber>;
910
+ requireConfirm: z.ZodOptional<z.ZodBoolean>;
911
+ }, z.core.$strict>>;
912
+ }, z.core.$strict>>>;
913
+ }, z.core.$strict>>>;
914
+ actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
915
+ id: z.ZodString;
916
+ mutating: z.ZodBoolean;
917
+ requires: z.ZodDefault<z.ZodArray<z.ZodString>>;
918
+ }, z.core.$strict>>>;
919
+ targets: z.ZodDefault<z.ZodArray<z.ZodObject<{
920
+ kind: z.ZodString;
921
+ resolver: z.ZodOptional<z.ZodString>;
922
+ }, z.core.$strict>>>;
923
+ agents: z.ZodDefault<z.ZodArray<z.ZodObject<{
924
+ id: z.ZodString;
925
+ roles: z.ZodDefault<z.ZodArray<z.ZodString>>;
926
+ ceiling: z.ZodDefault<z.ZodArray<z.ZodString>>;
927
+ }, z.core.$strict>>>;
928
+ }, z.core.$strict>>;
929
+ }, z.core.$loose>;
930
+ packType: z.ZodOptional<z.ZodEnum<{
931
+ mcp: "mcp";
932
+ agents: "agents";
933
+ memory: "memory";
934
+ skills: "skills";
935
+ providers: "providers";
936
+ ui: "ui";
937
+ i18n: "i18n";
938
+ themes: "themes";
939
+ prompts: "prompts";
940
+ automation: "automation";
941
+ policies: "policies";
942
+ }>>;
943
+ mode: z.ZodOptional<z.ZodEnum<{
944
+ inline: "inline";
945
+ remote: "remote";
946
+ both: "both";
947
+ }>>;
948
+ permissions: z.ZodOptional<z.ZodObject<{
949
+ network: z.ZodDefault<z.ZodArray<z.ZodString>>;
950
+ secrets: z.ZodDefault<z.ZodArray<z.ZodString>>;
951
+ tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
952
+ hooks: z.ZodDefault<z.ZodArray<z.ZodString>>;
953
+ }, z.core.$strip>>;
954
+ trust: z.ZodOptional<z.ZodObject<{
955
+ level: z.ZodOptional<z.ZodEnum<{
956
+ builtin: "builtin";
957
+ verified: "verified";
958
+ trusted: "trusted";
959
+ community: "community";
960
+ }>>;
961
+ source: z.ZodOptional<z.ZodString>;
962
+ }, z.core.$strip>>;
963
+ }, z.core.$strip>;
964
+ export type PackManifest = z.infer<typeof packManifestSchema>;
965
+ /**
966
+ * Нормализация `provides` из сырого JSON: `mcp`-объект → массив, отсутствующие
967
+ * списки → пустые массивы, прочие (пока неизвестные) виды вкладов сохраняются.
968
+ *
969
+ * Зачем отдельная функция: манифесты `synth-media` и `synth-gateway-telegram`
970
+ * (выпущены и работают) объявляют `provides.mcp` **объектом**. Переход на
971
+ * массив не должен ломать их — потребитель (загрузчик расширений в core)
972
+ * всегда работает с нормализованной формой и не знает про legacy-объект.
973
+ *
974
+ * Нормализация отвечает только за **форму** (списки вместо объекта/пустоты);
975
+ * содержимое элементов остаётся ответственностью `packProvidesSchema`
976
+ * (валидация) — здесь элементы не проверяются и не отбрасываются.
977
+ */
978
+ export declare function normalizePackProvides(provides: unknown): PackProvides;
979
+ /**
980
+ * Проверка целостности манифеста — **список проблем строками**, без throw.
981
+ *
982
+ * Функция принимает «сырое» значение (например, разобранный JSON): в отличие
983
+ * от `packManifestSchema` она не отбрасывает манифест целиком, а перечисляет
984
+ * все проблемы (неизвестный `kind`/`packType`, пустой `provides`, дубликаты,
985
+ * записи без обязательных полей, неизвестные capability).
986
+ *
987
+ * Разделение ответственности: `packManifestSchema` — **структура** (формат
988
+ * полей, semver, инвариант `packType`), `validatePackManifest` — **семантика**
989
+ * (смысловые правила целостности, перечисленные ниже).
990
+ *
991
+ * Проверяются правила:
992
+ * 1. неизвестный `kind`;
993
+ * 2. неизвестный `packType`;
994
+ * 3. `provides` без единого элемента;
995
+ * 4. `kind: 'pack'` без `packType`;
996
+ * 5. `packType` у другого `kind`;
997
+ * 6. дубликаты `name`/`id` внутри `provides`;
998
+ * 7. агент без `id`;
999
+ * 8. MCP без `name`/`transport`;
1000
+ * 9. скилл без `name`/`path`;
1001
+ * 10. пайплайн без `id`;
1002
+ * 11. `agents[].capabilities` — строки из известного набора `ToolCapability`;
1003
+ * 12. вклады плагина (`provides.tools`/`promptBlocks`/`llmFilters`) — по
1004
+ * явным схемам ADR-090;
1005
+ * 13. `mode` — только для `kind: 'plugin'`;
1006
+ * 14. `trust.level` плагина — не выше `trusted` (trust-floor, ADR-090);
1007
+ * 15. контент полномочий (`provides.authority`) — строгая схема + кросс-ссылки
1008
+ * (ADR-106 §«Валидация, а не каст»): неизвестное действие/цель/роль —
1009
+ * проблема, а не молчаливый проход.
1010
+ */
1011
+ export declare function validatePackManifest(manifest: unknown): string[];
1012
+ /** Вид вклада, по которому сверяются объявление и регистрация. */
1013
+ export type PackProvidesKind = 'tool' | 'promptBlock' | 'llmFilter';
1014
+ /**
1015
+ * Расхождение между объявленным в манифесте вкладом и фактической
1016
+ * регистрацией расширения.
1017
+ *
1018
+ * - `missing` — объявлено в `provides`, но не зарегистрировано;
1019
+ * - `unexpected` — зарегистрировано, но не объявлено.
1020
+ */
1021
+ export interface PackProvidesMismatch {
1022
+ kind: PackProvidesKind;
1023
+ /** Имя вклада (имя тула / ключ блока / id фильтра). */
1024
+ name: string;
1025
+ issue: 'missing' | 'unexpected';
1026
+ }
1027
+ /** Объявленные в манифесте вклады (из `provides`). */
1028
+ export interface DeclaredPackProvides {
1029
+ tools?: readonly string[];
1030
+ promptBlocks?: readonly {
1031
+ key: string;
1032
+ }[];
1033
+ llmFilters?: readonly {
1034
+ id: string;
1035
+ }[];
1036
+ }
1037
+ /** Фактически зарегистрированные расширением вклады. */
1038
+ export interface RegisteredPackProvides {
1039
+ tools?: readonly string[];
1040
+ promptBlocks?: readonly string[];
1041
+ llmFilters?: readonly string[];
1042
+ }
1043
+ /**
1044
+ * ADR-090: сверка объявленных в манифесте вкладов с фактическими
1045
+ * регистрациями расширения.
1046
+ *
1047
+ * Правило: «фактические регистрации обязаны совпадать с `provides`» —
1048
+ * расхождение (объявлено, но не зарегистрировано — и наоборот) означает
1049
+ * несогласованную сборку и должно вести к отказу активации (Ф1/Ф3).
1050
+ *
1051
+ * Функция возвращает **список расхождений** (пустой — совпадение) и не
1052
+ * бросает исключений: вызывающий (загрузчик `PluginHost`) сам решает, что
1053
+ * с ними делать.
1054
+ */
1055
+ export declare function diffPackProvides(declared: DeclaredPackProvides, registered: RegisteredPackProvides): PackProvidesMismatch[];
1056
+ /** Причина отказа семвер-гейта. */
1057
+ export type ExtensionCompatibilityReason = 'contract_mismatch' | 'host_mismatch';
1058
+ /**
1059
+ * Машиночитаемый вердикт семвер-гейта: расширение совместимо с хостом или
1060
+ * нет (и почему).
1061
+ */
1062
+ export interface ExtensionCompatibilityVerdict {
1063
+ ok: boolean;
1064
+ /** Причина отказа (нет при `ok: true`). */
1065
+ reason?: ExtensionCompatibilityReason;
1066
+ /** Ожидаемое значение (диапазон контракта/host). */
1067
+ expected?: string;
1068
+ /** Фактическое значение (версия контракта/host). */
1069
+ actual?: string;
1070
+ }
1071
+ /** Имя контракта Extension API по умолчанию (ADR-090). */
1072
+ export declare const DEFAULT_EXTENSION_CONTRACT = "extensionApi";
1073
+ /**
1074
+ * ADR-090 (шаг 3): семвер-гейт расширения против хоста.
1075
+ *
1076
+ * Проверяются два объявления манифеста:
1077
+ * - `contracts.extensionApi` — semver-диапазон версии контракта точки
1078
+ * расширения, которую предоставляет хост (сейчас — мажор `1`);
1079
+ * - `host` — semver-диапазон версий Synth, совместимых с расширением.
1080
+ *
1081
+ * Порядок проверок — как в пайплайне активации: сначала контракт, потом
1082
+ * host. Точные исключения (`exactHostExceptions`) — список версий Synth,
1083
+ * совместимых **вопреки** диапазону `host` (формат файла исключений —
1084
+ * открытый вопрос ADR-090; здесь — сам список).
1085
+ *
1086
+ * Вердикт — машиночитаемый: `{ ok, reason, expected, actual }`; загрузчик
1087
+ * `PluginHost` (Ф1) переиспользует функцию как есть.
1088
+ */
1089
+ export declare function checkExtensionCompatibility(input: {
1090
+ /** Объявленные контракты расширения (`contracts` манифеста). */
1091
+ contracts?: Record<string, string>;
1092
+ /** Диапазон версий Synth (`host` манифеста). */
1093
+ host?: string;
1094
+ /** Версия Synth (хоста). */
1095
+ hostVersion: string;
1096
+ /** Версия контракта Extension API, который предоставляет хост (напр. `1`). */
1097
+ contractVersion: string;
1098
+ /** Ключ контракта в `contracts` (по умолчанию — `extensionApi`). */
1099
+ contractName?: string;
1100
+ /** Точные исключения семвер-гейта (версии host в обход диапазона `host`). */
1101
+ exactHostExceptions?: readonly string[];
1102
+ }): ExtensionCompatibilityVerdict;