dsh-reference-anything 0.3.2 → 0.3.3

package/README.md

@@ -49,7 +49,7 @@ Use one `@` menu to reference:
 
 Beyond extending what `@` can reference, Reference Anything also enhances the `@` menu itself:
 
-- Customize visible groups: enable or hide `Commands`, `Skills`, files, DSH sessions, local agent conversations, external conversations, and cloud-drive files, then arrange them in any order
+- Customize visible groups: enable or hide `Commands`, `Skills`, files, DSH sessions, local agent conversations, external conversations, and cloud-drive files, then arrange them in any order
 - Customize result counts: set each group's collapsed row count and hard candidate cap independently
 - Choose how to browse: expand or collapse individual groups, or use DSH's native scrolling list
 - Enhanced visual icons: distinguish reference sources with type icons and platform logos, making menu items easier to identify
@@ -71,20 +71,21 @@ Type `@`, search across enabled sources, and insert the selected reference into
 
 > [!IMPORTANT]
 > This version targets DSH `0.1.0-rc.8` or newer. It uses the native `@` trigger menu, official file/session Remotes, and the native Composer reference renderer.
+> The `0.3.x` line remains on the current stable DSH SDK (`0.1.0-rc.8 ~ 0.1.1-rc.2`). Due to breaking changes, starting with version `v0.4.0-alpha.1`, development releases will target DSH `v0.1.2-alpha.1` or newer, use the npm `alpha` tag, and no longer support older DSH releases.
 
 > [!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-25 · v0.3.2** — Settings now show detected local-agent conversation counts and let users choose a custom folder when needed. Web AI conversation sync can be limited by age. Cloud drives support folder-by-folder browsing and quick access to the download folder. Update notes are available in Settings, and local-agent tool details are concise by default with full detail still available on demand.
-- **2026-08-20 · v0.3.1** — Added a sixth `@` group, `Local agent conversations`: the sessions fourteen other agent CLIs leave on disk — Claude Code, Codex, Cursor, Qoder, Reasonix, OpenClaw, Kimi, Grok Build, Hermes, Gemini CLI, Pi, and the three SQLite-backed ones (opencode, mimocode, zcode) — are now listed and referenced like any other source. Reference-only: nothing is imported into DSH's session store, and a transcript is streamed only when the model calls `reference_read`. Reads are bounded, workspace-scoped by default, and gated by the same per-task authorization the external conversations use, which is now source-qualified rather than hard-coded to one source. The rc.8 build now resolves its development SDKs from published packages, and workspace scoping normalizes both sides of a path comparison for reliable Windows matching.
+- **2026-08-28 · v0.3.3** — Improved dark-theme backgrounds for the reference menu and settings panels, added project screenshot metadata, and refreshed the documentation. This is the final release line targeting the current stable DeepSeek Harness SDK; the next development release, `v0.4.0-alpha.1`, will migrate to DeepSeek Harness `v0.1.2-alpha.1` under the npm `alpha` tag and will not support older DSH releases.
+- **2026-08-25 · v0.3.2** — Added local-agent conversation references, with detected session counts and custom-folder support. Web AI sync can be age-limited; cloud drives now support folder browsing and quick download-folder access. Settings include update notes, and local-agent tool details stay concise unless expanded.
 - **2026-08-20 · v0.3.0** — Completed the native DSH `@` integration: five independently configurable sources, official file/session Remotes, native Composer references with source logos, in-place expand/collapse and sync actions, and a one-click switch between Reference Anything and the official DSH `@` list. The legacy `dsh-file:` protocol and custom Composer interaction layer were removed.
-- **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.
 
 ## 🧭 Roadmap
 
 - [x] Support referencing historical conversations from other local agents
+- [ ] Support continuing referenced local-agent sessions
 - [x] Reference cloud-drive files through OpenList
 - [ ] Manage cloud-drive files inside the plugin (in progress; current access is read-only)
 - [ ] Support more keyword matching rules, including blacklists and whitelists, especially for file search
@@ -100,11 +101,19 @@ Prerequisites:
 - `dsh` is installed and running; automatic OpenCLI installation requires the `npm` bundled with Node.js.
 - The target platforms are already logged in under the selected Chrome Profile.
 
-Install the DSH plugin from npm:
+Install the stable `0.3.x` line for the current stable DSH SDK:
 
 ```powershell
-dsh plugin --profile web add dsh-reference-anything
-```
+dsh plugin --profile web add dsh-reference-anything@latest
+```
+
+Starting with `v0.4.0-alpha.1`, users on DSH `v0.1.2-alpha.1` can install the development line separately:
+
+```powershell
+dsh plugin --profile web add dsh-reference-anything@alpha
+```
+
+After the DSH alpha API stabilizes and the migration is verified, the `alpha` line will be promoted to `latest` and become the default installation.
 
 For development, install the published DSH rc.8 SDK dependencies, run the verification gate, then install the repository from a local path:
 
@@ -147,7 +156,7 @@ The default **Read bodies on demand** mode stores only the title index locally a
 
 ### 🧩 One `@` menu, multiple sources
 
-The `@` menu contains seven groups: `Commands`, `Skills`, `Files and folders`, `DSH sessions`, `Local agent conversations`, `External conversations`, and `Cloud drive files`. The cloud-drive group browses folders and supported files from drives connected through OpenList; access is read-only, and connections are managed in Settings. Each group shows six rows before its expand action by default and accepts a separate hard candidate cap from 1 to 50. In collapse mode, each expand action reveals five more rows and updates the mounted menu without jumping back to the top; collapse restores the configured compact count. The external-conversation group keeps its sync action first and updates that row and the visible results in place while synchronization runs and completes. Under `Settings → Reference Anything → General`, you can enable or disable groups, reorder them, and choose **Collapse / expand** or **Native DSH scrolling**.
+The `@` menu contains seven groups: `Commands`, `Skills`, `Files and folders`, `DSH sessions`, `Local agent conversations`, `External conversations`, and `Cloud drive files`. The cloud-drive group browses folders and supported files from drives connected through OpenList; access is read-only, and connections are managed in Settings. Each group shows six rows before its expand action by default and accepts a separate hard candidate cap from 1 to 50. In collapse mode, each expand action reveals five more rows and updates the mounted menu without jumping back to the top; collapse restores the configured compact count. The external-conversation group keeps its sync action first and updates that row and the visible results in place while synchronization runs and completes. Under `Settings → Reference Anything → General`, you can enable or disable groups, reorder them, and choose **Collapse / expand** or **Native DSH scrolling**.
 
 #### ⌨️ @Commands — DSH native commands
 
@@ -180,22 +189,22 @@ Type `@sessions:` to browse DSH sessions through the official session-reference
 
 Selected sessions use DSH's canonical `dsh-session:` mention and native session appearance. Snapshot preparation and resolution remain owned by DSH rather than this plugin.
 
-#### 🖥️ @Local agent conversations — transcripts from local agent CLIs
-
-Type `@agents:` to search and reference conversations saved by other local agent tools.
-
-<p align="center"><img src="./images/at-local-agents.png" alt="Browse other local agents' transcripts from the @ menu" width="800" /></p>
-
-**Supported agents:** Claude Code, Codex, Cursor, Qoder, Reasonix, OpenClaw, Kimi, Grok Build, Hermes, Gemini CLI, Pi, opencode, mimocode, and zcode.
-
-**Features:**
-
-- Automatically detects conversation history and shows the number found for each agent
-- Lets you enable agents independently or choose a custom history folder
-- Searches all detected conversations by default, with an option to limit results to the current workspace
-- Reads conversation content on demand; tool names are concise by default, with full details available when needed
-- Supports agent-specific prefixes such as `@codex:`, `@claude-code:`, and `@gemini-cli:`
-
+#### 🖥️ @Local agent conversations — transcripts from local agent CLIs
+
+Type `@agents:` to search and reference conversations saved by other local agent tools.
+
+<p align="center"><img src="./images/at-local-agents.png" alt="Browse other local agents' transcripts from the @ menu" width="800" /></p>
+
+**Supported agents:** Claude Code, Codex, Cursor, Qoder, Reasonix, OpenClaw, Kimi, Grok Build, Hermes, Gemini CLI, Pi, opencode, mimocode, and zcode.
+
+**Features:**
+
+- Automatically detects conversation history and shows the number found for each agent
+- Lets you enable agents independently or choose a custom history folder
+- Searches all detected conversations by default, with an option to limit results to the current workspace
+- Reads conversation content on demand; tool names are concise by default, with full details available when needed
+- Supports agent-specific prefixes such as `@codex:`, `@claude-code:`, and `@gemini-cli:`
+
 #### 🌐 @External conversations — external conversation platforms
 
 Supports historical conversations from ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi.
@@ -220,22 +229,22 @@ Supports historical conversations from ChatGPT, Claude, Gemini, DeepSeek, Grok,
 
 Opening the source URL happens only in the UI; the URL is never injected into model context. The initial reference contains only a safe pointer; if the model needs the body, it calls `reference_read` on demand.
 
-#### ☁️ @Cloud drive files — files connected through OpenList
-
-Type `@drive:`, `@cloud:`, `@netdisk:`, or `@网盘` to browse folders and reference files from cloud drives connected through OpenList.
-
-Common providers include OneDrive, Aliyun Drive, Baidu Netdisk, Quark, 115, 123, Dropbox, Google Drive/Photos, and Yandex. Other providers available in OpenList can be configured from the same settings page.
-
-**Features:**
-
-- Enables a managed OpenList instance with one click, or connects to an existing OpenList service
-- Adds and manages drive mounts from Settings, including common providers through quick login
-- Searches indexed files and supports folder-by-folder browsing from the `@` menu
-- Shows the drive, path, and file type in search results to make similarly named files easy to distinguish
-- Reads text files directly and downloads documents, spreadsheets, presentations, PDFs, and images when referenced
-- Lets you choose and open the download directory
-- Shows mount status and supports enabling, disabling, reauthenticating, removing, and rebuilding the search index
-
+#### ☁️ @Cloud drive files — files connected through OpenList
+
+Type `@drive:`, `@cloud:`, `@netdisk:`, or `@网盘` to browse folders and reference files from cloud drives connected through OpenList.
+
+Common providers include OneDrive, Aliyun Drive, Baidu Netdisk, Quark, 115, 123, Dropbox, Google Drive/Photos, and Yandex. Other providers available in OpenList can be configured from the same settings page.
+
+**Features:**
+
+- Enables a managed OpenList instance with one click, or connects to an existing OpenList service
+- Adds and manages drive mounts from Settings, including common providers through quick login
+- Searches indexed files and supports folder-by-folder browsing from the `@` menu
+- Shows the drive, path, and file type in search results to make similarly named files easy to distinguish
+- Reads text files directly and downloads documents, spreadsheets, presentations, PDFs, and images when referenced
+- Lets you choose and open the download directory
+- Shows mount status and supports enabling, disabling, reauthenticating, removing, and rebuilding the search index
+
 ---
 
 **General notes:**

package/lib/client.js

@@ -29610,7 +29610,8 @@ var css = `
      inside matching Composer reference chips. Native text continues to own all
      caret, selection, wrapping, and message geometry. */
 [data-composer-card] [role="listbox"]:has([role="presentation"][data-source]){box-sizing:border-box!important;width:100%!important;min-width:0!important;max-width:100%!important;border-radius:22px!important}
-[data-composer-card] [role="listbox"] [role="presentation"][data-source]{position:sticky;top:0;z-index:2;box-sizing:border-box;padding-top:6px!important;background:var(--dsw-alias-bg-layer-1,#fff)}
+[data-composer-card] [role="listbox"] [role="presentation"][data-source]{position:sticky;top:0;z-index:2;box-sizing:border-box;padding-top:6px!important;background:var(--dsw-alias-background-primary,var(--dsw-alias-bg-layer-1,#fff))}
+body[data-ds-dark-theme] [data-composer-card] [role="listbox"] [role="presentation"][data-source]{background:#343438}
 [data-composer-card] [role="listbox"] [role="presentation"][data-source]:not(:first-child){margin-top:8px}
 [data-composer-card] [role="listbox"] [role="option"]{scroll-margin-block-start:30px;scroll-margin-block-end:4px}
 [data-composer-card] [role="listbox"]>[data-dsh-ref-menu-settling]{overflow-anchor:none!important}
@@ -29644,7 +29645,7 @@ var css = `
    whole panel upward after a saved toggle and leaves a large blank region. */
 [role="dialog"]:has(.dsh_ref_settings){overflow:clip!important}
 .dsh_ref_toggle{position:relative}
-body[data-ds-dark-theme] .dsh_ref_settings{--dsh-ref-card-surface:var(--dsw-alias-bg-layer-1,#303038);--dsh-ref-control-surface:var(--dsw-alias-bg-layer-2,#363640)}
+body[data-ds-dark-theme] .dsh_ref_settings{--dsh-ref-card-surface:#2c2c30;--dsh-ref-control-surface:var(--dsw-alias-bg-layer-2,#363640)}
 .dsh_ref_header{padding:2px 2px 4px}.dsh_ref_header h2{font-size:26px;font-weight:700;letter-spacing:-.025em}.dsh_ref_header p{max-width:660px;color:var(--dsw-alias-label-dimmed,var(--dsw-alias-label-primary));line-height:1.55}.dsh_ref_settings button{border-color:var(--dsh-ref-line);border-radius:9px;background:transparent;color:var(--dsw-alias-label-primary);font-weight:600;transition:background .16s ease,border-color .16s ease,color .16s ease,transform .16s ease}.dsh_ref_settings button:hover:not(:disabled){border-color:var(--dsh-ref-blue-line);background:var(--dsh-ref-blue-soft);color:var(--dsh-ref-blue)}
 .dsh_ref_update_bar{display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:18px;padding:13px 14px;border:1px solid var(--dsh-ref-line);border-radius:12px;background:var(--dsh-ref-surface)}.dsh_ref_update_bar.is_available{border-color:var(--dsh-ref-blue-line);background:var(--dsh-ref-blue-soft)}.dsh_ref_update_copy{display:grid;min-width:0;gap:3px}.dsh_ref_update_copy strong{font-size:12px}.dsh_ref_update_copy small{color:#64748b;font-size:10px;line-height:1.45;overflow-wrap:anywhere}.dsh_ref_update_actions{display:flex;align-items:center;flex:none;gap:8px}.dsh_ref_update_notes{display:grid;flex:0 0 100%;gap:8px;padding-top:12px;border-top:1px solid var(--dsh-ref-line);font-size:11px}.dsh_ref_update_markdown{max-height:260px;overflow:auto;overflow-wrap:anywhere;line-height:1.55}.dsh_ref_update_markdown>:first-child{margin-top:0}.dsh_ref_update_markdown>:last-child{margin-bottom:0}.dsh_ref_update_markdown :is(h1,h2,h3,h4,h5,h6){margin:14px 0 6px;font-size:12px}.dsh_ref_update_markdown :is(p,ul,ol,blockquote,pre){margin:6px 0}.dsh_ref_update_markdown :is(ul,ol){padding-left:22px}.dsh_ref_update_markdown blockquote{padding-left:10px;border-left:2px solid var(--dsh-ref-line);opacity:.78}.dsh_ref_update_markdown code{padding:1px 4px;border-radius:4px;background:var(--dsh-ref-surface);font-family:"Geist Mono",Consolas,monospace}.dsh_ref_update_markdown pre{overflow:auto;padding:9px;border:1px solid var(--dsh-ref-line);border-radius:7px;background:var(--dsh-ref-surface)}.dsh_ref_update_markdown pre code{padding:0;background:transparent}.dsh_ref_update_notes a{justify-self:start;color:var(--dsh-ref-blue);font-size:10px;font-weight:650}.dsh_ref_settings .dsh_ref_button{display:inline-flex;align-items:center;justify-content:center;min-height:34px;padding:0 13px;border:1px solid var(--dsh-ref-line);border-radius:9px;background:transparent;color:var(--dsw-alias-label-primary);font-size:12px;font-weight:600;text-decoration:none;transition:background .16s ease,border-color .16s ease,color .16s ease,transform .16s ease}.dsh_ref_settings .dsh_ref_button:hover{border-color:var(--dsh-ref-blue-line);background:var(--dsh-ref-blue-soft);color:var(--dsh-ref-blue)}.dsh_ref_settings .dsh_ref_button:active{transform:translateY(1px)}.dsh_ref_update_actions .is_primary{border-color:var(--dsh-ref-blue);background:var(--dsh-ref-blue);color:#fff}.dsh_ref_update_actions .is_primary:hover:not(:disabled){background:var(--dsh-ref-blue);color:#fff;filter:brightness(.94)}body[data-ds-dark-theme] .dsh_ref_update_copy small{color:var(--dsw-alias-label-tertiary,#94a3b8)}
 .dsh_ref_recheck{border-color:var(--dsh-ref-blue-line)!important;color:var(--dsh-ref-blue)!important;background:var(--dsh-ref-blue-soft)!important}.dsh_ref_recheck:hover:not(:disabled){background:var(--dsh-ref-blue)!important;color:#fff!important}
@@ -29668,9 +29669,8 @@ body[data-ds-dark-theme] .dsh_ref_storage_header p{color:var(--dsw-alias-label-t
 @media(max-width:720px){.dsh_ref_storage_header{grid-template-columns:1fr}.dsh_ref_storage_metric{justify-items:start;justify-self:start}.dsh_ref_provider_summary{grid-template-columns:minmax(100px,1fr) auto}.dsh_ref_provider_summary>small{grid-column:1 / -1}.dsh_ref_provider_controls{align-items:flex-start;flex-direction:column}.dsh_ref_provider_controls>.dsh_ref_provider_actions{justify-content:flex-start}}
 @media(max-width:520px){.dsh_ref_provider{grid-template-columns:34px minmax(0,1fr)}.dsh_ref_provider_summary{grid-template-columns:1fr auto;gap:6px 10px}.dsh_ref_provider_controls>.dsh_ref_provider_actions{justify-content:flex-start}}
 /* General is a layout group, not a card. Keep only the actual picker list framed. */
-.dsh_ref_workspace>.dsh_ref_panel.dsh_ref_general_settings{padding:0;border:0;border-radius:0;background:transparent}
 /* The remaining sections keep their structural outline, but not a filled grey card. */
-.dsh_ref_workspace>.dsh_ref_panel,.dsh_ref_workspace>.dsh_ref_sources{background:transparent}.dsh_ref_check>span.is_ready{border-color:rgba(22,163,74,.35);background:rgba(22,163,74,.1);color:#16a34a}.dsh_ref_check>span.is_neutral{border-color:rgba(100,116,139,.35);background:rgba(100,116,139,.1);color:#64748b}.dsh_ref_check>span.is_error{border-color:rgba(220,38,38,.35);background:rgba(220,38,38,.08);color:#dc2626}.dsh_ref_check small.is_warning,.dsh_ref_provider>em,.dsh_ref_error{color:#dc2626}
+.dsh_ref_workspace>.dsh_ref_panel,.dsh_ref_workspace>.dsh_ref_sources{background:transparent}body[data-ds-dark-theme] .dsh_ref_workspace>.dsh_ref_panel,body[data-ds-dark-theme] .dsh_ref_workspace>.dsh_ref_sources{background:#242428}.dsh_ref_check>span.is_ready{border-color:rgba(22,163,74,.35);background:rgba(22,163,74,.1);color:#16a34a}.dsh_ref_check>span.is_neutral{border-color:rgba(100,116,139,.35);background:rgba(100,116,139,.1);color:#64748b}.dsh_ref_check>span.is_error{border-color:rgba(220,38,38,.35);background:rgba(220,38,38,.08);color:#dc2626}.dsh_ref_check small.is_warning,.dsh_ref_provider>em,.dsh_ref_error{color:#dc2626}
 .dsh_ref_health.is_ready{border-color:rgba(22,163,74,.35);background:rgba(22,163,74,.1);color:#16a34a}.dsh_ref_check_body{flex:1}.dsh_ref_check_actions{display:flex!important;align-items:center;flex-wrap:wrap;gap:7px!important;margin-top:6px}.dsh_ref_check_actions>button{min-height:28px;padding:0 9px;border-color:var(--dsh-ref-blue-line);border-radius:7px;color:var(--dsh-ref-blue);font-size:10px}.dsh_ref_check_profile{display:flex!important;grid-template-columns:none!important;align-items:center;gap:7px!important}.dsh_ref_check_profile select{height:29px;max-width:220px;padding:0 8px;border:1px solid var(--dsh-ref-line);border-radius:7px;background:var(--dsh-ref-control-surface);color:var(--dsw-alias-label-primary);font:11px Geist,"Segoe UI",sans-serif}.dsh_ref_store_fallback{margin:14px 0 0;padding:10px 12px;border:1px solid rgba(220,38,38,.3);border-radius:9px;background:rgba(220,38,38,.06);color:#dc2626;font-size:11px}.dsh_ref_store_fallback a{color:inherit;font-weight:700}.dsh_ref_setup_step{margin:14px 0 0;padding:9px 11px;border:1px solid var(--dsh-ref-blue-line);border-radius:9px;background:var(--dsh-ref-blue-soft);color:var(--dsh-ref-blue);font-size:11px;font-weight:650}
 .dsh_ref_chat{gap:0}.dsh_ref_chat_divider{height:0;margin:20px 0;border-top:1px solid var(--dsh-ref-line)}
 .dsh_ref_cloud{display:grid;gap:14px}.dsh_ref_cloud_actions,.dsh_ref_cloud_cards article>div{display:flex;gap:8px;flex-wrap:wrap}.dsh_ref_cloud_connect,.dsh_ref_cloud_mount_form{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:10px;padding-top:14px;border-top:1px solid var(--dsh-ref-line)}.dsh_ref_cloud label{display:grid;gap:5px;font-size:11px;font-weight:650}.dsh_ref_cloud input,.dsh_ref_cloud select,.dsh_ref_cloud textarea{min-width:0;padding:0 9px;border:1px solid var(--dsh-ref-line);border-radius:7px;background:var(--dsh-ref-control-surface);color:var(--dsw-alias-label-primary);font:12px Geist,"Segoe UI",sans-serif}.dsh_ref_cloud input,.dsh_ref_cloud select{height:34px}.dsh_ref_cloud textarea{padding-block:8px;resize:vertical}.dsh_ref_cloud .dsh_ref_masked_secret{-webkit-text-security:disc}.dsh_ref_cloud input[type=checkbox]{width:16px;height:16px;padding:0}.dsh_ref_cloud_mount_form h4{grid-column:1 / -1;margin:0;font-size:13px}.dsh_ref_cloud_cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:10px}.dsh_ref_cloud_cards article{display:grid;gap:7px;padding:12px;border:1px solid var(--dsh-ref-line);border-radius:10px;background:var(--dsh-ref-card-surface)}.dsh_ref_cloud_cards strong{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:13px}.dsh_ref_cloud_cards span,.dsh_ref_cloud_cards small{font-size:10px;opacity:.76}.dsh_ref_cloud_cards button{min-height:28px;padding:0 9px;font-size:10px}@media(max-width:640px){.dsh_ref_cloud_connect,.dsh_ref_cloud_mount_form{grid-template-columns:1fr}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-reference-anything",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Reference commands, skills, workspace files, DSH sessions, local agent transcripts, cloud-drive files, and mirrored web-chat conversations from one DeepSeek Harness @ menu",
   "license": "MIT",
   "publishConfig": {