dsh-plugin-prompt-tool 0.8.1 → 2.0.0

package/lib/index.d.mts

@@ -1,10 +1,165 @@
-import { $ as ENGINE_RECIPES, A as resolvePresetParams, B as MAX_CHARACTER_CARD_STREAM_BYTES, C as loadPresetSpec, D as renderComposition, E as removeUserPreset, F as BridgeEndpoint, G as SkillPolicyChange, H as SkillCatalogEntry, I as BridgeErrorPayload, J as SkillsCatalogSnapshot, K as SkillPolicyScope, L as BridgeRequestMap, M as savePresetPersona, N as userPresetsDir, O as resolvePresetDir, P as BRIDGE_ENDPOINTS, Q as ENGINE_CAPABILITIES, R as BridgeValueMap, S as listPresets, T as removePresetModule, U as SkillContentSnapshot, V as SETTINGS_BRIDGE_PREFIX, W as SkillInvocation, X as invocationForScope, Y as SkillsState, Z as scopeOfInvocation, _ as buildModuleConfigsFromParams, a as installPresetPackage, at as isEngineCapabilityPresent, b as ensurePresetSeed, c as convertStToPreset, ct as ImportChoices, d as stPresetId, dt as InstructionFileSnapshot, et as EngineCapability, f as EngineCapabilityCreateRequest, ft as InstructionFileStatus, g as applyModuleConfigs, h as PresetSpec, i as exportPresetPackage, it as engineRecipe, j as savePresetParams, k as resolvePresetModuleFacts, l as mergeStPresets, lt as INSTRUCTION_FILE_STATUSES, m as EngineCapabilityRemoveResult, n as USER_SKILLS_DIR, nt as PresetModuleFacts, o as presetImportPreview, ot as validateCustomToolIdentities, p as EngineCapabilityCreateResult, pt as MAX_INSTRUCTION_FILE_BYTES, q as SkillSourceKind, r as expandPresetSource, rt as engineCapability, s as StConversionOptions, st as AssetFile, tt as ModuleSourceMode, u as processStText, ut as InstructionContextView, v as cloneBuiltinPreset, w as removeEngineCapabilityFromPreset, x as listBuiltinTemplates, y as createEngineCapabilityInPreset, z as MAX_BRIDGE_BODY_BYTES } from "./paths-CY5psBqE.mjs";
+import { $ as SkillSourceKind, A as removeUserModule, B as BridgeEndpoint, C as ensureModuleSeed, Ct as moduleCapability, D as moduleDirExists, E as loadModuleSpec, F as saveModuleParams, G as MAX_CHARACTER_CARD_STREAM_BYTES, H as BridgeRequestMap, I as saveModulePersona, J as SkillCatalogEntry, K as ModuleSummary, L as userModulesDir, M as resolveModuleDir, N as resolveModuleFacts, O as removeModuleCapability, P as resolveModuleParams, Q as SkillPolicyScope, R as withModuleDefinition, S as createModuleCapability, St as isModuleCapabilityPresent, T as listModules, U as BridgeValueMap, V as BridgeErrorPayload, W as MAX_BRIDGE_BODY_BYTES, X as SkillInvocation, Y as SkillContentSnapshot, Z as SkillPolicyChange, _ as ModuleSpec, _t as MODULE_CAPABILITIES, a as installModulePackage, at as ImportChoices, b as buildModuleConfigsFromParams, bt as ModuleSourceMode, c as convertStToModule, ct as RuleDefinition, d as mergeStModulesWithReport, dt as InstructionFileSnapshot, et as SkillsCatalogSnapshot, f as processStText, ft as InstructionFileStatus, g as ModuleCapabilityRemoveResult, gt as InjectionPoint, h as ModuleCapabilityCreateResult, ht as INJECTION_POINT_ORDER, i as exportModulePackage, it as AssetFile, j as renderComposition, k as removeModuleCapabilityDeclaration, l as convertStToModuleWithReport, lt as INSTRUCTION_FILE_STATUSES, m as ModuleCapabilityCreateRequest, mt as ENGINE_RECIPES, n as USER_SKILLS_DIR, nt as invocationForScope, o as moduleImportPreview, ot as ModuleExportRequest, p as stModuleId, pt as MAX_INSTRUCTION_FILE_BYTES, q as SETTINGS_BRIDGE_PREFIX, r as expandModuleSource, rt as scopeOfInvocation, s as StConversionOptions, st as ModuleExportResult, tt as SkillsState, u as mergeStModules, ut as InstructionContextView, v as appendModuleCapabilities, vt as ModuleCapability, w as listBuiltinTemplates, wt as validateCustomToolIdentities, x as cloneBuiltinModule, xt as engineRecipe, y as applyModuleConfigs, yt as ModuleFacts, z as BRIDGE_ENDPOINTS } from "./paths-CyP0IkaM.mjs";
 import { parseDocument } from "yaml";
 import z from "@deepseek-ai/schemastery";
+import { ToolExecution } from "@deepseek-ai/dsh-tools";
 import { Context, Volatile } from "@deepseek-ai/cordis";
 import { SkillViewOptions } from "@deepseek-ai/dsh-skill";
 import { AgentOptions } from "@deepseek-ai/dsh-agent";
 import { SubagentRuntime } from "@deepseek-ai/dsh-subagent";
+//#region src/shared/param-keys.d.ts
+declare const PARAM_KEYS: ReadonlySet<string>;
+//#endregion
+//#region src/config.d.ts
+interface Config {
+  modulesEnabled: Volatile<boolean | undefined>;
+  /** 已部署配置的输入兼容；只在读取与显式保存边界归一。 */
+  writePreset?: Volatile<boolean | undefined>;
+}
+declare const Config: z<Schemastery.ObjectS<NoInfer<{
+  modulesEnabled: z<boolean, boolean, "volatile">;
+  writePreset: z<boolean, boolean, "volatile">;
+}>>, Schemastery.ObjectT<NoInfer<{
+  modulesEnabled: z<boolean, boolean, "volatile">;
+  writePreset: z<boolean, boolean, "volatile">;
+}>>, "plain">;
+interface PromptSettings {
+  /** 运行时检测：是否检测到任何模型服务商（不写入 settings）。 */
+  modelsAvailable: boolean;
+  modulesEnabled: boolean;
+}
+//#endregion
+//#region src/shared/legacy-prompt-params.d.ts
+/** 旧规则快捷参数只用于读取与旧 API 兼容；新编辑器直接保存规则实例。 */
+declare const LEGACY_PROMPT_PARAM_DEFINITIONS: {
+  readonly firstTurnAnchor: {
+    readonly kind: "boolean";
+    readonly targets: readonly ["near-anchor"];
+  };
+  readonly firstTurnText: {
+    readonly kind: "string";
+    readonly targets: readonly ["near-anchor", "prompt-injector"];
+  };
+  readonly firstTurnCustom: {
+    readonly kind: "boolean";
+    readonly targets: readonly ["near-anchor"];
+  };
+  readonly guideText: {
+    readonly kind: "string";
+    readonly targets: readonly ["router-guide"];
+  };
+  readonly guideCustom: {
+    readonly kind: "boolean";
+    readonly targets: readonly ["router-guide"];
+  };
+  readonly guideEnabled: {
+    readonly kind: "boolean";
+    readonly targets: readonly ["router-guide"];
+  };
+  readonly injectPrompt: {
+    readonly kind: "boolean";
+    readonly targets: readonly ["prompt-injector"];
+  };
+  readonly firstTurnWord: {
+    readonly kind: "string";
+    readonly targets: readonly ["prompt-injector"];
+  };
+  readonly buildPattern: {
+    readonly kind: "pattern";
+    readonly targets: readonly ["near-anchor"];
+  };
+  readonly complexPattern: {
+    readonly kind: "pattern";
+    readonly targets: readonly ["near-anchor", "router-guide"];
+  };
+  readonly firstTurnBuild: {
+    readonly kind: "string";
+    readonly targets: readonly ["near-anchor", "prompt-injector"];
+  };
+  readonly firstTurnInspect: {
+    readonly kind: "string";
+    readonly targets: readonly ["near-anchor", "prompt-injector"];
+  };
+  readonly firstTurnDeep: {
+    readonly kind: "string";
+    readonly targets: readonly ["near-anchor", "prompt-injector"];
+  };
+  readonly guideWeak: {
+    readonly kind: "string";
+    readonly targets: readonly ["router-guide"];
+  };
+  readonly guideDeep: {
+    readonly kind: "string";
+    readonly targets: readonly ["router-guide"];
+  };
+};
+type LegacyPromptParamKey = keyof typeof LEGACY_PROMPT_PARAM_DEFINITIONS;
+type LegacyPromptParams = { [K in LegacyPromptParamKey]?: typeof LEGACY_PROMPT_PARAM_DEFINITIONS[K]['kind'] extends 'boolean' ? boolean : string; };
+//#endregion
+//#region src/shared/engine-params.d.ts
+interface EngineParams {
+  /** 主会话请求路由 provider；与模型名同时非空时生效。 */
+  modelProvider?: string;
+  /** 模型名；与 provider 同时非空时生效。 */
+  modelName?: string;
+  /** 本地子代理请求路由 provider；不改写普通官方委派的创建参数。 */
+  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;
+  /** 已启用子代理工具策略的递归深度上限；普通官方委派由宿主管理。 */
+  maxDepth?: number | 'provider-managed' | string;
+  /** 晋升后 agent-instructions 全文 → 一次性 hint。 */
+  instructionHint?: boolean;
+  /** tool-git-bash 行的能力开关（B2 T3 补；此前该行只能靠「在不在组合里」决定启停）。 */
+  toolGitBashEnabled?: boolean;
+  /** 自定义模型工具在执行前需用户批准的执行器种类。 */
+  customToolRequireApproval?: string[] | string;
+}
+type EngineParamKey = keyof EngineParams;
+/**
+ * writeModule 实际透传进运行时 params 的引擎参数子集。
+ * RuntimeOptions（装配态）与 WriteModuleOptions（写入态）都从这里派生，
+ * 防止「加参数只改一处、模块写者忘透传」的静默漂移（如 stageAdvanceDescription 历史事故）。
+ */
+type ModuleWriterParams = Partial<EngineParams & LegacyPromptParams>;
+/**
+ * 数值型引擎参数保存前校验（与 write-preset.modelRequestConfigs 消费规则同源）。
+ * 保存层响亮失败（400 逐字段错误），渲染层保持宽容（never-brick）：
+ *   - 布尔键：必须是 boolean；
+ *   - 数值键（temperature / maxTokens / 字符数）：'' = 合法（删键回落默认）；
+ *     非空必须可解析为数字并满足各自约束（有限数 / 正整数）；
+ *   - 字符串键：必须是 string（'' = 删键回落默认）；
+ *   - 列表键（执行器种类等）：必须是 string 或 string[]；
+ *   - maxDepth：'' / 'provider-managed' / 非负安全整数及其数字字符串。
+ * 未知键（旧内容别名等不兼容键）在保存期响亮失败，不做运行时自动兼容。
+ * 注意：内容占位变量（variables）的空字符串是合理设计（世界书动态引用），
+ * 本函数只校验引擎行为参数，绝不碰 variables 通道。
+ */
+interface EngineParamValueError {
+  key: string;
+  message: string;
+}
+declare const ENGINE_PARAM_KEYS: EngineParamKey[];
+/** writeModule 实际透传键：全部引擎参数可直接进入 writer。 */
+declare const WRITER_PARAM_KEYS: (keyof EngineParams | "firstTurnAnchor" | "firstTurnText" | "firstTurnCustom" | "guideText" | "guideCustom" | "guideEnabled" | "injectPrompt" | "firstTurnWord" | "buildPattern" | "complexPattern" | "firstTurnBuild" | "firstTurnInspect" | "firstTurnDeep" | "guideWeak" | "guideDeep")[];
+/**
+ * 校验参数键值（键集合合法性由调用方白名单先行校验，本函数同样拒绝未知键）。
+ * 返回逐字段错误；空数组 = 通过。类型收窄：布尔/字符串/数值/列表各按 canonical
+ * 规则校验；'' 是合法删键值，其余非法类型与越界值在保存层响亮失败。
+ */
+declare function validateEngineParamValues(overrides: Record<string, unknown>): EngineParamValueError[];
+//#endregion
 //#region src/host/prompt-configs.d.ts
 /**
  * `PromptConfigSpec` 各枚举字段的**运行期值清单**。
@@ -77,12 +232,6 @@ interface PromptConfigSpec {
 declare function assertSafeConfigId(id: string): void;
 /** 生成文件名统一 4 位零填充前缀（0000-…），超过 10 条后字典序仍稳定。 */
 declare function configFileName(index: number, id: string): string;
-interface PromptConfigFile {
-  /** 模块文件夹内文件名（数字前缀决定引擎执行顺序）。 */
-  file: string;
-  /** yml 文件内容。 */
-  content: string;
-}
 /**
  * 条件判定的键集合：与 `engine/anchor-match.mjs` 的匹配语义同构。
  * 键按字面文本匹配（正则元字符会被转义）；要写正则须用 `/pattern/flags` 形态或 `useRegex: true`。
@@ -96,185 +245,39 @@ interface PromptConfigMatch {
   useRegex?: boolean;
 }
 //#endregion
-//#region src/shared/engine-params.d.ts
-/**
- * 引擎行为参数契约（单一来源）。
- *
- * 这是「可配置引擎参数」的类型唯一权威：所有消费引擎参数的接口（RuntimeOptions /
- * WritePresetOptions）从这里派生，不再各自手写一遍字段
- * （此前多处重复声明导致同字段签名漂移，如 maxDepth / modelTemperature）。
- *
- * 分层约定：
- *  - 本文件 = 引擎参数「契约层」（类型）：参数桥/模板/UI 可配置的键与类型；
- *  - ENGINE_PARAM_DEFINITIONS 统一键、校验、卡片、默认草稿与组合映射；
- *    Record<keyof EngineParams, ...> 强制完整覆盖，ENGINE_PARAM_KEYS 与 PARAM_KEYS 从其派生；
- *  - layerSettings ↔ 运行时平铺键：loadPresetSpec 展平 / savePresetParams 按层写入。
- *
- * 全部字段可选：缺省 = 模板 preset.yml layerSettings / 引擎默认，符合「一切皆可自定义」。
- */
-interface EngineParams {
-  /** 首轮近距离锚定：首条真实用户消息后追加一次性首句锚点。 */
-  firstTurnAnchor?: boolean;
-  /** 自定义锚点文本；firstTurnCustom=true 时固定使用。 */
-  firstTurnText?: string;
-  /** 自定义锚点开关：true 固定使用 firstTurnText；false 按任务自动选择。 */
-  firstTurnCustom?: boolean;
-  /** 自定义每轮引导文本；guideCustom=true 时固定使用。 */
-  guideText?: string;
-  /** 自定义每轮引导开关：true 固定使用 guideText；false 按任务自动选择。 */
-  guideCustom?: boolean;
-  /** 每轮引导独立开关；缺省关闭。 */
-  guideEnabled?: boolean;
-  /** 锚定确认后注入 preset.md；关闭时仍保留工具引导，但不生成 prompt-injector 提示词配置内容。 */
-  injectPrompt?: boolean;
-  /** 模型路由 provider；与模型名同时非空时给 subagent/subagent_fork 行加 agentOptions（主对话直派子代理与委派子代理通用）。 */
-  modelProvider?: string;
-  /** 模型名；与 provider 同时非空时生效。 */
-  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;
-  /** 委派递归深度上限（0 禁止委派 / provider-managed / 正整数；数字字符串同义）。 */
-  maxDepth?: number | 'provider-managed' | string;
-  /** custom-fallback 锚定词（prompt-injector params.firstTurnWord）。 */
-  firstTurnWord?: string;
-  /**
-   * 锚定/引导内容键：writePreset 把它们映射进 near-anchor / router-guide 的
-   * promptConfig params（由对应策略消费）。此前只在 PARAM_KEYS 旁路白名单里，
-   * 保存链接受键名却被值校验拒绝，形成「白名单通过、写盘前报未知键」的断层。
-   */
-  /** 构建任务正则（锚定三档分类的 build 档；编译规则与 engine/classify-task.mjs 同源，flags=i）。 */
-  buildPattern?: string;
-  /** 复杂任务正则（锚定 complex 档与引导深度判定共用）。 */
-  complexPattern?: string;
-  /** 构建档锚句。 */
-  firstTurnBuild?: string;
-  /** 排查档锚句。 */
-  firstTurnInspect?: string;
-  /** 深度档锚句。 */
-  firstTurnDeep?: string;
-  /** 引导-简短档正文。 */
-  guideWeak?: string;
-  /** 引导-深度档正文。 */
-  guideDeep?: string;
-  /** 晋升后 agent-instructions 全文 → 一次性 hint。 */
-  instructionHint?: boolean;
-  /** str-replace-editor 最大输出字符数（参数桥默认官方值 16000；由引擎能力卡编辑）。 */
-  strReplaceEditorMaxOutputChars?: number;
-  /** tool-git-bash 行的能力开关（B2 T3 补；此前该行只能靠「在不在组合里」决定启停）。 */
-  toolGitBashEnabled?: boolean;
-  /** 自定义模型工具在执行前需用户批准的执行器种类。 */
-  customToolRequireApproval?: string[] | string;
-}
-type EngineParamKey = keyof EngineParams;
-/**
- * writePreset.runtimeOf 实际透传进运行时 params 的引擎参数子集。
- * RuntimeOptions（装配态）与 WritePresetOptions（写入态）都从这里派生，
- * 防止「加参数只改一处、writePreset 忘透传」的静默漂移（如 stageAdvanceDescription 历史事故）。
- */
-type PresetWriterParams = Partial<EngineParams>;
-/**
- * 数值型引擎参数保存前校验（与 write-preset.modelRequestConfigs 消费规则同源）。
- * 保存层响亮失败（400 逐字段错误），渲染层保持宽容（never-brick）：
- *   - 布尔键：必须是 boolean；
- *   - 数值键（temperature / maxTokens / 字符数）：'' = 合法（删键回落默认）；
- *     非空必须可解析为数字并满足各自约束（有限数 / 正整数）；
- *   - 字符串键：必须是 string（'' = 删键回落默认）；
- *   - 列表键（执行器种类等）：必须是 string 或 string[]；
- *   - maxDepth：'' / 'provider-managed' / 非负安全整数及其数字字符串。
- * 未知键（旧内容别名等不兼容键）在保存期响亮失败，不做运行时自动兼容。
- * 注意：内容占位变量（variables）的空字符串是合理设计（世界书动态引用），
- * 本函数只校验引擎行为参数，绝不碰 variables 通道。
- */
-interface EngineParamValueError {
-  key: string;
-  message: string;
-}
-declare const ENGINE_PARAM_KEYS: EngineParamKey[];
-/** writePreset.runtimeOf 实际透传键：全部引擎参数可直接进入 writer。 */
-declare const WRITER_PARAM_KEYS: (keyof EngineParams)[];
-/**
- * 校验参数键值（键集合合法性由调用方白名单先行校验，本函数同样拒绝未知键）。
- * 返回逐字段错误；空数组 = 通过。类型收窄：布尔/字符串/数值/列表各按 canonical
- * 规则校验；'' 是合法删键值，其余非法类型与越界值在保存层响亮失败。
- */
-declare function validateEngineParamValues(overrides: Record<string, unknown>): EngineParamValueError[];
-//#endregion
-//#region src/shared/param-keys.d.ts
-declare const PARAM_KEYS: ReadonlySet<string>;
-//#endregion
-//#region src/config.d.ts
-interface Config {
-  /** 是否生成注入预设（默认 true）。 */
-  writePreset: Volatile<boolean>;
-  /** 预设模板名（默认 pt-standard：与宿主内置 standard 同名的用户目录会被遮蔽）。 */
-  presetTemplate: Volatile<string>;
-  /** 生成 preset 的显示顺序。 */
-  presetOrder: Volatile<number>;
-  /** preset.md 缺失或不可读时使用的文本。 */
-  fallbackText: Volatile<string>;
-}
-declare const Config: z<Schemastery.ObjectS<NoInfer<{
-  writePreset: z<boolean, boolean, "volatile-defined">;
-  presetTemplate: z<string, string, "volatile-defined">;
-  presetOrder: z<number, number, "volatile-defined">;
-  fallbackText: z<string, string, "volatile-defined">;
-}>>, Schemastery.ObjectT<NoInfer<{
-  writePreset: z<boolean, boolean, "volatile-defined">;
-  presetTemplate: z<string, string, "volatile-defined">;
-  presetOrder: z<number, number, "volatile-defined">;
-  fallbackText: z<string, string, "volatile-defined">;
-}>>, "plain">;
-interface PromptSettings {
-  /** 运行时检测：是否检测到任何模型服务商（不写入 settings）。 */
-  modelsAvailable: boolean;
-  /** 生成 preset 的显示顺序。 */
-  presetOrder: number;
-  /** preset.md 缺失或不可读时使用的文本。 */
-  fallbackText: string;
-  writePreset: boolean;
-  presetTemplate: string;
-}
-declare const PromptSettingsSchema: z<PromptSettings>;
-//#endregion
 //#region src/host/write-preset.d.ts
-/**
- * 把任意单一参数预设模板物化到生成目录（writePreset）的写入态选项。
- * 引擎参数契约来自 shared/engine-params.ts（PresetWriterParams：runtimeOf 透传子集），
- * 此处只保留 writePreset 专属字段——加引擎参数只需改一处契约，漏透传变成编译错误。
- */
-interface WritePresetOptions extends PresetWriterParams {
-  /** AGENTS.md 内容资产（写生成目录 agents.md）：常驻层写盘的唯一来源，不再注入提示词。 */
+interface WriteModuleOptions {
+  modulesRoot: string;
+  moduleId: string;
+  targetModuleId?: string;
+  sourceDir?: string;
+  /** 返回独立暂存根下的合法模块目录；安装方负责交换与清理暂存根。 */
+  stageOnly?: boolean;
   agentsInstructionText?: string;
-  presetDir: string;
-  presetOrder: number;
-  /** settings 层用户自定义提示词配置(优先级最高)。 */
-  promptConfigs: PromptConfigSpec[];
-  /** 当前预设目录名；默认 pt-standard。 */
+  warn?: (message: string) => void;
+}
+/** 旧入口只做名称适配；行为规则和参数必须已写入完整定义。 */
+interface WritePresetOptions extends ModuleWriterParams {
+  moduleDir: string;
   presetTemplate?: string;
-  /** 输出目录/预设 id 覆盖；缺省 = presetTemplate 同名输出。 */
   outputId?: string;
-  /** 隔离的定义/资源来源；与最终 outputId 分离，不回退同名已安装预设。 */
   sourceDir?: string;
-  /** 只生成并返回暂存目录；调用方负责安装或清理，不更新共享引擎及目标目录。 */
   materializeOnly?: boolean;
-  /** 目录加载失败等非致命告警回调。 */
+  agentsInstructionText?: string;
+  presetOrder?: number;
+  promptConfigs?: PromptConfigSpec[];
   warn?: (message: string) => void;
 }
-/** 把任意单一参数预设模板物化到生成目录;全部失败 fail loud。 */
+/** 按模块身份原地恢复切片；用户资产、正文与完整定义均不重写。 */
+declare function ensureModuleReady(id: string, options: {
+  modulesRoot?: string;
+  moduleDir?: string;
+  presetOrder?: number;
+  warn?: (message: string) => void;
+}): string;
+/** 已有同一模块只恢复切片；导入/复制先完整生成合法身份候选，再交换目标。 */
+declare function writeModule(prompt: string, options: WriteModuleOptions): string;
+/** @deprecated 使用 writeModule；旧字段仅在此边界适配。 */
 declare function writePreset(prompt: string, options: WritePresetOptions): string;
 //#endregion
 //#region src/host/agents-cards.d.ts
@@ -344,16 +347,15 @@ declare function writeAgentsFileChecked(options: {
 }): Promise<AgentsFileWriteOutcome>;
 //#endregion
 //#region src/runtime/pre-step-coordinator.d.ts
-/** 协调服务名：引擎行通过 ctx.get 解析本服务决定走管理路径还是独立路径。 */
 declare const PRE_STEP_COORDINATOR_SERVICE = "promptToolPreStep";
-/** 服务契约版本：引擎与协调器不同步时按「不认识就不接管」处理。 */
 declare const PRE_STEP_COORDINATOR_VERSION = 1;
-/** 批执行算法消费的提示词配置（与 engine/schema.mjs 产出的形状同源）。 */
 interface PreStepPromptConfig {
   id: string;
   layer: string;
   enabled?: boolean;
   order: number;
+  sequence?: number;
+  sourceModuleId?: string;
   position: string;
   promotion: string;
   audience: string | null;
@@ -372,58 +374,23 @@ interface PreStepPromptConfig {
   };
   resolve: (input: Record<string, unknown>) => unknown;
 }
-/** 一个预设 mount 注册进来的来源：提示词配置 + 装配事实（晋升/去重由协调器统一持有）。 */
 interface PreStepSource {
   configs: readonly PreStepPromptConfig[];
+  /** 已编译的本地点规则动作；执行与配置叶子共享同一批次资格帧。 */
+  ruleActions?: readonly unknown[];
   officialInstructions?: boolean;
 }
-/**
- * 文件来源每次 pre-step 编译出的最小候选。
- * `available: false` 表示读取失败/超限/空内容：只在「该文件曾经注入过」时转成
- * 一次性失效通知，不冒充空正文。
- */
-interface PreStepFileContribution {
-  fileId: string;
-  displayPath: string;
-  revision: string;
-  text: string;
-  available: boolean;
-  reason?: string;
-  order: number;
-  position: string;
-  promotion: string;
-  audience: string | null;
-  modelScope: string;
-}
 interface PreStepCoordinatorOptions {
-  /** 每次 pre-step 现读指令文件；缺省实现走 host 探测 + 独立策略。测试可注入。 */
-  collectFiles?: (agent: unknown, session: unknown) => PreStepFileContribution[];
-  /** 策略文件位置覆盖（测试隔离用）。 */
   policyFile?: string;
-  /** 用户级指令文件根（DSH_HOME）覆盖（测试隔离用）。 */
   home?: string;
 }
 interface PreStepCoordinatorService {
   readonly version: number;
-  /**
-   * 把 preset mount 的 pre-step 配置登记进协调器。
-   * 同一 scope 内同一个 `sourceId` 再次登记时后来者接管：先撤销旧登记再插入新登记。
-   * 宿主重挂同一个 preset（或其引擎行的旧 fiber 尚未释放）时这是正常路径，不是配置错误，
-   * 因此不抛错——抛错会让整行未激活，进而让 preset 挂载整体失败（无法切换预设）。
-   * @param sourceCtx 注册 ctx：同时决定来源作用域与释放时机（挂在这个 fiber 上）。
-   * @param sourceId 来源 id（同一 scope 内唯一：同名登记以最新一次为准）。
-   * @returns 幂等的撤销函数；登记已被后来者顶替时调用它是空操作。
-   */
   registerPreset(sourceCtx: Context, sourceId: string, source: PreStepSource): () => void;
-  /** 该会话最近一次 pre-step 观察到的负责人事实；未知返回 undefined。 */
   officialOwnerOf(sessionId: string): boolean | undefined;
+  /** hint 转换前也调用同一过滤器，保证监听器重挂顺序不让已关闭正文变成 hint。 */
+  filterInstructions(agent: unknown, messages: unknown[]): unknown[];
 }
-/**
- * 安装协调器：发布 `promptToolPreStep` 服务并注册唯一的 pre-step 监听器。
- * 普通监听器留在 prepend 门控内侧；来源监听器只登记后交出执行权。
- * 即使服务迟到或重挂，下游的 pre-step 过滤（声明式触发器的 `pre-step-filter` 动作）
- * 仍能在本监听器交出执行权之后过滤最终消息批。
- */
 declare function installPreStepCoordinator(ctx: Context, options?: PreStepCoordinatorOptions): PreStepCoordinatorService;
 //#endregion
 //#region src/runtime/models.d.ts
@@ -544,28 +511,42 @@ interface SkillsBridgeState {
   patchSkillFolders: (folders: string[]) => SkillsStateRead | Promise<SkillsStateRead>;
 }
 /**
- * 两类卡合并：预设卡原样保留，文件卡换成本次工作区的文件快照。
+ * 两类卡合并：模块卡原样保留，文件卡换成本次工作区的文件快照。
  * 生成目录里属于其他工作区的文件卡不再展示（写盘白名单也不含它们）；
  * 当前工作区里没有对应生成卡的文件按默认文件卡补齐。
  */
-declare function mergeInstructionCards(presetCards: readonly unknown[], files: readonly InstructionFileSnapshot[]): unknown[];
+declare function mergeInstructionCards(moduleCards: readonly unknown[], files: readonly InstructionFileSnapshot[]): unknown[];
 /** 自建 loopback settings bridge：替代 registerConfigurableProviders，避免模型设置区出现插件条目。 */
-declare function registerSettingsBridge(ctx: Context, ns: string, getModelsState: () => ModelDetection, getSkillsState: () => SkillsBridgeState, getEngineStrategyDir: () => string, afterSkillsChange?: () => void,
-/** 生成目录（presetDir）：读取实际生效的提示词配置（引擎加载源）。 */
-getPresetConfigsDir?: () => string,
-/** 内容导入完成回调：批量 scope 只触发一次重建（更新运行时文本并重建预设）。 */
-afterPresetImport?: (scopes: Array<'preset' | 'agents'>) => void,
-/** 参数覆盖写入后重建当前预设。 */
-afterOverridesChange?: () => void | Promise<void>,
-/** 预设已完整安装后的刷新回调；失败只返回 refreshWarning，不再物化或撤销安装。 */
-afterPresetPackageImport?: (id: string) => void | Promise<void>,
-/** 能力/recipe 原子创建后重建回调；抛错时调用方恢复 preset.yml。 */
-afterCapabilityChange?: () => void,
-/** 新建、复制或删除预设后刷新官方注册。 */
-afterPresetListChange?: () => void | Promise<void>): {
+declare function registerSettingsBridge(ctx: Context, ns: string, getModelsState: () => ModelDetection, getSkillsState: () => SkillsBridgeState, _getEngineStrategyDir: () => string, afterSkillsChange?: () => void,
+/**
+ * 生成目录（模块目录）：读取/写入哪一份提示词配置。
+ *
+ * 参数是**请求声明的编辑目标**（`x-module-id` 头解析而来）：给了就定位那个模块，
+ * 没给则由 host 回退启用表首项。编辑器因此不必依赖某个全局单选——配置卡自己的
+ * 模块身份决定写哪里。
+ */
+getModuleDirectory?: (moduleId?: string) => string,
+/** 内容导入完成回调：批量 scope 只触发一次重建（更新运行时文本并重建模块）。 */
+afterModuleContentImport?: (scopes: Array<'preset' | 'agents'>, moduleId?: string) => void | Promise<void>,
+/** 参数写入后重建指定模块；省略身份表示启用表变化，刷新全部运行实例。 */
+afterOverridesChange?: (moduleId?: string) => void | Promise<void>,
+/** 模块已完整安装后的刷新回调；失败返回未生效诊断，不再物化或撤销安装。 */
+afterModulePackageImport?: (id: string) => void | Promise<void>,
+/** 能力/recipe 提交后刷新回调；失败保留已提交定义并明确报告。 */
+afterCapabilityChange?: (moduleId?: string) => void | Promise<void>,
+/** 新建、复制或删除模块后重建当前模块。 */
+afterModuleListChange?: (id: string) => void | Promise<void>): {
   invalidateDescriptor: () => void;
 };
 //#endregion
+//#region src/host/module-layer-settings.d.ts
+declare class ModuleLayerSettingsError extends Error {
+  readonly code = "module-layer-settings-invalid";
+  constructor(message: string);
+}
+/** 仅消费当前 layerSettings；其余段作为未知字段留存，不投影为运行时参数。 */
+declare function readModuleLayerSettings(source: unknown): Record<string, unknown>;
+//#endregion
 //#region src/host/worldbook.d.ts
 type WorldBookEntry = Record<string, unknown>;
 /** buildWorldBookEntry 输入（两通道共用：ST 导入转换与模型 world_book_upsert 工具）。 */
@@ -593,25 +574,20 @@ interface WorldBookEntryInput {
  * 与模型工具（world_book_upsert）共用，不再各自手写条目结构。
  */
 declare function buildWorldBookEntry(input: WorldBookEntryInput): WorldBookEntry;
-/** 当前预设全部世界书条目（保持文件顺序）。 */
-declare function listWorldBookEntries(presetDir: string): WorldBookEntry[];
+/** 当前模块全部世界书条目（保持文件顺序）。 */
+declare function listWorldBookEntries(moduleDir: string): WorldBookEntry[];
 /** 新增或更新一条世界书条目（按 id 定位；不存在则追加）。返回写入后条目总数。 */
-declare function upsertWorldBookEntry(presetDir: string, entry: WorldBookEntry): number;
+declare function upsertWorldBookEntry(moduleDir: string, entry: WorldBookEntry): number;
 /** 删除一条世界书条目；不存在抛错。返回删除后条目总数。 */
-declare function deleteWorldBookEntry(presetDir: string, id: string): number;
+declare function deleteWorldBookEntry(moduleDir: string, id: string): number;
 //#endregion
 //#region src/web-surface.d.ts
 /** 从 loader 根 Include 的 baseUrl 推导 profile 目录。 */
 declare function resolveProfileDir(ctx: Context): string | undefined;
-/**
- * 每次启动：
- *  1. 只处理当前 profile：缺 webServer 时补 web-app 并提示重启；
- *  2. 不修改同级 profile，不主动退出进程。
- */
+/** 只读诊断；安装与 profile 变更交给官方 plugin_manager。 */
 declare function ensureWebSurface(ctx: Context, warn: (message: string) => void): void;
 /**
- * 把首次启动自愈挂到插件生命周期上：延迟到本轮装配结束后执行，
- * 插件卸载会取消计时器，卸载后不再异步补写 profile。
+ * 延迟到本轮装配结束后诊断；插件卸载取消尚未执行的任务。
  */
 declare function scheduleWebSurfaceRepair(ctx: Context, warn: (message: string) => void): void;
 //#endregion
@@ -635,96 +611,29 @@ type SkillsImportResult = {
 /** 浏览器上传：base64 文件列表；单技能包（无顶层目录）按 frontmatter.name 归类。 */
 declare function importSkillsPackage(root: string, files: SkillsImportFile[], overwrite?: readonly string[]): SkillsImportResult;
 //#endregion
-//#region src/runtime/configs-validate.d.ts
-interface PromptConfigValidationError {
-  /** 数组下标；结构层整组错误为 -1。 */
-  index: number;
-  /** 该条配置的 id（缺失或非字符串时为空串）。 */
+//#region src/host/module-tool-target.d.ts
+interface ModuleToolTarget {
   id: string;
-  /** 引擎或结构层错误消息（保留 configs[i] 前缀）。 */
-  message: string;
+  root: string;
+  dir: string;
 }
-interface PromptConfigValidationResult {
-  valid: boolean;
-  errors: PromptConfigValidationError[];
-  /** valid=true 时回显归一化前的输入数组（调用方预览用）。 */
-  configs?: PromptConfigSpec[];
-  /** valid=true 时逐条渲染的 yml 模块预览（与生成目录同构）。 */
-  files?: PromptConfigFile[];
+interface ModuleToolHost {
+  target: (exec: ToolExecution) => ModuleToolTarget;
+  rebuild: (id: string) => Promise<void>;
 }
-/**
- * 逐条调用引擎权威校验并渲染预览文件。
- * 逐条（而非整组一次）校验保证一条坏配置不吞掉其余错误，且 index 可直接映射。
- */
-declare function validatePromptConfigs(value: unknown, options?: {
-  strategyDir?: string;
-  presetDir?: string;
-}): Promise<PromptConfigValidationResult>;
 //#endregion
 //#region src/runtime/character-tools.d.ts
-/** 工具执行所需的运行时宿主能力（index.ts 闭包提供）。 */
-interface CharacterToolHost {
-  /** 预设根目录（presetDir）。 */
-  presetRoot: () => string;
-  /** 当前激活预设模板名。 */
-  templateName: () => string;
-  /** 应用/移除后重建生成目录（写 preset.yml 后使参数生效）。 */
-  rebuild: () => void;
-}
-/** 注册角色卡库模型工具；返回 disposer，随 character-tools 预设模块生命周期清理。 */
-declare function registerCharacterTools(ctx: Context, host: CharacterToolHost): () => void;
+declare function registerCharacterTools(ctx: Context, host: ModuleToolHost): () => void;
 //#endregion
 //#region src/runtime/world-book-tools.d.ts
-interface WorldBookToolHost {
-  /** 当前激活预设目录（preset.yml 所在目录）。 */
-  activeDir: () => string;
-  /** 预设根目录（角色卡库 .characters/<id> 所在根）。 */
-  presetRoot: () => string;
-  /** 写盘后重建生成目录。 */
-  rebuild: () => void;
-}
-/** 注册世界书条目级模型工具；返回 disposer，随 world-book-tools 预设模块生命周期清理。 */
-declare function registerWorldBookTools(ctx: Context, host: WorldBookToolHost): () => void;
+/** 注册世界书条目级模型工具；返回 disposer，随 world-book-tools 模块生命周期清理。 */
+declare function registerWorldBookTools(ctx: Context, host: ModuleToolHost): () => void;
 //#endregion
 //#region src/host/characters.d.ts
-/** meta 下记录「每张卡引入了哪些模块」的键；来源保留到模块不再被消费并完成回退。 */
-declare const CHARACTER_MODULES_KEY = "characterModules";
-/** 读取 preset.yml `meta.modules` 之外的模块来源记录；非法形状一律视为无记录（老卡与手改文件不报错）。 */
-declare function recordedCharacterModules(meta: unknown): Record<string, string[]>;
-/** 卡自身声明的模块（声明优先：ST 转换产物自带六件套声明，行为因此不变）。
- *  只丢弃非字符串与空串；模块名合法性仍由 appendPresetModules 校验（非法名 fail loud）。 */
-declare function declaredCharacterModules(spec: PresetSpec): string[];
-/** 必需模块：`prompt-config-engine` 缺失会让 promptConfigs 静默失效，因此始终补齐；
- *  卡内含 world-book 策略配置时另需 `world-book-tools`（与旧实现同判据）。 */
-declare function requiredCharacterModules(configs: readonly unknown[]): string[];
-/** 移除一张卡之后，某个模块是否仍被预设内容或其他卡需要（需要则不回退）。 */
-interface CharacterModuleContext {
-  /** 移除本卡前缀配置之后的提示词配置。 */
-  configs: readonly Record<string, unknown>[];
-  /** 移除本卡声明的 params 键之后的预设参数。 */
-  params: Record<string, unknown>;
-  /** 预设顶层是否仍有自定义工具。 */
-  customTools: boolean;
-  /** 移除本卡之后仍标记为已导入的角色卡 id。 */
-  importedCharacters: readonly string[];
-}
-/** 模块的消费者判据。未知模块保守保留：宁可留一个无消费者的模块，也不误删用户或引擎要用的装配。 */
-declare function characterModuleStillNeeded(module: string, context: CharacterModuleContext): boolean;
-/** 角色卡记忆变更后同步已导入预设的 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;
+/** 模块记忆与条目同归当前模块；来源和 id 前缀不改变位置。 */
+declare function appendModuleMemory(moduleDir: string, note: string): void;
+/** 每次显式读取最新字节；缺失为空，链接与读取失败原样报错。 */
+declare function readModuleMemory(moduleDir: string): string;
 type CharacterImportOptions = StConversionOptions & ImportChoices;
 type CharacterImportResult = {
   ok: true;
@@ -735,30 +644,11 @@ type CharacterImportResult = {
   ok: false;
   message: string;
 };
-/** 角色卡入库：PNG 原图（可选）+ 角色卡 JSON → 转换参数存 converted.yml。 */
-declare function importCharacterCard(presetRoot: string, files: AssetFile[], options?: CharacterImportOptions): CharacterImportResult;
-/** 原始文件流导入：识别 PNG 魔数后在 host 侧提取角色卡，避免客户端 base64 膨胀 JSON。 */
-declare function importCharacterCardFile(presetRoot: string, filePath: string, fileName?: string, options?: CharacterImportOptions): CharacterImportResult;
-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): {
+/** 复用普通模块候选校验、版本保护和目录交换，不生成角色专属存储。 */
+declare function importCharacterCard(root: string, files: AssetFile[], options?: CharacterImportOptions): Promise<CharacterImportResult>;
+declare function importCharacterCardFile(root: string, filePath: string, fileName?: string, options?: CharacterImportOptions): Promise<CharacterImportResult>;
+/** 通用并入保留既有带前缀往返行为，不复制本地记忆。 */
+declare function mergeModuleIntoModule(root: string, targetId: string, sourceId: string): {
   ok: true;
   count: number;
   personaOpened?: boolean;
@@ -766,9 +656,8 @@ declare function applyCharacterToPreset(presetRoot: string, templateName: string
   ok: false;
   message: string;
 };
-/** 从当前预设移除角色卡参数：删前缀 promptConfigs、删该卡声明的 params 键、
- *  meta.importedCharacters 除名。 */
-declare function removeCharacterFromPreset(presetRoot: string, templateName: string, cardId: string): {
+/** 撤销并入内容；旧 chara 前缀可撤销，能力归属只写一份登记。 */
+declare function removeMergedModule(root: string, targetId: string, sourceId: string): {
   ok: true;
   count: number;
 } | {
@@ -783,7 +672,7 @@ interface PromptConfigTemplate {
   /** 模板原文（编辑器源码模式可直接展示）。 */
   content: string;
   /** 解析后的单条提示词配置。 */
-  spec: PromptConfigSpec;
+  spec: RuleDefinition;
 }
 /** 自定义工具模板（templates/tools/*.yml；tool-config-engine 定义形态）。 */
 interface ToolTemplate {
@@ -802,15 +691,15 @@ type TuiSource = PromptSettings & {
   skillCatalog: SkillCatalogEntry[];
   activeSkillsDirs: string[];
 };
-/** 参数保存回调：写激活预设 preset.yml；失败必须抛给命令层渲染为错误。 */
-type SavePresetParam = (key: string, value: unknown) => void | Promise<void>;
+/** 参数保存回调：写激活模块 module.yml；失败必须抛给命令层渲染为错误。 */
+type SaveModuleParam = (key: string, value: unknown) => void | Promise<void>;
 /** 技能启停回调：切换受管实体的根链接。 */
 type ToggleSkillState = (folder: string, enabled: boolean) => {
   ok: boolean;
   message?: string;
 };
 /** 通过 DSH 命令注册表暴露 /prompt-tool，Web 与 dsh-tui 都能执行。 */
-declare function registerTuiCommand(ctx: Context, ns: 'prompt-tool', getSource: () => TuiSource, getModelsState: () => ModelDetection, getModelCatalog: () => Promise<Record<string, string[]>>, getPresetConfigsDir?: () => string, savePresetParam?: SavePresetParam, toggleSkillState?: ToggleSkillState): void;
+declare function registerTuiCommand(ctx: Context, ns: 'prompt-tool', getSource: () => TuiSource, getModelsState: () => ModelDetection, getModelCatalog: () => Promise<Record<string, string[]>>, getModuleDirectory?: () => string, saveModuleParam?: SaveModuleParam, toggleSkillState?: ToggleSkillState, refreshModule?: (id: string) => Promise<void>): void;
 //#endregion
 //#region src/host/skills-refresh.d.ts
 interface SkillsReloaderDeps {
@@ -873,6 +762,16 @@ declare function scanRoot(root: ScanRoot): ScannedSkill[];
 declare function scanRoots(roots: readonly ScanRoot[]): ScannedSkill[];
 declare function catalogFromScan(skills: readonly ScannedSkill[]): SkillCatalogEntry[];
 //#endregion
+//#region src/host/module-install.d.ts
+declare function assertModuleId(id: unknown): asserts id is string;
+/** ENOENT 才表示不存在；权限、占用与读取失败继续传播。 */
+declare function modulePathExists(path: string): boolean;
+declare function canonicalModulesRoot(root: string, allowMissing?: boolean): string;
+/** 根与目标先解析真实路径，拒绝链接目录及定义身份不一致。 */
+declare function assertModuleDirectory(root: string, id: string, allowMissing?: boolean): string;
+/** 复制和物化只接受自有普通文件；不跟随任意层级链接读取根外数据。 */
+declare function assertModuleTree(dir: string): void;
+//#endregion
 //#region src/runtime/skills-parse.d.ts
 interface SkillFrontmatter {
   name?: string;
@@ -891,12 +790,17 @@ declare function parseFrontmatter(text: string): {
 };
 //#endregion
 //#region src/shared/preset-ids.d.ts
-/** 包内模板、用户副本与当前预设共用同名 ID；避免与宿主官方预设重名。 */
-declare const DEFAULT_PRESET_ID = "pt-standard";
+/**
+ * 包内模块与用户副本共用同名 ID；避免与宿主官方预设重名。
+ *
+ * 内置模块随包分发在仓库根的 `modules/`。旧的内置预设 `pt-*` 已整体退场——它们是官方
+ * 预设形态的遗留，重构后不再读取也不再维护；这里指向当前随包分发的内置模块作为兜底。
+ */
+declare const DEFAULT_MODULE_ID = "ponytail";
 //#endregion
 //#region src/index.d.ts
 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 BridgeRequestMap, type BridgeValueMap, CHARACTER_MODULES_KEY, type CharacterModuleContext, Config, DEFAULT_PRESET_ID, ENGINE_CAPABILITIES, ENGINE_PARAM_KEYS, ENGINE_RECIPES, type EngineCapability, type EngineCapabilityCreateRequest, type EngineCapabilityCreateResult, type EngineCapabilityRemoveResult, INSTRUCTION_FILE_STATUSES, type InstructionContextView, type InstructionFileSnapshot, type InstructionFileStatus, MAX_BRIDGE_BODY_BYTES, MAX_CHARACTER_CARD_STREAM_BYTES, MAX_INSTRUCTION_FILE_BYTES, type ModuleSourceMode, PARAM_KEYS, PRE_STEP_COORDINATOR_SERVICE, PRE_STEP_COORDINATOR_VERSION, type PluginSubagentSeam, type PreStepCoordinatorOptions, type PreStepCoordinatorService, type PreStepFileContribution, type PreStepPromptConfig, type PreStepSource, type PresetModuleFacts, type PresetSpec, type PromptConfigTemplate, type PromptConfigValidationError, type PromptConfigValidationResult, PromptSettingsSchema, SETTINGS_BRIDGE_PREFIX, SKILL_NAME_PATTERN, type SkillCatalogEntry, type SkillFrontmatter, type SkillPolicyChange, type SkillPolicyRead, type SkillPolicyScope, type SkillPolicyWrite, type SkillsCatalogSnapshot, type SkillsRuntime, type SkillsState, type ToolTemplate, USER_SKILLS_DIR, WRITER_PARAM_KEYS, type WritePresetOptions, agentsFileCardSpecs, agentsFileId, appendCharacterMemory, appendMemoryFile, apply, applyCharacterToPreset, applyModuleConfigs, assertSafeConfigId, buildModuleConfigsFromParams, buildWorldBookEntry, catalogFromScan, characterModuleStillNeeded, cloneBuiltinPreset, configFileName, convertStToPreset, createEngineCapabilityInPreset, createSkillsReloader, createSkillsRuntime, declaredCharacterModules, deleteCharacterCard, deleteWorldBookEntry, detectAgentsFileSnapshots, detectAgentsFiles, detectModels, engineCapability, engineRecipe, ensurePresetSeed, ensureWebSurface, expandPresetSource, exportPresetPackage, importCharacterCard, importCharacterCardFile, importSkillsPackage, inject, installPreStepCoordinator, installPresetPackage, invalidateModelCatalog, invocationForScope, isEngineCapabilityPresent, listAdvertisedModels, listBuiltinTemplates, listCharacterCards, listPresets, listWorldBookEntries, loadPresetSpec, loadPromptTemplates, loadToolTemplates, mergeInstructionCards, mergeStPresets, name, parseFrontmatter, peekModelCatalog, presetImportPreview, processStText, readAgentsFileSnapshot, readCharacterMemory, readSkillInvocation, readSkillsState, recordedCharacterModules, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeCharacterFromPreset, removeEngineCapabilityFromPreset, removePresetModule, removeUserPreset, renderComposition, requiredCharacterModules, resolvePresetDir, resolvePresetModuleFacts, resolvePresetParams, resolveProfileDir, resolveProjectRoot, resolveSubagentStartOptions, savePresetParams, savePresetPersona, scanRoot, scanRoots, scheduleWebSurfaceRepair, scopeOfInvocation, setSkillInvocation, skillRoots, skillsStatePath, stPresetId, syncImportedCharacterMemory, upsertWorldBookEntry, userPresetsDir, validateCustomToolIdentities, validateEngineParamValues, validatePromptConfigs, writeAgentsFile, writeAgentsFileChecked, writePreset, writeSkillsState };
+export { BRIDGE_ENDPOINTS, type BridgeEndpoint, type BridgeErrorPayload, type BridgeRequestMap, type BridgeValueMap, Config, DEFAULT_MODULE_ID, MODULE_CAPABILITIES as ENGINE_CAPABILITIES, MODULE_CAPABILITIES, ENGINE_PARAM_KEYS, ENGINE_RECIPES, type ModuleCapability as EngineCapability, type ModuleCapability, type ModuleCapabilityCreateRequest as EngineCapabilityCreateRequest, type ModuleCapabilityCreateRequest, type ModuleCapabilityCreateResult as EngineCapabilityCreateResult, type ModuleCapabilityCreateResult, type ModuleCapabilityRemoveResult as EngineCapabilityRemoveResult, type ModuleCapabilityRemoveResult, INJECTION_POINT_ORDER, INSTRUCTION_FILE_STATUSES, type InjectionPoint, type InstructionContextView, type InstructionFileSnapshot, type InstructionFileStatus, MAX_BRIDGE_BODY_BYTES, MAX_CHARACTER_CARD_STREAM_BYTES, MAX_INSTRUCTION_FILE_BYTES, type ModuleExportRequest, type ModuleExportResult, type ModuleFacts, ModuleLayerSettingsError, type ModuleSourceMode, type ModuleSpec, type ModuleSummary, type ModuleWriterParams, PARAM_KEYS, PRE_STEP_COORDINATOR_SERVICE, PRE_STEP_COORDINATOR_VERSION, type PluginSubagentSeam, type PreStepCoordinatorOptions, type PreStepCoordinatorService, type PreStepPromptConfig, type PreStepSource, type PromptConfigTemplate, SETTINGS_BRIDGE_PREFIX, SKILL_NAME_PATTERN, type SkillCatalogEntry, type SkillFrontmatter, type SkillPolicyChange, type SkillPolicyRead, type SkillPolicyScope, type SkillPolicyWrite, type SkillsCatalogSnapshot, type SkillsRuntime, type SkillsState, type ToolTemplate, USER_SKILLS_DIR, WRITER_PARAM_KEYS, type WriteModuleOptions, type WritePresetOptions, agentsFileCardSpecs, agentsFileId, appendModuleCapabilities, appendModuleMemory, apply, applyModuleConfigs, assertModuleDirectory, assertModuleId, assertModuleTree, assertSafeConfigId, buildModuleConfigsFromParams, buildWorldBookEntry, canonicalModulesRoot, catalogFromScan, cloneBuiltinModule, cloneBuiltinModule as cloneBuiltinPreset, configFileName, convertStToModule, convertStToModule as convertStToPreset, convertStToModuleWithReport, createModuleCapability as createEngineCapabilityInPreset, createModuleCapability, createSkillsReloader, createSkillsRuntime, deleteWorldBookEntry, detectAgentsFileSnapshots, detectAgentsFiles, detectModels, moduleCapability as engineCapability, moduleCapability, engineRecipe, ensureModuleReady, ensureModuleSeed, ensureModuleSeed as ensurePresetSeed, ensureWebSurface, expandModuleSource, expandModuleSource as expandPresetSource, exportModulePackage, exportModulePackage as exportPresetPackage, importCharacterCard, importCharacterCardFile, importSkillsPackage, inject, installModulePackage, installModulePackage as installPresetPackage, installPreStepCoordinator, invalidateModelCatalog, invocationForScope, isModuleCapabilityPresent as isEngineCapabilityPresent, isModuleCapabilityPresent, listAdvertisedModels, listBuiltinTemplates, listModules, listWorldBookEntries, loadModuleSpec, loadPromptTemplates, loadToolTemplates, mergeInstructionCards, mergeModuleIntoModule, mergeStModules, mergeStModules as mergeStPresets, mergeStModulesWithReport, moduleDirExists, moduleImportPreview, moduleImportPreview as presetImportPreview, modulePathExists, name, parseFrontmatter, peekModelCatalog, processStText, readAgentsFileSnapshot, readModuleLayerSettings, readModuleMemory, readSkillInvocation, readSkillsState, registerCharacterTools, registerSettingsBridge, registerTuiCommand, registerWorldBookTools, removeModuleCapability as removeEngineCapabilityFromPreset, removeModuleCapability, removeMergedModule, removeModuleCapabilityDeclaration, removeModuleCapabilityDeclaration as removePresetModule, removeUserModule, removeUserModule as removeUserPreset, renderComposition, resolveModuleDir, resolveModuleFacts, resolveModuleParams, resolveModuleParams as resolvePresetParams, resolveProfileDir, resolveProjectRoot, resolveSubagentStartOptions, saveModuleParams, saveModulePersona, saveModulePersona as savePresetPersona, scanRoot, scanRoots, scheduleWebSurfaceRepair, scopeOfInvocation, setSkillInvocation, skillRoots, skillsStatePath, stModuleId, stModuleId as stPresetId, upsertWorldBookEntry, userModulesDir, validateCustomToolIdentities, validateEngineParamValues, withModuleDefinition, writeAgentsFile, writeAgentsFileChecked, writeModule, writePreset, writeSkillsState };