dsh-native-session-delete 1.0.4

package/package.json

@@ -0,0 +1,132 @@
+{
+  "name": "dsh-native-session-delete",
+  "version": "1.0.4",
+  "description": "Permanent session deletion in the native DeepSeek Harness menu",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "compatibility.json",
+    "cordis.patch.yml",
+    "lib/client.js",
+    "scripts/build-client.mjs",
+    "scripts/smoke-ui.mjs",
+    "src/index.js",
+    "src/host/delete-session.mjs",
+    "README.md",
+    "README.en.md",
+    "AGENTS.md",
+    "LICENSE",
+    "SECURITY.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ],
+      "platform": "web"
+    }
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "session",
+    "delete",
+    "privacy"
+  ],
+  "author": "WSL043",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WSL043/dsh-native-session-delete.git"
+  },
+  "bugs": {
+    "url": "https://github.com/WSL043/dsh-native-session-delete/issues"
+  },
+  "homepage": "https://github.com/WSL043/dsh-native-session-delete#readme",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "dependencies": {
+    "clsx": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-client-connection": "0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8",
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-runtime": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-conversation": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-primitives": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-sidebar": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-invariants": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-client-connection": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "0.1.0-rc.8",
+    "dsh-ui-workspace-rc6": "npm:@deepseek-ai/dsh-client-ui-workspace@0.1.0-rc.6",
+    "dsh-ui-workspace-rc7": "npm:@deepseek-ai/dsh-client-ui-workspace@0.1.0-rc.7",
+    "playwright": "1.62.1"
+  },
+  "scripts": {
+    "build": "node scripts/build-client.mjs",
+    "test": "node --test tests/*.test.mjs",
+    "check": "pnpm run test && pnpm run build && pnpm pack --pack-destination .artifacts",
+    "smoke:ui": "node scripts/smoke-ui.mjs"
+  }
+}

package/scripts/build-client.mjs

@@ -0,0 +1,170 @@
+import { readFileSync } from 'node:fs'
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { createRequire } from 'node:module'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const require = createRequire(import.meta.url)
+const here = dirname(fileURLToPath(import.meta.url))
+const output = resolve(here, '../lib/client.js')
+const compatibility = JSON.parse(readFileSync(resolve(here, '../compatibility.json'), 'utf8'))
+const LATEST_UPSTREAM_VERSION = compatibility.latestTested
+const SUPPORTED_UPSTREAM_VERSIONS = new Set(compatibility.supported)
+
+export const resolveUpstreamClient = () => require.resolve('@deepseek-ai/dsh-client-ui-workspace/client')
+export const resolveUpstreamManifest = () => require.resolve('@deepseek-ai/dsh-client-ui-workspace/package.json')
+
+const replaceOnce = (source, before, after, label) => {
+  const first = source.indexOf(before)
+  if (first === -1 || source.indexOf(before, first + before.length) !== -1) {
+    throw new Error(`upstream marker mismatch: ${label}`)
+  }
+  return `${source.slice(0, first)}${after}${source.slice(first + before.length)}`
+}
+
+const findFunctionSignature = (source, functionName) => {
+  const pattern = new RegExp(`function ${functionName}\\(\\{[^}]+\\}\\) \\{`, 'g')
+  const matches = [...source.matchAll(pattern)]
+  if (matches.length !== 1) throw new Error(`upstream marker mismatch: ${functionName} signature`)
+  return matches[0][0]
+}
+
+/**
+ * Add one narrow feature to the shipped workspace client while preserving the
+ * rest of the official bundle byte-for-byte after a modification notice.
+ * Exact markers turn upstream UI drift into a build failure instead of a
+ * silently malformed client.
+ */
+export function patchWorkspaceClient(upstream, upstreamVersion = LATEST_UPSTREAM_VERSION) {
+  if (!SUPPORTED_UPSTREAM_VERSIONS.has(upstreamVersion)) {
+    throw new Error(`unsupported @deepseek-ai/dsh-client-ui-workspace version: ${upstreamVersion}`)
+  }
+  const sessionTreeSignature = findFunctionSignature(upstream, 'SessionTree')
+  const workspaceBrowserSignature = findFunctionSignature(upstream, 'WorkspaceBrowser')
+  if (!sessionTreeSignature.includes('onDeleteRequest, onSessionRename, onSessionArchive, insertWorkspaceBefore,')) {
+    throw new Error('upstream marker mismatch: SessionTree delete insertion point')
+  }
+  if (!workspaceBrowserSignature.includes('deleteWorkspace, insertWorkspaceBefore, archiveSession, insertSessionBefore,')) {
+    throw new Error('upstream marker mismatch: WorkspaceBrowser delete insertion point')
+  }
+  let source = upstream
+  const patch = (before, after, label) => {
+    source = replaceOnce(source, before, after, label)
+  }
+
+  patch(
+    'id: "@deepseek-ai/dsh-client-ui-workspace",',
+    'id: "dsh-native-session-delete",',
+    'client module id',
+  )
+  patch(
+    'function SessionNodeItem({ node, currentId, now, onOpen, onRename, onFork, onArchive, drag, flat = false, t }) {',
+    'function SessionNodeItem({ node, currentId, now, onOpen, onRename, onFork, onArchive, onDelete, drag, flat = false, t }) {',
+    'session row props',
+  )
+  patch(
+    `\t\t\t\t{\n\t\t\t\t\tid: "archive",\n\t\t\t\t\tlabel: t("menu.archiveSession"),\n\t\t\t\t\ticon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconArchiveOutline20, { size: 16 })\n\t\t\t\t}\n`,
+    `\t\t\t\t{\n\t\t\t\t\tid: "archive",\n\t\t\t\t\tlabel: t("menu.archiveSession"),\n\t\t\t\t\ticon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconArchiveOutline20, { size: 16 })\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tid: "delete-session",\n\t\t\t\t\tlabel: t("menu.deleteSession"),\n\t\t\t\t\ticon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutline16, {}),\n\t\t\t\t\tdanger: true\n\t\t\t\t}\n`,
+    'session delete menu item',
+  )
+  patch(
+    '\t\t\t\t\t\t\t\t\tif (id === "archive") onArchive(node.id);\n',
+    '\t\t\t\t\t\t\t\t\tif (id === "archive") onArchive(node.id);\n\t\t\t\t\t\t\t\t\tif (id === "delete-session") onDelete(node.id, title);\n',
+    'session delete menu selection',
+  )
+  patch(
+    sessionTreeSignature,
+    sessionTreeSignature.replace(
+      'onDeleteRequest, onSessionRename, onSessionArchive, insertWorkspaceBefore,',
+      'onDeleteRequest, onSessionRename, onSessionArchive, onSessionDelete, insertWorkspaceBefore,',
+    ),
+    'session tree props',
+  )
+  patch(
+    '\t\t\t\t\t\t\t\t\t\t\tonArchive: onSessionArchive,\n',
+    '\t\t\t\t\t\t\t\t\t\t\tonArchive: onSessionArchive,\n\t\t\t\t\t\t\t\t\t\t\tonDelete: onSessionDelete,\n',
+    'tree row delete prop',
+  )
+  patch(
+    'function FlatList({ useSessions, open, forkSession, onSessionRename, onSessionArchive, archivedSessionIds, orderBy, sessionOrderByAccount, sessionUpdatedAtByAccount, syncSessionOrderAccount, setSessionOrder, t }) {',
+    'function FlatList({ useSessions, open, forkSession, onSessionRename, onSessionArchive, onSessionDelete, archivedSessionIds, orderBy, sessionOrderByAccount, sessionUpdatedAtByAccount, syncSessionOrderAccount, setSessionOrder, t }) {',
+    'flat list props',
+  )
+  patch(
+    '\t\t\t\t\t\t\tonFork: forkSession,\n\t\t\t\t\t\t\tonArchive: onSessionArchive,\n\t\t\t\t\t\t\tflat: true,\n',
+    '\t\t\t\t\t\t\tonFork: forkSession,\n\t\t\t\t\t\t\tonArchive: onSessionArchive,\n\t\t\t\t\t\t\tonDelete: onSessionDelete,\n\t\t\t\t\t\t\tflat: true,\n',
+    'flat row delete prop',
+  )
+  patch(
+    workspaceBrowserSignature,
+    workspaceBrowserSignature.replace(
+      'deleteWorkspace, insertWorkspaceBefore, archiveSession, insertSessionBefore,',
+      'deleteWorkspace, insertWorkspaceBefore, archiveSession, deleteSession, insertSessionBefore,',
+    ),
+    'workspace browser delete action prop',
+  )
+  patch(
+    `\t\t\tconst onSessionArchive = (sessionId) => {\n\t\t\t\tarchiveSession(sessionId).catch((reason) => {\n\t\t\t\t\tconsole.warn("session archive rejected:", reason);\n\t\t\t\t});\n\t\t\t};\n`,
+    `\t\t\tconst onSessionArchive = (sessionId) => {\n\t\t\t\tarchiveSession(sessionId).catch((reason) => {\n\t\t\t\t\tconsole.warn("session archive rejected:", reason);\n\t\t\t\t});\n\t\t\t};\n\t\t\tconst [sessionDeleteTarget, setSessionDeleteTarget] = (0, react.useState)(null);\n\t\t\tconst [sessionDeleting, setSessionDeleting] = (0, react.useState)(false);\n\t\t\tconst [sessionDeleteError, setSessionDeleteError] = (0, react.useState)(null);\n\t\t\tconst onSessionDelete = (sessionId, title) => {\n\t\t\t\tsetSessionDeleteTarget({ sessionId, title });\n\t\t\t\tsetSessionDeleteError(null);\n\t\t\t};\n\t\t\tconst closeSessionDelete = () => {\n\t\t\t\tif (sessionDeleting) return;\n\t\t\t\tsetSessionDeleteTarget(null);\n\t\t\t\tsetSessionDeleteError(null);\n\t\t\t};\n\t\t\tconst confirmSessionDelete = () => {\n\t\t\t\tif (sessionDeleting || sessionDeleteTarget === null) return;\n\t\t\t\tsetSessionDeleting(true);\n\t\t\t\tsetSessionDeleteError(null);\n\t\t\t\tdeleteSession(sessionDeleteTarget.sessionId).then(() => {\n\t\t\t\t\tsetSessionDeleting(false);\n\t\t\t\t\tsetSessionDeleteTarget(null);\n\t\t\t\t\tsetSessionDeleteError(null);\n\t\t\t\t}).catch((reason) => {\n\t\t\t\t\tsetSessionDeleting(false);\n\t\t\t\t\tsetSessionDeleteError(reason instanceof Error ? reason.message : String(reason));\n\t\t\t\t});\n\t\t\t};\n`,
+    'session delete dialog state',
+  )
+  patch(
+    '\t\t\t\t\t\t\tonSessionArchive,\n\t\t\t\t\t\t\tarchivedSessionIds,\n',
+    '\t\t\t\t\t\t\tonSessionArchive,\n\t\t\t\t\t\t\tonSessionDelete,\n\t\t\t\t\t\t\tarchivedSessionIds,\n',
+    'flat list delete handler',
+  )
+  patch(
+    '\t\t\t\t\t\t\tonSessionArchive,\n\t\t\t\t\t\t\tforkSession,\n',
+    '\t\t\t\t\t\t\tonSessionArchive,\n\t\t\t\t\t\t\tonSessionDelete,\n\t\t\t\t\t\t\tforkSession,\n',
+    'session tree delete handler',
+  )
+  patch(
+    `\t\t\t\t\t(0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.Modal, {\n\t\t\t\t\t\topen: deleteTarget !== null,\n`,
+    `\t\t\t\t\t(0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.Modal, {\n\t\t\t\t\t\topen: sessionDeleteTarget !== null,\n\t\t\t\t\t\tonClose: closeSessionDelete,\n\t\t\t\t\t\tcloseLabel: t("close"),\n\t\t\t\t\t\ttitle: t("delete.session.title"),\n\t\t\t\t\t\t...sessionDeleteTarget === null ? {} : { description: t("delete.session.desc", { name: sessionDeleteTarget.title }) },\n\t\t\t\t\t\tfooter: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {\n\t\t\t\t\t\t\tvariant: "outline",\n\t\t\t\t\t\t\tdisabled: sessionDeleting,\n\t\t\t\t\t\t\tonClick: closeSessionDelete,\n\t\t\t\t\t\t\tchildren: t("cancel")\n\t\t\t\t\t\t}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {\n\t\t\t\t\t\t\tvariant: "outline",\n\t\t\t\t\t\t\tclassName: WorkspaceBrowser_module_css_default.deleteAction,\n\t\t\t\t\t\t\tdisabled: sessionDeleting,\n\t\t\t\t\t\t\tonClick: confirmSessionDelete,\n\t\t\t\t\t\t\tchildren: t("delete.session.confirm")\n\t\t\t\t\t\t})] }),\n\t\t\t\t\t\tchildren: [sessionDeleting && (0, react_jsx_runtime.jsx)("div", {\n\t\t\t\t\t\t\tclassName: WorkspaceBrowser_module_css_default.deleteStatus,\n\t\t\t\t\t\t\trole: "status",\n\t\t\t\t\t\t\tchildren: t("delete.session.pending")\n\t\t\t\t\t\t}), sessionDeleteError !== null && (0, react_jsx_runtime.jsx)("div", {\n\t\t\t\t\t\t\tclassName: WorkspaceBrowser_module_css_default.renameError,\n\t\t\t\t\t\t\trole: "alert",\n\t\t\t\t\t\t\tchildren: sessionDeleteError\n\t\t\t\t\t\t})]\n\t\t\t\t\t}),\n\t\t\t\t\t(0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.Modal, {\n\t\t\t\t\t\topen: deleteTarget !== null,\n`,
+    'session delete confirmation modal',
+  )
+  patch(
+    '\t\t\t"menu.archiveSession": "归档会话",\n',
+    '\t\t\t"menu.archiveSession": "归档会话",\n\t\t\t"menu.deleteSession": "删除会话",\n\t\t\t"delete.session.title": "永久删除会话？",\n\t\t\t"delete.session.desc": "“{name}”的会话记录将从本机永久删除，且无法恢复。正在运行的任务会先安全停止。",\n\t\t\t"delete.session.confirm": "永久删除",\n\t\t\t"delete.session.pending": "正在永久删除会话…",\n',
+    'Chinese delete locale',
+  )
+  patch(
+    '\t\t\t"menu.archiveSession": "Archive session",\n',
+    '\t\t\t"menu.archiveSession": "Archive session",\n\t\t\t"menu.deleteSession": "Delete session",\n\t\t\t"delete.session.title": "Permanently delete session?",\n\t\t\t"delete.session.desc": "The local record for “{name}” will be permanently deleted and cannot be recovered. Running work will be stopped safely before deletion.",\n\t\t\t"delete.session.confirm": "Delete permanently",\n\t\t\t"delete.session.pending": "Permanently deleting session…",\n',
+    'English delete locale',
+  )
+  patch(
+    `\t\t\t\tarchiveSession: async (sessionId) => {\n\t\t\t\t\tawait ctx.workspaces.archiveSession(sessionId);\n\t\t\t\t},\n`,
+    `\t\t\t\tarchiveSession: async (sessionId) => {\n\t\t\t\t\tawait ctx.workspaces.archiveSession(sessionId);\n\t\t\t\t},\n\t\t\t\tdeleteSession: async (sessionId) => {\n\t\t\t\t\tconst response = await fetch("/plugins/dsh-session-delete/delete", {\n\t\t\t\t\t\tmethod: "POST",\n\t\t\t\t\t\theaders: {\n\t\t\t\t\t\t\t"content-type": "application/json",\n\t\t\t\t\t\t\t"x-dsh-session-delete-confirmation": "delete-session"\n\t\t\t\t\t\t},\n\t\t\t\t\t\tbody: JSON.stringify({ sessionId })\n\t\t\t\t\t});\n\t\t\t\t\tconst payload = await response.json().catch(() => null);\n\t\t\t\t\tif (!response.ok || payload?.ok !== true) {\n\t\t\t\t\t\tthrow new Error(payload?.error?.message ?? \`Delete failed (HTTP \${response.status})\`);\n\t\t\t\t\t}\n\t\t\t\t\tif (ctx.sessions.list.getSnapshot().current === sessionId) ctx.sessions.clear();\n\t\t\t\t\tconst refreshes = await Promise.allSettled([\n\t\t\t\t\t\tctx.sessions.refresh(),\n\t\t\t\t\t\tctx.workspaces.refresh()\n\t\t\t\t\t]);\n\t\t\t\t\tfor (const refresh of refreshes) {\n\t\t\t\t\t\tif (refresh.status === "rejected") console.warn("session deletion succeeded but runtime refresh failed:", refresh.reason);\n\t\t\t\t\t}\n\t\t\t\t},\n`,
+    'browser delete request',
+  )
+  const homePathCall = '(0, _deepseek_ai_dsh_client_runtime_client.abbreviateHomePath)(row.cwd, home)'
+  if (source.includes(homePathCall)) {
+    patch(
+      homePathCall,
+      'typeof _deepseek_ai_dsh_client_runtime_client.abbreviateHomePath === "function" ? (0, _deepseek_ai_dsh_client_runtime_client.abbreviateHomePath)(row.cwd, home) : row.cwd',
+      'home path compatibility fallback',
+    )
+  }
+
+  const notice = `// Modified from @deepseek-ai/dsh-client-ui-workspace ${upstreamVersion} by DSH Native Session Delete. See THIRD_PARTY_NOTICES.md.\n`
+  return `${notice}${source}`
+}
+
+export async function buildClient() {
+  const manifest = JSON.parse(await readFile(resolveUpstreamManifest(), 'utf8'))
+  if (manifest.version !== LATEST_UPSTREAM_VERSION) {
+    throw new Error(
+      `unsupported @deepseek-ai/dsh-client-ui-workspace version: ${manifest.version ?? 'unknown'}`,
+    )
+  }
+  const upstream = await readFile(resolveUpstreamClient(), 'utf8')
+  const patched = patchWorkspaceClient(upstream, manifest.version)
+  await mkdir(dirname(output), { recursive: true })
+  await writeFile(output, patched, 'utf8')
+  return output
+}
+
+if (process.argv[1] !== undefined && pathToFileURL(resolve(process.argv[1])).href === import.meta.url) {
+  process.stdout.write(`${await buildClient()}\n`)
+}

package/scripts/smoke-ui.mjs

@@ -0,0 +1,216 @@
+import { chromium } from 'playwright'
+import { resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+const HELP = `Usage:
+  pnpm smoke:ui -- --session "Exact session title" [options]
+
+Options:
+  --url <url>          Running DSH URL (default: http://127.0.0.1:14171)
+  --session <title>    Exact existing session title (required)
+  --channel <name>     Browser channel such as chrome (optional)
+  --executable <path>  Existing Chromium-family executable (optional)
+  --headed             Show the browser window
+  --screenshot <path>  Save the opened confirmation dialog
+  --simulate-delete-success
+                       On a ?fixture page only, intercept the delete request,
+                       click the final button, and verify no page reload
+  --help               Show this help
+
+By default this check opens Delete session, verifies the confirmation dialog,
+and clicks Cancel. The simulation mode never reaches the Host deletion route or
+controls DSH's process lifecycle.
+`
+
+export function parseArgs(argv) {
+  const result = { url: 'http://127.0.0.1:14171', headed: false }
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index]
+    if (arg === '--') continue
+    if (arg === '--help') return { help: true }
+    if (arg === '--headed') {
+      result.headed = true
+      continue
+    }
+    if (arg === '--simulate-delete-success') {
+      result.simulateDeleteSuccess = true
+      continue
+    }
+    if (['--url', '--session', '--channel', '--executable', '--screenshot'].includes(arg)) {
+      const value = argv[index + 1]
+      if (value === undefined || value.startsWith('--')) throw new Error(`${arg} requires a value`)
+      result[arg.slice(2)] = value
+      index += 1
+      continue
+    }
+    throw new Error(`unknown argument: ${arg}`)
+  }
+  if (typeof result.session !== 'string' || result.session.length === 0) {
+    throw new Error('--session is required so the smoke test never chooses a user session implicitly')
+  }
+  if (result.channel !== undefined && result.executable !== undefined) {
+    throw new Error('use either --channel or --executable, not both')
+  }
+  if (result.simulateDeleteSuccess === true) {
+    if (!isFixtureUrl(result.url)) {
+      throw new Error('--simulate-delete-success requires a DSH fixture URL so it cannot target user sessions')
+    }
+  }
+  return result
+}
+
+export function isFixtureUrl(url) {
+  return new URL(url).searchParams.has('fixture')
+}
+
+export function isIgnorableFixtureConsoleError(message) {
+  return (
+    message.includes('[cordis-client-runner] syncing inspect providers failed:')
+      && message.includes('fixture connection RPC endpoint "dynamicCordisRunner/syncInspectManifest" is unavailable')
+  ) || (
+    message.includes('[ui-cordis] reading the Cordis inventory failed:')
+      && message.includes('fixture connection RPC endpoint "dynamicCordisRunner/inventory" is unavailable')
+  )
+}
+
+export async function runSmoke(options) {
+  const deleteRequests = []
+  const consoleErrors = []
+  const fixture = isFixtureUrl(options.url)
+  const browser = await chromium.launch({
+    headless: !options.headed,
+    ...(options.channel === undefined ? {} : { channel: options.channel }),
+    ...(options.executable === undefined ? {} : { executablePath: options.executable }),
+  })
+  try {
+    const page = await browser.newPage({ viewport: { width: 1440, height: 960 } })
+    let navigationArmed = false
+    let mainFrameNavigations = 0
+    if (options.simulateDeleteSuccess === true) {
+      await page.addInitScript(() => {
+        globalThis.__dshDeleteSmokeDocumentToken = crypto.randomUUID()
+      })
+      await page.route('**/plugins/dsh-session-delete/delete', async (route) => {
+        await route.fulfill({
+          status: 200,
+          contentType: 'application/json',
+          body: JSON.stringify({ ok: true, value: { deleted: true } }),
+        })
+      })
+      page.on('framenavigated', (frame) => {
+        if (navigationArmed && frame === page.mainFrame()) mainFrameNavigations += 1
+      })
+    }
+    page.on('request', (request) => {
+      if (new URL(request.url()).pathname === '/plugins/dsh-session-delete/delete') {
+        deleteRequests.push(request.method())
+      }
+    })
+    page.on('console', (message) => {
+      if (message.type() === 'error') consoleErrors.push(message.text())
+    })
+
+    await page.goto(options.url, { waitUntil: 'domcontentloaded' })
+    const documentToken = options.simulateDeleteSuccess === true
+      ? await page.evaluate(() => globalThis.__dshDeleteSmokeDocumentToken)
+      : undefined
+    if (fixture) {
+      // Fixture mode cannot persist DSH's product-wide onboarding acknowledgement,
+      // so clicking Continue immediately reopens the unrelated notice. Remove only
+      // that exact fixture-only overlay; never mutate real settings or user pages.
+      const onboarding = page.getByRole('dialog', { name: /^(内测声明|Internal Testing Notice)$/ })
+      const onboardingVisible = await onboarding
+        .waitFor({ state: 'visible', timeout: 3000 })
+        .then(() => true, () => false)
+      if (onboardingVisible) {
+        await onboarding.evaluate((element) => {
+          const overlay = element.parentElement
+          if (overlay !== null) overlay.remove()
+          else element.remove()
+          for (const inertElement of document.querySelectorAll('[inert]')) {
+            inertElement.removeAttribute('inert')
+          }
+        })
+      }
+    }
+    const matchingTitles = page.getByText(options.session, { exact: true })
+    await matchingTitles.first().waitFor()
+    const rowCount = await matchingTitles.count()
+    if (rowCount !== 1) {
+      throw new Error(`expected exactly one visible session row named ${JSON.stringify(options.session)}, found ${rowCount}`)
+    }
+
+    const row = matchingTitles.first().locator('xpath=ancestor::*[@role="treeitem"][1]')
+    await row.hover()
+    const actions = row.getByRole('button')
+    if (await actions.count() !== 1) throw new Error('session action button was not uniquely identifiable')
+    await actions.click()
+
+    const archiveItem = page.getByRole('menuitem', { name: /^(Archive session|归档会话)$/ })
+    await archiveItem.waitFor()
+    const deleteItem = page.getByRole('menuitem', { name: /^(Delete session|删除会话)$/ })
+    await deleteItem.waitFor()
+    const [archiveColor, deleteColor] = await Promise.all([
+      archiveItem.evaluate((element) => getComputedStyle(element).color),
+      deleteItem.evaluate((element) => getComputedStyle(element).color),
+    ])
+    if (archiveColor === deleteColor) {
+      throw new Error(`delete menu item is not using a distinct danger color (${deleteColor})`)
+    }
+    await deleteItem.click()
+
+    const dialog = page.getByRole('dialog')
+    await dialog.getByText(/^(Permanently delete session\?|永久删除会话？)$/).waitFor()
+    await dialog.getByRole('button', { name: /^(Delete permanently|永久删除)$/ }).waitFor()
+    const cancel = dialog.getByRole('button', { name: /^(Cancel|取消)$/ })
+    await cancel.waitFor()
+    if (options.screenshot !== undefined) await dialog.screenshot({ path: options.screenshot })
+    if (options.simulateDeleteSuccess === true) {
+      navigationArmed = true
+      await dialog.getByRole('button', { name: /^(Delete permanently|永久删除)$/ }).click()
+      await page.waitForTimeout(750)
+      const settledToken = await page.evaluate(() => globalThis.__dshDeleteSmokeDocumentToken)
+      if (deleteRequests.length !== 1) {
+        throw new Error(`simulated success expected one delete request, observed ${deleteRequests.length}`)
+      }
+      if (mainFrameNavigations !== 0 || settledToken !== documentToken) {
+        throw new Error(`successful deletion reloaded the WebView (${mainFrameNavigations} main-frame navigation(s))`)
+      }
+      await dialog.getByText(/^(Permanently delete session\?|永久删除会话？)$/).waitFor({ state: 'hidden' })
+    } else {
+      await cancel.click()
+      await dialog.waitFor({ state: 'hidden' })
+      if (deleteRequests.length > 0) {
+        throw new Error(`cancel path unexpectedly sent ${deleteRequests.length} delete request(s)`)
+      }
+    }
+    const blockingConsoleErrors = fixture
+      ? consoleErrors.filter((message) => !isIgnorableFixtureConsoleError(message))
+      : consoleErrors
+    if (blockingConsoleErrors.length > 0) {
+      throw new Error(`browser console errors: ${blockingConsoleErrors.join(' | ')}`)
+    }
+    return {
+      ok: true,
+      checks: options.simulateDeleteSuccess === true
+        ? ['Archive session', 'red Delete session', 'confirmation dialog', 'successful delete without reload']
+        : ['Archive session', 'red Delete session', 'confirmation dialog', 'cancel without request'],
+    }
+  } finally {
+    await browser.close()
+  }
+}
+
+if (process.argv[1] !== undefined && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
+  try {
+    const options = parseArgs(process.argv.slice(2))
+    if (options.help) {
+      process.stdout.write(HELP)
+    } else {
+      process.stdout.write(`${JSON.stringify(await runSmoke(options))}\n`)
+    }
+  } catch (error) {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`)
+    process.exitCode = 1
+  }
+}