@michengai/dsh-codex-pet 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.1.5] - 2026-09-12
+
+- Keep the pet in a global Web overlay across pages while preserving interaction and letting clicks pass through empty areas.
+- Showing the pet on Codex UI settings pages requires Codex UI 1.1.3 or later. The pet still works independently without Codex UI.
+
+## [0.1.4] - 2026-09-11
+
+- Restore compatibility with DSH `0.1.0-rc.8`, `0.1.1-rc.2`, `0.1.2-rc.1`, and `0.1.5-rc.1` while retaining `0.1.5-rc.2`. Adapt legacy session requests so pet notifications can answer questions and approvals on older hosts.
+
 ## [0.1.3] - 2026-09-11
 
 - Support DSH Web `0.1.5-rc.2` and correct client service injection so the plugin loads with the updated host. Older DSH versions are outside the supported range.

package/CHANGELOG.zh-CN.md

@@ -1,5 +1,14 @@
 # 更新日志
 
+## [0.1.5] - 2026-09-12
+
+- 宠物改为在整个 Web 页面内悬浮，切换页面时保留显示和交互，空白区域不阻挡页面操作。
+- 在 Codex UI 设置页显示宠物需要同时升级 Codex UI 至 1.1.3 或更新版本；未安装 Codex UI 时仍可独立使用。
+
+## [0.1.4] - 2026-09-11
+
+- 恢复 DSH `0.1.0-rc.8`、`0.1.1-rc.2`、`0.1.2-rc.1`、`0.1.5-rc.1` 兼容，同时保留 `0.1.5-rc.2`；适配旧版会话请求，使宠物通知可处理旧宿主的提问和审批。
+
 ## [0.1.3] - 2026-09-11
 
 - 支持 DSH Web `0.1.5-rc.2`，修正客户端服务注入声明，使插件可在新版宿主加载；旧版 DSH 不在支持范围内。

package/README.md

@@ -72,7 +72,7 @@ Add plugins as needed to your existing DeepSeek Harness environment.
 
 ## Installation
 
-DeepSeek Harness **`0.1.5-rc.2`** is supported; older versions are outside the current support range. Make sure the `dsh` command is available. The example uses the `web` profile; replace it with your target profile.
+Supported DeepSeek Harness versions: **`0.1.0-rc.8`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, and `0.1.5-rc.2`**. New compatibility is added without dropping these older releases. Make sure the `dsh` command is available. The example uses the `web` profile; replace it with your target profile.
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -100,7 +100,7 @@ Open **Settings → Pets** (`宠物` in the current UI), or open settings from t
 
 The pet is a notification and action surface. Start new conversations and write follow-up messages in the main DSH interface.
 
-Known upstream limitation: cancelling before the model returns an HTTP response in DSH `0.1.5-rc.2` can report a non-JSON-serializable `turn/end` error, which the pet displays as a failure notification. Cancellation after streaming has started passed end-to-end validation.
+Known issue: in DSH `0.1.5-rc.2`, stopping a task before the model starts responding may cause the pet to show a failure notification.
 
 ### Create a custom pet
 
@@ -126,26 +126,9 @@ dsh plugin --profile web remove @michengai/dsh-codex-pet
 
 Custom pets are stored in `.dsh/codex-pet/pets` under your user directory by default; open the folder from pet settings. If `DSH_HOME` is set, pets are stored in its `codex-pet/pets` folder. Uninstalling keeps those files and settings.
 
-## Development checks
+## Contributing
 
-Development dependencies and the lockfile pin DSH `0.1.5-rc.2`. Use `npm ci` to reproduce the environment; `npm run check` also checks the plugin against official service types.
-
-```powershell
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-$OutputEncoding = [System.Text.Encoding]::UTF8
-npm ci
-npx playwright install chromium
-npm run check
-npm test
-npm run smoke
-npm run test:e2e
-```
-
-End-to-end tests also require pnpm on PATH (CI uses `11.25.0`). They install the local package through the official CLI and boot the full DSH Web app to test pet settings, persistence, session creation, question responses, completion and failure notifications, and cancellation. Only the external model HTTP service is replaced with a local fixture; no paid model or image generation is used. Tests use a separate `DSH_HOME` and keep logs and screenshots in the ignored `.preview/e2e-latest-*` directory without changing your everyday profile.
-
-The official type check verifies structural compatibility, not service lifecycle behavior. E2E runs as a separate CI job with a 25-minute budget; publishing requires a successful main push CI run for the exact tagged commit, including both language jobs. Wait for CI before tagging; missing, running, skipped, or failed checks block publishing. Windows Profile link errors (`EBUSY`) retry after 5 seconds within a shared 120-second startup budget; shutdown may require up to 10 additional seconds. This mitigates transient failures without claiming Windows stability. Other failures remain failures. Reports retain the locale, original failure, retry observations, and separate cleanup errors. PowerShell (`powershell.exe` on Windows, `pwsh` elsewhere) retains the latest five completed, marked runs. Unmarked historical evidence, unfinished runs, and directories containing `.keep` are preserved; pruning never follows directory links. Add `.keep` to release acceptance evidence before subsequent runs.
-
-Set `DSH_PET_E2E_LOCALE` to `zh-CN` (default) or `en-US` to choose the browser language; CI tests both.
+See the [development and validation guide (Chinese)](https://github.com/MichengAI/dsh-codex-pet/blob/main/CONTRIBUTING.md) for local development, testing, and release procedures.
 
 ## License
 

package/README.zh-CN.md

@@ -72,7 +72,7 @@
 
 ## 安装
 
-支持 DeepSeek Harness **`0.1.5-rc.2`**，需要可使用 `dsh` 命令。旧版不在当前支持范围内。以下示例使用 `web` profile，请按实际环境替换。
+支持 DeepSeek Harness **`0.1.0-rc.8`、`0.1.1-rc.2`、`0.1.2-rc.1`、`0.1.5-rc.1`、`0.1.5-rc.2`**，需要可使用 `dsh` 命令。新增兼容不移除这些旧版。以下示例使用 `web` profile，请按实际环境替换。
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
@@ -100,7 +100,7 @@ dsh plugin --profile web add @michengai/dsh-codex-pet@latest --registry=https://
 
 宠物承担通知和待处理操作。新建会话、输入后续消息仍在 DSH 主界面完成。
 
-已知上游边界：DSH `0.1.5-rc.2` 在模型尚未返回 HTTP 响应时停止任务，可能因 `turn/end` 数据不可 JSON 序列化而上报错误，宠物会显示失败通知。已开始流式响应时的停止操作已通过端到端验证。
+已知问题：在 DSH `0.1.5-rc.2` 中，若模型尚未开始响应就停止任务，宠物可能显示失败通知。
 
 ### 创建自定义宠物
 
@@ -126,26 +126,9 @@ dsh plugin --profile web remove @michengai/dsh-codex-pet
 
 自定义宠物默认保存在用户目录的 `.dsh/codex-pet/pets` 下，可从宠物设置打开。设置了 `DSH_HOME` 时使用该目录下的 `codex-pet/pets`。卸载插件会保留这些文件与配置。
 
-## 开发验证
+## 参与开发
 
-开发依赖和锁文件固定 DSH `0.1.5-rc.2`。使用 `npm ci` 复现，`npm run check` 同时检查插件与官方服务类型的兼容性。
-
-```powershell
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-$OutputEncoding = [System.Text.Encoding]::UTF8
-npm ci
-npx playwright install chromium
-npm run check
-npm test
-npm run smoke
-npm run test:e2e
-```
-
-端到端测试另需 PATH 中有 pnpm（CI 使用 `11.25.0`）。它通过官方 CLI 安装本地发行包、启动完整 DSH Web，验证宠物设置、持久化、创建会话、提问回传、完成与失败通知和停止任务。只有外部模型 HTTP 服务使用本地夹具，不调用付费模型或生成图片。测试使用独立 `DSH_HOME`，日志和截图保存在忽略的 `.preview/e2e-latest-*` 下，不改动日常 Profile。
-
-官方类型检查验证结构兼容性，不替代服务生命周期验证。E2E 拆为独立 CI job，限时 25 分钟；发布前必须验证标签提交对应的 main push CI 成功，且中英文 job 均通过；先等待 CI，再打标签，缺失、运行中、跳过或失败的检查都会阻止发布。Windows Profile 链接错误（`EBUSY`）在共享的 120 秒启动预算内每次等待 5 秒后重试，关闭进程最多另需 10 秒；这只缓解瞬时竞争，不代表 Windows 已稳定，其他错误直接失败。报告同时保留语言、原始失败、重试记录及独立清理错误。通过 PowerShell（Windows 使用 `powershell.exe`，其他平台使用 `pwsh`）保留最近 5 次已标记并结束的运行；未标记的历史证据、未结束运行及含 `.keep` 文件的目录不回收，清理不跟随目录链接。发布验收证据应在后续运行前添加 `.keep`。
-
-可设置 `DSH_PET_E2E_LOCALE` 为 `zh-CN`（默认）或 `en-US` 选择浏览器语言，CI 分别验证两种语言。
+本地开发、测试与发布流程见 [开发与验证指南](https://github.com/MichengAI/dsh-codex-pet/blob/main/CONTRIBUTING.md)。
 
 ## 许可证
 

package/lib/client.js

@@ -37,6 +37,140 @@ __export(client_exports, {
 });
 module.exports = __toCommonJS(client_exports);
 
+// src/session-compat.ts
+function compatibleSessions(sessions) {
+  const cache = /* @__PURE__ */ new WeakMap();
+  return {
+    list: sessions.list,
+    open: (id) => sessions.open(id),
+    create: (options) => sessions.create(options),
+    binding(id) {
+      const binding = sessions.binding(id);
+      if (!binding || binding.eventSource) return binding;
+      const cached = cache.get(binding);
+      if (cached) return cached;
+      let lastSeq = -1, initialized = false;
+      let snapshot = { revision: 0, change: { kind: "replace", entries: [] } };
+      const eventSource = {
+        getSnapshot() {
+          const state = binding.session.getSnapshot();
+          if (state.openState === "cold" || state.openState === "loading") initialized = false;
+          const events = [...state.chat?.timeline.turns.values() ?? []].flatMap((turn) => [turn.start, turn.end]).filter((entry) => !!entry).sort((a, b) => a.seq - b.seq);
+          const additions = events.filter((entry) => entry.seq > lastSeq);
+          if (additions.length) {
+            lastSeq = additions.at(-1).seq;
+            snapshot = { revision: snapshot.revision + 1, change: { kind: initialized ? "append" : "replace", entries: additions.map((entry) => ({ type: "event", event: entry })) } };
+          }
+          initialized = state.openState === void 0 || state.openState === "open";
+          return snapshot;
+        },
+        subscribe: (listener) => binding.session.subscribe(listener)
+      };
+      const adapted = { ...binding, eventSource };
+      cache.set(binding, adapted);
+      return adapted;
+    }
+  };
+}
+
+// src/legacy-pending.ts
+function compatiblePending(sessions, resolveModern) {
+  const legacy = legacyPending(sessions);
+  const listeners = /* @__PURE__ */ new Set();
+  let source = legacy;
+  let off;
+  let timer;
+  const notify = () => {
+    for (const listener of listeners) listener();
+  };
+  const sync = () => {
+    const next = resolveModern() ?? legacy;
+    if (next === source && off) return;
+    off?.();
+    source = next;
+    off = listeners.size ? source.subscribe(notify) : void 0;
+    notify();
+  };
+  return {
+    getSnapshot: () => source.getSnapshot(),
+    subscribe(listener) {
+      listeners.add(listener);
+      if (!timer) {
+        sync();
+        timer = setInterval(sync, 250);
+      }
+      return () => {
+        listeners.delete(listener);
+        if (!listeners.size) {
+          clearInterval(timer);
+          timer = void 0;
+          off?.();
+          off = void 0;
+        }
+      };
+    }
+  };
+}
+function legacyPending(sessions) {
+  const listeners = /* @__PURE__ */ new Set();
+  const subscriptions = /* @__PURE__ */ new Map();
+  let snapshot = /* @__PURE__ */ new Map();
+  let offList;
+  const refresh = () => {
+    const list = sessions.list.getSnapshot();
+    for (const [id, item] of subscriptions) if (!list.byId[id] || list.byId[id].origin === "subagent") {
+      item.off();
+      subscriptions.delete(id);
+    }
+    const next = /* @__PURE__ */ new Map();
+    for (const id of list.ids) {
+      if (list.byId[id]?.origin === "subagent") continue;
+      const source = sessions.binding(id)?.session;
+      if (!source) continue;
+      if (listeners.size && subscriptions.get(id)?.source !== source) {
+        subscriptions.get(id)?.off();
+        subscriptions.set(id, { source, off: source.subscribe(refresh) });
+      }
+      const wait = source.getSnapshot().pending?.[0];
+      if (!wait) continue;
+      next.set(id, {
+        kind: wait.kind,
+        key: wait.key,
+        sessionId: wait.sessionId,
+        ...wait.payload,
+        async answer(answer) {
+          if (wait.sessionId !== id || !source.getSnapshot().pending?.includes(wait)) throw new Error("\u8BF7\u6C42\u5DF2\u7ED3\u675F\u6216\u5DF2\u66F4\u6362");
+          const normalized = wait.kind === "question" ? { answers: answer.answers.map(({ custom, ...item }) => ({ ...item, ...custom?.trim() ? { custom: custom.trim() } : {} })) } : answer;
+          const value = wait.kind === "approval" ? { sessionId: id, approvalId: wait.payload.approvalId, outcome: answer } : { sessionId: id, answer: normalized };
+          const receipt = await wait.respond({ ok: true, value });
+          if (!receipt.accepted) throw new Error(receipt.reason ?? "\u5BBF\u4E3B\u62D2\u7EDD\u54CD\u5E94");
+        }
+      });
+    }
+    snapshot = next;
+    for (const listener of listeners) listener();
+  };
+  return {
+    getSnapshot: () => snapshot,
+    subscribe(listener) {
+      listeners.add(listener);
+      if (!offList) {
+        offList = sessions.list.subscribe(refresh);
+        refresh();
+      }
+      return () => {
+        listeners.delete(listener);
+        if (!listeners.size) {
+          offList?.();
+          offList = void 0;
+          for (const item of subscriptions.values()) item.off();
+          subscriptions.clear();
+        }
+      };
+    }
+  };
+}
+
 // src/companion-api.ts
 function createCompanionProvider(handlers) {
   let snapshot = null, active = true, displays = 0, signature = "null";
@@ -203,7 +337,7 @@ function translator(language) {
 }
 
 // src/client.tsx
-var import_react6 = require("react");
+var import_react7 = require("react");
 
 // src/library-store.ts
 function createLibraryStore(request2) {
@@ -759,7 +893,7 @@ function PluginUpdateHeader({ locale }) {
         zh2 ? "\u5BA0\u7269" : "Pets",
         /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { className: "dcp-version", children: [
           "v",
-          "0.1.3"
+          "0.1.5"
         ] })
       ] }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("nav", { className: "dcp-project-links", children: [
@@ -1974,10 +2108,26 @@ function observePetSettingsIcon() {
   return () => observer.disconnect();
 }
 
+// src/global-overlay.tsx
+var import_react6 = require("react");
+var import_react_dom = require("react-dom");
+function GlobalOverlay({ children }) {
+  const [container, setContainer] = (0, import_react6.useState)(null);
+  (0, import_react6.useEffect)(() => {
+    const element = document.createElement("div");
+    element.setAttribute("data-dsh-pet-overlay", "");
+    element.style.cssText = "position:fixed;inset:0;z-index:2147483000;pointer-events:none";
+    document.body.append(element);
+    setContainer(element);
+    return () => element.remove();
+  }, []);
+  return container ? (0, import_react_dom.createPortal)(children, container) : null;
+}
+
 // src/client.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var name = "michengai-codex-pet";
-var inject = ["slots", "sessions", "uiSession", "locale"];
+var inject = ["slots", "sessions", "locale"];
 function openSettings() {
   const trigger = document.querySelector("[data-dcu-settings-trigger]");
   if (trigger)
@@ -1997,23 +2147,23 @@ function Overlay({
 }) {
   const controller = usePetController(locale);
   const t = translator(controller.language);
-  const settingsDialog = (0, import_react6.useRef)(null);
-  (0, import_react6.useEffect)(() => {
+  const settingsDialog = (0, import_react7.useRef)(null);
+  (0, import_react7.useEffect)(() => {
     const show = () => {
       if (!settingsDialog.current?.open) settingsDialog.current?.showModal();
     };
     window.addEventListener("dcp-open-settings", show);
     return () => window.removeEventListener("dcp-open-settings", show);
   }, []);
-  const [state, setState] = (0, import_react6.useState)({
+  const [state, setState] = (0, import_react7.useState)({
     items: [],
     activity: IDLE,
     hidden: 0
   });
-  const notifications = (0, import_react6.useRef)(
+  const notifications = (0, import_react7.useRef)(
     null
   );
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     const engine = createNotifications(sessions, pending, setState);
     notifications.current = engine;
     return () => {
@@ -2021,7 +2171,7 @@ function Overlay({
       engine.dispose();
     };
   }, [sessions, pending]);
-  (0, import_react6.useEffect)(observePetSettingsIcon, []);
+  (0, import_react7.useEffect)(observePetSettingsIcon, []);
   const command = async (value) => {
     const engine = notifications.current;
     if (!engine) throw new Error("\u4F1A\u8BDD\u670D\u52A1\u5C1A\u672A\u5C31\u7EEA");
@@ -2031,17 +2181,17 @@ function Overlay({
     }
     await engine.command(value);
   };
-  const [externalDisplay, setExternalDisplay] = (0, import_react6.useState)(false);
-  const actions = (0, import_react6.useRef)({
+  const [externalDisplay, setExternalDisplay] = (0, import_react7.useState)(false);
+  const actions = (0, import_react7.useRef)({
     command,
     updateConfig: controller.update,
     openSettings
   });
   actions.current = { command, updateConfig: controller.update, openSettings };
-  const provider = (0, import_react6.useRef)(
+  const provider = (0, import_react7.useRef)(
     null
   );
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     const value = createCompanionProvider({
       command: (command2) => actions.current.command(command2),
       updateConfig: (config) => actions.current.updateConfig(config),
@@ -2058,7 +2208,7 @@ function Overlay({
       window.dispatchEvent(new Event("dsh-pet-disposed"));
     };
   }, []);
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     const library = controller.library;
     provider.current?.publish(
       library ? {
@@ -2090,6 +2240,7 @@ function Overlay({
         className: "dcp dcp-dialog",
         "aria-label": t("\u5BA0\u7269\u8BBE\u7F6E"),
         style: {
+          pointerEvents: "auto",
           width: "min(800px, calc(100vw - 32px))",
           maxHeight: "85vh",
           overflow: "auto"
@@ -2150,6 +2301,11 @@ function Page({
   );
 }
 function apply(ctx) {
+  const sessions = compatibleSessions(ctx.sessions);
+  const pending = compatiblePending(sessions, () => {
+    const service = ctx.reflect ? ctx.reflect.get("uiSession") : ctx.uiSession;
+    return service?.pendingInteractions;
+  });
   ctx.slots.inject(
     "settings.section",
     () => ctx.slots.register(
@@ -2159,21 +2315,21 @@ function apply(ctx) {
         label: () => translator(ctx.locale.getSnapshot().active)("\u5BA0\u7269"),
         order: 12
       },
-      () => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Page, { sessions: ctx.sessions, locale: ctx.locale })
+      () => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(Page, { sessions, locale: ctx.locale })
     )
   );
   ctx.slots.inject(
     "shell.overlay",
     () => ctx.slots.register(
       { name: "shell.overlay", id: "michengai-codex-pet", order: 100 },
-      () => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
+      () => /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(GlobalOverlay, { children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         Overlay,
         {
-          sessions: ctx.sessions,
-          pending: ctx.uiSession.pendingInteractions,
+          sessions,
+          pending,
           locale: ctx.locale
         }
-      )
+      ) })
     )
   );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-codex-pet",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "license": "Apache-2.0",
   "description": "独立实现的 DSH 宠物插件：Codex 原始宠物库、Skill 创建、Web 页内显示与消费者接入接口",
   "type": "module",
@@ -43,9 +43,8 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-renderer",
-        "@deepseek-ai/dsh-client-ui-session",
         "@deepseek-ai/dsh-client-locale"
       ]
     }
@@ -60,7 +59,7 @@
     "assets:import": "tsx scripts/import-codex.ts"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-host-webserver": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.8 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },