dsh-plugin-prompt-tool 0.4.2 → 0.6.0

package/lib/prompt-configs-ThS4iXPg.mjs

@@ -0,0 +1,771 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { Pair, Scalar, YAMLMap, YAMLSeq, parse, parseDocument } from "yaml";
+import { basename, dirname, join, resolve, sep } from "node:path";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+//#region src/host/paths.ts
+/** host 数据层的部署路径与序数常量（settings 层与运行时共用，避免 host→config 反向依赖）。 */
+/**
+* 包内 skills 目录。
+* 源码位于 src/host/（../../skills = 包根/skills），构建后内联进 lib/（层级变浅）。
+* 统一向上查找最近包含 skills/manifest.json 的包根，两种形态都正确。
+*/
+const SKILLS_DIR = (() => {
+	let dir = dirname(fileURLToPath(import.meta.url));
+	for (let depth = 0; depth < 6; depth += 1) {
+		if (existsSync(join(dir, "skills", "manifest.json"))) return join(dir, "skills");
+		const parent = dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return join(dir, "skills");
+})();
+/**
+* 部署路径默认值；凡是不同部署可能需要不同值的参数都通过 Config 暴露，
+* cordis.yml 可以覆盖，无需改代码。
+* 与官方 dsh-home-paths.resolveDshHome 语义对齐：
+* 未设置 / 空串 / 纯空白回退 OS home 下的 .dsh；支持 ~、~/、~\；
+* 相对路径按进程 cwd 解析为绝对路径，避免生成目录随运行目录漂移。
+*/
+function resolveDshHome() {
+	const ambient = process.env.DSH_HOME;
+	if (typeof ambient !== "string" || ambient.trim().length === 0) return join(homedir(), ".dsh");
+	const expanded = ambient === "~" ? homedir() : ambient.startsWith("~/") || ambient.startsWith("~\\") ? join(homedir(), ambient.slice(2)) : ambient;
+	return resolve(expanded);
+}
+const DSH_HOME = resolveDshHome();
+const DEFAULT_RESIDENT_AGENTS_PATH = join(DSH_HOME, "AGENTS.md");
+/**
+* 预设根：官方 USER_PRESET_DIR（DSH_HOME/.agent-presets）。
+* 每个预设一个官方预设目录（agent.cordis.yml 组合本体 + preset.yml 参数），
+* 宿主 agent-presets 直接可挂载；共享引擎在 .engine（点前缀 → discovery 跳过）。
+*/
+const DEFAULT_PRESET_DIR = join(DSH_HOME, ".agent-presets");
+join(DEFAULT_PRESET_DIR, ".engine");
+/** 旧版用户预设目录（~/.dsh/presets；迁移后归档为 presets.bak-*）。 */
+const LEGACY_USER_PRESETS_DIR = join(DSH_HOME, "presets");
+/** 旧版容器根（.agent-presets/prompt-tool；迁移后归档为 prompt-tool.bak-*）。 */
+const LEGACY_CONTAINER_DIR = join(DEFAULT_PRESET_DIR, "prompt-tool");
+const DEFAULT_SKILLS_DIR = SKILLS_DIR;
+//#endregion
+//#region src/host/manifest.ts
+/**
+* manifest — 预设模板单一参数 YAML(preset.yml)的加载与引擎参数解析。
+*
+* 一个预设 = 一个 preset.yml:
+*   - modules/params/content/meta 全部是直读参数,无模板语法;
+*   - 默认提示词配置由引擎按 params 生成(见 write-preset),promptConfigs 仅为可选覆盖;
+*   - 组合模块中的 __TOKEN__ 由引擎内部 renderEngineTokens 按 params 生成,
+*     不再暴露到参数文件。
+* 本模块负责参数归一化与引擎 token 渲染;所有 anchored 专属行为都在引擎内部。
+*/
+/** 包根 preset/ 目录(配置/模板文件夹):兼容源码运行(src/host)与打包运行(lib/)。 */
+function packagePresetDir() {
+	const candidates = [new URL("../preset/", import.meta.url), new URL("../../preset/", import.meta.url)];
+	for (const candidate of candidates) {
+		const dir = fileURLToPath(candidate);
+		if (existsSync(dir)) return dir;
+	}
+	throw new Error("prompt-tool: cannot locate package preset/ directory");
+}
+/** 包根 engine/ 目录(插件引擎,与配置文件夹分离):兼容源码与打包运行。 */
+function packageEngineDir() {
+	const candidates = [new URL("../engine/", import.meta.url), new URL("../../engine/", import.meta.url)];
+	for (const candidate of candidates) {
+		const dir = fileURLToPath(candidate);
+		if (existsSync(join(dir, "prompt-config-engine.mjs"))) return dir;
+	}
+	throw new Error("prompt-tool: cannot locate package engine/ directory");
+}
+/** 加载某个预设模板的单一参数文件 preset/<name>/preset.yml。 */
+function loadPresetSpec(dir) {
+	const raw = readFileSync(join(dir, "preset.yml"), "utf8");
+	const parsed = parse(raw, { logLevel: "silent" });
+	if (parsed === null || typeof parsed !== "object") throw new Error(`preset ${join(dir, "preset.yml")} is not a YAML map`);
+	if (typeof parsed.id !== "string" || parsed.id.length === 0) parsed.id = basename(dir);
+	return parsed;
+}
+/** 读取预设模板内容资产(presetText / agentsText);模板缺失时静默降级。
+*  模板目录按 resolvePresetDir 解析（用户自定义预设优先，包内模板回退）。 */
+function loadPresetContent(template = "anchored") {
+	try {
+		const spec = loadPresetSpec(resolvePresetDir(template));
+		return {
+			presetText: typeof spec.content?.presetText === "string" ? spec.content.presetText : "",
+			agentsText: typeof spec.content?.agentsText === "string" ? spec.content.agentsText : ""
+		};
+	} catch {
+		return {
+			presetText: "",
+			agentsText: ""
+		};
+	}
+}
+const asString = (value, fallback = "") => {
+	if (typeof value === "string") return value;
+	if (value === void 0 || value === null) return fallback;
+	return String(value);
+};
+/** 预设根：官方 USER_PRESET_DIR（~/.dsh/.agent-presets），导入/新建/种子化的预设都放这里。 */
+function userPresetsDir() {
+	return DEFAULT_PRESET_DIR;
+}
+/** 在指定扫描目录内按 template 定位预设目录：目录名精确匹配优先，preset.yml 的 id 匹配兜底。 */
+function findPresetDir(scanDir, template) {
+	const exact = join(scanDir, template);
+	if (existsSync(join(exact, "preset.yml"))) return exact;
+	try {
+		for (const entry of readdirSync(scanDir, { withFileTypes: true })) {
+			if (!entry.isDirectory()) continue;
+			const dir = join(scanDir, entry.name);
+			try {
+				if (loadPresetSpec(dir).id === template) return dir;
+			} catch {}
+		}
+	} catch {}
+}
+/**
+* 解析预设模板目录：用户自定义优先，包内模板回退。
+* 目录名与 preset.yml id 双匹配（UI 切换值=目录名；旧 settings 存量值=id 也兼容）。
+*/
+function resolvePresetDir(template) {
+	return findPresetDir(userPresetsDir(), template) ?? findPresetDir(packagePresetDir(), template) ?? join(packagePresetDir(), template);
+}
+/** 可用预设清单：全部来自预设根 ~/.dsh/.agent-presets（官方预设目录，含 agent.cordis.yml
+*  即被宿主挂载；点前缀目录与无 preset.yml 的官方目录跳过，不占本插件列表）。 */
+function listPresets() {
+	const scan = (dir) => {
+		try {
+			return readdirSync(dir, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.name.startsWith(".")).flatMap((entry) => {
+				try {
+					const spec = loadPresetSpec(join(dir, entry.name));
+					if (typeof spec.id !== "string" || spec.id.length === 0) return [];
+					return [{
+						id: entry.name,
+						name: spec.name,
+						user: true,
+						...typeof spec.description === "string" && spec.description.length > 0 ? { description: spec.description } : {},
+						...spec.meta !== void 0 && spec.meta !== null ? { meta: spec.meta } : {}
+					}];
+				} catch {
+					return [];
+				}
+			});
+		} catch {
+			return [];
+		}
+	};
+	const byId = /* @__PURE__ */ new Map();
+	for (const preset of scan(userPresetsDir())) byId.set(preset.id, preset);
+	return [...byId.values()].sort((a, b) => a.id.localeCompare(b.id));
+}
+/** 插件目录模板清单（「新建」选择器与首次种子化数据源；不直接出现在预设列表）。 */
+function listBuiltinTemplates() {
+	try {
+		return readdirSync(packagePresetDir(), { withFileTypes: true }).filter((entry) => entry.isDirectory()).filter((entry) => entry.name !== "custom").flatMap((entry) => {
+			try {
+				const spec = loadPresetSpec(join(packagePresetDir(), entry.name));
+				return [{
+					id: entry.name,
+					name: spec.name
+				}];
+			} catch {
+				return [];
+			}
+		}).sort((a, b) => a.id.localeCompare(b.id));
+	} catch {
+		return [];
+	}
+}
+/** 插件状态文件（DSH_HOME 下，预设根之外）：与用户资产解耦，删除/备份/迁移预设根不影响状态。
+*  原子写（tmp+rename），避免半写文件。 */
+function stateFilePath() {
+	return join(DSH_HOME, ".prompt-tool-state.json");
+}
+/** 读插件状态；文件缺失/损坏返回空对象（按未标记处理，触发首次动作）。 */
+function readPluginState() {
+	try {
+		const parsed = JSON.parse(readFileSync(stateFilePath(), "utf8"));
+		return parsed !== null && typeof parsed === "object" ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+/** 原子写插件状态（tmp+rename）。 */
+function writePluginState(state) {
+	const file = stateFilePath();
+	const tmp = `${file}.tmp`;
+	writeFileSync(tmp, JSON.stringify(state, null, 2), "utf8");
+	renameSync(tmp, file);
+}
+/** 首次启动种子化：把插件目录全部内置模板复制到预设根（state.seeded 后不再自动补）。
+*  用户删除的预设不会自动复活；升级新增的模板用「新建」按需复制。
+*  兼容旧版预设根内 .pt-seeded 标记：存在即视为已种子化，并迁入状态文件后删除。 */
+function ensurePresetSeed() {
+	const root = userPresetsDir();
+	const legacyMark = join(root, ".pt-seeded");
+	const state = readPluginState();
+	if (state.seeded === true || existsSync(legacyMark)) {
+		if (existsSync(legacyMark)) try {
+			writePluginState({
+				...state,
+				seeded: true
+			});
+			rmSync(legacyMark, { force: true });
+		} catch {}
+		return { created: [] };
+	}
+	const created = [];
+	try {
+		mkdirSync(root, { recursive: true });
+		for (const entry of readdirSync(packagePresetDir(), { withFileTypes: true })) {
+			if (!entry.isDirectory() || entry.name.startsWith(".")) continue;
+			const target = join(root, entry.name);
+			if (existsSync(target)) continue;
+			cpSync(join(packagePresetDir(), entry.name), target, { recursive: true });
+			created.push(entry.name);
+		}
+		writePluginState({
+			...readPluginState(),
+			seeded: true
+		});
+	} catch {}
+	return { created };
+}
+/** 从插件目录复制内置预设到预设根（新建/还原）。
+*  autoSuffix=true（自定义预设入口）时同名自动递增（custom → custom-2 → …）；否则同名拒绝。 */
+function cloneBuiltinPreset(id, autoSuffix = false) {
+	if (typeof id !== "string" || id.length === 0 || id === "." || id === ".." || id.includes("/") || id.includes("\\")) return {
+		ok: false,
+		message: `非法预设 id：${id}`
+	};
+	const builtin = findPresetDir(packagePresetDir(), id);
+	if (builtin === void 0) return {
+		ok: false,
+		message: `预设 ${id} 不是包内置预设`
+	};
+	let targetId = id;
+	let target = join(userPresetsDir(), targetId);
+	if (existsSync(target)) {
+		if (!autoSuffix) return {
+			ok: false,
+			message: `用户目录已存在同名预设 ${id}，请先删除再新建`
+		};
+		for (let suffix = 2;; suffix++) {
+			targetId = `${id}-${suffix}`;
+			target = join(userPresetsDir(), targetId);
+			if (!existsSync(target)) break;
+		}
+	}
+	try {
+		mkdirSync(userPresetsDir(), { recursive: true });
+		cpSync(builtin, target, {
+			recursive: true,
+			force: true
+		});
+		return {
+			ok: true,
+			id: targetId
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			message: `新建预设失败：${error instanceof Error ? error.message : String(error)}`
+		};
+	}
+}
+/** 复制用户预设目录为新预设（id 自动递增：<id>-copy / <id>-copy-2 / …）。
+*  复制的是用户目录完整副本（preset.yml / agent.cordis.yml / prompt-configs /
+*  内容资产 / 覆盖文件），与「从内置模板新建」互补：后者还原模板，前者备份现状。 */
+function duplicateUserPreset(id, presetRoot = userPresetsDir()) {
+	if (typeof id !== "string" || id.length === 0 || id === "." || id === ".." || id.includes("/") || id.includes("\\")) return {
+		ok: false,
+		message: `非法预设 id：${id}`
+	};
+	const root = resolve(presetRoot);
+	const source = resolve(join(root, id));
+	const rootResolved = resolve(root);
+	if (source !== rootResolved && !source.startsWith(rootResolved + sep)) return {
+		ok: false,
+		message: `预设路径越界：${id}`
+	};
+	if (!existsSync(source)) return {
+		ok: false,
+		message: `预设 ${id} 不存在`
+	};
+	let targetId = `${id}-copy`;
+	let target = join(root, targetId);
+	for (let suffix = 2; existsSync(target); suffix++) {
+		targetId = `${id}-copy${suffix}`;
+		target = join(root, targetId);
+	}
+	try {
+		mkdirSync(root, { recursive: true });
+		cpSync(source, target, {
+			recursive: true,
+			force: true
+		});
+		return {
+			ok: true,
+			id: targetId
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			message: `复制预设失败：${error instanceof Error ? error.message : String(error)}`
+		};
+	}
+}
+/** 在系统文件管理器中打开预设目录（尽力而为：无桌面环境时打开失败也返回路径供 UI 展示）。 */
+function openPresetLocation(id, presetRoot = userPresetsDir()) {
+	const isBareId = typeof id === "string" && id.length > 0 && id !== "." && id !== ".." && !id.includes("/") && !id.includes("\\");
+	const isCardPath = typeof id === "string" && /^\/\.[a-zA-Z0-9_-]+\/[^/\\]+$/.test(id);
+	if (!isBareId && !isCardPath) return {
+		ok: false,
+		message: `非法预设 id：${id}`,
+		path: ""
+	};
+	const dir = resolve(join(presetRoot, id));
+	const rootResolved = resolve(presetRoot);
+	if (dir !== rootResolved && !dir.startsWith(rootResolved + sep)) return {
+		ok: false,
+		message: `预设路径越界：${id}`,
+		path: dir
+	};
+	if (!existsSync(dir)) return {
+		ok: false,
+		message: `预设 ${id} 不存在`,
+		path: dir
+	};
+	try {
+		const command = process.platform === "win32" ? "explorer" : process.platform === "darwin" ? "open" : "xdg-open";
+		spawn(command, [dir], {
+			detached: true,
+			stdio: "ignore"
+		}).unref();
+		return {
+			ok: true,
+			path: dir
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			message: `打开目录失败：${error instanceof Error ? error.message : String(error)}`,
+			path: dir
+		};
+	}
+}
+/**
+* 保存预设参数：写激活预设目录 preset.yml 的 params（merge）/ promptConfigs（整体替换）。
+* parseDocument 保留注释与未知键（preset.yml 模板含大量注释）；空值键跳过
+* （保留 preset.yml 模板默认）。写入后删除 prompt-tool.overrides.yml（旧参数覆盖
+* 通道残留——参数已并入 preset.yml，避免旧值覆盖新值）。
+*/
+function savePresetParams(presetRoot, templateName, params, promptConfigs, variables, variablesEnabled) {
+	const file = join(presetRoot, templateName, "preset.yml");
+	if (!existsSync(file)) throw new Error(`preset ${templateName} 无 preset.yml`);
+	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
+	if (params !== void 0) for (const [key, value] of Object.entries(params)) {
+		if (value === void 0 || value === null || key.trim().length === 0) continue;
+		doc.setIn(["params", key], value);
+	}
+	if (promptConfigs !== void 0) {
+		const cleaned = promptConfigs.map((config) => {
+			if (config === null || typeof config !== "object" || Array.isArray(config)) return config;
+			const vars = config.variables;
+			if (vars === null || typeof vars !== "object" || Array.isArray(vars)) return config;
+			const kept = Object.fromEntries(Object.entries(vars).filter(([key]) => key.trim().length > 0));
+			const next = { ...config };
+			if (Object.keys(kept).length > 0) next.variables = kept;
+			else delete next.variables;
+			return next;
+		});
+		doc.setIn(["promptConfigs"], cleaned);
+	}
+	if (variables !== void 0) {
+		const kept = Object.fromEntries(Object.entries(variables).filter(([key, value]) => key.trim().length > 0 && typeof value === "string"));
+		if (Object.keys(kept).length > 0) doc.setIn(["variables"], kept);
+		else doc.deleteIn(["variables"]);
+		for (const [key, value] of Object.entries(variables)) {
+			if (typeof value !== "string") continue;
+			doc.deleteIn(["params", key]);
+		}
+	}
+	if (variablesEnabled !== void 0) {
+		if (variablesEnabled) doc.deleteIn(["variablesEnabled"]);
+		else doc.setIn(["variablesEnabled"], false);
+	}
+	writeFileSync(file, doc.toString(), "utf8");
+	rmSync(join(presetRoot, templateName, "prompt-tool.overrides.yml"), { force: true });
+}
+/** 删除预设目录（预设根/<id>；含同名导入的 .bak-* 备份目录）。
+*  仅作用于预设根（官方 USER_PRESET_DIR），包内置模板天然不受影响；路径越界与非法 id 拒绝。
+*  删除后宿主 agent-presets 目录列表自然不再出现该预设（官方 roster 即目录列表）。 */
+function removeUserPreset(id, presetRoot = userPresetsDir()) {
+	if (typeof id !== "string" || id.length === 0 || id === "." || id === ".." || id.includes("/") || id.includes("\\")) return {
+		ok: false,
+		message: `非法预设 id：${id}`
+	};
+	const root = presetRoot;
+	const target = resolve(join(root, id));
+	const rootResolved = resolve(root);
+	if (target !== rootResolved && !target.startsWith(rootResolved + sep)) return {
+		ok: false,
+		message: `预设路径越界：${id}`
+	};
+	if (existsSync(target)) try {
+		rmSync(target, {
+			recursive: true,
+			force: true
+		});
+		return { ok: true };
+	} catch (error) {
+		return {
+			ok: false,
+			message: `删除失败：${error instanceof Error ? error.message : String(error)}`
+		};
+	}
+	return {
+		ok: false,
+		message: `预设 ${id} 不存在（预设根 ~/.dsh/.agent-presets）`
+	};
+}
+/** 从导入的 preset.yml 文本解析预设 id（非法/缺失回退目录名）。 */
+function parseImportedPresetId(presetYaml, fallback) {
+	try {
+		const parsed = parse(presetYaml, { logLevel: "silent" });
+		return typeof parsed?.id === "string" && /^[a-zA-Z0-9\u4e00-\u9fff][a-zA-Z0-9\u4e00-\u9fff-]*$/.test(parsed.id) ? parsed.id : fallback;
+	} catch {
+		return fallback;
+	}
+}
+/** on/off 等字面开关归一化为布尔。 */
+function normalizeParam(value) {
+	if (value === "on") return true;
+	if (value === "off") return false;
+	return value;
+}
+/** 预设 params(默认参数)与运行时 settings 合并;settings 值优先。 */
+function resolvePresetParams(spec, runtime) {
+	const params = {};
+	for (const [key, value] of Object.entries(spec.params ?? {})) params[key] = normalizeParam(value);
+	for (const [key, value] of Object.entries(runtime)) if (value !== void 0) params[key] = value;
+	if (typeof params.promptText !== "string" || params.promptText.length === 0) params.promptText = typeof runtime.promptText === "string" ? runtime.promptText : "";
+	return params;
+}
+/** {{key}} 嵌套插值(块模板内引用 params)；键正则与引擎插值及 processStText 中文变量支持一致。 */
+function interpolateNested(text, scope) {
+	return text.replace(/\{\{([A-Za-z0-9_.\u4e00-\u9fff-]+)\}\}/g, (whole, key, offset) => {
+		if (!Object.prototype.hasOwnProperty.call(scope, key)) return whole;
+		const value = asString(scope[key]);
+		if (!value.includes("\n")) return value;
+		const lineStart = text.lastIndexOf("\n", offset) + 1;
+		const prefix = text.slice(lineStart, offset);
+		return value.split("\n").map((line, at) => at === 0 ? line : line.length > 0 ? prefix + line : "").join("\n");
+	});
+}
+/** 逗号分隔 / YAML flow 数组 / 空格分隔的字符串列表 → 字符串数组。 */
+function parseListParam(value) {
+	if (Array.isArray(value)) return value.map((item) => String(item)).filter((item) => item.length > 0);
+	if (typeof value !== "string") return [];
+	const trimmed = value.trim();
+	if (trimmed.length === 0) return [];
+	return (trimmed.startsWith("[") && trimmed.endsWith("]") ? trimmed.slice(1, -1) : trimmed).split(",").map((item) => item.trim()).filter((item) => item.length > 0);
+}
+/**
+* 引擎内部 token 渲染:把直读参数变成组合模块里的 __TOKEN__ 值。
+* anchored 的全部组合行为(usePtcMode/bootstrapMaxTokens/模型路由与委派完整自定义)
+* 在这里完成参数化,用户参数文件不需要任何模板语法。
+* 模型路由/委派参数统一扁平键（modelProvider/subagentModelProvider/toolFilterAllow/maxDepth 等），
+* 与官方 AgentOptions{provider,model} / toolFilter{allow,deny} / maxDepth 对齐。
+*/
+function renderEngineTokens(params) {
+	const provider = asString(params.subagentModelProvider, "");
+	const model = asString(params.subagentModelName, "");
+	const subagentPersona = asString(params.subagentPersona);
+	const toolFilterAllow = parseListParam(params.toolFilterAllow);
+	const toolFilterDeny = parseListParam(params.toolFilterDeny);
+	const mainFilterAllow = parseListParam(params.toolFilterAllow);
+	const mainFilterDeny = parseListParam(params.toolFilterDeny);
+	const mainFilterSubagents = params.toolFilterSubagents === true;
+	const mainFilterAllowLine = mainFilterAllow.length > 0 ? `[${mainFilterAllow.join(", ")}]` : "";
+	const mainFilterDenyLine = mainFilterDeny.length > 0 ? `[${mainFilterDeny.join(", ")}]` : "";
+	const rawMaxDepth = params.maxDepth;
+	const subagentMaxDepth = rawMaxDepth === "provider-managed" ? "provider-managed" : Number.isSafeInteger(rawMaxDepth) && rawMaxDepth >= 0 ? String(rawMaxDepth) : "";
+	const subagentLines = [];
+	if (provider.length > 0 && model.length > 0) subagentLines.push("agentOptions:", `  provider: ${provider}`, `  model: ${model}`);
+	if (subagentPersona.length > 0) subagentLines.push(interpolateNested("persona: |-\n  {{subagentPersona}}", { subagentPersona }));
+	if (toolFilterAllow.length > 0 || toolFilterDeny.length > 0) {
+		subagentLines.push("toolFilter:");
+		if (toolFilterAllow.length > 0) subagentLines.push(`  allow: [${toolFilterAllow.join(", ")}]`);
+		if (toolFilterDeny.length > 0) subagentLines.push(`  deny: [${toolFilterDeny.join(", ")}]`);
+	}
+	if (subagentMaxDepth.length > 0) subagentLines.push(`maxDepth: ${subagentMaxDepth}`);
+	const subagentConfigBlock = subagentLines.join("\n");
+	const bootstrap = typeof params.bootstrapMaxTokens === "number" && params.bootstrapMaxTokens > 0 ? `bootstrapMaxTokens: ${params.bootstrapMaxTokens}` : "";
+	const editorMaxOutputChars = typeof params.strReplaceEditorMaxOutputChars === "number" && Number.isSafeInteger(params.strReplaceEditorMaxOutputChars) && params.strReplaceEditorMaxOutputChars > 0 ? String(params.strReplaceEditorMaxOutputChars) : "16000";
+	return {
+		usePtcMode: params.usePtcMode === void 0 ? "" : params.usePtcMode === true ? "true" : "false",
+		bootstrapMaxTokens: bootstrap,
+		subagentConfig: subagentConfigBlock,
+		allowKinds: params.allowKinds === void 0 ? "" : Array.isArray(params.allowKinds) ? `[${params.allowKinds.map((item) => String(item)).join(", ")}]` : asString(params.allowKinds),
+		strReplaceEditorMaxOutputChars: editorMaxOutputChars,
+		mainToolFilterAllow: mainFilterAllowLine,
+		mainToolFilterDeny: mainFilterDenyLine,
+		mainToolFilterSubagents: String(mainFilterSubagents)
+	};
+}
+/** 预设 params + runtime → 组合 token 渲染(便捷入口)。 */
+function resolvePresetTokens(spec, runtime) {
+	return renderEngineTokens(resolvePresetParams(spec, runtime));
+}
+/** 按参数文件的 modules 清单从引擎模块库装配组合文本。 */
+/** 空模块清单兜底骨架（自定义预设空白起点：模块集与 minimal 一致，参数/配置全空）。 */
+const FALLBACK_MODULES = [
+	"official-persistent-shell",
+	"bootstrap-filesystem",
+	"context-gate",
+	"tool-bootstrap",
+	"prompt-config-engine",
+	"run-code-env",
+	"custom-bash",
+	"skill-search"
+];
+function assembleModules(spec, library) {
+	const parts = [];
+	for (const name of spec.modules ?? []) {
+		if (typeof name !== "string" || name.length === 0) throw new Error(`preset ${spec.id}: modules must be non-empty strings`);
+		try {
+			parts.push(readFileSync(join(library, `${name}.yml`), "utf8"));
+		} catch (error) {
+			throw new Error(`preset ${spec.id}: module ${name} not found in engine library: ${String(error.message ?? error)}`);
+		}
+	}
+	return parts.join("\n");
+}
+/**
+* 加载预设声明的组合:
+*   1. `modules:` 清单 → 引擎模块库按序装配(最终形态);
+*   2. 兼容 `composition:` 内联文本或组合清单名。
+*/
+/**
+* 行级 config 合并(moduleConfigs):仅支持 map 型 config 浅合并;
+* 数组型 config(如 compaction)与未声明模块原样保留。
+* 未声明 moduleConfigs 时返回原文(零开销);parseDocument 往返保留注释与 __TOKEN__。
+*/
+function applyModuleConfigs(raw, configs) {
+	if (configs === void 0 || Object.keys(configs).length === 0) return raw;
+	const doc = parseDocument(raw, { logLevel: "silent" });
+	if (!(doc.contents instanceof YAMLSeq)) return raw;
+	const rows = doc.contents;
+	let changed = false;
+	for (const item of rows.items) {
+		if (!(item instanceof YAMLMap)) continue;
+		const idNode = item.get("id", true);
+		const id = idNode !== null && typeof idNode === "object" && "value" in idNode ? String(idNode.value) : void 0;
+		if (id === void 0 || !Object.prototype.hasOwnProperty.call(configs, id)) continue;
+		const existingConfig = item.get("config", true);
+		let configNode;
+		if (existingConfig instanceof YAMLMap) configNode = existingConfig;
+		else if (existingConfig === null || existingConfig === void 0) {
+			configNode = new YAMLMap();
+			item.items.push(new Pair(new Scalar("config"), configNode));
+			changed = true;
+		} else continue;
+		for (const [key, value] of Object.entries(configs[id])) configNode.set(key, value);
+		changed = true;
+	}
+	return changed ? doc.toString() : raw;
+}
+/**
+* 加载预设声明的组合(原始 token 文本,未渲染)。
+*  - `modules:` 清单 → 引擎模块库按序装配;
+*  - `composition: ./xxx.yml` → 预设模板目录内组合文件(官方预设直用);
+*  - `composition:` 内联文本或组合清单名。
+*/
+function loadCompositionText(spec, templateDir) {
+	const library = join(packageEngineDir(), "compositions", "library");
+	let raw;
+	const modules = Array.isArray(spec.modules) && spec.modules.length === 0 ? FALLBACK_MODULES : spec.modules;
+	if (Array.isArray(modules)) raw = assembleModules({
+		...spec,
+		modules
+	}, library);
+	else {
+		const name = typeof spec.composition === "string" ? spec.composition : "";
+		if (name.includes("\n")) raw = name;
+		else if (name.startsWith("./")) {
+			if (templateDir === void 0) throw new Error(`preset ${spec.id}: composition relative path needs a templateDir (${JSON.stringify(name)})`);
+			try {
+				raw = readFileSync(join(templateDir, name.slice(2)), "utf8");
+			} catch (error) {
+				throw new Error(`preset ${spec.id}: composition file not found (${join(templateDir, name.slice(2))}): ${String(error.message ?? error)}`);
+			}
+		} else if (name.length > 0) {
+			const file = join(dirname(library), `${name}.yml`);
+			try {
+				raw = readFileSync(file, "utf8");
+			} catch (error) {
+				throw new Error(`preset ${spec.id}: engine composition ${name} not found (${file}): ${String(error.message ?? error)}`);
+			}
+		} else if (templateDir !== void 0) try {
+			raw = readFileSync(join(templateDir, "agent.cordis.yml"), "utf8");
+		} catch (error) {
+			throw new Error(`preset ${spec.id}: no modules/composition and no agent.cordis.yml in template dir (${templateDir}): ${String(error.message ?? error)}`);
+		}
+		else throw new Error(`preset ${spec.id}: no modules list and no composition declared`);
+	}
+	return raw;
+}
+/**
+* 预设组合渲染完整链路:token 渲染 → moduleConfigs 行级合并。
+* 合并必须发生在 token 渲染之后(独立行 token 在渲染前是非法 YAML,
+* 如 __SUBAGENT_CONFIG__ / __BOOTSTRAP_MAX_TOKENS__)。
+*/
+function renderComposition(spec, runtime, templateDir) {
+	const tokens = resolvePresetTokens(spec, runtime);
+	return applyModuleConfigs(renderTemplateVariables(loadCompositionText(spec, templateDir), tokens), spec.moduleConfigs);
+}
+/** 组合文本基础校验（模板无关）：无未解析 token，且必须是 YAML 数组。 */
+function assertCompositionArray(raw, spec) {
+	const unresolved = raw.match(/__[A-Za-z0-9_]+__/g);
+	if (unresolved !== null) throw new Error(`generated agent.cordis.yml has unresolved variables: ${unresolved.join(", ")}`);
+	const parsed = parse(raw, { logLevel: "silent" });
+	if (!Array.isArray(parsed)) throw new Error(`generated agent.cordis.yml is not a YAML array (preset ${spec.id})`);
+	return parsed;
+}
+/**
+* 文本 token 替换:
+*   - token 独立成行时,替换块按该行缩进前缀(用于 line/block);
+*   - token 内联时直接替换(用于布尔/字符串标量)。
+*/
+function renderTemplateVariables(raw, variables) {
+	let text = raw.replace(/^[ \t]*(?:[A-Za-z0-9_.-]+:[ \t]*)?__([A-Za-z0-9_]+)__[ \t]*\r?\n/gm, (whole, key) => Object.prototype.hasOwnProperty.call(variables, key) && variables[key] === "" ? "" : whole);
+	return text.replace(/__([A-Za-z0-9_]+)__/g, (whole, key, offset) => {
+		if (!Object.prototype.hasOwnProperty.call(variables, key)) return whole;
+		const value = variables[key];
+		if (value === "") return "";
+		const lineStart = text.lastIndexOf("\n", offset) + 1;
+		const lineEndRaw = text.indexOf("\n", offset);
+		const lineEnd = lineEndRaw < 0 ? text.length : lineEndRaw;
+		const prefix = text.slice(lineStart, offset);
+		const rest = text.slice(offset + whole.length, lineEnd);
+		if (prefix.trim() === "" && rest.trim() === "") return value.split("\n").map((line, at) => at === 0 ? line : line.length > 0 ? prefix + line : "").join("\n");
+		return value;
+	});
+}
+//#endregion
+//#region src/host/prompt-configs.ts
+/**
+* 提示词配置数据接口：默认提示词配置构建、通用 YAML 渲染、多源合并与目录加载。
+*
+* 这是「用户自定义注入内容 + 自定义注入层级位置」的功能层：
+*   1. settings.promptConfigs 数组（UI 设置最终消费此接口）
+*   2. 生成目录 prompt-configs/（yml/json 提示词配置文件）
+*   3. 默认四条提示词配置
+* 三者按此优先级合并，同名 id 后者覆盖，新 id 追加在默认提示词配置之后。
+* 引擎（engine/prompt-config-engine.mjs）在运行时对生成 yml 做权威校验。
+*/
+/** 文本块缩进 n 个空格（YAML block scalar）。 */
+function indentBy(level, text) {
+	const pad = " ".repeat(level);
+	return text.split(/\r?\n/).map((line) => line.length === 0 ? "" : pad + line).join("\n");
+}
+/** YAML 标量渲染：字符串非空用 block scalar，空串 quoted，布尔/数字原样。 */
+function yamlScalar(key, level, value) {
+	const pad = " ".repeat(level);
+	if (typeof value === "string") return value.length === 0 ? `${pad}${key}: ''` : `${pad}${key}: |-\n${indentBy(level + 2, value)}`;
+	if (typeof value === "boolean" || typeof value === "number") return `${pad}${key}: ${String(value)}`;
+	if (value === null || value === void 0) return "";
+	return `${pad}${key}: ${JSON.stringify(value)}`;
+}
+/** 嵌套 map 渲染（variables / params / identity）。 */
+function yamlMap(level, value) {
+	const pad = " ".repeat(level);
+	const lines = [];
+	for (const [key, item] of Object.entries(value)) {
+		if (item === null || item === void 0) continue;
+		if (typeof item === "object" && !Array.isArray(item)) {
+			lines.push(`${pad}${key}:`);
+			lines.push(...yamlMap(level + 2, item));
+		} else {
+			const line = yamlScalar(key, level, item);
+			if (line.length > 0) lines.push(line);
+		}
+	}
+	return lines;
+}
+/** 把任意提示词配置 spec 渲染为独立提示词配置模块 yml（全部字段开放可配置）。 */
+function renderPromptConfigYaml(spec) {
+	const lines = [`id: ${spec.id}`];
+	if (typeof spec.name === "string" && spec.name.length > 0 && spec.name !== spec.id) lines.push(`name: ${spec.name}`);
+	if (spec.configKind !== void 0) lines.push(`configKind: ${spec.configKind}`);
+	if (spec.layer !== void 0) lines.push(`layer: ${spec.layer}`);
+	if (spec.order !== void 0) lines.push(`order: ${spec.order}`);
+	if (spec.role !== void 0) lines.push(`role: ${spec.role}`);
+	lines.push(`enabled: ${spec.enabled !== false}`);
+	lines.push(`strategy: ${spec.strategy ?? "static"}`);
+	if (spec.position !== void 0) lines.push(`position: ${spec.position}`);
+	if (spec.dedupe !== void 0) lines.push(`dedupe: ${spec.dedupe}`);
+	if (spec.promotion !== void 0) lines.push(`promotion: ${spec.promotion}`);
+	if (spec.audience !== void 0 && spec.audience !== null) lines.push(`audience: ${spec.audience}`);
+	if (spec.modelScope !== void 0) lines.push(`modelScope: ${spec.modelScope}`);
+	if (typeof spec.group === "string" && spec.group.length > 0) lines.push(`group: ${spec.group}`);
+	if (spec.exclusive === true) lines.push("exclusive: true");
+	if (typeof spec.sourceKind === "string" && spec.sourceKind.length > 0 && spec.sourceKind !== spec.id) lines.push(`sourceKind: ${spec.sourceKind}`);
+	if (typeof spec.form === "string" && spec.form.length > 0 && spec.form !== "notice") lines.push(`form: ${spec.form}`);
+	if (typeof spec.summary === "string" && spec.summary.length > 0) lines.push(yamlScalar("summary", 0, spec.summary));
+	if (typeof spec.templateFile === "string" && spec.templateFile.length > 0) lines.push(`templateFile: ${spec.templateFile}`);
+	if (typeof spec.fill === "string" && spec.fill.length > 0) lines.push(`fill: ${spec.fill}`);
+	const texts = [...typeof spec.text === "string" && spec.text.length > 0 ? [spec.text] : [], ...Array.isArray(spec.texts) ? spec.texts : []];
+	if (texts.length > 0) lines.push(`texts: ${JSON.stringify(texts)}`);
+	if (spec.mergeMode !== void 0 && spec.mergeMode !== "separate") lines.push(`mergeMode: ${spec.mergeMode}`);
+	if (spec.identity !== void 0 && spec.identity.value !== spec.id) lines.push("identity:", `  field: ${spec.identity.field}`, `  value: ${spec.identity.value}`);
+	if (spec.variables !== void 0 && Object.keys(spec.variables).length > 0) {
+		lines.push("variables:");
+		lines.push(...yamlMap(2, spec.variables));
+	}
+	if (spec.params !== void 0 && Object.keys(spec.params).length > 0) {
+		lines.push("params:");
+		lines.push(...yamlMap(2, spec.params));
+	}
+	return lines.join("\n").trimEnd();
+}
+/** 多源提示词配置合并：同名 id 后者覆盖（保留默认提示词配置位置），新 id 追加在末尾。 */
+function mergePromptConfigs(...sources) {
+	const ordered = [];
+	const byId = /* @__PURE__ */ new Map();
+	for (const source of sources) for (const spec of source ?? []) {
+		if (spec === null || typeof spec !== "object" || typeof spec.id !== "string" || spec.id.length === 0) throw new TypeError("every prompt config must have a non-empty string id");
+		const existing = byId.get(spec.id);
+		if (existing === void 0) {
+			byId.set(spec.id, ordered.length);
+			ordered.push(spec);
+		} else ordered[existing] = spec;
+	}
+	return ordered;
+}
+/** 从用户提示词配置目录加载 yml/json 提示词配置（文件名排序；内容必须能解析）。 */
+function loadPromptConfigFiles(dir) {
+	if (dir.length === 0) return [];
+	let entries;
+	try {
+		entries = readdirSync(dir, { withFileTypes: true });
+	} catch (error) {
+		throw new Error(`提示词配置目录 ${JSON.stringify(dir)} 不可读: ${String(error.message ?? error)}`);
+	}
+	const specs = [];
+	const files = entries.filter((entry) => entry.isFile() && /\.(ya?ml|json)$/i.test(entry.name)).sort((a, b) => a.name.localeCompare(b.name));
+	for (const entry of files) {
+		if (entry.name === "variables.yml") continue;
+		const raw = readFileSync(join(dir, entry.name), "utf8");
+		const parsed = /\.json$/i.test(entry.name) ? JSON.parse(raw) : parse(raw, { logLevel: "silent" });
+		if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error(`prompt config file ${entry.name} must contain a single config object`);
+		if (typeof parsed.id !== "string") throw new Error(`prompt config file ${entry.name} must declare a string id`);
+		specs.push(parsed);
+	}
+	return specs;
+}
+//#endregion
+export { userPresetsDir as C, DEFAULT_SKILLS_DIR as D, DEFAULT_RESIDENT_AGENTS_PATH as E, LEGACY_CONTAINER_DIR as O, savePresetParams as S, DEFAULT_PRESET_DIR as T, readPluginState as _, asString as a, resolvePresetDir as b, duplicateUserPreset as c, listPresets as d, loadPresetContent as f, parseImportedPresetId as g, packageEngineDir as h, applyModuleConfigs as i, LEGACY_USER_PRESETS_DIR as k, ensurePresetSeed as l, openPresetLocation as m, mergePromptConfigs as n, assertCompositionArray as o, loadPresetSpec as p, renderPromptConfigYaml as r, cloneBuiltinPreset as s, loadPromptConfigFiles as t, listBuiltinTemplates as u, removeUserPreset as v, writePluginState as w, resolvePresetParams as x, renderComposition as y };