dsh-plugin-prompt-tool 0.7.1 → 0.8.0

package/lib/paths-CY5psBqE.d.mts

@@ -0,0 +1,1233 @@
+import { parseDocument } from "yaml";
+//#region src/shared/instructions.d.ts
+/**
+ * 指令文件（AGENTS.md / CLAUDE.md 等）跨 host/client 的最小契约。
+ * 只放两端都要理解的形状：读取快照、工作区上下文与写入结果；
+ * 引擎侧的位置/晋升/受众算法不在这里复制。
+ */
+/** 单个指令文件正文上限（与官方指令行的 maxBytes 基线对齐；读写限制一致）。 */
+declare const MAX_INSTRUCTION_FILE_BYTES: number;
+declare const INSTRUCTION_FILE_STATUSES: readonly ["ready", "missing", "unreadable", "too-large"];
+/**
+ * 读取状态：`ready` 之外的任何状态都不代表空正文，也禁止写盘。
+ * 读取成功的空文件是 `ready` + `text: ''`，与读取失败严格区分。
+ */
+type InstructionFileStatus = (typeof INSTRUCTION_FILE_STATUSES)[number];
+/** 单次读取形成的一致快照：正文、身份、版本来自同一次读取。 */
+interface InstructionFileSnapshot {
+  /** 服务端按真实文件身份生成；不是客户端写入授权本身。 */
+  fileId: string;
+  /** 服务端解析出的绝对路径（客户端不得据此写盘，只是展示与身份）。 */
+  path: string;
+  /** 展示用路径（DSH_HOME 内 `~/.dsh/…`，项目内相对项目根）。 */
+  displayPath: string;
+  scope: 'global' | 'project';
+  status: InstructionFileStatus;
+  /** status === 'ready' 时的原始 UTF-8 正文（可为空串）；其他状态为 ''。 */
+  text: string;
+  /** status === 'ready' 时原始文件字节的 SHA-256；其他状态为 null。 */
+  revision: string | null;
+  /** 读取失败/超限的诊断信息；ready 时不带。 */
+  message?: string;
+}
+/**
+ * 本次工作区上下文：优先由存活本地 Agent 的会话 cwd 解析；拿不到会话时回退到
+ * 部署进程 cwd（与官方 agent-instructions 的 `session.header.cwd ?? process.cwd()`
+ * 同口径），并如实标记来源，让 UI 能辨别两种范围。
+ */
+interface InstructionContextView {
+  /** 上下文 id（cwd + 文件身份集派生）；无可解析本地会话时为 null。 */
+  contextId: string | null;
+  cwd: string | null;
+  /**
+   * session = 由存活本地 Agent 的会话 cwd 解析；
+   * deploy-cwd = 会话不可用，退回部署进程 cwd（范围提示，不构成写授权）；
+   * global-only = 客户端尚无服务端解析结果时的空池标记。
+   */
+  source: 'session' | 'deploy-cwd' | 'global-only';
+}
+interface InstructionsSnapshot {
+  context: InstructionContextView;
+  files: InstructionFileSnapshot[];
+  owner: InstructionsOwnerView;
+}
+/**
+ * 指令负责人事实：本会话实际装配里是否仍挂着官方指令加载行。
+ * `true` 时独立文件来源整体不参战（同一正文只由一方注入）；`false` 表示由本插件
+ * 的独立来源负责；`null` 表示本次请求还没有该会话的装配观察结果（不猜）。
+ */
+interface InstructionsOwnerView {
+  officialInstructions: boolean | null;
+}
+/** /agents-file 成功返回值：写盘后的新版本，客户端据此更新基线。 */
+interface InstructionFileWriteResult {
+  fileId: string;
+  revision: string;
+}
+/**
+ * 指令文件卡策略（独立于预设与 settings 的本插件自有状态）。
+ *
+ * 只承载行为开关与展示名：正文永远在用户的原文件里，策略不存正文、读取版本、
+ * 会话 ID 或任意客户端路径。缺省 `enabled: false`——独立来源必须先完成负责人
+ * 切换验收，再由用户显式开启。
+ */
+interface InstructionPolicyValues {
+  order: number;
+  position: string;
+  promotion: string;
+  audience: string | null;
+  modelScope: string;
+}
+interface InstructionPolicyFileOverride extends Partial<InstructionPolicyValues> {
+  /** 每文件可关闭注入（默认开启）；部署级 enabled 为 false 时整体不注入。 */
+  enabled?: boolean;
+  /** 可选显示名（只影响 UI 标题）。 */
+  name?: string;
+}
+interface InstructionPolicy {
+  /** 部署级开关：文件来源是否参与注入。 */
+  enabled: boolean;
+  /** 未单独覆盖的文件使用这些值。 */
+  defaults: InstructionPolicyValues;
+  /** 按 fileId 的覆盖；缺省即用 defaults，删除覆盖恢复默认。 */
+  files: Record<string, InstructionPolicyFileOverride>;
+}
+/** 局部更新：只写传入的键；files[fileId] = null 表示删除该覆盖。 */
+interface InstructionPolicyPatch {
+  enabled?: boolean;
+  defaults?: Partial<InstructionPolicyValues>;
+  files?: Record<string, InstructionPolicyFileOverride | null>;
+}
+//#endregion
+//#region src/shared/persona-section.d.ts
+/**
+ * preset.yml 顶层 `persona` 段契约：与官方 `@deepseek-ai/dsh-persona` 行同构，
+ * 由渲染层写入 `deployment:persona-prefix`（order 0）与
+ * `deployment:persona-suffix`（order 10200）两段。
+ * 旧 params.sectionName 人设写法不做兼容也不迁移（本项目不含迁移代码）。
+ */
+/**
+ * preset.yml 顶层 `persona` 段：与官方 `@deepseek-ai/dsh-persona` 行的 config 同构。
+ * 官方 schema：prefix required、suffix 默认 ''、complete 默认 false、
+ * includeRuntimeContext 默认 true。
+ */
+interface PersonaSpec {
+  /** `deployment:persona-prefix` 文本（第一方指导之前，官方 order 0）。 */
+  prefix: string;
+  /** `deployment:persona-suffix` 文本（第一方指导之后，官方 order 10200）。 */
+  suffix?: string;
+  /** prefix 独占整个 system prompt（抑制其余段与 suffix）。 */
+  complete?: boolean;
+  /** false = 抑制该 scope 的动态 runtime-context 快照。 */
+  includeRuntimeContext?: boolean;
+}
+//#endregion
+//#region src/shared/asset-transfer.d.ts
+/** 资产传输使用显式编码；省略编码仅兼容旧文本请求。 */
+interface AssetFile {
+  path: string;
+  content: string;
+  encoding?: 'utf8' | 'base64';
+}
+type ImportKind = 'native-preset' | 'native-character' | 'st-preset' | 'st-character' | 'world-book';
+interface ImportChoices {
+  targetId?: string;
+  targetName?: string;
+  overwrite?: boolean;
+  sourceKind?: ImportKind;
+  promptOrderCharacterId?: string;
+}
+interface AssetSummary {
+  sourceName: string;
+  kind: ImportKind;
+  targetId: string;
+  targetName: string;
+  exists: boolean;
+  files: Array<{
+    path: string;
+    bytes: number;
+  }>;
+  configCount: number;
+  warnings: string[];
+}
+interface AssetImportRequest extends ImportChoices {
+  files?: AssetFile[];
+  sourceId?: string;
+  preview?: boolean;
+  expectedSourceDigest?: string;
+  expectedPreviewRevision?: string;
+}
+interface PresetExportRequest {
+  id: string;
+  mode?: 'definition' | 'zip';
+  preview?: boolean;
+  expectedRevision?: string;
+  memoryChoices?: Record<string, 'include' | 'exclude'>;
+}
+interface PresetExportResult {
+  id: string;
+  name: string;
+  content: string;
+  encoding?: 'utf8' | 'base64';
+  filename?: string;
+  revision?: string;
+  files?: Array<{
+    path: string;
+    bytes: number;
+  }>;
+  warnings?: string[];
+  blockers?: string[];
+  memoryConflicts?: Array<{
+    id: string;
+    name: string;
+  }>;
+  excludedMemoryCount?: number;
+}
+//#endregion
+//#region src/shared/engine-capabilities.d.ts
+type ModuleSourceMode = 'explicit' | 'composition' | 'official' | 'unknown';
+/** 官方九个注入层：与 engine/schema.mjs 的 LAYER_ORDER 同源，改一处必须同步另一处。 */
+type EngineLayer = 'pre-step' | 'system-section' | 'runtime-context' | 'agent-request' | 'llm-stream' | 'tool-pipeline' | 'turn-stop' | 'subagent-start' | 'subagent-end';
+interface PresetModuleFacts {
+  declaredModules: string[] | null;
+  effectiveModules: string[] | null;
+  rowIds: string[];
+  sourceMode: ModuleSourceMode;
+  editable: boolean;
+  effectiveConfigs?: Record<string, Record<string, unknown>>;
+}
+interface EngineCapability {
+  id: string;
+  moduleKeys: readonly string[];
+  rowIds: readonly string[];
+  displayLayer: EngineLayer;
+  /** 真实跨层影响的相关层（只在确有第二通道时登记，避免把归属铺满九层）。 */
+  relatedLayers?: readonly EngineLayer[];
+  /**
+   * 该能力拥有的 preset 顶层数据段（不是行级 config）。
+   * 创建时若段缺失则写入 `skeleton`（保证"模块在 ⇒ 数据在"）；删除时一并移除该段。
+   */
+  ownSection?: {
+    /** preset.yml 顶层键名。 */
+    key: string;
+    /** 启用时写入的可用骨架（必须能通过该段的校验）。 */
+    skeleton: Readonly<Record<string, unknown>>;
+  };
+}
+/** 首期只登记已有 typed editor 的能力，避免万能 key/value 表单。 */
+declare const ENGINE_CAPABILITIES: readonly EngineCapability[];
+/**
+ * 编辑组 = 前端一张可编辑卡（能力卡或专用卡）的主归属层。
+ * id 必须是代码里真实存在的 card / 展开键名，不新增臆造 id。
+ */
+interface EngineEditorGroup {
+  id: string;
+  displayLayer: EngineLayer;
+  /** 真实跨层影响的相关层（只有确有第二通道时才写）。 */
+  relatedLayers?: readonly EngineLayer[];
+  /** 真实生效通道的只读说明键（如 'agent-request' / 'system-section'）：供 UI 显示「实际生效通道」，
+   *  只写代码里可核对的事实，不承诺未验证的通道。 */
+  hook: string;
+}
+interface EngineRecipe {
+  id: string;
+  capabilities: readonly string[];
+  initialParams?: Readonly<Record<string, unknown>>;
+}
+/**
+ * 只保留已有真实工作流的一键组合；recipe 本身不写入 preset.yml。
+ *
+ * B7 T3 清空：三条 recipe 的成员都是随本轮退场的专用能力（phase-control /
+ * phase-control-ptc / deliberation），没有任何一条还能组成合法能力集合。
+ * export 与 `engineRecipe()` 保留——调用点（创建菜单、bridge 校验）不必跟着改，
+ * 空表天然让组合项整个消失。
+ */
+declare const ENGINE_RECIPES: readonly EngineRecipe[];
+declare function engineCapability(id: string): EngineCapability | undefined;
+declare function engineRecipe(id: string): EngineRecipe | undefined;
+/** 显式模块预设中的实际能力；包含当前参数与顶层策略所需的装配。
+ *  创建补声明由 host 单独检查 declaredModules；官方组合行不伪装成可编辑能力。 */
+declare function isEngineCapabilityPresent(id: string, facts: PresetModuleFacts | undefined): boolean;
+/** custom tool 的运行时名称缺省回落 id；保存前拒绝会导致同层注册失败的重复项。 */
+declare function validateCustomToolIdentities(tools: readonly unknown[]): string[];
+//#endregion
+//#region src/shared/managed-config-fields.d.ts
+interface ConfigFieldSources {
+  configId: string;
+  fields: Array<{
+    path: string;
+    source: 'preset-param' | 'prompt-config';
+  }>;
+}
+//#endregion
+//#region src/shared/official-orders.d.ts
+/** 一个已求值的区段：`from` / `to` 是该组首末档位的**官方**数值。 */
+interface OfficialOrderSegment {
+  readonly id: string;
+  readonly from: number;
+  readonly to: number;
+}
+/** 下发形状：两层各自一组区段。 */
+interface OfficialOrdersView {
+  readonly sections: readonly OfficialOrderSegment[];
+  readonly contexts: readonly OfficialOrderSegment[];
+}
+//#endregion
+//#region src/shared/skills.d.ts
+interface SkillContentSnapshot {
+  /** Markdown 正文，不含 YAML frontmatter 与分隔线。 */
+  content: string;
+  description: string;
+  /** 当前原始内容的 SHA-256；只用于冲突检查，不保存历史版本。 */
+  revision: string;
+}
+/** 官方技能根分类；数值越小越优先，与官方 rank 一致。 */
+type SkillSourceKind = 'project-dsh' | 'project-agents' | 'custom' | 'user-dsh' | 'user-agents' | 'bundled' | 'other';
+/** 两个官方调用策略键：值就是「该端是否可调用」。 */
+interface SkillInvocation {
+  /** `disable-model-invocation`：false 时模型不可发现、不可加载。 */
+  modelInvocable: boolean;
+  /** `user-invocable`：false 时用户斜杠命令不可加载。 */
+  userInvocable: boolean;
+}
+/** 两端调用策略的目标范围：'model' = 只让模型端不可调用，'user' = 只让用户端不可调用，
+ *  'all' = 两端都不可调用，'none' = 两端都恢复可调用。语义是「点击之后的目标状态」。 */
+type SkillPolicyScope = 'none' | 'model' | 'user' | 'all';
+/** 单端操作不携带另一端的旧快照；显式 scope 供两端批量操作和 TUI 使用。 */
+type SkillPolicyChange = {
+  side: 'model' | 'user';
+  enabled: boolean;
+} | {
+  scope: SkillPolicyScope;
+};
+interface SkillsCatalogSnapshot {
+  skills: SkillCatalogEntry[];
+  /** false 表示观测不完整，不能把未发现解释成不存在。 */
+  complete: boolean;
+}
+/** 目标范围 → 两个键的写入意图（true = 该端可调用）。 */
+declare function invocationForScope(scope: SkillPolicyScope): SkillInvocation;
+/** 当前两端状态 → 范围（两端都可调用时为 'none'）。 */
+declare function scopeOfInvocation(invocation: SkillInvocation): SkillPolicyScope;
+/** 插件技能状态：只剩用户显式引用的技能文件夹（绝对路径，按引用顺序）。
+ *  技能是否可调用由技能文件自己声明，不再进状态文件。 */
+interface SkillsState {
+  version: number;
+  folders: string[];
+}
+/** 清单条目：由插件扫描六类官方技能根得到，是管理面的事实来源。 */
+interface SkillCatalogEntry {
+  /** 稳定键：来源类别 + 来源根 + 目录名。 */
+  id: string;
+  /** frontmatter name（缺失时回退目录名）。 */
+  name: string;
+  description: string;
+  /** 技能目录名（一层扫描，与官方发现规则一致）。 */
+  folder: string;
+  /** 来源根的绝对路径。 */
+  dir: string;
+  source: SkillSourceKind;
+  /** 来源优先级（越小越优先）。 */
+  rank: number;
+  valid: boolean;
+  issue?: string;
+  /** frontmatter 声明的模型端调用策略（唯一事实，缺省为可调用）。 */
+  modelInvocable: boolean;
+  /** frontmatter 声明的用户端调用策略（唯一事实，缺省为可调用）。 */
+  userInvocable: boolean;
+  /** 同名技能中的胜出者 id；本项未胜出时用于提示"被同名技能遮蔽"。 */
+  winnerId?: string;
+  /** 标记文件绝对路径（调用策略的写入目标与身份校验依据）。 */
+  path?: string;
+  /** 同名遮蔽事实：只有注册表确实报了同名技能时才标注；其余条目按文件声明为事实。 */
+  availability?: 'active' | 'shadowed';
+  provider?: string;
+  canSetPolicy?: boolean;
+  /** 普通本地资产可编辑描述和正文；缺描述可修复，损坏的 frontmatter 拒绝读取。 */
+  canEdit?: boolean;
+  canDelete?: boolean;
+  readonlyReason?: string;
+}
+//#endregion
+//#region src/shared/bridge-contract.d.ts
+declare const SETTINGS_BRIDGE_PREFIX = "/api/prompt-tool/settings";
+/** JSON bridge 的统一内存缓冲上限；超过后改用原始文件流端点。 */
+declare const MAX_BRIDGE_BODY_BYTES: number;
+/** 角色卡原始文件流上限；独立于 JSON bridge，避免 base64 膨胀。 */
+declare const MAX_CHARACTER_CARD_STREAM_BYTES: number;
+/** 桥端点路径（相对前缀）。新增端点必须同时登记到契约测试。 */
+declare const BRIDGE_ENDPOINTS: {
+  readonly meta: "/meta";
+  readonly bootstrap: "/bootstrap";
+  readonly describe: "/describe";
+  readonly models: "/models";
+  readonly modelReasoning: "/model-reasoning";
+  readonly mutate: "/mutate";
+  readonly configsValidate: "/configs-validate";
+  readonly skillsList: "/skills-list";
+  readonly skillPolicy: "/skill-policy";
+  readonly skillRead: "/skill-read";
+  readonly skillWrite: "/skill-write";
+  readonly skillsFolders: "/skills-folders";
+  readonly skillsImport: "/skills-import";
+  readonly skillsImportDirectory: "/skills-import-directory";
+  readonly skillCreate: "/skill-create";
+  readonly skillDelete: "/skill-delete";
+  readonly templates: "/templates";
+  readonly promptConfigs: "/prompt-configs";
+  readonly agentsFile: "/agents-file";
+  readonly instructionsPolicy: "/instructions-policy";
+  readonly presetContent: "/preset-content";
+  readonly importPreset: "/import-preset";
+  readonly paramOverrides: "/param-overrides";
+  readonly triggers: "/triggers";
+  readonly persona: "/persona";
+  readonly presetVariables: "/preset-variables";
+  readonly customTools: "/custom-tools";
+  readonly importPresetPackage: "/import-preset-package";
+  readonly assetUpload: "/asset-upload";
+  readonly assetRelease: "/asset-release";
+  readonly exportPreset: "/export-preset";
+  readonly presetDelete: "/preset-delete";
+  readonly presetClone: "/preset-clone";
+  readonly presetDuplicate: "/preset-duplicate";
+  readonly presetOpen: "/preset-open";
+  readonly charactersImport: "/characters-import";
+  readonly charactersImportStream: "/characters-import-stream";
+  readonly charactersList: "/characters-list";
+  readonly charactersDelete: "/characters-delete";
+  readonly charactersApply: "/characters-apply";
+  readonly charactersRemove: "/characters-remove";
+  readonly subagentToolPolicy: "/subagent-tool-policy";
+  readonly subagentToolPolicyPreview: "/subagent-tool-policy-preview";
+  readonly toolSurface: "/tool-surface";
+  readonly engineCapability: "/engine-capability";
+  readonly worldBookDiagnostics: "/world-book-diagnostics";
+};
+type BridgeEndpoint = (typeof BRIDGE_ENDPOINTS)[keyof typeof BRIDGE_ENDPOINTS];
+/** 失败载荷：两端共用。 */
+type BridgeErrorPayload = {
+  ok: false;
+  code?: string;
+  message?: string;
+  conflicts?: string[];
+};
+/**
+ * 端点级请求体契约（body 形状；无请求体端点 = undefined）。
+ * 与 BRIDGE_ENDPOINTS 一一对应：新增端点必须同时补请求/响应映射，否则编译期断言失败。
+ * 载荷仍统一走 { ok, value } 包装（见 BridgeResult），这里收敛每端的 value 具体形状。
+ */
+interface BridgeRequestMap {
+  meta: undefined;
+  /** 可选 sessionId：服务端据此解析该本地 Agent 的工作区，返回对应指令文件快照。 */
+  bootstrap: {
+    sessionId?: string;
+  } | undefined;
+  describe: undefined;
+  /** 省略 body 或 `refresh: true`（显式刷新越过 10 分钟目录 TTL）。 */
+  models: {
+    refresh?: boolean;
+  } | undefined;
+  modelReasoning: {
+    provider: string;
+    model: string;
+  };
+  mutate: {
+    ops: unknown[];
+    expectedRevision?: number;
+  };
+  configsValidate: {
+    promptConfigs: unknown[];
+    strategyDir?: string;
+  };
+  /** 技能清单：按会话工作区扫描官方六类技能根，调用策略取自各技能文件的 frontmatter。 */
+  skillsList: {
+    sessionId?: string;
+  } | undefined;
+  /** 调用策略开关：改写该技能 SKILL.md frontmatter 的官方两个键（正文不动）；
+   *  path 必须命中服务端当次扫描的同名条目，否则按陈旧界面拒绝。 */
+  skillPolicy: {
+    name: string;
+    path: string;
+    sessionId?: string;
+  } & SkillPolicyChange;
+  /** 技能描述、Markdown 正文和完整原文摘要；重新扫描同名同路径身份。 */
+  skillRead: {
+    name: string;
+    path: string;
+    sessionId?: string;
+  };
+  /** 仅保存描述与正文，保持其余 frontmatter，并用完整原文摘要拒绝并发覆盖。 */
+  skillWrite: {
+    name: string;
+    path: string;
+    sessionId?: string;
+    content: string;
+    description: string;
+    expectedRevision: string;
+  };
+  /** 添加 / 移除引用的技能文件夹（只记状态，不复制文件）。 */
+  skillsFolders: {
+    folders: string[];
+    sessionId?: string;
+  };
+  /** overwrite 仅包含用户已确认覆盖的技能目录名；缺省时遇到同名返回冲突且不写盘。 */
+  skillsImport: {
+    files: Array<{
+      path: string;
+      content: string;
+    }>;
+    overwrite?: string[];
+  };
+  skillsImportDirectory: {
+    path: string;
+    overwrite?: string[];
+  };
+  skillCreate: {
+    name: string;
+    description: string;
+    content: string;
+  };
+  skillDelete: {
+    name: string;
+    path: string;
+    sessionId?: string;
+  };
+  templates: undefined;
+  /** 可选 sessionId：与 /bootstrap 同源解析当前工作区（单读与聚合读取必须一致）。 */
+  promptConfigs: {
+    sessionId?: string;
+  } | undefined;
+  /**
+   * 单文件写盘：fileId/contextId 必须命中服务端当次解析的白名单；
+   * expectedRevision 是客户端已读取的字节版本（乐观并发控制，服务端重读校验）。
+   */
+  agentsFile: {
+    sessionId?: string;
+    contextId: string;
+    fileId: string;
+    expectedRevision: string | null;
+    content: string;
+  };
+  /**
+   * 指令文件卡策略（独立存储，默认禁用）：省略 `policy` = 读取；
+   * 写入必须带读取时的 `expectedRevision`（文件缺失为 null）。
+   */
+  instructionsPolicy: {
+    policy?: InstructionPolicyPatch;
+    expectedRevision?: string | null;
+  } | undefined;
+  presetContent: undefined;
+  importPreset: {
+    contents: Array<{
+      scope: 'preset' | 'agents';
+      content: string;
+    }>;
+    expectedPresetId?: string;
+  };
+  paramOverrides: {
+    overrides?: Record<string, unknown>;
+    promptConfigs?: unknown[];
+    rebuild?: boolean;
+    expectedPresetId?: string;
+  };
+  triggers: {
+    expectedPresetId: string;
+    triggers?: unknown[];
+    expectedRevision?: string;
+    validateOnly?: boolean;
+  };
+  /** 顶层 persona 段读写（官方 @deepseek-ai/dsh-persona 行 config 同构）；省略 persona 键 = 读取。 */
+  persona: {
+    persona?: PersonaSpec | null;
+    expectedPresetId?: string;
+  } | undefined;
+  presetVariables: {
+    variables?: Record<string, string>;
+    enabled?: boolean;
+    expectedPresetId?: string;
+  };
+  customTools: {
+    customTools?: unknown[];
+    expectedPresetId?: string;
+  } | undefined;
+  /**
+   * 预设包导入（原生/ST/PNG/ZIP）。`preview: true` 只转换并返回报告，不写目标；
+   * 提交必须携带 expectedSourceDigest 和 expectedPreviewRevision，服务端重算并拒绝过期预览。
+   * `expectedPreviewRevision` 是预览返回的版本凭据：绑定文件、实际选组、转换器版本与
+   * 目标身份（含目标当前内容），服务端提交时重算，不符返回 409 且零写盘。
+   * `promptOrderCharacterId` 用于多顺序组包时显式选择：预览缺省时先返回候选
+   * （`state: 'needs-order-selection'`），提交时仍无法明确对应则拒绝。
+   * 上述参数只接受声明的类型，其它类型一律 400（见 docs/SillyTavern.md）。
+   */
+  importPresetPackage: AssetImportRequest;
+  assetUpload: undefined;
+  assetRelease: {
+    sourceId: string;
+  };
+  exportPreset: PresetExportRequest;
+  presetDelete: {
+    id: string;
+  };
+  presetClone: {
+    id: string;
+    autoSuffix?: boolean;
+  };
+  presetDuplicate: {
+    id: string;
+  };
+  presetOpen: {
+    id: string;
+  };
+  /** 角色卡 PNG/JSON/YAML 导入；预览不写角色库，提交必验版本，目标和选组均绑定预览。 */
+  charactersImport: AssetImportRequest;
+  charactersImportStream: undefined;
+  charactersList: undefined;
+  charactersDelete: {
+    id: string;
+  };
+  charactersApply: {
+    id: string;
+  };
+  charactersRemove: {
+    id: string;
+  };
+  subagentToolPolicy: {
+    policy?: unknown;
+    expectedPresetId?: string;
+  } | undefined;
+  subagentToolPolicyPreview: {
+    tool?: string;
+    description?: string;
+    prompt?: string;
+    tool_profile?: string;
+    character_id?: string;
+    task_type?: string;
+    additional_tools?: string[];
+    restrict_tools?: string[];
+  };
+  toolSurface: {
+    sessionId: string;
+    presetId?: never;
+  } | {
+    presetId: string;
+    sessionId?: never;
+  };
+  engineCapability: ({
+    action: 'create' | 'remove';
+    capabilityId: string;
+  } | {
+    action: 'create-recipe';
+    recipeId: string;
+  }) & {
+    expectedPresetId?: string;
+  };
+  /** 只读世界书诊断：只回当前授权会话最近一次选择的观测记录。 */
+  worldBookDiagnostics: {
+    sessionId?: string;
+  } | undefined;
+}
+/** settings descriptor 的跨端最小结构。 */
+interface BridgeSettingsView {
+  ns: string;
+  value: unknown;
+  base?: unknown;
+  revision: number;
+}
+/**
+ * 一条 provider/model 路由的推理档位元数据（官方模型元数据的展示子集）。
+ *
+ * `known` 区分「查过且该路由不提供档位」与「尚未取得元数据」：前者 UI 必须隐藏档位
+ * 选择而不是拿固定列表伪造能力；后者只是还没查到，不能据此判断模型没有推理能力。
+ * 目录/元数据只作展示，不是授权白名单——查询失败不影响保存任意模型 id。
+ */
+interface ModelReasoningView {
+  known: boolean;
+  efforts: Array<{
+    id: string;
+    name: string;
+    description?: string;
+  }>;
+  defaultEffort?: string;
+}
+/**
+ * SillyTavern 转换报告（ST-03）：host 在真实转换路径上生成的**只读派生元数据**。
+ * 不落盘进 preset.yml、不进入模型上下文，也不是写入凭证——提交仍以本次上传文件重算的
+ * `sourceDigest` 为准；预览返回的摘要不能替代后端对目标/类型/大小的既有校验。
+ */
+type StConversionClass = 'equivalent' | 'degraded' | 'unsupported' | 'excluded';
+interface StConversionEntryReport {
+  /** 来源条目身份：上传文件显示名内的原 identifier/uid（不含绝对路径）。 */
+  sourceId: string;
+  /** 来源在文件内的序号（prompts 数组下标或世界书 entries 序号）。 */
+  sourceIndex: number;
+  /** 生成的目标配置 id（被排除的条目没有目标）。多文件合并后重写为**最终** id。 */
+  targetId?: string;
+  /** 同源生成的 promptConfigs 下标：合并重命名时用它把 targetId 关联到最终配置。 */
+  targetIndex?: number;
+  /** 来源显示名（多文件合并时用于区分条目来自哪个上传文件）。 */
+  sourceName?: string;
+  /** 来源在本次合并中的序号（0 起）。 */
+  sourceFileIndex?: number;
+  layer?: string;
+  order?: number;
+  role?: string;
+  position?: string;
+  classification: StConversionClass;
+  /** 稳定原因码（如 depth-collapsed / system-role-downgrade / marker-dropped）。 */
+  codes: string[];
+}
+interface StConversionDiagnostic {
+  code: string;
+  severity: 'warning' | 'info';
+  message: string;
+  /** 源身份定位：来源条目 id（与 targetId 分开表达，不混用同一字段）。 */
+  entryId?: string;
+  /** 目标身份定位：生成/合并后的最终配置 id（源条目被排除时缺省）。 */
+  targetId?: string;
+  field?: string;
+}
+interface StConversionReport {
+  /** 转换器版本：解释本次生成使用了哪一版语义。 */
+  converter: string;
+  /** 来源显示名（上传文件名，不含绝对路径）。 */
+  sourceName: string;
+  /** prompt_order 分组；`selected` 标记本次实际采用的组。 */
+  orderGroups: Array<{
+    characterId: string;
+    selected: boolean;
+    entries: number;
+  }>;
+  entries: StConversionEntryReport[];
+  diagnostics: StConversionDiagnostic[];
+  summary: {
+    /** 来源条目总数（prompts + 世界书条目 + 角色卡正文段）。 */
+    inputs: number;
+    /** 生成的 promptConfigs 数量。 */
+    converted: number;
+    /** 生成但被禁用的条目数。 */
+    disabled: number;
+    excluded: number;
+    unsupported: number;
+    degraded: number;
+    /** 需要用户确认的诊断数（warning 级）。 */
+    needsReview: number;
+  };
+  /** 记录超出上限时为 true：只截断展示，不影响转换结果。 */
+  truncated?: boolean;
+}
+/** 世界书入选/落选诊断记录（只读派生数据，由引擎真实求值路径产生）。 */
+interface WorldBookDiagnosticRecord {
+  /** 配置 id（`lore-<来源条目>`）。 */
+  id: string;
+  stage: 'excluded' | 'rejected' | 'candidate' | 'selected' | 'committed';
+  /** 稳定原因码：disabled / delay / cooldown / recursion / primary-miss / secondary-miss /
+   *  probability / group-lost / group-occupied / match-error / sticky / constant / key-match /
+   *  ungrouped / group-winner / injected。 */
+  reason: string;
+  [key: string]: unknown;
+}
+/** 顺序组候选：多 prompt_order 组需要用户先选择时的有界选项（不含转换结果）。 */
+interface StOrderGroupCandidate {
+  characterId: string;
+  entries: number;
+}
+/** 导入预览状态：`ready` 才有报告与写入凭据；候选状态不得启用确认。 */
+type ImportPreviewState = 'ready' | 'needs-order-selection' | 'needs-kind-selection';
+/** 引擎实际消费的实例参数；只下发可序列化约束，未知扩展键仍由原配置保留。 */
+interface LayerParamContract {
+  type: 'string' | 'boolean' | 'object' | 'enum';
+  values?: readonly string[];
+}
+/** 声明编辑目录由引擎提供；示例同时经过声明编译器验证。 */
+interface TriggerEditorMeta {
+  predicates: Array<{
+    kind: string;
+    example: Record<string, unknown>;
+  }>;
+  actions: Array<{
+    kind: string;
+    example: Record<string, unknown>;
+    channel: string;
+    phase: string;
+    supportsWhen: boolean;
+  }>;
+  composites: string[];
+  waterfallPositions: string[];
+}
+interface LayerContract {
+  strategies: readonly string[];
+  subjects: readonly string[];
+  content: 'text' | 'request' | 'stream' | 'tool-result' | 'subagent-result';
+  variables: boolean;
+  messageMetadata: boolean;
+  params: Readonly<Record<string, LayerParamContract>>;
+}
+/**
+ * /meta 与 /bootstrap 的 meta 段下发的层契约：九层顺序 + 编辑组主归属。
+ * 只含可序列化白名单字段（组 id / displayLayer / relatedLayers / hook）：
+ * 不含路径、行级配置、校验函数或服务实例 —— 展示归属不扩大写权限。
+ * 插件与内置引擎同步发布，这些字段由当前 bridge 完整下发。
+ */
+interface EngineMetaLayerContract {
+  /** 九层固定顺序（引擎 LAYER_ORDER，host 不另写一份）。 */
+  layerOrder: readonly EngineLayer[];
+  /** 编辑组主归属总表（能力组 id = 能力 id）；前端据此组织九层卡片。 */
+  editorGroups: readonly EngineEditorGroup[];
+  /** 每层真实可编辑的行为契约，来自独立可分发的 engine/schema.mjs。 */
+  layerContracts: Record<EngineLayer, LayerContract>;
+}
+/** 物化配置的只读来源；与配置一同读回，不能作为写入字段或授权。 */
+interface PromptConfigSourceView {
+  fieldSources?: ConfigFieldSources;
+}
+/** 端点级响应 value 契约（value 字段形状；扩展字段仍以 value 旁可选字段出现）。 */
+interface BridgeValueMap {
+  /**
+   * `/meta` 与 `/bootstrap` 的 meta 段：层契约 + 官方装配刻度。
+   * `officialOrders` 缺席表示服务降级或官方档位名不匹配，消费方必须退化（不渲染刻度）。
+   */
+  meta: {
+    meta: Record<string, unknown> & EngineMetaLayerContract & {
+      officialOrders?: OfficialOrdersView;
+    };
+  };
+  bootstrap: BridgeSettingsView;
+  describe: BridgeSettingsView;
+  models: {
+    modelCatalog: Record<string, string[]>;
+  };
+  modelReasoning: {
+    reasoning: ModelReasoningView;
+  };
+  mutate: BridgeSettingsView;
+  configsValidate: {
+    valid: boolean;
+    errors: Array<{
+      index: number;
+      id: string;
+      message: string;
+    }>;
+    configs?: unknown[];
+    files?: unknown[];
+  };
+  /** 技能清单 + 引用目录 + 技能根（客户端据此渲染来源分组与调用策略）。 */
+  skillsList: SkillsCatalogSnapshot & {
+    folders: string[];
+    roots: string[];
+  };
+  skillPolicy: SkillsCatalogSnapshot;
+  skillRead: SkillContentSnapshot;
+  skillWrite: SkillContentSnapshot;
+  skillsFolders: SkillsCatalogSnapshot & {
+    folders: string[];
+  };
+  skillsImport: {
+    path: string;
+    count: number;
+    overwritten: number;
+    warning?: string;
+  };
+  skillCreate: {
+    id: string;
+    path: string;
+  };
+  skillDelete: {
+    id: string;
+    path: string;
+  };
+  skillsImportDirectory: {
+    path: string;
+    count: number;
+    overwritten: number;
+    warning?: string;
+  };
+  templates: {
+    templates?: unknown[];
+    toolTemplates?: unknown[];
+  };
+  promptConfigs: {
+    promptConfigs: Array<Record<string, unknown> & PromptConfigSourceView>;
+    instructions?: InstructionsSnapshot;
+  };
+  agentsFile: InstructionFileWriteResult;
+  instructionsPolicy: {
+    policy: InstructionPolicy;
+    revision: string | null;
+    exists: boolean;
+    error?: string;
+  };
+  presetContent: Record<string, unknown>;
+  importPreset: {
+    scopes: Array<'preset' | 'agents'>;
+  };
+  /** 参数/提示词配置只保存当前预设，不同步宿主全局默认模型。 */
+  paramOverrides: {
+    overrides?: Record<string, unknown>;
+    promptConfigs?: unknown[];
+  };
+  triggers: {
+    triggers: unknown[];
+    revision: string;
+    meta: TriggerEditorMeta;
+  };
+  persona: {
+    persona: PersonaSpec | null;
+  };
+  presetVariables: {
+    variables: Record<string, string>;
+    enabled: boolean;
+  };
+  customTools: {
+    customTools?: unknown[];
+  };
+  importPresetPackage: {
+    id?: string;
+    backupPath?: string;
+    preview?: boolean;
+    state?: ImportPreviewState;
+    /** 候选状态下的歧义来源文件显示名（不含绝对路径）。 */
+    sourceName?: string;
+    candidates?: StOrderGroupCandidate[];
+    sourceDigest?: string;
+    previewRevision?: string;
+    report?: StConversionReport;
+    summary?: AssetSummary;
+    kinds?: ImportKind[];
+    refreshWarning?: string;
+  };
+  assetUpload: {
+    sourceId: string;
+    name: string;
+    bytes: number;
+  };
+  assetRelease: {
+    released: boolean;
+  };
+  exportPreset: PresetExportResult;
+  presetDelete: {
+    id: string;
+  };
+  presetClone: {
+    id: string;
+  };
+  presetDuplicate: {
+    id: string;
+  };
+  presetOpen: {
+    path: string;
+  };
+  charactersImport: {
+    id?: string;
+    name?: string;
+    preview?: boolean;
+    state?: ImportPreviewState;
+    candidates?: StOrderGroupCandidate[];
+    sourceDigest?: string;
+    previewRevision?: string;
+    report?: StConversionReport;
+    summary?: AssetSummary;
+    kinds?: ImportKind[];
+  };
+  charactersImportStream: {
+    id: string;
+    name: string;
+  };
+  charactersList: {
+    characters: Array<{
+      id: string;
+      name: string;
+      description?: string;
+      hasAvatar: boolean;
+      imported: boolean;
+    }>;
+  };
+  charactersDelete: {
+    id: string;
+  };
+  charactersApply: {
+    id: string;
+    count: number;
+  };
+  charactersRemove: {
+    id: string;
+    count: number;
+  };
+  subagentToolPolicy: {
+    policy: unknown;
+    defaultProfile?: string;
+    errors?: string[];
+  };
+  subagentToolPolicyPreview: {
+    result: unknown;
+    errors?: string[];
+  };
+  toolSurface: {
+    source: 'session' | 'preset';
+    sessionId?: string;
+    presetId?: string;
+    tools: Array<{
+      name: string;
+      description: string;
+    }>;
+  };
+  engineCapability: {
+    changed: boolean;
+    addedModules?: string[];
+    removedModules?: string[];
+    capabilityIds: string[];
+  };
+  /** 只读世界书诊断：只回当前授权会话最近一次选择的观测记录（读取不重新求值）。 */
+  worldBookDiagnostics: {
+    records: WorldBookDiagnosticRecord[];
+    truncated: boolean;
+    step: number;
+    evaluated: boolean;
+  };
+}
+//#endregion
+//#region src/host/manifest.d.ts
+interface PresetSpec {
+  id: string;
+  name: string;
+  /** 官方预设列表顺序；省略时由宿主排序。 */
+  order?: number;
+  /** 预设说明（官方用户预设格式元数据；列表展示用，可选）。 */
+  description?: string;
+  version: string;
+  engineCompat: string;
+  meta?: Record<string, unknown>;
+  content?: {
+    presetText?: string;
+    agentsText?: string;
+  };
+  /** 模块清单(参数文件决定组合内容):按序装配 source/local 与 library 中的唯一模块。 */
+  modules?: string[];
+  /** 手写组合：内联文本或组合清单名。 */
+  composition?: string;
+  /** 内部运行时平铺适配面；磁盘上的同名段不参与运行参数。 */
+  params?: Record<string, unknown>;
+  /** 共享引擎参数按编辑组的主归属插入点存储；规则实例仍拥有各自 params。 */
+  layerSettings?: Record<string, Record<string, unknown>>;
+  /** 顶层人设段（官方 @deepseek-ai/dsh-persona 行同构）：prefix/suffix/complete/includeRuntimeContext。 */
+  persona?: PersonaSpec;
+  /** 预设级模板变量（{{key}} 插值源；与 layerSettings 分离，顶层 variables 段）。 */
+  variables?: Record<string, string>;
+  /** 自定义工具定义（tool-config-engine 渲染进 custom-tools/ 后运行时注册）。 */
+  customTools?: unknown[];
+  /** 子代理实例级工具策略（subagentToolPolicy 顶层领域段；缺省 = 官方 delegation 行为）。 */
+  subagentToolPolicy?: Record<string, unknown>;
+  /**
+   * 触发器声明（`triggers` 顶层段）：`{ id, channel, when?, do, … }` 的数组。
+   * 声明**由预设提供**（引擎不带默认），物化为 `triggers.yml` 后由 `declared-triggers`
+   * 运行时模块读入并注册；形状与校验归 `engine/trigger-spec.mjs` 的声明编译器。
+   */
+  triggers?: unknown[];
+  /** 模板变量插值开关（缺省 true = 启用；false = 停用，writePreset 不生成变量文件）。 */
+  variablesEnabled?: boolean;
+  /** 可选:模板自定义提示词配置覆盖(纯数据,不使用模板语法)。 */
+  promptConfigs?: unknown[];
+  /** 可选:引擎组合模块行参数直写(行级 map config 浅合并;参数桥未覆盖的键生效,参数桥优先)。 */
+  moduleConfigs?: Record<string, Record<string, unknown>>;
+  upstream?: Record<string, unknown>;
+}
+/**
+ * 从预设 preset.yml 的 modules 清单移除一个模块 id（YAML Document 保留注释
+ * 与其余字段）。返回是否发生修改；文件缺失或没有该模块时返回 false。
+ */
+declare function removePresetModule(dir: string, moduleId: string): boolean;
+/** 加载某个预设模板的单一参数文件 preset/<name>/preset.yml。 */
+declare function loadPresetSpec(dir: string): PresetSpec;
+/** 预设根：官方 USER_PRESET_DIR（~/.dsh/.agent-presets），导入/新建/种子化的预设都放这里。 */
+declare function userPresetsDir(): string;
+/**
+ * 解析预设模板目录：当前预设根优先，包内模板回退；不读取其他部署根的同名预设。
+ * 目录名与声明的 preset.yml id 一致；不扫描其他目录的 id 别名。
+ */
+declare function resolvePresetDir(template: string, presetRoot?: string): string;
+/** 本插件预设清单；所有目录按同一身份与组合源规则列举。 */
+declare function listPresets(presetRoot?: string): Array<{
+  id: string;
+  name: string;
+  user: boolean;
+  renderable: boolean;
+  description?: string;
+  meta?: Record<string, unknown>;
+}>;
+/** 插件目录模板清单（「新建」选择器与首次种子化数据源；不直接出现在预设列表）。 */
+declare function listBuiltinTemplates(): Array<{
+  id: string;
+  name: string;
+}>;
+/** 按包内同名目录补建缺失预设；已有目录的定义、生成物和资源保持原样。 */
+declare function ensurePresetSeed(root?: string): {
+  created: string[];
+};
+/** 从包内同名目录复制预设；autoSuffix=true 时递增目录名并同步定义身份。 */
+declare function cloneBuiltinPreset(id: string, autoSuffix?: boolean, presetRoot?: string): {
+  ok: true;
+  id: string;
+} | {
+  ok: false;
+  message: string;
+};
+/**
+ * 保存预设参数：写 layerSettings（merge）/ promptConfigs（整体替换）。
+ * parseDocument 保留注释与未知键（preset.yml 模板含大量注释）；空值键删除（'' / []，
+ * 回落模板/引擎默认；0 与 false 照常写入——语义与函数内注释、docs §3 一致）。
+ */
+declare function savePresetParams(presetRoot: string, templateName: string, params: Record<string, unknown> | undefined, promptConfigs: unknown[] | undefined, variables?: Record<string, string>, variablesEnabled?: boolean): void;
+/**
+ * 保存激活预设的顶层 persona 段（官方 `@deepseek-ai/dsh-persona` 行 config 同构）。
+ * null = 删除该段（回落宿主部署人设）；默认值不落键（见 personaRowConfig）。
+ */
+declare function savePresetPersona(presetRoot: string, templateName: string, persona: PersonaSpec | null): void;
+/** 删除具有合法身份的预设目录（预设根/<id>）；隐藏备份不经公共接口删除。
+ *  仅作用于预设根（官方 USER_PRESET_DIR），包内置模板天然不受影响；路径越界与非法 id 拒绝。
+ *  删除后宿主 agent-presets 目录列表自然不再出现该预设（官方 roster 即目录列表）。 */
+declare function removeUserPreset(id: string, presetRoot?: string): {
+  ok: true;
+} | {
+  ok: false;
+  message: string;
+};
+/** 当前 layerSettings 与显式运行参数合并；不从旧磁盘 params 段回退取值。 */
+declare function resolvePresetParams(spec: PresetSpec, runtime: Record<string, unknown>): Record<string, unknown>;
+/**
+ * 参数桥：params 扁平键 → 引擎模块行 config 对象（取代旧 __TOKEN__ 文本渲染）。
+ *
+ * 原则：
+ *  - 未声明的键不合并（composition 行默认 / 引擎默认生效），与旧"空值删行"语义等价；
+ *  - 值类型直达（布尔/数字/数组不再字符串化再解析）；
+ *  - 合并优先级：参数桥（UI/基础层）> moduleConfigs（模板/ST 行级直写）> 行默认。
+ * 模型路由/委派参数统一扁平键（modelProvider/subagentModelProvider/maxDepth 等），
+ * 与官方 AgentOptions{provider,model} / maxDepth 对齐。
+ */
+declare function buildModuleConfigsFromParams(params: Record<string, unknown>, options?: {
+  subagentPolicyEnabled?: boolean;
+}): Record<string, Record<string, unknown>>;
+/**
+ * 行级 config 合并:仅支持 map 型 config 浅合并;
+ * 数组型 config(如 delegation 组)按子行 id 嵌套合并;未声明模块原样保留。
+ * 未声明 configs 时返回原文(零开销);parseDocument 往返保留注释。
+ * 本函数是参数桥产物落位组合行的唯一机制(含 delegation 组子行嵌套),不是预设覆盖通道。
+ */
+declare function applyModuleConfigs(raw: string, configs: Record<string, Record<string, unknown>> | undefined): string;
+/**
+ * 解析预设的模块事实，供 UI 卡片存在性和受控创建共用。
+ * 显式模块及当前参数/策略所需的装配是可编辑插件能力；官方组合 row 仅保留为运行事实。
+ */
+declare function resolvePresetModuleFacts(spec: PresetSpec, templateDir?: string, editable?: boolean): PresetModuleFacts;
+type EngineCapabilityCreateRequest = {
+  action: 'create';
+  capabilityId: string;
+} | {
+  action: 'create-recipe';
+  recipeId: string;
+};
+interface EngineCapabilityCreateResult {
+  changed: boolean;
+  addedModules: string[];
+  capabilityIds: string[];
+}
+interface EngineCapabilityRemoveResult {
+  changed: boolean;
+  removedModules: string[];
+  capabilityIds: string[];
+}
+/** 在内存候选文档中展开能力/recipe，校验成功后一次原子替换 preset.yml。 */
+declare function createEngineCapabilityInPreset(presetDir: string, request: EngineCapabilityCreateRequest): EngineCapabilityCreateResult;
+/** 删除能力：模块声明、顶层数据段，以及该能力的**显式参数与行配置**一起移除。
+ *  参数在 ⇒ 装配在（见 impliedModulesFromParams）：留下参数会让移除立刻被隐含装配拉回来，
+ *  所以"移除能力"必须是完整移除。未登记参数、其他能力的数据与未知字段一律不动。 */
+declare function removeEngineCapabilityFromPreset(presetDir: string, capabilityId: string): EngineCapabilityRemoveResult;
+/**
+ * 预设组合渲染完整链路:模块装配 → 参数桥(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
+/** ST marker prompts（marker: true）：content 不发送给模型（仅标记注入位置，ST
+ *  以运行时内容填充该位置）；SPresetSettings 是旧版 ST 的预设设置 dump（正则
+ *  脚本/扩展配置/ToolBindings，动辄数百 KB）。两者转换时整体丢弃并计数进
+ *  meta.stDroppedMarkers——防止设置 dump 与位置占位污染 promptConfigs 与注入。 */
+/** 显式文本求值工具；导入本身仅 prepare，避免执行禁用卡的副作用。 */
+declare function processStText(text: string, cardName: string, variables: Record<string, string | number>): string;
+/** 合并多个转换结果为一个预设（角色卡 × 响应预设 → 单预设）。 */
+declare function mergeStPresets(specs: PresetSpec[]): PresetSpec;
+/** 转换选项：多 prompt_order 分组时显式选择来源角色，避免照搬「默认任取首组」。 */
+interface StConversionOptions {
+  characterId?: string;
+}
+/** prompt_order 分组候选：预览选组 UI 与实际转换消费同一份事实。 */
+interface StOrderGroupSummary {
+  characterId: string;
+  entries: number;
+}
+/** SillyTavern JSON 预设卡片 → 本项目 PresetSpec（导入端点直接消费）。 */
+declare function convertStToPreset(card: unknown, baseName: string, options?: StConversionOptions): 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/import-source.d.ts
+type PreparedImport = {
+  state: 'ready';
+  kind: ImportKind;
+  spec: PresetSpec;
+  yaml: string;
+  files: AssetFile[];
+  sourceName: string;
+  sourceDigest: string;
+  report?: StConversionReport;
+  avatar?: Buffer;
+  sourceText?: string;
+} | {
+  state: 'needs-order-selection';
+  candidates: StOrderGroupSummary[];
+  sourceName: string;
+} | {
+  state: 'needs-kind-selection';
+  kinds: ImportKind[];
+  sourceName: string;
+};
+/** 字节集合 → 同一规范化候选；没有目标写入和静默的未知 JSON 回退。 */
+declare function prepareImport(input: AssetFile[], target: 'preset' | 'character', choices?: ImportChoices): PreparedImport;
+//#endregion
+//#region src/host/preset-package.d.ts
+declare function expandPresetSource(input: AssetFile[]): Promise<AssetFile[]>;
+type ReadyImport = Extract<ReturnType<typeof prepareImport>, {
+  state: 'ready';
+}>;
+declare function presetImportPreview(root: string, files: AssetFile[], request: AssetImportRequest): {
+  prepared: ReadyImport;
+  summary: AssetSummary;
+  sourceDigest: string;
+  previewRevision: string;
+} | Exclude<ReturnType<typeof prepareImport>, {
+  state: 'ready';
+}>;
+declare function installPresetPackage(root: string, files: AssetFile[], request: AssetImportRequest): Promise<{
+  id: string;
+  backupPath?: string;
+}>;
+declare function exportPresetPackage(root: string, request: PresetExportRequest): Promise<PresetExportResult>;
+//#endregion
+//#region src/host/paths.d.ts
+/** 用户技能根：官方 `user-dsh` 技能根，也是本插件创建、复制导入与回收站的落点。
+ *  插件不再内置任何技能：包内没有 skills 目录，也不再有安装副本与内容账本。 */
+declare const USER_SKILLS_DIR: string;
+/**
+ * 预设根：官方 USER_PRESET_DIR（DSH_HOME/.agent-presets）。
+ * 每个预设一个官方预设目录（agent.cordis.yml 组合本体 + preset.yml 参数），
+ * 宿主 agent-presets 直接可挂载；共享引擎自阶段 2 起由**插件包**提供（组合行写包名说明符），
+ * 不再物化到预设根下。
+ */
+declare const DEFAULT_PRESET_DIR: string;
+//#endregion
+export { ENGINE_RECIPES as $, resolvePresetParams as A, MAX_CHARACTER_CARD_STREAM_BYTES as B, loadPresetSpec as C, renderComposition as D, removeUserPreset as E, BridgeEndpoint as F, SkillPolicyChange as G, SkillCatalogEntry as H, BridgeErrorPayload as I, SkillsCatalogSnapshot as J, SkillPolicyScope as K, BridgeRequestMap as L, savePresetPersona as M, userPresetsDir as N, resolvePresetDir as O, BRIDGE_ENDPOINTS as P, ENGINE_CAPABILITIES as Q, BridgeValueMap as R, listPresets as S, removePresetModule as T, SkillContentSnapshot as U, SETTINGS_BRIDGE_PREFIX as V, SkillInvocation as W, invocationForScope as X, SkillsState as Y, scopeOfInvocation as Z, buildModuleConfigsFromParams as _, installPresetPackage as a, isEngineCapabilityPresent as at, ensurePresetSeed as b, convertStToPreset as c, ImportChoices as ct, stPresetId as d, InstructionFileSnapshot as dt, EngineCapability as et, EngineCapabilityCreateRequest as f, InstructionFileStatus as ft, applyModuleConfigs as g, PresetSpec as h, exportPresetPackage as i, engineRecipe as it, savePresetParams as j, resolvePresetModuleFacts as k, mergeStPresets as l, INSTRUCTION_FILE_STATUSES as lt, EngineCapabilityRemoveResult as m, USER_SKILLS_DIR as n, PresetModuleFacts as nt, presetImportPreview as o, validateCustomToolIdentities as ot, EngineCapabilityCreateResult as p, MAX_INSTRUCTION_FILE_BYTES as pt, SkillSourceKind as q, expandPresetSource as r, engineCapability as rt, StConversionOptions as s, AssetFile as st, DEFAULT_PRESET_DIR as t, ModuleSourceMode as tt, processStText as u, InstructionContextView as ut, cloneBuiltinPreset as v, removeEngineCapabilityFromPreset as w, listBuiltinTemplates as x, createEngineCapabilityInPreset as y, MAX_BRIDGE_BODY_BYTES as z };