dsh-notch-focus 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DSH Notch contributors
+
+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,38 @@
+# dsh-notch-focus 0.1.2
+
+DSH Notch 的客户端同步助手。0.1.2 源码的 `@deepseek-ai/dsh-*` peer 为 `>=0.2.0-rc.1 <0.2.1`，对应 DeepSeek Harness **`dsh-v0.2.0-rc.2` Desktop / Web**，与 `dsh-notch` 0.3.3 同时更新。该范围接受 `0.2.0-rc.2` 和稳定版 `0.2.0`，拒绝 `0.2.0` alpha，也拒绝 `0.1.7-rc.2`。已发布的 0.1.1 包仍在 v0.3.2 Release 里。
+
+- 从 Notch 点击会话，通过 RC2 的 `uiWorkspace.openSession` 打开对话。
+- 从 RC2 `uiSession.sessionStatus` 读取未读完成状态，通过 `retainedBy.mainView` 识别当前会话。
+- 仅前台页面查看已完成会话时发送带时间的阅读确认；后台页面、仍运行的会话不会清除未读结果。
+- 保留用户 fork，只排除 `origin: subagent` 的子代理；允许 API 创建的自定义会话 ID。
+- 首次轮询忽略旧跳转请求，避免重新打开页面时意外切换会话。
+
+## 安装
+
+下载 [Notch v0.3.2 Release](https://github.com/aa2246740/dsh-notch/releases/tag/v0.3.2) 的 `dsh-notch-focus-0.1.1.tgz`，与 Host 插件安装到同一个 profile。
+
+Desktop 使用应用内插件管理页；Web 使用：
+
+```sh
+dsh plugin --profile web add /absolute/path/to/dsh-notch-focus-0.1.1.tgz
+```
+
+包内已有官方 `dsh.bundle.patch`，不要再手动追加同名条目。按管理器提示完成加载并重新打开页面；已有安装更新原条目。只替换磁盘文件不代表当前页面已加载新代码。
+
+## 从源码构建
+
+开发者需要 Node.js 24、DSHX 0.9.2（git 分支，不用 npm 上的旧版）和已备好依赖的 **`dsh-v0.2.0-rc.2`** Harness checkout。在本目录运行：
+
+```sh
+npm ci --ignore-scripts --legacy-peer-deps
+DSHX_HARNESS=/absolute/path/to/deepseek-harness npm run build
+```
+
+编译只写本插件的 `lib/`。客户端产物为 `lib/client.js`，使用 DSHX 的外部构建适配器。发布包已经带有该产物，安装者无需源码构建或 DSHX。
+
+## English
+
+The 0.1.2 companion source targets DSH `dsh-v0.2.0-rc.2` Desktop and Web with Notch 0.3.3. Its `@deepseek-ai/dsh-*` peer is `>=0.2.0-rc.1 <0.2.1`: that accepts `0.2.0-rc.2` and stable `0.2.0`, and rejects `0.2.0` alphas and `0.1.7-rc.2`. It uses `uiWorkspace.openSession`, `uiSession.sessionStatus`, and main-view retention for bidirectional navigation and timestamped reading acknowledgements. Inactive pages and running sessions cannot clear unread results. User forks remain independent; delegated subagents are excluded. The published 0.1.1 tarball remains on the v0.3.2 release.
+
+Install the prebuilt `.tgz` from the linked release using the Desktop Plugins page or the Web CLI above. Both plugins must use the same profile. The package supplies its Bundle patch; do not mount it again manually. Follow the manager's loading instructions and reopen the page. Client HMR in every Desktop variant is not claimed.

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-notch-focus
+      name: dsh-notch-focus

package/cordis.yml

@@ -0,0 +1,5 @@
+# portable overlay: relative name only. --patch resolves against the profile
+# directory, so cold-boot through `dshx start` / `dshx verify-boot`, not raw pnpm dsh.
+- insert:
+    - id: dsh-notch-focus
+      name: './src/dsh-notch-focus.ts'

package/lib/client.js

@@ -0,0 +1,102 @@
+window.__ModuleLoader__.load({
+	id: "dsh-notch-focus",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		//#region src/client/index.tsx
+		const name = "dsh-notch-focus-client";
+		const inject = [
+			"sessions",
+			"uiWorkspace",
+			"uiSession"
+		];
+		const POLL_MS = 400;
+		function apply(ctx) {
+			const sessions = ctx.get("sessions");
+			const clientId = crypto.randomUUID();
+			let lastAt = 0;
+			let armed = false;
+			let stopped = false;
+			const open = async (sessionId) => {
+				try {
+					ctx.uiWorkspace.openSession(sessionId);
+					return;
+				} catch {}
+				try {
+					await sessions.refresh();
+					ctx.uiWorkspace.openSession(sessionId);
+				} catch {}
+			};
+			const poll = async () => {
+				try {
+					const snapshot = sessions.list.getSnapshot();
+					if (snapshot.phase === "ready") {
+						const rows = snapshot.ids.map((id) => snapshot.byId[id]).filter((row) => row && row.origin !== "subagent").map((row) => ({
+							id: row.id,
+							title: row.displayTitle,
+							completed: ctx.uiSession.sessionStatus.getSnapshot().get(row.id)?.completionUnread === true,
+							running: row.running,
+							updatedAt: row.updatedAt
+						}));
+						const focused = document.hasFocus();
+						const current = rows.find((row) => row.id === Object.values(snapshot.byId).find((item) => (item.retainedBy?.mainView ?? 0) > 0)?.id);
+						const viewed = focused && current && !current.running ? {
+							id: current.id,
+							at: Date.now()
+						} : void 0;
+						await fetch("/dsh-notch/sidebar", {
+							method: "POST",
+							headers: {
+								"content-type": "application/json",
+								"x-dsh-notch-client": "1"
+							},
+							body: JSON.stringify({
+								clientId,
+								projectionVersion: 3,
+								focused,
+								viewed,
+								rows
+							})
+						});
+					}
+					if (stopped) return;
+					const response = await fetch("/dsh-notch/pending-focus", { cache: "no-store" });
+					if (!response.ok) return;
+					const focus = (await response.json()).focus;
+					if (!armed) {
+						armed = true;
+						if (focus && typeof focus.at === "number") lastAt = focus.at;
+						return;
+					}
+					if (!focus || typeof focus.at !== "number" || focus.at <= lastAt) return;
+					if (typeof focus.sessionId !== "string" || focus.sessionId === "") return;
+					lastAt = focus.at;
+					await open(focus.sessionId);
+					try {
+						window.focus();
+					} catch {}
+				} catch {}
+			};
+			const tick = () => {
+				if (stopped) return;
+				poll().finally(() => {
+					if (!stopped) timer = window.setTimeout(tick, POLL_MS);
+				});
+			};
+			let timer = window.setTimeout(tick, POLL_MS);
+			poll();
+			ctx.effect(() => () => {
+				stopped = true;
+				window.clearTimeout(timer);
+			}, "dsh-notch-focus: poll");
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		exports.name = name;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../src/client/index.tsx"],"sourcesContent":["import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client'\nimport type {} from '@deepseek-ai/dsh-client-ui-session/client'\nimport type {} from '@deepseek-ai/dsh-client-ui-workspace/client'\nimport type { SessionId } from '@deepseek-ai/dsh-session/types'\n/**\n * Headless follower: polls the Host for notch focus wishes and selects the\n * session in every open DSH page (app webview or browser tab).\n *\n * First poll only arms (ignores a wish already sitting there) so a reload\n * does not yank the current session. A later click bumps `at` and opens.\n */\nimport type { Context as ClientContext } from '@deepseek-ai/cordis'\n\nexport const name = 'dsh-notch-focus-client'\nexport const inject = ['sessions', 'uiWorkspace', 'uiSession']\n\ninterface PendingFocusWire {\n  ok?: boolean\n  focus?: { sessionId?: string; at?: number } | null\n}\n\nconst POLL_MS = 400\n\nexport function apply(ctx: ClientContext): void {\n  const sessions = ctx.get('sessions') as unknown as ISessions\n  const clientId = crypto.randomUUID()\n  let lastAt = 0\n  let armed = false\n  let stopped = false\n\n  const open = async (sessionId: string): Promise<void> => {\n    try {\n      ctx.uiWorkspace.openSession(sessionId as SessionId)\n      return\n    } catch {\n      /* list may be stale; refresh once and retry */\n    }\n    try {\n      await sessions.refresh()\n      ctx.uiWorkspace.openSession(sessionId as SessionId)\n    } catch {\n      /* session not in this page's list */\n    }\n  }\n\n  const poll = async (): Promise<void> => {\n    try {\n      const snapshot = sessions.list.getSnapshot()\n      if (snapshot.phase === 'ready') {\n        // parentId also records independent user forks; only origin classifies\n        // a delegated child, matching the official workspace sidebar.\n        const rows = snapshot.ids.map(id => snapshot.byId[id]).filter(row => row && row.origin !== 'subagent').map(row => ({ id: row.id, title: row.displayTitle, completed: ctx.uiSession.sessionStatus.getSnapshot().get(row.id)?.completionUnread === true, running: row.running, updatedAt: row.updatedAt }))\n        const focused = document.hasFocus()\n        const current = rows.find(row => row.id === Object.values(snapshot.byId).find(item => (item.retainedBy?.mainView ?? 0) > 0)?.id)\n        // updatedAt is the user's prompt timestamp, not the completion time.\n        // Capture this observation before sending it, so a delayed request\n        // cannot acknowledge a turn that finishes after the user looked.\n        const viewed = focused && current && !current.running\n          ? { id: current.id, at: Date.now() } : undefined\n        await fetch('/dsh-notch/sidebar', { method: 'POST', headers: { 'content-type': 'application/json', 'x-dsh-notch-client': '1' }, body: JSON.stringify({ clientId, projectionVersion: 3, focused, viewed, rows }) })\n      }\n      if (stopped) return\n      const response = await fetch('/dsh-notch/pending-focus', { cache: 'no-store' })\n      if (!response.ok) return\n      const data = (await response.json()) as PendingFocusWire\n      const focus = data.focus\n      if (!armed) {\n        armed = true\n        if (focus && typeof focus.at === 'number') lastAt = focus.at\n        return\n      }\n      if (!focus || typeof focus.at !== 'number' || focus.at <= lastAt) return\n      if (typeof focus.sessionId !== 'string' || focus.sessionId === '') return\n      lastAt = focus.at\n      await open(focus.sessionId)\n      try {\n        window.focus()\n      } catch {\n        /* native helper already fronts DSH.app */\n      }\n    } catch {\n      /* Host unreachable mid-poll; the next tick retries. */\n    }\n  }\n\n  const tick = (): void => {\n    if (stopped) return\n    void poll().finally(() => {\n      if (!stopped) timer = window.setTimeout(tick, POLL_MS)\n    })\n  }\n  let timer = window.setTimeout(tick, POLL_MS)\n  void poll()\n\n  ctx.effect(() => () => {\n    stopped = true\n    window.clearTimeout(timer)\n  }, 'dsh-notch-focus: poll')\n}\n"],"mappings":";;;;;;;EAaA,MAAa,OAAO;EACpB,MAAa,SAAS;GAAC;GAAY;GAAe;EAAW;EAO7D,MAAM,UAAU;EAEhB,SAAgB,MAAM,KAA0B;GAC9C,MAAM,WAAW,IAAI,IAAI,UAAU;GACnC,MAAM,WAAW,OAAO,WAAW;GACnC,IAAI,SAAS;GACb,IAAI,QAAQ;GACZ,IAAI,UAAU;GAEd,MAAM,OAAO,OAAO,cAAqC;IACvD,IAAI;KACF,IAAI,YAAY,YAAY,SAAsB;KAClD;IACF,QAAQ,CAER;IACA,IAAI;KACF,MAAM,SAAS,QAAQ;KACvB,IAAI,YAAY,YAAY,SAAsB;IACpD,QAAQ,CAER;GACF;GAEA,MAAM,OAAO,YAA2B;IACtC,IAAI;KACF,MAAM,WAAW,SAAS,KAAK,YAAY;KAC3C,IAAI,SAAS,UAAU,SAAS;MAG9B,MAAM,OAAO,SAAS,IAAI,KAAI,OAAM,SAAS,KAAK,GAAG,CAAC,CAAC,QAAO,QAAO,OAAO,IAAI,WAAW,UAAU,CAAC,CAAC,KAAI,SAAQ;OAAE,IAAI,IAAI;OAAI,OAAO,IAAI;OAAc,WAAW,IAAI,UAAU,cAAc,YAAY,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,qBAAqB;OAAM,SAAS,IAAI;OAAS,WAAW,IAAI;MAAU,EAAE;MACxS,MAAM,UAAU,SAAS,SAAS;MAClC,MAAM,UAAU,KAAK,MAAK,QAAO,IAAI,OAAO,OAAO,OAAO,SAAS,IAAI,CAAC,CAAC,MAAK,UAAS,KAAK,YAAY,YAAY,KAAK,CAAC,CAAC,EAAE,EAAE;MAI/H,MAAM,SAAS,WAAW,WAAW,CAAC,QAAQ,UAC1C;OAAE,IAAI,QAAQ;OAAI,IAAI,KAAK,IAAI;MAAE,IAAI,KAAA;MACzC,MAAM,MAAM,sBAAsB;OAAE,QAAQ;OAAQ,SAAS;QAAE,gBAAgB;QAAoB,sBAAsB;OAAI;OAAG,MAAM,KAAK,UAAU;QAAE;QAAU,mBAAmB;QAAG;QAAS;QAAQ;OAAK,CAAC;MAAE,CAAC;KACnN;KACA,IAAI,SAAS;KACb,MAAM,WAAW,MAAM,MAAM,4BAA4B,EAAE,OAAO,WAAW,CAAC;KAC9E,IAAI,CAAC,SAAS,IAAI;KAElB,MAAM,SAAQ,MADM,SAAS,KAAK,EAAA,CACf;KACnB,IAAI,CAAC,OAAO;MACV,QAAQ;MACR,IAAI,SAAS,OAAO,MAAM,OAAO,UAAU,SAAS,MAAM;MAC1D;KACF;KACA,IAAI,CAAC,SAAS,OAAO,MAAM,OAAO,YAAY,MAAM,MAAM,QAAQ;KAClE,IAAI,OAAO,MAAM,cAAc,YAAY,MAAM,cAAc,IAAI;KACnE,SAAS,MAAM;KACf,MAAM,KAAK,MAAM,SAAS;KAC1B,IAAI;MACF,OAAO,MAAM;KACf,QAAQ,CAER;IACF,QAAQ,CAER;GACF;GAEA,MAAM,aAAmB;IACvB,IAAI,SAAS;IACb,KAAU,CAAC,CAAC,cAAc;KACxB,IAAI,CAAC,SAAS,QAAQ,OAAO,WAAW,MAAM,OAAO;IACvD,CAAC;GACH;GACA,IAAI,QAAQ,OAAO,WAAW,MAAM,OAAO;GAC3C,KAAU;GAEV,IAAI,mBAAmB;IACrB,UAAU;IACV,OAAO,aAAa,KAAK;GAC3B,GAAG,uBAAuB;EAC5B"}

package/lib/dsh-notch-focus.js

@@ -0,0 +1,8 @@
+//#region lib/types/dsh-notch-focus.js
+const name = "dsh-notch-focus";
+const inject = [];
+function apply(ctx) {
+	console.log("[my-plugins/dsh-notch-focus] loaded");
+}
+//#endregion
+export { apply, inject, name };

package/lib/types/client/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Headless follower: polls the Host for notch focus wishes and selects the
+ * session in every open DSH page (app webview or browser tab).
+ *
+ * First poll only arms (ignores a wish already sitting there) so a reload
+ * does not yank the current session. A later click bumps `at` and opens.
+ */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+export declare const name = "dsh-notch-focus-client";
+export declare const inject: string[];
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/dsh-notch-focus.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "dsh-notch-focus";
+export declare const inject: never[];
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=dsh-notch-focus.d.ts.map

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "dsh-notch-focus",
+  "version": "0.1.2",
+  "description": "Bidirectional session navigation and unread synchronization for DSH Desktop and Web 0.2.0-rc.2.",
+  "type": "module",
+  "main": "lib/dsh-notch-focus.js",
+  "types": "lib/types/dsh-notch-focus.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/types/dsh-notch-focus.d.ts",
+      "default": "./lib/dsh-notch-focus.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-client-ui-workspace",
+        "@deepseek-ai/dsh-client-ui-session"
+      ],
+      "platform": "web"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "files": [
+    "lib/*.js",
+    "lib/*.js.map",
+    "lib/types/**/*.d.ts",
+    "cordis.yml",
+    "README.md",
+    "cordis.patch.yml",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-client-ui-workspace": ">=0.2.0-rc.1 <0.2.1",
+    "@deepseek-ai/dsh-client-ui-session": ">=0.2.0-rc.1 <0.2.1",
+    "@deepseek-ai/dsh-api-session-controller": ">=0.2.0-rc.1 <0.2.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.2.0-rc.2"
+  }
+}