@roaming-ai/dsh-group-chat 0.2.2 → 0.3.0

package/lib/index.js

@@ -46,6 +46,71 @@ function mountOnce(packageName, fn) {
 	});
 }
 //#endregion
+//#region src/core/errors.ts
+const PREFIX = "模型输出异常终止: ";
+const LEGACY_ROLE = /^角色「([^」]+)」发言失败[:：]\s*/;
+/** 剥旧系统胶囊与引擎包装前缀，保留供应商原文。 */
+function unwrapSpeakFailure(raw) {
+	const text = String(raw || "").trim();
+	const legacy = parseLegacyRoleFailure(text);
+	const body = legacy ? legacy.rest : text;
+	return body.startsWith(PREFIX) ? body.slice(10).trim() : body;
+}
+/** 旧系统胶囊文案：角色「名」发言失败：原文。对不上则 null。 */
+function parseLegacyRoleFailure(text) {
+	const m = LEGACY_ROLE.exec(String(text || ""));
+	if (!m) return null;
+	return {
+		roleName: m[1],
+		rest: String(text).slice(m[0].length)
+	};
+}
+/** 发言失败卡：error 标记，或旧系统胶囊文案。 */
+function isSpeakFailure(m) {
+	return !!m.error || !!parseLegacyRoleFailure(m.text);
+}
+/**
+* 把旧系统失败行挂到对应角色（恰好一名命中才迁）。
+* 返回是否改写了记录。
+*/
+function repairFailedMessage(m, roles) {
+	if (!isSpeakFailure(m)) return false;
+	let changed = false;
+	if (!m.error) {
+		m.error = true;
+		changed = true;
+	}
+	if (!m.failedRoleId && m.speaker !== "user" && m.speaker !== "system") {
+		m.failedRoleId = m.speaker;
+		changed = true;
+	}
+	if (!m.failedRoleId && m.speaker === "system") {
+		const parsed = parseLegacyRoleFailure(m.text);
+		if (parsed) {
+			const hits = roles.filter((r) => r.name === parsed.roleName);
+			if (hits.length === 1) {
+				const role = hits[0];
+				m.speaker = role.id;
+				m.failedRoleId = role.id;
+				m.text = unwrapSpeakFailure(parsed.rest);
+				if (!m.model && (role.provider || role.model)) m.model = (role.provider || "") + " / " + (role.model || "");
+				changed = true;
+			}
+		}
+	} else if (m.failedRoleId && m.speaker === "system") {
+		m.speaker = m.failedRoleId;
+		changed = true;
+	}
+	if (m.failedRoleId || m.speaker !== "user" && m.speaker !== "system") {
+		const unwrapped = unwrapSpeakFailure(m.text);
+		if (unwrapped !== m.text) {
+			m.text = unwrapped;
+			changed = true;
+		}
+	}
+	return changed;
+}
+//#endregion
 //#region src/core/types.ts
 /** 全部合法档位（展示顺序）。 */
 const PERMISSION_TIERS = [
@@ -67,6 +132,16 @@ function migrateTier(permissionTier, allowCommands) {
 	if (tier !== void 0) return tier;
 	return allowCommands === true ? "workspace_write" : "view_only";
 }
+/** 全部合法约束类型。 */
+const CONSTRAINT_KINDS = [
+	"decided",
+	"rejected",
+	"open"
+];
+/** 合法 kind 原样，其余 undefined。 */
+function asConstraintKind(value) {
+	return typeof value === "string" && CONSTRAINT_KINDS.includes(value) ? value : void 0;
+}
 /** 可选数值参数安全化：数字则原样，否则 undefined。 */
 function asNumber(value) {
 	return typeof value === "number" && !Number.isNaN(value) ? value : void 0;
@@ -116,7 +191,8 @@ function createHostState(ctx) {
 			pendingConfirm: null,
 			confirmSignal: null,
 			childProc: null,
-			finished: null
+			finished: null,
+			replaceMessageId: null
 		},
 		store: null,
 		revision: 1,
@@ -124,12 +200,10 @@ function createHostState(ctx) {
 		nid: (p) => p + "-" + core.idSeq++,
 		lastCreated: null,
 		newSession: (groupId, name) => {
-			let n = 0;
-			for (const s of core.sessions.values()) if (s.groupId === groupId) n++;
 			const s = {
 				id: randomUUID(),
 				groupId,
-				name: name || "会话 " + (n + 1),
+				name: name || "新会话",
 				topic: "",
 				messageIds: [],
 				createdAt: Date.now()
@@ -144,7 +218,7 @@ function createHostState(ctx) {
 //#region src/host/api/actions.ts
 /**
 * 动作分发（handleAction，POST /api/group-chat/action 的载荷）：
-* mutate（12 种 CRUD/配置操作）| send | stop | confirmCommand | models | efforts。
+* mutate（12 种 CRUD/配置操作）| send | retrySpeak | stop | confirmCommand | models | efforts。
 * @module dsh-group-chat/host/api/actions
 */
 /** 创建动作分发面。 */
@@ -382,6 +456,8 @@ function createActions(core, deps) {
 				};
 				for (const mid of sess.messageIds) messages.delete(mid);
 				sess.messageIds = [];
+				sess.constraints = void 0;
+				sess.constraintsUpToSeq = void 0;
 				schedulePersist({ session: sess.id });
 				touch();
 			}
@@ -426,10 +502,56 @@ function createActions(core, deps) {
 		run.queue = queue;
 		run.stopping = false;
 		run.finished = null;
+		run.replaceMessageId = null;
 		touch();
 		runLoop(sess).catch((e) => console.error("group-chat run failed", e));
 		return { ok: true };
 	};
+	/** 对失败卡原地重试：只让该角色再讲一次，成功后覆盖同一条消息。 */
+	const retrySpeak = (args) => {
+		const sess = sessions.get(String(args && args.sessionId || ""));
+		if (!sess) return {
+			ok: false,
+			error: "会话不存在"
+		};
+		if (run.running) return {
+			ok: false,
+			error: "已有对话进行中，请先停止"
+		};
+		const msg = messages.get(String(args && args.messageId || ""));
+		if (!msg || msg.sessionId !== sess.id || !isSpeakFailure(msg)) return {
+			ok: false,
+			error: "没有可重试的失败发言"
+		};
+		const g = groups.get(sess.groupId);
+		if (!g) return {
+			ok: false,
+			error: "群组不存在"
+		};
+		if (repairFailedMessage(msg, g.roleIds.map((id) => roles.get(id)).filter((r) => Boolean(r)))) {
+			schedulePersist({ session: sess.id });
+			touch();
+		}
+		const roleId = msg.failedRoleId || (msg.speaker !== "user" && msg.speaker !== "system" ? msg.speaker : "");
+		const role = roleId ? roles.get(roleId) : void 0;
+		if (!role || role.groupId !== sess.groupId) return {
+			ok: false,
+			error: "失败角色已不存在，无法重试"
+		};
+		if (!role.enabled) return {
+			ok: false,
+			error: "该角色已停用，无法重试"
+		};
+		run.running = true;
+		run.sessionId = sess.id;
+		run.queue = [role.id];
+		run.stopping = false;
+		run.finished = null;
+		run.replaceMessageId = msg.id;
+		touch();
+		runLoop(sess, { replaceMessageId: msg.id }).catch((e) => console.error("group-chat retry failed", e));
+		return { ok: true };
+	};
 	const stop = (args) => {
 		if (run.running && (!args || !args.sessionId || run.sessionId === args.sessionId)) {
 			run.stopping = true;
@@ -527,6 +649,7 @@ function createActions(core, deps) {
 			lastCreated: core.lastCreated
 		};
 		if (kind === "send") return send(body);
+		if (kind === "retrySpeak") return retrySpeak(body);
 		if (kind === "stop") return stop(body);
 		if (kind === "confirmCommand") return confirmCommand(body);
 		if (kind === "models") return {
@@ -738,7 +861,8 @@ function createBroadcast(core) {
 			partial: core.run.partial,
 			partialReasoning: core.run.partialReasoning,
 			pendingConfirm: core.run.pendingConfirm,
-			finished: core.run.finished
+			finished: core.run.finished,
+			replaceMessageId: core.run.replaceMessageId
 		},
 		lastCreated: core.lastCreated,
 		groups: [...core.groups.values()].map((g) => ({
@@ -754,6 +878,7 @@ function createBroadcast(core) {
 			groupId: s.groupId,
 			name: s.name,
 			topic: s.topic,
+			...s.constraints && s.constraints.length ? { constraints: s.constraints } : {},
 			messageIds: s.messageIds.slice(),
 			createdAt: s.createdAt
 		})),
@@ -779,6 +904,7 @@ function createBroadcast(core) {
 			reasoning: m.reasoning,
 			model: m.model,
 			error: m.error,
+			failedRoleId: m.failedRoleId,
 			toolCalls: m.toolCalls,
 			ts: m.ts
 		}))
@@ -846,8 +972,274 @@ const TOOL_SCHEMAS = [
 		}
 	}
 ];
+/** 折叠失败时临时原文总长上限。 */
+const TEMP_MAX_CHARS = 16e3;
+const KIND_LABEL = {
+	decided: "已定",
+	rejected: "否决",
+	open: "未决"
+};
+/** 已折入水位（缺省 0）。 */
+function constraintsWatermark(sess) {
+	return typeof sess.constraintsUpToSeq === "number" && sess.constraintsUpToSeq > 0 ? sess.constraintsUpToSeq : 0;
+}
+/** 重试：只取失败卡之前的时间线；untilId 不在列表则原样。 */
+function prefixIds(ids, untilId) {
+	if (!untilId) return ids;
+	const i = ids.indexOf(untilId);
+	return i >= 0 ? ids.slice(0, i) : ids;
+}
+/**
+* 新挤出：seq > 水位 且不在最近 40 条。只扫窗口外前缀（旧→新）。
+* untilId：重试时把窗口截到该消息之前，不带上后面已经发生的发言。
+*/
+function squeezedMessages(messages, sess, untilId) {
+	const ids = prefixIds(sess.messageIds, untilId);
+	if (ids.length <= 40) return [];
+	const end = ids.length - 40;
+	const upTo = constraintsWatermark(sess);
+	const last = messages.get(ids[end - 1]);
+	if (last && last.seq <= upTo) return [];
+	const out = [];
+	for (let i = 0; i < end; i++) {
+		const m = messages.get(ids[i]);
+		if (!m || m.seq <= upTo) continue;
+		out.push(m);
+	}
+	return out;
+}
+/** 说话人展示名（折叠输入 / transcript 共用）。 */
+function speakerLabel(speaker, roleName) {
+	if (speaker === "user") return "用户";
+	if (speaker === "system") return "系统";
+	return roleName || "成员";
+}
+/** 单条消息压成 transcript 行（正文 8k + 工具一行摘要）。 */
+function formatTranscriptLine(m, name) {
+	let text = m.text || "";
+	if (text.length > 8e3) text = text.slice(0, 8e3) + "…(已截断)";
+	let line = "【" + name + "】" + text;
+	if (Array.isArray(m.toolCalls)) for (const c of m.toolCalls) {
+		if (!c || typeof c.tool !== "string") continue;
+		let brief = "";
+		try {
+			brief = JSON.stringify(c.args) || "";
+		} catch {
+			brief = "";
+		}
+		if (brief.length > 60) brief = brief.slice(0, 60) + "…";
+		const st = c.status === "ok" ? "成功" : c.status === "denied" ? "用户拒绝" : "失败";
+		let ob = String(c.output || "");
+		if (ob.length > 200) ob = ob.slice(0, 200) + "…";
+		line += "\n  [工具] " + c.tool + " " + brief + " → " + st + (ob ? "（" + ob.replace(/\s+/g, " ") + "）" : "");
+	}
+	return line;
+}
+/**
+* 单轮折叠消耗前缀：从最旧挤出起，最多 40 条 / 16k；系统行与失败卡计入消耗但不进模型。
+* 水位只能推到 consumed 的 max seq，剩余留待下一轮。
+*/
+function takeFoldBatch(squeezed, nameOf) {
+	const consumed = [];
+	const lines = [];
+	let hasUser = false;
+	let chars = 0;
+	for (const m of squeezed) {
+		if (m.speaker === "system" || m.error) {
+			consumed.push(m);
+			if (consumed.length >= 40) break;
+			continue;
+		}
+		const line = formatTranscriptLine(m, nameOf(m));
+		const extra = line.length + (lines.length ? 2 : 0);
+		if (lines.length > 0 && chars + extra > 16e3) break;
+		if (m.speaker === "user") hasUser = true;
+		lines.push(line);
+		chars += extra;
+		consumed.push(m);
+		if (consumed.length >= 40) break;
+	}
+	return {
+		consumed,
+		lines,
+		hasUser,
+		allSystem: lines.length === 0
+	};
+}
+/**
+* 未折入的挤出原文（失败缓冲）：只格式化最近 20 条，再按 16k 从最旧往下丢。
+*/
+function tempTranscript(squeezed, nameOf) {
+	if (!squeezed.length) return "";
+	const usable = squeezed.filter((m) => m.speaker !== "system" && !m.error);
+	if (!usable.length) return "";
+	const lines = (usable.length > 20 ? usable.slice(-20) : usable).map((m) => formatTranscriptLine(m, nameOf(m)));
+	let start = 0;
+	let total = lines[0] ? lines[0].length : 0;
+	for (let i = 1; i < lines.length; i++) total += 2 + lines[i].length;
+	while (start < lines.length - 1 && total > 16e3) {
+		total -= lines[start].length + 2;
+		start++;
+	}
+	let block = lines.slice(start).join("\n\n");
+	if (block.length > 16e3) block = block.slice(0, TEMP_MAX_CHARS) + "…(已截断)";
+	return block;
+}
+/** 水位 = 本批挤出的 max(seq)；空批为 0。 */
+function squeezedMaxSeq(squeezed) {
+	let max = 0;
+	for (const m of squeezed) if (m.seq > max) max = m.seq;
+	return max;
+}
+/** hydrate / 模型输出：非法 kind 丢条目；空 text 丢；条数与总长截断。 */
+function sanitizeConstraints(raw) {
+	if (!Array.isArray(raw)) return [];
+	const out = [];
+	let total = 0;
+	for (const item of raw) {
+		if (out.length >= 12) break;
+		if (!item || typeof item !== "object") continue;
+		const kind = asConstraintKind(item.kind);
+		const text = typeof item.text === "string" ? item.text.trim() : "";
+		if (!kind || !text) continue;
+		const clipped = text.length > 160 ? text.slice(0, 160) + "…" : text;
+		const cost = KIND_LABEL[kind].length + clipped.length;
+		if (total + cost > 1200) break;
+		out.push({
+			kind,
+			text: clipped
+		});
+		total += cost;
+	}
+	return out;
+}
+/**
+* 解析折叠模型输出。null = 解析失败（水位不推）；[] = 无新结论（水位推、备忘不动）。
+*/
+function parseConstraints(raw) {
+	const body = raw.replace(/```(?:json)?/g, "");
+	const l = body.indexOf("{");
+	const r = body.lastIndexOf("}");
+	if (l < 0 || r <= l) return null;
+	try {
+		const o = JSON.parse(body.slice(l, r + 1));
+		if (!Object.prototype.hasOwnProperty.call(o, "constraints")) return null;
+		if (!Array.isArray(o.constraints)) return null;
+		return sanitizeConstraints(o.constraints);
+	} catch {
+		return null;
+	}
+}
+/** 本批无用户消息时，新的已定/否决降为未决。 */
+function downgradeWithoutUser(list, hasUser) {
+	if (hasUser) return list;
+	return list.map((c) => c.kind === "open" ? c : {
+		kind: "open",
+		text: c.text
+	});
+}
+/** system 提示词「已确认约束」块；空则空串。 */
+function constraintBlock(list) {
+	if (!list || !list.length) return "";
+	return "\n# 已确认约束\n" + list.map((c) => "- " + KIND_LABEL[c.kind] + "：" + c.text).join("\n");
+}
+//#endregion
+//#region src/host/engine/fold.ts
+/** DSH 默认模型（与 retitle 同一读取面；缺位返回 null）。 */
+const defaultModel$1 = (core) => {
+	try {
+		const svc = core.ctx.reflect.get("agentDefaultModel");
+		const sel = svc ? svc.currentSelection() : null;
+		return sel && typeof sel.provider === "string" && typeof sel.model === "string" && sel.provider && sel.model ? {
+			provider: sel.provider,
+			model: sel.model
+		} : null;
+	} catch {
+		return null;
+	}
+};
+/**
+* 每轮 send 结束后折叠窗口外约束：fire-and-forget、不产生消息、静默失败。
+* 同会话去重；会话已清空则 abort。内存 {constraints, constraintsUpToSeq} 一次挂上。
+*/
+function createFold(core, deps) {
+	const { llm, messages, roles } = core;
+	const { touch, schedulePersist } = deps;
+	const folding = /* @__PURE__ */ new Set();
+	const nameOf = (speaker) => speakerLabel(speaker, (roles.get(speaker) || { name: void 0 }).name);
+	return async (sess) => {
+		if (folding.has(sess.id)) return;
+		const squeezed = squeezedMessages(messages, sess);
+		if (!squeezed.length) return;
+		const input = takeFoldBatch(squeezed, (m) => nameOf(m.speaker));
+		const watermark = squeezedMaxSeq(input.consumed);
+		if (watermark <= 0) return;
+		const commit = (next) => {
+			const live = core.sessions.get(sess.id);
+			if (!live || live.messageIds.length === 0) return;
+			if (next && next.length) live.constraints = next;
+			live.constraintsUpToSeq = watermark;
+			schedulePersist({ session: live.id });
+			touch();
+		};
+		if (input.allSystem) {
+			commit(void 0);
+			return;
+		}
+		const dm = defaultModel$1(core);
+		if (!dm) return;
+		folding.add(sess.id);
+		try {
+			const existing = (sess.constraints || []).map((c) => "- " + KIND_LABEL[c.kind] + "：" + c.text);
+			const sys = [
+				"你是群聊会话的约束整理助手。把已经离开最近对话窗口的旧消息压成无主结论/约束备忘。",
+				"",
+				"# 规则",
+				"- 只输出一行 JSON：{\"constraints\":[{\"kind\":\"decided|rejected|open\",\"text\":\"…\"}, ...]}",
+				"- kind 只能是 decided（已定）/ rejected（否决）/ open（未决）",
+				"- 无主：条目不写说话人。8–12 条、合计不超过 1200 字，最多 12 条",
+				"- 已定/否决只能依据【用户】原文；角色对打一律标 open（未决）",
+				"- 同主题：新已定覆盖旧未决；旧已定不能因角色反对改写，除非【用户】改口",
+				"- 没有新结论时输出 {\"constraints\":[]}（保留旧备忘）",
+				"- 超预算时按 已定 > 未决 > 过程叙述 取舍；语言跟随记录",
+				"",
+				"当前备忘：",
+				existing.length ? existing.join("\n") : "（空）"
+			].join("\n");
+			const user = "旧消息（从旧到新，含工具一行摘要）：\n\n" + input.lines.join("\n\n");
+			let acc = "";
+			for await (const chunk of llm.stream({
+				provider: dm.provider,
+				model: dm.model,
+				system: sys,
+				purpose: "session-title",
+				messages: [{
+					id: "g" + core.revision + "-c0",
+					role: "user",
+					content: [{
+						type: "text",
+						text: user
+					}],
+					source: { kind: "user" }
+				}]
+			})) if (chunk.type === "text-delta") {
+				acc += chunk.text;
+				if (acc.length > 4e3) break;
+			} else if (chunk.type === "finish") break;
+			const parsed = parseConstraints(acc);
+			if (parsed === null) return;
+			commit(parsed.length ? downgradeWithoutUser(parsed, input.hasUser) : void 0);
+		} catch (e) {
+			console.error("[dsh-group-chat] 会话约束折叠失败（跳过，不影响对话）：", e);
+		} finally {
+			folding.delete(sess.id);
+		}
+	};
+}
 //#endregion
 //#region src/host/engine/retitle.ts
+/** 仍是新建占位名（含改名之前的「会话 N」存量），自动标题尚未落地。 */
+const isPlaceholderName = (name) => name === "新会话" || /^会话 \d+$/.test(name);
 /** DSH 默认模型（agentDefaultModel 服务缺位或未配置时返回 null，调用方静默跳过）。 */
 const defaultModel = (core) => {
 	try {
@@ -866,7 +1258,7 @@ const titleTranscript = (core, sess) => {
 	const out = [];
 	for (const mid of sess.messageIds.slice(-40)) {
 		const m = core.messages.get(mid);
-		if (!m || m.speaker === "system" || !m.text) continue;
+		if (!m || m.speaker === "system" || m.error || !m.text) continue;
 		const name = m.speaker === "user" ? "用户" : (core.roles.get(m.speaker) || { name: void 0 }).name || "成员";
 		out.push("【" + name + "】" + m.text.replace(/\s+/g, " ").slice(0, 500));
 	}
@@ -892,9 +1284,9 @@ const parseRetitle = (raw) => {
 };
 /**
 * 每轮结束后根据聊天内容整理会话名称与主题：后台 fire-and-forget、不产生
-* 消息、静默失败。名称 =「类别 emoji + 对象｜目标」（类别固定、对象稳定、
-* 目标实质变化才改）；主题 = 演进式一句话摘要（对象+目标+当前焦点），注入
-* 后续轮次的角色上下文。手动编辑过的字段永久跳过（隐式固定，apply 时复查）。
+* 消息、静默失败。名称只在仍为默认占位时生成一次（「类别 emoji + 对象｜目标」）；
+* 主题 = 演进式一句话摘要（对象+目标+当前焦点），每轮更新，注入后续角色上下文。
+* 手动编辑过的字段永久跳过（隐式固定，apply 时复查）。
 */
 function createRetitle(core, deps) {
 	const { llm } = core;
@@ -904,7 +1296,8 @@ function createRetitle(core, deps) {
 	return async (sess) => {
 		if (retitling.has(sess.id)) return;
 		const dm = defaultModel(core);
-		if (!dm || sess.namePinned && sess.topicPinned) return;
+		const nameFrozen = !!sess.namePinned || !isPlaceholderName(sess.name);
+		if (!dm || nameFrozen && sess.topicPinned) return;
 		const transcript = titleTranscript(core, sess);
 		if (!transcript) return;
 		retitling.add(sess.id);
@@ -915,9 +1308,9 @@ function createRetitle(core, deps) {
 				"# 名称规则",
 				"- 格式：「类别 emoji + 对象｜目标」，例如「🔎 缓存选型｜Redis 与本地 KV 对比」",
 				"- 类别固定六选一：🔎 调研对比（多方案/多观点比较）、💡 头脑风暴（创意发散）、⚖️ 方案评审（评审已有方案或产物）、🛠️ 排查修复（定位与解决问题）、📝 方法整理（总结沉淀方法与知识）、🗣️ 通用讨论（其余兜底）",
-				"- 对象在前且稳定：把辨识度最高的讨论对象放最前；省略群组名（外层已展示）；除非讨论对象实质变化，沿用当前名称里的对象名；「继续」「追问」等不改变主线",
+				"- 对象在前：把辨识度最高的讨论对象放最前；省略群组名（外层已展示）",
 				"- 目标 = 当前正在做的事，动宾短语，保持简洁",
-				"- 名称总长不超过 16 个字",
+				"- 名称总长不超过 16 个字；名称只生成一次，不要为了追问/继续而改名",
 				"",
 				"# 主题规则",
 				"- 一句话演进式摘要：讨论对象 + 当前目标 + 当前焦点/分歧点",
@@ -927,7 +1320,7 @@ function createRetitle(core, deps) {
 				"- 语言跟随用户消息的主要语言；保留产品名与技术名词",
 				"- 只输出一行 JSON：{\"name\": \"…\", \"topic\": \"…\"}，不要输出其他内容",
 				"",
-				"当前名称：" + (sess.namePinned ? "（已手动固定，本次不要输出 name 字段）" : sess.name),
+				"当前名称：" + (nameFrozen ? "（已固定，本次不要输出 name 字段）" : sess.name),
 				"当前主题：" + (sess.topicPinned ? "（已手动固定，本次不要输出 topic 字段）" : sess.topic || "（空）")
 			].join("\n");
 			let acc = "";
@@ -951,7 +1344,7 @@ function createRetitle(core, deps) {
 			} else if (chunk.type === "finish") break;
 			const parsed = parseRetitle(acc);
 			let changed = false;
-			if (parsed.name && !sess.namePinned) {
+			if (parsed.name && !sess.namePinned && isPlaceholderName(sess.name)) {
 				sess.name = parsed.name;
 				changed = true;
 			}
@@ -974,7 +1367,7 @@ function createRetitle(core, deps) {
 //#region src/host/engine/conversation.ts
 /**
 * 对话引擎：消息追加、群聊记录转写、角色发言（speak：prompt 构建 + 流式
-* 轮次 + 工具回注循环）、多轮 runLoop（每轮结束触发 retitle 标题整理）。
+* 轮次 + 工具回注循环）、多轮 runLoop（结束时后台 retitle + 窗口外约束折叠）。
 * @module dsh-group-chat/host/engine/conversation
 */
 /** 创建对话引擎。 */
@@ -985,6 +1378,11 @@ function createConversation(core, deps) {
 		touch,
 		schedulePersist
 	});
+	const fold = createFold(core, {
+		touch,
+		schedulePersist
+	});
+	const nameOf = (speaker) => speakerLabel(speaker, (roles.get(speaker) || { name: void 0 }).name);
 	const appendMessage = (sess, speaker, text, extra) => {
 		const msg = {
 			id: core.nid("msg"),
@@ -1003,6 +1401,7 @@ function createConversation(core, deps) {
 			if (extra.thinkingSummary !== void 0) msg.thinkingSummary = extra.thinkingSummary;
 			if (extra.model !== void 0) msg.model = extra.model;
 			if (extra.error !== void 0) msg.error = extra.error;
+			if (extra.failedRoleId !== void 0) msg.failedRoleId = extra.failedRoleId;
 			if (Array.isArray(extra.toolCalls) && extra.toolCalls.length > 0) msg.toolCalls = extra.toolCalls;
 		}
 		messages.set(msg.id, msg);
@@ -1011,35 +1410,76 @@ function createConversation(core, deps) {
 		schedulePersist({ session: sess.id });
 		return msg;
 	};
-	/** 群聊记录 → 角色上下文块（最近 40 条、逐条 8k 截断、工具行压缩）。 */
-	const transcriptBlock = (sess) => {
+	/** 把失败回合写成该角色的消息（speaker = 角色 id），不再用系统胶囊顶替。 */
+	const writeFailure = (sess, role, err, replaceId) => {
+		const raw = unwrapSpeakFailure(String(err && err.message || err));
+		const extra = {
+			error: true,
+			failedRoleId: role.id,
+			model: role.provider + " / " + role.model
+		};
+		if (replaceId) {
+			const existing = messages.get(replaceId);
+			if (existing && existing.sessionId === sess.id) {
+				existing.speaker = role.id;
+				existing.text = raw;
+				existing.error = true;
+				existing.failedRoleId = role.id;
+				existing.model = extra.model;
+				existing.reasoning = void 0;
+				existing.reasoningFull = void 0;
+				existing.thinkingSummary = void 0;
+				existing.toolCalls = void 0;
+				existing.ts = Date.now();
+				touch();
+				schedulePersist({ session: sess.id });
+				return;
+			}
+		}
+		appendMessage(sess, role.id, raw, extra);
+	};
+	/** 成功发言写入：replaceId 存在则原地覆盖失败卡。 */
+	const writeSuccess = (sess, role, out, replaceId) => {
+		const extra = {
+			model: role.provider + " / " + role.model,
+			reasoning: out.reasoning,
+			toolCalls: out.toolCalls
+		};
+		if (replaceId) {
+			const existing = messages.get(replaceId);
+			if (existing && existing.sessionId === sess.id) {
+				existing.speaker = role.id;
+				existing.text = out.text;
+				existing.error = void 0;
+				existing.failedRoleId = void 0;
+				existing.model = extra.model;
+				existing.reasoning = out.reasoning;
+				existing.reasoningFull = void 0;
+				existing.thinkingSummary = void 0;
+				existing.toolCalls = Array.isArray(out.toolCalls) && out.toolCalls.length > 0 ? out.toolCalls : void 0;
+				existing.ts = Date.now();
+				touch();
+				schedulePersist({ session: sess.id });
+				return;
+			}
+		}
+		appendMessage(sess, role.id, out.text, extra);
+	};
+	/** 群聊记录 → 角色上下文块（最近 40 条 + 未折入临时原文）。失败卡不进上下文。重试截到该条之前。 */
+	const transcriptBlock = (sess, skipId) => {
 		const out = [];
-		for (const mid of sess.messageIds) {
+		for (const mid of prefixIds(sess.messageIds, skipId).slice(-40)) {
 			const m = messages.get(mid);
-			if (!m) continue;
-			const name = m.speaker === "user" ? "用户" : m.speaker === "system" ? "系统" : (roles.get(m.speaker) || { name: void 0 }).name || "成员";
-			let text = m.text || "";
-			if (text.length > 8e3) text = text.slice(0, 8e3) + "…(已截断)";
-			let line = "【" + name + "】" + text;
-			if (Array.isArray(m.toolCalls)) for (const c of m.toolCalls) {
-				if (!c || typeof c.tool !== "string") continue;
-				let brief = "";
-				try {
-					brief = JSON.stringify(c.args) || "";
-				} catch {
-					brief = "";
-				}
-				if (brief.length > 60) brief = brief.slice(0, 60) + "…";
-				const st = c.status === "ok" ? "成功" : c.status === "denied" ? "用户拒绝" : "失败";
-				let ob = String(c.output || "");
-				if (ob.length > 200) ob = ob.slice(0, 200) + "…";
-				line += "\n  [工具] " + c.tool + " " + brief + " → " + st + (ob ? "（" + ob.replace(/\s+/g, " ") + "）" : "");
-			}
-			out.push(line);
+			if (!m || m.id === skipId || m.error) continue;
+			out.push(formatTranscriptLine(m, nameOf(m.speaker)));
 		}
-		return out.slice(-40).join("\n\n");
+		const live = out.join("\n\n");
+		const temp = tempTranscript(squeezedMessages(messages, sess, skipId), (m) => nameOf(m.speaker));
+		if (!temp) return live;
+		if (!live) return temp;
+		return temp + "\n\n" + live;
 	};
-	const speak = async (g, sess, role) => {
+	const speak = async (g, sess, role, skipId) => {
 		const ws = await materials.loadWorkspaceFiles(g);
 		const parts = ws.parts;
 		const sys = [
@@ -1049,6 +1489,7 @@ function createConversation(core, deps) {
 			"- 名称：" + role.name,
 			"- 人设：" + (role.persona ? role.persona : "（未填写，请以积极协作者的身份参与讨论）"),
 			sess.topic ? "\n# 本会话主题\n" + sess.topic : "",
+			constraintBlock(sess.constraints),
 			materials.materialBlock(parts, ws.dir),
 			ws.dir ? "\n# 可用工具\n你可以调用工具在群组工作区目录（" + ws.dir + "）内查看文件与目录" + (g.permissionTier === "workspace_write" ? "、执行 shell 命令（命令需用户逐条确认，请优先用于运行测试）" : g.permissionTier === "full_access" ? "、执行 shell 命令（命令将直接执行、无需确认，请谨慎并优先用于运行测试）" : "") + "。需要事实依据时优先用工具查看，不要凭空猜测。" : "",
 			"\n# 发言要求",
@@ -1056,7 +1497,7 @@ function createConversation(core, deps) {
 			"- 回应群内最新讨论（消息中「@你的名字」表示用户点名要求你回应，被点名时请优先回应）；与其他成员自然对话；有不同观点可以提出并说明理由",
 			"- 保持简洁，通常不超过 300 字"
 		].filter((s) => s !== "").join("\n");
-		const history = transcriptBlock(sess);
+		const history = transcriptBlock(sess, skipId);
 		const intro = history ? "以下是本会话的群聊记录（从旧到新）：\n\n" + history : "本会话刚刚开始，请围绕主题做简短开场发言。";
 		let wsRoot = null;
 		if (ws.dir) try {
@@ -1276,10 +1717,12 @@ function createConversation(core, deps) {
 			toolCalls
 		};
 	};
-	const runLoop = async (sess) => {
+	const runLoop = async (sess, opts) => {
 		const g = groups.get(sess.groupId);
 		const startCount = sess.messageIds.length;
 		let failed = false;
+		let replaceId = opts && opts.replaceMessageId;
+		run.replaceMessageId = replaceId || null;
 		try {
 			while (run.queue.length > 0 && !run.stopping) {
 				const roleId = run.queue.shift();
@@ -1289,16 +1732,27 @@ function createConversation(core, deps) {
 				run.partialReasoning = "";
 				touch();
 				if (!role) continue;
+				const targetId = replaceId;
+				replaceId = void 0;
 				try {
-					const out = await speak(g, sess, role);
-					if (!run.stopping && (out.text || Array.isArray(out.toolCalls) && out.toolCalls.length > 0)) appendMessage(sess, role.id, out.text, {
-						model: role.provider + " / " + role.model,
-						reasoning: out.reasoning,
-						toolCalls: out.toolCalls
-					});
+					const out = await speak(g, sess, role, targetId);
+					if (!run.stopping && (out.text || Array.isArray(out.toolCalls) && out.toolCalls.length > 0)) writeSuccess(sess, role, out, targetId);
+					else if (!run.stopping && targetId) {
+						failed = true;
+						run.currentRoleId = null;
+						run.partial = "";
+						run.partialReasoning = "";
+						run.replaceMessageId = null;
+						writeFailure(sess, role, "模型没有返回内容", targetId);
+						break;
+					}
 				} catch (e) {
 					failed = true;
-					appendMessage(sess, "system", "角色「" + role.name + "」发言失败：" + String(e && e.message || e), { error: true });
+					run.currentRoleId = null;
+					run.partial = "";
+					run.partialReasoning = "";
+					run.replaceMessageId = null;
+					writeFailure(sess, role, e, targetId);
 					break;
 				}
 			}
@@ -1318,9 +1772,13 @@ function createConversation(core, deps) {
 			run.confirmSignal = null;
 			run.childProc = null;
 			run.stopping = false;
+			run.replaceMessageId = null;
 			touch();
 		}
-		if (sess.messageIds.length > startCount) retitle(sess);
+		if (sess.messageIds.length > startCount || opts && opts.replaceMessageId) {
+			retitle(sess);
+			fold(sess);
+		}
 	};
 	return {
 		appendMessage,
@@ -1607,6 +2065,7 @@ function messageJson(m) {
 	if (m.reasoningFull !== void 0) o.reasoningFull = m.reasoningFull;
 	if (m.thinkingSummary !== void 0) o.thinkingSummary = m.thinkingSummary;
 	if (m.error !== void 0) o.error = m.error;
+	if (typeof m.failedRoleId === "string" && m.failedRoleId) o.failedRoleId = m.failedRoleId;
 	if (Array.isArray(m.toolCalls) && m.toolCalls.length > 0) o.toolCalls = m.toolCalls;
 	return o;
 }
@@ -2021,6 +2480,8 @@ function createPersistence(core) {
 		topic: s.topic,
 		...s.namePinned ? { namePinned: true } : {},
 		...s.topicPinned ? { topicPinned: true } : {},
+		...s.constraints && s.constraints.length ? { constraints: s.constraints } : {},
+		...typeof s.constraintsUpToSeq === "number" && s.constraintsUpToSeq > 0 ? { constraintsUpToSeq: s.constraintsUpToSeq } : {},
 		createdAt: s.createdAt,
 		messages: s.messageIds.map((mid) => core.messages.get(mid)).filter(Boolean).map((m) => messageJson(m)).filter(Boolean)
 	});
@@ -2128,6 +2589,9 @@ function createPersistence(core) {
 			if (typeof doc.topic === "string") sess.topic = doc.topic;
 			if (doc.namePinned === true) sess.namePinned = true;
 			if (doc.topicPinned === true) sess.topicPinned = true;
+			const constraints = sanitizeConstraints(doc.constraints);
+			if (constraints.length) sess.constraints = constraints;
+			if (typeof doc.constraintsUpToSeq === "number" && doc.constraintsUpToSeq > 0) sess.constraintsUpToSeq = doc.constraintsUpToSeq;
 			if (typeof doc.createdAt === "number") sess.createdAt = doc.createdAt;
 			let fallbackSeq = 0;
 			for (const m of Array.isArray(doc.messages) ? doc.messages : []) {
@@ -2144,11 +2608,19 @@ function createPersistence(core) {
 					thinkingSummary: m.thinkingSummary !== void 0 ? String(m.thinkingSummary) : void 0,
 					model: m.model,
 					error: m.error,
+					failedRoleId: typeof m.failedRoleId === "string" && m.failedRoleId ? m.failedRoleId : void 0,
 					toolCalls: Array.isArray(m.toolCalls) ? m.toolCalls : void 0,
 					ts: typeof m.ts === "number" ? m.ts : Date.now()
 				});
 				sess.messageIds.push(m.id);
 			}
+			const groupRoles = g.roleIds.map((rid) => core.roles.get(rid)).filter((r) => Boolean(r));
+			let repaired = false;
+			for (const mid of sess.messageIds) {
+				const rec = core.messages.get(mid);
+				if (rec && repairFailedMessage(rec, groupRoles)) repaired = true;
+			}
+			if (repaired) schedulePersist({ session: sid });
 		}
 		core.sessions.set(sid, sess);
 		g.sessionIds.push(sid);
@@ -2223,7 +2695,7 @@ function createPersistence(core) {
 				sessionIds: []
 			};
 			core.groups.set(g.id, g);
-			const sess = core.newSession(g.id, "会话 1");
+			const sess = core.newSession(g.id);
 			g.sessionIds.push(sess.id);
 			autoSessions.push(sess.id);
 		}