dsh-plugin-prompt-tool 0.6.2 → 0.7.1

package/lib/index.d.mts

@@ -1,18 +1,8 @@
-import { n as PromptConfigFile, r as PromptConfigSpec } from "./prompt-configs-B4vH09wx.mjs";
-import { SettingsNamespace } from "@deepseek-ai/dsh-settings";
+import { c as PresetWriterParams, l as WRITER_PARAM_KEYS, n as PromptConfigFile, r as PromptConfigSpec, s as ENGINE_PARAM_KEYS } from "./prompt-configs-CN0sJTUL.mjs";
+import { parseDocument } from "yaml";
 import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/shared/param-keys.d.ts
-/**
- * 引擎行为参数键（按预设存储：激活预设 preset.yml 的 params + promptConfigs）。
- * 不进 Config schema、不进 settings namespace——每预设一份，随预设走（官方范式：
- * Config = 部署轴，引擎行为在预设文件）。
- *
- * 这些键在 UI 有专门编辑入口（模型设置 / 工具与深度 / 开关），writePreset 把
- * 预设级 params 合并进每条 promptConfig 的 params 时排除——「params（高级参数
- * JSON）」框只保留内容变量与配置自身策略参数，避免 UI 已管理的参数冗余回写。
- * 放 shared：host（write-preset）与 config/settings-bridge 共用，单一来源。
- */
 declare const PARAM_KEYS: ReadonlySet<string>;
 //#endregion
 //#region src/config.d.ts
@@ -114,47 +104,14 @@ interface PromptSettings {
 declare const PromptSettingsSchema: z<PromptSettings>;
 //#endregion
 //#region src/host/write-preset.d.ts
-interface WritePresetOptions {
-  firstTurnAnchor: boolean;
-  firstTurnText: string;
-  firstTurnCustom: boolean;
-  guideText: string;
-  guideCustom: boolean;
-  injectPrompt: boolean;
-  modelProvider: string;
-  modelName: string;
-  /** 子代理固定模型路由 provider（agentOptions 注入 tool-subagent）。 */
-  subagentModelProvider: string;
-  /** 子代理固定模型名。 */
-  subagentModelName: string;
-  /** 主对话思维程度（agent-request patch reasoningEffort；''=不设置，官方档位 off/low/high/max）。 */
-  modelReasoningEffort?: string;
-  /** 主对话采样温度（agent-request patch temperature；''=不设置）。 */
-  modelTemperature?: string;
-  /** 主对话输出上限（agent-request patch maxTokens；''=不设置）。 */
-  modelMaxTokens?: string;
-  /** 子代理思维程度（agent-request patch，audience=subagent；''=不设置）。 */
-  subagentReasoningEffort?: string;
-  /** 子代理采样温度（agent-request patch，audience=subagent；''=不设置）。 */
-  subagentTemperature?: string;
-  /** 子代理输出上限（agent-request patch，audience=subagent；''=不设置）。 */
-  subagentMaxTokens?: string;
-  /** 子代理自定义模型人设（per-child shadow；缺省 = 经 scope 链继承主会话 persona 模块）。 */
-  subagentPersona?: string;
-  /** 委派工具集白名单（toolFilter.allow；支持数组或逗号/空格分隔字符串）。 */
-  toolFilterAllow?: string[] | string;
-  /** 委派工具集黑名单（toolFilter.deny）。 */
-  toolFilterDeny?: string[] | string;
-  /** 委派递归深度上限（0 禁止委派 / provider-managed / 正整数）。 */
-  maxDepth?: number | 'provider-managed' | string;
-  /** 注入 kind 白名单（context-gate allowKinds；数组或逗号分隔字符串）。 */
-  allowKinds?: string[] | string;
-  /** custom-fallback 锚定词（prompt-injector params.firstTurnWord）。 */
-  firstTurnWord?: string;
+/**
+ * 把任意单一参数预设模板物化到生成目录（writePreset）的写入态选项。
+ * 引擎参数契约来自 shared/engine-params.ts（PresetWriterParams：runtimeOf 透传子集），
+ * 此处只保留 writePreset 专属字段——加引擎参数只需改一处契约，漏透传变成编译错误。
+ */
+interface WritePresetOptions extends PresetWriterParams {
   /** 是否注入 agents.md 内容到 instruction-hint（false 时 instruction-hint 走引擎默认提示/动态探测）。 */
   injectAgentsPrompt?: boolean;
-  bootstrapMaxTokens: number;
-  usePtcMode: boolean;
   /** 写入 agents-instruction.txt 供 instruction-hint 配置读取;不传则使用本地默认 hint。 */
   agentsInstructionText?: string;
   presetDir: string;
@@ -163,6 +120,10 @@ interface WritePresetOptions {
   promptConfigs: PromptConfigSpec[];
   /** 预设模板名(preset/<name>);默认 anchored(兼容期)。 */
   presetTemplate?: string;
+  /** 输出目录/预设 id 覆盖（旧容器 id 兼容别名，如 prompt-tool）；缺省 = presetTemplate 同名输出。 */
+  outputId?: string;
+  /** 兼容别名标记：输出目录是源预设的镜像（preset.yml name 加后缀，UI 可识别展示）。 */
+  aliasOf?: boolean;
   /** 目录加载失败等非致命告警回调。 */
   warn?: (message: string) => void;
 }
@@ -170,16 +131,6 @@ interface WritePresetOptions {
 declare function writePreset(prompt: string, options: WritePresetOptions): void;
 //#endregion
 //#region src/host/manifest.d.ts
-/**
- * manifest — 预设模板单一参数 YAML(preset.yml)的加载与引擎参数解析。
- *
- * 一个预设 = 一个 preset.yml:
- *   - modules/params/content/meta 全部是直读参数,无模板语法;
- *   - 默认提示词配置由引擎按 params 生成(见 write-preset),promptConfigs 仅为可选覆盖;
- *   - 组合模块中的 __TOKEN__ 由引擎内部 renderEngineTokens 按 params 生成,
- *     不再暴露到参数文件。
- * 本模块负责参数归一化与引擎 token 渲染;所有 anchored 专属行为都在引擎内部。
- */
 interface PresetSpec {
   id: string;
   name: string;
@@ -204,13 +155,13 @@ interface PresetSpec {
   subagentModel?: Record<string, unknown>;
   /** 预设级模板变量（{{key}} 插值源；与引擎行为参数 params 分离，顶层 variables 段）。 */
   variables?: Record<string, string>;
+  /** 自定义工具定义（tool-config-engine 渲染进 custom-tools/ 后运行时注册）。 */
+  customTools?: unknown[];
   /** 模板变量插值开关（缺省 true = 启用；false = 停用，writePreset 不生成变量文件）。 */
   variablesEnabled?: boolean;
-  /** 宿主层默认值(唯一入口):apply 时合并进 Config,settings 仍可覆盖。 */
-  hostDefaults?: Record<string, unknown>;
   /** 可选:模板自定义提示词配置覆盖(纯数据,不使用模板语法)。 */
   promptConfigs?: unknown[];
-  /** 可选:引擎组合模块行参数覆盖(行级 map config 浅合并,preset 优先)。 */
+  /** 可选:引擎组合模块行参数直写(行级 map config 浅合并;参数桥未覆盖的键生效,参数桥优先)。 */
   moduleConfigs?: Record<string, Record<string, unknown>>;
   /** 世界书（独立存储段，不进 promptConfigs）：injectMode + 条目。 */
   worldBook?: {
@@ -222,6 +173,12 @@ interface PresetSpec {
 }
 /** 加载某个预设模板的单一参数文件 preset/<name>/preset.yml。 */
 declare function loadPresetSpec(dir: string): PresetSpec;
+/**
+ * 顶层模型段 ↔ 扁平参数键双向映射（单一来源）。
+ * loadPresetSpec 展平（段 → 扁平键）与 savePresetParams 迁移（扁平键 → 段）
+ * 共用本常量，杜绝两处字面量漂移。段结构 = 官方 agent-default-model 同构。
+ */
+declare const MODEL_SEGMENT_MAP: Record<string, [string, string]>;
 /** 预设根：官方 USER_PRESET_DIR（~/.dsh/.agent-presets），导入/新建/种子化的预设都放这里。 */
 declare function userPresetsDir(): string;
 /**
@@ -246,6 +203,8 @@ declare function listBuiltinTemplates(): Array<{
 interface PromptToolState {
   seeded?: boolean;
   paramsMigrated?: boolean;
+  /** 旧容器 id 兼容快照已处理；删除后不再自动复活。 */
+  legacyAliasHandled?: boolean;
 }
 /** 读插件状态；文件缺失/损坏返回空对象（按未标记处理，触发首次动作）。 */
 declare function readPluginState(): PromptToolState;
@@ -268,8 +227,8 @@ declare function cloneBuiltinPreset(id: string, autoSuffix?: boolean): {
 };
 /**
  * 保存预设参数：写激活预设目录 preset.yml 的 params（merge）/ promptConfigs（整体替换）。
- * parseDocument 保留注释与未知键（preset.yml 模板含大量注释）；空值键跳过
- * （保留 preset.yml 模板默认）。写入后删除 prompt-tool.overrides.yml（旧参数覆盖
+ * parseDocument 保留注释与未知键（preset.yml 模板含大量注释）；空值键删除（'' / []，
+ * 回落模板/引擎默认；0 与 false 照常写入--语义与函数内注释、docs §3 一致）。写入后删除 prompt-tool.overrides.yml（旧参数覆盖
  * 通道残留——参数已并入 preset.yml，避免旧值覆盖新值）。
  */
 declare function savePresetParams(presetRoot: string, templateName: string, params: Record<string, unknown> | undefined, promptConfigs: unknown[] | undefined, variables?: Record<string, string>, variablesEnabled?: boolean): void;
@@ -284,25 +243,91 @@ declare function removeUserPreset(id: string, presetRoot?: string): {
 };
 /** 预设 params(默认参数)与运行时 settings 合并;settings 值优先。 */
 declare function resolvePresetParams(spec: PresetSpec, runtime: Record<string, unknown>): Record<string, unknown>;
+/**
+ * 参数桥：params 扁平键 → 引擎模块行 config 对象（取代旧 __TOKEN__ 文本渲染）。
+ *
+ * 原则：
+ *  - 未声明的键不合并（composition 行默认 / 引擎默认生效），与旧"空值删行"语义等价；
+ *  - 值类型直达（布尔/数字/数组不再字符串化再解析）；
+ *  - 合并优先级：参数桥（UI/基础层）> moduleConfigs（模板/ST 行级直写）> 行默认。
+ * 模型路由/委派参数统一扁平键（modelProvider/subagentModelProvider/toolFilterAllow/maxDepth 等），
+ * 与官方 AgentOptions{provider,model} / toolFilter{allow,deny} / maxDepth 对齐。
+ */
+declare function buildModuleConfigsFromParams(params: Record<string, unknown>): Record<string, Record<string, unknown>>;
 /**
  * 加载预设声明的组合:
  *   1. `modules:` 清单 → 引擎模块库按序装配(最终形态);
  *   2. 兼容 `composition:` 内联文本或组合清单名。
  */
 /**
- * 行级 config 合并(moduleConfigs):仅支持 map 型 config 浅合并;
- * 数组型 config(如 compaction)与未声明模块原样保留。
- * 未声明 moduleConfigs 时返回原文(零开销);parseDocument 往返保留注释与 __TOKEN__。
+ * 行级 config 合并:仅支持 map 型 config 浅合并;
+ * 数组型 config(如 delegation 组)按子行 id 嵌套合并;未声明模块原样保留。
+ * 未声明 configs 时返回原文(零开销);parseDocument 往返保留注释。
+ * 本函数是参数桥产物落位组合行的唯一机制(含 delegation 组子行嵌套),不是预设覆盖通道。
  */
 declare function applyModuleConfigs(raw: string, configs: Record<string, Record<string, unknown>> | undefined): string;
+/**
+ * 预设组合渲染完整链路:模块装配 → 参数桥(moduleConfigs + params)行级合并。
+ * 合并优先级:参数桥(params/UI 基础层) > moduleConfigs(模板/ST 行级直写) > 行默认。
+ * moduleConfigs 仅补充参数桥未覆盖的行级 config(如 ST 导入的 tool-web.fetch),
+ * 不再锁定覆盖 UI 可管理参数(旧作者锁定语义已移除)。
+ */
+declare function renderComposition(spec: PresetSpec, runtime: Record<string, unknown>, templateDir?: string): string;
 //#endregion
 //#region src/host/sillytavern.d.ts
+/**
+ * 处理 SillyTavern 文本，ST 变量语义 → 本项目 params fallback 插值：
+ *   {{setvar::k::v}}        → 收集 k=v 进 params（会话变量初始值 = fallback 基准），指令剥离；
+ *   {{getvar::k}}           → 改写为 {{k}}（引擎按 params 插值，无值保留原样）；
+ *   {{getvar::k::default}}  → 改写为 {{k}} 且 variables 缺 k 时写入 default（fallback 落顶层 variables）；
+ *   {{trim}}/{{//注释}}/{{ERA:...}} → 剥离（格式化/注释/第三方运行时）；
+ *   {{user}}/{{char}}       → 替换占位符。
+ */
+declare function processStText(text: string, cardName: string, variables: Record<string, string>): string;
+/** 合并多个转换结果为一个预设（角色卡 × 响应预设 → 单预设）。 */
+declare function mergeStPresets(specs: PresetSpec[]): PresetSpec;
+/** SillyTavern JSON 预设卡片 → 本项目 PresetSpec（导入端点直接消费）。 */
+declare function convertStToPreset(card: unknown, baseName: string): PresetSpec;
 /** ST 导入预设 id：必须是官方 agent-presets 可发现的目录名（PRESET_ID =
  *  /^[a-z0-9][a-z0-9-]*$/——含中文的目录会被宿主 discovery 静默跳过，会话
  *  resume 报 preset not found）。文件名 slug 化（去中文）；纯中文名退化为
  *  st-<文件名短哈希>（唯一且合法）；显示名 name 仍保留中文原名。 */
 declare function stPresetId(baseName: string): string;
 //#endregion
+//#region src/host/worldbook.d.ts
+type WorldBookEntry = Record<string, unknown>;
+/** buildWorldBookEntry 输入（两通道共用：ST 导入转换与模型 world_book_upsert 工具）。 */
+interface WorldBookEntryInput {
+  /** 条目 id；缺省不写（调用方自行加前缀时用，如角色卡 chara-<卡>- 前缀）。 */
+  id?: string;
+  name: string;
+  text: string;
+  /** 注入顺序（层内升序）；缺省 100。 */
+  order?: number;
+  /** 启用状态；缺省不写（引擎默认启用）。 */
+  enabled?: boolean;
+  /** 常驻注入（不依赖关键字）。 */
+  constant: boolean;
+  keys?: string[];
+  secondaryKeys?: string[];
+  caseSensitive?: boolean;
+  wholeWords?: boolean;
+  /** ST selectiveLogic（0/1/2/3 → anchor-match any/all/not/notAny）。 */
+  selectiveLogic?: number;
+}
+/**
+ * 世界书条目结构工厂（能力归一）。
+ * strategy/layer/position 固定值与 params 键集单一权威——ST 导入（sillytavern.ts）
+ * 与模型工具（world_book_upsert）共用，不再各自手写条目结构。
+ */
+declare function buildWorldBookEntry(input: WorldBookEntryInput): WorldBookEntry;
+/** 当前预设全部世界书条目（保持文件顺序）。 */
+declare function listWorldBookEntries(presetDir: string): WorldBookEntry[];
+/** 新增或更新一条世界书条目（按 id 定位；不存在则追加）。返回写入后条目总数。 */
+declare function upsertWorldBookEntry(presetDir: string, entry: WorldBookEntry): number;
+/** 删除一条世界书条目；不存在抛错。返回删除后条目总数。 */
+declare function deleteWorldBookEntry(presetDir: string, id: string): number;
+//#endregion
 //#region src/web-surface.d.ts
 /** 从 loader 根 Include 的 baseUrl 推导 profile 目录。 */
 declare function resolveProfileDir(ctx: Context): string | undefined;
@@ -378,15 +403,17 @@ interface SkillsBridgeState {
   skillCatalog: SkillCatalogEntry[];
 }
 /** 自建 loopback settings bridge：替代 registerConfigurableProviders，避免模型设置区出现插件条目。 */
-declare function registerSettingsBridge(ctx: Context, ns: SettingsNamespace, getModelsState: () => ModelDetection, getSkillsState: () => SkillsBridgeState, getEngineStrategyDir: () => string, ensureRegistered: (sctx: Context) => boolean, afterSkillFix?: () => void,
+declare function registerSettingsBridge(ctx: Context, ns: string, getModelsState: () => ModelDetection, getSkillsState: () => SkillsBridgeState, getEngineStrategyDir: () => string, afterSkillFix?: () => void,
 /** 生成目录（presetDir）：读取实际生效的提示词配置（引擎加载源）。 */
 getPresetConfigsDir?: () => string,
-/** 内容导入完成回调（更新运行时文本并重建预设）。 */
-afterPresetImport?: (scope: 'preset' | 'agents') => void,
+/** 内容导入完成回调：批量 scope 只触发一次重建（更新运行时文本并重建预设）。 */
+afterPresetImport?: (scopes: Array<'preset' | 'agents'>) => void,
 /** 参数覆盖写入回调（重建预设使参数生效）。 */
 afterOverridesChange?: () => void,
 /** 预设包导入完成回调（物化导入预设：组合/配置目录/共享引擎落盘，宿主 discovery 可见）。 */
-afterPresetPackageImport?: (id: string) => void): void;
+afterPresetPackageImport?: (id: string) => void): {
+  invalidateDescriptor: () => void;
+};
 //#endregion
 //#region src/runtime/character-tools.d.ts
 /** 工具执行所需的运行时宿主能力（index.ts 闭包提供）。 */
@@ -398,7 +425,8 @@ interface CharacterToolHost {
   /** 应用/移除后重建生成目录（写 preset.yml 后使参数生效）。 */
   rebuild: () => void;
 }
-declare function registerCharacterTools(ctx: Context, host: CharacterToolHost): void;
+/** 注册角色卡库模型工具；返回 disposer（预设切换重挂用）。enabled=false 返回空操作。 */
+declare function registerCharacterTools(ctx: Context, host: CharacterToolHost): () => void;
 //#endregion
 //#region src/runtime/world-book-tools.d.ts
 interface WorldBookToolHost {
@@ -409,7 +437,73 @@ interface WorldBookToolHost {
   /** 写盘后重建生成目录。 */
   rebuild: () => void;
 }
-declare function registerWorldBookTools(ctx: Context, host: WorldBookToolHost): void;
+/** 注册世界书条目级模型工具；返回 disposer（预设切换重挂用）。enabled=false 返回空操作。 */
+declare function registerWorldBookTools(ctx: Context, host: WorldBookToolHost): () => void;
+//#endregion
+//#region src/host/characters.d.ts
+/** 角色卡记忆变更后同步已导入预设的 chara-<id>-memory 注入条目
+ *  （world_book note 写入卡记忆后调用；未导入当前预设的卡返回 synced=false）。 */
+declare function syncImportedCharacterMemory(presetRoot: string, templateName: string, cardId: string): {
+  ok: true;
+  synced: boolean;
+} | {
+  ok: false;
+  message: string;
+};
+/** 追加角色卡本地记忆（.characters/<id>/memory.md，跟随角色卡跨预设）。 */
+declare function appendCharacterMemory(presetRoot: string, cardId: string, note: string): void;
+/** 追加记忆文件（时间戳列表格式；header 标注文件类型）。世界书工具与角色卡共用。 */
+declare function appendMemoryFile(file: string, note: string, header?: string): void;
+/** 读角色卡本地记忆文本（无记忆返回空串）。 */
+declare function readCharacterMemory(presetRoot: string, cardId: string): string;
+/** 角色卡入库：PNG 原图（可选）+ 角色卡 JSON → 转换参数存 converted.yml。 */
+declare function importCharacterCard(presetRoot: string, files: Array<{
+  path: string;
+  content: string;
+}>): {
+  ok: true;
+  id: string;
+  name: string;
+} | {
+  ok: false;
+  message: string;
+};
+interface CharacterCardListItem {
+  id: string;
+  name: string;
+  description?: string;
+  hasAvatar: boolean;
+  /** 是否已导入当前预设（激活预设 meta.importedCharacters 含该 id）。 */
+  imported: boolean;
+}
+/** 角色卡库清单 + 各卡在当前预设的导入状态。 */
+declare function listCharacterCards(presetRoot: string, activeTemplate: string | undefined): CharacterCardListItem[];
+/** 删除角色卡库条目。 */
+declare function deleteCharacterCard(presetRoot: string, id: string): {
+  ok: true;
+} | {
+  ok: false;
+  message: string;
+};
+/** 角色卡参数导入当前预设：promptConfigs 合并（chara-<id>- 前缀防冲突）、
+ *  params 合并（角色卡覆盖同键）、meta.importedCharacters 记录来源。 */
+declare function applyCharacterToPreset(presetRoot: string, templateName: string, cardId: string): {
+  ok: true;
+  count: number;
+  personaOpened?: boolean;
+} | {
+  ok: false;
+  message: string;
+};
+/** 从当前预设移除角色卡参数：删前缀 promptConfigs、删该卡声明的 params 键、
+ *  meta.importedCharacters 除名。 */
+declare function removeCharacterFromPreset(presetRoot: string, templateName: string, cardId: string): {
+  ok: true;
+  count: number;
+} | {
+  ok: false;
+  message: string;
+};
 //#endregion
 //#region src/host/templates.d.ts
 interface PromptConfigTemplate {
@@ -420,34 +514,23 @@ interface PromptConfigTemplate {
   /** 解析后的单条提示词配置。 */
   spec: PromptConfigSpec;
 }
+/** 自定义工具模板（templates/tools/*.yml；tool-config-engine 定义形态）。 */
+interface ToolTemplate {
+  file: string;
+  content: string;
+  /** 解析后的工具定义（含 id/name/execute.kind）。 */
+  spec: Record<string, unknown>;
+}
 /** 扫描包内 templates/*.yml，按文件名排序返回（文件损坏时抛出，由调用方决定呈现）。 */
 declare function loadPromptTemplates(): PromptConfigTemplate[];
+/** 工具模板库扫描（templates/tools/*.yml；损坏 fail loud——包内模板属于发布 bug）。 */
+declare function loadToolTemplates(): ToolTemplate[];
 //#endregion
 //#region src/runtime/tui.d.ts
+/** 参数保存回调：写激活预设 preset.yml；失败必须抛给命令层渲染为错误。 */
+type SavePresetParam = (key: string, value: unknown) => void | Promise<void>;
 /** 通过 DSH 命令注册表暴露 /prompt-tool，Web 与 dsh-tui 都能执行。 */
-declare function registerTuiCommand(ctx: Context, ns: SettingsNamespace, getSource: () => PromptSettings, getModelsState: () => ModelDetection, getModelCatalog: () => Promise<Record<string, string[]>>, getPresetConfigsDir?: () => string,
-/** 参数保存回调（写激活预设 preset.yml；key='promptConfigs' 时 value 为数组）。 */
-savePresetParam?: (key: string, value: unknown) => void): void;
-//#endregion
-//#region src/runtime/settings-registration.d.ts
-interface SettingsRegistrationHooks<T> {
-  /** 注册时的 composition base（每次尝试注册都取最新值）。 */
-  base: () => T;
-  /** 注册成功后接线：setSource / watch / 初始 onChange。 */
-  onRegistered: (scope: {
-    get: () => T;
-    watch: (callback: (next: T, prev: T) => void) => void;
-  }) => void;
-  /** 注册失败（schema 校验或重复注册竞态）时的日志出口。 */
-  onError: (message: string) => void;
-}
-/**
- * 确保 `ns` 已注册：已注册（describe 命中）直接返回 true；未注册时补注册。
- * 官方 installSettingsSection 的 inject 回调只在 settings 服务首次可用时跑一次，
- * settings 服务实例被替换（provider fiber reload）后注册丢失且不自动重建；
- * 本函数由 Web bridge 每次请求前调用兜底。
- */
-declare function ensureSettingsRegistered<T>(sctx: Context, ns: SettingsNamespace, schema: unknown, hooks: SettingsRegistrationHooks<T>): boolean;
+declare function registerTuiCommand(ctx: Context, ns: 'prompt-tool', getSource: () => PromptSettings, getModelsState: () => ModelDetection, getModelCatalog: () => Promise<Record<string, string[]>>, getPresetConfigsDir?: () => string, savePresetParam?: SavePresetParam): void;
 //#endregion
 //#region src/runtime/skills-provider.d.ts
 /** 官方 dsh-skill 的 SkillName 契约：kebab-case。 */
@@ -508,14 +591,15 @@ declare function fixSkillEntry(skillsDir: string, folder: string): SkillFixResul
 //#region src/shared/bridge-contract.d.ts
 /**
  * settings bridge 跨端契约（host 注册 / client 消费的唯一来源）。
- * 铁律：11 端点载荷统一成功 `{ ok: true, value }`、失败 `{ ok: false, code?, message? }`；
+ * 铁律：25 端点载荷统一成功 `{ ok: true, value }`、失败 `{ ok: false, code?, message? }`；
  * 端点附加字段只能以 value 旁的可选扩展字段出现（describe）。
  * 改路径或载荷形状必须同步更新 test/shared/bridge-contract.test.mjs。
  */
 declare const SETTINGS_BRIDGE_PREFIX = "/api/prompt-tool/settings";
-/** 22 个桥端点路径（相对前缀）。新增端点必须同时登记到契约测试。 */
+/** 桥端点路径（相对前缀）。新增端点必须同时登记到契约测试。 */
 declare const BRIDGE_ENDPOINTS: {
   readonly meta: "/meta";
+  readonly bootstrap: "/bootstrap";
   readonly describe: "/describe";
   readonly models: "/models";
   readonly mutate: "/mutate";
@@ -527,6 +611,7 @@ declare const BRIDGE_ENDPOINTS: {
   readonly importPreset: "/import-preset";
   readonly paramOverrides: "/param-overrides";
   readonly presetVariables: "/preset-variables";
+  readonly customTools: "/custom-tools";
   readonly importPresetPackage: "/import-preset-package";
   readonly exportPreset: "/export-preset";
   readonly presetDelete: "/preset-delete";
@@ -568,4 +653,4 @@ declare const name = "prompt-tool";
 declare const inject: string[];
 declare function apply(ctx: Context, configIn: Config): void;
 //#endregion
-export { BRIDGE_ENDPOINTS, type BridgeEndpoint, type BridgeErrorPayload, type CachedSkillsReader, Config, PARAM_KEYS, type PresetSpec, type PromptConfigTemplate, type PromptConfigValidationError, type PromptConfigValidationResult, PromptSettingsSchema, SETTINGS_BRIDGE_PREFIX, SKILL_NAME_RE, type SettingsRegistrationHooks, type SkillCatalogEntry, type SkillEntry, type SkillFixResult, type SkillFrontmatter, type WritePresetOptions, apply, applyModuleConfigs, cloneBuiltinPreset, createCachedSkillsReader, detectModels, ensurePresetSeed, ensureSettingsRegistered, ensureWebSurface, fixSkillEntry, inject, installDefaultModelRoute, isValidSkill, listAdvertisedModels, listBuiltinTemplates, listPresets, listSkillFolders, loadPresetSpec, loadPromptTemplates, mergeSkillDirs, migrateLegacyLayout, name, normalizePresetRootDir, parseFrontmatter, readPluginState, readSkills, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeUserPreset, resolvePresetDir, resolvePresetParams, resolveProfileDir, resolveProfileSkillsDir, savePresetParams, stPresetId, toKebabName, userPresetsDir, validSkills, validatePromptConfigs, writePluginState, writePreset };
+export { BRIDGE_ENDPOINTS, type BridgeEndpoint, type BridgeErrorPayload, type CachedSkillsReader, Config, ENGINE_PARAM_KEYS, MODEL_SEGMENT_MAP, PARAM_KEYS, type PresetSpec, type PromptConfigTemplate, type PromptConfigValidationError, type PromptConfigValidationResult, PromptSettingsSchema, SETTINGS_BRIDGE_PREFIX, SKILL_NAME_RE, type SkillCatalogEntry, type SkillEntry, type SkillFixResult, type SkillFrontmatter, type ToolTemplate, WRITER_PARAM_KEYS, type WritePresetOptions, appendCharacterMemory, appendMemoryFile, apply, applyCharacterToPreset, applyModuleConfigs, buildModuleConfigsFromParams, buildWorldBookEntry, cloneBuiltinPreset, convertStToPreset, createCachedSkillsReader, deleteCharacterCard, deleteWorldBookEntry, detectModels, ensurePresetSeed, ensureWebSurface, fixSkillEntry, importCharacterCard, inject, installDefaultModelRoute, isValidSkill, listAdvertisedModels, listBuiltinTemplates, listCharacterCards, listPresets, listSkillFolders, listWorldBookEntries, loadPresetSpec, loadPromptTemplates, loadToolTemplates, mergeSkillDirs, mergeStPresets, migrateLegacyLayout, name, normalizePresetRootDir, parseFrontmatter, processStText, readCharacterMemory, readPluginState, readSkills, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeCharacterFromPreset, removeUserPreset, renderComposition, resolvePresetDir, resolvePresetParams, resolveProfileDir, resolveProfileSkillsDir, savePresetParams, stPresetId, syncImportedCharacterMemory, toKebabName, upsertWorldBookEntry, userPresetsDir, validSkills, validatePromptConfigs, writePluginState, writePreset };