@drscrewdriver/dsh-better-display 0.3.3-fork.1

package/lib/types/skill-roots.js

@@ -0,0 +1,126 @@
+import { access, readdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { GENERATIVE_MCPAPPS_SKILL, skillListIncludes, skillRootEntryMatches, } from './skill-status.js';
+export function expandHomePath(path, home = homedir()) {
+    if (path === '~')
+        return home;
+    if (path.startsWith('~/') || path.startsWith('~\\'))
+        return join(home, path.slice(2));
+    return path;
+}
+/** `$DSH_HOME` or `~/.dsh`, matching official `resolveDshHome`. */
+export function resolveDshHome(env = process.env, home = homedir()) {
+    const fromEnv = env.DSH_HOME;
+    const selected = fromEnv !== undefined && fromEnv.trim().length > 0 ? fromEnv : join(home, '.dsh');
+    return resolve(expandHomePath(selected, home));
+}
+/** `$DSH_AGENTS_HOME` or `~/.agents`. */
+export function resolveAgentsHome(env = process.env, home = homedir()) {
+    const fromEnv = env.DSH_AGENTS_HOME;
+    const selected = fromEnv !== undefined && fromEnv.trim().length > 0 ? fromEnv : join(home, '.agents');
+    return resolve(expandHomePath(selected, home));
+}
+export function userSkillRoots(env = process.env, home = homedir()) {
+    return [
+        { source: 'user-dsh', path: join(resolveDshHome(env, home), 'skills') },
+        { source: 'user-agents', path: join(resolveAgentsHome(env, home), 'skills') },
+    ];
+}
+export function projectSkillRoots(projectRoot) {
+    return [
+        { source: 'project-dsh', path: join(projectRoot, '.dsh', 'skills') },
+        { source: 'project-agents', path: join(projectRoot, '.agents', 'skills') },
+    ];
+}
+export async function findProjectRoot(cwd) {
+    let current = resolve(cwd);
+    while (true) {
+        if (existsSync(join(current, '.git')))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return resolve(cwd);
+        current = parent;
+    }
+}
+export async function rootHasGenerativeMcpapps(rootPath) {
+    let entries;
+    try {
+        entries = await readdir(rootPath, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const entry of entries) {
+        if (entry.name === '.system')
+            continue;
+        if (!skillRootEntryMatches(entry.name))
+            continue;
+        if (entry.isDirectory()) {
+            try {
+                await access(join(rootPath, entry.name, 'SKILL.md'));
+                return true;
+            }
+            catch {
+                continue;
+            }
+        }
+        if (entry.isFile())
+            return true;
+    }
+    return false;
+}
+/** Resolve the plugin-shipped pack. This path is never treated as a skill root. */
+export function pluginSkillPackPath(moduleUrl = import.meta.url) {
+    const here = dirname(fileURLToPath(moduleUrl));
+    const candidates = [
+        join(here, '../skills', GENERATIVE_MCPAPPS_SKILL),
+        join(here, '../../skills', GENERATIVE_MCPAPPS_SKILL),
+        join(here, 'skills', GENERATIVE_MCPAPPS_SKILL),
+    ];
+    return candidates.find(path => existsSync(join(path, 'SKILL.md')));
+}
+export async function scanGenerativeMcpappsStatus(options = {}) {
+    const env = options.env ?? process.env;
+    const home = options.home ?? homedir();
+    const roots = [...userSkillRoots(env, home)];
+    const cwd = typeof options.cwd === 'string' && options.cwd.trim().length > 0
+        ? (isAbsolute(options.cwd) ? options.cwd : resolve(options.cwd))
+        : undefined;
+    if (cwd !== undefined)
+        roots.unshift(...projectSkillRoots(await findProjectRoot(cwd)));
+    const inspected = [];
+    let rootHit = false;
+    for (const root of roots) {
+        const present = await rootHasGenerativeMcpapps(root.path);
+        inspected.push({ ...root, present });
+        if (present)
+            rootHit = true;
+    }
+    let via = null;
+    let listHit = false;
+    if (options.listSkills) {
+        try {
+            listHit = skillListIncludes(await options.listSkills());
+            if (listHit)
+                via = 'skills.list';
+        }
+        catch {
+            // Registry/RPC absence falls back to the scanned roots.
+        }
+    }
+    if (!listHit && rootHit)
+        via = 'skill-root';
+    const packPath = options.packPath ?? pluginSkillPackPath();
+    return {
+        name: GENERATIVE_MCPAPPS_SKILL,
+        installed: listHit || rootHit,
+        via,
+        roots: inspected,
+        ...packPath !== undefined ? { packPath } : {},
+    };
+}
+//# sourceMappingURL=skill-roots.js.map

package/lib/types/skill-roots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-roots.js","sourceRoot":"","sources":["../../src/skill-roots.ts"],"names":[],"mappings":"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"}

package/lib/types/skill-status.d.ts

@@ -0,0 +1,36 @@
+/** Shared generative-mcpapps identity. Plugin-tree presence is not installation. */
+export declare const GENERATIVE_MCPAPPS_SKILL = "generative-mcpapps";
+/** Conventional relative roots only. Never expand $HOME or dump host `root.path`. */
+export declare const CONVENTIONAL_SKILL_ROOTS: readonly [".dsh/skills", ".agents/skills"];
+/** Copy source relative to the plugin / checkout, not an absolute pack path. */
+export declare const SKILL_PACK_RELATIVE = "skills/generative-mcpapps";
+export type SkillRootSource = 'project-dsh' | 'project-agents' | 'user-dsh' | 'user-agents' | 'custom' | 'bundled' | (string & {});
+export interface SkillRootInfo {
+    readonly source: SkillRootSource;
+    readonly path: string;
+    readonly present?: boolean;
+}
+export interface HostSkillStatus {
+    readonly name: typeof GENERATIVE_MCPAPPS_SKILL;
+    readonly installed: boolean;
+    readonly via: 'skills.list' | 'skill-root' | null;
+    readonly roots: readonly SkillRootInfo[];
+    /** Plugin-shipped pack path for copy guidance. Not a harness skill root. */
+    readonly packPath?: string;
+}
+export declare function skillNameMatches(name: unknown): boolean;
+export declare function skillListIncludes(entries: readonly {
+    readonly name?: string;
+}[] | undefined): boolean;
+/** Directory bundle `name/SKILL.md` or flat `name.md` at a scanned root. */
+export declare function skillRootEntryMatches(entryName: string): boolean;
+export declare function skillsFromListResult(result: unknown): {
+    name?: string;
+}[];
+export declare function publicSkillRoots(): readonly SkillRootInfo[];
+/**
+ * Strip host home / pack absolutes before anything user-facing (HTTP or Settings).
+ * Detection still uses the raw scan; this is the public face.
+ */
+export declare function toPublicSkillStatus(status: HostSkillStatus): HostSkillStatus;
+//# sourceMappingURL=skill-status.d.ts.map

package/lib/types/skill-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-status.d.ts","sourceRoot":"","sources":["../../src/skill-status.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,eAAO,MAAM,wBAAwB,uBAAuB,CAAC;AAE7D,qFAAqF;AACrF,eAAO,MAAM,wBAAwB,4CAA6C,CAAC;AAEnF,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,8BAAuC,CAAC;AAExE,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,gBAAgB,GAChB,UAAU,GACV,aAAa,GACb,QAAQ,GACR,SAAS,GACT,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,wBAAwB,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS,GAAG,OAAO,CAErG;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAgBzE;AAED,wBAAgB,gBAAgB,IAAI,SAAS,aAAa,EAAE,CAE3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAO5E"}

package/lib/types/skill-status.js

@@ -0,0 +1,51 @@
+/** Shared generative-mcpapps identity. Plugin-tree presence is not installation. */
+export const GENERATIVE_MCPAPPS_SKILL = 'generative-mcpapps';
+/** Conventional relative roots only. Never expand $HOME or dump host `root.path`. */
+export const CONVENTIONAL_SKILL_ROOTS = ['.dsh/skills', '.agents/skills'];
+/** Copy source relative to the plugin / checkout, not an absolute pack path. */
+export const SKILL_PACK_RELATIVE = `skills/${GENERATIVE_MCPAPPS_SKILL}`;
+export function skillNameMatches(name) {
+    return typeof name === 'string' && name === GENERATIVE_MCPAPPS_SKILL;
+}
+export function skillListIncludes(entries) {
+    return Array.isArray(entries) && entries.some(entry => skillNameMatches(entry?.name));
+}
+/** Directory bundle `name/SKILL.md` or flat `name.md` at a scanned root. */
+export function skillRootEntryMatches(entryName) {
+    return entryName === GENERATIVE_MCPAPPS_SKILL || entryName === `${GENERATIVE_MCPAPPS_SKILL}.md`;
+}
+export function skillsFromListResult(result) {
+    if (Array.isArray(result))
+        return result;
+    if (result === null || typeof result !== 'object')
+        return [];
+    const record = result;
+    if (record.ok === false)
+        return [];
+    if (Array.isArray(record.skills))
+        return record.skills;
+    if (record.value && typeof record.value === 'object') {
+        const value = record.value;
+        if (Array.isArray(value.skills))
+            return value.skills;
+        if (Array.isArray(record.value))
+            return record.value;
+    }
+    return [];
+}
+export function publicSkillRoots() {
+    return CONVENTIONAL_SKILL_ROOTS.map(path => ({ source: 'conventional', path }));
+}
+/**
+ * Strip host home / pack absolutes before anything user-facing (HTTP or Settings).
+ * Detection still uses the raw scan; this is the public face.
+ */
+export function toPublicSkillStatus(status) {
+    return {
+        name: status.name,
+        installed: status.installed,
+        via: status.via,
+        roots: publicSkillRoots(),
+    };
+}
+//# sourceMappingURL=skill-status.js.map

package/lib/types/skill-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-status.js","sourceRoot":"","sources":["../../src/skill-status.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,MAAM,CAAC,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AAE7D,qFAAqF;AACrF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,aAAa,EAAE,gBAAgB,CAAU,CAAC;AAEnF,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,wBAAwB,EAAE,CAAC;AA0BxE,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,wBAAwB,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAA0D;IAC1F,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,SAAS,KAAK,wBAAwB,IAAI,SAAS,KAAK,GAAG,wBAAwB,KAAK,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAe;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC7D,MAAM,MAAM,GAAG,MAId,CAAC;IACF,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,MAA6B,CAAC;IAC9E,IAAI,MAAM,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,MAAM,CAAC,KAA6B,CAAC;QACnD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC,MAA6B,CAAC;QAC5E,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC,KAA4B,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAuB;IACzD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,gBAAgB,EAAE;KAC1B,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,133 @@
+{
+  "name": "@drscrewdriver/dsh-better-display",
+  "version": "0.3.3-fork.1",
+  "description": "A calmer reading view for DeepSeek Harness: native process details, live reasoning, and clean final answers. Fork adds answer message bubbles with a settings switch.",
+  "type": "module",
+  "license": "MIT",
+  "main": "lib/dsh-better-display.js",
+  "types": "lib/types/dsh-better-display.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/dsh-better-display.d.ts",
+      "default": "./lib/dsh-better-display.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-client-ui-chat",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-session"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "node scripts/check-harness-compat.mjs && tsc -p tsconfig.json && tsdown",
+    "check:harness": "node scripts/check-harness-compat.mjs",
+    "test:official": "node scripts/verify-official-bridge.mjs",
+    "test:auto-fold": "node scripts/verify-auto-fold.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --import tsx/esm --test tests/*.test.ts",
+    "link:harness": "node scripts/link-harness-dependencies.mjs"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-api-session-controller": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-attachment": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-client-store": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-client-ui-chat": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-client-ui-session": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-client-ui-tool": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-session": ">=0.1.7-rc.1 <0.1.8",
+    "@deepseek-ai/dsh-util-workspace-path": ">=0.1.7-rc.1 <0.1.8",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session-turn-outline": "0.1.7-rc.2",
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "lightningcss": "^1.33.0",
+    "tsdown": "^0.22.2",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "clsx": "^2.0.0",
+    "katex": "^0.16.47",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-math": "^3.0.0",
+    "micromark-core-commonmark": "^2.0.3",
+    "micromark-extension-gfm": "^3.0.0",
+    "micromark-extension-math": "^3.1.0",
+    "micromark-factory-space": "^2.0.1",
+    "micromark-util-character": "^2.1.1",
+    "micromark-util-classify-character": "^2.0.1",
+    "micromark-util-sanitize-uri": "^2.0.1",
+    "micromark-util-symbol": "^2.0.1",
+    "micromark-util-types": "^2.0.2"
+  },
+  "files": [
+    "lib",
+    "skills",
+    "src",
+    "tests",
+    "scripts",
+    "cordis.yml",
+    "cordis.patch.yml",
+    "dshx.yml",
+    "tsconfig.json",
+    "tsdown.config.ts",
+    "README.md",
+    "README.en.md",
+    "DESIGN.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "CHANGELOG.md",
+    "compat",
+    "docs"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/drscrewdriver/dsh-better-display.git"
+  },
+  "homepage": "https://github.com/drscrewdriver/dsh-better-display#readme",
+  "bugs": {
+    "url": "https://github.com/drscrewdriver/dsh-better-display/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "dshx",
+    "conversation",
+    "reasoning",
+    "streaming",
+    "accessibility"
+  ]
+}

package/scripts/build-motion-fixture.mjs

@@ -0,0 +1,26 @@
+import { createRequire } from 'node:module';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+const require = createRequire(import.meta.url);
+const deps = createRequire(require.resolve('tsdown'));
+const { rolldown } = await import(pathToFileURL(deps.resolve('rolldown')).href);
+const { transform } = deps('lightningcss');
+const build = await rolldown({ input: process.argv[2] ?? 'tests/browser-motion.tsx', platform: 'browser', transform: { jsx: { runtime: 'automatic' }, define: { 'process.env.NODE_ENV': JSON.stringify('production') } }, plugins: [{
+  name: 'fixture-css',
+  resolveId(source, importer) { if (source.endsWith('.module.css')) return resolve(importer ? resolve(importer,'..') : '.',source) + '.mjs'; },
+  async load(id) {
+    if (!id.endsWith('.module.css.mjs')) return;
+    const path = id.slice(0, -4);
+    const {code,exports} = transform({filename:path,code:await readFile(path),cssModules:{pattern:'[hash]_[local]'}});
+    const map=Object.fromEntries(Object.entries(exports).map(([key,value])=>[key,value.name]));
+    return `const style=document.createElement('style');style.textContent=${JSON.stringify(code.toString())};document.head.append(style);export default ${JSON.stringify(map)};`;
+  },
+}] });
+await mkdir('.delivery',{recursive:true});
+const result = await build.generate({ format:'iife', name:'ReaderMotionFixture' });
+const js=result.output.find(x=>x.type==='chunk').code;
+await writeFile('.delivery/motion-fixture.js',js);
+await writeFile('.delivery/motion-fixture.html',`<!doctype html><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Reader transition verification</title><style>body{margin:0;font:16px/1.75 system-ui;background:#fff;color:#242424;--dsw-alias-label-primary:#242424;--dsw-alias-label-secondary:#666;--dsw-alias-label-tertiary:#888;--dsw-alias-bg-base:#fff;--dsw-alias-bg-module-platform:#f6f7f8;--dsw-alias-border-l2:#dedede}button{cursor:pointer}</style><div id="app"></div><script>${js.replaceAll('</script','<\\/script')}</script>`);
+await build.close();
+console.log('Built .delivery/motion-fixture.html using actual plugin components');

package/scripts/check-harness-compat.mjs

@@ -0,0 +1,71 @@
+/** Upgrade gate for the public composition adapter and remaining Markdown fork. */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+
+const root = resolve(import.meta.dirname, '..');
+const harness = resolve(process.env.DSHX_HARNESS?.trim() || readFileSync(join(homedir(), '.config/dshx/harness'), 'utf8').trim());
+const baselineFile = join(root, 'compat/harness-rc2.json');
+const ts = createRequire(join(root, 'package.json'))('typescript');
+const files = [
+  'packages/client/ui-slots/src/index.ts',
+  'packages/client/ui-slots/src/renderer.ts',
+  'packages/client/ui-renderer/src/client/registry.ts',
+  'packages/client/ui-renderer/src/client/scoped-slots.tsx',
+  'packages/client/ui-chat/src/client/contract/slots.ts',
+  'packages/client/ui-tool/src/client/contract/slots.ts',
+  'packages/client/ui-deliverables/src/client/Deliverables.tsx',
+  'packages/client/ui-chat/src/client/chat/AssistantMarkdown.tsx',
+  'packages/client/ui-chat/src/client/chat/MessageItem.tsx',
+  'packages/client/ui-chat/src/client/chat/AssistantNodeView.tsx',
+  'packages/client/ui-chat/src/client/chat/TurnTailNodeView.tsx',
+  'packages/client/ui-chat/src/client/chat/TurnProcessNodeView.tsx',
+  'packages/client/ui-tool/src/client/tool/models/tool-call-model.ts',
+  ...['MarkdownText.tsx', 'render.tsx', 'parse.ts', 'incremental.ts', 'katex.tsx'].map(name => `packages/client/ui-primitives/src/markdown/${name}`),
+];
+const hashes = Object.fromEntries(files.map(file => [file, createHash('sha256').update(readFileSync(join(harness, file))).digest('hex')]));
+const registrations = [];
+for (const path of execFileSync('rg', ['--files', 'packages/client', '-g', '*.ts', '-g', '*.tsx'], { cwd: harness, encoding: 'utf8' }).trim().split('\n')) {
+  if (!path.includes('/src/client/')) continue;
+  const text = readFileSync(join(harness, path), 'utf8');
+  if (!/conversation\.chat\.|tool\.call\.|conversation\.message\./u.test(text)) continue;
+  const file = ts.createSourceFile(path, text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+  function visit(node) {
+    if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text === 'register') {
+      const options = node.arguments[0];
+      if (options && ts.isObjectLiteralExpression(options)) {
+        const fields = {};
+        for (const p of options.properties) {
+          if (ts.isPropertyAssignment(p) && ts.isStringLiteral(p.initializer)) fields[p.name.getText(file).replaceAll("'", '').replaceAll('"', '')] = p.initializer.text;
+        }
+        if (/^(conversation\.chat\.|tool\.call\.|conversation\.message\.)/u.test(fields.name ?? '')) {
+          registrations.push(`${fields.name} | ${fields.key ?? fields.id ?? '(chain/single)'} | ${path}`);
+        }
+      }
+    }
+    ts.forEachChild(node, visit);
+  }
+  visit(file);
+}
+registrations.sort();
+const current = {
+  harnessVersion: JSON.parse(readFileSync(join(harness, 'packages/client/ui-chat/package.json'), 'utf8')).version,
+  hashes, registrations,
+};
+if (process.argv.includes('--record')) {
+  writeFileSync(baselineFile, JSON.stringify(current, null, 2) + '\n');
+  console.log(`Recorded candidate baseline: ${current.harnessVersion}; run build, fixtures and DSH acceptance before committing it.`);
+} else {
+  const baseline = JSON.parse(readFileSync(baselineFile, 'utf8'));
+  const changed = files.filter(file => current.hashes[file] !== baseline.hashes[file]);
+  const added = registrations.filter(row => !baseline.registrations.includes(row));
+  const removed = baseline.registrations.filter(row => !registrations.includes(row));
+  if (current.harnessVersion !== baseline.harnessVersion || changed.length || added.length || removed.length) {
+    console.error(JSON.stringify({ compatible: 'review-required', target: current.harnessVersion, changedContractsOrForkSources: changed, addedRegistrations: added, removedRegistrations: removed }, null, 2));
+    console.error('Review the differences and run the official bridge/visual tests. --record alone is not compatibility proof.');
+    process.exitCode = 1;
+  } else console.log(`Harness compatibility baseline passed (${current.harnessVersion}; ${registrations.length} official registrations).`);
+}

package/scripts/link-harness-dependencies.mjs

@@ -0,0 +1,54 @@
+import { existsSync, mkdirSync, symlinkSync, realpathSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+
+const root = resolve(process.argv[2] || '');
+if (!process.argv[2] || !existsSync(join(root, 'tools/dshx/src/client-build.js'))) throw new Error('Pass a prepared Harness checkout.');
+const local = resolve('node_modules');
+mkdirSync(local, { recursive: true });
+const shared = {
+  '@deepseek-ai/cordis': 'vendor/cordis',
+  '@deepseek-ai/dsh-api-remotes': 'packages/api/remotes',
+  '@deepseek-ai/dsh-api-session-controller': 'packages/api/session-controller',
+  '@deepseek-ai/dsh-client-connection': 'packages/client/connection',
+  '@deepseek-ai/dsh-session-turn-outline': 'packages/session/session-turn-outline',
+  '@deepseek-ai/dsh-client-store': 'packages/client/store',
+  '@deepseek-ai/dsh-client-ui-chat': 'packages/client/ui-chat',
+  '@deepseek-ai/dsh-client-ui-conversation': 'packages/client/ui-conversation',
+  '@deepseek-ai/dsh-client-ui-primitives': 'packages/client/ui-primitives',
+  '@deepseek-ai/dsh-client-ui-renderer': 'packages/client/ui-renderer',
+  '@deepseek-ai/dsh-client-ui-session': 'packages/client/ui-session',
+  '@deepseek-ai/dsh-client-ui-slots': 'packages/client/ui-slots',
+  '@deepseek-ai/dsh-client-ui-tool': 'packages/client/ui-tool',
+  '@deepseek-ai/dsh-attachment': 'packages/attachment/attachment',
+  '@deepseek-ai/dsh-session': 'packages/core/session',
+  '@deepseek-ai/dsh-util-workspace-path': 'packages/util/workspace-path',
+};
+function link(name, target) {
+  if (!existsSync(target)) throw new Error(`Missing Harness dependency target: ${name} (${target})`);
+  const destination = join(local, name);
+  mkdirSync(dirname(destination), { recursive: true });
+  if (existsSync(destination)) {
+    if (realpathSync(destination) !== realpathSync(target)) throw new Error(`Dependency mismatch: ${name}`);
+    return;
+  }
+  symlinkSync(target, destination);
+}
+for (const [name, path] of Object.entries(shared)) link(name, join(root, path));
+const require = createRequire(join(root, 'packages/client/ui-conversation/package.json'));
+const rootRequire = createRequire(join(root, 'package.json'));
+for (const name of ['react', '@types/react']) link(name, dirname(require.resolve(`${name}/package.json`)));
+for (const name of ['@types/node', 'typescript', 'tsdown', 'tsx']) link(name, dirname(rootRequire.resolve(`${name}/package.json`)));
+for (const name of ['@types/mdast', 'clsx', 'katex', 'mdast-util-from-markdown', 'mdast-util-gfm', 'mdast-util-math', 'micromark-core-commonmark', 'micromark-extension-gfm', 'micromark-extension-math', 'micromark-factory-space', 'micromark-util-character', 'micromark-util-classify-character', 'micromark-util-sanitize-uri', 'micromark-util-symbol', 'micromark-util-types']) {
+  link(name, join(root, 'packages/client/ui-primitives/node_modules', name));
+}
+mkdirSync(join(local, '.bin'), { recursive: true });
+for (const name of ['typescript', 'tsdown']) {
+  const pkg = JSON.parse(readFileSync(join(local, name, 'package.json'), 'utf8'));
+  const bins = typeof pkg.bin === 'string' ? { [name]: pkg.bin } : pkg.bin;
+  for (const [command, path] of Object.entries(bins)) {
+    const target = join(local, '.bin', command);
+    if (!existsSync(target)) symlinkSync(join(local, name, path), target);
+  }
+}
+console.log('Development dependencies linked to the selected Harness; no package download or Harness mutation.');

package/scripts/verify-auto-fold.mjs

@@ -0,0 +1,114 @@
+/** Real Reader interaction regression, isolated from the user's Host and data. */
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+const root = resolve(import.meta.dirname, '..');
+const harness = process.env.DSHX_HARNESS;
+if (!harness) throw new Error('Set DSHX_HARNESS to the target checkout.');
+const require = createRequire(join(root, 'package.json'));
+const webRequire = createRequire(join(harness, 'packages/client/web/package.json'));
+const { build } = await import(pathToFileURL(createRequire(require.resolve('tsx')).resolve('esbuild')).href);
+const { launchPinnedChromium } = await import(pathToFileURL(join(homedir(), '.codex/playwright-runtime/runtime.mjs')).href);
+const out = join(root, '.evidence/auto-fold');
+await mkdir(out, { recursive: true });
+await build({
+  entryPoints: [join(root, 'tests/browser-auto-fold.tsx')], outfile: join(out, 'fixture.js'),
+  bundle: true, platform: 'browser', format: 'esm', jsx: 'automatic',
+  alias: {
+    '@deepseek-ai/dsh-client-ui-primitives': join(harness, 'packages/client/ui-primitives/src/index.ts'),
+    react: dirname(require.resolve('react/package.json')), 'react-dom': dirname(webRequire.resolve('react-dom/package.json')),
+  },
+  loader: { '.woff2': 'dataurl', '.woff': 'dataurl', '.ttf': 'dataurl', '.svg': 'dataurl' },
+});
+const server = createServer(async (req, res) => {
+  const file = req.url === '/fixture.js' ? 'fixture.js' : req.url === '/fixture.css' ? 'fixture.css' : null;
+  if (file) { res.setHeader('Content-Type', file.endsWith('.js') ? 'text/javascript' : 'text/css'); res.end(await readFile(join(out, file))); return; }
+  if (req.url !== '/') { res.writeHead(404); res.end(); return; }
+  res.setHeader('Content-Type', 'text/html');
+  res.end('<!doctype html><html lang="zh"><meta charset="utf-8"><link rel="stylesheet" href="/fixture.css"><style>body{margin:0;font:14px/1.6 system-ui;--dsw-alias-label-primary:#222;--dsw-alias-label-secondary:#666;--dsw-alias-label-tertiary:#888;--dsw-alias-bg-base:#fff;--dsw-alias-border-l2:#ddd}button{cursor:pointer}</style><div id="app"></div><script type="module" src="/fixture.js"></script></html>');
+});
+await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
+let browser;
+const results = [];
+try {
+  browser = await launchPinnedChromium();
+  for (const reducedMotion of ['no-preference', 'reduce']) {
+    const page = await browser.newPage({ viewport: { width: 1200, height: 1000 }, reducedMotion });
+    page.setDefaultTimeout(4000);
+    const errors = [];
+    page.on('pageerror', error => errors.push(String(error)));
+    await page.goto(`http://127.0.0.1:${server.address().port}/`);
+    const closed = page.locator('[data-reader-turn="1"]');
+    const live = page.locator('[data-reader-turn="2"]');
+    const completedThought = closed.getByText('已完成思考 0', { exact: true });
+    const oldLiveThought = live.getByText('进行中思考 0', { exact: true });
+    const latestThought = live.getByText('进行中思考 1', { exact: true });
+    const toggle = () => page.getByRole('button', { name: /^自动折叠[开关]$/ }).click();
+    await page.getByRole('button', { name: '自动折叠开', exact: true }).waitFor();
+    await latestThought.waitFor();
+    assert.equal(await completedThought.count(), 0);
+
+    // Reading while auto-fold is off used to persist a manual expansion forever.
+    await toggle();
+    await completedThought.click();
+    assert.ok(Object.values(await page.evaluate(() => window.autoFoldFixture.state().expanded)).includes(true));
+    await toggle();
+    await completedThought.waitFor({ state: 'hidden' });
+    await latestThought.waitFor();
+    await closed.getByText('最终回答始终保留', { exact: true }).waitFor();
+
+    // A prior-steps disclosure has its own state, separate from the store.
+    await live.getByRole('button', { name: '展开此前步骤', exact: true }).click();
+    await oldLiveThought.waitFor();
+    await toggle();
+    await toggle();
+    await oldLiveThought.waitFor({ state: 'hidden' });
+    await latestThought.waitFor();
+
+    // Fresh manual choices still work after automatic folding is restored.
+    await closed.getByRole('button', { name: '展开思考与过程', exact: true }).click();
+    await completedThought.waitFor();
+    await page.evaluate(() => window.autoFoldFixture.preference(false));
+    await page.getByRole('button', { name: '自动折叠关', exact: true }).waitFor();
+    await page.evaluate(() => window.autoFoldFixture.preference(true));
+    await completedThought.waitFor({ state: 'hidden' });
+
+    // Active text selection still protects reading until the user clears it.
+    await toggle();
+    await completedThought.evaluate(async element => {
+      const range = document.createRange();
+      range.selectNodeContents(element);
+      document.getSelection().removeAllRanges();
+      document.getSelection().addRange(range);
+      document.dispatchEvent(new Event('selectionchange'));
+      await new Promise(requestAnimationFrame);
+    });
+    await page.evaluate(() => window.autoFoldFixture.preference(true));
+    await page.getByRole('button', { name: '自动折叠开', exact: true }).waitFor();
+    await closed.getByRole('button', { name: '收起思考与过程', exact: true }).waitFor();
+    assert.equal(await page.evaluate(() => document.getSelection().toString()), '已完成思考 0');
+    await page.evaluate(() => document.getSelection().removeAllRanges());
+    await completedThought.waitFor({ state: 'hidden' });
+
+    // Rapid reversal must settle with automatic folding enabled.
+    for (let i = 0; i < 6; i++) await toggle();
+    await completedThought.waitFor({ state: 'hidden' });
+    await oldLiveThought.waitFor({ state: 'hidden' });
+    await latestThought.waitFor();
+    assert.deepEqual(errors, []);
+    assert.equal(await page.getByText('此内容暂时无法展示', { exact: false }).count(), 0);
+    await page.screenshot({ path: join(out, `${reducedMotion}.png`) });
+    results.push({ reducedMotion, passed: true, paths: ['read-while-off', 'prior-steps-override', 'new-manual-choice', 'settings-toggle', 'active-selection', 'rapid-reversal', 'latest-and-final-content'] });
+    await page.close();
+  }
+  await writeFile(join(out, 'result.json'), JSON.stringify({ passed: true, results }, null, 2));
+  console.log(JSON.stringify({ passed: true, results }));
+} finally {
+  await browser?.close();
+  await new Promise(resolve => server.close(resolve));
+}