dsh-plugin-prompt-tool 2.0.1 → 3.0.0

package/lib/index.d.mts

@@ -1,670 +1,50 @@
-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; };
+//#region src/shared/engine-capabilities.d.ts
+/** 官方九个注入层：与 engine/schema.mjs 的 LAYER_ORDER 同源，改一处必须同步另一处。 */
+type InjectionPoint = 'pre-step' | 'system-section' | 'runtime-context' | 'agent-request' | 'llm-stream' | 'tool-pipeline' | 'turn-stop' | 'subagent-start' | 'subagent-end';
 //#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;
+//#region src/shared/rules.d.ts
+/** 一张独立配置卡的判断树；原语与组合的合法形状由引擎唯一校验。 */
+type RuleCondition = Record<string, unknown>;
+/** 动作拥有稳定身份；其执行点由动作目录推导，不能任意指定宿主事件。 */
+interface RuleAction extends Record<string, unknown> {
+  id: string;
+  kind: string;
+  channelOrder?: number;
+  waterfallPosition?: 'default' | 'outermost';
 }
-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` 各枚举字段的**运行期值清单**。
- *
- * 类型由它派生（`(typeof X)[number]`），守卫测试也读它——于是「类型允许的值」与
- * 「守卫断言的值」是同一份，不可能各自漂移；而这两个值集合都必须与 `engine/schema.mjs`
- * 的对应 `KNOWN_*` 一致（守卫见 `test/shared/prompt-config-spec-enums.test.mjs`）。
+ * module.yml.rules 的单一规则定义；层是动作未声明 `config.layer` 时的缺省注入层，其余用于展示，不建立跨层执行顺序。
  *
- * 为什么不直接从引擎派生类型：引擎是仓库根的纯 `.mjs`（无 `.d.mts`，`src/` 侧靠
- * `@ts-expect-error` 引入），其 `KNOWN_*` 在 TS 看来是 `any`，派生不出字面量联合。
+ * **旧名 `when`/`do` 已随引擎重构退役**（不再作为兼容输入），全链路只有 `if`/`then`/`else`。
+ * 定义迁移由 YAML Document API 改键名完成，注释与未知字段原地保留。
  */
-declare const PROMPT_CONFIG_SPEC_ENUMS: {
-  readonly configKind: readonly ["ordered", "anchor"];
-  readonly role: readonly ["user"];
-  readonly position: readonly ["after-user", "before-all", "after-all"];
-  readonly dedupe: readonly ["session", "batch", "none"];
-  readonly promotion: readonly ["none", "main", "include-subagents"];
-  readonly audience: readonly ["main", "subagent"];
-  readonly subject: readonly ["toolArgs", "toolResult", "userMessage", "assistantText", "subagentInfo"];
-  readonly modelScope: readonly ["all", "pro", "flash"];
-  readonly mergeMode: readonly ["separate", "merged"];
-};
-/** 取上面某一条枚举的值联合。 */
-type SpecEnum<K extends keyof typeof PROMPT_CONFIG_SPEC_ENUMS> = (typeof PROMPT_CONFIG_SPEC_ENUMS[K])[number];
-interface PromptConfigSpec {
+interface RuleDefinition {
   id: string;
   name?: string;
   enabled?: boolean;
-  strategy?: string;
-  layer?: string;
-  configKind?: SpecEnum<'configKind'>;
-  order?: number;
-  role?: SpecEnum<'role'>;
+  layer?: InjectionPoint;
   group?: string;
   exclusive?: boolean;
-  position?: SpecEnum<'position'>;
-  dedupe?: SpecEnum<'dedupe'>;
-  promotion?: SpecEnum<'promotion'>;
-  /** 消息受众：缺省（省略/null）= 公用（主会话+子代理）；main=仅主会话；subagent=仅子代理。 */
-  audience?: SpecEnum<'audience'> | null;
-  /** 条件判定的匹配对象；缺省由层决定（engine/schema.mjs 的 LAYER_DEFAULT_SUBJECT）。 */
-  subject?: SpecEnum<'subject'>;
-  /** 条件判定的键集合；省略 = 无条件（旧行为）。 */
-  match?: PromptConfigMatch;
-  modelScope?: SpecEnum<'modelScope'>;
-  sourceKind?: string;
-  form?: string;
-  summary?: string;
-  identity?: {
-    field: 'plugin';
-    value: string;
-  };
-  text?: string;
-  /** 单条提示词配置的多段文本：注入为一条消息的多个 text 内容块。 */
-  texts?: string[];
-  /** 同位置多条提示词配置的插入方式：separate=先后插入独立消息（默认）；merged=拼接为一条消息。 */
-  mergeMode?: SpecEnum<'mergeMode'>;
-  templateFile?: string;
-  fill?: string;
-  variables?: Record<string, string>;
-  params?: Record<string, unknown>;
-}
-/**
- * 提示词配置 / 自定义工具 ID 的安全文件名段校验：ID 直接拼进生成文件名
- * （prompt-configs/<n>-<id>.yml / custom-tools/<n>-<id>.yml），含路径分隔符
- * 或 Windows 非法字符会越出生成目录或写盘失败，保存/物化前 fail loud 拒绝。
- * 允许 [a-zA-Z0-9._-] 与常见中文/多字节字符（ST 导入 id 含中文），
- * 仅拒绝分隔符、控制字符、点目录与 Windows 保留字符。
- */
-declare function assertSafeConfigId(id: string): void;
-/** 生成文件名统一 4 位零填充前缀（0000-…），超过 10 条后字典序仍稳定。 */
-declare function configFileName(index: number, id: string): string;
-/**
- * 条件判定的键集合：与 `engine/anchor-match.mjs` 的匹配语义同构。
- * 键按字面文本匹配（正则元字符会被转义）；要写正则须用 `/pattern/flags` 形态或 `useRegex: true`。
- */
-interface PromptConfigMatch {
-  keys?: string[];
-  secondaryKeys?: string[];
-  logic?: 'any' | 'all' | 'not' | 'notAny';
-  caseSensitive?: boolean;
-  wholeWords?: boolean;
-  useRegex?: boolean;
-}
-//#endregion
-//#region src/host/write-preset.d.ts
-interface WriteModuleOptions {
-  modulesRoot: string;
-  moduleId: string;
-  targetModuleId?: string;
-  sourceDir?: string;
-  /** 返回独立暂存根下的合法模块目录；安装方负责交换与清理暂存根。 */
-  stageOnly?: boolean;
-  agentsInstructionText?: string;
-  warn?: (message: string) => void;
-}
-/** 旧入口只做名称适配；行为规则和参数必须已写入完整定义。 */
-interface WritePresetOptions extends ModuleWriterParams {
-  moduleDir: string;
-  presetTemplate?: string;
-  outputId?: string;
-  sourceDir?: string;
-  materializeOnly?: boolean;
-  agentsInstructionText?: string;
-  presetOrder?: number;
-  promptConfigs?: PromptConfigSpec[];
-  warn?: (message: string) => void;
-}
-/** 按模块身份原地恢复切片；用户资产、正文与完整定义均不重写。 */
-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
-/** 文件身份（fileId + 路径 + 展示路径）：生成卡与读取快照共用的最小形状。 */
-interface AgentsFileIdentity {
-  /** 稳定文件 id（规范化真实路径哈希；bridge 写白名单与卡 id 共用）。 */
-  fileId: string;
-  /** 探测到的路径（普通文件；符号链接在 realPath 解析）。 */
-  path: string;
-  displayPath: string;
-  scope: 'global' | 'project';
-}
-interface AgentsFileCard extends AgentsFileIdentity {
-  /** 解析后的真实路径：同一实际文件去重与身份校验用。 */
-  realPath: string;
-}
-declare function agentsFileId(path: string): string;
-/**
- * 探测当前可见的 AGENTS 指令文件：用户级 `$DSH_HOME/AGENTS.md` + cwd→项目根链的全部候选。
- * 只返回已存在的文件——探测不到就不生成卡。
- */
-declare function detectAgentsFiles(options?: {
-  cwd?: string;
-  home?: string;
-  projects?: boolean;
-}): AgentsFileCard[];
-/**
- * 探测结果 → pre-step 提示卡（每个文件一张，不落 preset.yml）。
- * 插入点对齐官方 `@deepseek-ai/dsh-agent-instructions`：pre-step 层、紧随真实用户消息；
- * 注入内容 = 该文件当前正文（`fill=instruction-file` 运行时读取，params.file 精确到单个文件）。
- */
-declare function agentsFileCardSpecs(files?: readonly AgentsFileIdentity[]): PromptConfigSpec[];
-/**
- * 单次读取形成一致快照：正文、revision、身份、读取状态来自同一次读取。
- * 只支持可正确解码的 UTF-8；有 BOM 的文件保留 BOM 字符，不让无关保存悄悄改写字节。
- */
-declare function readAgentsFileSnapshot(file: AgentsFileCard): InstructionFileSnapshot;
-/** 探测 + 读取：同一套探测规则下每个文件一份快照。 */
-declare function detectAgentsFileSnapshots(options?: {
-  cwd?: string;
-  home?: string;
-  projects?: boolean;
-}): InstructionFileSnapshot[];
-type AgentsFileWriteOutcome = {
-  ok: true;
-  fileId: string;
-  revision: string;
-} | {
-  ok: false;
-  status: 400 | 404 | 409 | 413;
-  code: string;
-  message: string;
-};
-/** 原子写指令文件（tmp + rename）；调用方必须先用 detectAgentsFiles() 校验路径白名单。 */
-declare function writeAgentsFile(path: string, content: string): void;
-/**
- * 带版本校验的单文件写：
- * 1. 写前在同一段内重读文件，expectedRevision 不一致 = 409（不做「猜到用户意图」的重试）；
- * 2. 目标消失 = 404，不自动重建用户文件；
- * 3. 正文超限 = 413，不截断保存；
- * 4. 替换前复查目标身份（真实路径未变），失败保留原文件并清理临时文件。
- */
-declare function writeAgentsFileChecked(options: {
-  file: AgentsFileCard;
-  content: string;
-  expectedRevision: string | null;
-}): Promise<AgentsFileWriteOutcome>;
-//#endregion
-//#region src/runtime/pre-step-coordinator.d.ts
-declare const PRE_STEP_COORDINATOR_SERVICE = "promptToolPreStep";
-declare const PRE_STEP_COORDINATOR_VERSION = 1;
-interface PreStepPromptConfig {
-  id: string;
-  layer: string;
-  enabled?: boolean;
-  order: number;
-  sequence?: number;
-  sourceModuleId?: string;
-  position: string;
-  promotion: string;
-  audience: string | null;
-  modelScope: string;
-  role: string;
-  dedupe: string;
-  mergeMode: string;
-  sourceKind: string;
-  form?: string;
-  texts: string[];
-  params: Record<string, unknown>;
-  variables: Record<string, unknown>;
-  identity: {
-    field: 'plugin';
-    value: string;
-  };
-  resolve: (input: Record<string, unknown>) => unknown;
-}
-interface PreStepSource {
-  configs: readonly PreStepPromptConfig[];
-  /** 已编译的本地点规则动作；执行与配置叶子共享同一批次资格帧。 */
-  ruleActions?: readonly unknown[];
-  officialInstructions?: boolean;
-}
-interface PreStepCoordinatorOptions {
-  policyFile?: string;
-  home?: string;
-}
-interface PreStepCoordinatorService {
-  readonly version: number;
-  registerPreset(sourceCtx: Context, sourceId: string, source: PreStepSource): () => void;
-  officialOwnerOf(sessionId: string): boolean | undefined;
-  /** hint 转换前也调用同一过滤器，保证监听器重挂顺序不让已关闭正文变成 hint。 */
-  filterInstructions(agent: unknown, messages: unknown[]): unknown[];
-}
-declare function installPreStepCoordinator(ctx: Context, options?: PreStepCoordinatorOptions): PreStepCoordinatorService;
-//#endregion
-//#region src/runtime/models.d.ts
-/**
- * 官方子代理 seam 的类型锚点：本插件只读 `list()` / `getProvider()` 并显式传参，
- * 不替换 {@link SubagentRuntime.start} 或 `startContinuable`；这里保留类型引用是为了
- * 让「不碰 registry 方法」这条边界在类型层随 rc.2 契约一起编译校验。
- */
-type PluginSubagentSeam = Pick<SubagentRuntime, 'list' | 'getProvider'>;
-/** 模型服务商检测结果（含诊断信息，供 Web/TUI 展示）。 */
-interface ModelDetection {
-  /** 是否检测到任何已注册/可配置的服务商路由。 */
-  available: boolean;
-  /** 已检测到（live 注册）的模型服务商 id——状态提示用。 */
-  providers: string[];
-  error?: string;
-}
-/** 检测模型服务商：只统计 live 注册路由（状态提示与下拉共用同一来源）。 */
-declare function detectModels(ctx: Context): ModelDetection;
-/**
- * 目录失效：provider 注册/移除（官方 `llm/adapters-updated`）、服务重挂或显式刷新时
- * 调用。代次前进让已在飞的旧查询回来后不再写缓存（M-11：变更必须让相关缓存失效）。
- * 只清目录，不碰 provider 单点失败的既有语义。
- */
-declare function invalidateModelCatalog(ctx: Context): void;
-/** 同步读模型目录缓存（命中返回，未命中/过期返回空）：/describe 不触发查询。 */
-declare function peekModelCatalog(ctx: Context): Record<string, string[]>;
-/**
- * 查询各已注册服务商公布的模型 id（对齐官方 web 选择器 buildModelCatalog：只遍历
- * listProviders() live 路由，单点失败/超时不拖垮整体；仅作展示，不构成路由白名单）。
- * 并行查询 + 10min 缓存 + 单点超时；同 Context 的并发刷新合并为一次查询，
- * 失败只影响该次刷新（不写空缓存），旧代次结果不回写新数据。
- */
-declare function listAdvertisedModels(ctx: Context): Promise<Record<string, string[]>>;
-/**
- * 本插件子代理入口的显式模型路由（subagentModelProvider + subagentModelName 同时非空时生效）。
- *
- * 只产出要传给 {@link SubagentRuntime.start} 的 `agentOptions`，由调用方显式传入；
- * 不修改 registry 上的 `start` / `startContinuable` 方法，也不在根 scope 强加默认值——
- * 官方 API 的替换会让第三方直派调用也带上本插件的模型，超出插件授权范围。
- */
-declare function resolveSubagentStartOptions(isEnabled: () => boolean, provider: () => string, model: () => string, getReasoningEffort?: () => string): AgentOptions | undefined;
-//#endregion
-//#region src/host/skills-actions.d.ts
-type SkillActionResult = {
-  ok: true;
-  id: string;
-  path: string;
-} | {
-  ok: false;
-  message: string;
-};
-//#endregion
-//#region src/host/skills-policy.d.ts
-type SkillPolicyRead = {
-  ok: true;
-  invocation: SkillInvocation;
-  frontmatter?: string;
-  body?: string;
-} | {
-  ok: false;
-  message: string;
-};
-type SkillPolicyWrite = {
-  ok: true;
-  changed: boolean;
-  invocation: SkillInvocation;
-} | {
-  ok: false;
-  message: string;
-};
-/** 读取技能文件当前的调用策略（缺省即可调用）。 */
-declare function readSkillInvocation(file: string): SkillPolicyRead;
-/** 把技能文件的调用策略写到目标范围；返回是否发生写入。 */
-declare function setSkillInvocation(file: string, change: SkillPolicyChange | SkillPolicyScope): SkillPolicyWrite;
-//#endregion
-//#region src/host/skills-content.d.ts
-type SkillContentResult = ({
-  ok: true;
-  changed?: boolean;
-} & SkillContentSnapshot) | {
-  ok: false;
-  message: string;
-};
-//#endregion
-//#region src/host/skills-config.d.ts
-/** 与官方 `SKILL_NAME` 同规则；技能目录名、引用校验与调用策略写入共用。 */
-declare const SKILL_NAME_PATTERN: RegExp;
-type SkillsStateRead = {
-  ok: true;
-  state: SkillsState;
-  exists: boolean;
-} | {
-  ok: false;
-  state: SkillsState;
-  message: string;
-};
-declare function skillsStatePath(dshHome?: string): string;
-declare function readSkillsState(file?: string): SkillsStateRead;
-/** 写状态：Document API 保留注释与未知字段；内容无变化时不落盘；提交前核对本次读取的原文，失败清理暂存文件。 */
-declare function writeSkillsState(patch: Partial<Pick<SkillsState, 'folders'>>, file?: string): SkillsStateRead;
-//#endregion
-//#region src/runtime/settings-bridge.d.ts
-interface SkillsBridgeState {
-  /** 用户技能根（技能实体的落点）。 */
-  skillsRoot: string;
-  /** 用户添加的技能文件夹（只引用，不复制）。 */
-  folders: string[];
-  /** 技能清单：按会话工作区扫描官方六类技能根，调用策略取自各技能文件的 frontmatter。 */
-  listSkills: (cwd?: string) => SkillCatalogEntry[];
-  snapshot?: (options: SkillViewOptions) => Promise<SkillsCatalogSnapshot>;
-  /** 单端写入只提交本端意图；路径必须命中当前来源白名单。 */
-  setSkillPolicy: (name: string, path: string, change: SkillPolicyChange, cwd?: string) => SkillPolicyWrite;
-  readSkillContent: (name: string, path: string, cwd?: string) => SkillContentResult;
-  writeSkillContent: (name: string, path: string, content: string, description: string, expectedRevision: string, cwd?: string) => SkillContentResult;
-  deleteSkill: (name: string, path: string, cwd?: string) => SkillActionResult;
-  /** 添加 / 移除引用的技能文件夹。 */
-  patchSkillFolders: (folders: string[]) => SkillsStateRead | Promise<SkillsStateRead>;
-}
-/**
- * 两类卡合并：模块卡原样保留，文件卡换成本次工作区的文件快照。
- * 生成目录里属于其他工作区的文件卡不再展示（写盘白名单也不含它们）；
- * 当前工作区里没有对应生成卡的文件按默认文件卡补齐。
- */
-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,
-/**
- * 生成目录（模块目录）：读取/写入哪一份提示词配置。
- *
- * 参数是**请求声明的编辑目标**（`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 工具）。 */
-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(moduleDir: string): WorldBookEntry[];
-/** 新增或更新一条世界书条目（按 id 定位；不存在则追加）。返回写入后条目总数。 */
-declare function upsertWorldBookEntry(moduleDir: string, entry: WorldBookEntry): 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;
-/** 只读诊断；安装与 profile 变更交给官方 plugin_manager。 */
-declare function ensureWebSurface(ctx: Context, warn: (message: string) => void): void;
-/**
- * 延迟到本轮装配结束后诊断；插件卸载取消尚未执行的任务。
- */
-declare function scheduleWebSurfaceRepair(ctx: Context, warn: (message: string) => void): void;
-//#endregion
-//#region src/host/skills-import.d.ts
-interface SkillsImportFile {
-  path?: unknown;
-  content?: unknown;
-}
-type SkillsImportResult = {
-  ok: true;
-  path: string;
-  count: number;
-  overwritten: number;
-  warning?: string;
-} | {
-  ok: false;
-  message: string;
-  code?: 'skills-overwrite-required';
-  conflicts?: string[];
-};
-/** 浏览器上传：base64 文件列表；单技能包（无顶层目录）按 frontmatter.name 归类。 */
-declare function importSkillsPackage(root: string, files: SkillsImportFile[], overwrite?: readonly string[]): SkillsImportResult;
-//#endregion
-//#region src/host/module-tool-target.d.ts
-interface ModuleToolTarget {
-  id: string;
-  root: string;
-  dir: string;
-}
-interface ModuleToolHost {
-  target: (exec: ToolExecution) => ModuleToolTarget;
-  rebuild: (id: string) => Promise<void>;
+  /** 分支条件；缺省 = 无条件。 */
+  if?: RuleCondition;
+  /** 动作列表。 */
+  then: RuleAction[];
+  /** `if` 不命中时执行；与 `then` 结构互斥（编译期按 `not(if)` 展开）。 */
+  else?: RuleAction[];
 }
 //#endregion
-//#region src/runtime/character-tools.d.ts
-declare function registerCharacterTools(ctx: Context, host: ModuleToolHost): () => void;
-//#endregion
-//#region src/runtime/world-book-tools.d.ts
-/** 注册世界书条目级模型工具；返回 disposer，随 world-book-tools 模块生命周期清理。 */
-declare function registerWorldBookTools(ctx: Context, host: ModuleToolHost): () => void;
-//#endregion
-//#region src/host/characters.d.ts
-/** 模块记忆与条目同归当前模块；来源和 id 前缀不改变位置。 */
-declare function appendModuleMemory(moduleDir: string, note: string): void;
-/** 每次显式读取最新字节；缺失为空，链接与读取失败原样报错。 */
-declare function readModuleMemory(moduleDir: string): string;
-type CharacterImportOptions = StConversionOptions & ImportChoices;
-type CharacterImportResult = {
-  ok: true;
-  id: string;
-  name: string;
-  warning?: string;
-} | {
-  ok: false;
-  message: 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;
-} | {
-  ok: false;
-  message: string;
-};
-/** 撤销并入内容；旧 chara 前缀可撤销，能力归属只写一份登记。 */
-declare function removeMergedModule(root: string, targetId: string, sourceId: string): {
-  ok: true;
-  count: number;
-} | {
-  ok: false;
-  message: string;
-};
-//#endregion
 //#region src/host/templates.d.ts
 interface PromptConfigTemplate {
   /** 模板文件名（数字前缀决定展示顺序）。 */
@@ -674,133 +54,28 @@ interface PromptConfigTemplate {
   /** 解析后的单条提示词配置。 */
   spec: RuleDefinition;
 }
-/** 自定义工具模板（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
-type TuiSource = PromptSettings & {
-  skillCatalog: SkillCatalogEntry[];
-  activeSkillsDirs: string[];
-};
-/** 参数保存回调：写激活模块 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[]>>, getModuleDirectory?: () => string, saveModuleParam?: SaveModuleParam, toggleSkillState?: ToggleSkillState, refreshModule?: (id: string) => Promise<void>): void;
-//#endregion
-//#region src/host/skills-refresh.d.ts
-interface SkillsReloaderDeps {
-  stateFile: string;
-  currentSnapshot: () => string;
-  accept: (state: SkillsState, snapshot: string) => void;
-  warn: (message: string) => void;
-}
-declare function createSkillsReloader(deps: SkillsReloaderDeps): {
-  reload: () => void;
-};
-//#endregion
-//#region src/host/skills-runtime.d.ts
-interface SkillsRuntime {
-  readonly skillsRoot: string;
-  readonly folders: string[];
-  listSkills: (cwd?: string) => SkillCatalogEntry[];
-  snapshot: (options?: SkillViewOptions) => Promise<SkillsCatalogSnapshot>;
-  setPolicy: (name: string, path: string, change: SkillPolicyChange, cwd?: string) => SkillPolicyWrite;
-  readContent: (name: string, path: string, cwd?: string) => SkillContentResult;
-  writeContent: (name: string, path: string, content: string, description: string, expectedRevision: string, cwd?: string) => SkillContentResult;
-  deleteSkill: (name: string, path: string, cwd?: string) => SkillActionResult;
-  setFolders: (folders: string[]) => SkillsStateRead;
-  invalidate: () => void;
-}
-declare function createSkillsRuntime(ctx: Context, options?: {
-  dshHome?: string;
-}): SkillsRuntime;
-//#endregion
-//#region src/host/skills-scan.d.ts
-interface ScanRoot {
-  kind: SkillSourceKind;
-  path: string;
-}
-interface ScannedSkill {
-  id: string;
-  source: SkillSourceKind;
-  rank: number;
-  dir: string;
-  folder: string;
-  file: string;
-  name: string;
-  description: string;
-  whenToUse?: string;
-  metadata?: Record<string, unknown>;
-  body: string;
-  valid: boolean;
-  issue?: string;
-  modelInvocable: boolean;
-  userInvocable: boolean;
-}
-declare function resolveProjectRoot(cwd: string): string;
-declare function skillRoots(options: {
-  cwd?: string;
-  dshHome: string;
-  folders: readonly string[];
-}): ScanRoot[];
-/** 只扫描普通目录包和直属 Markdown 文件；链接技能由 registry 补充为只读条目。 */
-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;
-  description?: string;
-  whenToUse?: string;
-  metadata?: Record<string, unknown>;
-  /** 官方调用策略：true 时模型不可发现/不可加载（默认 false = 可调用）。 */
-  disableModelInvocation?: boolean;
-  /** 官方调用策略：false 时用户命令不可加载（默认 true）。 */
-  userInvocable?: boolean;
+//#region src/host/write-module.d.ts
+interface WriteModuleOptions {
+  modulesRoot: string;
+  moduleId: string;
+  targetModuleId?: string;
+  sourceDir?: string;
+  agentsInstructionText?: string;
+  warn?: (message: string) => void;
 }
-declare function parseFrontmatter(text: string): {
-  data: SkillFrontmatter;
-  body: string;
-  issue?: string;
-};
+/** 已有同一模块只恢复切片；导入/复制先完整生成合法身份候选，再交换目标。 */
+declare function writeModule(options: WriteModuleOptions): string;
 //#endregion
-//#region src/shared/preset-ids.d.ts
-/**
- * 包内模块与用户副本共用同名 ID；避免与宿主官方预设重名。
- *
- * 内置模块随包分发在仓库根的 `modules/`。旧的内置预设 `pt-*` 已整体退场——它们是官方
- * 预设形态的遗留，重构后不再读取也不再维护；这里指向当前随包分发的内置模块作为兜底。
- */
-declare const DEFAULT_MODULE_ID = "ponytail";
+//#region src/host/module-dirs.d.ts
+/** 模块根：本插件的存储根（~/.dsh/.prompt-tool），导入/新建/种子化的模块都放这里。 */
+declare function userModulesDir(): string;
 //#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, 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 };
+export { Config, apply, inject, loadPromptTemplates, name, userModulesDir, writeModule };