dsh-reference-anything 0.2.2 → 0.2.4

package/README.md

@@ -26,9 +26,12 @@ Within the unified `@` menu of DeepSeek Harness (DSH), reference commands, Skill
 
 This plugin uses OpenCLI to access historical conversations through AI chat sessions that are already logged in. By default, only conversation titles are stored locally, and the agent fetches remote content on demand. An optional offline-mirror mode stores the latest complete conversation bodies locally.
 
+> [!NOTE]
+> DSH is currently in Beta, so its underlying capabilities and interfaces may change as it evolves. This plugin will adapt alongside those changes. Because of some current DSH limitations, parts of the implementation may not yet be ideal; we will continue to follow DSH updates and improve the plugin over time. See the relevant sections below for specific limitations and usage notes.
+
 ## News
 
-- **2026-08-19 · v0.2.2** — Added automatic version checks and in-settings updates, Pill/Raw text input rendering modes, and reusable background browser sessions for more reliable OpenCLI synchronization and input interactions.
+- **2026-08-19 · v0.2.3** — Added automatic version checks and in-settings updates, Pill/Raw text input rendering modes, and reusable background browser sessions for more reliable OpenCLI synchronization and input interactions.
 - **2026-08-18 · v0.2.0** — A redesigned Reference Anything settings page with local session statistics, paginated management, Provider/Profile selection, and sync status checks.
 - **2026-08-18** — Introduced on-demand read protocol: references default to safe pointers, and the agent reads the body and attachments only after authorization.
 - **2026-08-17** — Unified ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi under the DSH `@` menu.

package/lib/client.js

@@ -15477,6 +15477,7 @@ var zh = {
   "settings.adapterInstalled": "\u5DF2\u5B89\u88C5\u4E14\u53EF\u53D1\u73B0",
   "settings.adapterInstalledVersion": "\u5DF2\u5B89\u88C5\u4E14\u53EF\u53D1\u73B0\uFF08v{version}\uFF09",
   "settings.adapterMissing": "\u672A\u5B89\u88C5\u9002\u914D\u5668",
+  "settings.adapterLoadFailed": "\u9002\u914D\u5668\u5DF2\u767B\u8BB0\u4F46\u52A0\u8F7D\u5931\u8D25\uFF1A{error}",
   "settings.adapterIncomplete": "\u9002\u914D\u5668\u5305\u4E0D\u5B8C\u6574\uFF0C\u672A\u6CE8\u518C\u5168\u90E8\u516D\u4E2A\u5BF9\u8BDD\u6765\u6E90",
   "settings.adapterVersionUnsupported": "\u9002\u914D\u5668\u7248\u672C {version} \u8FC7\u65E7\u6216\u65E0\u6CD5\u8BC6\u522B",
   "settings.adapterStillUnavailable": "\u5B89\u88C5\u540E\u5BF9\u8BDD\u9002\u914D\u5668\u4ECD\u4E0D\u53EF\u7528\u3002",
@@ -15513,11 +15514,12 @@ var zh = {
   "settings.setupStep.complete": "\u6240\u6709\u68C0\u67E5\u5747\u5DF2\u901A\u8FC7\u3002",
   "settings.install": "\u5B89\u88C5\u9002\u914D\u5668",
   "settings.reinstall": "\u91CD\u65B0\u5B89\u88C5\u9002\u914D\u5668",
+  "settings.repairAdapter": "\u4FEE\u590D\u9002\u914D\u5668",
   "settings.oneClickSetup": "\u4E00\u952E\u5B89\u88C5",
   "settings.restartDaemon": "\u91CD\u542F\u6D4F\u89C8\u5668\u6865\u63A5\u670D\u52A1",
   "settings.restarting": "\u6B63\u5728\u91CD\u542F\u2026",
   "settings.serviceActions": "\u670D\u52A1\u64CD\u4F5C",
-  "settings.serviceActionsDetail": "\u4E00\u952E\u5B89\u88C5\u4F1A\u81EA\u52A8\u5B89\u88C5\u9002\u914D\u5668\u3001\u542F\u52A8\u5B88\u62A4\u8FDB\u7A0B\u5E76\u6253\u5F00\u6D4F\u89C8\u5668\u6269\u5C55\u5B89\u88C5\u9875\uFF1B\u4E5F\u53EF\u5355\u72EC\u5B89\u88C5\u9002\u914D\u5668\u6216\u91CD\u542F\u6D4F\u89C8\u5668\u6865\u63A5\u670D\u52A1\u3002",
+  "settings.serviceActionsDetail": "\u4E00\u952E\u5B89\u88C5\u4F1A\u6309\u9700\u5B89\u88C5\u6216\u4FEE\u590D\u9002\u914D\u5668\u3001\u542F\u52A8\u5B88\u62A4\u8FDB\u7A0B\uFF0C\u5E76\u5F15\u5BFC\u5B89\u88C5\u6D4F\u89C8\u5668\u6269\u5C55\u3002",
   "settings.general": "\u901A\u7528\u8BBE\u7F6E",
   "settings.generalDetail": "\u63A7\u5236 @ \u9762\u677F\u4E2D\u53EF\u7528\u7684\u7C7B\u522B\u3001\u663E\u793A\u987A\u5E8F\u53CA\u6BCF\u7C7B\u6700\u591A\u663E\u793A\u7684\u6761\u76EE\u6570\u3002\u5173\u95ED\u67D0\u7C7B\u540E\uFF0C\u5B83\u4E0D\u4F1A\u51FA\u73B0\u5728 @ \u9762\u677F\uFF0C\u4E5F\u4E0D\u4F1A\u5411 Agent \u63D0\u4F9B\u5BF9\u5E94\u6307\u4EE4\u3002",
   "settings.inputRenderMode": "\u8F93\u5165\u6846\u6E32\u67D3",
@@ -15650,6 +15652,7 @@ var en = {
   "settings.updateConfirm": "Update Reference Anything to v{version}? Restart DSH after the update completes.",
   "settings.github": "GitHub",
   "settings.adapterIncomplete": "The adapter package is incomplete and did not register all six conversation sources.",
+  "settings.adapterLoadFailed": "The adapter is registered but failed to load: {error}",
   "settings.setupStep.checking": "Rechecking every dependency\u2026",
   "settings.setupStep.opencli": "Finding, installing, or upgrading OpenCLI\u2026",
   "settings.setupStep.adapter": "Installing the conversation adapter\u2026",
@@ -15717,11 +15720,12 @@ var en = {
   "settings.moveUp": "Move {item} up",
   "settings.moveDown": "Move {item} down",
   "settings.reinstall": "Reinstall adapter",
+  "settings.repairAdapter": "Repair adapter",
   "settings.oneClickSetup": "One-click setup",
   "settings.settingUp": "Setting up\u2026",
   "settings.restartDaemon": "Restart Browser Bridge",
   "settings.serviceActions": "Service actions",
-  "settings.serviceActionsDetail": "One-click setup installs the adapter, starts the daemon, and opens the extension install page; you can also install the adapter or restart Browser Bridge individually.",
+  "settings.serviceActionsDetail": "One-click setup installs or repairs the adapter as needed, starts the daemon, and guides browser-extension installation.",
   "notice.daemonRestarted": "Browser Bridge restarted.",
   "notice.oneClickSetup": 'Extension install page opened. Click "Add to Chrome", then Recheck here.',
   "notice.updateInstalled": "Reference Anything updated to v{version}. Restart DSH to load the new version.",
@@ -15994,6 +15998,7 @@ function ConversationSettings({ useScope, save, sync, cancel, refresh, refreshOn
   const daemonReady = Boolean(state.health?.daemonRunning && !state.health.daemonStale);
   const extensionReady = Boolean(state.health?.extensionConnected && state.health.connectivityOk);
   const adapterReady = Boolean(state.health?.pluginInstalled && state.health.adapterCompatible);
+  const adapterNeedsRepair = Boolean(state.health?.pluginInstalled && !adapterReady);
   const runAction = (name, action) => {
     if (busyActionRef.current || state.loading) return;
     busyActionRef.current = true;
@@ -16216,7 +16221,7 @@ function ConversationSettings({ useScope, save, sync, cancel, refresh, refreshOn
                 label: t("check.conversationAdapter"),
                 detail: adapterStateDetail(state.health, t),
                 ready: adapterReady,
-                actionLabel: !opencliReady ? t("settings.installOpenCli") : state.health?.pluginInstalled ? t("settings.reinstall") : t("settings.install"),
+                actionLabel: !opencliReady ? t("settings.installOpenCli") : adapterNeedsRepair ? t("settings.repairAdapter") : state.health?.pluginInstalled ? t("settings.reinstall") : t("settings.install"),
                 actionBusy: busyAction === "adapter",
                 actionDisabled: Boolean(busyAction),
                 onAction: () => {
@@ -16236,18 +16241,10 @@ function ConversationSettings({ useScope, save, sync, cancel, refresh, refreshOn
               /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("strong", { children: t("settings.serviceActions") }),
               /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { children: t("settings.serviceActionsDetail") })
             ] }),
-            /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dsh_ref_service_actions", children: [
-              /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { className: "is_primary", type: "button", disabled: state.loading || Boolean(busyAction), onClick: () => {
-                const opened = state.health?.extensionConnected ? true : openStore();
-                runAction("setup", () => setupAll(opened));
-              }, children: busyAction === "setup" ? t("settings.settingUp") : t("settings.oneClickSetup") }),
-              /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { type: "button", disabled: state.loading || Boolean(busyAction) || !opencliReady, onClick: () => {
-                runAction("adapter", install);
-              }, children: busyAction === "adapter" ? t("settings.installing") : state.health?.pluginInstalled ? t("settings.reinstall") : t("settings.install") }),
-              /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { type: "button", disabled: state.loading || Boolean(busyAction) || !opencliReady, onClick: () => {
-                runAction("daemon", restartDaemon);
-              }, children: busyAction === "daemon" ? t("settings.restarting") : t("settings.restartDaemon") })
-            ] })
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dsh_ref_service_actions", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { className: "is_primary", type: "button", disabled: state.loading || Boolean(busyAction), onClick: () => {
+              const opened = state.health?.extensionConnected ? true : openStore();
+              runAction("setup", () => setupAll(opened));
+            }, children: busyAction === "setup" ? t("settings.settingUp") : t("settings.oneClickSetup") }) })
           ] })
         ] }),
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dsh_ref_chat_divider" }),
@@ -16535,6 +16532,7 @@ function daemonStateDetail(health, t) {
 }
 function adapterStateDetail(health, t) {
   if (!health?.pluginInstalled) return health?.pluginError || t("settings.adapterMissing");
+  if (health.pluginError) return t("settings.adapterLoadFailed", { error: health.pluginError });
   if (!health.adapterCommandsReady) return t("settings.adapterIncomplete");
   if (!health.adapterCompatible) return t("settings.adapterVersionUnsupported", { version: health.pluginVersion || t("settings.unknownVersion") });
   return health.pluginVersion ? t("settings.adapterInstalledVersion", { version: health.pluginVersion }) : t("settings.adapterInstalled");

package/lib/opencli.d.ts

@@ -107,6 +107,7 @@ export declare class OpenCliRunner {
     private historyRows;
     private json;
     private raw;
+    private command;
 }
 /** Locate a working OpenCLI without asking a command-line newcomer for PATH details. */
 export declare function discoverOpenCli(configured?: string, signal?: AbortSignal): Promise<OpenCliDiscovery>;

package/lib/opencli.js

@@ -12,6 +12,7 @@ const SITE = {
     deepseek: 'dsh-deepseek', grok: 'dsh-grok', kimi: 'dsh-kimi',
 };
 const REQUIRED_ADAPTER_COMMANDS = ['chatgpt', 'claude', 'gemini', 'deepseek', 'grok', 'kimi'];
+const ADAPTER_PLUGIN_NAME = 'dsh-chat-history';
 /**
  * A persistent OpenCLI site session owns one mutable browser tab. Serialize
  * commands that target the same executable/profile/site across runner
@@ -127,7 +128,9 @@ export class OpenCliRunner {
         const daemonVersion = daemon.value.match(/^Version:\s+v?([^\s(]+)/m)?.[1];
         const pluginVersion = plugins.value.match(/dsh-chat-history\s+@([^\s—]+)/i)?.[1];
         const pluginInstalled = /dsh-chat-history/i.test(plugins.value);
-        const adapterCommandsReady = REQUIRED_ADAPTER_COMMANDS.every(command => new RegExp(`\\b${command}\\b`, 'i').test(plugins.value));
+        const adapterLoadError = adapterPluginLoadError(plugins.diagnostic);
+        const adapterCommandsReady = !adapterLoadError
+            && REQUIRED_ADAPTER_COMMANDS.every(command => new RegExp(`\\b${command}\\b`, 'i').test(plugins.value));
         const opencliCompatible = versionAtLeast(cliVersion, MIN_OPENCLI_VERSION);
         const daemonStale = Boolean(status.daemonRunning && (!daemonVersion || normalizeVersion(daemonVersion) !== cliVersion));
         const connectivityOk = /\[OK\]\s+Connectivity:/i.test(doctor.value);
@@ -143,7 +146,7 @@ export class OpenCliRunner {
             adapterCompatible: pluginInstalled && adapterCommandsReady && versionAtLeast(pluginVersion ?? '', MIN_ADAPTER_VERSION),
             ...(version.error ? { versionError: version.error } : {}),
             ...(daemon.error ? { daemonError: daemon.error } : {}),
-            ...(plugins.error ? { pluginError: plugins.error } : {}),
+            ...(plugins.error || adapterLoadError ? { pluginError: plugins.error || adapterLoadError } : {}),
             ...(doctor.error ? { doctorError: doctor.error } : {}),
         };
     }
@@ -164,12 +167,25 @@ export class OpenCliRunner {
         });
     }
     async installPlugin(pluginUrl, signal) {
-        await this.raw(['plugin', 'install', pluginUrl], signal);
+        const before = await this.command(['plugin', 'list'], signal);
+        if (new RegExp(`\\b${ADAPTER_PLUGIN_NAME}\\b`, 'i').test(before.stdout)) {
+            await this.raw(['plugin', 'update', ADAPTER_PLUGIN_NAME], signal);
+        }
+        else {
+            await this.raw(['plugin', 'install', pluginUrl], signal);
+        }
+        const after = await this.command(['plugin', 'list'], signal);
+        const loadError = adapterPluginLoadError(after.stderr);
+        const commandsReady = REQUIRED_ADAPTER_COMMANDS.every(command => new RegExp(`\\b${command}\\b`, 'i').test(after.stdout));
+        if (loadError || !commandsReady) {
+            throw new OpenCliError(loadError || 'OpenCLI did not register all six conversation adapters', 'OPENCLI_CONFIGURATION');
+        }
     }
     async restartDaemon(signal) { await this.raw(['daemon', 'restart'], signal); }
     async probe(args, signal) {
         try {
-            return { value: await this.raw(args, signal) };
+            const result = await this.command(args, signal);
+            return { value: result.stdout, ...(result.stderr.trim() ? { diagnostic: result.stderr.trim() } : {}) };
         }
         catch (error) {
             return { value: '', error: error instanceof Error ? error.message : String(error) };
@@ -213,6 +229,9 @@ export class OpenCliRunner {
         });
     }
     async raw(args, signal) {
+        return (await this.command(args, signal)).stdout;
+    }
+    async command(args, signal) {
         const invocation = resolveInvocation(this.executable);
         const fullArgs = [...invocation.prefix, ...this.prefixArgs, ...(this.profile ? ['--profile', this.profile] : []), ...args];
         try {
@@ -220,7 +239,7 @@ export class OpenCliRunner {
                 encoding: 'utf8', timeout: this.timeoutMs, maxBuffer: this.maxStdoutBytes,
                 windowsHide: true, shell: false, signal, env: { ...process.env, OPENCLI_WINDOW: 'background' },
             });
-            return result.stdout;
+            return { stdout: result.stdout, stderr: result.stderr };
         }
         catch (error) {
             const detail = error;
@@ -237,6 +256,13 @@ export class OpenCliRunner {
         }
     }
 }
+/** Keep successful-process diagnostics: OpenCLI reports plugin import failures on stderr while exiting zero. */
+function adapterPluginLoadError(diagnostic = '') {
+    const lines = diagnostic.split(/\r?\n/)
+        .map(line => line.trim())
+        .filter(line => /Plugin dsh-chat-history\//i.test(line));
+    return [...new Set(lines)].join('\n').slice(0, 2_000);
+}
 async function serializeSiteCommand(key, task) {
     const previous = SITE_COMMAND_TAILS.get(key) ?? Promise.resolve();
     const current = previous.then(task, task);

package/lib/sources/web-chat/index.d.ts

@@ -97,6 +97,7 @@ export default class WebChatHistoryService extends Service implements ReferenceS
     profiles(signal?: AbortSignal): Promise<import("../../opencli.ts").BrowserProfile[]>;
     private runner;
     installAdapter(signal?: AbortSignal): Promise<boolean>;
+    private installAdapterFrom;
     /**
      * (Re)arm the background sync timer from the current settings.
      *

package/lib/sources/web-chat/index.js

@@ -4,7 +4,9 @@ import { providerSchema, referenceAnythingDomainSpec, settingsRecordSchema } fro
 import { ConversationStore } from "../../store/store.js";
 import { ConversationSyncManager } from "../../sync/index.js";
 import { OpenCliError, OpenCliRunner, discoverOpenCli, installOpenCli as installOpenCliPackage } from "../../opencli.js";
-import { PackageUpdateManager } from "../../update.js";
+import { PACKAGE_NAME, PackageUpdateManager } from "../../update.js";
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
 import { ReferenceAnythingError } from "../../errors.js";
 import { parseProviderQuery } from "../../search.js";
 export { parseProviderQuery };
@@ -27,7 +29,11 @@ export default class WebChatHistoryService extends Service {
     syncValue;
     autoSyncInterval;
     autoSyncCatchUp;
-    packageUpdates = new PackageUpdateManager();
+    packageUpdates = new PackageUpdateManager({
+        afterInstall: async (profileDir, _version, signal) => {
+            await this.installAdapterFrom(pathToFileURL(join(profileDir, 'node_modules', PACKAGE_NAME, 'opencli-plugin')).href, signal);
+        },
+    });
     liveAttachments = new Map();
     constructor(ctx, config = {}) {
         super(ctx, 'referenceChatHistory');
@@ -234,11 +240,14 @@ export default class WebChatHistoryService extends Service {
             timeoutMs: this.config.timeoutMs, maxStdoutBytes: this.config.maxStdoutBytes });
     }
     async installAdapter(signal) {
+        await this.installAdapterFrom(new URL('../../../opencli-plugin/', import.meta.url).href, signal);
+        return true;
+    }
+    async installAdapterFrom(pluginUrl, signal) {
         const settings = this.store.settings;
         const runner = new OpenCliRunner({ executable: settings.opencliPath, profile: settings.profile,
             timeoutMs: this.config.timeoutMs, maxStdoutBytes: this.config.maxStdoutBytes });
-        await runner.installPlugin(new URL('../../../opencli-plugin/', import.meta.url).href, signal);
-        return true;
+        await runner.installPlugin(pluginUrl, signal);
     }
     /**
      * (Re)arm the background sync timer from the current settings.

package/lib/update.d.ts

@@ -16,6 +16,7 @@ interface UpdateManagerOptions {
     dshHome?: string;
     fetchLatest?: (signal?: AbortSignal) => Promise<string>;
     install?: (profileDir: string, version: string, signal?: AbortSignal) => Promise<void>;
+    afterInstall?: (profileDir: string, version: string, signal?: AbortSignal) => Promise<void>;
 }
 /** One startup/manual-check cache and the confirmed profile-local updater. */
 export declare class PackageUpdateManager {
@@ -23,6 +24,7 @@ export declare class PackageUpdateManager {
     private readonly dshHome?;
     private readonly fetchLatest;
     private readonly install;
+    private readonly afterInstall?;
     private cached?;
     private checking?;
     constructor(options?: UpdateManagerOptions);

package/lib/update.js

@@ -16,6 +16,7 @@ export class PackageUpdateManager {
     dshHome;
     fetchLatest;
     install;
+    afterInstall;
     cached;
     checking;
     constructor(options = {}) {
@@ -23,6 +24,7 @@ export class PackageUpdateManager {
         this.dshHome = options.dshHome;
         this.fetchLatest = options.fetchLatest ?? fetchLatestVersion;
         this.install = options.install ?? installPackageVersion;
+        this.afterInstall = options.afterInstall;
     }
     /** Return the startup result, waiting for it when it is still in flight. */
     status(signal) {
@@ -52,6 +54,7 @@ export class PackageUpdateManager {
             return { version: status.currentVersion, restartRequired: false };
         const profileDir = await findOwningProfileDir(this.packageRoot, this.dshHome);
         await this.install(profileDir, status.latestVersion, signal);
+        await this.afterInstall?.(profileDir, status.latestVersion, signal);
         this.cached = {
             currentVersion: status.latestVersion,
             latestVersion: status.latestVersion,

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "dsh-reference-anything",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Reference locally mirrored ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi conversations from DeepSeek Harness",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "repository": {
     "type": "git",
@@ -53,9 +53,9 @@
     "opencli-plugin/*.js",
     "opencli-plugin/opencli-plugin.json",
     "opencli-plugin/package.json",
-    "cordis.patch.yml",
-    "images/logo.png",
-    "NOTICE.md",
+    "cordis.patch.yml",
+    "images/logo.png",
+    "NOTICE.md",
     "README.md"
   ],
   "dsh": {
@@ -78,8 +78,8 @@
     "build": "node build.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
-    "check": "pnpm run typecheck && pnpm run test && pnpm run build",
-    "prepublishOnly": "pnpm run check",
+    "check": "pnpm run typecheck && pnpm run test && pnpm run build",
+    "prepublishOnly": "pnpm run check",
     "prepare": "node build.mjs"
   },
   "peerDependencies": {