@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,349 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PROP-068 §3/§12: контракт индекса каталога расширений (`format: 1`).
|
|
3
|
+
*
|
|
4
|
+
* Индекс — **versioned JSON-документ**, который собирает CI каталога и который
|
|
5
|
+
* читают и портал-витрина, и инстанс Synth (загрузчик внешнего каталога
|
|
6
|
+
* скиллов, `core/src/engine/skills/remote.ts`). Формат индекса — из референса
|
|
7
|
+
* dshmarket (`format: 1`), поля карточки — из PROP-068 §12 (все классы
|
|
8
|
+
* расширений: `plugin`/`gateway`/`addon`/`pack`/`storage`).
|
|
9
|
+
*
|
|
10
|
+
* Источник истины по техническим полям расширения — манифест `synth.pack`
|
|
11
|
+
* (`types/pack.ts`): здесь переиспользуются `packNameSchema`,
|
|
12
|
+
* `packVersionSchema`, `packKindSchema`, `packTypeSchema` и общий инвариант
|
|
13
|
+
* `packType` (`refinePackType`): обязателен для `kind: 'pack'`, запрещён у
|
|
14
|
+
* остальных.
|
|
15
|
+
*
|
|
16
|
+
* Локализация: RU — канонический язык, EN — зеркало; обе строки обязательны
|
|
17
|
+
* в канонической форме (`description`, `title`, категории/метки).
|
|
18
|
+
*
|
|
19
|
+
* Ключевые поля канонической формы:
|
|
20
|
+
* - `metadata.sources[]` — перечень каталогов-адаптеров верхнего уровня
|
|
21
|
+
* (PROP-068 §3), **обязателен**; не путать с полем записи `source`;
|
|
22
|
+
* - `plugins[].path` — путь внутри каталога к вендоренному контенту
|
|
23
|
+
* (`kind: 'pack'`); legacy-формы кладут его и в `path`, и в `extra.path`.
|
|
24
|
+
*
|
|
25
|
+
* Модуль browser-safe (`zod` + локальные типы), в UI-бандл `node:*` не попадает.
|
|
26
|
+
*/
|
|
27
|
+
import { z } from 'zod';
|
|
28
|
+
/** Версия формата индекса каталога расширений. */
|
|
29
|
+
export declare const CATALOG_INDEX_FORMAT = 1;
|
|
30
|
+
/**
|
|
31
|
+
* Локализованный текст карточки: RU — канонический, EN — зеркало.
|
|
32
|
+
* Обе строки обязательны (в канонической форме).
|
|
33
|
+
*/
|
|
34
|
+
export declare const catalogLocalizedTextSchema: z.ZodObject<{
|
|
35
|
+
ru: z.ZodString;
|
|
36
|
+
en: z.ZodString;
|
|
37
|
+
}, z.core.$strip>;
|
|
38
|
+
export type CatalogLocalizedText = z.infer<typeof catalogLocalizedTextSchema>;
|
|
39
|
+
/**
|
|
40
|
+
* Уровни доверия записи (PROP-068 §4.1). Для каталога расширений
|
|
41
|
+
* `agent-created` не используется — записи каталога публикуются из репозиториев.
|
|
42
|
+
*
|
|
43
|
+
* Перечень живёт в `types/trust.ts` — он общий с манифестом `synth.pack`
|
|
44
|
+
* (`types/pack.ts`), который импортирует схемы каталога (цикл импортов
|
|
45
|
+
* `catalog → pack` не даёт импортировать каталог из `pack`).
|
|
46
|
+
*/
|
|
47
|
+
export { CATALOG_TRUST_LEVELS, catalogTrustLevelSchema, trustLevelRank, type CatalogTrustLevel, } from './trust.js';
|
|
48
|
+
/**
|
|
49
|
+
* Источник/адаптер происхождения записи (PROP-068 §3.1).
|
|
50
|
+
*
|
|
51
|
+
* Это **канал доставки конкретной записи** (`versions[].source.type = 'npm'`),
|
|
52
|
+
* а не перечень каталогов верхнего уровня — см. `catalogSourceAdapterSchema`.
|
|
53
|
+
*/
|
|
54
|
+
export declare const CATALOG_SOURCES: readonly ["npm", "github", "helm", "builtin", "registry"];
|
|
55
|
+
export type CatalogSource = (typeof CATALOG_SOURCES)[number];
|
|
56
|
+
export declare const catalogSourceSchema: z.ZodEnum<{
|
|
57
|
+
builtin: "builtin";
|
|
58
|
+
npm: "npm";
|
|
59
|
+
github: "github";
|
|
60
|
+
helm: "helm";
|
|
61
|
+
registry: "registry";
|
|
62
|
+
}>;
|
|
63
|
+
/**
|
|
64
|
+
* Каталог-адаптер верхнего уровня (`metadata.sources[]`, PROP-068 §3) —
|
|
65
|
+
* список каталогов, чьи записи попали в индекс, с их дефолтами доверия и
|
|
66
|
+
* включения.
|
|
67
|
+
*
|
|
68
|
+
* ⚠️ **Не путать с полем записи `source`** (`CatalogSource` =
|
|
69
|
+
* `npm|github|helm|builtin|registry`): `source` у записи — *канал доставки этой
|
|
70
|
+
* записи* (`versions[].source.type`), а `metadata.sources[]` — *каталоги-адаптеры*,
|
|
71
|
+
* из которых индекс собра (репозиторий/подкаталог + уровень доверия +
|
|
72
|
+
* «включён по умолчанию»).
|
|
73
|
+
*/
|
|
74
|
+
export declare const catalogSourceAdapterSchema: z.ZodObject<{
|
|
75
|
+
id: z.ZodString;
|
|
76
|
+
label: z.ZodString;
|
|
77
|
+
trust_level: z.ZodEnum<{
|
|
78
|
+
builtin: "builtin";
|
|
79
|
+
verified: "verified";
|
|
80
|
+
trusted: "trusted";
|
|
81
|
+
community: "community";
|
|
82
|
+
}>;
|
|
83
|
+
enabled_by_default: z.ZodOptional<z.ZodBoolean>;
|
|
84
|
+
repo: z.ZodOptional<z.ZodString>;
|
|
85
|
+
subpath: z.ZodOptional<z.ZodString>;
|
|
86
|
+
}, z.core.$strip>;
|
|
87
|
+
export type CatalogSourceAdapter = z.infer<typeof catalogSourceAdapterSchema>;
|
|
88
|
+
export declare const catalogTimestampSchema: z.ZodString;
|
|
89
|
+
/**
|
|
90
|
+
* Версия записи каталога в истории релизов: версия, момент публикации
|
|
91
|
+
* (unix-время, мс), источник и требования к окружению (`engines`).
|
|
92
|
+
*/
|
|
93
|
+
export declare const catalogVersionSchema: z.ZodObject<{
|
|
94
|
+
version: z.ZodString;
|
|
95
|
+
publishTimestamp: z.ZodOptional<z.ZodNumber>;
|
|
96
|
+
source: z.ZodEnum<{
|
|
97
|
+
builtin: "builtin";
|
|
98
|
+
npm: "npm";
|
|
99
|
+
github: "github";
|
|
100
|
+
helm: "helm";
|
|
101
|
+
registry: "registry";
|
|
102
|
+
}>;
|
|
103
|
+
engines: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
104
|
+
}, z.core.$strip>;
|
|
105
|
+
export type CatalogVersion = z.infer<typeof catalogVersionSchema>;
|
|
106
|
+
/**
|
|
107
|
+
* Карточка записи каталога расширений (PROP-068 §12).
|
|
108
|
+
*
|
|
109
|
+
* Инварианты, зашитые в схему:
|
|
110
|
+
* - `kind: 'pack'` **требует** `packType`; у остальных `kind` `packType`
|
|
111
|
+
* запрещён (тот же инвариант, что в манифесте `synth.pack`);
|
|
112
|
+
* - `license` обязателен (SPDX-идентификатор) — для сторонних записей;
|
|
113
|
+
* - `description` локализован (RU + EN).
|
|
114
|
+
*/
|
|
115
|
+
export declare const catalogEntrySchema: z.ZodObject<{
|
|
116
|
+
name: z.ZodString;
|
|
117
|
+
kind: z.ZodEnum<{
|
|
118
|
+
storage: "storage";
|
|
119
|
+
pack: "pack";
|
|
120
|
+
plugin: "plugin";
|
|
121
|
+
gateway: "gateway";
|
|
122
|
+
addon: "addon";
|
|
123
|
+
}>;
|
|
124
|
+
packType: z.ZodOptional<z.ZodEnum<{
|
|
125
|
+
mcp: "mcp";
|
|
126
|
+
agents: "agents";
|
|
127
|
+
memory: "memory";
|
|
128
|
+
skills: "skills";
|
|
129
|
+
providers: "providers";
|
|
130
|
+
ui: "ui";
|
|
131
|
+
i18n: "i18n";
|
|
132
|
+
themes: "themes";
|
|
133
|
+
prompts: "prompts";
|
|
134
|
+
automation: "automation";
|
|
135
|
+
policies: "policies";
|
|
136
|
+
}>>;
|
|
137
|
+
version: z.ZodString;
|
|
138
|
+
description: z.ZodObject<{
|
|
139
|
+
ru: z.ZodString;
|
|
140
|
+
en: z.ZodString;
|
|
141
|
+
}, z.core.$strip>;
|
|
142
|
+
repository: z.ZodOptional<z.ZodObject<{
|
|
143
|
+
url: z.ZodString;
|
|
144
|
+
}, z.core.$strip>>;
|
|
145
|
+
homepage: z.ZodOptional<z.ZodString>;
|
|
146
|
+
license: z.ZodString;
|
|
147
|
+
icon: z.ZodOptional<z.ZodString>;
|
|
148
|
+
screenshots: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
149
|
+
tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
150
|
+
category: z.ZodString;
|
|
151
|
+
trust_level: z.ZodEnum<{
|
|
152
|
+
builtin: "builtin";
|
|
153
|
+
verified: "verified";
|
|
154
|
+
trusted: "trusted";
|
|
155
|
+
community: "community";
|
|
156
|
+
}>;
|
|
157
|
+
identifier: z.ZodString;
|
|
158
|
+
path: z.ZodOptional<z.ZodString>;
|
|
159
|
+
minSynth: z.ZodOptional<z.ZodString>;
|
|
160
|
+
source: z.ZodEnum<{
|
|
161
|
+
builtin: "builtin";
|
|
162
|
+
npm: "npm";
|
|
163
|
+
github: "github";
|
|
164
|
+
helm: "helm";
|
|
165
|
+
registry: "registry";
|
|
166
|
+
}>;
|
|
167
|
+
versions: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
168
|
+
version: z.ZodString;
|
|
169
|
+
publishTimestamp: z.ZodOptional<z.ZodNumber>;
|
|
170
|
+
source: z.ZodEnum<{
|
|
171
|
+
builtin: "builtin";
|
|
172
|
+
npm: "npm";
|
|
173
|
+
github: "github";
|
|
174
|
+
helm: "helm";
|
|
175
|
+
registry: "registry";
|
|
176
|
+
}>;
|
|
177
|
+
engines: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
178
|
+
}, z.core.$strip>>>;
|
|
179
|
+
extra: z.ZodPrefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
180
|
+
}, z.core.$strip>;
|
|
181
|
+
export type CatalogEntry = z.infer<typeof catalogEntrySchema>;
|
|
182
|
+
/** Категория витрины: локализованный заголовок и порядок вывода. */
|
|
183
|
+
export declare const catalogCategorySchema: z.ZodObject<{
|
|
184
|
+
title: z.ZodObject<{
|
|
185
|
+
ru: z.ZodString;
|
|
186
|
+
en: z.ZodString;
|
|
187
|
+
}, z.core.$strip>;
|
|
188
|
+
order: z.ZodOptional<z.ZodNumber>;
|
|
189
|
+
}, z.core.$strip>;
|
|
190
|
+
export type CatalogCategory = z.infer<typeof catalogCategorySchema>;
|
|
191
|
+
/** Метка каталога (`metadata.labels`) — локализованный заголовок. */
|
|
192
|
+
export declare const catalogLabelSchema: z.ZodObject<{
|
|
193
|
+
title: z.ZodObject<{
|
|
194
|
+
ru: z.ZodString;
|
|
195
|
+
en: z.ZodString;
|
|
196
|
+
}, z.core.$strip>;
|
|
197
|
+
}, z.core.$strip>;
|
|
198
|
+
export type CatalogLabel = z.infer<typeof catalogLabelSchema>;
|
|
199
|
+
/**
|
|
200
|
+
* Канонический документ индекса каталога расширений (`format: 1`).
|
|
201
|
+
*
|
|
202
|
+
* - `title`/`description` — локализованные (RU канонический, EN зеркало);
|
|
203
|
+
* - `generated_at` — момент сборки индекса (ISO-8601), база freshness-watchdog;
|
|
204
|
+
* - `metadata.categories` — категории витрины, `metadata.labels` — метки;
|
|
205
|
+
* - `metadata.sources` — **обязательный** перечень каталогов-адаптеров, чьи
|
|
206
|
+
* записи попали в индекс (PROP-068 §3): без него документ не является
|
|
207
|
+
* полноценным индексом (fail-closed к §3);
|
|
208
|
+
* - `plugins` — записи каталога (все классы расширений).
|
|
209
|
+
*/
|
|
210
|
+
export declare const catalogIndexSchema: z.ZodObject<{
|
|
211
|
+
format: z.ZodLiteral<1>;
|
|
212
|
+
title: z.ZodObject<{
|
|
213
|
+
ru: z.ZodString;
|
|
214
|
+
en: z.ZodString;
|
|
215
|
+
}, z.core.$strip>;
|
|
216
|
+
description: z.ZodObject<{
|
|
217
|
+
ru: z.ZodString;
|
|
218
|
+
en: z.ZodString;
|
|
219
|
+
}, z.core.$strip>;
|
|
220
|
+
generated_at: z.ZodString;
|
|
221
|
+
metadata: z.ZodObject<{
|
|
222
|
+
categories: z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
223
|
+
title: z.ZodObject<{
|
|
224
|
+
ru: z.ZodString;
|
|
225
|
+
en: z.ZodString;
|
|
226
|
+
}, z.core.$strip>;
|
|
227
|
+
order: z.ZodOptional<z.ZodNumber>;
|
|
228
|
+
}, z.core.$strip>>;
|
|
229
|
+
labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
230
|
+
title: z.ZodObject<{
|
|
231
|
+
ru: z.ZodString;
|
|
232
|
+
en: z.ZodString;
|
|
233
|
+
}, z.core.$strip>;
|
|
234
|
+
}, z.core.$strip>>>;
|
|
235
|
+
sources: z.ZodArray<z.ZodObject<{
|
|
236
|
+
id: z.ZodString;
|
|
237
|
+
label: z.ZodString;
|
|
238
|
+
trust_level: z.ZodEnum<{
|
|
239
|
+
builtin: "builtin";
|
|
240
|
+
verified: "verified";
|
|
241
|
+
trusted: "trusted";
|
|
242
|
+
community: "community";
|
|
243
|
+
}>;
|
|
244
|
+
enabled_by_default: z.ZodOptional<z.ZodBoolean>;
|
|
245
|
+
repo: z.ZodOptional<z.ZodString>;
|
|
246
|
+
subpath: z.ZodOptional<z.ZodString>;
|
|
247
|
+
}, z.core.$strip>>;
|
|
248
|
+
}, z.core.$strip>;
|
|
249
|
+
plugins: z.ZodArray<z.ZodObject<{
|
|
250
|
+
name: z.ZodString;
|
|
251
|
+
kind: z.ZodEnum<{
|
|
252
|
+
storage: "storage";
|
|
253
|
+
pack: "pack";
|
|
254
|
+
plugin: "plugin";
|
|
255
|
+
gateway: "gateway";
|
|
256
|
+
addon: "addon";
|
|
257
|
+
}>;
|
|
258
|
+
packType: z.ZodOptional<z.ZodEnum<{
|
|
259
|
+
mcp: "mcp";
|
|
260
|
+
agents: "agents";
|
|
261
|
+
memory: "memory";
|
|
262
|
+
skills: "skills";
|
|
263
|
+
providers: "providers";
|
|
264
|
+
ui: "ui";
|
|
265
|
+
i18n: "i18n";
|
|
266
|
+
themes: "themes";
|
|
267
|
+
prompts: "prompts";
|
|
268
|
+
automation: "automation";
|
|
269
|
+
policies: "policies";
|
|
270
|
+
}>>;
|
|
271
|
+
version: z.ZodString;
|
|
272
|
+
description: z.ZodObject<{
|
|
273
|
+
ru: z.ZodString;
|
|
274
|
+
en: z.ZodString;
|
|
275
|
+
}, z.core.$strip>;
|
|
276
|
+
repository: z.ZodOptional<z.ZodObject<{
|
|
277
|
+
url: z.ZodString;
|
|
278
|
+
}, z.core.$strip>>;
|
|
279
|
+
homepage: z.ZodOptional<z.ZodString>;
|
|
280
|
+
license: z.ZodString;
|
|
281
|
+
icon: z.ZodOptional<z.ZodString>;
|
|
282
|
+
screenshots: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
283
|
+
tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
284
|
+
category: z.ZodString;
|
|
285
|
+
trust_level: z.ZodEnum<{
|
|
286
|
+
builtin: "builtin";
|
|
287
|
+
verified: "verified";
|
|
288
|
+
trusted: "trusted";
|
|
289
|
+
community: "community";
|
|
290
|
+
}>;
|
|
291
|
+
identifier: z.ZodString;
|
|
292
|
+
path: z.ZodOptional<z.ZodString>;
|
|
293
|
+
minSynth: z.ZodOptional<z.ZodString>;
|
|
294
|
+
source: z.ZodEnum<{
|
|
295
|
+
builtin: "builtin";
|
|
296
|
+
npm: "npm";
|
|
297
|
+
github: "github";
|
|
298
|
+
helm: "helm";
|
|
299
|
+
registry: "registry";
|
|
300
|
+
}>;
|
|
301
|
+
versions: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
302
|
+
version: z.ZodString;
|
|
303
|
+
publishTimestamp: z.ZodOptional<z.ZodNumber>;
|
|
304
|
+
source: z.ZodEnum<{
|
|
305
|
+
builtin: "builtin";
|
|
306
|
+
npm: "npm";
|
|
307
|
+
github: "github";
|
|
308
|
+
helm: "helm";
|
|
309
|
+
registry: "registry";
|
|
310
|
+
}>;
|
|
311
|
+
engines: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
312
|
+
}, z.core.$strip>>>;
|
|
313
|
+
extra: z.ZodPrefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
314
|
+
}, z.core.$strip>>;
|
|
315
|
+
}, z.core.$strip>;
|
|
316
|
+
export type CatalogIndex = z.infer<typeof catalogIndexSchema>;
|
|
317
|
+
/** Плейсхолдер лицензии для записей, у которых источник её не указал. */
|
|
318
|
+
export declare const CATALOG_UNKNOWN_LICENSE = "UNKNOWN";
|
|
319
|
+
/** Категория по умолчанию для записей-скиллов без категории. */
|
|
320
|
+
export declare const CATALOG_DEFAULT_SKILL_CATEGORY = "skills";
|
|
321
|
+
/** Версия по умолчанию для записей, у которых источник её не указал. */
|
|
322
|
+
export declare const CATALOG_UNKNOWN_VERSION = "0.0.0";
|
|
323
|
+
/** Запись каталога — скилл? (`kind: 'pack'` + `packType: 'skills'`). */
|
|
324
|
+
export declare function isCatalogSkillEntry(entry: CatalogEntry): boolean;
|
|
325
|
+
/**
|
|
326
|
+
* Похож ли корень на документ каталога? (`format: 1`, legacy `{ skills: [...] }`
|
|
327
|
+
* или голый массив записей).
|
|
328
|
+
*
|
|
329
|
+
* Нужен потребителю, чтобы отличить «пустой каталог» от «по ссылке лежит не
|
|
330
|
+
* каталог» (HTML/мусор) — без дублирования знания о формате.
|
|
331
|
+
*/
|
|
332
|
+
export declare function isCatalogIndexDocument(raw: unknown): boolean;
|
|
333
|
+
/**
|
|
334
|
+
* Tolerant-парсер индекса каталога: три формы → `CatalogEntry[]`.
|
|
335
|
+
*
|
|
336
|
+
* 1. Каноническая: `{ format: 1, plugins: [...] }` — записи валидируются
|
|
337
|
+
* строгим контрактом `catalogEntrySchema`, невалидные пропускаются молча;
|
|
338
|
+
* 2. `{ skills: [...] }` — записи скиллов;
|
|
339
|
+
* 3. Голый массив `[{ name, path? }]` — legacy-формат внешнего каталога скиллов
|
|
340
|
+
* (ADR-046 §4.3).
|
|
341
|
+
*
|
|
342
|
+
* Формы 2 и 3 — это **скиллы**: `kind: 'pack'`, `packType: 'skills'`,
|
|
343
|
+
* `trust_level: 'community'`, `source: 'registry'`, `identifier` = `path`
|
|
344
|
+
* (или `name`).
|
|
345
|
+
*
|
|
346
|
+
* Парсер **не бросает исключений** и не сигналит: битые записи пропускаются,
|
|
347
|
+
* неизвестный формат документа → пустой список.
|
|
348
|
+
*/
|
|
349
|
+
export declare function parseCatalogEntries(raw: unknown): CatalogEntry[];
|