dsh-manage-session 0.5.7 → 2.0.4

package/lib/index.d.ts

@@ -1,10 +1,7 @@
 import z from "@deepseek-ai/schemastery";
-//#region node_modules/.pnpm/cosmokit@1.8.1/node_modules/cosmokit/lib/index.d.ts
 type Dict<T = any, K extends string | symbol = string> = { [key in K]: T; };
 type Promisify<T> = Promise<T extends Promise<infer S> ? S : T>;
 type Awaitable<T> = [T] extends [Promise<unknown>] ? T : T | Promise<T>;
-//#endregion
-//#region node_modules/.pnpm/@standard-schema+spec@1.1.0/node_modules/@standard-schema/spec/dist/index.d.ts
 /** The Standard Typed interface. This is a base type extended by other specs. */
 interface StandardTypedV1<Input = unknown, Output = Input> {
   /** The Standard properties. */
@@ -80,8 +77,25 @@ declare namespace StandardSchemaV1 {
   /** Infers the output type of a Standard. */
   type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
 }
-//#endregion
-//#region node_modules/.pnpm/cordis@4.0.0-rc.10/node_modules/cordis/lib/utils.d.ts
+declare abstract class Service<out T = never> {
+  protected ctx: Context;
+  static readonly init: unique symbol;
+  static readonly check: unique symbol;
+  static readonly invoke: unique symbol;
+  static readonly metadata: unique symbol;
+  static readonly extend: unique symbol;
+  static readonly tracker: unique symbol;
+  static readonly mergeIntercept: unique symbol;
+  static readonly resolveIntercept: unique symbol;
+  [symbols.metadata]: T;
+  name: string;
+  constructor(ctx: Context, name: string);
+  protected [symbols.filter](ctx: Context): boolean;
+  protected [symbols.extend](props?: any): any;
+  [symbols.mergeIntercept](...values: T[]): T;
+  [symbols.resolveIntercept](): T;
+  static [Symbol.hasInstance](instance: any): boolean;
+}
 declare class DisposableList<T extends WeakKey> {
   private sn;
   private map;
@@ -97,29 +111,29 @@ declare const symbols: {
   caller: symbol;
   receiver: symbol;
   original: symbol;
-  metadata: symbol;
+  decorator: symbol;
   initHooks: symbol;
   checkProto: symbol;
+  root: typeof Context.root;
   effect: typeof Context.effect;
   filter: typeof Context.filter;
   isolate: typeof Context.isolate;
   intercept: typeof Context.intercept;
   init: typeof Service.init;
   check: typeof Service.check;
-  config: typeof Service.config;
   invoke: typeof Service.invoke;
+  metadata: typeof Service.metadata;
   extend: typeof Service.extend;
   tracker: typeof Service.tracker;
-  resolveConfig: typeof Service.resolveConfig;
+  mergeIntercept: typeof Service.mergeIntercept;
+  resolveIntercept: typeof Service.resolveIntercept;
 };
-//#endregion
-//#region node_modules/.pnpm/cordis@4.0.0-rc.10/node_modules/cordis/lib/registry.d.ts
 type Inject<M = Dict> = (keyof M)[] | { [K in keyof M]?: M[K]; };
 type InjectKey = keyof { [K in keyof Context & string as Context[K] extends {
-  [symbols.config]: any;
+  [symbols.metadata]: any;
 } ? K : never]: any; };
 declare function Inject<K extends InjectKey>(name: K, config?: Context[K] extends {
-  [symbols.config]: infer T;
+  [symbols.metadata]: infer T;
 } ? T : never): (value: any, decorator: ClassDecoratorContext<any> | ClassMethodDecoratorContext<any>) => void;
 declare namespace Inject {
   function resolve(inject: Inject | null | undefined, result?: Dict): Dict;
@@ -158,7 +172,7 @@ type GetPluginParameters<P> = P extends ((ctx: Context, ...args: infer R) => any
   apply(ctx: Context, ...args: infer R): any;
 } ? R : never;
 type GetPluginConfig<P> = P extends Plugin.Transform<infer S, any> ? S : GetPluginParameters<P>[0];
-declare module './context' {
+declare module './context.ts' {
   interface Context {
     inject(deps: Inject, callback: Plugin.Function<void>): Fiber & PromiseLike<Fiber>;
     plugin<P extends Plugin>(plugin: P, ...args: Spread<GetPluginConfig<P>>): Fiber & PromiseLike<Fiber>;
@@ -182,9 +196,7 @@ declare class RegistryService {
   inject(inject: Inject, callback: Plugin.Function<void>): Fiber & PromiseLike<Fiber>;
   plugin(plugin: Plugin, config?: any, getOuterStack?: () => string[]): Fiber & PromiseLike<Fiber>;
 }
-//#endregion
-//#region node_modules/.pnpm/cordis@4.0.0-rc.10/node_modules/cordis/lib/reflect.d.ts
-declare module './context' {
+declare module './context.ts' {
   interface Context {
     get<K extends string & keyof this>(name: K, strict?: boolean): undefined | this[K];
     get(name: string, strict?: boolean): any;
@@ -209,30 +221,33 @@ declare namespace Property {
   }
 }
 interface Impl {
+  uid: number;
   name: string;
-  fiber: Fiber;
+  ctx: Context;
+  dependents: Set<Fiber>;
+  release?: () => void;
   value?: any;
   check?: () => boolean;
+  isolate: symbol;
 }
 declare class ReflectService {
   ctx: Context;
   static handler: ProxyHandler<Context>;
   store: Dict<Impl, symbol>;
   props: Dict<Property>;
+  private _implCounter;
   constructor(ctx: Context);
   get(name: string, strict?: boolean): any;
   _getImpl(name: string, strict?: boolean): Impl | undefined;
   set(name: string, value: any, error?: Error): boolean;
   provide(name: string, value?: any, check?: () => boolean): Disposable<Promise<void>>;
-  notify(names: string[], filter?: (ctx: Context, name: string) => boolean): Fiber[];
+  notify(names: string[], filter?: (ctx: Context, name: string) => boolean): void;
   accessor(name: string, options: Omit<Property.Accessor, 'type'>): Disposable<Promise<void>>;
   mixin(source: any, mixins: string[] | Dict<string>): Disposable<Promise<void>>;
   trace<T>(value: T): T;
   bind<T extends Function>(callback: T): T;
 }
-//#endregion
-//#region node_modules/.pnpm/cordis@4.0.0-rc.10/node_modules/cordis/lib/fiber.d.ts
-declare module './context' {
+declare module './context.ts' {
   interface Context extends Pick<Fiber, 'effect'> {
     fiber: Fiber;
   }
@@ -258,24 +273,28 @@ declare const enum FiberState {
 }
 declare class Fiber {
   parent: Context;
+  config: any;
   inject: Dict<any>;
   runtime: Plugin.Runtime | null;
   uid: number | null;
   readonly ctx: Context;
-  config: any;
   state: FiberState;
   readonly dispose: () => Promise<void>;
-  store: Dict<Impl> | undefined;
+  committed: Readonly<Dict<Impl>> | undefined;
+  readonly provisions: Set<Impl>;
   inertia: Promise<void> | undefined;
   readonly _hooks: Dict<DisposableList<Function>>;
   readonly _disposables: DisposableList<Disposable<any>>;
   protected context: Context;
   private _error;
+  private _revision;
   private _runner;
   private _store;
+  private _release;
   constructor(parent: Context, config: any, inject: Dict<any>, runtime: Plugin.Runtime | null, getOuterStack: () => string[]);
   get name(): string;
   assertActive(): void;
+  private _resolve;
   private _execute;
   effect(execute: () => SyncEffect, label?: string): Disposable<Promise<void>>;
   effect(execute: () => Effect, label?: string): AsyncDisposable<Promise<void>>;
@@ -291,24 +310,22 @@ declare class Fiber {
   restart(): Promise<void>;
   update(config: any, noSave?: boolean): Awaitable<void>;
 }
-//#endregion
-//#region node_modules/.pnpm/cordis@4.0.0-rc.10/node_modules/cordis/lib/events.d.ts
 type Parameters<F> = F extends ((...args: infer P) => any) ? P : never;
-type ReturnType$1<F> = F extends ((...args: any) => infer R) ? R : never;
+type ReturnType<F> = F extends ((...args: any) => infer R) ? R : never;
 type ThisType<F> = F extends ((this: infer T, ...args: any) => any) ? T : never;
 type DispatchMode = 'emit' | 'parallel' | 'serial' | 'bail' | 'waterfall';
-declare module './context' {
+declare module './context.ts' {
   interface Context {
     parallel<K extends keyof Events>(name: K, ...args: Parameters<Events[K]>): Promise<void>;
     parallel<K extends keyof Events>(thisArg: NoInfer<ThisType<Events[K]>>, name: K, ...args: Parameters<Events[K]>): Promise<void>;
     emit<K extends keyof Events>(name: K, ...args: Parameters<Events[K]>): void;
     emit<K extends keyof Events>(thisArg: NoInfer<ThisType<Events[K]>>, name: K, ...args: Parameters<Events[K]>): void;
-    serial<K extends keyof Events>(name: K, ...args: Parameters<Events[K]>): Promisify<ReturnType$1<Events[K]>>;
-    serial<K extends keyof Events>(thisArg: NoInfer<ThisType<Events[K]>>, name: K, ...args: Parameters<Events[K]>): Promisify<ReturnType$1<Events[K]>>;
-    bail<K extends keyof Events>(name: K, ...args: Parameters<Events[K]>): ReturnType$1<Events[K]>;
-    bail<K extends keyof Events>(thisArg: NoInfer<ThisType<Events[K]>>, name: K, ...args: Parameters<Events[K]>): ReturnType$1<Events[K]>;
-    waterfall<K extends keyof Events>(name: K, ...args: Parameters<Events[K]>): ReturnType$1<Events[K]>;
-    waterfall<K extends keyof Events>(thisArg: NoInfer<ThisType<Events[K]>>, name: K, ...args: Parameters<Events[K]>): ReturnType$1<Events[K]>;
+    serial<K extends keyof Events>(name: K, ...args: Parameters<Events[K]>): Promisify<ReturnType<Events[K]>>;
+    serial<K extends keyof Events>(thisArg: NoInfer<ThisType<Events[K]>>, name: K, ...args: Parameters<Events[K]>): Promisify<ReturnType<Events[K]>>;
+    bail<K extends keyof Events>(name: K, ...args: Parameters<Events[K]>): ReturnType<Events[K]>;
+    bail<K extends keyof Events>(thisArg: NoInfer<ThisType<Events[K]>>, name: K, ...args: Parameters<Events[K]>): ReturnType<Events[K]>;
+    waterfall<K extends keyof Events>(name: K, ...args: Parameters<Events[K]>): ReturnType<Events[K]>;
+    waterfall<K extends keyof Events>(thisArg: NoInfer<ThisType<Events[K]>>, name: K, ...args: Parameters<Events[K]>): ReturnType<Events[K]>;
     on<K extends keyof Events>(name: K, listener: Events[K], options?: boolean | EventOptions): () => boolean;
     once<K extends keyof Events>(name: K, listener: Events[K], options?: boolean | EventOptions): () => boolean;
   }
@@ -343,19 +360,14 @@ interface Events {
   'internal/plugin'(fiber: Fiber): void;
   'internal/status'(fiber: Fiber, oldValue: FiberState): void;
   'internal/service'(this: Context, name: string, value: any): void;
-  'internal/update'(this: Fiber, config: any, noSave: boolean, next: () => Awaitable<void>): Awaitable<void>;
+  'internal/update'(this: Fiber, resolvedConfig: any, next: () => Awaitable<void>): Awaitable<void>;
+  'internal/commit'(fiber: Fiber, originalConfig: any): void;
+  'internal/config'(fiber: Fiber, next: () => any): any;
   'internal/get'(ctx: Context, name: string, error: Error, next: () => any): any;
   'internal/set'(ctx: Context, name: string, value: any, error: Error, next: () => boolean): boolean;
   'internal/listener'(this: Context, name: string, listener: any, prepend: boolean): void;
   'internal/dispatch'(mode: DispatchMode, name: string | symbol, args: any[], thisArg: any): void;
 }
-//#endregion
-//#region node_modules/.pnpm/cordis@4.0.0-rc.10/node_modules/cordis/lib/logger.d.ts
-declare module './context' {
-  interface Intercept {
-    logger: LoggerService.Intercept;
-  }
-}
 type LoggerType = 'error' | 'info' | 'warn' | 'debug';
 type LoggerMethod = (format: any, ...param: any[]) => void;
 type Formatter = (value: any, exporter: Exporter, message: Message) => any;
@@ -400,6 +412,7 @@ interface LoggerService extends Record<LoggerType, LoggerMethod> {
   (name?: string): Logger;
 }
 declare class LoggerService {
+  [symbols.metadata]: LoggerService.Intercept;
   bufferSize: number;
   buffer: Message[];
   ctx: Context;
@@ -408,16 +421,12 @@ declare class LoggerService {
   exporters: Map<number, Exporter>;
   constructor(ctx: Context);
   exporter(exporter: Exporter): Disposable<Promise<void>>;
-  private _resolveConfig;
   [symbols.invoke](name?: string): Logger;
 }
-//#endregion
-//#region node_modules/.pnpm/cordis@4.0.0-rc.10/node_modules/cordis/lib/context.d.ts
 interface Context {
+  [symbols.root]: this;
   [symbols.isolate]: Dict<symbol>;
   [symbols.intercept]: Dict;
-  /** @experimental */
-  root: this;
   baseUrl?: string | undefined;
   events: EventsService;
   logger: LoggerService;
@@ -425,6 +434,7 @@ interface Context {
   registry: RegistryService;
 }
 declare class Context {
+  static readonly root: unique symbol;
   static readonly effect: unique symbol;
   static readonly filter: unique symbol;
   static readonly isolate: unique symbol;
@@ -434,101 +444,41 @@ declare class Context {
   extend(meta?: {}): this;
   isolate(name: string, label?: symbol): this;
   intercept<K extends InjectKey>(name: K, config: Context[K] extends {
-    [symbols.config]: infer T;
+    [symbols.metadata]: infer T;
   } ? T : never): this;
   intercept(name: string, config: any): this;
 }
-//#endregion
-//#region node_modules/.pnpm/cordis@4.0.0-rc.10/node_modules/cordis/lib/service.d.ts
-declare abstract class Service<out T = never> {
-  protected ctx: Context;
-  static readonly init: unique symbol;
-  static readonly check: unique symbol;
-  static readonly config: unique symbol;
-  static readonly invoke: unique symbol;
-  static readonly extend: unique symbol;
-  static readonly tracker: unique symbol;
-  static readonly resolveConfig: unique symbol;
-  [symbols.config]: T;
-  name: string;
-  constructor(ctx: Context, name: string);
-  protected [symbols.filter](ctx: Context): boolean;
-  protected [symbols.extend](props?: any): any;
-  [symbols.resolveConfig](base?: T, head?: T): T;
-  static [Symbol.hasInstance](instance: any): boolean;
-}
-//#endregion
-//#region src/config.d.ts
 /**
- * dsh-manage-session 的共享配置面（合并包：管家子域 + 搜索索引子域）。
+ * dsh-manage-session 的共享配置面（会话管理器：归档 + 体检）。
  *
  * 与 host 半身（schemastery schema 在 src/index.ts）以及浏览器半身共用同一形状，
  * 使一处 admitted 的值在另一处也 admitted。
  *
- * 两个设置命名空间**并存且互不迁移**：
- * - `session-steward` —— 管家子域（enabled/historyFiles/healthCheck/search 等共享键）；
- * - `switch-search` —— 搜索子域的历史命名空间，存储键承诺保持稳定（见
- *   dsh-search-index README「存储键保持稳定，不做迁移」）；0.1.7 起两者实际
- *   都落在同一 composition entry（configForms），旧宿主才按命名空间分流。
+ * 设置命名空间只有一个：`manage-session`（enabled/historyFiles/healthCheck/directDelete）。
+ * 搜索/索引子域已拆回 dsh-search-index，本包不再持有 `search` 开关、索引目录、
+ * 语料源（DRS）等字段——DRS 依赖也随搜索一起迁回那边。
  */
-/** 会话管家运行时配置（设置命名空间 + 组合入口）。 */
+/** 会话管理运行时配置（设置命名空间 + 组合入口）。 */
 interface StewardConfig {
-  /** 插件总开关（合并包唯一 master：关闭后不注册任何子域路由）。 */
+  /** 插件总开关（关闭后不注册任何子域路由）。 */
   enabled: boolean;
-  /** 会话历史文件（归档浏览与清理）。关闭后不注册 history 路由、不渲染「养老院」页签。 */
+  /** 会话历史文件（归档浏览与清理）。关闭后不注册 history 路由。 */
   historyFiles?: boolean;
   /** 会话健康检查（体检 → 处方 → 出院）。关闭后不注册 health 路由、不渲染「体检」页签。 */
   healthCheck?: boolean;
-  /** 搜索索引子域（`index-*` 路由与侧栏搜索入口）。关闭后索引子域整体停摆。 */
-  search?: boolean;
   /**
-   * 直接删除入口（2026-10-20 用户定标）：开启后搜索面板结果行出现行内
-   * 「删除」按钮（两步确认,走管理端同款 session-history-purge 链路）。
-   * **缺省关**——破坏性入口不默认铺开;管理端批量删除不受本开关限制。
+   * 直接删除入口（2026-10-20 用户定标）：开启后侧栏会话菜单出现「删除」行
+   * （两步确认，走管理端同款 session-history-purge 链路）。
+   * **缺省关**——破坏性入口不默认铺开；管理端批量删除不受本开关限制。
    */
   directDelete?: boolean;
 }
 /** 缺省值。 */
 declare const DEFAULT_CONFIG: Required<StewardConfig>;
 /** host 半身注册的设置命名空间（与 src/index.ts 保持一致）。 */
-declare const STEWARD_SETTINGS_NAMESPACE = "session-steward";
-/** host 路由前缀（管家子域；与搜索子域的 /switch-search/api 互不干扰）。 */
-declare const STEWARD_API_PREFIX = "/session-steward/api";
-/** 搜索子域路由前缀（历史值，浏览器旧 bundle 与快照文件名依赖它，保持不变）。 */
-declare const SWITCH_API_PREFIX = "/switch-search/api";
-/** 搜索面板打开时的默认模式。 */
-type SwitchSearchDefaultMode = 'title' | 'content';
-/** 搜索子域可调配置（独立于 StewardConfig 的历史形状，字段名保持稳定）。 */
-interface SwitchSearchConfig {
-  /**
-   * 搜索卡上的「启用」开关。合并包里它与管家 `enabled` 是**同一个**组合入口
-   * 字段（0.1.7 configForms 单 scope）；保留在此处是为了 legacy settingsScope
-   * 回退路径（旧 switch-search 命名空间的存储形状）与设置卡类型不变。
-   */
-  enabled?: boolean;
-  /** 面板默认模式。 */
-  defaultMode: SwitchSearchDefaultMode;
-  /** 独立索引是否后台自动同步（水位轮询）。 */
-  autoSync?: boolean;
-  /** 增量同步间隔（ms）。 */
-  syncIntervalMs?: number;
-  /** 整理索引后保留的归档份数。 */
-  archiveKeep?: number;
-  /** 独立索引文件的可选绝对目录。 */
-  indexDir?: string;
-  /**
-   * 语料源(T7.1):`'native'`=sessionQuery 服务 + 转录文件兜底(缺省);
-   * `'drs'`=dsh-reference-session-collector 投影库(docs 直插;DRS 不可达时整轮
-   * 回退 native 链路,水位语义切换的首轮会全量重灌一次)。
-   */
-  corpusSource?: 'native' | 'drs';
-  /** DRS 投影库 API 基址;空=自动(首个 trustedHosts 条目,再退 http://127.0.0.1:8080)。 */
-  drsBaseUrl?: string;
-}
-/** 搜索子域缺省值。 */
-declare const SWITCH_DEFAULT_CONFIG: Required<SwitchSearchConfig>;
-//#endregion
-//#region src/host/history/archive-source.d.ts
+declare const STEWARD_SETTINGS_NAMESPACE = "manage-session";
+/** host 路由前缀（管理 + 体检，方法名一律 `session-*`）。 */
+declare const STEWARD_API_PREFIX = "/manage-session/api";
 /** 一次归档读取的结果：ids 以及服务它的来源。 */
 interface StewardArchiveRead {
   ids: readonly string[];
@@ -611,8 +561,6 @@ declare function archiveArchiveFile(ids: readonly string[], log?: (msg: string)
   total: number;
   file?: string;
 };
-//#endregion
-//#region src/host/settings-bridge.d.ts
 /** 桥对 handleMethod 暴露的面。 */
 interface LegacySettingsBridge {
   /** 读一个命名空间文档（无文档/非对象 → undefined）。 */
@@ -625,8 +573,6 @@ interface BridgeState {
   bridge: LegacySettingsBridge | undefined;
   revision: number;
 }
-//#endregion
-//#region src/host/health/decode.d.ts
 /** 一次读取的统计与问题清单。 */
 interface SessionLogRead {
   events: DecodedEvent[];
@@ -693,8 +639,6 @@ interface OfficialDecoders {
 declare function decodeSessionLogBytes(file: string, bytes: Buffer, decoders?: OfficialDecoders): SessionLogRead;
 /** 从文件读取并解码。 */
 declare function decodeSessionLogFile(file: string, decoders?: OfficialDecoders): SessionLogRead;
-//#endregion
-//#region src/host/health/generation.d.ts
 /** 日志的物理编码（对齐宿主的 `JsonlCompression`）。 */
 type LogCompression = 'zstd' | 'none';
 /** 处置优先级：`high` = 该会话的当前代是从暂存（TMP）发布出来的。 */
@@ -783,8 +727,6 @@ declare function latestArtifactMtime(facts: SessionGenerations): number | undefi
  * @returns 处置优先级。
  */
 declare function sessionPriority(facts: SessionGenerations): SessionPriority;
-//#endregion
-//#region src/host/health/gates.d.ts
 /**
  * gate 严重级。
  *
@@ -906,8 +848,6 @@ declare function gateLosslessJson(projectionState: Record<string, unknown> | und
 declare function gateColdRead(facts: TailFacts): GateResult;
 /** 聚合全部 gate 结果为一份报告。 */
 declare function buildSessionReport(context: GateContext): SessionHealthReport;
-//#endregion
-//#region src/host/health/cache.d.ts
 /** 一份已成型的缓存。 */
 interface HealthCacheEntry {
   /** 非 ok 的会话报告（与 `onlyProblems: true` 的扫描结果同构）。 */
@@ -948,692 +888,6 @@ declare class HealthCache {
   /** 丢弃缓存与未完成的累积。 */
   clear(): void;
 }
-//#endregion
-//#region src/host/index/schema.d.ts
-/**
- * Which SQLite driver served the handle (better-sqlite3 when the optional
- * dependency installed, node:sqlite otherwise). Surfaced in logs and
- * index-status so rebuild speed can be compared across drivers.
- */
-type SwitchSqliteDriver = 'better-sqlite3' | 'node:sqlite';
-//#endregion
-//#region src/host/index/extract.d.ts
-/**
- * First-party semantic text extraction for the independent switch-search index.
- *
- * Semantics mirror the official session-query `extractSessionEventText` and the
- * core-session surface fold, mirrored structurally: the plugin must not
- * value-import official packages, so the event data is inspected as plain
- * records. Structural boundaries, embedded raw streams, request envelopes, and
- * unknown declaration-merged events contribute no text.
- */
-/** One raw session event the plugin reads through sessionQuery.readSession. */
-interface SwitchRawEvent {
-  seq: number;
-  type: string;
-  time?: number;
-  ignorable?: boolean;
-  surfaceOp?: unknown;
-  data: unknown;
-}
-/**
- * 从会话事件流里抽出**最后一帧标题**（`session/title` log-only 事件）。
- *
- * 这是标题的基础层：入索引时随事件白拿，不依赖 readTitleSnapshots（后者
- * 对归档 id 可能整批失败——beta.4 标题全军覆没的根因）。数据形状按历史
- * 演变兼容三种：`{ title: string }`、`{ title: { title } }`、`{ title: { val } }`。
- */
-declare function extractTitleFromEvents(events: readonly SwitchRawEvent[]): string;
-//#endregion
-//#region src/host/index/engine.d.ts
-/** One indexed session header row. */
-interface SwitchIndexedSession {
-  sessionId: string;
-  version: number;
-  title: string;
-  cwd: string;
-  updatedAt: number;
-  indexedAt: number;
-  archived: boolean;
-}
-/** One session-grouped search hit. */
-interface SwitchSearchHit {
-  sessionId: string;
-  title: string;
-  seq: number;
-  type: string;
-  /** Timestamp of the strongest matching document. Per-hit, not per-session. */
-  time: number;
-  /**
-   * Session-level last-activity timestamp. Distinct from `time`: a session
-   * may hold an old best match yet have moved one minute ago. This is the
-   * field recency ordering and any client-side re-sort must key on.
-   */
-  updatedAt: number;
-  snippet: string;
-}
-/**
- * Result ordering for one search.
- * - `relevance` (default) — weighted BM25, the historical behaviour.
- * - `time` — session recency first, relevance as the tie-break.
- */
-type SwitchSearchSort = 'relevance' | 'time';
-/** Coarse type-filter buckets mapped onto raw session event types. */
-type SwitchIndexContentType = 'all' | 'user' | 'reply' | 'tool';
-/** Constructor options for one engine instance. */
-interface SwitchIndexEngineOptions {
-  /** Absolute path of the index file this engine owns. */
-  path: string;
-}
-/** One open index handle. All mutating calls are synchronous; callers pace
- * them off the HTTP hot path (background sync / rebuild tasks). */
-declare class SwitchIndexEngine {
-  private readonly options;
-  private db;
-  private driver;
-  private inBatch;
-  constructor(options: SwitchIndexEngineOptions);
-  /** Which SQLite driver is serving this handle. */
-  get driverLabel(): SwitchSqliteDriver;
-  /**
-   * Run one write inside the current batched transaction, or its own
-   * IMMEDIATE transaction when not batching (nested calls join the batch).
-   */
-  withWriteTx<T>(fn: () => T): T;
-  /**
-   * Run one function as a single batched transaction (one fsync checkpoint):
-   * upserts inside it join via withWriteTx instead of opening their own.
-   */
-  runBatched<T>(fn: () => T): T;
-  /** Whether the handle is open. */
-  get isOpen(): boolean;
-  /** Open (creating or migrating) the index file. Idempotent. */
-  open(): Promise<void>;
-  /** Close the handle. Idempotent. */
-  close(): void;
-  /** Remove one session's FTS entries for external-content bookkeeping. */
-  private deleteSessionFts;
-  /** Insert or replace one session's documents and header row. */
-  upsertSession(input: {
-    sessionId: string;
-    version: number;
-    title?: string;
-    cwd?: string;
-    updatedAt?: number;
-    events: readonly SwitchRawEvent[];
-    /**
-     * 归档标记。缺省时**保留行上现有值**（归档态翻转由 setArchived 单独负责，
-     * 全量重灌不改变归档状态）；显式传入时以传入值为准（重建/导入路径）。
-     */
-    archived?: boolean;
-  }): number;
-  /**
-   * 该会话是否已有正文（issue #1:hollow 行判据）。
-   * LIMIT 1 探测命中 docs_session 索引,每轮 poll 对每个未变更会话的开销可忽略。
-   */
-  hasSessionDocs(sessionId: string): boolean;
-  /**
-   * 「有表头无正文」的会话 id（升序）—— hollow 体检面。补录后仍 hollow 的行
-   * 包含无可索引文本的真空会话（合法终态,见 sync 的 confirmedEmpty 缓存）。
-   */
-  listHollowSessions(): string[];
-  /**
-   * `PRAGMA integrity_check` 首行：'ok' 或损坏报告串。swap 后完整性闸门用。
-   */
-  integrityCheck(): string;
-  /**
-   * Write an archived session's header row without any document content.
-   *
-   * @deprecated 旧"归档即软删"语义的遗物,合并包 R1 已改为归档保留 docs;仅剩
-   * 旧快照兼容路径可落 header 行。新代码一律 upsertSession + setArchived。
-   */
-  upsertArchivedHeader(input: {
-    sessionId: string;
-    version: number;
-    title?: string;
-    cwd?: string;
-    updatedAt?: number;
-  }): void;
-  /**
-   * Apply the official archive set: flip the archived flag both ways.
-   *
-   * 合表复用语义（R1）：归档**保留全部 docs 与 FTS**——正文在归档态不可变
-   * （归档门只拒新回合），翻转只是检索域成员资格的变化；恢复也不再需要重灌
-   * （旧实现的 version = -1 强制重读随"归档即删 docs"一并废除）。
-   */
-  setArchived(archivedIds: ReadonlySet<string>): void;
-  /**
-   * Flip one session's archived flag (steward write-side linkage). No-op when
-   * the row does not exist — flag state on an unindexed session is meaningless.
-   */
-  setArchivedOne(sessionId: string, archived: boolean): void;
-  /** One session's stored documents, ascending seq (snapshot export face). */
-  exportSessionDocs(sessionId: string): {
-    seq: number;
-    type: string;
-    surface: string;
-    time: number;
-    text: string;
-  }[];
-  /**
-   * Insert or replace one session from already-extracted documents
-   * (snapshot import face; no re-extraction, what was exported is restored;
-   * segmentation is recomputed for the current index format).
-   */
-  importSessionDocs(input: {
-    sessionId: string;
-    version: number;
-    title?: string;
-    /** 归档标记随快照往返；旧快照缺省为活跃。 */
-    archived?: boolean;
-    docs: readonly {
-      seq: number;
-      type: string;
-      surface: string;
-      time: number;
-      text: string;
-    }[];
-  }): void;
-  /**
-   * Insert or replace one session from corpus-source documents (T7.1 DRS
-   * 语料源):docs 已由语料源抽好(surface 字符串),切分仍由本引擎重算。
-   * 与 importSessionDocs 的三点差异,均为检索排序/水印所需:cwd 与
-   * updated_at 直写(日期过滤/时间排序键);标题空串保留旧行(upsertSession
-   * 同款 CASE——DRS 对老会话可能给不出标题,不能抹掉既有精修);归档旗标
-   * 冲突时不动(翻转仍归 setArchived)。
-   * @returns 落库 docs 数(0 = 该会话无可索引文本,合法终态)。
-   */
-  upsertSessionDocs(input: {
-    sessionId: string;
-    version: number;
-    title?: string;
-    cwd?: string;
-    updatedAt?: number;
-    archived?: boolean;
-    docs: readonly {
-      seq: number;
-      type: string;
-      surface: string;
-      time: number;
-      text: string;
-    }[];
-  }): number;
-  /**
-   * 会话头直写（DRS 直连时代的同步轮专用，T7.3）：只维护 sessions 元数据
-   * （水位/标题/目录/末时间/归档），**不碰 docs/docs_fts**——内容检索
-   * 已直连 dsh-reference-session-collector（op=search&group=session），本地正文索引
-   * 退役，存量 docs 行自然老化不再新增。空标题保留旧行（同 upsertSessionDocs）。
-   */
-  upsertSessionHead(input: {
-    sessionId: string;
-    version: number;
-    title?: string;
-    cwd?: string;
-    updatedAt?: number;
-    archived?: boolean;
-  }): void;
-  /** Remove one session and its documents entirely. */
-  removeSession(sessionId: string): void;
-  /** Update only a session's header row (title backfill), keeping documents. */
-  updateSessionHeader(input: {
-    sessionId: string;
-    title?: string;
-    cwd?: string;
-    updatedAt?: number;
-  }): void;
-  /** One indexed session row, or undefined. */
-  getSession(sessionId: string): SwitchIndexedSession | undefined;
-  /** All indexed sessions (active AND archived), newest first — the title
-   * corpus and the manage console both read this; the `archived` flag rides
-   * each row so clients filter locally. */
-  listIndexedSessions(): SwitchIndexedSession[];
-  /** Archived (soft-deleted) sessions, newest first — the archive viewer face. */
-  listArchived(): SwitchIndexedSession[];
-  /** Number of indexed sessions (active + archived — the whole corpus). */
-  countSessions(): number;
-  /** Number of archived (soft-deleted) sessions. */
-  countArchived(): number;
-  /**
-   * Run one session-grouped full-text search.
-   *
-   * One statement: the FTS match is bounded by rank in a subquery (its rowid
-   * aligns with docs.doc_id), then the type/surface filters join in — no
-   * second round-trip, no large IN parameter lists.
-   * @param request - query text, coarse type filter, page size, ordering.
-   * @returns hits ordered by `sortBy` (relevance by default).
-   */
-  search(request: {
-    query: string;
-    types?: readonly SwitchIndexContentType[];
-    limit?: number;
-    sortBy?: SwitchSearchSort;
-    /**
-     * 检索域：`'active'` 仅活跃、`'archived'` 仅归档、`'all'`（缺省）两者。
-     * 归档正文入索引后的筛选 chip 即此参数。
-     */
-    archived?: 'active' | 'archived' | 'all';
-    /** 更新时间下界（epoch ms,含）。 */
-    from?: number;
-    /** 更新时间上界（epoch ms,排他）。 */
-    to?: number;
-  }): SwitchSearchHit[];
-  private requireDb;
-}
-//#endregion
-//#region src/host/index/sync.d.ts
-/** The sessionQuery faces the sync reads (structural mirrors). */
-interface SwitchSyncSessionQuery {
-  listSessions(): Promise<readonly {
-    header: {
-      id: string;
-      version: number;
-      createdAt?: number;
-      cwd?: string;
-    };
-  }[]>;
-  readSession(sessionId: string): Promise<{
-    session: {
-      id: string;
-      version: number;
-      createdAt?: number;
-      cwd?: string;
-    };
-    events: readonly SwitchRawEvent[];
-  }>;
-  readTitleSnapshots?(sessionIds: readonly string[]): Promise<readonly {
-    status: 'fulfilled' | 'rejected';
-    value?: {
-      session: {
-        id: string;
-      };
-      title?: {
-        title: string;
-      };
-    };
-  }[]>;
-}
-/** Live sync progress reported to the status endpoint. */
-interface SwitchSyncState {
-  /** What the syncer is doing right now. */
-  state: 'idle' | 'syncing' | 'error';
-  /** Epoch ms of the last completed pass. */
-  lastSyncAt: number;
-  /** Sessions currently in the index. */
-  indexed: number;
-  /** Sessions seen in the corpus at the last pass. */
-  total: number;
-  /** Sessions re-read in the last pass. */
-  updated: number;
-  /** Per-session failures from the last pass. */
-  failures: {
-    sessionId: string;
-    error: string;
-  }[];
-  /** 补录后仍「有表头无正文」的行数（hollow 体检面,含合法真空会话）。 */
-  hollow: number;
-  /** Last pass error (whole-pass abort), if any. */
-  error?: string;
-}
-/**
- * The official archive-set face (workspaceRegistry mirror): read-only.
- * Resolved lazily per pass — the registry may mount after this plugin.
- */
-interface SwitchArchiveSource {
-  readonly archivedSessionIds: readonly string[];
-}
-/** DRS 语料头(依赖倒置端口;真身 = drs-source.ts 的 DrsCorpusSource)。 */
-interface SwitchDrsCorpusHead {
-  sessionId: string;
-  /** 水位代理 = DRS sessions.artifact_mtime_ms(日志重写必 bump)。 */
-  version: number;
-  title: string;
-  cwd: string;
-  updatedAt: number;
-  archived: boolean;
-}
-/** DRS 检索臂文档(surface 已折算引擎字符串域;切分由引擎重算)。 */
-interface SwitchDrsCorpusDoc {
-  seq: number;
-  type: string;
-  surface: string;
-  time: number;
-  text: string;
-}
-/**
- * DRS 语料源端口(T7.1):corpusSource='drs' 时语料改从
- * dsh-reference-session-collector 投影库取,docs 直插引擎;不可达时整轮回退原生
- * sessionQuery + 文件兜底链路。单测注入普通对象。
- */
-interface SwitchDrsCorpusSource {
-  listSessions(): Promise<readonly SwitchDrsCorpusHead[]>;
-  readSession(sessionId: string): Promise<{
-    head: SwitchDrsCorpusHead;
-    docs: readonly SwitchDrsCorpusDoc[];
-  } | undefined>;
-}
-/**
- * One watermark syncer bound to one open engine. `poll()` is re-entrant-safe:
- * overlapping calls collapse into the running pass.
- */
-declare class SwitchWatermarkSync {
-  private readonly engine;
-  private readonly sessionQuery;
-  private readonly readArchiveSource?;
-  private readonly log?;
-  private readonly readSessionFromFile?;
-  /**
-   * 第三标题源（可选）:官方投影缓存里的 title 行。事件流没有 session/title
-   * 的老会话,快照服务又整片不可用时,这是最后兜底。
-   */
-  private readonly readProjectionTitle?;
-  /**
-   * DRS 语料源（可选,T7.1）:提供时每轮先走 DRS 轮(docs 直插);DRS 整轮
-   * 失败（网络/路由/包络）自动回退原生 sessionQuery + 文件兜底。
-   */
-  private readonly drsSource?;
-  private running;
-  /**
-   * 本进程已确认「重读过且产出仍为 0 docs」的会话（键 id@version）。
-   * 无可索引文本是合法终态——没有这份缓存,hollow 补录判据会把真空会话
-   * 每轮完整重读一次（热循环）。宿主重启后缓存归零,最多各重读一次。
-   */
-  private readonly confirmedEmpty;
-  private static emptyKey;
-  private readonly state;
-  /**
-   * @param readSessionFromFile - 可选的**文件级兜底读取器**（管家 health 侧的
-   * 多帧 zstd 读取器）：sessionQuery.readSession 对某些会话（典型:归档会话,
-   * 或服务面退化）失败时改读转录文件。返回 undefined 表示文件也不可用。
-   */
-  constructor(engine: SwitchIndexEngine, sessionQuery: SwitchSyncSessionQuery, readArchiveSource?: (() => SwitchArchiveSource | undefined) | undefined, log?: ((msg: string) => void) | undefined, readSessionFromFile?: ((sessionId: string) => Promise<{
-    session: {
-      id: string;
-      version: number;
-      createdAt?: number;
-      cwd?: string;
-    };
-    events: readonly SwitchRawEvent[];
-  } | undefined>) | undefined,
-  /**
-   * 第三标题源（可选）:官方投影缓存里的 title 行。事件流没有 session/title
-   * 的老会话,快照服务又整片不可用时,这是最后兜底。
-   */
-  readProjectionTitle?: ((sessionId: string) => string) | undefined,
-  /**
-   * DRS 语料源（可选,T7.1）:提供时每轮先走 DRS 轮(docs 直插);DRS 整轮
-   * 失败（网络/路由/包络）自动回退原生 sessionQuery + 文件兜底。
-   */
-  drsSource?: SwitchDrsCorpusSource | undefined);
-  /**
-   * 读取一个会话的日志:服务面优先,失败落文件兜底。两条路都失败时抛最后
-   * 一个错误,由调用方按会话隔离记失败。
-   */
-  private readSessionLog;
-  /** Current progress snapshot (cloned). */
-  snapshot(): SwitchSyncState;
-  /**
-   * Fold titles for an explicit id set without running a full pass.
-   *
-   * Used by the `session/title` event listener so a rename lands immediately
-   * rather than at the next poll. It deliberately leaves watermarks alone: a
-   * title-only refresh can never make the index claim content it has not read,
-   * and the next poll still re-ingests the session off its bumped version.
-   * Safe for unknown ids — the header write is a no-op when no row exists.
-   * @param sessionIds - sessions whose titles should be re-folded.
-   */
-  refreshTitles(sessionIds: readonly string[]): Promise<void>;
-  /**
-   * Run one incremental pass (or await the running one).
-   * @returns the state after the pass completes.
-   */
-  poll(): Promise<SwitchSyncState>;
-  private runPass;
-  /**
-   * DRS 语料轮(T7.1):语料头从 DRS `op=sessions` 分页拉取,水位
-   * diff(version=artifact_mtime_ms)后按会话 `op=session&fields=search`
-   * 取检索臂 docs 直插引擎(upsertSessionDocs)。归档集合改用 DRS 行的
-   * archived 旗标(DRS sync 本就只读跟随 workspace.json,同源);标题直接
-   * 采 DRS 行(投影侧同一 extractTitleFromEvents 视界),不再走快照精修。
-   * 每会话失败隔离语义与原生轮一致;无可索引文本仍进 confirmedEmpty 缓存。
-   */
-  private runDrsPass;
-  /**
-   * Fold latest titles for changed sessions into the index header rows.
-   *
-   * beta.4 教训:整批一次调用,任何一个坏 id（典型:归档 id）让整个 promise
-   * reject,catch 一吞就是**全部**标题丢失。改为分块 + 块失败时逐 id 重试 ——
-   * 单点坏 id 最多损失它自己的精修标题（入索引时的 extractTitleFromEvents
-   * 基础层仍然在）。
-   */
-  private backfillTitles;
-}
-//#endregion
-//#region src/host/index/archive-source.d.ts
-/** One resolved archive read: ids plus which source served them. */
-interface SwitchArchiveRead {
-  ids: readonly string[];
-  source: 'registry' | 'storage-file' | 'none';
-}
-/** The workspaceRegistry mirror face (getter only). */
-interface SwitchRegistryFace {
-  readonly archivedSessionIds: readonly string[];
-}
-/** Diagnostics describing how the archive set is being resolved. */
-interface SwitchArchiveDiagnostics {
-  source: 'registry' | 'storage-file' | 'none';
-  ids: number;
-  error?: string;
-}
-/** Build the lazy source face the syncer expects, with diagnostics capture. */
-declare function createArchiveSource(getRegistry: () => SwitchRegistryFace | undefined): {
-  read: () => SwitchArchiveRead;
-  diagnostics: () => SwitchArchiveDiagnostics;
-};
-//#endregion
-//#region src/host/index/drs-source.d.ts
-/** 一个 DRS 会话头(watermark 代理 + 检索排序字段)。 */
-interface DrsCorpusHead {
-  sessionId: string;
-  version: number;
-  title: string;
-  cwd: string;
-  updatedAt: number;
-  archived: boolean;
-}
-/** 一个 DRS 检索臂文档(surface 已折算成引擎列的字符串域)。 */
-interface DrsCorpusDoc {
-  seq: number;
-  type: string;
-  surface: 'current' | 'shadowed';
-  time: number;
-  text: string;
-}
-/** 一个 DRS 会话的完整语料(头 + docs)。 */
-interface DrsCorpusSession {
-  head: DrsCorpusHead;
-  docs: DrsCorpusDoc[];
-}
-interface DrsCorpusSourceOptions {
-  /** DRS API 基址(http://host[:port];解析序见 resolveDrsBaseUrl)。 */
-  baseUrl: string;
-  /** 注入面(单测);缺省全局 fetch。 */
-  fetchImpl?: typeof fetch;
-  /** 显式 Host 头(trustedHosts 首条回显;缺省不覆盖)。 */
-  hostHeader?: string;
-  log?: (message: string) => void;
-}
-declare class DrsCorpusSource {
-  private readonly options;
-  private readonly fetchImpl;
-  constructor(options: DrsCorpusSourceOptions);
-  /** 一个 GET 的 JSON 包络(ok!==true 或非 2xx 一律抛,由调用方回退 native)。 */
-  private getJson;
-  private static headOf;
-  /** 全量语料头(内部翻页;rows 空或凑满 total 即止)。 */
-  listSessions(): Promise<DrsCorpusHead[]>;
-  /** 一个会话的检索臂 docs；DRS 无此会话（session:null）返回 undefined。 */
-  readSession(sessionId: string): Promise<DrsCorpusSession | undefined>;
-  /**
-   * 分组内容搜索直连臂（op=search&group=session，DRS surface.searchGrouped 同构）：
-   * 会话分组/加权/过滤/锚定节选全部在 DRS 侧完成，本方法只搬 wire →
-   * 引擎命中形状（SwitchSearchHit 字段同名）。失败（网络/非 2xx/包络）直抛，
-   * 调用侧按硬依赖语义显式报错——**不回退本地索引**。
-   */
-  searchGrouped(request: {
-    query: string;
-    /** 原事件 type 列表（调用方展开粗类）；空=DRS 缺省 user+assistant。 */
-    kinds?: readonly string[];
-    archived?: 'active' | 'archived' | 'all';
-    from?: number;
-    to?: number;
-    sortBy?: 'relevance' | 'time';
-    limit?: number;
-    /** 命中展开（wire `expand=1`）：同会话多命中各自成行；缺省聚合。 */
-    expand?: boolean;
-    /** 同源 Host 覆盖（转发调用方请求头；优先于装配 baseUrl）。 */
-    atHost?: string;
-  }): Promise<{
-    sessionId: string;
-    title: string;
-    seq: number;
-    type: string;
-    time: number;
-    updatedAt: number;
-    snippet: string;
-  }[]>;
-  /** 可性探针（op=status）：硬依赖预检/降级提示用；失败返回 false。 */
-  probe(atHost?: string): Promise<boolean>;
-}
-//#endregion
-//#region src/host/index/rebuild.d.ts
-/** The corpus reader a rebuild needs (same faces as the syncer). */
-interface SwitchRebuildSessionQuery {
-  listSessions(): Promise<readonly {
-    header: {
-      id: string;
-      version: number;
-      createdAt?: number;
-      cwd?: string;
-    };
-  }[]>;
-  readSession(sessionId: string): Promise<{
-    session: {
-      id: string;
-      version: number;
-      createdAt?: number;
-      cwd?: string;
-    };
-    events: readonly SwitchRawEvent[];
-  }>;
-}
-/** Live rebuild progress reported to the status endpoint. */
-interface SwitchRebuildState {
-  state: 'idle' | 'building' | 'swapping' | 'error';
-  /** Sessions written into the shadow index so far. */
-  done: number;
-  /** Sessions seen in the corpus when the build started. */
-  total: number;
-  /** Epoch ms when the build started. */
-  startedAt: number;
-  /** Epoch ms when the last build finished. */
-  finishedAt: number;
-  /** Per-session failures during the last build. */
-  failures: {
-    sessionId: string;
-    error: string;
-  }[];
-  error?: string;
-}
-/** Filesystem layout of one index directory. */
-interface SwitchIndexLayout {
-  /** Directory holding every index file. */
-  dir: string;
-  /** Active index file name. */
-  active: string;
-  /** Shadow file name used while building. */
-  building: string;
-  /** Archive file name prefix. */
-  archivePrefix: string;
-}
-/** Default layout names. */
-declare const DEFAULT_INDEX_LAYOUT: SwitchIndexLayout;
-/**
- * Inspect the index directory for half-built leftovers from an abnormally
- * terminated rebuild and recover:
- * - shadow present + active present: the build never finished — the shadow
- *   is garbage (the active index kept serving) and is discarded.
- * - shadow present + active missing: the crash hit the rename window — the
- *   newest archive is restored as the active index, the shadow discarded.
- * Runs at host activation, before the engine opens (opening would create a
- * fresh empty active file and mask the swap-window case).
- */
-declare function recoverIndex(layout: SwitchIndexLayout, log?: (msg: string) => void): Promise<string[]>;
-/**
- * Build a fresh index into the shadow file, then swap it in atomically.
- *
- * During the build the caller's active engine stays open and queryable; only
- * the final swap briefly reopens the handle.
- * @param activeEngine - the currently-serving engine (its file is replaced).
- * @param layout - filesystem layout of the index directory.
- * @param sessionQuery - corpus reader for the full rebuild.
- * @param keepArchives - how many archive files to retain (oldest pruned).
- * @param onProgress - optional progress callback after each session.
- * @returns the rebuild state snapshot after completion.
- */
-/** Optional observability callbacks for rebuildIndex. */
-interface SwitchRebuildHooks {
-  /** Progress log line sink (cordis logger bridge). */
-  log?: (msg: string) => void;
-  /** State-mutation sink: called after every change so index-status sees
-   * live progress (the "0/?" bug was state cloned only at completion). */
-  onState?: (state: SwitchRebuildState) => void;
-  /**
-   * 文件级兜底读取器（与同步器同语义）：readSession 对归档/服务面退化会话
-   * 失败时改读转录文件；返回 undefined 表示文件也不可用（记失败）。
-   */
-  readSessionFromFile?: (sessionId: string) => Promise<{
-    session: {
-      id: string;
-      version: number;
-      createdAt?: number;
-      cwd?: string;
-    };
-    events: readonly SwitchRawEvent[];
-  } | undefined>;
-}
-/**
- * The swap window: synchronous renames only; queries fail only inside it.
- *
- * issue #1 评论的损坏根因：只搬主文件时,旧库残留的 -wal/-shm 会被同名顶替
- * 的新库当自己的 WAL 重放,页号错配 → malformed。因此 sidecar 必须随主文件
- * 一并迁 archive（干净 close 本会 checkpoint 自删,这里是异常关闭的兜底）。
- * swap 后跑 integrity_check：非 ok 则把损坏库改名 .corrupt、从刚落的 archive
- * 回滚重开,并抛错让调用方置 error（把「索引损坏」降级为「回到上次快照」）。
- * 导出供测试直接驱动 swap 窗口（多连接场景在 Windows 上 rename 必 EBUSY,
- * 无法经 rebuildIndex 全链路确定性复现）。
- */
-declare function swapShadowIntoActive(activeEngine: SwitchIndexEngine, layout: SwitchIndexLayout, log?: (msg: string) => void): Promise<void>;
-declare function rebuildIndex(activeEngine: SwitchIndexEngine, layout: SwitchIndexLayout, sessionQuery: SwitchRebuildSessionQuery, keepArchives: number, onProgress?: (done: number, total: number) => void, archiveSource?: () => SwitchArchiveSource | undefined, hooks?: SwitchRebuildHooks): Promise<SwitchRebuildState>;
-/** One doc-level record the snapshot importer feeds in. */
-interface SwitchImportRecord {
-  sessionId: string;
-  version: number;
-  title?: string;
-  /** 归档标记（旧快照缺省活跃）。 */
-  archived?: boolean;
-  docs: readonly {
-    seq: number;
-    type: string;
-    surface: string;
-    time: number;
-    text: string;
-  }[];
-}
-/** Import doc-level records into the shadow file and swap it in (same swap path).
- * @param log - 可选日志汇（空 docs 记录告警,issue #1 写入侧可观测）。 */
-declare function importIntoIndex(activeEngine: SwitchIndexEngine, layout: SwitchIndexLayout, records: readonly SwitchImportRecord[], keepArchives: number, log?: (msg: string) => void): Promise<SwitchRebuildState>;
-//#endregion
-//#region src/host/history/archive.d.ts
 /** 一行历史文件条目（尽力而为的元数据 + 磁盘占用）。 */
 interface StewardHistoryRow {
   sessionId: string;
@@ -1720,8 +974,6 @@ interface StewardHistoryArchiveResult {
  * @param searchPaths - 可选候选路径覆盖（测试注入用）。
  */
 declare function archiveHistory(payload: unknown, log?: (msg: string) => void, searchPaths?: readonly string[]): StewardHistoryArchiveResult;
-//#endregion
-//#region src/host/history/purge.d.ts
 /** 一个归档会话在磁盘上的实体与占用。 */
 interface StewardSessionUsage {
   sessionId: string;
@@ -1823,8 +1075,6 @@ interface StewardPurgeOptions {
  * @returns 清理条数、释放字节数与逐条失败。
  */
 declare function purgeHistory(payload: unknown, log?: (msg: string) => void, options?: StewardPurgeOptions): StewardHistoryPurgeResult;
-//#endregion
-//#region src/host/health/source-kind.d.ts
 /** v4 线起点的宿主版本（会话格式 v4 引入 producer-owned source kind）。 */
 declare const V4_HOST_MIN = "0.1.7-rc.1";
 /** 一份日志里的旧署名事实。 */
@@ -1905,8 +1155,6 @@ declare function migrateLegacySource(source: unknown): Record<string, unknown> |
 declare function migrateSessionSourceKind(sessionId: string, logPath: string, log: SessionLogRead, dshHome?: string, now?: () => number): SourceKindMigrationOutcome;
 /** 备份文件的后缀约定（purge/清理工具可据此识别并一并处置）。 */
 declare const SOURCE_MIGRATE_BACKUP_SUFFIX = ".pre-sourcemigrate-";
-//#endregion
-//#region src/host/health/lossless.d.ts
 /**
  * 无损 JSON 判定 —— 本次事故的核心 gate 判据。
  *
@@ -1935,8 +1183,6 @@ declare function isLossless(value: unknown): boolean;
  * @returns 首个违规点位或 undefined。
  */
 declare function firstLosslessViolation(value: unknown, limit?: number): LosslessViolation | undefined;
-//#endregion
-//#region src/host/health/attribution.d.ts
 /** 一条归属记录。 */
 interface ProjectionOwner {
   key: string;
@@ -1955,8 +1201,6 @@ interface ProjectionOwner {
 declare function buildProjectionOwnerIndex(nodeModulesRoot: string): ProjectionOwner[];
 /** 索引查询器。 */
 declare function createAttributor(index: readonly ProjectionOwner[]): (projection: string) => GateAttribution | undefined;
-//#endregion
-//#region src/host/health/repair.d.ts
 /** 可逆处置的结果。 */
 interface RepairOutcome {
   ok: boolean;
@@ -2022,8 +1266,6 @@ declare function assessRepair(input: {
   after: SessionHealthReport;
   repair: RepairOutcome;
 }): RepairAssessment;
-//#endregion
-//#region src/host/health/scan.d.ts
 /** 一个已发现的会话。 */
 interface DiscoveredSession {
   sessionId: string;
@@ -2108,56 +1350,6 @@ declare function scanSessions(options: {
   projectionStateFor?: (sessionId: string) => Record<string, unknown> | undefined;
   now?: () => number;
 }): HealthScanResult;
-//#endregion
-//#region src/host/index/snapshot.d.ts
-/**
- * Export the whole index (active AND archived) as a JSON Lines string.
- * 归档行带 archived 标记一起导出——快照是完整备份,不是活跃子集。
- * @param engine - the open active engine.
- * @returns the complete snapshot text (header line first).
- */
-declare function exportSnapshot(engine: SwitchIndexEngine): string;
-/** One parsed snapshot: importable records plus skipped-line count. */
-interface SwitchParsedSnapshot {
-  records: SwitchImportRecord[];
-  skipped: number;
-}
-/**
- * Parse a snapshot's JSON Lines text into importable records.
- * The header line and any malformed line are skipped, not fatal.
- * @param text - raw snapshot text.
- * @returns importable records and how many lines were skipped.
- */
-declare function parseSnapshot(text: string): SwitchParsedSnapshot;
-//#endregion
-//#region src/host/index/peers.d.ts
-/** Resolution outcome for a peer plugin package. */
-type PeerPresence = 'installed' | 'missing' | 'unknown';
-/**
- * Probe whether a package resolves from this plugin's own module graph.
- *
- * The bundle lives at `<profile>/node_modules/dsh-search-index/lib/index.mjs`,
- * so resolution runs against `<profile>/node_modules` — exactly where a
- * profile dependency lands, and therefore the same place the host would load
- * the peer from.
- *
- * @param name - the package name to resolve.
- * @param base - resolution base; defaults to this module's own URL, i.e. the
- *   plugin's install directory. Injectable so the classification can be tested
- *   against a fixture that fails in a way this checkout cannot produce.
- * @returns `installed` when it resolves; `missing` only for a genuine
- *   module-not-found; `unknown` for every other failure, because an
- *   unanswerable probe is not evidence of absence.
- */
-declare function probePeer(name: string, base?: string): PeerPresence;
-/**
- * Probe whether {@link STEWARD_PACKAGE} is installed alongside this plugin.
- *
- * @returns the resolution state, never a throw.
- */
-declare function detectSteward(): PeerPresence;
-//#endregion
-//#region src/index.d.ts
 /** 本插件声明的宿主服务（与 toggle 相同的注入面）。0.2.1-a.2 起 webRuntime 更名 webStartup，读取面走双名回退链。 */
 declare const inject: string[];
 /** 运行时配置 schema（与 src/config.ts 的形状保持一致）。0.1.7+：volatile 字段即设置表单。 */
@@ -2165,28 +1357,12 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
   enabled: z<boolean, boolean, "defined">;
   historyFiles: z<boolean, boolean, "defined">;
   healthCheck: z<boolean, boolean, "defined">;
-  search: z<boolean, boolean, "defined">;
   directDelete: z<boolean, boolean, "defined">;
-  defaultMode: z<"title" | "content", "title" | "content", "defined">;
-  autoSync: z<boolean, boolean, "defined">;
-  syncIntervalMs: z<number, number, "defined">;
-  archiveKeep: z<number, number, "defined">;
-  indexDir: z<string, string, "defined">;
-  corpusSource: z<"native" | "drs", "native" | "drs", "defined">;
-  drsBaseUrl: z<string, string, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
   enabled: z<boolean, boolean, "defined">;
   historyFiles: z<boolean, boolean, "defined">;
   healthCheck: z<boolean, boolean, "defined">;
-  search: z<boolean, boolean, "defined">;
   directDelete: z<boolean, boolean, "defined">;
-  defaultMode: z<"title" | "content", "title" | "content", "defined">;
-  autoSync: z<boolean, boolean, "defined">;
-  syncIntervalMs: z<number, number, "defined">;
-  archiveKeep: z<number, number, "defined">;
-  indexDir: z<string, string, "defined">;
-  corpusSource: z<"native" | "drs", "native" | "drs", "defined">;
-  drsBaseUrl: z<string, string, "defined">;
 }>>, "plain">;
 /** 运行时依赖。 */
 interface StewardRuntime {
@@ -2200,6 +1376,10 @@ interface StewardRuntime {
     field?: string;
   } | undefined;
   log: (message: string) => void;
+  /**
+   * 管理台语料来源（宿主 `sessionQuery`；可选：缺席时 `session-catalog` 显式报错）。
+   */
+  sessionQuery?: SwitchSessionQuery;
   /**
    * 体检结果缓存（进程内，随 fiber 存活）。
    *
@@ -2212,23 +1392,6 @@ interface StewardRuntime {
    * 租约。缺省（单测/modern 宿主）= describe 回空投影、mutate 显式拒绝。
    */
   settingsBridge?: BridgeState;
-  /**
-   * 搜索索引联动钩子（可选）：管家写侧操作成功后同步翻索引的归档标记 /
-   * 删除索引行，消灭"搜索还挂着 30s 前的幽灵"的窗口。缺省（单测/降级）为无联动。
-   */
-  index?: {
-    /** 批量归档成功 → 翻 archived=true。 */
-    onArchive: (sessionIds: readonly string[]) => void;
-    /** 取消归档成功 → 翻 archived=false。 */
-    onUnarchive: (sessionIds: readonly string[]) => void;
-    /** 清理成功（物理删除）→ 索引行整个移除。 */
-    onPurged: (sessionIds: readonly string[]) => void;
-  };
-  /**
-   * 退场墓碑台账目录（可选）：purge 成功后追加 retired-tombstones.jsonl。
-   * 缺省 = ~/.dsh-switch-search（单测注入临时目录隔离真实家目录）。
-   */
-  tombstoneDir?: () => string;
 }
 /**
  * 支持的路由方法（按子域分组；用于对外声明与测试断言）。
@@ -2238,11 +1401,9 @@ interface StewardRuntime {
  */
 declare const HISTORY_METHODS: readonly ["session-history-list", "session-history-archive", "session-history-prune", "session-history-purge", "session-history-favorites-list", "session-history-favorite-set"];
 declare const HEALTH_METHODS: readonly ["session-health-status", "session-health-scan", "session-health-session", "session-health-repair", "session-health-source-migrate"];
-/** 搜索索引子域方法（`/switch-search/api`；index-export/import 走原始体，其余 JSON）。 */
-declare const INDEX_METHODS: readonly ["list-sessions", "content-search", "search-status", "index-status", "index-rebuild", "index-export", "index-import"];
 /** 依据开关判定某方法是否启用。 */
 declare function methodEnabled(method: string, config: Required<StewardConfig>): boolean;
-/** ------------------------------------------------------------------ 搜索子域 handlers */
+/** ------------------------------------------------------------------ 会话语料结构镜像 */
 /**
  * One session header shape the query service returns (structural subset).
  */
@@ -2273,72 +1434,20 @@ interface SwitchTitleObservationResult {
   };
   reason?: unknown;
 }
-/** The session-query service face: corpus reads, title folding, FTS5 search. */
+/** The session-query service face used by the manage console catalog. */
 interface SwitchSessionQuery {
   listSessions(signal?: AbortSignal): Promise<readonly SwitchSessionRecord[]>;
   readSession?(sessionId: string): Promise<{
     session: SwitchSessionHeader;
-    events: readonly SwitchRawEvent[];
+    events: readonly unknown[];
   }>;
   readTitleSnapshots(sessionIds: readonly string[], signal?: AbortSignal): Promise<readonly SwitchTitleObservationResult[]>;
-  searchSessions?(request: {
-    query: string;
-    eventFilters?: readonly unknown[];
-    limit?: number;
-  }, exec?: {
-    signal?: AbortSignal;
-  }): Promise<{
-    items: readonly unknown[];
-    nextCursor?: string;
-  }>;
-}
-/** ------------------------------------------------------------------ index service */
-/** The per-activation index service state, carried in the apply closure. */
-interface SwitchIndexServiceState {
-  engine: SwitchIndexEngine;
-  sync: SwitchWatermarkSync;
-  layout: SwitchIndexLayout;
-  rebuild: SwitchRebuildState;
-  /** Official archive-set reader (registry first, storage-hub file fallback). */
-  archiveReader: ReturnType<typeof createArchiveSource>;
-}
-/**
- * Everything the search handlers need, captured from the apply closure: the
- * optional live sessionQuery, the index service state, and the latest config.
- * Handlers never touch the cordis context — arbitrary property writes on a
- * Context are rejected ("cannot set property ... without provide").
- */
-interface SearchRuntime {
-  sessionQuery: SwitchSessionQuery | undefined;
-  index: SwitchIndexServiceState;
-  /** DRS 直连客户端（T7.3 硬依赖：内容分组检索臂唯一来源 + 可性探针）。 */
-  drsSource: DrsCorpusSource;
-  config: () => Required<StewardConfig> & SwitchSearchConfig;
-  /** Lazy official archive-set source (registry first, file fallback). */
-  registry: () => {
-    archivedSessionIds: readonly string[];
-  };
-  /** Cordis logger bridge ([session-steward] prefixed). */
-  log: (msg: string) => void;
-  /** 文件级兜底读取器（重建钩子透传;见 SwitchWatermarkSync 注释）。 */
-  readSessionFromFile: (sessionId: string) => Promise<{
-    session: {
-      id: string;
-      version: number;
-      createdAt?: number;
-      cwd?: string;
-    };
-    events: readonly SwitchRawEvent[];
-  } | undefined>;
 }
-/** JSON 面的搜索子域方法分发（index-export/import 走原始体，在路由层特判）。 */
-declare function handleIndexMethod(method: string, payload: unknown, srt: SearchRuntime, requestHost?: string): Promise<unknown>;
 declare function handleMethod(method: string, payload: unknown, runtime: StewardRuntime): Promise<unknown>;
 /**
  * 插件主体：装配运行时、挂载两条 fenced 路由与索引生命周期。
  * @param ctx - host 插件上下文（webServer / webStartup（旧名 webRuntime）/ 可选 sessionQuery、workspaceRegistry）。
  * @param config - 组合条目（0.1.7：`.volatile()` 字段为 live ref）。
  */
-declare function apply(ctx: Context, config?: Partial<StewardConfig & SwitchSearchConfig>): void;
-//#endregion
-export { Config, DEFAULT_CONFIG, DEFAULT_INDEX_LAYOUT, type DiscoveredSession, type GenerationArtifact, HEALTH_METHODS, HISTORY_METHODS, HealthCache, type HealthCacheEntry, INDEX_METHODS, type LogArtifact, type LogCompression, type RepairAssessment, type RepairVerdict, SOURCE_MIGRATE_BACKUP_SUFFIX, STEWARD_API_PREFIX, STEWARD_SETTINGS_NAMESPACE, SWITCH_API_PREFIX, SWITCH_DEFAULT_CONFIG, SearchRuntime, type SessionGenerations, type SessionPriority, type StewardConfig, StewardRuntime, type SwitchArchiveDiagnostics, SwitchIndexEngine, SwitchIndexServiceState, type SwitchSearchConfig, SwitchWatermarkSync, V4_HOST_MIN, apply, archiveArchiveFile, archiveHistory, assessRepair, backupFilesIn, buildProjectionOwnerIndex, buildSessionReport, classifyGenerationFilename, countCorpus, createArchiveSource, createAttributor, decodeSessionLogBytes, decodeSessionLogFile, detectSteward, dirSize, discoverSessions, editWorkspaceDocument, exportSnapshot, extractTitleFromEvents, findSession, findSessionLog, firstLosslessViolation, gateColdRead, gateGeneration, gateLogIntegrity, gateLosslessJson, gateProjectionCache, gateSourceKind, generationLogFilename, handleIndexMethod, handleMethod, importIntoIndex, indexSessionDirs, inject, isLossless, isMigrationStagingFilename, isSafeChild, isSourceMigrateBackupName, latestArtifactMtime, listHistory, locateSessionUsage, methodEnabled, migrateLegacySource, migrateSessionSourceKind, parseGenerationLogFilename, parseSnapshot, prescribe, probePeer, projCacheRootFor, pruneArchiveFile, pruneHistory, purgeHistory, quarantineProjectionCache, readArchiveSet, readProjectionCache, readSessionGenerations, readSourceKindFacts, readTailFacts, rebuildIndex, recoverIndex, scanSessions, scanZstdFrames, sessionPriority, sessionsRootFor, swapShadowIntoActive };
+declare function apply(ctx: Context, config?: Partial<StewardConfig>): void;
+export { Config, DEFAULT_CONFIG, type DiscoveredSession, type GenerationArtifact, HEALTH_METHODS, HISTORY_METHODS, HealthCache, type HealthCacheEntry, type LogArtifact, type LogCompression, type RepairAssessment, type RepairVerdict, SOURCE_MIGRATE_BACKUP_SUFFIX, STEWARD_API_PREFIX, STEWARD_SETTINGS_NAMESPACE, type SessionGenerations, type SessionPriority, type StewardConfig, StewardRuntime, V4_HOST_MIN, apply, archiveArchiveFile, archiveHistory, assessRepair, backupFilesIn, buildProjectionOwnerIndex, buildSessionReport, classifyGenerationFilename, countCorpus, createAttributor, decodeSessionLogBytes, decodeSessionLogFile, dirSize, discoverSessions, editWorkspaceDocument, findSession, findSessionLog, firstLosslessViolation, gateColdRead, gateGeneration, gateLogIntegrity, gateLosslessJson, gateProjectionCache, gateSourceKind, generationLogFilename, handleMethod, indexSessionDirs, inject, isLossless, isMigrationStagingFilename, isSafeChild, isSourceMigrateBackupName, latestArtifactMtime, listHistory, locateSessionUsage, methodEnabled, migrateLegacySource, migrateSessionSourceKind, parseGenerationLogFilename, prescribe, projCacheRootFor, pruneArchiveFile, pruneHistory, purgeHistory, quarantineProjectionCache, readArchiveSet, readProjectionCache, readSessionGenerations, readSourceKindFacts, readTailFacts, scanSessions, scanZstdFrames, sessionPriority, sessionsRootFor };