cvc-catalog-sync-plugin 1.0.0 → 2.0.0

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.
@@ -0,0 +1,308 @@
1
+ /**
2
+ * Коэффициенты моделей CheapVibeCode: бейджи `×0.1…×10` в выборе модели.
3
+ *
4
+ * Своего запроса к апстриму модуль не делает: каталог берётся из ОБЩЕГО кэша
5
+ * `deps.cache` (`lib/cache.js`), который наполняется одним `GET /v1/models` для
6
+ * трёх функций. Здесь остаются только чистые преобразования каталога и защита
7
+ * маршрута от лишних чтений.
8
+ *
9
+ * Почему защита вообще нужна, если кэш и сам сливает одновременные запросы:
10
+ * у маршрута может быть несколько читателей сразу (несколько вкладок браузера,
11
+ * открытая панель), и каждый лишний `cache.get()` — это лишняя работа на
12
+ * хосте. Поэтому модуль сам держит одно чтение на монтирование функции, а
13
+ * поздний ответ (функцию уже выключили и включили заново) он не превращает в
14
+ * ответ: поколение чтения сменилось.
15
+ *
16
+ * Ключ и сеть сюда не попадают: `cache.get()` уже получил каталог, а ошибки
17
+ * апстрима приходят кодом (`CvcApiError.code`), не текстом с секретом.
18
+ *
19
+ * @module cvc-catalog-sync-plugin/lib/coefficients
20
+ */
21
+
22
+ /** Путь маршрута в общей таблице каркаса. */
23
+ export const ROUTE_PATH = 'coefficients'
24
+
25
+ /**
26
+ * Нормализовать идентификатор модели для сравнения и дедупликации.
27
+ *
28
+ * Каталог CheapVibeCode и каталог адаптера DSH пишут одну модель по-разному:
29
+ * `deepseek-v4.1-flash` и `deepseek-v4-1-flash`. Точки и подчёркивания
30
+ * сводятся к дефису, регистр не учитывается.
31
+ *
32
+ * @param {unknown} value — сырой идентификатор.
33
+ * @returns {string} ключ сравнения или пустая строка.
34
+ */
35
+ export function normalizeModelId(value) {
36
+ return String(value ?? '')
37
+ .trim()
38
+ .toLowerCase()
39
+ .replace(/[._]+/g, '-')
40
+ .replace(/-+/g, '-')
41
+ }
42
+
43
+ /**
44
+ * Разобрать числовой коэффициент.
45
+ *
46
+ * Ноль — законное значение (бесплатная модель), отрицательное и NaN — нет.
47
+ * Строка принимается, потому что часть прокси отдаёт числа текстом.
48
+ *
49
+ * @param {unknown} value
50
+ * @returns {number | null} число или `null`, если значение не читается.
51
+ */
52
+ export function parseMultiplier(value) {
53
+ if (typeof value === 'string' && value.trim() !== '') {
54
+ const parsed = Number(value)
55
+ return Number.isFinite(parsed) && parsed >= 0 ? parsed : null
56
+ }
57
+ if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) return null
58
+ return value
59
+ }
60
+
61
+ /**
62
+ * Размер контекста из строки каталога.
63
+ *
64
+ * @param {unknown} value — `context_window` сырой строки.
65
+ * @returns {number | null} целое положительное число или `null`.
66
+ */
67
+ export function parseContextWindow(value) {
68
+ return Number.isFinite(value) && value > 0 ? Math.trunc(/** @type {number} */ (value)) : null
69
+ }
70
+
71
+ /**
72
+ * Отображаемое имя модели: `display_name` каталога, иначе сам id.
73
+ *
74
+ * @param {string} id — идентификатор модели.
75
+ * @param {unknown} value — `display_name` сырой строки.
76
+ * @returns {string}
77
+ */
78
+ export function displayNameOf(id, value) {
79
+ if (typeof value === 'string' && value.trim().length > 0) return value.trim()
80
+ return id
81
+ }
82
+
83
+ /**
84
+ * Индекс каталога: `нормализованный id → множители и контекст`.
85
+ *
86
+ * Принимает и весь снимок кэша (`{models: [...]}`), и голый массив строк.
87
+ * Строка без читаемого `multiplier` не индексируется: бейдж без множителя
88
+ * означал бы выдуманную цену. При двух записях с одним ключом остаётся первая:
89
+ * порядок каталога провайдера и есть порядок, в котором он их объявил.
90
+ *
91
+ * @param {unknown} catalog — снимок каталога или список строк.
92
+ * @returns {Map<string, { id: string, displayName: string, multiplier: number, fastMultiplier: number | null, contextWindow: number | null }>}
93
+ */
94
+ export function indexCoefficients(catalog) {
95
+ const source = Array.isArray(catalog)
96
+ ? catalog
97
+ : catalog !== null && typeof catalog === 'object' && Array.isArray(/** @type {any} */ (catalog).models)
98
+ ? /** @type {any} */ (catalog).models
99
+ : []
100
+
101
+ const index = new Map()
102
+ for (const row of source) {
103
+ if (row === null || typeof row !== 'object') continue
104
+ const id = typeof row.id === 'string' ? row.id.trim() : ''
105
+ const multiplier = parseMultiplier(row.multiplier)
106
+ if (id.length === 0 || multiplier === null) continue
107
+ const key = normalizeModelId(id)
108
+ if (key.length === 0 || index.has(key)) continue
109
+ index.set(key, {
110
+ id,
111
+ displayName: displayNameOf(id, row.display_name),
112
+ multiplier,
113
+ fastMultiplier: parseMultiplier(row.fast_multiplier),
114
+ contextWindow: parseContextWindow(row.context_window),
115
+ })
116
+ }
117
+ return index
118
+ }
119
+
120
+ /**
121
+ * Найти коэффициент модели по идентификатору.
122
+ *
123
+ * Порядок поиска: точный ключ, затем ключ без префикса провайдера
124
+ * (`openai/gpt-6-sol`), затем единственный ключ каталога, который заканчивается
125
+ * на id модели. Последний шаг нужен, когда адаптер DSH отрезает вендора, а
126
+ * каталог CheapVibeCode его оставляет. Если таких хвостов несколько — это уже
127
+ * неоднозначность, и коэффициент не показывается.
128
+ *
129
+ * @param {ReturnType<typeof indexCoefficients>} index — индекс каталога.
130
+ * @param {unknown} modelId — идентификатор модели в селекторе.
131
+ * @returns {{ id: string, multiplier: number, fastMultiplier: number | null, contextWindow: number | null } | null}
132
+ */
133
+ export function lookupCoefficient(index, modelId) {
134
+ const key = normalizeModelId(modelId)
135
+ if (key.length === 0) return null
136
+
137
+ const direct = index.get(key)
138
+ if (direct !== undefined) return direct
139
+
140
+ const slash = key.lastIndexOf('/')
141
+ if (slash >= 0) {
142
+ const tail = index.get(key.slice(slash + 1))
143
+ if (tail !== undefined) return tail
144
+ }
145
+
146
+ // Хвост после дефиса берём только когда он сам похож на id модели.
147
+ // Иначе «pro» совпадёт и с mimo-v2.6-pro, и с gemini-3.1-pro, и с десятком
148
+ // других, а единственный короткий ключ получит чужой коэффициент.
149
+ if (key.length < 6 || !key.includes('-')) return null
150
+
151
+ const suffix = []
152
+ for (const [candidate, value] of index) {
153
+ if (candidate.endsWith(`-${key}`) || candidate.endsWith(`/${key}`)) suffix.push(value)
154
+ }
155
+ return suffix.length === 1 ? suffix[0] : null
156
+ }
157
+
158
+ /**
159
+ * Текст бейджа: значимые знаки без хвостовых нулей.
160
+ *
161
+ * `0.1` остаётся `×0.1`, `1` становится `×1`, `2.50` — `×2.5`. В браузере
162
+ * правило продублировано (`src/client/coefficients.js`): собранный клиент не
163
+ * может импортировать хост-модуль, и дублирование здесь дешевле сборки.
164
+ *
165
+ * @param {number} multiplier
166
+ * @returns {string} подпись бейджа или пустая строка для нечисла.
167
+ */
168
+ export function formatMultiplier(multiplier) {
169
+ if (!Number.isFinite(multiplier)) return ''
170
+ return `×${String(Number(multiplier.toFixed(4)))}`
171
+ }
172
+
173
+ /**
174
+ * Ответ маршрута из снимка кэша.
175
+ *
176
+ * `fetchedAt` — время каталога, а не ответа маршрута: бейджи показывают тот
177
+ * каталог, который действительно прочитан. `stale` говорит, что кэш отдал
178
+ * прошлый удачный снимок после ошибки апстрима.
179
+ *
180
+ * @param {unknown} catalog — данные из `cache.get().data`.
181
+ * @param {{ fetchedAt?: number | null, stale?: boolean }} [meta] — метаданные кэша.
182
+ * @returns {{ models: Array<{ id: string, displayName: string, multiplier: number, fastMultiplier: number | null, contextWindow: number | null }>, providers: string[], fetchedAt: string | null, stale: boolean }}
183
+ */
184
+ export function coefficientsPayload(catalog, meta = {}) {
185
+ const index = indexCoefficients(catalog)
186
+ const models = [...index.values()].map((model) => ({
187
+ id: model.id,
188
+ displayName: displayNameOf(model.id, /** @type {any} */ (model).displayName),
189
+ multiplier: model.multiplier,
190
+ fastMultiplier: model.fastMultiplier,
191
+ contextWindow: model.contextWindow,
192
+ }))
193
+
194
+ // id провайдеров, которым принадлежит кэшированный каталог: браузер не должен
195
+ // украшать бейджем модель чужого провайдера с тем же id.
196
+ const rawProviders = catalog !== null && typeof catalog === 'object' && Array.isArray(/** @type {any} */ (catalog).providers)
197
+ ? /** @type {any} */ (catalog).providers
198
+ : []
199
+ const providers = []
200
+ for (const entry of rawProviders) {
201
+ const id = typeof entry === 'string' ? entry : typeof entry?.provider === 'string' ? entry.provider : ''
202
+ if (id.length > 0 && !providers.includes(id)) providers.push(id)
203
+ }
204
+
205
+ const fetchedAt = typeof meta.fetchedAt === 'number' && meta.fetchedAt > 0
206
+ ? new Date(meta.fetchedAt).toISOString()
207
+ : null
208
+
209
+ return { models, providers, fetchedAt, stale: meta.stale === true }
210
+ }
211
+
212
+ /**
213
+ * Одно чтение общего кэша на все одновременные запросы.
214
+ *
215
+ * Заодно это защита от позднего ответа: `dispose()` поднимает поколение, и
216
+ * чтение, начатое до выключения функции, уже не станет ответом. Сам кэш тоже
217
+ * сливает одновременные запросы, но здесь важно не открывать второе чтение
218
+ * вовсе — у маршрута бывает несколько одновременных читателей.
219
+ *
220
+ * @param {{ get: (options?: { force?: boolean }) => Promise<any> }} cache — общий кэш каталога.
221
+ * @returns {{ read: () => Promise<any | null>, dispose: () => void }}
222
+ */
223
+ export function createCoefficientsReader(cache) {
224
+ /** @type {Promise<any> | null} */
225
+ let inflight = null
226
+ let generation = 0
227
+
228
+ return {
229
+ read() {
230
+ if (inflight !== null) return inflight
231
+ const startedGeneration = generation
232
+ const run = (async () => {
233
+ try {
234
+ const result = await cache.get()
235
+ // Поздний ответ: функцию успели выключить или перемонтировать.
236
+ if (startedGeneration !== generation) return null
237
+ return result
238
+ } finally {
239
+ if (inflight === run) inflight = null
240
+ }
241
+ })()
242
+ inflight = run
243
+ return run
244
+ },
245
+ dispose() {
246
+ generation += 1
247
+ inflight = null
248
+ },
249
+ }
250
+ }
251
+
252
+ /**
253
+ * Подключить функцию коэффициентов: `GET /cvc/coefficients`.
254
+ *
255
+ * Маршрут отдаёт форму §4 спеки. Ошибка апстрима не превращается в 500:
256
+ * бейджи просто не рисуются, а причина уходит в лог кодом (`CvcApiError.code`),
257
+ * потому что текст ошибки апстрима может содержать что угодно.
258
+ *
259
+ * @param {import('@deepseek-ai/cordis').Context} ctx — контекст плагина.
260
+ * @param {object} deps — общие зависимости каркаса (см. `lib/CONTRACT.js`).
261
+ * @returns {() => void} disposer, снимающий маршрут и ожидающие чтения.
262
+ */
263
+ export function register(ctx, deps) {
264
+ const reader = createCoefficientsReader(deps.cache)
265
+ const disposeRoute = deps.route(ROUTE_PATH, async (req, res) => {
266
+ if (String(req.method ?? 'GET').toUpperCase() !== 'GET') {
267
+ deps.http.methodNotAllowed(res, ['GET'])
268
+ return
269
+ }
270
+
271
+ let result = null
272
+ let failedCode = ''
273
+ try {
274
+ result = await reader.read()
275
+ } catch (error) {
276
+ failedCode = typeof /** @type {any} */ (error)?.code === 'string' ? error.code : 'unavailable'
277
+ }
278
+ if (failedCode.length > 0) {
279
+ deps.log('warn', `coefficients: catalog read failed (${failedCode})`)
280
+ }
281
+
282
+ if (result === null) {
283
+ // Снимка ещё нет (или чтение отменено выключением функции): пустой каталог
284
+ // — честный ответ, бейджей не будет, но маршрут не врёт про 200.
285
+ deps.http.sendJson(res, 200, { models: [], providers: [], fetchedAt: null, stale: false })
286
+ return
287
+ }
288
+ deps.http.sendJson(res, 200, coefficientsPayload(result.data, {
289
+ fetchedAt: result.fetchedAt,
290
+ stale: result.stale === true,
291
+ }))
292
+ })
293
+
294
+ return () => {
295
+ reader.dispose()
296
+ disposeRoute()
297
+ }
298
+ }
299
+
300
+ /**
301
+ * Описание инструмента функции; у коэффициентов инструмента нет.
302
+ * @param {object} deps
303
+ * @returns {object | null}
304
+ */
305
+ export function tool(deps) {
306
+ void deps
307
+ return null
308
+ }