dsh-plugin-prompt-tool 0.7.2 → 0.8.0

package/lib/prompt-configs-BnQKRHVb.mjs

@@ -1,884 +0,0 @@
-import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { basename, dirname, join, resolve, sep } from "node:path";
-import { spawn } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { Pair, Scalar, YAMLMap, YAMLSeq, parse, parseDocument } from "yaml";
-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 仅为可选覆盖;
-*   - 组合模块的行级 config 由参数桥 buildModuleConfigsFromParams 按 params
-*     构造对象合并（取代旧 __TOKEN__ 文本渲染，无占位符、无文本往返），
-*     params（UI/基础层）优先于 moduleConfigs 行级直写（旧作者锁定语义已移除）。
-* 本模块负责参数归一化与引擎模块配置装配;所有 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.yml 读缓存：按 mtime+size 签名失效。load()/describe/param-overrides 等
-* 每次请求读盘解析，加缓存后同一文件只解析一次；写盘路径（savePresetParams /
-* withPresetDoc）与外部编辑（stat 签名变化）都会正确失效。
-*/
-const presetSpecCache = /* @__PURE__ */ new Map();
-/** 写盘后失效缓存（调用方在写完 preset.yml 后调用；不调用也安全——stat 签名兜底）。 */
-function invalidatePresetSpec(dir) {
-	presetSpecCache.delete(join(dir, "preset.yml"));
-}
-/** 加载某个预设模板的单一参数文件 preset/<name>/preset.yml。 */
-function loadPresetSpec(dir) {
-	const file = join(dir, "preset.yml");
-	const stat = statSync(file);
-	const cached = presetSpecCache.get(file);
-	if (cached !== void 0 && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size) return cached.spec;
-	const raw = readFileSync(file, "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);
-	const flattenModelGroup = (source, mapping) => {
-		if (source === null || typeof source !== "object" || Array.isArray(source)) return;
-		if (parsed.params === null || typeof parsed.params !== "object" || Array.isArray(parsed.params)) parsed.params = {};
-		for (const [segmentKey, flatKey] of Object.entries(mapping)) {
-			const value = source[segmentKey];
-			if (value !== void 0) parsed.params[flatKey] = value;
-		}
-	};
-	const flattenMapping = (segmentName) => {
-		const mapping = {};
-		for (const [flatKey, [segment, segmentKey]] of Object.entries(MODEL_SEGMENT_MAP)) if (segment === segmentName) mapping[segmentKey] = flatKey;
-		return mapping;
-	};
-	flattenModelGroup(parsed.model, flattenMapping("model"));
-	flattenModelGroup(parsed.subagentModel, flattenMapping("subagentModel"));
-	presetSpecCache.set(file, {
-		mtimeMs: stat.mtimeMs,
-		size: stat.size,
-		spec: parsed
-	});
-	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);
-};
-/**
-* 顶层模型段 ↔ 扁平参数键双向映射（单一来源）。
-* loadPresetSpec 展平（段 → 扁平键）与 savePresetParams 迁移（扁平键 → 段）
-* 共用本常量，杜绝两处字面量漂移。段结构 = 官方 agent-default-model 同构。
-*/
-const MODEL_SEGMENT_MAP = {
-	modelProvider: ["model", "provider"],
-	modelName: ["model", "name"],
-	modelReasoningEffort: ["model", "reasoningEffort"],
-	modelTemperature: ["model", "temperature"],
-	modelMaxTokens: ["model", "maxTokens"],
-	subagentModelProvider: ["subagentModel", "provider"],
-	subagentModelName: ["subagentModel", "name"],
-	subagentReasoningEffort: ["subagentModel", "reasoningEffort"],
-	subagentTemperature: ["subagentModel", "temperature"],
-	subagentMaxTokens: ["subagentModel", "maxTokens"]
-};
-/** 预设根：官方 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(".")).filter((entry) => entry.name !== "prompt-tool").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 (existsSync(legacyMark)) try {
-		writePluginState({
-			...state,
-			seeded: true
-		});
-		rmSync(legacyMark, { force: true });
-	} catch {}
-	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
-		};
-	}
-}
-/** 删除 yaml 两级键；父集合缺失时不触发 deleteIn 对不存在集合的异常。 */
-function deleteYamlPath(doc, path) {
-	if (doc.hasIn(path)) doc.deleteIn(path);
-}
-/** 删除扁平 params 键。 */
-function deleteFlatParam(doc, key) {
-	deleteYamlPath(doc, ["params", key]);
-}
-/**
-* 保存预设参数：写激活预设目录 preset.yml 的 params（merge）/ promptConfigs（整体替换）。
-* parseDocument 保留注释与未知键（preset.yml 模板含大量注释）；空值键删除（'' / []，
-* 回落模板/引擎默认；0 与 false 照常写入--语义与函数内注释、docs §3 一致）。写入后删除 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;
-		const isEmpty = value === "" || Array.isArray(value) && value.length === 0;
-		const segment = MODEL_SEGMENT_MAP[key];
-		if (segment !== void 0) {
-			if (isEmpty) deleteYamlPath(doc, [segment[0], segment[1]]);
-			else doc.setIn([segment[0], segment[1]], value);
-			deleteFlatParam(doc, key);
-		} else if (isEmpty) deleteFlatParam(doc, key);
-		else 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;
-			deleteFlatParam(doc, key);
-		}
-	}
-	if (variablesEnabled !== void 0) {
-		if (variablesEnabled) doc.deleteIn(["variablesEnabled"]);
-		else doc.setIn(["variablesEnabled"], false);
-	}
-	writeFileSync(file, doc.toString(), "utf8");
-	invalidatePresetSpec(join(presetRoot, templateName));
-	rmSync(join(presetRoot, templateName, "prompt-tool.overrides.yml"), { force: true });
-}
-/** 预设文件读-改-写（parseDocument 保留注释与未知键；mutate 内 setIn/deleteIn）。
-*  角色卡库（characters）与世界书工具（world-book-tools）共用此入口，避免
-*  各自实现 parseDocument 往返。 */
-function withPresetDoc(presetDir, mutate) {
-	const file = join(presetDir, "preset.yml");
-	if (!existsSync(file)) throw new Error(`${presetDir} 无 preset.yml`);
-	const doc = parseDocument(readFileSync(file, "utf8"), { logLevel: "silent" });
-	mutate(doc);
-	writeFileSync(file, doc.toString(), "utf8");
-	invalidatePresetSpec(presetDir);
-}
-/** 删除预设目录（预设根/<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;
-}
-/** 逗号分隔 / 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);
-}
-/**
-* 参数桥：params 扁平键 → 引擎模块行 config 对象（取代旧 __TOKEN__ 文本渲染）。
-*
-* 原则：
-*  - 未声明的键不合并（composition 行默认 / 引擎默认生效），与旧"空值删行"语义等价；
-*  - 值类型直达（布尔/数字/数组不再字符串化再解析）；
-*  - 合并优先级：参数桥（UI/基础层）> moduleConfigs（模板/ST 行级直写）> 行默认。
-* 模型路由/委派参数统一扁平键（modelProvider/subagentModelProvider/toolFilterAllow/maxDepth 等），
-* 与官方 AgentOptions{provider,model} / toolFilter{allow,deny} / maxDepth 对齐。
-*/
-function buildModuleConfigsFromParams(params) {
-	const out = {};
-	const merge = (module, cfg) => {
-		if (Object.keys(cfg).length === 0) return;
-		out[module] = {
-			...out[module],
-			...cfg
-		};
-	};
-	const bootstrap = {};
-	if (typeof params.bootstrapMaxTokens === "number" && params.bootstrapMaxTokens > 0) bootstrap.bootstrapMaxTokens = params.bootstrapMaxTokens;
-	if (params.bootstrapTools !== void 0) bootstrap.bootstrapTools = parseListParam(params.bootstrapTools);
-	if (params.promoteGate !== void 0) bootstrap.promoteGate = params.promoteGate === true;
-	if (params.promoteAfterFirstResponse !== void 0) bootstrap.promoteAfterFirstResponse = params.promoteAfterFirstResponse === true;
-	if (params.maxPromoteSteps !== void 0 && Number.isSafeInteger(params.maxPromoteSteps)) bootstrap.maxPromoteSteps = params.maxPromoteSteps;
-	if (params.compactionTools !== void 0) bootstrap.compactionTools = parseListParam(params.compactionTools);
-	if (params.personaSectionsOnly !== void 0) bootstrap.personaSectionsOnly = params.personaSectionsOnly === true;
-	if (params.workspaceLine !== void 0) bootstrap.workspaceLine = params.workspaceLine === true;
-	if (typeof params.phase1FirstCallInstruction === "string" && params.phase1FirstCallInstruction.length > 0) bootstrap.phase1FirstCallInstruction = params.phase1FirstCallInstruction;
-	if (params.stages !== void 0) bootstrap.stages = params.stages;
-	if (params.stagePreUnlock !== void 0 && Number.isSafeInteger(params.stagePreUnlock)) bootstrap.stagePreUnlock = params.stagePreUnlock;
-	if (typeof params.stageAdvanceTool === "string" && params.stageAdvanceTool.length > 0) bootstrap.stageAdvanceTool = params.stageAdvanceTool;
-	if (typeof params.stageAdvanceDescription === "string" && params.stageAdvanceDescription.length > 0) bootstrap.stageAdvanceDescription = params.stageAdvanceDescription;
-	if (typeof params.stageSectionTemplate === "string" && params.stageSectionTemplate.length > 0) bootstrap.stageSectionTemplate = params.stageSectionTemplate;
-	merge("tool-bootstrap", bootstrap);
-	const gate = {};
-	if (params.allowKinds !== void 0) gate.allowKinds = parseListParam(params.allowKinds);
-	if (params.messageSources !== void 0) gate.messageSources = parseListParam(params.messageSources);
-	if (params.deferredSources !== void 0) gate.deferredSources = parseListParam(params.deferredSources);
-	if (params.deferredGraceSteps !== void 0 && Number.isSafeInteger(params.deferredGraceSteps)) gate.deferredGraceSteps = params.deferredGraceSteps;
-	if (params.instructionHint !== void 0) gate.instructionHint = params.instructionHint === true;
-	merge("context-gate", gate);
-	const presentation = {};
-	if (params.usePtcMode !== void 0) presentation.usePtcMode = params.usePtcMode === true;
-	merge("code-presentation", presentation);
-	const anchorTurn = {};
-	if (params.anchorTurn !== void 0) anchorTurn.enabled = params.anchorTurn === true;
-	if (typeof params.anchorTurnText === "string" && params.anchorTurnText.length > 0) anchorTurn.text = params.anchorTurnText;
-	merge("anchor-turn", anchorTurn);
-	const gate2 = {};
-	if (params.deliberationGate !== void 0) gate2.enabled = params.deliberationGate === true;
-	if (typeof params.deliberationMinChars === "number" && params.deliberationMinChars > 0) gate2.minChars = params.deliberationMinChars;
-	if (typeof params.deliberationMaxGatesPerTurn === "number" && params.deliberationMaxGatesPerTurn > 0) gate2.maxGatesPerTurn = params.deliberationMaxGatesPerTurn;
-	merge("deliberation-gate", gate2);
-	const drip = {};
-	if (params.cotDrip !== void 0) drip.enabled = params.cotDrip === true;
-	if (typeof params.cotDripEvery === "number" && params.cotDripEvery > 0) drip.every = params.cotDripEvery;
-	if (typeof params.cotDripMaxPerTurn === "number" && params.cotDripMaxPerTurn > 0) drip.maxPerTurn = params.cotDripMaxPerTurn;
-	merge("cot-drip", drip);
-	const editor = {};
-	editor.maxOutputChars = typeof params.strReplaceEditorMaxOutputChars === "number" && Number.isSafeInteger(params.strReplaceEditorMaxOutputChars) && params.strReplaceEditorMaxOutputChars > 0 ? params.strReplaceEditorMaxOutputChars : 16e3;
-	merge("str-replace-editor", editor);
-	const filter = {};
-	const mainAllow = parseListParam(params.toolFilterAllow);
-	const mainDeny = parseListParam(params.toolFilterDeny);
-	if (mainAllow.length > 0) filter.allow = mainAllow;
-	if (mainDeny.length > 0) filter.deny = mainDeny;
-	if (params.toolFilterSubagents === true) filter.includeSubagents = true;
-	merge("tool-filter", filter);
-	const subagent = {};
-	const provider = asString(params.subagentModelProvider, "");
-	const model = asString(params.subagentModelName, "");
-	if (provider.length > 0 && model.length > 0) subagent.agentOptions = {
-		provider,
-		model
-	};
-	const subAllow = parseListParam(params.toolFilterAllow);
-	const subDeny = parseListParam(params.toolFilterDeny);
-	if (subAllow.length > 0 || subDeny.length > 0) subagent.toolFilter = {
-		...subAllow.length > 0 ? { allow: subAllow } : {},
-		...subDeny.length > 0 ? { deny: subDeny } : {}
-	};
-	const rawMaxDepth = params.maxDepth;
-	if (rawMaxDepth === "provider-managed") subagent.maxDepth = "provider-managed";
-	else if (Number.isSafeInteger(rawMaxDepth) && rawMaxDepth >= 0) subagent.maxDepth = rawMaxDepth;
-	if (Object.keys(subagent).length > 0) {
-		out["tool-subagent"] = subagent;
-		out["tool-subagent-fork"] = subagent;
-	}
-	return out;
-}
-/** 按参数文件的 modules 清单从引擎模块库装配组合文本。 */
-/** 空模块清单兜底骨架（自定义预设空白起点：模块集与 minimal 一致，参数/配置全空）。 */
-const FALLBACK_MODULES = [
-	"official-persistent-shell",
-	"bootstrap-filesystem",
-	"context-gate",
-	"tool-bootstrap",
-	"code-presentation",
-	"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 合并:仅支持 map 型 config 浅合并;
-* 数组型 config(如 delegation 组)按子行 id 嵌套合并;未声明模块原样保留。
-* 未声明 configs 时返回原文(零开销);parseDocument 往返保留注释。
-* 本函数是参数桥产物落位组合行的唯一机制(含 delegation 组子行嵌套),不是预设覆盖通道。
-*/
-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;
-	/** 把 cfg 的键写入一个 config 节点（无 config 时创建）。 */
-	const mergeInto = (item, cfg) => {
-		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));
-		} else return false;
-		for (const [key, value] of Object.entries(cfg)) configNode.set(key, value);
-		return true;
-	};
-	/** 从行节点读 id（ParsedNode 值包装兼容）。 */
-	const rowId = (item) => {
-		const idNode = item.get("id", true);
-		return idNode !== null && typeof idNode === "object" && "value" in idNode ? String(idNode.value) : void 0;
-	};
-	for (const item of rows.items) {
-		if (!(item instanceof YAMLMap)) continue;
-		const id = rowId(item);
-		const existingConfig = item.get("config", true);
-		if (existingConfig instanceof YAMLSeq && id !== void 0 && !Object.prototype.hasOwnProperty.call(configs, id)) {
-			for (const child of existingConfig.items) {
-				if (!(child instanceof YAMLMap)) continue;
-				const childId = rowId(child);
-				if (childId === void 0 || !Object.prototype.hasOwnProperty.call(configs, childId)) continue;
-				if (mergeInto(child, configs[childId])) changed = true;
-			}
-			continue;
-		}
-		if (id === void 0 || !Object.prototype.hasOwnProperty.call(configs, id)) continue;
-		if (mergeInto(item, configs[id])) 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;
-}
-/**
-* 预设组合渲染完整链路:模块装配 → 参数桥(moduleConfigs + params)行级合并。
-* 合并优先级:参数桥(params/UI 基础层) > moduleConfigs(模板/ST 行级直写) > 行默认。
-* moduleConfigs 仅补充参数桥未覆盖的行级 config(如 ST 导入的 tool-web.fetch),
-* 不再锁定覆盖 UI 可管理参数(旧作者锁定语义已移除)。
-*/
-function renderComposition(spec, runtime, templateDir) {
-	const merged = buildModuleConfigsFromParams(resolvePresetParams(spec, runtime));
-	for (const [id, cfg] of Object.entries(spec.moduleConfigs ?? {})) merged[id] = {
-		...cfg,
-		...merged[id]
-	};
-	return applyModuleConfigs(loadCompositionText(spec, templateDir), merged);
-}
-/** 组合文本基础校验（模板无关）：无未解析 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;
-}
-//#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 { DEFAULT_SKILLS_DIR as A, resolvePresetParams as C, writePluginState as D, withPresetDoc as E, LEGACY_USER_PRESETS_DIR as M, DEFAULT_PRESET_DIR as O, resolvePresetDir as S, userPresetsDir as T, packageEngineDir as _, applyModuleConfigs as a, removeUserPreset as b, buildModuleConfigsFromParams as c, ensurePresetSeed as d, listBuiltinTemplates as f, openPresetLocation as g, loadPresetSpec as h, MODEL_SEGMENT_MAP as i, LEGACY_CONTAINER_DIR as j, DEFAULT_RESIDENT_AGENTS_PATH as k, cloneBuiltinPreset as l, loadPresetContent as m, mergePromptConfigs as n, asString as o, listPresets as p, renderPromptConfigYaml as r, assertCompositionArray as s, loadPromptConfigFiles as t, duplicateUserPreset as u, parseImportedPresetId as v, savePresetParams as w, renderComposition as x, readPluginState as y };