@canary-builds/dsh-wpa 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 1.1.0 — 2026-09-06
+
+- Rename the project to DSH WPA and the package to `@canary-builds/dsh-wpa`.
+- Move the repository to `Canary-Builds/dsh-wpa`.
+- Add a Profile Bundle patch for one-command installation.
+- Update browser module registration to match the scoped package name.
+- Add contract checks, package validation, version-aware npm publishing and GitHub release assets.
+- Preserve Splash's mobile and standalone-window UI behavior.
+
+## 1.0.2 and earlier
+
+Published as `dsh-plugin-splash`. Historical Git tags are preserved.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mareekkk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# DSH WPA
+
+A mobile/PWA-first UI redesign for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) web GUI, delivered as one Cordis plugin with a host half and a browser half. minimal, app-like: the sidebar gets out of your way, the reading area wins, and the app installs as a proper standalone window.
+
+Everything visual is scoped to app windows and touch devices (`display-mode: standalone/fullscreen/minimal-ui`, or `hover:none` + `pointer:coarse`). **Desktop browser tabs are untouched** and render the stock UI.
+
+## Features
+
+**Sidebar (app-style)**
+- Collapsing the sidebar hides the 56px icon rail entirely — the chat area spans the full screen width
+- A floating whale launcher (the DSH whale mark, theme-following) appears centered in the first column's header band; click to expand
+- Expanding opens the sidebar as a **fullscreen overlay** covering the chat instead of pushing it
+- Opening a session from the list **auto-collapses** the sidebar (workspace group rows and row menus are ignored)
+
+**Top bar**
+- Title row spans the full width; tab row (Chat / Trajectory) gains two right-aligned controls: the agent-preset mode chip (abbreviated to `STD` / `PTC` / `MIN` / `CTR`, en+zh) and the session-log export as a bare icon-only button
+
+**Settings**
+- The settings sheet fills the entire screen (no margins, no radius)
+- Section nav collapses to an icon-only rail (labels stay in the accessibility tree)
+- Picker rows (Permission / Agent preset / Enter behavior): selector on top full-width, description filling the area below
+
+**Chat area**
+- Side padding reduced (32px → 12px left / 6px right), reserved scrollbar gutter removed
+- User bubbles: fit-content size, right-anchored, uncapped width (extend all the way left when long), square right corners, overflow-safe
+
+**PWA**
+- Host route serves a standalone-window manifest (`display: standalone` + `display_override`), so the GUI installs as a real app window — the Android notification bar stays visible (the shipped manifest uses `fullscreen`, which hides it)
+
+## Install
+
+Requires Node.js 22.19+ and DeepSeek Harness. Install into your web profile:
+
+```sh
+dsh plugin --profile web add @canary-builds/dsh-wpa
+```
+
+Restart DSH and refresh the browser. To update, run the same command again and restart. The package includes its Profile Bundle patch and prebuilt browser module; no separate installer, build, or manual composition row is needed for a fresh install.
+
+### Migrating from Splash
+
+This is the successor to `dsh-plugin-splash` in the renamed `Canary-Builds/dsh-wpa` repository. Remove the old `splash` row that names `dsh-plugin-splash` from your profile's `cordis.patch.yml`, then run:
+
+```sh
+dsh plugin --profile web remove dsh-plugin-splash
+dsh plugin --profile web add @canary-builds/dsh-wpa
+```
+
+Restart DSH. Keep other profile overrides intact. Do not load both packages together; both own the same UI behavior and manifest route. GitHub redirects the previous repository URL, but npm package names do not redirect automatically.
+
+## Compatibility
+
+The redesign is implemented as scoped CSS keyed off the shipped UI's DOM: stable public attributes (`data-sidebar-collapsed`, `data-details-collapsed`, slot wrappers) wherever possible, plus CSS-module class hashes for elements that expose nothing else. **Those hashes are build-specific** — the plugin targets the `0.1.1-rc.x` DSH web frontend and may silently no-op (never break) on a version whose bundles re-hash. If a feature stops applying after a DSH upgrade, update the hashes in `lib/client.js` (serve `/plugins/@deepseek-ai/dsh-client-ui-*/client.js` on your install and grep the new prefixes).
+
+## Behavior notes
+
+- The manifest override takes precedence over the dist fallback server; disabling the plugin row restores the shipped manifest on restart
+- All effects are fiber-owned: removing the plugin row cleanly reverts every style, slot entry, listener, and route
+- The floating launcher and auto-collapse never run in desktop browser tabs
+
+## License
+
+MIT
+
+## Development and releases
+
+Run `npm test` and `npm run test:package`. See [RELEASING.md](RELEASING.md) for automated npm publication and GitHub releases. [Report an issue](https://github.com/Canary-Builds/dsh-wpa/issues) · [Canary Builds](https://canarybuilds.com).

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+[
+  {
+    "insert": [
+      {
+        "id": "dsh-wpa",
+        "name": "@canary-builds/dsh-wpa"
+      }
+    ]
+  }
+]

package/lib/client.js

@@ -0,0 +1,171 @@
+// Client half of @canary-builds/dsh-wpa: app-style collapsed sidebar.
+// Graduated from dynamic plugin whale-1/pkg-1. Hand-written static client
+// module in the served ModuleLoader format (identical to the shipped
+// bundles): window.__ModuleLoader__.load({ id, factory }) with require
+// limited to the seeded externals (react, ...).
+//
+// Effects, all owned by this plugin's fiber:
+//   - one <style> tag (data-plugin-css) with the redesign rules;
+//   - one shell.overlay list entry ("whale-fab"): a floating whale button,
+//     top-left, visible only while the sidebar is collapsed; clicking it
+//     calls ctx.layout.toggleSidebar().
+//
+// The collapse redesign is pure CSS keyed off the frame's public
+// data-sidebar-collapsed attribute (set by ui-layout's AppFrame):
+//   - [data-sidebar-collapsed]>.pI_x6G_sidebarCol  -> visibility:hidden
+//     (the 56px icon rail disappears entirely);
+//   - [data-sidebar-collapsed]>.pI_x6G_centerCol   -> margin-left:-56px
+//     (the chat area reclaims the full rail width);
+//   - [data-sidebar-collapsed] .wSkVaW_header      -> padding-left:60px
+//     (the session title clears the floating whale);
+//   - .nL4_yW_sessionLogButton                     -> icon-only 32x32 pill,
+//     absolutely positioned into the header's tab row, right-aligned
+//     (the "Session log" text stays in the a11y tree, visually hidden);
+//   - .SVAs4q_label (the agent-preset mode chip)   -> relocated into the
+//     same tab row, left of the download button; preset name abbreviated
+//     to three letters (STD/PTC/MIN/CTR via the label's title prefix).
+
+window.__ModuleLoader__.load({
+	id: "@canary-builds/dsh-wpa",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		const React = require("react");
+
+		//#region styles (one style tag per document)
+		// PWA/mobile-only: rules apply to real app windows (standalone,
+		// fullscreen, minimal-ui) AND to touch devices (phones reached via a
+		// home-screen shortcut still report display-mode browser); desktop
+		// browser tabs (hover + fine pointer + browser mode) stay stock.
+		const SCOPE = "(display-mode: standalone),(display-mode: fullscreen),(display-mode: minimal-ui),(hover:none) and (pointer:coarse)";
+		const css = "@media " + SCOPE + "{" + [
+			".whalefab-button{position:absolute;top:25.5px;left:10px;z-index:30;display:none;align-items:center;justify-content:center;box-sizing:border-box;width:36px;height:36px;padding:0;border:none;border-radius:10px;background:transparent;color:var(--dsw-alias-label-primary);cursor:pointer}",
+			".whalefab-button:hover{background:var(--dsw-alias-interactive-bg-hover)}",
+			".whalefab-button:active{background:var(--dsw-alias-interactive-bg-active)}",
+			".whalefab-button:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}",
+			".whalefab-mark{display:block;width:26px;height:26px;background-color:currentColor;-webkit-mask-image:url(/favicon.svg);mask-image:url(/favicon.svg);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-position:center;mask-position:center;-webkit-mask-size:contain;mask-size:contain;transform:translateY(1.7px)}",
+			".pI_x6G_centerCol{transition:margin-left var(--ds-transition-duration-slow) var(--ds-ease-in-out)}",
+			"[data-sidebar-collapsed] .whalefab-button{display:flex}",
+			"[data-sidebar-collapsed]>.pI_x6G_sidebarCol{visibility:hidden;pointer-events:none}",
+			"[data-sidebar-collapsed]>.pI_x6G_centerCol{margin-left:-56px}",
+			"[data-sidebar-collapsed] .wSkVaW_header{padding-left:50px;padding-right:0}",
+			// v3 — fullscreen sidebar: when open (and details closed), the sidebar
+			// column overlays the whole frame instead of pushing the chat; the
+			// chat keeps full width underneath.
+			".pI_x6G_frame:not([data-sidebar-collapsed])[data-details-collapsed]{grid-template-columns:0px minmax(0,1fr) 0px!important}",
+			".pI_x6G_frame:not([data-sidebar-collapsed])[data-details-collapsed]>.pI_x6G_sidebarCol{position:absolute;inset:0;z-index:15}",
+			".pI_x6G_frame:not([data-sidebar-collapsed])[data-details-collapsed]>.pI_x6G_handle[data-side=sidebar]{display:none}",
+			".pI_x6G_frame:not([data-sidebar-collapsed])[data-details-collapsed] .hHd-Xa_root{width:100%!important}",
+			".nL4_yW_sessionLogButton{min-width:0;width:32px;height:32px;padding:0;position:absolute;top:40px;right:28px;z-index:2;border:none;border-radius:0;background:transparent}",
+			".nL4_yW_sessionLogButton>span{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}",
+			// v9 — settings nav as a top tab strip: no side column, content
+			// gets the full width; tabs are icon+label, scrollable horizontally.
+			".VOzbGW_panel{flex-direction:column}",
+			".VOzbGW_nav{width:auto;flex:none;flex-direction:row;align-items:center;gap:8px;padding:10px 16px 0;border-bottom:1px solid var(--dsw-alias-border-l2)}",
+			".VOzbGW_navTitle{visibility:visible;padding:0 8px 0 4px}",
+			".VOzbGW_navList{flex-direction:row;gap:4px;flex-wrap:nowrap;overflow-x:auto}",
+			// v10 — settings tabs: icon-only cells; Close swaps to the left of
+			// the settings-document (open conf file) action via header reversal.
+			// v12b — tabs stay icon-only; the General page gains a "General"
+			// heading (styled like the Models page title) since its section
+			// ships without one.
+			".VOzbGW_navCell{height:36px;flex:none;flex-direction:row;justify-content:center;gap:0;width:40px;padding:0;border-radius:10px 10px 0 0}",
+			".VOzbGW_navLabel{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}",
+			"._WvWnq_section::before{content:\"General\";color:var(--dsw-alias-label-primary);margin:0 0 12px;font-size:20px;font-weight:500;line-height:28px;display:block}",
+			// v11 — header row (open conf, then close at the far right) above
+			// the tab strip: content's children become direct panel items via
+			// display:contents.
+			".VOzbGW_content{display:contents}",
+			".VOzbGW_header{order:1}",
+			".VOzbGW_nav{order:2}",
+			".VOzbGW_options{order:3}",
+			// v6 — settings modal fills the entire screen: no margins, no radius.
+			".VOzbGW_panel{width:100vw;max-width:100vw;height:100vh;height:100dvh;border-radius:0;box-shadow:none}",
+			// v5 — settings preset/permission/enter-behavior rows: the selector
+			// moves to the top (full-width), the title + description fill the
+			// area below.
+			".oY77xG_row,._5QVD0a_row,.T1PP_q_row{flex-direction:column;align-items:stretch;gap:8px}",
+			".oY77xG_rowText,._5QVD0a_rowText,.T1PP_q_rowText{order:2;padding-right:0}",
+			".oY77xG_selector,._5QVD0a_selector,.T1PP_q_selector{align-self:stretch}",
+			// v7 — chat area side padding: 32px/side down to 6px, with the
+			// composer clearance variable following so the composer aligns.
+			".Md3f7G_scroll{padding-left:12px;padding-right:6px}",
+			".wSkVaW_scrollBody{scrollbar-gutter:auto}",
+			// v8 — user messages: right-anchored, fit-content size, uncapped so
+			// long text extends all the way to the left; square right corners.
+			".gdEzaW_userRow{align-items:flex-end}",
+			".gdEzaW_userStack{max-width:100%;align-items:flex-end}",
+			".gdEzaW_bubble{box-sizing:border-box;overflow-wrap:anywhere;border-radius:22px 22px 0 22px}",
+			".FJxK0a_root{padding-left:6px;padding-right:6px}",
+			".wSkVaW_root{--dsh-composer-side-clearance:6px}",
+			// v2 — agent-preset mode chip (标准模式/创造模式/PTC/极简): relocate
+			// into the header tab row, left of the download button, and abbreviate
+			// the name to three letters keyed off the label's title (the preset
+			// description). The composer write-access control is NOT touched.
+			".SVAs4q_label{position:absolute;top:45px;right:70px;z-index:2;font-size:0}",
+			".SVAs4q_label::after{font-size:13px;font-weight:500}",
+			".SVAs4q_label[title^=\"Full coding agent\"]::after,.SVAs4q_label[title^=\"功能完整\"]::after{content:\"STD\"}",
+			".SVAs4q_label[title^=\"All Standard mode\"]::after,.SVAs4q_label[title^=\"具备标准\"]::after{content:\"PTC\"}",
+			".SVAs4q_label[title^=\"Two-tool coding agent\"]::after,.SVAs4q_label[title^=\"仅提供持久\"]::after{content:\"MIN\"}",
+			".SVAs4q_label[title^=\"Built for creating\"]::after,.SVAs4q_label[title^=\"用于创建\"]::after{content:\"CTR\"}",
+		].join("") + "}";
+		const tagId = "@canary-builds/dsh-wpa/whale.css";
+		if (typeof document !== "undefined") {
+			// drop a stale tag from the pre-rename name if this page still carries one
+			document.querySelectorAll("style[data-plugin=\"dsh-plugin-whale\"]").forEach((t) => t.remove());
+			const existing = document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]");
+			if (existing !== null) existing.textContent = css;
+			else {
+				const tag = document.createElement("style");
+				tag.dataset.plugin = "@canary-builds/dsh-wpa";
+				tag.dataset.pluginCss = tagId;
+				tag.textContent = css;
+				document.head.appendChild(tag);
+			}
+		}
+		//#endregion
+
+		function apply(ctx) {
+			const FloatingWhale = function () {
+				return React.createElement("button", {
+					type: "button",
+					className: "whalefab-button",
+					"aria-label": "Open sidebar",
+					title: "Open sidebar",
+					onClick: function () { ctx.layout.toggleSidebar(); },
+				}, React.createElement("span", { className: "whalefab-mark" }));
+			};
+			ctx.effect(() => ctx.slots.inject("shell.overlay", () =>
+				ctx.slots.register(
+					{ name: "shell.overlay", id: "whale-fab", order: 0, label: "Open sidebar" },
+					function () { return React.createElement(FloatingWhale); },
+				)
+			), "dsh-wpa: overlay entry");
+			// v3 — auto-collapse: opening a session from the sidebar list closes
+			// the sidebar again (app-style). Session rows carry the hashed
+			// YDXeBa_sessionRow class; workspace group rows do not. Clicks on
+			// inner controls (row menu buttons) are ignored, and the sidebar is
+			// only collapsed when it is actually expanded.
+			ctx.effect(() => {
+				const onClick = (event) => {
+					if (window.matchMedia("(display-mode: standalone),(display-mode: fullscreen),(display-mode: minimal-ui),(hover:none) and (pointer:coarse)").matches === false) return;
+					const target = event.target;
+					if (!(target instanceof Element)) return;
+					if (target.closest("button, a, input, [role=menuitem]") !== null) return;
+					if (target.closest(".YDXeBa_sessionRow") === null) return;
+					if (document.querySelector(".pI_x6G_frame:not([data-sidebar-collapsed])") === null) return;
+					ctx.layout.toggleSidebar();
+				};
+				document.addEventListener("click", onClick, true);
+				return () => document.removeEventListener("click", onClick);
+			}, "dsh-wpa: auto-collapse on session open");
+		}
+
+		exports.apply = apply;
+		exports.inject = ["slots", "layout"];
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,40 @@
+// @canary-builds/dsh-wpa — host half: standalone PWA manifest route.
+//
+// Graduated from the dynamic plugin whale-1/pkg-1 (2026-08-28). Registers a
+// named exact route on the webServer service that takes precedence over the
+// dist fallback server's shipped /manifest.webmanifest (display: fullscreen)
+// and serves a standalone manifest instead, so the GUI installs as a proper
+// app window with its own taskbar icon. Route disposal rides the plugin
+// fiber, so disabling the plugin row removes the override cleanly.
+
+export const inject = ['webServer']
+
+const MANIFEST = JSON.stringify({
+  id: '/',
+  name: 'DeepSeek Harness',
+  short_name: 'DSH',
+  description: 'DeepSeek Harness - local agent workspace.',
+  start_url: '/',
+  scope: '/',
+  display: 'standalone',
+  display_override: ['standalone'],
+  background_color: '#ffffff',
+  theme_color: '#ffffff',
+  icons: [
+    { src: '/favicon.svg', sizes: 'any', type: 'image/svg+xml', purpose: 'any' },
+  ],
+})
+
+export function apply(ctx) {
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/manifest.webmanifest',
+    handler: (req, res) => {
+      res.writeHead(200, {
+        'Content-Type': 'application/manifest+json; charset=utf-8',
+        'Cache-Control': 'no-cache',
+      })
+      res.end(MANIFEST)
+    },
+  }), 'dsh-wpa: PWA manifest route')
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@canary-builds/dsh-wpa",
+  "version": "1.1.0",
+  "description": "Mobile/PWA-first redesign for the DeepSeek Harness web GUI: app-style collapsible sidebar with a floating whale launcher, fullscreen overlay sidebar, compact top bar (icon-only session-log export, abbreviated mode chips), fullscreen settings sheet with icon-only nav, full-width user bubbles, and a standalone-window PWA manifest.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "cordis",
+    "pwa",
+    "ui",
+    "dsh-plugin"
+  ],
+  "dsh": {
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-layout"
+      ]
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Canary-Builds/dsh-wpa.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Canary-Builds/dsh-wpa/issues"
+  },
+  "homepage": "https://github.com/Canary-Builds/dsh-wpa#readme",
+  "author": "Canary Builds",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs",
+    "test:package": "node scripts/check-package.mjs"
+  }
+}