Skip to content

dsh Browser Control v0.1.3 — Firefox, Cross-Platform Setup, and Contextual Sessions

Latest

Choose a tag to compare

@Lum1104 Lum1104 released this 04 Sep 06:47
e60e6e3

dsh Browser Control v0.1.3 expands the project from a Chrome-first browser assistant into a cross-platform Chrome/Firefox integration with safer session continuity, richer side-panel workflows, and support for the current DSH transport architecture.

Highlights

Firefox and cross-platform setup

  • Added a Firefox MV3 build with a native sidebar, event-page background, runtime-port recovery, and Firefox-specific authentication safeguards.
  • Added a Windows PowerShell installer alongside the macOS/Linux installer.
  • Improved Chrome and Chromium discovery, clipboard fallbacks, browser launch behavior, and installation guidance across macOS and Linux.
  • Added automatic discovery of DSH Desktop’s recommended fixed port, 43189.
  • The bridge now displays a copyable WebSocket address in DSH General settings.

Firefox is currently distributed as a source build and requires Firefox 140 or later. Because moz-extension:// UUIDs are not stable add-on identities, Firefox must authenticate with the token stored at ~/.dsh/ext-bridge-token.

Faster browser workflows

  • Highlighted page text now appears as a removable quote in the side-panel composer and is sent inside the existing untrusted-content boundary.
  • New conversations automatically capture and inject the current page snapshot before the first prompt.
  • Added browser_open_tab, allowing the assistant—with approval—to open an HTTP(S) URL in a new tab, follow it, and return its page snapshot.
  • Hardened new-tab cancellation and readiness handling, including Firefox’s initial blank document.
  • Added a persistent text-size control with steps from 90% to 175%.
  • Fixed Settings sections being compressed or clipped in short side panels.

Browser operation remains text-only. User-attached images continue through the separate DSH multimodal conversation path.

Safer and more flexible sessions

  • Conversation restoration is now scoped to the same browser tab, window, origin, and pathname. Query strings and fragments do not split a page session.
  • Opening the same URL in a new tab creates a new conversation.
  • Navigating while the panel is closed starts fresh, while navigation during an open panel or a successful assistant action remains part of the current conversation.
  • Automatic restoration no longer falls back to unrelated global history; older conversations remain available through the history picker.
  • Sessions can be created or switched while another agent turn is running, with independent per-session tab affinity and cancellation state.
  • Added “Stay & stop asking” for users who want the assistant to keep controlling its original tab while they browse elsewhere.
  • Added session deletion through archive-then-purge handling with persisted-ID validation and running-session protection.
  • Added side-panel configuration for Claude-, OpenAI-, and Codex-compatible API relay profiles, with credentials stored in the DSH credential store.
  • Preserved provisional sessions, pending questions, approvals, and page-scoped recovery across panel and bridge lifecycle changes.

DSH 0.1.2 bridge architecture

  • Migrated the primary bridge transport to the DSH 0.1.2 Typert Gateway, Connection, and Remote APIs.
  • Added a capability-selected compatibility adapter for DSH 0.1.1-rc.2.
  • Kept Desktop-owned ask_user_question waterfalls in the native Desktop UI while routing extension-owned sessions to the browser panel.
  • Corrected older-history pagination by using the real Host follow cursor and preserving paging options.
  • Malformed history pages and records now fail closed instead of appearing as valid but incomplete history.
  • Improved follower replacement, tool cancellation, and session-scoped approval behavior.

Compatibility

  • Primary runtime: @deepseek-ai/dsh@0.1.2-rc.1
  • Temporary compatibility runtime: DSH 0.1.1-rc.2
  • Earlier DSH releases are no longer supported.
  • Chrome requires version 116 or later.
  • Firefox requires version 140 or later and a bridge token.
  • Regular HTTP and HTTPS pages are supported; protected browser pages and extension stores remain unavailable.

Install the tagged release

macOS and Linux:

git clone --branch v0.1.3 --depth 1 https://github.com/Lum1104/dsh-browser.git
cd dsh-browser
./scripts/install.sh

Windows PowerShell:

git clone --branch v0.1.3 --depth 1 https://github.com/Lum1104/dsh-browser.git
cd dsh-browser
.\scripts\install.ps1

Existing managed installations can use the update command shown in the extension.

Contributors

Thank you to everyone who contributed to this release:

Complete change history

  • #24 — Add Firefox extension support.
  • #42 — Advance release metadata after v0.1.1.
  • #44 — Improve macOS/Linux installation and add Windows installation support.
  • #48 — Quote text selected in the current page.
  • #49 — Automatically seed new conversations with the current page.
  • #50 — Add session deletion and API relay profiles.
  • #52 — Add concurrent session switching with per-session tab affinity.
  • #53 — Fix clipped Settings sections.
  • #54 — Discover DSH Desktop on port 43189.
  • #58 — Add persistent side-panel text sizing.
  • #59 — Add persistent background-tab control.
  • #62 — Preserve Desktop-owned question waterfalls.
  • #64 — Show a copyable bridge URL in DSH settings.
  • #65 — Correct Host-cursor session history pagination.
  • #66 — Add browser_open_tab.
  • #68 — Support DSH 0.1.1-rc.2 and 0.1.2-rc.1 transports.
  • #69 — Scope conversation continuity to the current tab and page.

Full changelog: v0.1.1...v0.1.3