@lynn123411/dsh-chat-translate 2.0.0 → 3.0.1

package/lib/types/client/chat/assistant-step.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 助手行渲染器：经 keyed slot `conversation.chat.node`（key `assistant-step`）
+ * 替换宿主默认的行渲染。
+ *
+ * 接管换来两件事——
+ * 1. 正文块从数据层拿**原始 markdown**（`AssistantBlock.text`），译文同样按
+ *    markdown 交给宿主公开基线组件 `MarkdownText` 重渲染：格式保真由官方
+ *    渲染器负责，本文件不产生任何自拼 markup。
+ * 2. 「已翻译」是渲染状态：落定、开关开启、进入视口后逐行请求；成功的块
+ *    （包括模型认为原样最好的块）挂译文、左缘一条细线、点击在译文与原文间
+ *    切换；失败的块保持原文、无标记，下一次条件满足自然重试。
+ *
+ * 除正文外的行内容与宿主逐分支等价：reasoning 行走折叠（含 Turn-process
+ * 隐藏与 beforematch 揭示）、连续 image 组交回 owner 的 renderMessageImages、
+ * 未知块落 JsonBlock、tool-call 在助手行内跳过（工具行由宿主独立渲染）、
+ * 中断前缀行尾带「已停止」。props 形状是宿主 contract 的结构性镜像：值边
+ * 不跨包（客户端 bundle 纯净门禁），类型注释指明对应声明。
+ * 本渲染器抛错时按 keyed slot 的退位语义退出该 cell，宿主原渲染器回位。
+ */
+import * as React from 'react';
+import type { ReactElement, ReactNode } from 'react';
+import type { MarkdownFileMentions } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { AssistantBlockLike } from './row-plan.ts';
+interface DisclosureState {
+    readonly expanded: boolean;
+    readonly setExpanded: (open: boolean) => void;
+    readonly toggle: () => void;
+}
+interface PresentationLike {
+    readonly settledReasoningPreview: boolean;
+}
+interface NodeDataLike {
+    readonly status: string;
+    readonly turn: number;
+    readonly step: number;
+    readonly blocks: readonly AssistantBlockLike[];
+    readonly finalNode?: {
+        readonly seq: number;
+    };
+}
+interface TurnProcessLike {
+    readonly foldable: boolean;
+    readonly open: boolean;
+    readonly spec: {
+        readonly answerStep: number;
+        readonly inlineReasoning: boolean;
+    };
+    readonly setOpen: (open: boolean) => void;
+}
+export interface AssistantStepProps {
+    readonly node: {
+        readonly data: NodeDataLike;
+        readonly location?: {
+            readonly kind?: string;
+            readonly turn?: {
+                readonly status?: string;
+            };
+        };
+        readonly anchorSeq?: number;
+    };
+    readonly groupPart?: string;
+    readonly useDisclosure: () => DisclosureState;
+    readonly useTurnData: (key: string) => unknown;
+    readonly turnProcess?: TurnProcessLike;
+    readonly openFile: (path: string, options?: {
+        line?: number;
+    }) => void;
+    readonly renderMessageImages: (owner: {
+        readonly images: readonly {
+            readonly attachment: unknown;
+        }[];
+        readonly align?: string;
+    }) => ReactNode;
+    readonly fileMentions: (owner: unknown) => MarkdownFileMentions | undefined;
+    readonly usePresentation: <R>(select: (policy: PresentationLike) => R) => R;
+    readonly t: (key: string, params?: Record<string, unknown>) => string;
+}
+export declare const AssistantStepView: React.MemoExoticComponent<(props: AssistantStepProps) => ReactElement | null>;
+export {};

package/lib/types/client/chat/click-guard.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 已翻译块的点击守卫：切换只认「落在块空白正文上的裸点击」。
+ *
+ * 块内含链接、代码块复制钮等交互元素——它们的点击归自己，不连带切块；
+ * 拖选译文松手产生的 click 同样忽略。纯 DOM 判定，不依赖 React，可独立测试。
+ */
+interface MinimalPointerEvent {
+    /** 点击命中的最深元素。 */
+    target: {
+        closest?(selector: string): unknown;
+    } | null;
+    /** 挂了本守卫的已翻译块容器。 */
+    currentTarget: unknown;
+}
+interface MinimalWindow {
+    getSelection?(): {
+        isCollapsed?: boolean;
+        toString?(): string;
+    } | null;
+}
+/**
+ * @param event - click 事件（结构面：target/currentTarget）。
+ * @param view - 可注入的 window（测试传假对象；运行时传全局 window）。
+ * @returns 该点击是否应当触发原文/译文切换。
+ */
+export declare function isBareBlockClick(event: MinimalPointerEvent, view: MinimalWindow | undefined): boolean;
+export {};

package/lib/types/client/chat/presentation.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 助手行渲染所需的「工作细节」呈现策略。
+ *
+ * 宿主把这一策略派生自 `ui-chat` 配置条目的 `transcriptView` 字段；本插件接管
+ * 助手行渲染后，经 `ctx.configForms.get('ui-chat')` 读同一个字段，映射到与宿主
+ * 同形、同值的策略表。策略对象按模式常驻（同一模式恒等返回同一实例），
+ * 选择器订阅看到的是稳定引用。
+ */
+/** 与宿主 ChatPresentationPolicy 同形的结构性镜像。 */
+export interface ChatPresentationPolicy {
+    readonly mode: string;
+    readonly foldCompletedTurns: boolean;
+    readonly stepGrouping: 'collapsed' | 'history' | 'none';
+    readonly liveProcessDetail: boolean;
+    readonly settledReasoningPreview: boolean;
+}
+/**
+ * 模式 → 策略常量表，逐行对齐宿主 ui-chat 的实现（含两代 legacy 存储值：
+ * `normal` 按 standard 读、`expanded` 按 detailed 读，从不写回）。
+ * 渲染器只选择单个字段，不按 mode 分支。
+ */
+export declare const POLICY_BY_MODE: Readonly<Record<string, ChatPresentationPolicy>>;
+/** 宿主在用户没有显式选择时使用的模式。 */
+export declare const DEFAULT_MODE = "standard";
+/** 本模块只用到配置面的这一小片形状（结构性镜像，值边不跨包）。 */
+interface ModeFormLike {
+    getSnapshot(): {
+        status: string;
+        value?: Record<string, unknown>;
+    };
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * 跟随 `ui-chat` 配置的活策略源。attach 之后：读一次、订一次；配置面缺席
+ * （宿主半边未服务该条目、内存模式）时停在 standard，不发订阅。
+ */
+export declare class ChatPresentation {
+    private policy;
+    private listeners;
+    private form;
+    private unsubscribe;
+    attach(form: ModeFormLike | null | undefined): void;
+    detach(): void;
+    getSnapshot: () => ChatPresentationPolicy;
+    subscribe: (listener: () => void) => (() => void);
+    private read;
+}
+export declare function createChatPresentation(): ChatPresentation;
+/** 渲染器与配置面之间的进程内单例：在 client/index.ts 接线一次。 */
+export declare const chatPresentation: ChatPresentation;
+export {};

package/lib/types/client/chat/row-plan.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 助手行的渲染计划：纯函数，不含 React，无浏览器依赖。
+ *
+ * 计划层承担两类判断——
+ * 1. 与宿主 `AssistantMarkdown` 逐条等价的分支：什么时候整行不渲染、
+ *    groupPart 怎么过滤、tool-call 块为什么在这里被跳过（工具行是 flow 里
+ *    独立的行，由宿主自己渲染）、连续 image 怎么合成一组、未知块落 JSON、
+ *    「已停止」标记的出现条件。
+ * 2. 翻译的呈现判断：正文块在什么状态下显示译文并带「已翻译」标记。标准只有
+ *    一条——该块的翻译成功落定。「模型认为原样最好、返回同样的文字」同样是
+ *    成功：照常挂载、照常标记，标记传达的是「这段过了模型」，不是「这段变过」。
+ *
+ * 渲染层（assistant-step.tsx）把计划变成 JSX；改动这里的等价分支必须同时对照
+ * 宿主实现。
+ */
+import type { BlockOutcome } from './translate-store.ts';
+/** 助手行块数据的结构性镜像（值边不跨包，type-only 世界）。 */
+export interface AssistantBlockLike {
+    readonly kind: string;
+    readonly text?: string;
+    readonly attachment?: unknown;
+    readonly block?: unknown;
+}
+export type RowPlanEntry = 
+/** 思考块：blockIndex 供「流式尾块」判定，key 是条目在计划里的位置（React 键）。 */
+{
+    type: 'reasoning';
+    key: number;
+    blockIndex: number;
+    text: string;
+}
+/** 正文块：translated 非 null 时显示该译文并带「已翻译」标记，否则显示 text。 */
+ | {
+    type: 'prose';
+    key: number;
+    text: string;
+    translated: string | null;
+} | {
+    type: 'images';
+    key: number;
+    attachments: readonly unknown[];
+} | {
+    type: 'unknown';
+    key: number;
+    block: unknown;
+} | {
+    type: 'stopped';
+    key: number;
+};
+export interface RowPlan {
+    /** null = 整行不渲染（与宿主的空行守卫一致）。 */
+    entries: RowPlanEntry[] | null;
+    /** 送翻译池的正文文本，按正文块出现顺序，与结果下标对齐。 */
+    texts: string[];
+}
+export interface RowPlanInput {
+    blocks: readonly AssistantBlockLike[];
+    /** 行在流式中：流式期间一律原文，落定后才有译文。 */
+    streaming: boolean;
+    /** 中断前缀：行尾带「已停止」标记。 */
+    interrupted: boolean;
+    /** flow 分组：'reasoning' 只要思考块，'response' 排除思考块，缺省全要。 */
+    groupPart?: string;
+    /** 可译门（enabled 且通道三要素齐备）：false 时一切按原文呈现，不挂线。 */
+    canTranslate: boolean;
+    /**
+     * 该行正文块的翻译结果，与 texts 同下标；null = 该批尚未落定（逐批出文的
+     * 中间态）。未登记或换代时整个缺省。
+     */
+    outcomes?: readonly (BlockOutcome | null)[];
+}
+export declare function planAssistantRow(input: RowPlanInput): RowPlan;

package/lib/types/client/chat/styles.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 助手行接管所需的样式：与宿主 `AssistantMarkdown` / `ReasoningRow` 逐条对齐
+ * 的等价规则（字号、行距、gap、粘性折叠头、running 微光、summary 遮罩等），
+ * 加上本插件唯一新增的视觉词汇——左缘线的色相与粗细标记：蓝粗线（1px）=正在
+ * 读译文，灰细线（0.5px）=有译文但正在读原文（再点即切回），无线=没译成。
+ *
+ * 全部颜色与尺寸走 `--dsw-alias-*` / `--dsh-*` 主题别名，中性平边按官方规则
+ * 画 0.5px hairline；动画声明尊重 `prefers-reduced-motion`。样式随 bundle 注入
+ * 一次（`<style data-plugin-css>`），类名用固定前缀，不依赖宿主哈希类名。
+ */
+export declare const ASSISTANT_CSS: string;
+/**
+ * 正文块的标记类名单点：有译文才可点（常驻内缩 + 光标）；左缘线的色相与粗细
+ * 随显示态——译文挂 1px 蓝线、原文态挂 0.5px 灰线（保留「这块有译文、点了能
+ * 切回」的线索），没译无线。线宽只差 0.5px，切换不跳字。
+ */
+export declare function proseClassNames(processed: boolean, showOriginal: boolean): string | undefined;
+/** 注入接管样式；重复调用是空操作。 */
+export declare function ensureAssistantStyles(): void;

package/lib/types/client/chat/translate-store.d.ts

@@ -0,0 +1,73 @@
+import { type ReplyBlockResult } from '../translate/api.ts';
+/** 一行正文的按块翻译结果，与请求的 texts 数组按下标对齐。 */
+export interface BlockOutcome {
+    /** 模型产出的中文（Markdown 源文本）；失败时等于原文。 */
+    translated: string;
+    /** 该块是否翻译成功。失败的块界面保持原文、不标记。 */
+    ok: boolean;
+}
+/**
+ * 一行正文的翻译状态。outcomes 与 texts 同下标，null = 该块所在批尚未落定：
+ * 每批返回就地填入并通知，长回答按阅读顺序逐段出中文，不憋到最后一批。
+ * 全部批落定后：无失败即 done；有失败标 partial——partial 行允许后续 ensure
+ * 重走（渲染层的下一次触发是滚出视口再回来、或行重挂载），失败的块因此
+ * 自然重试，成功的块由宿主磁盘缓存直接命中、不再花模型调用。重走有上限
+ * （MAX_ROW_ATTEMPTS）：确定性失败（如弱模型丢占位符）不该被滚动无限续杯，
+ * 封顶后保持原文直到文本换代重置。
+ */
+export interface RowState {
+    status: 'pending' | 'partial' | 'done';
+    texts: readonly string[];
+    outcomes: readonly (BlockOutcome | null)[];
+    /** 这一代文本已经完整跑过几轮（首跑计 1）。 */
+    attempts: number;
+}
+/** 送译一行正文的取数面：默认走宿主路由，测试注入假实现。 */
+export type ReplyFetcher = (texts: string[]) => Promise<ReplyBlockResult[]>;
+/** 同时在池的行数上限：LRU 淘汰最久未读的整行；行文本本身仍归宿主会话持有。 */
+export declare const MAX_TRANSLATED_ROWS = 200;
+/** 同一代文本最多完整跑几轮；封顶后不再打通道，直到文本换代重置额度。 */
+export declare const MAX_ROW_ATTEMPTS = 3;
+/**
+ * 一次 HTTP 请求装载的估算 token 上限：与宿主的打包输入上限同值同源
+ * （blocks.ts 的 REPLY_MAX_INPUT_TOKENS）——客户端按宿主的打包窗口切批，
+ * 每批在宿主侧通常正好落进一次模型调用。
+ */
+export declare const REQUEST_TOKEN_BUDGET = 4096;
+/** 按出现顺序把整行文本切成不超预算的批；单块超预算时独自成批。 */
+export declare function chunkTexts(texts: readonly string[]): string[][];
+/**
+ * 助手行的翻译池：按行键存「该行全部正文块的翻译结果」。
+ *
+ * 行键由渲染层给出（会话内锚点序号），文本数组参与一致性判断：同键不同文本
+ * 视为行换了一代内容，整行重新请求——这保证重渲染或会话切换后不会把旧译文
+ * 配到新文本上。请求幂等：同键同文本、且上一代已落定成功或仍在途的 ensure
+ * 不再发请求；只有 partial（有失败块）的同代 ensure 会重走，且同代封顶三次。在途期间换代，
+ * 迟到的旧代结果直接丢弃。
+ *
+ * 本模块不依赖 React：渲染层用 useSyncExternalStore 订阅版本，再读 getState。
+ */
+export declare class ChatTranslateStore {
+    private rows;
+    private listeners;
+    private version;
+    private fetch;
+    constructor(fetcher: ReplyFetcher);
+    /** 单调版本号：任何状态变化（含单批落定）都前进一位，供渲染层判等重渲。 */
+    getVersion(): number;
+    subscribe: (listener: () => void) => (() => void);
+    /** 读一行状态，并把该行刷成最近使用。 */
+    getState(rowKey: string): RowState | undefined;
+    /**
+     * 确保该行按当前文本被翻译。
+     * @returns 是否发出了新的请求（同代 done/pending 与换代前的登记之外都是 false）。
+     */
+    ensure(rowKey: string, texts: readonly string[]): boolean;
+    private run;
+    private prune;
+    private bump;
+}
+/** 供测试注入取数面创建独立池。 */
+export declare function createTranslateStore(fetcher: ReplyFetcher): ChatTranslateStore;
+/** 正文翻译池：客户端半边唯一的按行译文登记处。 */
+export declare const chatTranslate: ChatTranslateStore;

package/lib/types/client/composer/dock-toggle.d.ts

@@ -0,0 +1,26 @@
+import type { ReactElement } from 'react';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { NS } from '../locales.ts';
+/**
+ * `t` 由注册项的 `locale: NS` 注入，类型走共享的 `PropsLocale`。owner props
+ * （`PropsRuntime<'conversation.composer.dock'>`）的类型随
+ * `@deepseek-ai/dsh-client-ui-conversation` 声明，本包不依赖它（与 dsh-a6api
+ * 同法），组件也不读那些 prop。
+ */
+export type DockToggleProps = PropsLocale<typeof NS>;
+/**
+ * 对话输入框下方那一行的翻译开关：一个胶囊按钮，点亮表示正文翻译开着。
+ * 它与设置页「总开关」是同一个 `enabled` 字段——点击写 profile 配置，两处
+ * 状态由同一个 store 同步；关闭与重开的行为（还原英文、重扫补翻）也走
+ * 同一条链路。Key 没配齐时照常可切换：缺配置只是不产生翻译，界面无特殊态。
+ */
+export declare function ComposerTranslateToggle(props: DockToggleProps): ReactElement;
+/**
+ * 把开关注册进 `conversation.composer.dock`——ui-conversation 声明的
+ * 「输入框卡片下方那一行」。该 slot 只在会话形态渲染，新建会话的 Hero 形态
+ * 没有这一行，按钮随之不出现。`slots.inject` 等声明落地再注册，声明塌缩时
+ * 注册一起退场。
+ * @param ctx - DSH browser client context（`slots` 已在客户端半边声明注入）。
+ * @returns 撤销本次贡献的 disposer。
+ */
+export declare function setupComposerToggle(ctx: any): () => void;

package/lib/types/client/index.d.ts

@@ -1,36 +1,45 @@
 /** Client plugin name, shared with the browser bundle id. */
 export declare const name = "dsh-chat-translate";
 /**
- * Declared services: slots for the shared 「阅读体验」 settings page (page claim
- * plus the card registration), configForms for this plugin's own configuration
- * form (`ctx.configForms.get(<profile entry id>)` is the read/write face the
- * card rides), the remote + remote.credentials pair for the credentials Remote
- * namespace, and locale for the card's own dictionary. The runtime withholds
- * any service not declared here; `locale` is declared rather than sampled
- * because `ctx.get('locale')` at apply time can beat the locale plugin's
- * `provide`, which silently left the card's dictionary unregistered.
+ * Declared services: slots for the keyed assistant-row takeover, the shared
+ * 「阅读体验」 settings page (page claim plus the card registration) and the
+ * composer dock pill; configForms for this plugin's own configuration form
+ * plus the host `ui-chat` entry whose `transcriptView` field drives the
+ * reasoning-row presentation policy; the remote + remote.credentials pair for
+ * the credentials Remote namespace; and locale for the card's own dictionary.
+ * The runtime withholds any service not declared here; `locale` is declared
+ * rather than sampled because `ctx.get('locale')` at apply time can beat the
+ * locale plugin's `provide`, which silently left the card's dictionary
+ * unregistered.
  */
 export declare const inject: string[];
 interface ClientContext {
     effect(factory: () => void | (() => void), label?: string): void;
     get?(serviceName: string): any;
-    slots?: any;
-    configForms?: any;
+    slots?: {
+        inject(name: string, register: () => unknown): () => void;
+        register(options: Record<string, unknown>, component: unknown): () => void;
+    };
+    configForms?: {
+        get(namespace: string): any;
+    };
     locale?: any;
     remote?: {
         credentials?: any;
     };
 }
 /**
- * Mount the reply-body translation observer and the settings UI card inside the
- * shared reading-settings page.
+ * Mount the assistant-row takeover (keyed `conversation.chat.node` /
+ * `assistant-step`), the settings UI card inside the shared reading-settings
+ * page, and the translation toggle in the composer dock.
  * @param ctx - DSH browser client context.
  */
 export declare function apply(ctx: ClientContext): void;
-export { chatTranslateObserver } from './translate/observer.ts';
-export { replyTranslator, collectReplyUnits, chunkUnits, needsTranslation } from './translate/reply.ts';
+export { AssistantStepView } from './chat/assistant-step.tsx';
+export { planAssistantRow } from './chat/row-plan.ts';
+export { chatTranslate, createTranslateStore } from './chat/translate-store.ts';
+export { chatPresentation, createChatPresentation, POLICY_BY_MODE } from './chat/presentation.ts';
+export { ensureAssistantStyles } from './chat/styles.ts';
 export { setupSettingsUi } from './settings/ui.tsx';
-export { NonDestructiveTranslationMount } from './translate/mount.ts';
-export { clientCache } from './translate/client-cache.ts';
-export { lazyQueue } from './translate/lazy.ts';
+export { setupComposerToggle, ComposerTranslateToggle } from './composer/dock-toggle.tsx';
 export { settingsStore } from './settings/store.ts';

package/lib/types/client/locales.d.ts

@@ -11,7 +11,7 @@ export declare const zh: {
     readonly title: "正文翻译";
     readonly masterTitle: "翻译总开关";
     readonly enableTranslation: "启用翻译";
-    readonly masterDesc: "自动把回答正文里需要阅读的英文翻成中文（如 {example}），思考卡与工具调用行一律不翻，代码块原样保留。译文挂在原文位置上，点击译文可原地切回原文。回答还在流式输出时不翻，落定后整条转为中文；已经写好的中文段落原样保留。只作用于当前查看的会话，译文不写回会话上下文。";
+    readonly masterDesc: "自动把助手回答正文翻成中文（如 {example}）：折叠块里的过程正文与最终汇总一视同仁，整段中文的块也照送，由模型一并改写成自然中文、顺掉机器腔。Think 卡与工具调用行不翻，代码块原样保留。翻译过的块左缘有一条竖线：显示译文时是稍粗的蓝线，点回原文变细灰线（提示这里备着译文，再点即切回），没译成的没有线——线的颜色与粗细一眼分清「有没有译」和「正在读哪一版」。点击已翻译的块可在译文与原文间切换，模型认为原样最好、返回一模一样的文字时同样算翻译过、同样可切。译文按原 markdown 格式重新渲染，表格、列表、加粗与行内代码保持结构。回答还在流式输出时不翻，落定后按阅读顺序逐段出中文。只作用于当前查看的会话，译文不写回会话上下文。输入框下方那一行有同款开关，两处状态同步。";
     readonly aiTitle: "AI 翻译（OpenAI 兼容协议）";
     readonly aiRule: "只有这一条通道：Key / Base URL / 模型齐备才会翻译，缺任何一项都保持原文。";
     readonly badgeConfigured: "已配置";
@@ -36,7 +36,10 @@ export declare const zh: {
     readonly testOk: "连接正常，延迟 {latency}ms";
     readonly testFail: "失败：{error}";
     readonly behaviorTitle: "翻译范围";
-    readonly behaviorRule: "需要阅读的回答正文；思考链正文、工具调用标题与折叠摘要永不翻译，代码块及其内部原样保留。";
+    readonly behaviorRule: "助手回答正文一律翻译，包括最终汇总与整段中文的块：中文块同样交给模型改写成自然中文，意义、术语与数字不变。思考链正文、工具调用标题与折叠摘要不翻译，代码块及其内部原样保留。";
+    readonly dockLabel: "译";
+    readonly dockOn: "正文翻译已开启，点击关闭";
+    readonly dockOff: "正文翻译已关闭，点击开启";
 };
 /** Locale keys this plugin renders. */
 export type ChatTranslateLocaleKey = keyof typeof zh;

package/lib/types/index.d.ts

@@ -1,16 +1,15 @@
 import type { HostConnectionHandle } from '@deepseek-ai/dsh-client-connection';
 import z from '@deepseek-ai/schemastery';
-import { type PluginConfigRefs, type SettingsMigrationTarget } from './server/config.ts';
+import { type PluginConfigRefs } from './server/config.ts';
 /** Stable Cordis loader name. */
 export declare const name = "dsh-chat-translate";
 /**
- * Hard dependencies: settings and credentials are the DSH-owned config/secret
- * surfaces this plugin rides on. The plugin's own values arrive as its resolved
- * Config, so `settings` is only the provider-level write face the one-shot
- * legacy-file migration needs. The translation routes register through the
- * connection service when a Web carrier composes it, so apply takes that
- * service through ctx.inject and the plugin still loads in compositions
- * without one.
+ * Hard dependencies: credentials is the DSH-owned secret surface this plugin
+ * rides on, and settings carries the entry's automatic-page policy. The
+ * plugin's own values arrive as its resolved Config. The translation routes
+ * register through the connection service when a Web carrier composes it, so
+ * apply takes that service through ctx.inject and the plugin still loads in
+ * compositions without one.
  */
 export declare const inject: string[];
 /**
@@ -25,18 +24,16 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     aiTimeoutMs: z<number, number, "volatile-defined">;
     baseUrl: z<string, string, "volatile-defined">;
     model: z<string, string, "volatile-defined">;
-    targetLang: z<string, string, "volatile-defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
     enabled: z<boolean, boolean, "volatile-defined">;
     aiTimeoutMs: z<number, number, "volatile-defined">;
     baseUrl: z<string, string, "volatile-defined">;
     model: z<string, string, "volatile-defined">;
-    targetLang: z<string, string, "volatile-defined">;
 }>>, "plain">;
 interface HostContext {
     connection: HostConnectionHandle;
     fiber: unknown;
-    settings: SettingsMigrationTarget & {
+    settings: {
         /** Register this entry's automatic-page policy; `auto: false` opts out. */
         configure(presentation: {
             auto?: boolean;

package/lib/types/server/cache.d.ts

@@ -2,31 +2,16 @@ export declare class LruDiskCache {
     private cache;
     private maxEntries;
     private filePath;
+    private revision;
     private saveTimer;
     private dirty;
-    /** Legacy root-level cache file (<=1.1); moved under the plugin subdir. */
-    private legacyPath;
-    /** Only the original cache file carries a pre-1.2 root-level predecessor. */
-    private hasLegacyPredecessor;
-    constructor(maxEntries?: number, fileName?: string);
+    constructor(maxEntries?: number, fileName?: string, revision?: string);
     init(): Promise<void>;
-    /** Load one cache document into memory, dropping poisoned or malformed entries. */
-    private loadFile;
+    /** Adopt loaded entries, dropping poisoned or malformed ones. */
+    private loadEntries;
     get(key: string): string | undefined;
     set(key: string, value: string): void;
     private scheduleSave;
     flush(): Promise<void>;
     dispose(): Promise<void>;
 }
-/**
- * One-shot retirement of store files an earlier release owned. Repo rule: a
- * capability's leftovers go away in the change that removes the capability, so
- * a retired pool file is deleted rather than left to rot in the user's home.
- *
- * Absent files and unreadable paths both produce `false`; this never throws —
- * a failed cleanup must not stop the plugin from loading.
- *
- * @param fileNames - file names under the plugin's own home directory.
- * @returns whether at least one file was removed.
- */
-export declare function retireStoreFiles(fileNames: readonly string[]): Promise<boolean>;

package/lib/types/server/config.d.ts

@@ -4,30 +4,17 @@ import type { CredentialsReader } from './credentials.ts';
 /**
  * Bounds for the AI channel request timeout. One request carries a packed run
  * of whole reply blocks, and a local model can take minutes on that much
- * prose, so the budget is long-form rather than the old short-text scale.
+ * prose, so the budget is sized for long-form output.
  */
 export declare const AI_TIMEOUT_MIN = 500;
 export declare const AI_TIMEOUT_MAX = 900000;
 /**
- * The settings namespace this plugin owns. Since 0.1.7 a namespace IS the
- * Profile entry id, so the user-editable layer is the `config` row of
- * `dsh-chat-translate` in the active profile's patch
- * (`~/.dsh/profiles/<profile>/cordis.patch.yml`). The standalone
- * ~/.dsh/dsh-chat-translate-config.json file is legacy (<=1.1) and is migrated
- * once at boot.
+ * The settings namespace this plugin owns. A namespace IS the Profile entry
+ * id, so the user-editable layer is the `config` row of `dsh-chat-translate`
+ * in the active profile's patch (`~/.dsh/profiles/<profile>/cordis.patch.yml`).
  */
 export declare const SETTINGS_NAMESPACE = "dsh-chat-translate";
 export declare const DEFAULT_CONFIG: PluginConfig;
-/**
- * Config keys an earlier release declared and this one no longer reads. DSH
- * resolves unknown keys through a non-strict schema and simply ignores them, so
- * a leftover from an upgraded profile would linger in the patch forever unless
- * it is actively unset once.
- *
- * `channels` predates 1.1 and was already retired then; it rides the same list
- * so one pass cleans any generation of an old profile.
- */
-export declare const RETIRED_CONFIG_KEYS: readonly ["channels", "concurrency", "timeoutMs", "thinkTimeoutMs", "aiEnabled", "bingEnabled", "thinkEnabled"];
 /**
  * Live read face of this plugin's own Config, as `ConfigManager` consumes it.
  *
@@ -53,7 +40,6 @@ export interface PluginConfigRefs {
     readonly aiTimeoutMs: Volatile<number>;
     readonly baseUrl: Volatile<string>;
     readonly model: Volatile<string>;
-    readonly targetLang: Volatile<string>;
 }
 /**
  * Read the current committed value of every Config field.
@@ -75,32 +61,8 @@ export declare function readPluginConfig(refs: PluginConfigRefs): PluginConfig;
  */
 export declare function createLiveConfigSource(onVolatileUpdate: (listener: () => void) => () => void, refs: PluginConfigRefs): ConfigSourceLike;
 /**
- * One path-addressed edit to a settings namespace's user section, matching
- * DSH's `SettingsPathOp` wire shape.
- */
-export type SettingsPathOpLike = {
-    op: 'set';
-    path: string[];
-    value: unknown;
-} | {
-    op: 'unset';
-    path: string[];
-};
-/**
- * Provider-level write face the legacy migration needs: DSH's `ctx.settings`
- * service itself, whose `mutate` applies path ops under one revision fence.
- */
-export interface SettingsMigrationTarget {
-    describe(): Array<{
-        ns: string;
-        user?: unknown;
-        revision?: number;
-    }>;
-    mutate(ns: string, ops: readonly SettingsPathOpLike[], expectedRevision?: number): Promise<unknown>;
-}
-/**
- * Config facade over this plugin's own live Config. No file I/O lives here
- * anymore: persistence, atomic writes, external-edit hot reload and the
+ * Config facade over this plugin's own live Config. This module does no file
+ * I/O: persistence, atomic writes, external-edit hot reload and the
  * browser-facing edit API are all owned by DSH itself.
  */
 export declare class ConfigManager {
@@ -112,31 +74,3 @@ export declare class ConfigManager {
     isAiConfigured(): boolean;
     onConfigChange(listener: (config: PluginConfig) => void): () => void;
 }
-/**
- * Coerce a raw record (legacy config file, HTTP-era partials) into a
- * validated partial config patch. Unknown fields are dropped, type-mismatched
- * values are skipped (the schema default wins), and numerics are clamped —
- * so one bad field never takes down a whole migration.
- */
-export declare function sanitizePatch(input: Record<string, unknown>): Partial<PluginConfig>;
-/**
- * One-shot retirement of config keys an earlier release declared. DSH hands
- * unknown keys through rather than rejecting them, so without this pass a
- * profile that predates the reply-body rewrite keeps dead keys forever.
- *
- * A tolerant, per-key unset: only keys the user layer actually carries are
- * written, and a failed write is logged and retried on the next boot rather
- * than taking down plugin load.
- *
- * @param settings - DSH's own settings service (the `mutate` write face).
- * @returns whether any retired key was removed.
- */
-export declare function retireRemovedConfigKeys(settings: SettingsMigrationTarget): Promise<boolean>;
-/**
- * One-shot migration from the pre-1.2 standalone config file. Runs only while
- * the settings namespace has no user layer yet, so values the user edited
- * after upgrading are never overwritten. The legacy file is removed whether
- * or not a migration happened.
- * @returns whether any legacy values were migrated.
- */
-export declare function migrateLegacyConfigFile(settings: SettingsMigrationTarget, legacyPath: string): Promise<boolean>;

package/lib/types/server/credentials.d.ts

@@ -2,9 +2,9 @@
  * API-key access through the DSH `ctx.credentials` service.
  *
  * The service owns ~/.dsh/.credentials.yaml (refs section, 0600 perms, env
- * shadowing, cross-process locking). The pre-1.2 hand-rolled YAML parser is
- * gone: reads go through `resolve`, writes through `set`/`unset`, and the
- * host's `credentials/reference-updated` event keeps the sync cache warm.
+ * shadowing, cross-process locking): reads go through `resolve`, writes through
+ * `set`/`unset`, and the host's `credentials/reference-updated` event keeps
+ * the sync cache warm.
  */
 /** Refs key that holds the translation API key. */
 export declare const TRANSLATE_API_KEY_REF = "TRANSLATE_API_KEY";