dsh-reference-anything 0.2.3 → 0.2.5

package/README.md

@@ -22,7 +22,13 @@ One `@` to reference them all.
 
 </div>
 
-Within the unified `@` menu of DeepSeek Harness (DSH), reference commands, Skills, workspace files/folders, DSH sessions, and historical conversations from ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi.
+<div align="center">
+
+<img src="./images/demo.gif" alt="dsh-reference-anything demo" width="800" />
+
+</div>
+
+Within a unified `@` menu of DeepSeek Harness (DSH), reference commands, Skills, workspace files/folders, DSH sessions, and historical conversations from ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi.
 
 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.
 
@@ -31,7 +37,7 @@ This plugin uses OpenCLI to access historical conversations through AI chat sess
 
 ## News
 
-- **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-19 · v0.2.4** — 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.
@@ -98,14 +104,20 @@ The `@` menu contains five groups: `Commands`, `Skills`, `Files and folders`, `D
 
 Available only at the start of the draft. To browse all commands, use `@commands` or the native DSH `/` panel.
 
+<p align="center"><img src="./images/at-commands.png" alt="Browse DSH commands from the @ menu" width="800" /></p>
+
 #### @Skills — DSH skill library
 
 Available only at the start of the draft. To browse all skills, use `@skills:` or the native DSH `/` panel.
 
+<p align="center"><img src="./images/at-skills.png" alt="Browse DSH skills from the @ menu" width="800" /></p>
+
 #### @Files and folders — workspace files and directories
 
 Type `@files:` in the input box to browse all files and folders in the workspace. Search supports fuzzy matching on titles, so both `@cachedes` and `@cache-design` can match “Cache design notes.”
 
+<p align="center"><img src="./images/at-files.png" alt="Browse workspace files and folders from the @ menu" width="800" /></p>
+
 Features:
 - Quick reference to workspace files with automatic workspace-boundary validation
 - File references only write a validated path and type marker into the model context; file content is not preloaded
@@ -115,6 +127,8 @@ Features:
 
 Type `@sessions:` to browse locally synced DSH sessions. Sessions are ranked by match quality, with recency as fallback ordering.
 
+<p align="center"><img src="./images/at-sessions.png" alt="Browse DSH sessions from the @ menu" width="800" /></p>
+
 Search capabilities:
 - **Title match:** fuzzy search on session titles
 - **Content search:** when title matches are insufficient, the synced session body is searched; matching excerpts are shown in the candidate row for UI display only and are not injected into model context
@@ -126,6 +140,8 @@ Full browsing is available on the settings page’s paginated list. Session refe
 
 Supports historical conversations from ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi.
 
+<p align="center"><img src="./images/at-external-conversations.png" alt="Browse external conversations from the @ menu" width="800" /></p>
+
 **Platform filtering:**
 - Use `@chatgpt:cache` or `@claude:refactor` to filter a specific platform
 - Short aliases are also accepted, such as `@gpt:` and `@ds:`

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,11 +12,12 @@ 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
+ * A persistent OpenCLI site session owns one mutable browser lease. Serialize
  * commands that target the same executable/profile/site across runner
- * instances so concurrent detail workers cannot navigate that tab over one
- * another. Different provider sites still run in parallel.
+ * instances so concurrent detail workers cannot navigate or close each
+ * other's active tab. Different provider sites still run in parallel.
  */
 const SITE_COMMAND_TAILS = new Map();
 export class OpenCliError extends Error {
@@ -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) };
@@ -194,9 +210,9 @@ export class OpenCliRunner {
     async json(site, operation, args, signal) {
         const queueKey = [this.executable, ...this.prefixArgs, this.profile, site].join('\0');
         return serializeSiteCommand(queueKey, async () => {
-            // Pin adapter traffic to one persistent background session. OpenCLI
-            // otherwise lets caller flags override the adapter lifecycle metadata,
-            // which could release its tab or make an unattended sync steal focus.
+            // Pin adapter traffic to one persistent background session. Persistence
+            // suppresses OpenCLI's close-window action; the adapter closes only its
+            // completed task tab and leaves the background container reusable.
             const stdout = await this.raw([
                 site, operation, ...args,
                 '--site-session', 'persistent', '--window', 'background', '-f', 'json',
@@ -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/opencli-plugin/common.js

@@ -38,7 +38,7 @@ async function evaluate(page, script, args, operation) {
   return parseEvaluate(await page.evaluate(source), operation)
 }
 
-function assertResult(result, domain, operation) {
+function assertResult(result, domain, operation) {
   if (result?.code === 'AUTH') throw new AuthRequiredError(domain, result.message || `${operation} requires login`)
   if (result?.code === 'RATE_LIMIT') {
     throw new CommandExecutionError(`${operation}: ${result.message || 'provider rate limit reached'}`)
@@ -46,9 +46,26 @@ function assertResult(result, domain, operation) {
   if (result?.ok !== true || !Array.isArray(result.rows)) {
     throw new CommandExecutionError(`${operation}: ${result?.message || 'provider adapter did not return rows'}`)
   }
-  return result.rows
-}
-
+  return result.rows
+}
+
+/**
+ * Close only the tab used by this adapter command. The persistent site session
+ * prevents OpenCLI from sending its `close-window` lease-release action, while
+ * Browser Bridge can keep and reuse the background container window.
+ */
+async function inTemporaryTab(page, task) {
+  try {
+    return await task()
+  } finally {
+    try {
+      await page.closeTab?.()
+    } catch {
+      // Preserve the provider result/error if the tab or browser closed first.
+    }
+  }
+}
+
 export function registerProvider(config) {
   const browserSession = SYNC_BROWSER_SESSION
 
@@ -64,7 +81,7 @@ export function registerProvider(config) {
     navigateBefore: false,
     args: [],
     columns: ['identity'],
-    func: async (page) => {
+    func: async (page) => inTemporaryTab(page, async () => {
       await page.goto(config.home, { settleMs: 500 })
       const result = await evaluate(page, config.whoamiScript, {}, `${config.site} whoami`)
       if (result?.code === 'AUTH') throw new AuthRequiredError(config.domain)
@@ -72,7 +89,7 @@ export function registerProvider(config) {
         throw new CommandExecutionError(`${config.site} whoami: ${result?.message || 'stable account identity unavailable'}`)
       }
       return [{ identity: result.identity }]
-    },
+    }),
   })
 
   cli({
@@ -90,7 +107,7 @@ export function registerProvider(config) {
       help: 'ISO 8601 instant; stop paging once the listing predates it. Honoured only while the provider pages newest-first',
     }, { name: 'accountScope', help: 'Previously observed hashed account scope; mismatch forces a full listing' }],
     columns: SYNC_INDEX_COLUMNS,
-    func: async (page, kwargs) => {
+    func: async (page, kwargs) => inTemporaryTab(page, async () => {
       const since = String(kwargs.since || '').trim()
       if (since && Number.isNaN(Date.parse(since))) throw new ArgumentError('since must be an ISO 8601 instant')
       await page.goto(config.home, { settleMs: 1200 })
@@ -110,7 +127,7 @@ export function registerProvider(config) {
         { kind: 'identity', identity: identity.identity, sinceApplied: effectiveSince },
         ...rows.map(row => ({ kind: 'conversation', identity: '', sinceApplied: '', ...row })),
       ]
-    },
+    }),
   })
 
   cli({
@@ -128,7 +145,7 @@ export function registerProvider(config) {
       help: 'ISO 8601 instant; stop paging once the listing predates it. Honoured only while the provider pages newest-first',
     }],
     columns: HISTORY_COLUMNS,
-    func: async (page, kwargs) => {
+    func: async (page, kwargs) => inTemporaryTab(page, async () => {
       const since = String(kwargs.since || '').trim()
       if (since && Number.isNaN(Date.parse(since))) throw new ArgumentError('since must be an ISO 8601 instant')
       await page.goto(config.home, { settleMs: 1200 })
@@ -138,7 +155,7 @@ export function registerProvider(config) {
         `${config.site} history-all`,
       )
       return rows
-    },
+    }),
   })
 
   cli({
@@ -156,7 +173,7 @@ export function registerProvider(config) {
       { name: 'accountScope', help: 'Expected hashed account scope; mismatch refuses the read' },
     ],
     columns: DETAIL_COLUMNS,
-    func: async (page, kwargs) => {
+    func: async (page, kwargs) => inTemporaryTab(page, async () => {
       const id = String(kwargs.id || '').trim()
       if (!id) throw new ArgumentError('id must be a non-empty conversation id')
       await page.goto(config.home, { settleMs: 600 })
@@ -180,7 +197,7 @@ export function registerProvider(config) {
       const rows = assertResult(result, config.domain, `${config.site} detail`)
       if (rows.length === 0) throw new EmptyResultError(`${config.site} detail`, `No messages found for ${id}`)
       return rows
-    },
+    }),
   })
 
   cli({
@@ -199,7 +216,7 @@ export function registerProvider(config) {
       { name: 'maxBytes', type: 'int', default: 26214400, help: 'Maximum decoded bytes' },
     ],
     columns: ['attachmentId', 'name', 'mimeType', 'size', 'status', 'localPath'],
-    func: async (page, kwargs) => {
+    func: async (page, kwargs) => inTemporaryTab(page, async () => {
       const locator = String(kwargs.locator || '').trim()
       const output = resolve(String(kwargs.output || ''))
       const maxBytes = Number(kwargs.maxBytes ?? 26_214_400)
@@ -229,15 +246,14 @@ export function registerProvider(config) {
         status: 'available',
         localPath: output,
       }]
-    },
+    }),
   })
 }
 
 /**
  * Keep one stable, background Browser Bridge session per provider site.
- * OpenCLI maps persistent sessions to `site:<config.site>` and keeps their tab
- * lease after both successful and failed commands, so later sync work reuses
- * the same tab. If the user closes it manually, OpenCLI recreates it on demand.
+ * Persistence suppresses OpenCLI's `close-window` action; inTemporaryTab closes
+ * only the finished command's tab so the reusable container window stays alive.
  */
 export const SYNC_BROWSER_SESSION = Object.freeze({
   siteSession: 'persistent',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-reference-anything",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Reference locally mirrored ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi conversations from DeepSeek Harness",
   "license": "MIT",
   "publishConfig": {