dsh-reference-anything 0.2.3 → 0.2.4

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,6 +1,6 @@
 {
   "name": "dsh-reference-anything",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Reference locally mirrored ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi conversations from DeepSeek Harness",
   "license": "MIT",
   "publishConfig": {