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

package/lib/index.js

@@ -46,6 +46,59 @@ function mountOnce(packageName, fn) {
 	});
 }
 //#endregion
+//#region src/core/json.ts
+/** 消息 → 落盘 JSON（可选字段无则省略；兼容保留 error）。 */
+function messageJson(m) {
+	if (!m || typeof m.id !== "string") return null;
+	const o = {
+		id: m.id,
+		speaker: m.speaker,
+		text: String(m.text || ""),
+		ts: typeof m.ts === "number" ? m.ts : Date.now(),
+		seq: typeof m.seq === "number" ? m.seq : 0
+	};
+	if (m.model !== void 0) o.model = m.model;
+	if (m.reasoning !== void 0) o.reasoning = m.reasoning;
+	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;
+}
+/** 角色 → 落盘 JSON（groupId 由目录归属，不再写入）。 */
+function roleJson(r) {
+	const o = {
+		id: r.id,
+		name: String(r.name || "成员"),
+		persona: String(r.persona || ""),
+		provider: String(r.provider || ""),
+		model: String(r.model || ""),
+		enabled: r.enabled !== false,
+		thinking: r.thinking === true
+	};
+	if (r.color) o.color = r.color;
+	if (typeof r.temperature === "number" && !Number.isNaN(r.temperature)) o.temperature = r.temperature;
+	if (typeof r.reasoningEffort === "string" && r.reasoningEffort && r.reasoningEffort !== "default") o.reasoningEffort = r.reasoningEffort;
+	return o;
+}
+/**
+* 宽容 JSON 提取（模型输出/供应商错误原文的统一解析入口）：
+* 取首个 { 至末个 } 的片段解析，仅接受普通对象；失败返回 null。
+* 代码围栏剥离由调用方按需先行处理（供应商错误原文不剥）。
+*/
+function looseJson(raw) {
+	const start = raw.indexOf("{");
+	const end = raw.lastIndexOf("}");
+	if (start < 0 || end <= start) return null;
+	try {
+		const parsed = JSON.parse(raw.slice(start, end + 1));
+		return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+	} catch {
+		return null;
+	}
+}
+//#endregion
 //#region src/core/errors.ts
 const PREFIX = "模型输出异常终止: ";
 const LEGACY_ROLE = /^角色「([^」]+)」发言失败[:：]\s*/;
@@ -226,7 +279,7 @@ function createActions(core, deps) {
 	const { llm, groups, sessions, roles, messages, run } = core;
 	const { touch, snapshot, schedulePersist, dropDirty, appendMessage, runLoop, wakeConfirm, killChild, browse, fileSearch, disposeFileSearch } = deps;
 	const mutate = (args) => {
-		const op = args && args.op;
+		const op = args.op;
 		if (op === "createGroup") {
 			const g = {
 				id: core.nid("grp"),
@@ -1117,18 +1170,11 @@ function sanitizeConstraints(raw) {
 * 解析折叠模型输出。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;
-	}
+	const o = looseJson(raw.replace(/```(?:json)?/g, ""));
+	if (o === null) return null;
+	if (!Object.prototype.hasOwnProperty.call(o, "constraints")) return null;
+	if (!Array.isArray(o.constraints)) return null;
+	return sanitizeConstraints(o.constraints);
 }
 /** 本批无用户消息时，新的已定/否决降为未决。 */
 function downgradeWithoutUser(list, hasUser) {
@@ -1144,9 +1190,13 @@ function constraintBlock(list) {
 	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) => {
+//#region src/host/engine/defaults.ts
+/**
+* 引擎共享小件：DSH 默认模型读取 + 发言人展示名（retitle / fold / conversation 共用）。
+* @module dsh-group-chat/host/engine/defaults
+*/
+/** DSH 默认模型（agentDefaultModel 服务缺位或未配置时返回 null，调用方静默跳过）。 */
+const defaultModel = (core) => {
 	try {
 		const svc = core.ctx.reflect.get("agentDefaultModel");
 		const sel = svc ? svc.currentSelection() : null;
@@ -1158,6 +1208,10 @@ const defaultModel$1 = (core) => {
 		return null;
 	}
 };
+/** 发言人展示名（roles 表内查角色名；user/system 固定文案，见 speakerLabel）。 */
+const speakerNameOf = (roles, speaker) => speakerLabel(speaker, roles.get(speaker)?.name);
+//#endregion
+//#region src/host/engine/fold.ts
 /**
 * 每轮 send 结束后折叠窗口外约束：fire-and-forget、不产生消息、静默失败。
 * 同会话去重；会话已清空则 abort。内存 {constraints, constraintsUpToSeq} 一次挂上。
@@ -1166,12 +1220,11 @@ 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 input = takeFoldBatch(squeezed, (m) => speakerNameOf(roles, m.speaker));
 		const watermark = squeezedMaxSeq(input.consumed);
 		if (watermark <= 0) return;
 		const commit = (next) => {
@@ -1186,7 +1239,7 @@ function createFold(core, deps) {
 			commit(void 0);
 			return;
 		}
-		const dm = defaultModel$1(core);
+		const dm = defaultModel(core);
 		if (!dm) return;
 		folding.add(sess.id);
 		try {
@@ -1240,47 +1293,26 @@ function createFold(core, deps) {
 //#region src/host/engine/retitle.ts
 /** 仍是新建占位名（含改名之前的「会话 N」存量），自动标题尚未落地。 */
 const isPlaceholderName = (name) => name === "新会话" || /^会话 \d+$/.test(name);
-/** DSH 默认模型（agentDefaultModel 服务缺位或未配置时返回 null，调用方静默跳过）。 */
-const defaultModel = (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;
-	}
-};
 /** 命名输入：最近 40 条非系统消息的紧凑转写（每条 500 字符封顶，命名不需要全文）。 */
 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.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));
+		out.push("【" + speakerNameOf(core.roles, m.speaker) + "】" + m.text.replace(/\s+/g, " ").slice(0, 500));
 	}
 	return out.join("\n");
 };
-/** 宽容解析模型输出：剥代码围栏 → 取首个 { 至末个 } 的 JSON → 校验并封顶字段。 */
+/** 宽容解析模型输出：剥代码围栏 → looseJson → 校验并封顶字段。 */
 const parseRetitle = (raw) => {
-	const body = raw.replace(/```(?:json)?/g, "");
-	const l = body.indexOf("{");
-	const r = body.lastIndexOf("}");
-	if (l < 0 || r <= l) return {};
-	try {
-		const o = JSON.parse(body.slice(l, r + 1));
-		const name = typeof o.name === "string" ? o.name.trim() : "";
-		const topic = typeof o.topic === "string" ? o.topic.trim() : "";
-		return {
-			name: name ? name.slice(0, 24) : void 0,
-			topic: topic ? topic.slice(0, 120) : void 0
-		};
-	} catch {
-		return {};
-	}
+	const o = looseJson(raw.replace(/```(?:json)?/g, ""));
+	if (!o) return {};
+	const name = typeof o.name === "string" ? o.name.trim() : "";
+	const topic = typeof o.topic === "string" ? o.topic.trim() : "";
+	return {
+		name: name ? name.slice(0, 24) : void 0,
+		topic: topic ? topic.slice(0, 120) : void 0
+	};
 };
 /**
 * 每轮结束后根据聊天内容整理会话名称与主题：后台 fire-and-forget、不产生
@@ -1382,7 +1414,6 @@ function createConversation(core, deps) {
 		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"),
@@ -1410,60 +1441,56 @@ function createConversation(core, deps) {
 		schedulePersist({ session: sess.id });
 		return msg;
 	};
+	/** 原地覆盖既有消息（重试槽位）；目标不存在或不属于本会话时返回 false，由调用方走追加。 */
+	const overwriteMessage = (sess, replaceId, patch) => {
+		if (!replaceId) return false;
+		const existing = messages.get(replaceId);
+		if (!existing || existing.sessionId !== sess.id) return false;
+		Object.assign(existing, patch, { ts: Date.now() });
+		touch();
+		schedulePersist({ session: sess.id });
+		return true;
+	};
 	/** 把失败回合写成该角色的消息（speaker = 角色 id），不再用系统胶囊顶替。 */
 	const writeFailure = (sess, role, err, replaceId) => {
 		const raw = unwrapSpeakFailure(String(err && err.message || err));
+		const model = role.provider + " / " + role.model;
 		const extra = {
 			error: true,
 			failedRoleId: role.id,
-			model: role.provider + " / " + role.model
+			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;
-			}
-		}
+		if (overwriteMessage(sess, replaceId, {
+			speaker: role.id,
+			text: raw,
+			...extra,
+			reasoning: void 0,
+			reasoningFull: void 0,
+			thinkingSummary: void 0,
+			toolCalls: void 0
+		})) return;
 		appendMessage(sess, role.id, raw, extra);
 	};
 	/** 成功发言写入：replaceId 存在则原地覆盖失败卡。 */
 	const writeSuccess = (sess, role, out, replaceId) => {
-		const extra = {
-			model: role.provider + " / " + role.model,
+		const model = role.provider + " / " + role.model;
+		const toolCalls = Array.isArray(out.toolCalls) && out.toolCalls.length > 0 ? out.toolCalls : void 0;
+		if (overwriteMessage(sess, replaceId, {
+			speaker: role.id,
+			text: out.text,
+			error: void 0,
+			failedRoleId: void 0,
+			model,
+			reasoning: out.reasoning,
+			reasoningFull: void 0,
+			thinkingSummary: void 0,
+			toolCalls
+		})) return;
+		appendMessage(sess, role.id, out.text, {
+			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) => {
@@ -1471,10 +1498,10 @@ function createConversation(core, deps) {
 		for (const mid of prefixIds(sess.messageIds, skipId).slice(-40)) {
 			const m = messages.get(mid);
 			if (!m || m.id === skipId || m.error) continue;
-			out.push(formatTranscriptLine(m, nameOf(m.speaker)));
+			out.push(formatTranscriptLine(m, speakerNameOf(roles, m.speaker)));
 		}
 		const live = out.join("\n\n");
-		const temp = tempTranscript(squeezedMessages(messages, sess, skipId), (m) => nameOf(m.speaker));
+		const temp = tempTranscript(squeezedMessages(messages, sess, skipId), (m) => speakerNameOf(roles, m.speaker));
 		if (!temp) return live;
 		if (!live) return temp;
 		return temp + "\n\n" + live;
@@ -1671,6 +1698,7 @@ function createConversation(core, deps) {
 			});
 			for (const tc of round.tcs) {
 				if (run.stopping) break;
+				if (wsRoot === null) break;
 				const res = await tools.executeTool(g, wsRoot, tc);
 				const output = String(res.output || "");
 				toolCalls.push({
@@ -1718,12 +1746,13 @@ function createConversation(core, deps) {
 		};
 	};
 	const runLoop = async (sess, opts) => {
-		const g = groups.get(sess.groupId);
+		const g = groups.get(sess.groupId) ?? null;
 		const startCount = sess.messageIds.length;
 		let failed = false;
 		let replaceId = opts && opts.replaceMessageId;
 		run.replaceMessageId = replaceId || null;
 		try {
+			if (!g) return;
 			while (run.queue.length > 0 && !run.stopping) {
 				const roleId = run.queue.shift();
 				const role = roles.get(roleId);
@@ -2049,43 +2078,6 @@ function createMaterials(core) {
 	};
 }
 //#endregion
-//#region src/core/json.ts
-/** 消息 → 落盘 JSON（可选字段无则省略；兼容保留 error）。 */
-function messageJson(m) {
-	if (!m || typeof m.id !== "string") return null;
-	const o = {
-		id: m.id,
-		speaker: m.speaker,
-		text: String(m.text || ""),
-		ts: typeof m.ts === "number" ? m.ts : Date.now(),
-		seq: typeof m.seq === "number" ? m.seq : 0
-	};
-	if (m.model !== void 0) o.model = m.model;
-	if (m.reasoning !== void 0) o.reasoning = m.reasoning;
-	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;
-}
-/** 角色 → 落盘 JSON（groupId 由目录归属，不再写入）。 */
-function roleJson(r) {
-	const o = {
-		id: r.id,
-		name: String(r.name || "成员"),
-		persona: String(r.persona || ""),
-		provider: String(r.provider || ""),
-		model: String(r.model || ""),
-		enabled: r.enabled !== false,
-		thinking: r.thinking === true
-	};
-	if (r.color) o.color = r.color;
-	if (typeof r.temperature === "number" && !Number.isNaN(r.temperature)) o.temperature = r.temperature;
-	if (typeof r.reasoningEffort === "string" && r.reasoningEffort && r.reasoningEffort !== "default") o.reasoningEffort = r.reasoningEffort;
-	return o;
-}
-//#endregion
 //#region src/host/persistence/store.ts
 /**
 * 持久化（PERSISTENCE.md v2.1：会话级文件隔离）。

package/lib/types/client/components/AsidePanel.d.ts

@@ -1,31 +1,15 @@
 /**
- * 右侧成员与工作区栏组件
+ * 右侧成员与工作区栏组件。工作区目录编辑态（草稿、文件浏览器）为栏内自有状态。
  * @module dsh-group-chat/client/components
  */
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 import { type ClientSnapshot, type SnapshotRole } from '../lib/model.ts';
 interface AsidePanelProps {
     snap: ClientSnapshot;
     group: ClientSnapshot['groups'][number];
     asideOpen: boolean;
-    wsDraft: string | null;
-    setWsDraft: (val: string | null) => void;
-    fileBrowser: {
-        open: boolean;
-        loading: boolean;
-        list: import('../../core/types.ts').BrowseResult | null;
-        error: string;
-    } | null;
-    setFileBrowser: (val: {
-        open: boolean;
-        loading: boolean;
-        list: import('../../core/types.ts').BrowseResult | null;
-        error: string;
-    } | null) => void;
     mutate: (args: Record<string, unknown>) => Promise<unknown>;
-    openRoleEditor: (role: SnapshotRole | null) => Promise<void>;
-    openBrowser: (path: string | undefined) => Promise<void>;
-    selectCurrentDir: () => void;
+    openRoleEditor: (role: SnapshotRole | null) => void;
 }
 export declare function AsidePanel(props: AsidePanelProps): ReactNode;
 export {};

package/lib/types/client/components/NavPanel.d.ts

@@ -1,9 +1,15 @@
 /**
- * 左侧导航栏组件
+ * 左侧导航栏组件（群组 → 会话目录树；群组行与会话行共用重命名/删除三件套）。
  * @module dsh-group-chat/client/components
  */
 import type { ReactNode } from 'react';
 import { type ClientSnapshot } from '../lib/model.ts';
+/** 目录树节点编辑态形状（群组/会话共用）。 */
+type NodeEdit = {
+    kind: 'group' | 'session';
+    id: string;
+    value: string;
+};
 interface NavPanelProps {
     snap: ClientSnapshot;
     search: string;
@@ -15,16 +21,8 @@ interface NavPanelProps {
     setGid: (val: string) => void;
     setSid: (val: string) => void;
     setPartsSel: (val: string[] | null) => void;
-    renameDraft: {
-        kind: 'group' | 'session';
-        id: string;
-        value: string;
-    } | null;
-    setRenameDraft: (val: {
-        kind: 'group' | 'session';
-        id: string;
-        value: string;
-    } | null) => void;
+    renameDraft: NodeEdit | null;
+    setRenameDraft: (val: NodeEdit | null) => void;
     confirmDel: {
         kind: 'group' | 'session';
         id: string;

package/lib/types/client/components/RoleDrawer.d.ts

@@ -7,11 +7,12 @@ import { type ModelsResponse, type RoleDraft } from '../lib/model.ts';
 export interface RoleDrawerProps {
     draft: RoleDraft;
     set: (draft: RoleDraft) => void;
+    /** 保存目标群组（upsertRole 落库）。 */
+    groupId: string;
     models: ModelsResponse | null;
     modelsError: string | null;
     onRetryModels: () => void;
-    onSave: () => void;
+    mutate: (args: Record<string, unknown>) => Promise<unknown>;
     onCancel: () => void;
-    formError: string;
 }
 export declare function RoleDrawer(props: RoleDrawerProps): ReactNode;

package/lib/types/client/components/ToolRow.d.ts

@@ -3,7 +3,7 @@
  * @module dsh-group-chat/client/ToolRow
  */
 import { type ReactNode } from 'react';
-import type { ToolCallView } from '../lib/model.ts';
+import type { ToolCallRecord } from '../../core/types.ts';
 export declare function ToolRow(props: {
-    c: ToolCallView;
+    c: ToolCallRecord;
 }): ReactNode;

package/lib/types/client/hooks/useGroupChatState.d.ts

@@ -47,26 +47,10 @@ export declare function useGroupChatState(): {
     setConfirmClear: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     roleDraft: RoleDraft | null;
     setRoleDraft: import("react").Dispatch<import("react").SetStateAction<RoleDraft | null>>;
-    roleFormError: string;
-    setRoleFormError: import("react").Dispatch<import("react").SetStateAction<string>>;
     models: ModelsResponse | null;
     setModels: import("react").Dispatch<import("react").SetStateAction<ModelsResponse | null>>;
     modelsError: string | null;
     setModelsError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
-    fileBrowser: {
-        open: boolean;
-        loading: boolean;
-        list: import("../../core/types.ts").BrowseResult | null;
-        error: string;
-    } | null;
-    setFileBrowser: import("react").Dispatch<import("react").SetStateAction<{
-        open: boolean;
-        loading: boolean;
-        list: import("../../core/types.ts").BrowseResult | null;
-        error: string;
-    } | null>>;
-    wsDraft: string | null;
-    setWsDraft: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     partsSel: string[] | null;
     setPartsSel: import("react").Dispatch<import("react").SetStateAction<string[] | null>>;
     rounds: number;

package/lib/types/client/lib/model.d.ts

@@ -2,7 +2,7 @@
  * 浏览器半共享常量与小工具（纯函数，无 React 依赖）。
  * @module dsh-group-chat/client/model
  */
-import type { RoleRecord, Snapshot, ToolCallRecord } from '../../core/types.ts';
+import type { Snapshot } from '../../core/types.ts';
 /** 会话列表状态派生与文案（core 纯函数，供 NavPanel 渲染）。 */
 export { sessStatus, SESS_STATUS_LABEL, type SessStatus } from '../../core/status.ts';
 /** 角色标识色调色板（与宿主半一致）。 */
@@ -72,9 +72,3 @@ export interface RoleDraft {
 }
 export declare function draftFromRole(role: SnapshotRole): RoleDraft;
 export declare function blankDraft(): RoleDraft;
-/** 工具调用行的展示参数。 */
-export type ToolCallView = ToolCallRecord;
-/** 草稿是否可作为角色落库（宿主侧再校验一次）。 */
-export declare function draftMissing(draft: RoleDraft): string;
-/** RoleRecord 兼容视图（快照角色行即其展示子集）。 */
-export type RoleView = RoleRecord;

package/lib/types/client/utils/utils.d.ts

@@ -13,14 +13,14 @@ export declare function execCommand(commandId: 'delete' | 'insertHTML' | 'insert
  * DIV/P 块前补换行（防粘贴残留的块级包裹）。
  */
 export declare function serializeInput(root: HTMLElement): string;
-/** @角色芯片的 HTML（原子元素：contenteditable=false + draggable，退格整删）。 */
+/** @角色芯片的 HTML（原子元素：contenteditable=false + draggable，退格整删；fresh=插入后需营救选区，加 data-new 标记）。 */
 export declare function chipHtml(role: {
     id: string;
     name: string;
     color?: string;
-}): string;
-/** @文件芯片的 HTML（原子元素：contenteditable=false + draggable，退格整删）。 */
-export declare function fileChipHtml(path: string, kind: 'file' | 'directory'): string;
+}, fresh?: boolean): string;
+/** @文件芯片的 HTML（原子元素：contenteditable=false + draggable，退格整删；fresh 同 chipHtml）。 */
+export declare function fileChipHtml(path: string, kind: 'file' | 'directory', fresh?: boolean): string;
 /**
  * 光标前的活跃 @token（角色或文件弹层触发判定）。
  *

package/lib/types/core/json.d.ts

@@ -7,3 +7,9 @@ import type { MessageRecord, RoleRecord } from './types.ts';
 export declare function messageJson(m: Partial<MessageRecord> | undefined): Record<string, unknown> | null;
 /** 角色 → 落盘 JSON（groupId 由目录归属，不再写入）。 */
 export declare function roleJson(r: Partial<RoleRecord>): Record<string, unknown>;
+/**
+ * 宽容 JSON 提取（模型输出/供应商错误原文的统一解析入口）：
+ * 取首个 { 至末个 } 的片段解析，仅接受普通对象；失败返回 null。
+ * 代码围栏剥离由调用方按需先行处理（供应商错误原文不剥）。
+ */
+export declare function looseJson(raw: string): Record<string, unknown> | null;