@eddyskywalker/dsh-chatgpt-subscription 0.50.0 → 0.51.0

package/lib/{entry-progress-updates-CkGJr_fe.js → entry-progress-updates-BEkdyDZU.js}

@@ -249,6 +249,16 @@ function stringOf$1(value) {
 * 同一套措辞。用户看到的语言由 {@link progressLanguageDirective} 单独钉住——
 * 「指令用英文」与「输出用中文」是两件事，不要混在一起。
 *
+* ## 分节恒定，语言覆盖走尾部消息
+*
+* 这一段分节属于**缓存前缀的第一段**：会话中途改一个字，harness 就会就地替换
+* 最早那条 system 消息，整段前缀作废——在按内容前缀计费的线路上（Kimi Code），
+* 一次改写就是一次全价重建。所以：
+*
+* - 分节文本**恒为通用档位**（跟随用户语言），与任何设置无关，逐字节不变；
+* - zh/en 的固定语言要求、以及切回 auto 的撤销，都由 {@link resolveLanguageNotice}
+*   判定成一条**尾部用户消息**投递：末尾追加不改已发前缀。
+*
 * @module dsh-chatgpt-subscription/host/progress-updates/prompt
 */
 /**
@@ -315,16 +325,104 @@ function progressLanguageDirective(language) {
 	return PROGRESS_LANGUAGE_DIRECTIVES[language] ?? PROGRESS_LANGUAGE_DIRECTIVES.auto;
 }
 /**
+* 系统提示词分节里**恒定**的那条语言指令。
+*
+* 分节文本属于缓存前缀的第一段：会话中途改一个字，harness 就会就地替换最早那条
+* system 消息，整段前缀作废（Kimi Code 按内容前缀命中，一次改写就是一次全价
+* 重建）。所以分节里只放**跟随用户语言**这一条通用指令——它与设置无关，逐字节
+* 恒定。zh/en 的固定语言要求改由**尾部消息**投递（见
+* {@link languageOverrideNoticeText}）：末尾追加不改已发前缀。
+*/
+const FIXED_LANGUAGE_DIRECTIVE = PROGRESS_LANGUAGE_DIRECTIVES.auto;
+/**
 * 生成提示词分节的文本提供者。
 *
-* 文本与开关无关，这是刻意的：系统提示是缓存前缀的第一段，会话中途改一个字
-* 就会让整段前缀失效、整段重新计费（Kimi 的缓存是内容前缀匹配）。开关的语义
-* 因此只留给工具自己——关闭时 `execute` 直接返回 `displayed:false`。
-* @param language - 读取当前输出语言的函数；缺省按 `auto` 处理。
-* @returns 引导词加语言指令。
+* **不接受任何开关或语言参数**：分节文本必须在整个会话里逐字节恒定。开关的语义
+* 只留给工具自己（关闭时 `execute` 直接返回 `displayed:false`）；语言档位
+* （zh/en）走尾部消息，不进分节。
+* @returns 引导词加通用语言指令。
+*/
+function progressSectionText() {
+	return () => PROGRESS_GUIDANCE + "\n\n" + FIXED_LANGUAGE_DIRECTIVE;
+}
+/**
+* 语言覆盖通知的消息来源 kind。
+*
+* 与本插件其它注入的用户消息同形（`plan-mode-notice` / `progress-updates-nudge`），
+* 便于客户端与日志把「这是一条通知」与「这是一条真人输入」分开。
+*/
+const LANGUAGE_NOTICE_SOURCE_KIND = "progress-updates-language";
+/**
+* 「固定语言」覆盖通知的正文。
+*
+* 覆盖的是分节里那条通用指令（跟随用户语言），所以正文里明确写了「压过它」。
+* @param language - 要覆盖成的语言档位（zh/en）。
+* @returns 通知正文。
+*/
+function languageOverrideNoticeText(language) {
+	return "Progress update output language override: " + progressLanguageDirective(language) + " This overrides the default instruction to write progress updates in the language the user is writing in; it applies to every progress update from now on.";
+}
+/**
+* 撤销覆盖、切回「跟随用户语言」的通知正文。
+*
+* 必须单独通知：模型还记得「一律用中文」，不撤销它就会一直用中文。
+* @returns 通知正文。
 */
-function progressSectionText(language = () => "auto") {
-	return () => PROGRESS_GUIDANCE + "\n\n" + progressLanguageDirective(language());
+function languageDefaultNoticeText() {
+	return "Progress update output language override ended: write the title and the message of every progress update in the language the user is writing in again (any earlier instruction to always use one fixed language no longer applies).";
+}
+/**
+* 造一条语言通知消息。
+*
+* 用 DSH 自己的消息工厂而不是手写字面量：DSH 对每条被接纳的消息都校验 id 与
+* source，手写字面量会在第一次被追加时同步抛错。
+* @param text - 通知正文。
+* @param summary - 通知摘要（写进消息来源，便于日志辨认）。
+* @returns 用户角色的通知消息。
+*/
+function createLanguageNotice(text, summary) {
+	return createUserMessage({
+		content: [{
+			type: "text",
+			text
+		}],
+		source: {
+			kind: LANGUAGE_NOTICE_SOURCE_KIND,
+			form: "notice",
+			summary
+		}
+	});
+}
+/**
+* 判定这一轮要不要追加一条语言通知。
+*
+* 规则只有一条：**模型当前知道的语言档位与设置里的不一致时才通知**。
+*
+* - 模型起始只知道分节里的通用档位（跟随用户语言），所以第一次设成 zh/en 时
+*   通知一次；
+* - 同一个档位重复设置不重复通知（每一步都重读设置，但只在**变化**时投递）；
+* - 切回 auto 也要通知：模型还记得「一律用中文」，不撤销它就会一直用中文。
+*
+* @param current - 设置里当前的语言档位。
+* @param remembered - 模型已经知道的语言档位；undefined 表示只知道通用档位。
+* @returns 通知与新的「已知档位」。
+*/
+function resolveLanguageNotice(current, remembered) {
+	if (current === (remembered ?? "auto")) return { remembered: current };
+	if (current === "auto") return {
+		notice: {
+			text: languageDefaultNoticeText(),
+			summary: "progress update language: auto"
+		},
+		remembered: "auto"
+	};
+	return {
+		notice: {
+			text: languageOverrideNoticeText(current),
+			summary: `progress update language: ${current}`
+		},
+		remembered: current
+	};
 }
 //#endregion
 //#region src/host/progress-updates/projection.ts
@@ -658,6 +756,14 @@ function resolveProgressUpdatesSettings(config) {
 		language: language !== void 0 && PROGRESS_UPDATE_LANGUAGES.includes(language) ? language : "auto"
 	};
 }
+/**
+* 判断一个值是不是普通对象。
+* @param value - 任意值。
+* @returns 是非 null 的对象时为 true。
+*/
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
 /** 血缘回溯的深度上限：与 `nudge.ts` 的 `counterSessionIdOf` 同一个数。 */
 const LINEAGE_DEPTH_LIMIT = 16;
 /**
@@ -913,9 +1019,46 @@ function installProgressUpdates(ctx, options) {
 		return systemPrompt.section({
 			name: PROGRESS_SECTION_NAME,
 			order: 220,
-			text: progressSectionText(() => options.settings().language)
+			text: progressSectionText()
 		});
 	}, "dsh-chatgpt-subscription: progress update prompt section");
+	/** 每个会话记住的「模型已经知道的语言档位」。 */
+	const rememberedLanguages = /* @__PURE__ */ new WeakMap();
+	/**
+	* 取一个会话的桶键。
+	* @param agent - pre-step 载荷里的 agent。
+	* @returns 桶键；认不出会话时 undefined。
+	*/
+	const languageBucketOf = (agent) => {
+		if (!isRecord(agent)) return void 0;
+		const session = agent["session"];
+		if (isRecord(session)) return session;
+		return agent;
+	};
+	const disposePreStepListener = ctx.on?.("agent/pre-step", (async (payload, next) => {
+		const decision = await next();
+		try {
+			if (decision === void 0 || decision.kind === "reject") return decision;
+			if (payload?.signal?.aborted === true) return decision;
+			const messages = Array.isArray(decision.messages) ? decision.messages : [];
+			if (messages.length === 0) return decision;
+			const bucket = languageBucketOf(payload?.agent);
+			if (bucket === void 0) return decision;
+			const outcome = resolveLanguageNotice(options.settings().language, rememberedLanguages.get(bucket));
+			if (outcome.notice === void 0) {
+				rememberedLanguages.set(bucket, outcome.remembered);
+				return decision;
+			}
+			const notice = createLanguageNotice(outcome.notice.text, outcome.notice.summary);
+			rememberedLanguages.set(bucket, outcome.remembered);
+			return {
+				...decision,
+				messages: [...messages, notice]
+			};
+		} catch {
+			return decision;
+		}
+	}));
 	track(() => {
 		const webServer = serviceOf("webServer");
 		if (webServer === void 0) return () => void 0;
@@ -945,6 +1088,7 @@ function installProgressUpdates(ctx, options) {
 	}));
 	return () => {
 		disposeListener?.();
+		if (typeof disposePreStepListener === "function") disposePreStepListener();
 		stores.clear();
 		countedSteps.clear();
 		release();