dsh-reference-anything 0.2.4 → 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/opencli.js

@@ -14,10 +14,10 @@ const SITE = {
 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 {
@@ -210,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',

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.4",
+  "version": "0.2.5",
   "description": "Reference locally mirrored ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi conversations from DeepSeek Harness",
   "license": "MIT",
   "publishConfig": {