@kenz1117/dsh-engram 0.9.4 → 0.9.6

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/lib/index.js CHANGED
@@ -51,186 +51,6 @@ function resolveLanguage(setting) {
51
51
  return setting === "auto" ? systemLanguage() : setting;
52
52
  }
53
53
  //#endregion
54
- //#region src/config.ts
55
- /**
56
- * 插件 Config:所有部署可变项集中于此,禁止在实现里内嵌默认值。
57
- * @module @kenz1117/dsh-engram/config
58
- */
59
- /** 合法配置键集合(未知键 loud 失败)。 */
60
- const CONFIG_KEYS = /* @__PURE__ */ new Set([
61
- "legacyMigration",
62
- "dbDir",
63
- "injectProfile",
64
- "profileTopN",
65
- "modelCacheDir",
66
- "hfEndpoint",
67
- "ingest",
68
- "reflect",
69
- "provider",
70
- "model",
71
- "decayAfterDays",
72
- "decayImportanceBelow",
73
- "injectTokenBudget",
74
- "injectItemBudgetStart",
75
- "injectItemBudgetDecay",
76
- "injectItemBudgetFloor",
77
- "rankRecencyWeight",
78
- "rankProofWeight",
79
- "queryRewrite",
80
- "autoSlot",
81
- "reviewScheduling",
82
- "assessReminder",
83
- "historyBackfillDays",
84
- "historyBackfillMaxTurnsPerSession",
85
- "historyBackfillMaxTotalTurns",
86
- "historyBackfillIncludeSubagents",
87
- "historyBackfillIncludeSeeded",
88
- "historyBackfillIncludeNoCwd",
89
- "jev",
90
- "language",
91
- "redactWords"
92
- ]);
93
- const INGEST_MODES = /* @__PURE__ */ new Set([
94
- "off",
95
- "light",
96
- "eager"
97
- ]);
98
- const REFLECT_MODES = /* @__PURE__ */ new Set([
99
- "off",
100
- "suggest",
101
- "auto"
102
- ]);
103
- /** Schemastery 校验面(cordis.yml 读取时校验)。 */
104
- const Config = z.object({
105
- dbDir: z.string(),
106
- legacyMigration: z.string(),
107
- injectProfile: z.boolean(),
108
- profileTopN: z.number().step(1).min(1).max(64),
109
- modelCacheDir: z.string(),
110
- hfEndpoint: z.string(),
111
- ingest: z.string(),
112
- reflect: z.string(),
113
- provider: z.string(),
114
- model: z.string(),
115
- decayAfterDays: z.number().step(1).min(1).max(3650),
116
- decayImportanceBelow: z.number().min(0).max(1),
117
- injectTokenBudget: z.number().step(1).min(128).max(8192),
118
- injectItemBudgetStart: z.number().step(1).min(40).max(2e3),
119
- injectItemBudgetDecay: z.number().min(.5).max(1),
120
- injectItemBudgetFloor: z.number().step(1).min(8).max(200),
121
- rankRecencyWeight: z.number().min(0).max(2),
122
- rankProofWeight: z.number().min(0).max(2),
123
- queryRewrite: z.boolean(),
124
- autoSlot: z.boolean(),
125
- reviewScheduling: z.boolean(),
126
- assessReminder: z.boolean(),
127
- historyBackfillDays: z.number().step(1).min(0).max(3650),
128
- historyBackfillMaxTurnsPerSession: z.number().step(1).min(1).max(500),
129
- historyBackfillMaxTotalTurns: z.number().step(1).min(1).max(5e3),
130
- historyBackfillIncludeSubagents: z.boolean(),
131
- historyBackfillIncludeSeeded: z.boolean(),
132
- historyBackfillIncludeNoCwd: z.boolean(),
133
- jev: z.object({
134
- enabled: z.boolean(),
135
- apiKey: z.string(),
136
- baseUrl: z.string(),
137
- model: z.string(),
138
- timeoutMs: z.number().step(1).min(1e3).max(6e4),
139
- deferMergeAbove: z.number().min(.5).max(1),
140
- deferAcceptBelow: z.number().min(0).max(.5),
141
- contradictMinProbability: z.number().min(.5).max(1)
142
- }),
143
- language: z.string(),
144
- redactWords: z.array(z.string())
145
- });
146
- /**
147
- * 显式 resolve 步骤:默认值只在唯一的此处落地,非法值 loud 失败。
148
- * @param config - cordis.yml 传入的未校验配置。
149
- * @returns 完整解析配置。
150
- * @throws 未知键、ingest 档位非法、provider/model 只给其一、decay/预算/排序权重/历史回填规则越界时抛错。
151
- */
152
- function resolveConfig(config = {}) {
153
- for (const key of Object.keys(config)) if (!CONFIG_KEYS.has(key)) throw new Error(`dsh-engram: unknown config key "${key}"`);
154
- if (config.legacyMigration !== void 0 && config.legacyMigration !== "eager" && config.legacyMigration !== "conservative") throw new Error("dsh-engram: legacyMigration must be one of eager|conservative");
155
- if (config.ingest !== void 0 && !INGEST_MODES.has(config.ingest)) throw new Error(`dsh-engram: ingest must be one of off|light|eager, got "${String(config.ingest)}"`);
156
- if (config.reflect !== void 0 && !REFLECT_MODES.has(config.reflect)) throw new Error(`dsh-engram: reflect must be one of off|suggest|auto, got "${String(config.reflect)}"`);
157
- if (config.language !== void 0 && config.language !== "auto" && !isEngramLanguage(config.language)) throw new Error(`dsh-engram: language must be one of auto|zh|en|ru, got "${String(config.language)}"`);
158
- if (config.profileTopN !== void 0 && (!Number.isInteger(config.profileTopN) || config.profileTopN < 1 || config.profileTopN > 64)) throw new Error("dsh-engram: profileTopN must be an integer in [1, 64]");
159
- const hasProvider = config.provider !== void 0;
160
- const hasModel = config.model !== void 0;
161
- if (hasProvider !== hasModel) throw new Error("dsh-engram: provider and model must be supplied together");
162
- if (config.decayAfterDays !== void 0 && (!Number.isInteger(config.decayAfterDays) || config.decayAfterDays < 1 || config.decayAfterDays > 3650)) throw new Error("dsh-engram: decayAfterDays must be an integer in [1, 3650]");
163
- if (config.decayImportanceBelow !== void 0 && (config.decayImportanceBelow < 0 || config.decayImportanceBelow > 1)) throw new Error("dsh-engram: decayImportanceBelow must be in [0, 1]");
164
- if (config.injectTokenBudget !== void 0 && (!Number.isInteger(config.injectTokenBudget) || config.injectTokenBudget < 128 || config.injectTokenBudget > 8192)) throw new Error("dsh-engram: injectTokenBudget must be an integer in [128, 8192]");
165
- if (config.injectItemBudgetStart !== void 0 && (!Number.isInteger(config.injectItemBudgetStart) || config.injectItemBudgetStart < 40 || config.injectItemBudgetStart > 2e3)) throw new Error("dsh-engram: injectItemBudgetStart must be an integer in [40, 2000]");
166
- if (config.injectItemBudgetDecay !== void 0 && (config.injectItemBudgetDecay < .5 || config.injectItemBudgetDecay > 1)) throw new Error("dsh-engram: injectItemBudgetDecay must be in [0.5, 1]");
167
- if (config.injectItemBudgetFloor !== void 0 && (!Number.isInteger(config.injectItemBudgetFloor) || config.injectItemBudgetFloor < 8 || config.injectItemBudgetFloor > 200)) throw new Error("dsh-engram: injectItemBudgetFloor must be an integer in [8, 200]");
168
- if (config.injectItemBudgetStart !== void 0 && config.injectItemBudgetFloor !== void 0 && config.injectItemBudgetFloor > config.injectItemBudgetStart) throw new Error("dsh-engram: injectItemBudgetFloor must not exceed injectItemBudgetStart");
169
- if (config.assessReminder !== void 0 && typeof config.assessReminder !== "boolean") throw new Error("dsh-engram: assessReminder must be a boolean");
170
- if (config.rankRecencyWeight !== void 0 && (config.rankRecencyWeight < 0 || config.rankRecencyWeight > 2)) throw new Error("dsh-engram: rankRecencyWeight must be in [0, 2]");
171
- if (config.rankProofWeight !== void 0 && (config.rankProofWeight < 0 || config.rankProofWeight > 2)) throw new Error("dsh-engram: rankProofWeight must be in [0, 2]");
172
- if (config.historyBackfillDays !== void 0 && (!Number.isInteger(config.historyBackfillDays) || config.historyBackfillDays < 0 || config.historyBackfillDays > 3650)) throw new Error("dsh-engram: historyBackfillDays must be an integer in [0, 3650] (0 = unlimited)");
173
- if (config.historyBackfillMaxTurnsPerSession !== void 0 && (!Number.isInteger(config.historyBackfillMaxTurnsPerSession) || config.historyBackfillMaxTurnsPerSession < 1 || config.historyBackfillMaxTurnsPerSession > 500)) throw new Error("dsh-engram: historyBackfillMaxTurnsPerSession must be an integer in [1, 500]");
174
- if (config.historyBackfillMaxTotalTurns !== void 0 && (!Number.isInteger(config.historyBackfillMaxTotalTurns) || config.historyBackfillMaxTotalTurns < 1 || config.historyBackfillMaxTotalTurns > 5e3)) throw new Error("dsh-engram: historyBackfillMaxTotalTurns must be an integer in [1, 5000]");
175
- const jev = config.jev;
176
- if (jev !== void 0) {
177
- if (jev.enabled !== void 0 && typeof jev.enabled !== "boolean") throw new Error("dsh-engram: jev.enabled must be a boolean");
178
- if (jev.enabled === true && (jev.apiKey === void 0 || jev.apiKey === "")) throw new Error("dsh-engram: jev.enabled=true requires jev.apiKey");
179
- if (jev.timeoutMs !== void 0 && (!Number.isInteger(jev.timeoutMs) || jev.timeoutMs < 1e3 || jev.timeoutMs > 6e4)) throw new Error("dsh-engram: jev.timeoutMs must be an integer in [1000, 60000]");
180
- if (jev.deferMergeAbove !== void 0 && (jev.deferMergeAbove < .5 || jev.deferMergeAbove > 1)) throw new Error("dsh-engram: jev.deferMergeAbove must be in [0.5, 1]");
181
- if (jev.deferAcceptBelow !== void 0 && (jev.deferAcceptBelow < 0 || jev.deferAcceptBelow > .5)) throw new Error("dsh-engram: jev.deferAcceptBelow must be in [0, 0.5]");
182
- if (jev.contradictMinProbability !== void 0 && (jev.contradictMinProbability < .5 || jev.contradictMinProbability > 1)) throw new Error("dsh-engram: jev.contradictMinProbability must be in [0.5, 1]");
183
- if ((jev.deferAcceptBelow ?? .15) >= (jev.deferMergeAbove ?? .85)) throw new Error("dsh-engram: jev.deferAcceptBelow must be less than jev.deferMergeAbove");
184
- }
185
- const dbDir = config.dbDir ?? join(homedir(), ".dsh", "engram");
186
- return {
187
- dbDir,
188
- legacyMigration: config.legacyMigration ?? "eager",
189
- injectProfile: config.injectProfile ?? true,
190
- profileTopN: config.profileTopN ?? 8,
191
- modelCacheDir: config.modelCacheDir ?? join(dbDir, "models"),
192
- hfEndpoint: config.hfEndpoint,
193
- ingest: config.ingest ?? "off",
194
- reflect: config.reflect ?? "off",
195
- language: resolveLanguage(config.language ?? "auto"),
196
- redactWords: config.redactWords ?? [],
197
- routeOverride: hasProvider && hasModel ? {
198
- provider: config.provider,
199
- model: config.model
200
- } : void 0,
201
- decayAfterDays: config.decayAfterDays ?? 30,
202
- decayImportanceBelow: config.decayImportanceBelow ?? .3,
203
- injectTokenBudget: config.injectTokenBudget ?? 1024,
204
- injectItemBudgetStart: config.injectItemBudgetStart ?? 160,
205
- injectItemBudgetDecay: config.injectItemBudgetDecay ?? .9,
206
- injectItemBudgetFloor: config.injectItemBudgetFloor ?? 24,
207
- assessReminder: config.assessReminder ?? true,
208
- rankRecencyWeight: config.rankRecencyWeight ?? .2,
209
- rankProofWeight: config.rankProofWeight ?? .1,
210
- queryRewrite: config.queryRewrite ?? true,
211
- autoSlot: config.autoSlot ?? true,
212
- reviewScheduling: config.reviewScheduling ?? true,
213
- historyBackfill: {
214
- days: config.historyBackfillDays ?? 7,
215
- maxTurnsPerSession: config.historyBackfillMaxTurnsPerSession ?? 20,
216
- maxTotalTurns: config.historyBackfillMaxTotalTurns ?? 200,
217
- includeSubagents: config.historyBackfillIncludeSubagents ?? false,
218
- includeSeeded: config.historyBackfillIncludeSeeded ?? false,
219
- includeNoCwd: config.historyBackfillIncludeNoCwd ?? false
220
- },
221
- jev: {
222
- enabled: config.jev?.enabled ?? false,
223
- apiKey: config.jev?.apiKey,
224
- baseUrl: config.jev?.baseUrl ?? "https://api.typesafe.ai",
225
- model: config.jev?.model ?? "jev-latest",
226
- timeoutMs: config.jev?.timeoutMs ?? 3e3,
227
- deferMergeAbove: config.jev?.deferMergeAbove ?? .85,
228
- deferAcceptBelow: config.jev?.deferAcceptBelow ?? .15,
229
- contradictMinProbability: config.jev?.contradictMinProbability ?? .8
230
- }
231
- };
232
- }
233
- //#endregion
234
54
  //#region src/i18n/catalog/core.ts
235
55
  /**
236
56
  * Словарь: ядро плагина — профиль сессии, бюджет токенов, предложение экскурсии,
@@ -288,6 +108,7 @@ const zh$4 = {
288
108
  "core.warnConsolidationFailed": "[dsh-engram] 闭馆整理失败(不影响对话):",
289
109
  "core.warnEmbedderUnavailable": "[dsh-engram] 嵌入器不可用,检索降级为纯关键词模式:",
290
110
  "core.warnRoomFull": "[dsh-engram] 房间已满,自动开新房「{room}」(可在管理面板翻新清单中人工拆分/命名)",
111
+ "core.warnJevLegacyFields": "[dsh-engram] {where} 中的 jev.{field} 已不再读取:令牌与地址现取自 jev.provider 所指的 DSH 提供商——请把密钥迁入该提供商的密钥库,并删除这个字段",
291
112
  "core.warnSlotsBackfilled": "[dsh-engram] 存量记忆排桩完成:{count} 条已钉入宫殿({path})",
292
113
  "core.logReflectDone": "[dsh-engram] 信念巩固完成({scope}):新建 {formed},细化 {refined},维持 {confirmed},否定 {refuted}",
293
114
  "core.logConsolidationDone": "[dsh-engram] 闭馆整理完成:归档 {archived},合并 {merged},跳过 {skipped}({ms} ms)",
@@ -341,6 +162,7 @@ const en$4 = {
341
162
  "core.warnConsolidationFailed": "[dsh-engram] Closing-time consolidation failed (conversation unaffected):",
342
163
  "core.warnEmbedderUnavailable": "[dsh-engram] Embedder unavailable; retrieval degrades to keyword-only mode:",
343
164
  "core.warnRoomFull": "[dsh-engram] Room full; opening a new room “{room}” automatically (split or rename it by hand in the panel’s slot-list view)",
165
+ "core.warnJevLegacyFields": "[dsh-engram] jev.{field} in {where} is no longer read: the token and endpoint now come from the DSH provider named by jev.provider — move the key into that provider’s credential store and delete the field",
344
166
  "core.warnSlotsBackfilled": "[dsh-engram] Existing memories slotted: {count} pinned into the palace ({path})",
345
167
  "core.logReflectDone": "[dsh-engram] Belief consolidation done ({scope}): {formed} formed, {refined} refined, {confirmed} confirmed, {refuted} refuted",
346
168
  "core.logConsolidationDone": "[dsh-engram] Closing-time consolidation done: {archived} archived, {merged} merged, {skipped} skipped ({ms} ms)",
@@ -394,6 +216,7 @@ const ru$4 = {
394
216
  "core.warnConsolidationFailed": "[dsh-engram] Закрытие зала не удалось (диалог не затронут):",
395
217
  "core.warnEmbedderUnavailable": "[dsh-engram] Встраиватель недоступен, поиск деградирует до режима «только ключевые слова»:",
396
218
  "core.warnRoomFull": "[dsh-engram] Комната заполнена, автоматически открывается новая «{room}» (её можно вручную разделить или переименовать в списке обновления панели)",
219
+ "core.warnJevLegacyFields": "[dsh-engram] jev.{field} в {where} больше не читается: ключ и адрес берутся у провайдера DSH, названного в jev.provider — перенесите ключ в хранилище секретов этого провайдера и удалите поле",
397
220
  "core.warnSlotsBackfilled": "[dsh-engram] Разметка существующих воспоминаний завершена: {count} закреплено во дворце ({path})",
398
221
  "core.logReflectDone": "[dsh-engram] Закрепление убеждений завершено ({scope}): создано {formed}, уточнено {refined}, подтверждено {confirmed}, опровергнуто {refuted}",
399
222
  "core.logConsolidationDone": "[dsh-engram] Закрытие зала завершено: архивировано {archived}, объединено {merged}, пропущено {skipped} ({ms} ms)",
@@ -516,7 +339,13 @@ const zh$2 = {
516
339
  "misc.exportHeading": "# dsh-engram 导出({scope})",
517
340
  "misc.exportRecordLine": "- [{status}/{kind}] {content}(id={id},importance {importance})",
518
341
  "misc.exportEdgesHeading": "## 关系边",
519
- "misc.importInvalidPayload": "导入文件结构校验失败:{error}",
342
+ "misc.importInvalidPayload": "导入文件结构有误:{error}",
343
+ "misc.bodyTooLarge": "请求体过大:超过 {limit} 上限。",
344
+ "misc.bodyMalformed": "请求体不是合法 JSON:{error}",
345
+ "misc.bodyNotObject": "请求体必须是 JSON 对象。",
346
+ "misc.importBodyTooLarge": "导入文件过大:超过 {limit} 上限。请拆分导出文件后重试,或改用 engram_import 工具按文件路径导入。",
347
+ "misc.importBodyMalformed": "导入请求体不是合法 JSON:{error}",
348
+ "misc.importBodyNotObject": "导入请求体必须是 JSON 对象。",
520
349
  "misc.backfillCannotStart": "无法启动回填",
521
350
  "misc.archivePathOutsideDbDir": "archivePath 必须在 dbDir 内",
522
351
  "misc.restoreFailed": "恢复失败:{message}",
@@ -541,9 +370,15 @@ const zh$2 = {
541
370
  "misc.refurbLowPlacardReason": "{slot}门牌得分 {score} < 0.5(不合唯一/差异化/带日期纪律),建议重写铭牌。",
542
371
  "misc.placardImprovementHint": "门牌不合规(宫殿纪律:唯一 · 差异化 · 带日期):建议用 engram_update 的 placard 参数挂一个 4-30 字、含日期锚点、与同房其他门牌前 6 字不重复的铭牌。",
543
372
  "misc.jevEnabledMustBeBoolean": "invalid: jev.enabled 必须是布尔值",
544
- "misc.jevApiKeyMustBeString": "invalid: jev.apiKey 必须是字符串",
545
- "misc.jevBaseUrlMustBeString": "invalid: jev.baseUrl 必须是字符串",
546
- "misc.jevBaseUrlMustBeHttp": "invalid: jev.baseUrl 必须是 http(s) URL",
373
+ "misc.jevProviderMustBeString": "invalid: jev.provider 必须是字符串",
374
+ "misc.jevProviderMustBeSelected": "Jev:请先选择提供商和模型",
375
+ "misc.jevHostLlmUnavailable": "Jev:宿主的模型服务不可用,无法获取提供商列表",
376
+ "misc.jevProviderNotConfigured": "Jev:提供商「{provider}」未在 DSH 中配置",
377
+ "misc.jevProviderHasNoBaseUrl": "Jev:提供商「{provider}」在 DSH 配置中没有 baseURL",
378
+ "misc.jevProviderKeyMissing": "Jev:提供商「{provider}」没有密钥(引用「{ref}」为空)",
379
+ "misc.jevProviderUnresolved": "Jev:没有提供商——面板、插件设置和会话路由都没有指定",
380
+ "misc.jevModelNotPicked": "Jev:提供商「{provider}」的 DSH 设置里没有 JEV 模型,请手动指定模型",
381
+ "misc.jevEndpointMustBeHttp": "invalid: jev.endpoint 必须是 http(s) URL",
547
382
  "misc.jevModelMustNotBeEmpty": "invalid: jev.model 不能为空",
548
383
  "misc.jevTimeoutMsMustBeInteger": "invalid: jev.timeoutMs 必须是 1000-60000 的整数毫秒"
549
384
  };
@@ -554,7 +389,13 @@ const en$2 = {
554
389
  "misc.exportHeading": "# dsh-engram export ({scope})",
555
390
  "misc.exportRecordLine": "- [{status}/{kind}] {content} (id={id}, importance {importance})",
556
391
  "misc.exportEdgesHeading": "## Relation edges",
557
- "misc.importInvalidPayload": "import file structure validation failed: {error}",
392
+ "misc.importInvalidPayload": "import file structure is invalid: {error}",
393
+ "misc.bodyTooLarge": "request body is too large: over the {limit} limit.",
394
+ "misc.bodyMalformed": "request body is not valid JSON: {error}",
395
+ "misc.bodyNotObject": "request body must be a JSON object.",
396
+ "misc.importBodyTooLarge": "import file is too large: over the {limit} limit. Split the export and retry, or use the engram_import tool with a file path.",
397
+ "misc.importBodyMalformed": "import request body is not valid JSON: {error}",
398
+ "misc.importBodyNotObject": "import request body must be a JSON object.",
558
399
  "misc.backfillCannotStart": "cannot start backfill",
559
400
  "misc.archivePathOutsideDbDir": "archivePath must be inside dbDir",
560
401
  "misc.restoreFailed": "restore failed: {message}",
@@ -579,9 +420,15 @@ const en$2 = {
579
420
  "misc.refurbLowPlacardReason": "{slot}placard score {score} < 0.5 (violates the unique/distinctive/date-anchored discipline); rewrite the placard.",
580
421
  "misc.placardImprovementHint": "placard does not comply (palace discipline: unique · distinctive · date-anchored): attach a 4-30 character placard with the placard parameter of engram_update, including a date anchor and not repeating the first 6 characters of another placard in the same room.",
581
422
  "misc.jevEnabledMustBeBoolean": "invalid: jev.enabled must be a boolean",
582
- "misc.jevApiKeyMustBeString": "invalid: jev.apiKey must be a string",
583
- "misc.jevBaseUrlMustBeString": "invalid: jev.baseUrl must be a string",
584
- "misc.jevBaseUrlMustBeHttp": "invalid: jev.baseUrl must be an http(s) URL",
423
+ "misc.jevProviderMustBeString": "invalid: jev.provider must be a string",
424
+ "misc.jevProviderMustBeSelected": "Jev: choose a provider and a model first",
425
+ "misc.jevHostLlmUnavailable": "Jev: the host LLM service is unavailable, so providers cannot be listed",
426
+ "misc.jevProviderNotConfigured": "Jev: provider \"{provider}\" is not configured in DSH",
427
+ "misc.jevProviderHasNoBaseUrl": "Jev: provider \"{provider}\" has no baseURL in the DSH configuration",
428
+ "misc.jevProviderKeyMissing": "Jev: provider \"{provider}\" has no key (credential \"{ref}\" is empty)",
429
+ "misc.jevProviderUnresolved": "Jev: no provider — neither the panel, nor the plugin settings, nor the session route names one",
430
+ "misc.jevModelNotPicked": "Jev: provider \"{provider}\" has no JEV model in its DSH settings; name the model explicitly",
431
+ "misc.jevEndpointMustBeHttp": "invalid: jev.endpoint must be an http(s) URL",
585
432
  "misc.jevModelMustNotBeEmpty": "invalid: jev.model must not be empty",
586
433
  "misc.jevTimeoutMsMustBeInteger": "invalid: jev.timeoutMs must be an integer number of milliseconds between 1000 and 60000"
587
434
  };
@@ -592,7 +439,13 @@ const ru$2 = {
592
439
  "misc.exportHeading": "# Экспорт dsh-engram ({scope})",
593
440
  "misc.exportRecordLine": "- [{status}/{kind}] {content} (id={id}, importance {importance})",
594
441
  "misc.exportEdgesHeading": "## Связи",
595
- "misc.importInvalidPayload": "проверка структуры файла импорта не пройдена: {error}",
442
+ "misc.importInvalidPayload": "структура файла импорта некорректна: {error}",
443
+ "misc.bodyTooLarge": "тело запроса слишком большое: превышен предел {limit}.",
444
+ "misc.bodyMalformed": "тело запроса — не корректный JSON: {error}",
445
+ "misc.bodyNotObject": "тело запроса должно быть JSON-объектом.",
446
+ "misc.importBodyTooLarge": "файл импорта слишком большой: превышен предел {limit}. Разделите экспорт и повторите либо используйте инструмент engram_import с путём к файлу.",
447
+ "misc.importBodyMalformed": "тело запроса импорта — не корректный JSON: {error}",
448
+ "misc.importBodyNotObject": "тело запроса импорта должно быть JSON-объектом.",
596
449
  "misc.backfillCannotStart": "не удалось запустить заполнение",
597
450
  "misc.archivePathOutsideDbDir": "archivePath должен находиться внутри dbDir",
598
451
  "misc.restoreFailed": "восстановление не удалось: {message}",
@@ -617,9 +470,15 @@ const ru$2 = {
617
470
  "misc.refurbLowPlacardReason": "{slot}оценка таблички {score} < 0.5 (нарушает дисциплину уникальности/различимости/даты); перепишите табличку.",
618
471
  "misc.placardImprovementHint": "табличка не соответствует дисциплине дворца (уникальность · различимость · дата): прикрепите параметром placard инструмента engram_update табличку из 4-30 символов с датой, первые 6 символов которой не совпадают с другими табличками той же комнаты.",
619
472
  "misc.jevEnabledMustBeBoolean": "invalid: jev.enabled должно быть логическим значением",
620
- "misc.jevApiKeyMustBeString": "invalid: jev.apiKey должно быть строкой",
621
- "misc.jevBaseUrlMustBeString": "invalid: jev.baseUrl должно быть строкой",
622
- "misc.jevBaseUrlMustBeHttp": "invalid: jev.baseUrl должно быть URL со схемой http(s)",
473
+ "misc.jevProviderMustBeString": "invalid: jev.provider должно быть строкой",
474
+ "misc.jevProviderMustBeSelected": "Jev: сначала выберите провайдера и модель",
475
+ "misc.jevHostLlmUnavailable": "Jev: сервис моделей хоста недоступен, список провайдеров получить нельзя",
476
+ "misc.jevProviderNotConfigured": "Jev: провайдер «{provider}» не настроен в DSH",
477
+ "misc.jevProviderHasNoBaseUrl": "Jev: у провайдера «{provider}» в настройках DSH нет baseURL",
478
+ "misc.jevProviderKeyMissing": "Jev: у провайдера «{provider}» нет ключа (ссылка «{ref}» пуста)",
479
+ "misc.jevProviderUnresolved": "Jev: провайдер не назван — ни панелью, ни настройками плагина, ни маршрутом сессии",
480
+ "misc.jevModelNotPicked": "Jev: у провайдера «{provider}» в настройках DSH нет JEV-модели — укажите модель вручную",
481
+ "misc.jevEndpointMustBeHttp": "invalid: jev.endpoint должно быть URL со схемой http(s)",
623
482
  "misc.jevModelMustNotBeEmpty": "invalid: jev.model не может быть пустым",
624
483
  "misc.jevTimeoutMsMustBeInteger": "invalid: jev.timeoutMs должно быть целым числом миллисекунд от 1000 до 60000"
625
484
  };
@@ -1818,6 +1677,245 @@ function message(key, params) {
1818
1677
  return messageIn(current, key, params);
1819
1678
  }
1820
1679
  //#endregion
1680
+ //#region src/jev/stale.ts
1681
+ /**
1682
+ * Поля Jev прежнего формата: ключ и адрес когда-то хранились у самого плагина
1683
+ * (`jev.apiKey`, `jev.baseUrl`). После переезда к провайдеру хоста они больше не
1684
+ * читаются, но продолжают лежать в уже написанных конфигурациях — и человек вправе
1685
+ * об этом узнать, а не гадать, почему судья молчит.
1686
+ *
1687
+ * Предупреждение одноразовое на процесс, причём отдельно для каждого источника и
1688
+ * поля: перекрытие панели читается при каждой сборке судьи, и без счётчика один и
1689
+ * тот же текст повторялся бы на каждой записи. Источники разделены намеренно —
1690
+ * `cordis.yml` и `jev-config.json` правятся в разных местах, и заглушить один
1691
+ * предупреждением о другом значило бы оставить половину работы незамеченной.
1692
+ *
1693
+ * @module @kenz1117/dsh-engram/jev/stale
1694
+ */
1695
+ /** Прежние поля Jev, пережившие переезд ключа и адреса к провайдеру хоста. */
1696
+ const LEGACY_FIELDS = ["apiKey", "baseUrl"];
1697
+ /** Уже прозвучавшие предупреждения: ключ — «источник + поле». */
1698
+ const warned = /* @__PURE__ */ new Set();
1699
+ /**
1700
+ * Имена полей прежнего формата, реально присутствующих в объекте.
1701
+ * @param value - разобранный JSON перекрытия или подконфигурация `jev` из cordis.yml.
1702
+ * @returns найденные имена полей; пустой массив — объект чист.
1703
+ */
1704
+ function legacyJevFields(value) {
1705
+ if (value === null || typeof value !== "object") return [];
1706
+ const raw = value;
1707
+ return LEGACY_FIELDS.filter((field) => raw[field] !== void 0);
1708
+ }
1709
+ /**
1710
+ * Напомнить один раз, что поля прежнего формата игнорируются, и сказать, куда
1711
+ * переехал ключ. Текст берётся из служебного словаря: язык — состояние процесса.
1712
+ * @param where - где нашлись поля: `cordis.yml` или `jev-config.json`.
1713
+ * @param fields - имена полей (см. `legacyJevFields`).
1714
+ */
1715
+ function noteLegacyJevFields(where, fields) {
1716
+ for (const field of fields) {
1717
+ const seen = `${where}|${field}`;
1718
+ if (warned.has(seen)) continue;
1719
+ warned.add(seen);
1720
+ console.warn(message("core.warnJevLegacyFields", {
1721
+ where,
1722
+ field
1723
+ }));
1724
+ }
1725
+ }
1726
+ //#endregion
1727
+ //#region src/config.ts
1728
+ /**
1729
+ * 插件 Config:所有部署可变项集中于此,禁止在实现里内嵌默认值。
1730
+ * @module @kenz1117/dsh-engram/config
1731
+ */
1732
+ /** 合法配置键集合(未知键 loud 失败)。 */
1733
+ const CONFIG_KEYS = /* @__PURE__ */ new Set([
1734
+ "legacyMigration",
1735
+ "dbDir",
1736
+ "injectProfile",
1737
+ "profileTopN",
1738
+ "modelCacheDir",
1739
+ "hfEndpoint",
1740
+ "ingest",
1741
+ "reflect",
1742
+ "provider",
1743
+ "model",
1744
+ "decayAfterDays",
1745
+ "decayImportanceBelow",
1746
+ "injectTokenBudget",
1747
+ "injectItemBudgetStart",
1748
+ "injectItemBudgetDecay",
1749
+ "injectItemBudgetFloor",
1750
+ "rankRecencyWeight",
1751
+ "rankProofWeight",
1752
+ "queryRewrite",
1753
+ "autoSlot",
1754
+ "reviewScheduling",
1755
+ "assessReminder",
1756
+ "historyBackfillDays",
1757
+ "historyBackfillMaxTurnsPerSession",
1758
+ "historyBackfillMaxTotalTurns",
1759
+ "historyBackfillIncludeSubagents",
1760
+ "historyBackfillIncludeSeeded",
1761
+ "historyBackfillIncludeNoCwd",
1762
+ "jev",
1763
+ "language",
1764
+ "redactWords"
1765
+ ]);
1766
+ const INGEST_MODES = /* @__PURE__ */ new Set([
1767
+ "off",
1768
+ "light",
1769
+ "eager"
1770
+ ]);
1771
+ const REFLECT_MODES = /* @__PURE__ */ new Set([
1772
+ "off",
1773
+ "suggest",
1774
+ "auto"
1775
+ ]);
1776
+ /** Schemastery 校验面(cordis.yml 读取时校验)。 */
1777
+ const Config = z.object({
1778
+ dbDir: z.string(),
1779
+ legacyMigration: z.string(),
1780
+ injectProfile: z.boolean(),
1781
+ profileTopN: z.number().step(1).min(1).max(64),
1782
+ modelCacheDir: z.string(),
1783
+ hfEndpoint: z.string(),
1784
+ ingest: z.string(),
1785
+ reflect: z.string(),
1786
+ provider: z.string(),
1787
+ model: z.string(),
1788
+ decayAfterDays: z.number().step(1).min(1).max(3650),
1789
+ decayImportanceBelow: z.number().min(0).max(1),
1790
+ injectTokenBudget: z.number().step(1).min(128).max(8192),
1791
+ injectItemBudgetStart: z.number().step(1).min(40).max(2e3),
1792
+ injectItemBudgetDecay: z.number().min(.5).max(1),
1793
+ injectItemBudgetFloor: z.number().step(1).min(8).max(200),
1794
+ rankRecencyWeight: z.number().min(0).max(2),
1795
+ rankProofWeight: z.number().min(0).max(2),
1796
+ queryRewrite: z.boolean(),
1797
+ autoSlot: z.boolean(),
1798
+ reviewScheduling: z.boolean(),
1799
+ assessReminder: z.boolean(),
1800
+ historyBackfillDays: z.number().step(1).min(0).max(3650),
1801
+ historyBackfillMaxTurnsPerSession: z.number().step(1).min(1).max(500),
1802
+ historyBackfillMaxTotalTurns: z.number().step(1).min(1).max(5e3),
1803
+ historyBackfillIncludeSubagents: z.boolean(),
1804
+ historyBackfillIncludeSeeded: z.boolean(),
1805
+ historyBackfillIncludeNoCwd: z.boolean(),
1806
+ jev: z.object({
1807
+ enabled: z.boolean(),
1808
+ provider: z.string(),
1809
+ model: z.string(),
1810
+ endpoint: z.string(),
1811
+ timeoutMs: z.number().step(1).min(1e3).max(6e4),
1812
+ deferMergeAbove: z.number().min(.5).max(1),
1813
+ deferAcceptBelow: z.number().min(0).max(.5),
1814
+ contradictMinProbability: z.number().min(.5).max(1)
1815
+ }),
1816
+ language: z.string(),
1817
+ redactWords: z.array(z.string())
1818
+ });
1819
+ /**
1820
+ * 显式 resolve 步骤:默认值只在唯一的此处落地,非法值 loud 失败。
1821
+ * @param config - cordis.yml 传入的未校验配置。
1822
+ * @returns 完整解析配置。
1823
+ * @throws 未知键、ingest 档位非法、provider/model 只给其一、decay/预算/排序权重/历史回填规则越界时抛错。
1824
+ */
1825
+ function resolveConfig(config = {}) {
1826
+ for (const key of Object.keys(config)) if (!CONFIG_KEYS.has(key)) throw new Error(`dsh-engram: unknown config key "${key}"`);
1827
+ if (config.legacyMigration !== void 0 && config.legacyMigration !== "eager" && config.legacyMigration !== "conservative") throw new Error("dsh-engram: legacyMigration must be one of eager|conservative");
1828
+ if (config.ingest !== void 0 && !INGEST_MODES.has(config.ingest)) throw new Error(`dsh-engram: ingest must be one of off|light|eager, got "${String(config.ingest)}"`);
1829
+ if (config.reflect !== void 0 && !REFLECT_MODES.has(config.reflect)) throw new Error(`dsh-engram: reflect must be one of off|suggest|auto, got "${String(config.reflect)}"`);
1830
+ if (config.language !== void 0 && config.language !== "auto" && !isEngramLanguage(config.language)) throw new Error(`dsh-engram: language must be one of auto|zh|en|ru, got "${String(config.language)}"`);
1831
+ if (config.profileTopN !== void 0 && (!Number.isInteger(config.profileTopN) || config.profileTopN < 1 || config.profileTopN > 64)) throw new Error("dsh-engram: profileTopN must be an integer in [1, 64]");
1832
+ const hasProvider = config.provider !== void 0;
1833
+ const hasModel = config.model !== void 0;
1834
+ if (hasProvider !== hasModel) throw new Error("dsh-engram: provider and model must be supplied together");
1835
+ if (config.decayAfterDays !== void 0 && (!Number.isInteger(config.decayAfterDays) || config.decayAfterDays < 1 || config.decayAfterDays > 3650)) throw new Error("dsh-engram: decayAfterDays must be an integer in [1, 3650]");
1836
+ if (config.decayImportanceBelow !== void 0 && (config.decayImportanceBelow < 0 || config.decayImportanceBelow > 1)) throw new Error("dsh-engram: decayImportanceBelow must be in [0, 1]");
1837
+ if (config.injectTokenBudget !== void 0 && (!Number.isInteger(config.injectTokenBudget) || config.injectTokenBudget < 128 || config.injectTokenBudget > 8192)) throw new Error("dsh-engram: injectTokenBudget must be an integer in [128, 8192]");
1838
+ if (config.injectItemBudgetStart !== void 0 && (!Number.isInteger(config.injectItemBudgetStart) || config.injectItemBudgetStart < 40 || config.injectItemBudgetStart > 2e3)) throw new Error("dsh-engram: injectItemBudgetStart must be an integer in [40, 2000]");
1839
+ if (config.injectItemBudgetDecay !== void 0 && (config.injectItemBudgetDecay < .5 || config.injectItemBudgetDecay > 1)) throw new Error("dsh-engram: injectItemBudgetDecay must be in [0.5, 1]");
1840
+ if (config.injectItemBudgetFloor !== void 0 && (!Number.isInteger(config.injectItemBudgetFloor) || config.injectItemBudgetFloor < 8 || config.injectItemBudgetFloor > 200)) throw new Error("dsh-engram: injectItemBudgetFloor must be an integer in [8, 200]");
1841
+ if (config.injectItemBudgetStart !== void 0 && config.injectItemBudgetFloor !== void 0 && config.injectItemBudgetFloor > config.injectItemBudgetStart) throw new Error("dsh-engram: injectItemBudgetFloor must not exceed injectItemBudgetStart");
1842
+ if (config.assessReminder !== void 0 && typeof config.assessReminder !== "boolean") throw new Error("dsh-engram: assessReminder must be a boolean");
1843
+ if (config.rankRecencyWeight !== void 0 && (config.rankRecencyWeight < 0 || config.rankRecencyWeight > 2)) throw new Error("dsh-engram: rankRecencyWeight must be in [0, 2]");
1844
+ if (config.rankProofWeight !== void 0 && (config.rankProofWeight < 0 || config.rankProofWeight > 2)) throw new Error("dsh-engram: rankProofWeight must be in [0, 2]");
1845
+ if (config.historyBackfillDays !== void 0 && (!Number.isInteger(config.historyBackfillDays) || config.historyBackfillDays < 0 || config.historyBackfillDays > 3650)) throw new Error("dsh-engram: historyBackfillDays must be an integer in [0, 3650] (0 = unlimited)");
1846
+ if (config.historyBackfillMaxTurnsPerSession !== void 0 && (!Number.isInteger(config.historyBackfillMaxTurnsPerSession) || config.historyBackfillMaxTurnsPerSession < 1 || config.historyBackfillMaxTurnsPerSession > 500)) throw new Error("dsh-engram: historyBackfillMaxTurnsPerSession must be an integer in [1, 500]");
1847
+ if (config.historyBackfillMaxTotalTurns !== void 0 && (!Number.isInteger(config.historyBackfillMaxTotalTurns) || config.historyBackfillMaxTotalTurns < 1 || config.historyBackfillMaxTotalTurns > 5e3)) throw new Error("dsh-engram: historyBackfillMaxTotalTurns must be an integer in [1, 5000]");
1848
+ const jev = config.jev;
1849
+ if (jev !== void 0) {
1850
+ const legacy = legacyJevFields(jev);
1851
+ if (legacy.length > 0) noteLegacyJevFields("cordis.yml", legacy);
1852
+ if (jev.enabled !== void 0 && typeof jev.enabled !== "boolean") throw new Error("dsh-engram: jev.enabled must be a boolean");
1853
+ if (jev.provider !== void 0 && (typeof jev.provider !== "string" || jev.provider.trim() === "")) throw new Error("dsh-engram: jev.provider must be a non-empty string");
1854
+ if (jev.model !== void 0 && (typeof jev.model !== "string" || jev.model.trim() === "")) throw new Error("dsh-engram: jev.model must be a non-empty string");
1855
+ if (jev.endpoint !== void 0) {
1856
+ let scheme = "";
1857
+ try {
1858
+ scheme = new URL(jev.endpoint).protocol;
1859
+ } catch {
1860
+ throw new Error("dsh-engram: jev.endpoint must be an http(s) URL");
1861
+ }
1862
+ if (scheme !== "https:" && scheme !== "http:") throw new Error("dsh-engram: jev.endpoint must be an http(s) URL");
1863
+ }
1864
+ if (jev.timeoutMs !== void 0 && (!Number.isInteger(jev.timeoutMs) || jev.timeoutMs < 1e3 || jev.timeoutMs > 6e4)) throw new Error("dsh-engram: jev.timeoutMs must be an integer in [1000, 60000]");
1865
+ if (jev.deferMergeAbove !== void 0 && (jev.deferMergeAbove < .5 || jev.deferMergeAbove > 1)) throw new Error("dsh-engram: jev.deferMergeAbove must be in [0.5, 1]");
1866
+ if (jev.deferAcceptBelow !== void 0 && (jev.deferAcceptBelow < 0 || jev.deferAcceptBelow > .5)) throw new Error("dsh-engram: jev.deferAcceptBelow must be in [0, 0.5]");
1867
+ if (jev.contradictMinProbability !== void 0 && (jev.contradictMinProbability < .5 || jev.contradictMinProbability > 1)) throw new Error("dsh-engram: jev.contradictMinProbability must be in [0.5, 1]");
1868
+ if ((jev.deferAcceptBelow ?? .15) >= (jev.deferMergeAbove ?? .85)) throw new Error("dsh-engram: jev.deferAcceptBelow must be less than jev.deferMergeAbove");
1869
+ }
1870
+ const dbDir = config.dbDir ?? join(homedir(), ".dsh", "engram");
1871
+ return {
1872
+ dbDir,
1873
+ legacyMigration: config.legacyMigration ?? "eager",
1874
+ injectProfile: config.injectProfile ?? true,
1875
+ profileTopN: config.profileTopN ?? 8,
1876
+ modelCacheDir: config.modelCacheDir ?? join(dbDir, "models"),
1877
+ hfEndpoint: config.hfEndpoint,
1878
+ ingest: config.ingest ?? "off",
1879
+ reflect: config.reflect ?? "off",
1880
+ language: resolveLanguage(config.language ?? "auto"),
1881
+ redactWords: config.redactWords ?? [],
1882
+ routeOverride: hasProvider && hasModel ? {
1883
+ provider: config.provider,
1884
+ model: config.model
1885
+ } : void 0,
1886
+ decayAfterDays: config.decayAfterDays ?? 30,
1887
+ decayImportanceBelow: config.decayImportanceBelow ?? .3,
1888
+ injectTokenBudget: config.injectTokenBudget ?? 1024,
1889
+ injectItemBudgetStart: config.injectItemBudgetStart ?? 160,
1890
+ injectItemBudgetDecay: config.injectItemBudgetDecay ?? .9,
1891
+ injectItemBudgetFloor: config.injectItemBudgetFloor ?? 24,
1892
+ assessReminder: config.assessReminder ?? true,
1893
+ rankRecencyWeight: config.rankRecencyWeight ?? .2,
1894
+ rankProofWeight: config.rankProofWeight ?? .1,
1895
+ queryRewrite: config.queryRewrite ?? true,
1896
+ autoSlot: config.autoSlot ?? true,
1897
+ reviewScheduling: config.reviewScheduling ?? true,
1898
+ historyBackfill: {
1899
+ days: config.historyBackfillDays ?? 7,
1900
+ maxTurnsPerSession: config.historyBackfillMaxTurnsPerSession ?? 20,
1901
+ maxTotalTurns: config.historyBackfillMaxTotalTurns ?? 200,
1902
+ includeSubagents: config.historyBackfillIncludeSubagents ?? false,
1903
+ includeSeeded: config.historyBackfillIncludeSeeded ?? false,
1904
+ includeNoCwd: config.historyBackfillIncludeNoCwd ?? false
1905
+ },
1906
+ jev: {
1907
+ enabled: config.jev?.enabled ?? false,
1908
+ provider: config.jev?.provider,
1909
+ model: config.jev?.model,
1910
+ endpoint: config.jev?.endpoint,
1911
+ timeoutMs: config.jev?.timeoutMs ?? 3e3,
1912
+ deferMergeAbove: config.jev?.deferMergeAbove ?? .85,
1913
+ deferAcceptBelow: config.jev?.deferAcceptBelow ?? .15,
1914
+ contradictMinProbability: config.jev?.contradictMinProbability ?? .8
1915
+ }
1916
+ };
1917
+ }
1918
+ //#endregion
1821
1919
  //#region src/i18n/patterns.ts
1822
1920
  /**
1823
1921
  * Языкозависимые образцы распознавания ввода.
@@ -2919,6 +3017,7 @@ async function ingestPreviousTurn(deps) {
2919
3017
  skipped: raw.trim() === "" ? "empty-answer" : "unparseable-output"
2920
3018
  };
2921
3019
  const embedder = await deps.embedder;
3020
+ const judge = deps.resolveJudge?.();
2922
3021
  const writtenContents = [];
2923
3022
  let written = 0;
2924
3023
  let merged = 0;
@@ -2971,8 +3070,8 @@ async function ingestPreviousTurn(deps) {
2971
3070
  continue;
2972
3071
  }
2973
3072
  const vector = embedder === void 0 ? void 0 : (await embedder.embed([content]))[0];
2974
- const decision = await decideWrite(target, kind, vector, deps.judge === void 0 ? {} : {
2975
- judge: deps.judge,
3073
+ const decision = await decideWrite(target, kind, vector, judge === void 0 ? {} : {
3074
+ judge,
2976
3075
  content
2977
3076
  });
2978
3077
  if (decision.disposition === "merge") {
@@ -2995,7 +3094,7 @@ async function ingestPreviousTurn(deps) {
2995
3094
  ...deps.history === true ? { initialReviewAt: null } : {}
2996
3095
  });
2997
3096
  if (decision.disposition === "defer") {
2998
- const neighbors = deps.judge === void 0 ? [decision.neighbor] : await confirmContradictions(deps.judge, content, [decision.neighbor]) ?? [decision.neighbor];
3097
+ const neighbors = judge === void 0 ? [decision.neighbor] : await confirmContradictions(judge, content, [decision.neighbor]) ?? [decision.neighbor];
2999
3098
  for (const neighbor of neighbors) {
3000
3099
  if (neighbor.id === record.id) continue;
3001
3100
  await target.linkEdge(record.id, neighbor.id, "contradicts");
@@ -3160,7 +3259,7 @@ async function replayPendingIngests(deps) {
3160
3259
  routeOverride: deps.routeOverride,
3161
3260
  call: deps.call,
3162
3261
  logRequest: deps.logRequest,
3163
- ...deps.judge === void 0 ? {} : { judge: deps.judge },
3262
+ ...deps.resolveJudge === void 0 ? {} : { resolveJudge: deps.resolveJudge },
3164
3263
  signal: deps.signal
3165
3264
  });
3166
3265
  if (outcome.skipped === "unparseable-output" || outcome.skipped === "empty-answer") {
@@ -3404,6 +3503,7 @@ async function runHistoryBackfill(deps, defaults, overrides, onProgress, signal)
3404
3503
  provider: overrides.provider,
3405
3504
  model: overrides.model
3406
3505
  } : deps.routeOverride;
3506
+ const judge = deps.resolveJudge?.();
3407
3507
  const failures = [];
3408
3508
  /** 内部可变累加器(对外以只读的 HistoryRunProgress 暴露)。 */
3409
3509
  const progress = {
@@ -3436,7 +3536,7 @@ async function runHistoryBackfill(deps, defaults, overrides, onProgress, signal)
3436
3536
  routeOverride,
3437
3537
  call: deps.call,
3438
3538
  logRequest: deps.logRequest,
3439
- ...deps.judge === void 0 ? {} : { judge: deps.judge },
3539
+ ...judge === void 0 ? {} : { judge },
3440
3540
  signal,
3441
3541
  throttle: true,
3442
3542
  history: true
@@ -4025,7 +4125,7 @@ const parseEntity = (raw, index) => {
4025
4125
  * 空文件(records 为空数组)合法——预览为空、提交零写入。
4026
4126
  */
4027
4127
  function parseImportData(raw) {
4028
- if (!isObj(raw)) return "导入文件不是 JSON 对象";
4128
+ if (!isObj(raw)) return "文件顶层不是 JSON 对象(顶层须是 {\"records\": [...]};若文件本身就是数组,请包成 {\"records\": 数组})";
4029
4129
  if (!Array.isArray(raw.records)) return "records 不是数组(不是 dsh-engram 导出文件?)";
4030
4130
  if (raw.edges !== void 0 && !Array.isArray(raw.edges)) return "edges 不是数组";
4031
4131
  if (raw.entities !== void 0 && !Array.isArray(raw.entities)) return "entities 不是数组";
@@ -4158,35 +4258,135 @@ async function embedImportedRecords(store, embedder, importedIds) {
4158
4258
  return embedded;
4159
4259
  }
4160
4260
  //#endregion
4261
+ //#region src/body-limits.ts
4262
+ /**
4263
+ * 回环 API 的 body 字节上限(服务端与面板共用一份数字)。
4264
+ *
4265
+ * 单列一个模块的原因:上限既要写在服务端路由里,也要写在面板的前置检查里,
4266
+ * 两边各写一份迟早漂移——而漂移的后果是「面板放行、服务端拒收」或反过来,
4267
+ * 用户看到的却是另一句不相干的话。
4268
+ *
4269
+ * 本模块刻意不依赖任何运行时(无 node API、无 DOM API),服务端与浏览器端都能直接内联。
4270
+ *
4271
+ * @module @kenz1117/dsh-engram/body-limits
4272
+ */
4273
+ /** 普通写接口的 body 上限:64 KiB(防坏/恶意 body 拖住 handler)。 */
4274
+ const BODY_LIMIT_BYTES = 65536;
4275
+ /**
4276
+ * 导入接口的 body 上限:16 MiB。
4277
+ * 导入 payload 是整份导出(records + edges + entities),实测导出件动辄上百 KB
4278
+ * (issue #34 的现场导出件是 117 KB 与 165 KB),16 MiB 给足余量同时留住上限。
4279
+ */
4280
+ const IMPORT_BODY_LIMIT_BYTES = 16777216;
4281
+ /** 字节数 → 可读上限文案(上限要能让人一眼看出量级)。 */
4282
+ function formatBytes(bytes) {
4283
+ if (bytes >= 1048576) return `${String(Math.round(bytes / 1024 / 1024))} MB`;
4284
+ if (bytes >= 1024) return `${String(Math.round(bytes / 1024))} KB`;
4285
+ return `${String(bytes)} B`;
4286
+ }
4287
+ //#endregion
4288
+ //#region src/http-body.ts
4289
+ /**
4290
+ * 读取并解析 JSON body。
4291
+ *
4292
+ * 字节口径:限额按 body 的**字节数**算,不是字符数。中文一字 3 字节,按字符算
4293
+ * 会让实际字节上限虚高到 3 倍——等于把防滥用防线悄悄放宽了。
4294
+ *
4295
+ * 解码口径:先攒 Buffer,最后一次性 UTF-8 解码。逐块 `String(chunk)` 会在多字节
4296
+ * 字符跨块边界时被切成两个 U+FFFD——大文件必中招(导出件全是中文)。
4297
+ *
4298
+ * @param req - 请求。
4299
+ * @param limit - 字节上限(默认 64 KiB)。
4300
+ */
4301
+ async function readJsonBody(req, limit = BODY_LIMIT_BYTES) {
4302
+ const declared = Number(req.headers["content-length"]);
4303
+ if (Number.isFinite(declared) && declared > limit) {
4304
+ req.resume();
4305
+ return {
4306
+ ok: false,
4307
+ reason: "too-large",
4308
+ limit
4309
+ };
4310
+ }
4311
+ const chunks = [];
4312
+ let size = 0;
4313
+ let tooLarge = false;
4314
+ await new Promise((resolve, reject) => {
4315
+ let ended = false;
4316
+ req.on("data", (chunk) => {
4317
+ size += chunk.length;
4318
+ if (size > limit) {
4319
+ tooLarge = true;
4320
+ chunks.length = 0;
4321
+ return;
4322
+ }
4323
+ chunks.push(chunk);
4324
+ });
4325
+ req.on("end", () => {
4326
+ ended = true;
4327
+ resolve();
4328
+ });
4329
+ req.on("error", (error) => reject(error));
4330
+ req.on("aborted", () => reject(/* @__PURE__ */ new Error("request aborted")));
4331
+ req.on("close", () => {
4332
+ if (!ended) reject(/* @__PURE__ */ new Error("request closed before end"));
4333
+ });
4334
+ });
4335
+ if (tooLarge) return {
4336
+ ok: false,
4337
+ reason: "too-large",
4338
+ limit
4339
+ };
4340
+ const text = Buffer.concat(chunks).toString("utf8");
4341
+ let parsed;
4342
+ try {
4343
+ parsed = JSON.parse(text === "" ? "{}" : text);
4344
+ } catch (error) {
4345
+ return {
4346
+ ok: false,
4347
+ reason: "malformed",
4348
+ error: error instanceof Error ? error.message : String(error)
4349
+ };
4350
+ }
4351
+ if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) return {
4352
+ ok: false,
4353
+ reason: "not-object"
4354
+ };
4355
+ return {
4356
+ ok: true,
4357
+ body: parsed
4358
+ };
4359
+ }
4360
+ //#endregion
4161
4361
  //#region src/jev/client.ts
4162
4362
  /**
4163
- * 调用 Jev /v1/systemone 端点并行回答 Noul 问题。
4164
- * @param config - 已解析的 Jev 子配置(调用方先判 enabled)。
4165
- * @param state - 待判断的状态文本(如两条记忆正文的对照)。
4166
- * @param questions - Noul 问题列表;空列表直接返回空结果,不发请求。
4167
- * @param signal - 外部取消信号;与配置超时信号合并监听,超时按配置 timeoutMs 兜底。
4168
- * @returns 问题 id → Noul 概率(0-1,数字即信念)。
4169
- * @throws 网络、非 2xx、响应缺 answers、答案缺失或非 0-1 数字时抛错。
4363
+ * Задать Noul-вопросы эндпоинту System One и получить вероятности.
4364
+ * @param connection - собранное соединение (адрес, ключ, модель, тайм-аут).
4365
+ * @param state - текст состояния, по которому идёт суждение (например, две записи рядом).
4366
+ * @param questions - список Noul-вопросов; пустой список возвращает пустой результат без запроса.
4367
+ * @param signal - внешний сигнал отмены; складывается с тайм-аутом из connection.timeoutMs.
4368
+ * @returns идентификатор вопроса → вероятность Noul (0-1; число и есть убеждённость).
4369
+ * @throws при сетевом сбое, не-2xx, отсутствии `answers`, пропуске ответа или не-числе вне 0-1.
4170
4370
  */
4171
- async function askNoul(config, state, questions, signal = new AbortController().signal) {
4371
+ async function askNoul(connection, state, questions, signal = new AbortController().signal) {
4172
4372
  if (questions.length === 0) return {};
4173
- const response = await fetch(new URL("/v1/systemone", config.baseUrl), {
4373
+ const response = await fetch(connection.endpoint, {
4174
4374
  method: "POST",
4175
4375
  headers: {
4176
- Authorization: `Bearer ${config.apiKey ?? ""}`,
4376
+ Authorization: `Bearer ${connection.apiKey}`,
4177
4377
  "Content-Type": "application/json"
4178
4378
  },
4179
4379
  body: JSON.stringify({
4180
- model: config.model,
4380
+ model: connection.model,
4181
4381
  state,
4182
4382
  questions: Object.fromEntries(questions.map((question) => [question.id, {
4183
4383
  type: "noul",
4184
4384
  instructions: question.instructions
4185
4385
  }]))
4186
4386
  }),
4187
- signal: AbortSignal.any([signal, AbortSignal.timeout(config.timeoutMs)])
4387
+ signal: AbortSignal.any([signal, AbortSignal.timeout(connection.timeoutMs)])
4188
4388
  });
4189
- if (!response.ok) throw new Error(`jev: HTTP ${response.status} from ${config.baseUrl}`);
4389
+ if (!response.ok) throw new Error(`jev: HTTP ${response.status} from ${connection.endpoint}`);
4190
4390
  const payload = await response.json();
4191
4391
  if (payload.answers === void 0 || payload.answers === null) throw new Error("jev: response missing answers");
4192
4392
  const result = {};
@@ -4198,27 +4398,52 @@ async function askNoul(config, state, questions, signal = new AbortController().
4198
4398
  return result;
4199
4399
  }
4200
4400
  /**
4201
- * 从已解析配置构建可注入摄取与工具链路的判断器。
4202
- * @param config - 已解析的 Jev 子配置(含三阈值)。
4203
- * @returns MemoryJudge 实现;ask 不接收外部取消信号,仅受配置超时约束。
4204
- */
4205
- function createMemoryJudge(config) {
4401
+ * Собрать судью для конвейеров записи и инструментов из разрешённой конфигурации.
4402
+ *
4403
+ * Реквизиты соединения берутся у хоста лениво — при первом вопросе этого судьи —
4404
+ * и запоминаются на время его жизни: одна операция задаёт десятки вопросов, а
4405
+ * чтение конфигурации провайдера и секрета — это обращения к сервисам хоста.
4406
+ * Помнится только удачная сборка: неудачную следующая попытка повторяет, иначе
4407
+ * разовый сбой сервиса хоста залипал бы на всю жизнь судьи.
4408
+ *
4409
+ * @param config - разрешённая конфигурация Jev (включая три порога).
4410
+ * @param resolveConnection - сборщик соединения из данных хоста; строка = текст ошибки.
4411
+ * @returns реализация MemoryJudge; ask не принимает внешний сигнал отмены, только тайм-аут.
4412
+ */
4413
+ function createMemoryJudge(config, resolveConnection) {
4414
+ let cached;
4415
+ let attempt;
4416
+ const connection = async () => {
4417
+ if (cached !== void 0) return cached;
4418
+ attempt ??= resolveConnection();
4419
+ const resolved = await attempt;
4420
+ attempt = void 0;
4421
+ if (typeof resolved === "string") return resolved;
4422
+ cached = resolved;
4423
+ return resolved;
4424
+ };
4206
4425
  return {
4207
4426
  deferMergeAbove: config.deferMergeAbove,
4208
4427
  deferAcceptBelow: config.deferAcceptBelow,
4209
4428
  contradictMinProbability: config.contradictMinProbability,
4210
- ask: (state, questions) => askNoul(config, state, questions)
4429
+ ask: async (state, questions) => {
4430
+ const resolved = await connection();
4431
+ if (typeof resolved === "string") throw new Error(resolved);
4432
+ return askNoul(resolved, state, questions);
4433
+ }
4211
4434
  };
4212
4435
  }
4213
4436
  /**
4214
- * 连接测试:向端点发一个最小 ping 问题,验证 baseUrl/model/apiKey 三者组合可用。
4215
- * 不抛错——失败原因以 error 字段返回,供面板直接展示。
4216
- * @param config - 待测试的生效配置(enabled 不参与判断;apiKey/baseUrl/model 用调用方给的值)。
4437
+ * Проверка связи: минимальный ping-вопрос на эндпоинт — проверяет, что связка
4438
+ * «провайдер + модель + ключ» рабочая. Она же и есть проверка «модель действительно
4439
+ * Jev»: обычная чат-модель на запрос System One вероятностью не ответит.
4440
+ * Не бросает ошибку — причина возвращается полем error, чтобы панель её показала.
4441
+ * @param connection - проверяемое соединение (вызывающий уже собрал его из данных хоста).
4217
4442
  */
4218
- async function testJevConnection(config) {
4443
+ async function testJevConnection(connection) {
4219
4444
  const startedAt = Date.now();
4220
4445
  try {
4221
- const answers = await askNoul(config, "Connectivity test: this state exists.", [{
4446
+ const answers = await askNoul(connection, "Connectivity test: this state exists.", [{
4222
4447
  id: "ping",
4223
4448
  instructions: "This is a connectivity test. Return any probability between 0 and 1."
4224
4449
  }]);
@@ -4238,19 +4463,310 @@ async function testJevConnection(config) {
4238
4463
  }
4239
4464
  }
4240
4465
  //#endregion
4466
+ //#region src/jev/host.ts
4467
+ /**
4468
+ * Мост к хосту DSH: провайдеры, их модели и ключи живут в одном месте — у хоста.
4469
+ *
4470
+ * Jev не хранит ни токен, ни адрес. Панель выбирает провайдера из числа
4471
+ * **настроенных** в DSH (`ctx.llm.listConfigurableProviders()`, отбор по признаку
4472
+ * `declared`), а реквизиты собираются в момент вызова:
4473
+ * адрес — шаблон от `baseURL` провайдера (можно переопределить в настройках Jev);
4474
+ * ключ — из хранилища секретов по ссылке `apiKeyEnv` (`ctx.credentials.resolve`).
4475
+ *
4476
+ * Шаблон адреса: `{baseURL}/systemone`. Проверено на живом провайдере: при
4477
+ * `baseURL = https://api.aitunnel.ru/v1` эндпоинт `…/v1/systemone` отвечает
4478
+ * корректным Noul-ответом, а прежняя настройка Jev (`https://api.aitunnel.ru`)
4479
+ * давала тот же адрес через свой зашитый путь `/v1/systemone`.
4480
+ *
4481
+ * Почему не через `ctx.llm.stream`: у Jev собственный протокол (state/questions →
4482
+ * вероятности), он не OpenAI-chat-совместим, поэтому HTTP-клиент остаётся свой,
4483
+ * а у хоста берутся только реквизиты — тогда токен вводится ровно в одном месте.
4484
+ *
4485
+ * @module @kenz1117/dsh-engram/jev/host
4486
+ */
4487
+ function asRecord(value) {
4488
+ return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
4489
+ }
4490
+ function readString(record, key) {
4491
+ const value = record?.[key];
4492
+ return typeof value === "string" && value !== "" ? value : void 0;
4493
+ }
4494
+ function readBoolean(record, key) {
4495
+ const value = record?.[key];
4496
+ return typeof value === "boolean" ? value : void 0;
4497
+ }
4498
+ /** Пройти по пути вида `['providers', 'aitunnel']` внутри конфигурации плагина хоста. */
4499
+ function readPath(root, path) {
4500
+ let current = root;
4501
+ for (const segment of path) {
4502
+ const record = asRecord(current);
4503
+ if (record === void 0) return void 0;
4504
+ current = record[segment];
4505
+ }
4506
+ return current;
4507
+ }
4508
+ /** Модели из конфигурации провайдера: `[{id, name}]`; битые записи пропускаем. */
4509
+ function readModels(profile) {
4510
+ const models = profile?.["models"];
4511
+ if (!Array.isArray(models)) return [];
4512
+ const result = [];
4513
+ for (const entry of models) {
4514
+ const record = asRecord(entry);
4515
+ const id = readString(record, "id");
4516
+ if (id === void 0) continue;
4517
+ result.push({
4518
+ id,
4519
+ name: readString(record, "name") ?? id
4520
+ });
4521
+ }
4522
+ return result;
4523
+ }
4524
+ /** Собрать адрес из корня и относительного пути, не теряя уже имеющийся `/`. */
4525
+ function joinUrl(base, relative) {
4526
+ try {
4527
+ return new URL(relative, base.endsWith("/") ? base : `${base}/`).toString();
4528
+ } catch {
4529
+ return;
4530
+ }
4531
+ }
4532
+ /**
4533
+ * Шаблон адреса System One от корня API провайдера.
4534
+ * `https://api.aitunnel.ru/v1` → `https://api.aitunnel.ru/v1/systemone`
4535
+ * (системный путь — сосед `/chat/completions` в том же корне API).
4536
+ */
4537
+ function systemOneEndpoint(baseUrl) {
4538
+ return joinUrl(baseUrl, "systemone");
4539
+ }
4540
+ /** Дескриптор конфигурации хоста по namespace (например `llm-pi-ai`). */
4541
+ async function readSettingsValue(ctx, ns) {
4542
+ const settings = ctx.get("settings");
4543
+ if (settings?.describe === void 0) return void 0;
4544
+ try {
4545
+ const descriptors = await settings.describe();
4546
+ for (const descriptor of descriptors) if (descriptor.ns === ns) return descriptor.value;
4547
+ } catch {
4548
+ return;
4549
+ }
4550
+ }
4551
+ /** Конфигурация провайдера: подпись, `baseURL`, ссылка на ключ и модели. */
4552
+ async function readProviderProfile(ctx, providerId) {
4553
+ const entry = (ctx.get("llm")?.listConfigurableProviders?.() ?? []).find((candidate) => candidate.provider === providerId);
4554
+ if (entry === void 0) return void 0;
4555
+ const ns = typeof entry.settingsNs === "string" ? entry.settingsNs : void 0;
4556
+ if (ns === void 0) return void 0;
4557
+ const path = Array.isArray(entry.settingsPath) ? entry.settingsPath.filter((segment) => typeof segment === "string") : [];
4558
+ const value = await readSettingsValue(ctx, ns);
4559
+ if (value === void 0) return void 0;
4560
+ return asRecord(readPath(value, path.length > 0 ? path : ["providers", providerId]));
4561
+ }
4562
+ /** Ключ провайдера из хранилища секретов хоста по ссылке `apiKeyEnv`. */
4563
+ async function readProviderKey(ctx, profile) {
4564
+ const apiKeyEnv = readString(profile, "apiKeyEnv");
4565
+ if (apiKeyEnv === void 0) return "";
4566
+ const credentials = ctx.get("credentials");
4567
+ if (credentials?.resolve === void 0) return "";
4568
+ try {
4569
+ const value = (await credentials.resolve(apiKeyEnv))?.value;
4570
+ return typeof value === "string" ? value : "";
4571
+ } catch {
4572
+ return "";
4573
+ }
4574
+ }
4575
+ async function readProviderRekvisites(ctx, providerId) {
4576
+ if (ctx.get("llm") === void 0) return message("misc.jevHostLlmUnavailable");
4577
+ const profile = await readProviderProfile(ctx, providerId);
4578
+ if (profile === void 0) return message("misc.jevProviderNotConfigured", { provider: providerId });
4579
+ return {
4580
+ baseUrl: readString(profile, "baseURL"),
4581
+ apiKey: await readProviderKey(ctx, profile),
4582
+ apiKeyEnv: readString(profile, "apiKeyEnv"),
4583
+ modelIds: readModels(profile).map((item) => item.id)
4584
+ };
4585
+ }
4586
+ /**
4587
+ * Каталог для панели: только провайдеры, настроенные в DSH, с шаблоном адреса
4588
+ * и моделями из настроек (без обращения к сети — живой список берётся отдельно).
4589
+ *
4590
+ * Реестр хоста отдаёт и весь встроенный каталог pi-ai (anthropic, openai, google
4591
+ * и ещё три десятка видов) — их пользователь не настраивал, и в выпадающем списке
4592
+ * Jev им делать нечего. Признак «свой» хост сообщает сам: `declared = true`
4593
+ * у провайдера, объявленного в настройках, и `false` — у взятого из каталога
4594
+ * (функция `directoryEntries` в `dsh-llm-pi-ai`; там же видно, что объявленные
4595
+ * идут в конце списка, после встроенных).
4596
+ *
4597
+ * @param ctx - контекст плагина (доступ к сервисам хоста по имени).
4598
+ * @returns настроенные провайдеры с моделями; пустой список, если хост не отдал ничего.
4599
+ */
4600
+ async function readJevCatalog(ctx) {
4601
+ const llm = ctx.get("llm");
4602
+ const configurable = llm?.listConfigurableProviders?.() ?? [];
4603
+ const declared = [];
4604
+ const withProfile = [];
4605
+ const every = [];
4606
+ for (const entry of configurable) {
4607
+ const id = typeof entry.provider === "string" ? entry.provider : void 0;
4608
+ if (id === void 0) continue;
4609
+ const profile = await readProviderProfile(ctx, id);
4610
+ const baseUrl = readString(profile, "baseURL");
4611
+ const item = {
4612
+ id,
4613
+ displayName: readString(asRecord(entry), "displayName") ?? readString(profile, "displayName") ?? id,
4614
+ baseUrl,
4615
+ endpoint: baseUrl === void 0 ? void 0 : systemOneEndpoint(baseUrl),
4616
+ models: readModels(profile)
4617
+ };
4618
+ every.push(item);
4619
+ if (profile !== void 0) withProfile.push(item);
4620
+ const flag = readBoolean(asRecord(entry), "declared");
4621
+ if (flag === true || flag === void 0 && profile !== void 0) declared.push(item);
4622
+ }
4623
+ if (declared.length > 0) return { providers: declared };
4624
+ if (withProfile.length > 0) return { providers: withProfile };
4625
+ if (every.length > 0) return { providers: every };
4626
+ const providers = [];
4627
+ for (const route of llm?.listProviders?.() ?? []) {
4628
+ const id = readString(route, "id");
4629
+ if (id === void 0) continue;
4630
+ providers.push({
4631
+ id,
4632
+ displayName: readString(route, "name") ?? id,
4633
+ baseUrl: void 0,
4634
+ endpoint: void 0,
4635
+ models: []
4636
+ });
4637
+ }
4638
+ return { providers };
4639
+ }
4640
+ /**
4641
+ * Живой список моделей провайдера: `GET {baseURL}/models` тем же ключом, что и
4642
+ * судейство. Список сужается до Jev-моделей — панель предлагает только то, что
4643
+ * может отвечать протоколом System One.
4644
+ *
4645
+ * Если Jev-моделей у провайдера не нашлось, не предлагается ничего: остальные его
4646
+ * модели этого протокола не понимают, и подсказка из них была бы подсказкой сломать
4647
+ * судью. Имя в таком случае вписывают руками — поле принимает любое.
4648
+ * Ничего не бросает: причина отказа возвращается полем error.
4649
+ * @param ctx - контекст плагина.
4650
+ * @param providerId - выбранный провайдер DSH.
4651
+ */
4652
+ async function readProviderModels(ctx, providerId) {
4653
+ const rekvisites = await readProviderRekvisites(ctx, providerId);
4654
+ if (typeof rekvisites === "string") return {
4655
+ models: [],
4656
+ filtered: false,
4657
+ error: rekvisites
4658
+ };
4659
+ if (rekvisites.baseUrl === void 0) return {
4660
+ models: [],
4661
+ filtered: false,
4662
+ error: message("misc.jevProviderHasNoBaseUrl", { provider: providerId })
4663
+ };
4664
+ if (rekvisites.apiKey === "") return {
4665
+ models: [],
4666
+ filtered: false,
4667
+ error: message("misc.jevProviderKeyMissing", {
4668
+ provider: providerId,
4669
+ ref: rekvisites.apiKeyEnv ?? ""
4670
+ })
4671
+ };
4672
+ const url = joinUrl(rekvisites.baseUrl, "models");
4673
+ if (url === void 0) return {
4674
+ models: [],
4675
+ filtered: false,
4676
+ error: message("misc.jevProviderHasNoBaseUrl", { provider: providerId })
4677
+ };
4678
+ try {
4679
+ const response = await fetch(url, {
4680
+ headers: { Authorization: `Bearer ${rekvisites.apiKey}` },
4681
+ signal: AbortSignal.timeout(1e4)
4682
+ });
4683
+ if (!response.ok) return {
4684
+ models: [],
4685
+ filtered: false,
4686
+ error: `HTTP ${response.status}`
4687
+ };
4688
+ const payload = await response.json();
4689
+ const ids = [];
4690
+ if (Array.isArray(payload.data)) for (const entry of payload.data) {
4691
+ const id = readString(asRecord(entry), "id");
4692
+ if (id !== void 0) ids.push(id);
4693
+ }
4694
+ ids.sort((left, right) => left.localeCompare(right));
4695
+ return {
4696
+ models: ids.filter((id) => /jev/i.test(id)),
4697
+ filtered: true,
4698
+ error: void 0
4699
+ };
4700
+ } catch (error) {
4701
+ return {
4702
+ models: [],
4703
+ filtered: false,
4704
+ error: error instanceof Error ? error.message : String(error)
4705
+ };
4706
+ }
4707
+ }
4708
+ /**
4709
+ * Собрать соединение Jev: адрес — из настроек Jev либо шаблоном от провайдера,
4710
+ * ключ — из хранилища секретов по ссылке `apiKeyEnv`, модель — из настроек Jev
4711
+ * либо первая Jev-модель провайдера.
4712
+ * @param ctx - контекст плагина.
4713
+ * @param providerId - выбранный провайдер DSH; пусто = провайдера не назвал никто.
4714
+ * @param model - выбранная модель; пусто = взять Jev-модель провайдера.
4715
+ * @param timeoutMs - тайм-аут одного запроса.
4716
+ * @param endpointOverride - адрес из настроек Jev; пусто = взять шаблон от провайдера.
4717
+ * @returns соединение либо текст ошибки (как в `parseJevPatch`).
4718
+ */
4719
+ async function resolveJevConnection(ctx, providerId, model, timeoutMs, endpointOverride) {
4720
+ if (providerId.trim() === "") return message("misc.jevProviderUnresolved");
4721
+ const rekvisites = await readProviderRekvisites(ctx, providerId);
4722
+ if (typeof rekvisites === "string") return rekvisites;
4723
+ const chosenModel = model.trim() !== "" ? model.trim() : pickJevModel(rekvisites.modelIds);
4724
+ if (chosenModel === void 0) return message("misc.jevModelNotPicked", { provider: providerId });
4725
+ const endpoint = (endpointOverride !== void 0 && endpointOverride.trim() !== "" ? endpointOverride.trim() : void 0) ?? (rekvisites.baseUrl === void 0 ? void 0 : systemOneEndpoint(rekvisites.baseUrl));
4726
+ if (endpoint === void 0) return message("misc.jevProviderHasNoBaseUrl", { provider: providerId });
4727
+ if (rekvisites.apiKey === "") return message("misc.jevProviderKeyMissing", {
4728
+ provider: providerId,
4729
+ ref: rekvisites.apiKeyEnv ?? ""
4730
+ });
4731
+ return {
4732
+ endpoint,
4733
+ apiKey: rekvisites.apiKey,
4734
+ model: chosenModel,
4735
+ timeoutMs
4736
+ };
4737
+ }
4738
+ /**
4739
+ * Первая Jev-модель из настроек провайдера — замена пустому полю модели.
4740
+ * Порядок не пересортировываем: он задан пользователем в настройках DSH, и выбранной
4741
+ * должна стать та модель, которую он поставил выше.
4742
+ * @param modelIds - модели провайдера из его настроек в DSH.
4743
+ * @returns имя модели либо `undefined`, если Jev-моделей у провайдера нет.
4744
+ */
4745
+ function pickJevModel(modelIds) {
4746
+ return modelIds.find((id) => /jev/i.test(id));
4747
+ }
4748
+ //#endregion
4241
4749
  //#region src/jev/runtime.ts
4242
4750
  /**
4243
- * Jev 连接配置的运行时覆盖:管理面板保存到 `<dbDir>/jev-config.json`(0600),
4244
- * 字段级覆盖 cordis.yml 的 jev 子配置;装配免缓存——judge 构造是无状态闭包、
4245
- * 覆盖文件是小读,每个装配点即时解析,面板保存后立即生效。
4246
- * 覆盖文件损坏按空覆盖处理:不卡启动,面板重新保存即修复。
4751
+ * Настройки Jev, задаваемые из панели: сохраняются в `<dbDir>/jev-config.json` (0600)
4752
+ * и пофайлово перекрывают подконфигурацию `jev` из cordis.yml.
4753
+ *
4754
+ * Здесь хранится только то, что действительно относится к Jev: включён ли он,
4755
+ * какой провайдер DSH и какая его модель выбраны, тайм-аут. Ни адреса, ни токена
4756
+ * тут нет и быть не должно — их берёт у хоста мост `./host.ts` в момент вызова,
4757
+ * поэтому провайдеры и ключи вводятся ровно в одном месте, у хоста.
4758
+ *
4759
+ * Сборка судьи не кэшируется: конструктор — это замыкание без состояния, а файл
4760
+ * настроек читается мелко, поэтому каждая точка сборки разрешает его заново и
4761
+ * сохранение в панели действует сразу. Битый файл настроек считается пустым
4762
+ * перекрытием: запуск не блокируется, панель перезапишет файл при сохранении.
4247
4763
  * @module @kenz1117/dsh-engram/jev/runtime
4248
4764
  */
4249
- /** 覆盖文件路径(dbDir 已 0700,文件本身 0600 双保险)。 */
4765
+ /** Путь к файлу перекрытия (каталог уже 0700, сам файл — 0600, двойная защита). */
4250
4766
  function jevOverridePath(dbDir) {
4251
4767
  return `${dbDir}/jev-config.json`;
4252
4768
  }
4253
- /** 读覆盖文件:缺失/损坏/非法 JSON 都按空覆盖(面板重新保存即修复)。 */
4769
+ /** Прочитать перекрытие: нет файла, битый JSON или мусор — всё считается пустым перекрытием. */
4254
4770
  function loadJevOverride(dbDir) {
4255
4771
  let raw;
4256
4772
  try {
@@ -4264,28 +4780,35 @@ function loadJevOverride(dbDir) {
4264
4780
  return {};
4265
4781
  }
4266
4782
  }
4267
- /** 收敛未知 JSON 为覆盖对象:只认五个已知字段,类型不符的丢弃。 */
4783
+ /**
4784
+ * Свести произвольный JSON к перекрытию: известны четыре поля, остальное отбрасывается.
4785
+ * Поля прежнего формата (`apiKey`, `baseUrl`) намеренно не читаются: ключ и адрес
4786
+ * больше не хранятся у Jev, их место занял выбор провайдера у хоста.
4787
+ */
4268
4788
  function collectOverride(value) {
4269
4789
  if (value === null || typeof value !== "object") return {};
4270
4790
  const raw = value;
4791
+ const legacy = legacyJevFields(raw);
4792
+ if (legacy.length > 0) noteLegacyJevFields("jev-config.json", legacy);
4271
4793
  return {
4272
4794
  ...typeof raw["enabled"] === "boolean" ? { enabled: raw["enabled"] } : {},
4273
- ...typeof raw["apiKey"] === "string" ? { apiKey: raw["apiKey"] } : {},
4274
- ...typeof raw["baseUrl"] === "string" ? { baseUrl: raw["baseUrl"] } : {},
4275
- ...typeof raw["model"] === "string" ? { model: raw["model"] } : {},
4795
+ ...typeof raw["provider"] === "string" && raw["provider"] !== "" ? { provider: raw["provider"] } : {},
4796
+ ...typeof raw["model"] === "string" && raw["model"] !== "" ? { model: raw["model"] } : {},
4797
+ ...typeof raw["endpoint"] === "string" && raw["endpoint"] !== "" ? { endpoint: raw["endpoint"] } : {},
4276
4798
  ...typeof raw["timeoutMs"] === "number" && Number.isInteger(raw["timeoutMs"]) ? { timeoutMs: raw["timeoutMs"] } : {}
4277
4799
  };
4278
4800
  }
4279
- /** 全量保存覆盖文件(调用方先经 parseJevPatch 校验;内容为面板合并后的完整覆盖)。 */
4801
+ /** Записать перекрытие целиком (вызывающий уже проверил его через `parseJevPatch`). */
4280
4802
  function saveJevOverride(dbDir, override) {
4281
4803
  writeFileSync(jevOverridePath(dbDir), `${JSON.stringify(override, null, 2)}\n`, { mode: 384 });
4282
4804
  }
4283
4805
  /**
4284
- * 面板 patch 解析:只认已知字段并逐个校验,出现非法值整体拒绝。
4285
- * `apiKey: ''` 表示清除面板密钥覆盖(回落 yml);缺席的字段保留 current。
4286
- * @param current - 现有覆盖(合并底座)。
4287
- * @param patch - POST body 原始对象。
4288
- * @returns 合法时返回合并后的完整覆盖;非法时返回 `invalid:` 前缀的字段错误文案。
4806
+ * Разобрать правку из панели: известные поля проверяются по одному, при любой
4807
+ * негодности отвергается вся правка. `provider: ''` очищает выбор провайдера
4808
+ * (Jev при этом молча уходит в чистые правила); отсутствующее поле сохраняет текущее.
4809
+ * @param current - текущее перекрытие (основа слияния).
4810
+ * @param patch - сырой объект из тела POST.
4811
+ * @returns при годности — слитое перекрытие целиком; иначе текст ошибки с префиксом `invalid:`.
4289
4812
  */
4290
4813
  function parseJevPatch(current, patch) {
4291
4814
  const merged = { ...current };
@@ -4293,26 +4816,32 @@ function parseJevPatch(current, patch) {
4293
4816
  if (typeof patch["enabled"] !== "boolean") return message("misc.jevEnabledMustBeBoolean");
4294
4817
  merged.enabled = patch["enabled"];
4295
4818
  }
4296
- if (patch["apiKey"] !== void 0) {
4297
- if (typeof patch["apiKey"] !== "string") return message("misc.jevApiKeyMustBeString");
4298
- const trimmed = patch["apiKey"].trim();
4299
- if (trimmed === "") delete merged.apiKey;
4300
- else merged.apiKey = trimmed;
4301
- }
4302
- if (patch["baseUrl"] !== void 0) {
4303
- if (typeof patch["baseUrl"] !== "string") return message("misc.jevBaseUrlMustBeString");
4304
- const value = patch["baseUrl"].trim();
4305
- try {
4306
- const url = new URL(value);
4307
- if (url.protocol !== "https:" && url.protocol !== "http:") return message("misc.jevBaseUrlMustBeHttp");
4308
- } catch {
4309
- return message("misc.jevBaseUrlMustBeHttp");
4310
- }
4311
- merged.baseUrl = value;
4819
+ if (patch["provider"] !== void 0) {
4820
+ if (typeof patch["provider"] !== "string") return message("misc.jevProviderMustBeString");
4821
+ const trimmed = patch["provider"].trim();
4822
+ if (trimmed === "") delete merged.provider;
4823
+ else merged.provider = trimmed;
4312
4824
  }
4313
4825
  if (patch["model"] !== void 0) {
4314
- if (typeof patch["model"] !== "string" || patch["model"].trim() === "") return message("misc.jevModelMustNotBeEmpty");
4315
- merged.model = patch["model"].trim();
4826
+ if (typeof patch["model"] !== "string") return message("misc.jevModelMustNotBeEmpty");
4827
+ const trimmed = patch["model"].trim();
4828
+ if (trimmed === "") delete merged.model;
4829
+ else merged.model = trimmed;
4830
+ }
4831
+ if (patch["endpoint"] !== void 0) {
4832
+ if (typeof patch["endpoint"] !== "string") return message("misc.jevEndpointMustBeHttp");
4833
+ const trimmed = patch["endpoint"].trim();
4834
+ if (trimmed === "") delete merged.endpoint;
4835
+ else {
4836
+ let scheme = "";
4837
+ try {
4838
+ scheme = new URL(trimmed).protocol;
4839
+ } catch {
4840
+ scheme = "";
4841
+ }
4842
+ if (scheme !== "http:" && scheme !== "https:") return message("misc.jevEndpointMustBeHttp");
4843
+ merged.endpoint = trimmed;
4844
+ }
4316
4845
  }
4317
4846
  if (patch["timeoutMs"] !== void 0) {
4318
4847
  const value = patch["timeoutMs"];
@@ -4322,36 +4851,41 @@ function parseJevPatch(current, patch) {
4322
4851
  return merged;
4323
4852
  }
4324
4853
  /**
4325
- * 面板覆盖与 yml 基线的字段级合并;合并后 enabled=true 但无密钥时强制降级
4326
- * enabled=false(与 Jev 不可用静默降级语义一致,不卡启动)。
4854
+ * Непустое значение либо `undefined`: пустая строка означает «поле не названо»,
4855
+ * а не «названо пустым». Без этого шага очищенное поле панели затирало бы значение
4856
+ * из cordis.yml вместо того, чтобы уступить ему место.
4857
+ */
4858
+ function named(value) {
4859
+ return value !== void 0 && value !== "" ? value : void 0;
4860
+ }
4861
+ /**
4862
+ * Слить перекрытие панели с базой из cordis.yml по полям.
4863
+ *
4864
+ * Провайдер и модель вправе остаться неназванными: провайдера тогда подставит ленивый
4865
+ * резолвер соединения (маршрут текущей сессии), а модель — первая Jev-модель этого
4866
+ * провайдера. Поэтому `enabled` здесь означает только «пользователь включил Jev»:
4867
+ * снимать его заранее значило бы терять наследование, которое видно лишь в момент вопроса.
4327
4868
  */
4328
4869
  function effectiveJevConfig(base, override) {
4329
- const apiKey = override.apiKey ?? base.apiKey;
4330
- const enabled = (override.enabled ?? base.enabled) && apiKey !== void 0 && apiKey !== "";
4331
4870
  return {
4332
- enabled,
4333
- apiKey: enabled ? apiKey : void 0,
4334
- baseUrl: override.baseUrl ?? base.baseUrl,
4335
- model: override.model ?? base.model,
4871
+ enabled: override.enabled ?? base.enabled,
4872
+ provider: named(override.provider) ?? named(base.provider),
4873
+ model: named(override.model) ?? named(base.model),
4874
+ endpoint: override.endpoint ?? base.endpoint,
4336
4875
  timeoutMs: override.timeoutMs ?? base.timeoutMs,
4337
4876
  deferMergeAbove: base.deferMergeAbove,
4338
4877
  deferAcceptBelow: base.deferAcceptBelow,
4339
4878
  contradictMinProbability: base.contradictMinProbability
4340
4879
  };
4341
4880
  }
4342
- /** 密钥掩码:长度 > 8 显示尾 4 位,其余全掩码。 */
4343
- function maskApiKey(key) {
4344
- return key.length > 8 ? `****${key.slice(-4)}` : "******";
4345
- }
4346
- /** 组装面板视图:基于生效配置;掩码取合并后的密钥。 */
4881
+ /** Собрать вид для панели по действующей конфигурации. */
4347
4882
  function jevConfigView(base, override) {
4348
4883
  const config = effectiveJevConfig(base, override);
4349
4884
  return {
4350
4885
  enabled: config.enabled,
4351
- apiKeySet: config.apiKey !== void 0 && config.apiKey !== "",
4352
- apiKeyMask: config.apiKey === void 0 || config.apiKey === "" ? null : maskApiKey(config.apiKey),
4353
- baseUrl: config.baseUrl,
4886
+ provider: config.provider,
4354
4887
  model: config.model,
4888
+ endpoint: config.endpoint,
4355
4889
  timeoutMs: config.timeoutMs,
4356
4890
  deferMergeAbove: config.deferMergeAbove,
4357
4891
  deferAcceptBelow: config.deferAcceptBelow,
@@ -4359,14 +4893,34 @@ function jevConfigView(base, override) {
4359
4893
  };
4360
4894
  }
4361
4895
  /**
4362
- * 统一装配函数:读面板覆盖、合并 yml 基线,enabled 时产出 judge,否则返回空对象。
4363
- * 产出形状可直接条件展开进摄取/工具/末轮/回填四类依赖(`...resolveJevField(resolved.jev, dbDir)`)。
4364
- * 免缓存:judge 构造是无状态闭包、覆盖文件是小读,每次调用即时解析,面板保存立即生效。
4365
- */
4366
- function resolveJevField(base, dbDir) {
4367
- const config = effectiveJevConfig(base, loadJevOverride(dbDir));
4368
- if (!config.enabled || config.apiKey === void 0 || config.apiKey === "") return {};
4369
- return { judge: createMemoryJudge(config) };
4896
+ * Единая точка сборки: отдать поставщика судьи Jev — функцию, которая собирает судью
4897
+ * в момент операции. Результат раскладывается в зависимости четырёх видов
4898
+ * (запись, инструменты, последний ход, догрузка истории).
4899
+ *
4900
+ * Поставщик читает перекрытие панели и базу cordis.yml при каждом вызове, а реквизиты
4901
+ * соединения резолвятся ещё позже — при первом вопросе судьи, где и доопределяются
4902
+ * провайдер и модель, которых не назвал никто. Поэтому включение Jev и смена провайдера,
4903
+ * модели или адреса в панели действуют без перезапуска, а не только при загрузке плагина.
4904
+ * Три порога задаются лишь в cordis.yml и меняются с перезапуском.
4905
+ * @param ctx - контекст плагина (доступ к сервисам хоста: llm, settings, credentials).
4906
+ * @param base - база из cordis.yml.
4907
+ * @param dbDir - каталог данных (там лежит файл перекрытия).
4908
+ * @param routeProvider - провайдер текущей сессии: подставляется, только если его не
4909
+ * назвали ни панель, ни cordis.yml. Читается в момент вопроса, поэтому смена
4910
+ * маршрута посреди сессии подхватывается сама.
4911
+ */
4912
+ function resolveJevField(ctx, base, dbDir, routeProvider) {
4913
+ return { resolveJudge: () => {
4914
+ const config = effectiveJevConfig(base, loadJevOverride(dbDir));
4915
+ if (!config.enabled) return void 0;
4916
+ const configured = config.provider;
4917
+ const model = config.model ?? "";
4918
+ const endpoint = config.endpoint;
4919
+ const timeoutMs = config.timeoutMs;
4920
+ return createMemoryJudge(config, () => {
4921
+ return resolveJevConnection(ctx, configured !== void 0 && configured !== "" ? configured : routeProvider?.() ?? "", model, timeoutMs, endpoint);
4922
+ });
4923
+ } };
4370
4924
  }
4371
4925
  //#endregion
4372
4926
  //#region src/mirror/markdown.ts
@@ -5083,24 +5637,33 @@ function guardWrite(req, res) {
5083
5637
  }
5084
5638
  return true;
5085
5639
  }
5086
- /** 读取并解析 JSON body(上限 64 KiB,防坏/恶意 body 拖住 handler)。 */
5087
- async function readJsonBody(req) {
5088
- let body = "";
5089
- for await (const chunk of req) {
5090
- body += String(chunk);
5091
- if (body.length > 65536) return null;
5092
- }
5093
- try {
5094
- const parsed = JSON.parse(body === "" ? "{}" : body);
5095
- return parsed !== null && typeof parsed === "object" ? parsed : null;
5096
- } catch {
5097
- return null;
5098
- }
5099
- }
5100
5640
  function json(res, status, body) {
5101
5641
  res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
5102
5642
  res.end(JSON.stringify(body));
5103
5643
  }
5644
+ /**
5645
+ * 读 JSON body,并把失败原因说清楚:超限 413、坏 JSON 400、不是对象 400。
5646
+ *
5647
+ * 为什么不给「宽容降级成空对象」:那样超限/坏 body 会掉进字段校验,报成
5648
+ * 「id required」「archivePath required」——把服务端的锅甩给调用方(#34 的同款毛病)。
5649
+ * 机器已经能分辨三种原因,就别再合成一句话。
5650
+ *
5651
+ * @returns body;返回 null = 已写好错误响应,调用方直接 return。
5652
+ */
5653
+ async function readBody(req, res, language) {
5654
+ const result = await readJsonBody(req);
5655
+ if (result.ok) return result.body;
5656
+ if (result.reason === "too-large") {
5657
+ json(res, 413, { error: messageIn(language, "misc.bodyTooLarge", { limit: formatBytes(result.limit) }) });
5658
+ return null;
5659
+ }
5660
+ if (result.reason === "malformed") {
5661
+ json(res, 400, { error: messageIn(language, "misc.bodyMalformed", { error: result.error }) });
5662
+ return null;
5663
+ }
5664
+ json(res, 400, { error: messageIn(language, "misc.bodyNotObject") });
5665
+ return null;
5666
+ }
5104
5667
  /** 从 URL searchParams 收敛 scope(缺省 user)。 */
5105
5668
  function scopeOf$1(raw, fallback) {
5106
5669
  if (raw === "user" || raw === "project" || raw === "shared") return raw;
@@ -5445,8 +6008,9 @@ function registerEngramRoutes(ctx, deps) {
5445
6008
  }
5446
6009
  if (req.method === "POST" && route === "review-answer") {
5447
6010
  if (!guardWrite(req, res)) return;
5448
- const body = await readJsonBody(req);
5449
- if (body === null || typeof body.id !== "string" || body.id === "") {
6011
+ const body = await readBody(req, res, deps.language);
6012
+ if (body === null) return;
6013
+ if (typeof body.id !== "string" || body.id === "") {
5450
6014
  json(res, 400, { error: "id required" });
5451
6015
  return;
5452
6016
  }
@@ -5508,27 +6072,6 @@ function registerEngramRoutes(ctx, deps) {
5508
6072
  });
5509
6073
  return;
5510
6074
  }
5511
- if (req.method === "POST" && route === "review-answer") {
5512
- if (!guardWrite(req, res)) return;
5513
- const body = await readJsonBody(req);
5514
- if (body === null || typeof body.id !== "string" || body.id === "") {
5515
- json(res, 400, { error: "id required" });
5516
- return;
5517
- }
5518
- const grade = Number(body.grade);
5519
- if (!Number.isInteger(grade) || grade < 0 || grade > 5) {
5520
- json(res, 400, { error: "grade must be an integer 0-5" });
5521
- return;
5522
- }
5523
- adoptBodySelector(body);
5524
- const record = await (await storeFor(scopeOf$1(typeof body.scope === "string" ? body.scope : null, "user"))).scheduleReview(body.id, grade);
5525
- if (record === void 0) {
5526
- json(res, 404, { error: messageIn(deps.language, "misc.recordNotFound", { id: body.id }) });
5527
- return;
5528
- }
5529
- json(res, 200, { record });
5530
- return;
5531
- }
5532
6075
  if (req.method === "GET" && route === "export") {
5533
6076
  const scope = scopeOf$1(url.searchParams.get("scope"), "user");
5534
6077
  const format = url.searchParams.get("format") === "json" ? "json" : "markdown";
@@ -5558,8 +6101,20 @@ function registerEngramRoutes(ctx, deps) {
5558
6101
  }
5559
6102
  if (req.method === "POST" && route === "import") {
5560
6103
  if (!guardWrite(req, res)) return;
5561
- const body = await readJsonBody(req);
5562
- const bodyObj = typeof body === "object" && body !== null && !Array.isArray(body) ? body : {};
6104
+ const bodyResult = await readJsonBody(req, IMPORT_BODY_LIMIT_BYTES);
6105
+ if (!bodyResult.ok) {
6106
+ if (bodyResult.reason === "too-large") {
6107
+ json(res, 413, { error: messageIn(deps.language, "misc.importBodyTooLarge", { limit: formatBytes(bodyResult.limit) }) });
6108
+ return;
6109
+ }
6110
+ if (bodyResult.reason === "malformed") {
6111
+ json(res, 400, { error: messageIn(deps.language, "misc.importBodyMalformed", { error: bodyResult.error }) });
6112
+ return;
6113
+ }
6114
+ json(res, 400, { error: messageIn(deps.language, "misc.importBodyNotObject") });
6115
+ return;
6116
+ }
6117
+ const bodyObj = bodyResult.body;
5563
6118
  const scope = scopeOf$1(typeof bodyObj.scope === "string" ? bodyObj.scope : null, "user");
5564
6119
  let data;
5565
6120
  let redacted = false;
@@ -5791,8 +6346,9 @@ function registerEngramRoutes(ctx, deps) {
5791
6346
  }
5792
6347
  if (req.method === "POST" && route === "history-backfill/start") {
5793
6348
  if (!guardWrite(req, res)) return;
5794
- const body = await readJsonBody(req);
5795
- const started = deps.history.start(historyRulesOf(body ?? {}));
6349
+ const body = await readBody(req, res, deps.language);
6350
+ if (body === null) return;
6351
+ const started = deps.history.start(historyRulesOf(body));
5796
6352
  if (!started.ok) {
5797
6353
  json(res, 409, {
5798
6354
  ok: false,
@@ -5816,33 +6372,77 @@ function registerEngramRoutes(ctx, deps) {
5816
6372
  return;
5817
6373
  }
5818
6374
  if (req.method === "GET" && route === "jev-config") {
5819
- json(res, 200, jevConfigView(deps.jev.base, loadJevOverride(deps.jev.dbDir)));
6375
+ const catalog = await deps.jev.host.catalog();
6376
+ json(res, 200, {
6377
+ ...jevConfigView(deps.jev.base, loadJevOverride(deps.jev.dbDir)),
6378
+ providers: catalog.providers
6379
+ });
5820
6380
  return;
5821
6381
  }
5822
6382
  if (req.method === "POST" && route === "jev-config") {
5823
6383
  if (!guardWrite(req, res)) return;
5824
- const body = await readJsonBody(req);
5825
- const parsed = parseJevPatch(loadJevOverride(deps.jev.dbDir), body ?? {});
6384
+ const body = await readBody(req, res, deps.language);
6385
+ if (body === null) return;
6386
+ const parsed = parseJevPatch(loadJevOverride(deps.jev.dbDir), body);
5826
6387
  if (typeof parsed === "string") {
5827
6388
  json(res, 400, { error: parsed });
5828
6389
  return;
5829
6390
  }
5830
6391
  saveJevOverride(deps.jev.dbDir, parsed);
6392
+ const catalog = await deps.jev.host.catalog();
5831
6393
  json(res, 200, {
5832
6394
  ok: true,
5833
- view: jevConfigView(deps.jev.base, parsed)
6395
+ view: {
6396
+ ...jevConfigView(deps.jev.base, parsed),
6397
+ providers: catalog.providers
6398
+ }
5834
6399
  });
5835
6400
  return;
5836
6401
  }
5837
6402
  if (req.method === "POST" && route === "jev-test") {
5838
6403
  if (!guardWrite(req, res)) return;
5839
- const body = await readJsonBody(req);
5840
- json(res, 200, await testJevConnection({
5841
- ...effectiveJevConfig(deps.jev.base, loadJevOverride(deps.jev.dbDir)),
5842
- ...typeof body?.baseUrl === "string" && body.baseUrl.trim() !== "" ? { baseUrl: body.baseUrl.trim() } : {},
5843
- ...typeof body?.model === "string" && body.model.trim() !== "" ? { model: body.model.trim() } : {},
5844
- ...typeof body?.apiKey === "string" && body.apiKey !== "" ? { apiKey: body.apiKey } : {}
5845
- }));
6404
+ const body = await readBody(req, res, deps.language);
6405
+ if (body === null) return;
6406
+ const base = effectiveJevConfig(deps.jev.base, loadJevOverride(deps.jev.dbDir));
6407
+ const provider = typeof body.provider === "string" && body.provider.trim() !== "" ? body.provider.trim() : base.provider;
6408
+ const model = typeof body.model === "string" && body.model.trim() !== "" ? body.model.trim() : base.model;
6409
+ const endpoint = typeof body.endpoint === "string" && body.endpoint.trim() !== "" ? body.endpoint.trim() : base.endpoint;
6410
+ if (provider === void 0 || model === void 0) {
6411
+ json(res, 200, {
6412
+ ok: false,
6413
+ elapsedMs: 0,
6414
+ probability: void 0,
6415
+ error: message("misc.jevProviderMustBeSelected")
6416
+ });
6417
+ return;
6418
+ }
6419
+ const connection = await deps.jev.host.connection(provider, model, base.timeoutMs, endpoint);
6420
+ if (typeof connection === "string") {
6421
+ json(res, 200, {
6422
+ ok: false,
6423
+ elapsedMs: 0,
6424
+ probability: void 0,
6425
+ error: connection
6426
+ });
6427
+ return;
6428
+ }
6429
+ json(res, 200, await testJevConnection(connection));
6430
+ return;
6431
+ }
6432
+ if (req.method === "POST" && route === "jev-models") {
6433
+ if (!guardWrite(req, res)) return;
6434
+ const body = await readBody(req, res, deps.language);
6435
+ if (body === null) return;
6436
+ const provider = typeof body.provider === "string" ? body.provider.trim() : "";
6437
+ if (provider === "") {
6438
+ json(res, 200, {
6439
+ models: [],
6440
+ filtered: false,
6441
+ error: message("misc.jevProviderMustBeSelected")
6442
+ });
6443
+ return;
6444
+ }
6445
+ json(res, 200, await deps.jev.host.models(provider));
5846
6446
  return;
5847
6447
  }
5848
6448
  if (req.method === "GET" && route === "jev-observations") {
@@ -5851,11 +6451,12 @@ function registerEngramRoutes(ctx, deps) {
5851
6451
  }
5852
6452
  if (req.method === "POST" && route === "consolidate") {
5853
6453
  if (!guardWrite(req, res)) return;
5854
- const body = await readJsonBody(req);
6454
+ const body = await readBody(req, res, deps.language);
6455
+ if (body === null) return;
5855
6456
  adoptBodySelector(body);
5856
- const rawScope = typeof body?.scope === "string" ? body.scope : "user";
6457
+ const rawScope = typeof body.scope === "string" ? body.scope : "user";
5857
6458
  const scope = rawScope === "project" ? "project" : rawScope === "shared" ? "shared" : "user";
5858
- const candidates = Array.isArray(body?.candidates) ? body.candidates.filter((value) => typeof value === "string") : void 0;
6459
+ const candidates = Array.isArray(body.candidates) ? body.candidates.filter((value) => typeof value === "string") : void 0;
5859
6460
  json(res, 200, await runConsolidation(await storeFor(scope), deps.embedder, candidates === void 0 ? { scope } : {
5860
6461
  scope,
5861
6462
  mergeCandidateIds: candidates
@@ -5875,8 +6476,9 @@ function registerEngramRoutes(ctx, deps) {
5875
6476
  }
5876
6477
  if (req.method === "POST" && route === "restore-backup") {
5877
6478
  if (!guardWrite(req, res)) return;
5878
- const body = await readJsonBody(req);
5879
- if (body === null || typeof body.archivePath !== "string" || body.archivePath === "") {
6479
+ const body = await readBody(req, res, deps.language);
6480
+ if (body === null) return;
6481
+ if (typeof body.archivePath !== "string" || body.archivePath === "") {
5880
6482
  json(res, 400, { error: "archivePath required" });
5881
6483
  return;
5882
6484
  }
@@ -5901,8 +6503,9 @@ function registerEngramRoutes(ctx, deps) {
5901
6503
  }
5902
6504
  if (req.method === "POST" && (route === "update" || route === "forget" || route === "restore")) {
5903
6505
  if (!guardWrite(req, res)) return;
5904
- const body = await readJsonBody(req);
5905
- if (body === null || typeof body.id !== "string" || body.id === "") {
6506
+ const body = await readBody(req, res, deps.language);
6507
+ if (body === null) return;
6508
+ if (typeof body.id !== "string" || body.id === "") {
5906
6509
  json(res, 400, { error: "id required" });
5907
6510
  return;
5908
6511
  }
@@ -8623,10 +9226,10 @@ function createEngramTools(baseDeps) {
8623
9226
  * 写入单条已清洗内容(四态处置):MERGE 不新建条目只强化既有;
8624
9227
  * DEFER 写入并建 contradicts 边待裁决;ACCEPT 原样写入。
8625
9228
  */
8626
- async function writeWithDisposition(store, item) {
9229
+ async function writeWithDisposition(store, item, judge) {
8627
9230
  const { embedding } = item;
8628
- const decision = await decideWrite(store, item.kind, embedding, deps.judge === void 0 ? {} : {
8629
- judge: deps.judge,
9231
+ const decision = await decideWrite(store, item.kind, embedding, judge === void 0 ? {} : {
9232
+ judge,
8630
9233
  content: item.content
8631
9234
  });
8632
9235
  if (decision.disposition === "merge") return {
@@ -8647,7 +9250,7 @@ function createEngramTools(baseDeps) {
8647
9250
  });
8648
9251
  if (decision.disposition === "defer") {
8649
9252
  const candidates = (await store.findContradictions(embedding)).filter((candidate) => candidate.id !== record.id);
8650
- const confirmed = deps.judge === void 0 ? candidates : await confirmContradictions(deps.judge, item.content, candidates) ?? candidates;
9253
+ const confirmed = judge === void 0 ? candidates : await confirmContradictions(judge, item.content, candidates) ?? candidates;
8651
9254
  for (const candidate of confirmed) await store.linkEdge(record.id, candidate.id, "contradicts");
8652
9255
  return {
8653
9256
  disposition: "defer",
@@ -8745,6 +9348,7 @@ function createEngramTools(baseDeps) {
8745
9348
  }
8746
9349
  const vectors = embedder === void 0 || prepared.length === 0 ? void 0 : await embedder.embed(prepared.map((item) => item.content.trim()));
8747
9350
  const saved = [];
9351
+ const judge = deps.resolveJudge?.();
8748
9352
  for (const [position, item] of prepared.entries()) try {
8749
9353
  const embedding = vectors?.[position];
8750
9354
  const outcome = await writeWithDisposition(store, {
@@ -8754,7 +9358,7 @@ function createEngramTools(baseDeps) {
8754
9358
  ...item.importance === void 0 ? {} : { importance: item.importance },
8755
9359
  sourceSessionId,
8756
9360
  ...embedding === void 0 ? {} : { embedding }
8757
- });
9361
+ }, judge);
8758
9362
  await linkEntities(store, outcome.disposition === "merge" && outcome.relatedId !== void 0 ? asMemoryId(outcome.relatedId) : outcome.record.id, item.entities);
8759
9363
  saved.push({
8760
9364
  id: outcome.record.id,
@@ -9000,6 +9604,7 @@ function createEngramTools(baseDeps) {
9000
9604
  const embeddings = embedder === void 0 ? void 0 : await embedder.embed([content.trim()]);
9001
9605
  const imagery = placardOf(input.placard);
9002
9606
  const mentions = parseEntityMentions(input.entities);
9607
+ const judge = deps.resolveJudge?.();
9003
9608
  const outcome = await writeWithDisposition(store, {
9004
9609
  scope,
9005
9610
  kind: input.kind,
@@ -9008,7 +9613,7 @@ function createEngramTools(baseDeps) {
9008
9613
  sourceSessionId,
9009
9614
  ...embeddings?.[0] === void 0 ? {} : { embedding: embeddings[0] },
9010
9615
  ...imagery === void 0 ? {} : { imagery }
9011
- });
9616
+ }, judge);
9012
9617
  if (mentions.length > 0) await linkEntities(store, outcome.disposition === "merge" && outcome.relatedId !== void 0 ? asMemoryId(outcome.relatedId) : outcome.record.id, mentions);
9013
9618
  const { record, candidates } = outcome;
9014
9619
  if (outcome.disposition === "merge") {
@@ -11229,7 +11834,7 @@ function estimateTokens(text) {
11229
11834
  }
11230
11835
  //#endregion
11231
11836
  //#region package.json
11232
- var version = "0.9.2";
11837
+ var version = "0.9.6";
11233
11838
  //#endregion
11234
11839
  //#region src/index.ts
11235
11840
  /**
@@ -11411,7 +12016,7 @@ async function preStep(ctx, openStore, openStoreForProjectCwd, resolved, embedde
11411
12016
  embedder,
11412
12017
  mode,
11413
12018
  routeOverride: resolved.routeOverride,
11414
- ...resolveJevField(resolved.jev, resolved.dbDir),
12019
+ ...resolveJevField(ctx, resolved.jev, resolved.dbDir, () => state.route?.provider),
11415
12020
  call: (params) => streamText(ctx, {
11416
12021
  ...params,
11417
12022
  sessionId: agent.session.id
@@ -11432,7 +12037,7 @@ async function preStep(ctx, openStore, openStoreForProjectCwd, resolved, embedde
11432
12037
  embedder,
11433
12038
  mode,
11434
12039
  routeOverride: resolved.routeOverride,
11435
- ...resolveJevField(resolved.jev, resolved.dbDir),
12040
+ ...resolveJevField(ctx, resolved.jev, resolved.dbDir, () => state.route?.provider),
11436
12041
  call: (params) => streamText(ctx, {
11437
12042
  ...params,
11438
12043
  sessionId: agent.session.id
@@ -11794,7 +12399,7 @@ function apply(ctx, config = {}) {
11794
12399
  sessionId: ""
11795
12400
  }),
11796
12401
  logRequest: logIngestRequest,
11797
- ...resolveJevField(resolved.jev, resolved.dbDir)
12402
+ ...resolveJevField(ctx, resolved.jev, resolved.dbDir, () => (resolved.routeOverride ?? preStepState.route)?.provider)
11798
12403
  });
11799
12404
  /** 回填任务(进程内单例;面板轮询它的进度,工具同步等待自己的那一次运行)。 */
11800
12405
  let backfillJob;
@@ -11901,7 +12506,7 @@ function apply(ctx, config = {}) {
11901
12506
  sessionId: callParams.sessionId ?? ""
11902
12507
  }),
11903
12508
  routeOverride: resolved.routeOverride,
11904
- ...resolveJevField(resolved.jev, resolved.dbDir),
12509
+ ...resolveJevField(ctx, resolved.jev, resolved.dbDir, () => preStepState.route?.provider),
11905
12510
  queryRewrite: resolved.queryRewrite,
11906
12511
  exportDir: `${resolved.dbDir}/exports`,
11907
12512
  language: resolved.language,
@@ -11923,7 +12528,12 @@ function apply(ctx, config = {}) {
11923
12528
  embedder,
11924
12529
  jev: {
11925
12530
  base: resolved.jev,
11926
- dbDir: resolved.dbDir
12531
+ dbDir: resolved.dbDir,
12532
+ host: {
12533
+ catalog: () => readJevCatalog(ctx),
12534
+ models: (provider) => readProviderModels(ctx, provider),
12535
+ connection: (provider, model, timeoutMs, endpoint) => resolveJevConnection(ctx, provider, model, timeoutMs, endpoint)
12536
+ }
11927
12537
  },
11928
12538
  history: {
11929
12539
  estimate: historyApi.estimate,
@@ -11956,7 +12566,7 @@ function apply(ctx, config = {}) {
11956
12566
  embedder,
11957
12567
  mode,
11958
12568
  routeOverride: resolved.routeOverride,
11959
- ...resolveJevField(resolved.jev, resolved.dbDir),
12569
+ ...resolveJevField(ctx, resolved.jev, resolved.dbDir, () => (resolved.routeOverride ?? routeFromEvents(events))?.provider),
11960
12570
  call: (params) => streamText(ctx, {
11961
12571
  ...params,
11962
12572
  sessionId: session.id