dsh-browser-plus 0.0.0-stage → 0.5.1

package/package.json

@@ -1,6 +1,122 @@
 {
   "name": "dsh-browser-plus",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.1",
+  "description": "Enhanced shared browser for DeepSeek Harness: one visible window with isolated task views, a page task manager, non-stealing background tasks, built-in toolbar and operation trail, and pinned Electron 42.9.3 compositing.",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./browser": {
+      "types": "./lib/browser/runtime.d.ts",
+      "default": "./lib/browser/runtime.js"
+    },
+    "./browser-electron": {
+      "types": "./lib/browser-electron/entry.d.ts",
+      "default": "./lib/browser-electron/entry.js"
+    },
+    "./tool-browser": {
+      "types": "./lib/tool-browser/index.d.ts",
+      "default": "./lib/tool-browser/index.js"
+    },
+    "./command-browser": {
+      "types": "./lib/command-browser/index.d.ts",
+      "default": "./lib/command-browser/index.js"
+    },
+    "./http-browser": {
+      "types": "./lib/http-browser/index.d.ts",
+      "default": "./lib/http-browser/index.js"
+    },
+    "./task-todos": {
+      "types": "./lib/task-todos/index.d.ts",
+      "default": "./lib/task-todos/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./host-main": {
+      "default": "./lib/browser-electron/host-main.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "client",
+    "docs",
+    "assets",
+    "scripts",
+    "screenshots.json",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "NOTICE.md"
+  ],
+  "scripts": {
+    "build": "npm run build:icons && tsc -p tsconfig.json && npm run build:client",
+    "build:icons": "node scripts/build-icons.mjs",
+    "build:client": "node scripts/build-client.mjs",
+    "pretest": "tsc -p tsconfig.json",
+    "test": "node --test test/*.test.mjs",
+    "test:only": "node --test test/*.test.mjs",
+    "lint": "eslint src",
+    "smoke:electron-host": "node scripts/smoke-electron-host.mjs",
+    "smoke:browser-tools": "node scripts/smoke-browser-tools.mjs",
+    "smoke:chrome-world": "node scripts/smoke-chrome-world.mjs",
+    "test:orb-drag": "node scripts/test-orb-drag.mjs",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "browser",
+    "cdp"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ParticleLight/dsh-browser-plus.git"
+  },
+  "homepage": "https://github.com/ParticleLight/dsh-browser-plus",
+  "bugs": {
+    "url": "https://github.com/ParticleLight/dsh-browser-plus/issues"
+  },
+  "engines": {
+    "node": ">=22.19"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.1 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.1 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.1 || ^0.2.0-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "devDependencies": {
+    "@resvg/resvg-js": "^2.6.2",
+    "@types/node": "^22.0.0",
+    "eslint": "^10.11.0",
+    "typescript": "^5.5.0",
+    "typescript-eslint": "^8.71.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-sidebar-right"
+      ],
+      "platform": "web"
+    }
+  },
+  "optionalDependencies": {
+    "electron": "42.9.3"
+  }
+}

package/screenshots.json

@@ -0,0 +1,3 @@
+[
+  "assets/readme-workspace.png"
+]

package/scripts/build-client.mjs

@@ -0,0 +1,20 @@
+/**
+ * Build the browser bundle: copy the single-file client source to lib/client.js.
+ *
+ * The client-modules loader serves the package's \`./client\` export, and the
+ * bundle is one file that only requires platform modules (React), so there is
+ * nothing to bundle or minify — the copy keeps the shipped artifact identical to
+ * the reviewed source. Run by \`npm run build\` and by \`prepack\`.
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+
+const source = new URL('../client/index.js', import.meta.url)
+const output = new URL('../lib/client.js', import.meta.url)
+
+const body = await readFile(source, 'utf8')
+if (!body.includes('__ModuleLoader__.load')) {
+  throw new Error('client/index.js must register through window.__ModuleLoader__.load')
+}
+await mkdir(new URL('../lib/', import.meta.url), { recursive: true })
+await writeFile(output, body)
+process.stdout.write('built lib/client.js (' + String(body.length) + ' bytes)\n')

package/scripts/build-icons.mjs

@@ -0,0 +1,80 @@
+// Browser icon derivatives builder.
+// Reads assets/dsh-browser-plus.svg (plus the -small variant for the sizes where the
+// title-bar dots would be sub-pixel), renders 256/512 PNGs and an ICO
+// (16/32/48/256 PNG entries) with @resvg/resvg-js, writes them to assets/.
+
+import { readFile, writeFile, mkdir } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { Resvg } from '@resvg/resvg-js'
+
+const root = path.dirname(path.dirname(fileURLToPath(import.meta.url)))
+const assetsDir = path.join(root, 'assets')
+const svgPath = path.join(assetsDir, 'dsh-browser-plus.svg')
+
+const smallSvgPath = path.join(assetsDir, 'dsh-browser-plus-small.svg')
+
+async function readSvg(file, label) {
+  try {
+    return await readFile(file, 'utf8')
+  } catch (error) {
+    console.error(`build-icons: cannot read ${label} at ${file}: ${error.message}`)
+    process.exit(1)
+  }
+}
+
+const svg = await readSvg(svgPath, 'source SVG')
+// Falls back to the full-detail art, so a missing variant degrades instead of failing.
+const smallSvg = existsSync(smallSvgPath) ? await readSvg(smallSvgPath, 'small SVG') : svg
+
+function renderPng(size, source = svg) {
+  const data = new Resvg(source, { fitTo: { mode: 'width', value: size } }).render()
+  const buffer = data.asPng()
+  if (!buffer || buffer.length === 0) {
+    throw new Error(`build-icons: empty render at ${size}px`)
+  }
+  return buffer
+}
+
+function buildIco(images) {
+  const header = Buffer.alloc(6)
+  header.writeUInt16LE(0, 0)
+  header.writeUInt16LE(1, 2)
+  header.writeUInt16LE(images.length, 4)
+  const entries = Buffer.alloc(images.length * 16)
+  let offset = 6 + entries.length
+  for (let i = 0; i < images.length; i++) {
+    const image = images[i]
+    const size = image.size >= 256 ? 0 : image.size
+    entries.writeUInt8(size, i * 16)
+    entries.writeUInt8(size, i * 16 + 1)
+    entries.writeUInt8(0, i * 16 + 2)
+    entries.writeUInt8(0, i * 16 + 3)
+    entries.writeUInt16LE(1, i * 16 + 4)
+    entries.writeUInt16LE(32, i * 16 + 6)
+    entries.writeUInt32LE(image.bytes.length, i * 16 + 8)
+    entries.writeUInt32LE(offset, i * 16 + 12)
+    offset += image.bytes.length
+  }
+  return Buffer.concat([header, entries, ...images.map((image) => image.bytes)])
+}
+
+await mkdir(assetsDir, { recursive: true })
+
+const png256 = renderPng(256)
+const png512 = renderPng(512)
+const ico = buildIco([
+  { size: 16, bytes: renderPng(16, smallSvg) },
+  { size: 32, bytes: renderPng(32, smallSvg) },
+  { size: 48, bytes: renderPng(48) },
+  { size: 256, bytes: png256 },
+])
+
+await writeFile(path.join(assetsDir, 'dsh-browser-plus-256.png'), png256)
+await writeFile(path.join(assetsDir, 'dsh-browser-plus-512.png'), png512)
+await writeFile(path.join(assetsDir, 'dsh-browser-plus.ico'), ico)
+
+console.log(`assets/dsh-browser-plus-256.png ${png256.length} bytes`)
+console.log(`assets/dsh-browser-plus-512.png ${png512.length} bytes`)
+console.log(`assets/dsh-browser-plus.ico ${ico.length} bytes`)

package/scripts/capture-window.ps1

@@ -0,0 +1,79 @@
+param([string]$Out = 'F:\deepseekharness\dsh-browser-plus\.tmp\window.png', [long]$Hwnd = 0)
+Add-Type -AssemblyName System.Drawing
+Add-Type @"
+using System;
+using System.Runtime.InteropServices;
+public class CapFg {
+  [DllImport("user32.dll")] public static extern bool SetProcessDPIAware();
+  [DllImport("user32.dll")] public static extern bool GetWindowRect(IntPtr h, out RECT r);
+  [DllImport("user32.dll")] public static extern bool SetWindowPos(IntPtr h, IntPtr after, int x, int y, int cx, int cy, uint flags);
+  [DllImport("user32.dll")] public static extern bool ShowWindow(IntPtr h, int n);
+  [DllImport("user32.dll")] public static extern bool IsIconic(IntPtr h);
+  [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr h);
+  [DllImport("user32.dll")] public static extern IntPtr GetForegroundWindow();
+  [DllImport("user32.dll")] public static extern bool BringWindowToTop(IntPtr h);
+  [DllImport("user32.dll")] public static extern uint GetWindowThreadProcessId(IntPtr h, IntPtr pid);
+  [DllImport("user32.dll")] public static extern bool AttachThreadInput(uint a, uint b, bool f);
+  [DllImport("kernel32.dll")] public static extern uint GetCurrentThreadId();
+  [StructLayout(LayoutKind.Sequential)] public struct RECT { public int Left, Top, Right, Bottom; }
+  public static void Force(IntPtr h) {
+    uint fg = GetWindowThreadProcessId(GetForegroundWindow(), IntPtr.Zero);
+    uint me = GetCurrentThreadId();
+    AttachThreadInput(me, fg, true);
+    BringWindowToTop(h);
+    SetForegroundWindow(h);
+    AttachThreadInput(me, fg, false);
+  }
+}
+"@
+[void][CapFg]::SetProcessDPIAware()
+# An explicit handle wins: Electron can own several top-level windows and
+# MainWindowHandle sometimes picks a helper instead of the browser window.
+$h = if ($Hwnd -ne 0) { [IntPtr]$Hwnd } else { 0 }
+$p = $null
+if ($Hwnd -eq 0) {
+# Pick the LARGEST top-level window owned by an electron process with our title.
+# MainWindowHandle is unreliable here: Electron owns several top-level windows and
+# Windows happily reports a small helper, which silently screenshots the wrong thing.
+$p = Get-Process electron -ErrorAction SilentlyContinue | Where-Object { $_.MainWindowTitle -like '*dsh-browser-plus*' -and $_.MainWindowHandle -ne 0 } | Select-Object -First 1
+if (-not $p) { Write-Output 'NO WINDOW'; exit 1 }
+$best = [IntPtr]::Zero
+$bestArea = 0
+foreach ($proc in $p) {
+  foreach ($h in @($proc.MainWindowHandle)) {
+    if ($h -eq [IntPtr]::Zero) { continue }
+    $rect = New-Object CapFg+RECT
+    if (-not [CapFg]::GetWindowRect($h, [ref]$rect)) { continue }
+    $area = ($rect.Right - $rect.Left) * ($rect.Bottom - $rect.Top)
+    if ($area -gt $bestArea) { $bestArea = $area; $best = $h }
+  }
+}
+if ($best -eq [IntPtr]::Zero) { Write-Output 'NO WINDOW'; exit 1 }
+$h = $best
+}
+[void][CapFg]::ShowWindow($h, 9)
+Start-Sleep -Milliseconds 500
+[CapFg]::Force($h)
+[void][CapFg]::SetWindowPos($h, [IntPtr](-1), 0, 0, 0, 0, 0x0003 -bor 0x0040)
+Start-Sleep -Milliseconds 1500
+$r = New-Object CapFg+RECT
+[void][CapFg]::GetWindowRect($h, [ref]$r)
+$cw = $r.Right - $r.Left; $ch = $r.Bottom - $r.Top
+$fg = [CapFg]::GetForegroundWindow()
+Write-Output ("hwnd=" + $h + " fg=" + $fg + " same=" + ($fg -eq $h) + " rect=" + $cw + "x" + $ch)
+$bmp = New-Object System.Drawing.Bitmap($cw, $ch)
+$g = [System.Drawing.Graphics]::FromImage($bmp)
+$g.CopyFromScreen($r.Left, $r.Top, 0, 0, (New-Object System.Drawing.Size($cw, $ch)))
+$dir = Split-Path $Out
+if (-not (Test-Path $dir)) { New-Item -ItemType Directory -Force -Path $dir | Out-Null }
+$bmp.Save($Out, [System.Drawing.Imaging.ImageFormat]::Png)
+$g.Dispose(); $bmp.Dispose()
+[void][CapFg]::SetWindowPos($h, [IntPtr](-2), 0, 0, 0, 0, 0x0003)
+# The foreground dance above can leave the window minimised (seen 2026-10-02: the
+# capture reported 276x45 = the iconic rect and the user's browser stayed in the
+# taskbar). Put it back the way we found it before we hand control back.
+if ([CapFg]::IsIconic($h)) {
+  [void][CapFg]::ShowWindow($h, 9)
+  Start-Sleep -Milliseconds 500
+}
+Write-Output ("saved " + $Out + " iconicAfter=" + [CapFg]::IsIconic($h))

package/scripts/crop-image.ps1

@@ -0,0 +1,20 @@
+<#
+.SYNOPSIS
+  Crop a region out of a PNG (no image library, System.Drawing only).
+
+.DESCRIPTION
+  Used with scripts/capture-window.ps1 to look at the chrome band at full
+  resolution: a downscaled full-window capture cannot show whether a tab icon
+  actually rendered. Omit -W/-H to crop to the bottom-right corner.
+#>
+param([string]$In, [string]$Out, [int]$X=0, [int]$Y=0, [int]$W=0, [int]$H=0)
+Add-Type -AssemblyName System.Drawing
+$src = [System.Drawing.Image]::FromFile($In)
+if ($W -le 0) { $W = $src.Width - $X }
+if ($H -le 0) { $H = $src.Height - $Y }
+$dst = New-Object System.Drawing.Bitmap($W, $H)
+$g = [System.Drawing.Graphics]::FromImage($dst)
+$g.DrawImage($src, (New-Object System.Drawing.Rectangle(0,0,$W,$H)), (New-Object System.Drawing.Rectangle($X,$Y,$W,$H)), [System.Drawing.GraphicsUnit]::Pixel)
+$dst.Save($Out, [System.Drawing.Imaging.ImageFormat]::Png)
+$g.Dispose(); $dst.Dispose(); $src.Dispose()
+Write-Output "cropped $Out $W x $H"