dsh-zen-remote 1.1.11 → 1.1.13

package/src/client/MobileSessionInfo.tsx

@@ -7,8 +7,9 @@ import {
   IconDownloadOutline16,
   IconEditOutline16,
 } from '@deepseek-ai/dsh-client-ui-primitives'
-import { workspaceTitleOf } from '@deepseek-ai/dsh-client-runtime/client'
-import type { SessionFace, SessionId } from '@deepseek-ai/dsh-client-runtime/client'
+import { workspaceTitleOf } from './compat/store.ts'
+import { agentPresetOf } from './compat/types.ts'
+import type { RenameResult, SessionId } from './compat/types.ts'
 import { NS } from './locales.ts'
 import { GO_HOME_EVENT, SESSION_INFO_EVENT } from './nav-store.ts'
 import { hasLayer, popLayer, pushLayer } from './history-nav.ts'
@@ -36,7 +37,7 @@ export type MobileSessionInfoProps =
     /** Bound ctx.sessions.open(id) — lands on the freshly forked session. */
     openSession: (id: SessionId) => void
     /** Bound ctx.sessions.binding(id)?.session.rename(title); undefined when the binding is gone. */
-    renameSession: (sessionId: SessionId, title: string) => ReturnType<SessionFace['rename']> | undefined
+    renameSession: (sessionId: SessionId, title: string) => RenameResult | undefined
     /** Bound ctx.workspaces.archiveSession(sessionId). */
     archiveSession: (sessionId: SessionId) => Promise<void>
     /** Bound ctx.sessionLogDownload.download(sessionId) — owns its own progress/result modal. */
@@ -198,6 +199,7 @@ export function MobileSessionInfo({
   const cacheHit = usage === undefined ? null : cacheHitPercent(usage)
   const tokensEmpty = usage === undefined || (billedInputTokens(usage) === 0 && usage.outputTokens === 0)
   const cwd = row?.cwd === undefined || row.cwd === '' ? undefined : workspaceTitleOf(row.cwd)
+  const preset = agentPresetOf(row)
 
   const cells: Array<{ label: string; value: string; sub: string | undefined }> = [
     { label: t('infoStatTurns'), value: stats === undefined ? NA : String(stats.turns), sub: undefined },
@@ -279,7 +281,7 @@ export function MobileSessionInfo({
         </div>
 
         <div data-mobile-nav="info-badges">
-          {row?.agentPreset !== undefined && <span data-mobile-nav="info-badge">{row.agentPreset}</span>}
+          {preset !== undefined && <span data-mobile-nav="info-badge">{preset}</span>}
           {subagentCount > 0 && (
             <span data-mobile-nav="info-badge">{t('infoSubagents', { count: subagentCount })}</span>
           )}

package/src/client/chips-store.ts

@@ -1,4 +1,4 @@
-import { createSnapshotStore } from '@deepseek-ai/dsh-client-runtime/client'
+import { createSnapshotStore } from './compat/store.ts'
 import { useSyncExternalStore } from 'react'
 
 /**

package/src/client/compat/store.ts

@@ -0,0 +1,205 @@
+// Compat: self-written store engine + workspace-title helper, replacing the
+// three runtime values this plugin used to import from
+// `@deepseek-ai/dsh-client-runtime/client` (createSnapshotStore in
+// chips-store.ts, defineStore in nav-store.ts, workspaceTitleOf in
+// MobileSessionInfo.tsx). DSH 0.1.2 dropped that package entirely: a browser
+// `require` of it now throws and the plugin would not load at all. The store
+// pair moved to `@deepseek-ai/dsh-client-store` and `workspaceTitleOf`
+// exists nowhere, so instead of try/catching two package names at runtime
+// (and re-coupling to whichever upstream renames next), the functions are
+// written here — they are small, and their contract types come from
+// `@deepseek-ai/dsh-client-ui-slots`, which both DSH versions ship.
+//
+// Both frameworks consume a store handle structurally — they call
+// `handle.create(scopeKey?)` and read `getSnapshot / subscribe / actions /
+// clearPersisted` off the instance, with no `instanceof` and no brand check
+// (0.1.1 dsh-client-runtime/lib/client.js:171,302; 0.1.2
+// dsh-client-ui-renderer/lib/client.js:1341,1350) — so these stand-ins are
+// accepted as-is by the slot engine on either version.
+import type {
+  ActionsDecl,
+  BakedActions,
+  StoreHandle,
+  StoreInstance,
+  StoreSpec,
+} from '@deepseek-ai/dsh-client-ui-slots'
+
+/** Writable snapshot source: read + subscribe + mutate/wholesale-set. */
+export interface SnapshotStore<T> {
+  /** Read the current state. Same reference every time until an update. */
+  getSnapshot(): T
+  /**
+   * Subscribe to state changes.
+   * @param fn - invalidation callback.
+   * @returns unsubscribe function.
+   */
+  subscribe(fn: () => void): () => void
+  /**
+   * Mutate the state through a draft.
+   * @param mutator - draft mutator.
+   */
+  update(mutator: (draft: T) => void): void
+  /** Replace the state wholesale. @param next - next state. */
+  set(next: T): void
+}
+
+/**
+ * Create a snapshot store with optional whole-value localStorage persistence.
+ * The 0.1.1 `opts.flush: 'raf' | 'sync'` mode is deliberately not
+ * implemented: this plugin never used it (chips-store.ts persists
+ * synchronously and React reads via useSyncExternalStore).
+ * @param init - initial state.
+ * @param opts - optional persistence key.
+ * @returns the store.
+ */
+export function createSnapshotStore<T>(
+  init: T,
+  opts?: { persist?: { name: string } },
+): SnapshotStore<T> {
+  let state = init
+  const listeners = new Set<() => void>()
+  const persistName = opts?.persist?.name
+
+  // Rehydrate once at construction: a persisted whole value replaces the
+  // initial state wholesale. Failures (quota, private mode, corrupted JSON)
+  // only log — a broken persisted value must not take the store down, and a
+  // store that cannot persist must still work in memory.
+  if (persistName !== undefined && typeof localStorage !== 'undefined') {
+    try {
+      const raw = localStorage.getItem(persistName)
+      if (raw !== null) state = JSON.parse(raw) as T
+    } catch (error) {
+      console.error(`snapshot store '${persistName}' rehydration failed:`, error)
+    }
+  }
+
+  const persist = (): void => {
+    if (persistName === undefined || typeof localStorage === 'undefined') return
+    try {
+      localStorage.setItem(persistName, JSON.stringify(state))
+    } catch (error) {
+      console.error(`snapshot store '${persistName}' persistence failed:`, error)
+    }
+  }
+
+  const notify = (): void => {
+    // Iterate a snapshot of the set so a callback that unsubscribes cannot
+    // make the loop skip listeners registered after it.
+    for (const fn of [...listeners]) fn()
+  }
+
+  return {
+    getSnapshot: (): T => state,
+    subscribe: (fn: () => void): (() => void) => {
+      listeners.add(fn)
+      return () => {
+        listeners.delete(fn)
+      }
+    },
+    update: (mutator: (draft: T) => void): void => {
+      // ponytail: official uses immer's structural sharing; here we copy one
+      // level shallowly (array spread / object spread) and let the mutator
+      // edit that copy before swapping it in wholesale. That only supports
+      // one-level-deep draft writes — fine while both plugin stores stay
+      // flat ({view, workspace}, Record<string, boolean>); if a state ever
+      // nests, switch this to immer instead of deepening the copy.
+      const draft = (Array.isArray(state) ? [...state] : { ...(state as object) }) as T
+      mutator(draft)
+      state = draft
+      notify()
+      persist()
+    },
+    set: (next: T): void => {
+      state = next
+      notify()
+      persist()
+    },
+  }
+}
+
+/**
+ * A live `create()` product: the ui-slots contract instance plus the raw
+ * snapshot store it was built on. The official engine instance carries the
+ * same `store` member (dsh-client-store's EngineStoreInstance); the
+ * framework-neutral `StoreInstance` contract omits it, so this file widens
+ * the return of {@link defineStore}'s create with a local subtype.
+ */
+interface SnapshotStoreInstance<T, A extends ActionsDecl<T>> extends StoreInstance<T, A> {
+  /** The underlying snapshot store. */
+  readonly store: SnapshotStore<T>
+}
+
+/**
+ * Declare a store: an init lambda (fresh state per instance), an optional
+ * persistence key, and the full write set as pure draft mutators. Returns
+ * the registration currency of the slot system's store seat.
+ *
+ * The `A & ActionsDecl<T>` actions position is load-bearing: T resolves from
+ * `init` in the first inference round, and the intersection then
+ * contextually types each mutator's draft parameter, so call sites write
+ * `(draft, view: MobileView) => { … }` without annotating the draft. Keep
+ * the intersection — dropping it makes nav-store.ts fail to typecheck.
+ *
+ * Persist-key rules mirror the official defineStore: `decl.persist` alone at
+ * root scope, suffixed with `.{scopeKey}` per session scope, none when
+ * `decl.persist` is absent.
+ * @param decl - init/persist/actions declaration.
+ * @returns the store handle.
+ */
+export function defineStore<T, A extends ActionsDecl<T>>(
+  decl: StoreSpec<T, A> & { actions: A & ActionsDecl<T> },
+): StoreHandle<T, A> {
+  return {
+    spec: decl,
+    create(scopeKey?: string): SnapshotStoreInstance<T, A> {
+      const persistKey =
+        decl.persist === undefined
+          ? undefined
+          : scopeKey === undefined
+            ? decl.persist
+            : `${decl.persist}.${scopeKey}`
+      const store = createSnapshotStore<T>(
+        decl.init(),
+        persistKey !== undefined ? { persist: { name: persistKey } } : undefined,
+      )
+      // TS cannot verify an object that is filled key-by-key from
+      // Object.keys(decl.actions) satisfies the BakedActions mapped type, so
+      // the map is built loosely and narrowed once at the contract boundary;
+      // at runtime every declared action key is present (the declaration's
+      // own keys are the ones iterated).
+      const actions = {} as Record<string, (...params: unknown[]) => void>
+      for (const [key, mutate] of Object.entries(decl.actions)) {
+        actions[key] = (...params: unknown[]): void => {
+          store.update((draft) => {
+            mutate(draft, ...params)
+          })
+        }
+      }
+      return {
+        actions: actions as BakedActions<T, A>,
+        getSnapshot: (): T => store.getSnapshot(),
+        subscribe: (fn: () => void): (() => void) => store.subscribe(fn),
+        store,
+        clearPersisted: (): void => {
+          if (persistKey === undefined || typeof localStorage === 'undefined') return
+          try {
+            localStorage.removeItem(persistKey)
+          } catch {
+            // Storage gone or denied: nothing to clean up anyway.
+          }
+        },
+      }
+    },
+  }
+}
+
+/**
+ * Last path segment of a workspace directory, for showing "which workspace
+ * is this session in" on the mobile info card. 0.1.1's one-line
+ * implementation, kept verbatim.
+ * @param cwd - a workspace path (posix or windows separators).
+ * @returns the trailing name, or '' when no non-empty segment exists.
+ */
+export function workspaceTitleOf(cwd: string): string {
+  return cwd.replace(/[/\\]+$/, '').split(/[/\\]/).pop() ?? ''
+}

package/src/client/compat/types.ts

@@ -0,0 +1,115 @@
+// Compat: type re-homing + a structural session-row mirror.
+//
+// Most of src/client used to `import type { … } from
+// '@deepseek-ai/dsh-client-runtime/client'`, a package DSH 0.1.2 removed.
+// Type-only imports vanish at runtime, so each moved type just needs a new
+// home; keeping those homes here concentrates every import-path swap in one
+// file, and a future upstream rename touches only this file again.
+//
+// The one type that cannot be imported from either version is the session
+// row: 0.1.1 declares `SessionSummary` in dsh-client-runtime, 0.1.2 in
+// dsh-api-session-controller, and the two field sets differ (0.1.2 dropped
+// `agentPreset` and `pendingInteraction`). Mirroring the handful of fields
+// this plugin actually reads as a structural type (the same trick
+// dsh-plugin-subscriptions' upstream compat.ts uses for RpcResult) lets rows
+// from both versions assign in, instead of picking one version's type and
+// breaking the other.
+import type { Context } from '@deepseek-ai/cordis'
+// Canonical homes for the two branded ids are the packages' `./types`
+// subpaths. This tsconfig still resolves with node10 `moduleResolution:
+// "node"`, which ignores package.json `exports` — the subpath only resolves
+// because tsconfig.client.json maps it through `paths` to the exact .d.ts
+// files; keep those two entries in sync if either package moves.
+import type { SessionId } from '@deepseek-ai/dsh-session/types'
+import type { WorkspaceId } from '@deepseek-ai/dsh-workspace/types'
+
+/**
+ * Browser-half cordis context. 0.1.1's `dsh-client-runtime` exported
+ * `ClientContext` as the bare `Context` type (lib/types/client/index.d.ts:55);
+ * 0.1.2 has no such alias. Re-declared here under the same name so the
+ * dozen files that used it only change their import path, not the
+ * identifier.
+ */
+export type ClientContext = Context
+
+/** Session id. Both versions ship it in `@deepseek-ai/dsh-session/types`; re-exported to collect import points. */
+export type { SessionId }
+
+/** Workspace id. 0.1.2 lives in `@deepseek-ai/dsh-workspace/types`. */
+export type { WorkspaceId }
+
+/**
+ * Structural mirror of the session-row fields this plugin reads, valid
+ * against both versions' `SessionSummary`. Deliberately NOT imported from
+ * either version (see the file header): `projectionValues` stays `unknown`
+ * rather than copying the host's
+ * `Readonly<Partial<SessionProjectionMap>>` — that type differs between
+ * versions and fights assignments under `exactOptionalPropertyTypes`. The
+ * single read site (MobileHome.tsx:311) already casts.
+ *
+ * `agentPreset` and `pendingInteraction` are intentionally absent: their
+ * real readers (MobileHome.tsx, MobileSessionInfo.tsx) receive rows typed by
+ * the host's devDeps (0.1.2), not by this mirror, so fields here would not
+ * help them — use {@link agentPresetOf} / {@link hasPendingInteraction}
+ * instead.
+ */
+export interface MobileSessionRow {
+  id: SessionId
+  title?: string
+  displayTitle: string
+  cwd?: string
+  parentId?: SessionId
+  origin?: 'subagent'
+  running: boolean
+  completed?: boolean
+  blank: boolean
+  updatedAt: number
+  /** 宿主投影值；本插件只读 sessionStats.turns，读的地方自己 cast。 */
+  projectionValues?: unknown
+}
+
+/**
+ * 0.1.1's session row carries `agentPreset`; 0.1.2 dropped it. Reading it
+ * must not depend on which version's types are in scope in the current
+ * file, so narrow through unknown.
+ * @param row - a session row of either version.
+ * @returns the agent preset name, or undefined when absent.
+ */
+export function agentPresetOf(row: unknown): string | undefined {
+  const agentPreset = (row as { agentPreset?: unknown } | null | undefined)?.agentPreset
+  return typeof agentPreset === 'string' ? agentPreset : undefined
+}
+
+/**
+ * 0.1.1's session row carries `pendingInteraction` (the pending-interaction
+ * state behind the sidebar's yellow dot); 0.1.2 serves it from the
+ * uiSession service instead. This answers only "does this row carry a
+ * pending interaction".
+ * @param row - a session row of either version.
+ * @returns true when the row has a pending interaction.
+ */
+export function hasPendingInteraction(row: unknown): boolean {
+  const pending = (row as { pendingInteraction?: unknown } | null | undefined)?.pendingInteraction
+  return pending !== undefined && pending !== null
+}
+
+/**
+ * `ctx.sessions.binding(id)?.session.rename(title)` 的返回值。
+ * 两版的包裹类型不同（0.1.1 是 RpcResult、0.1.2 是 RemoteResult），但判别式
+ * 联合的形状一致：成功分支带 ok:true（还有个我们不读的 value），失败分支带
+ * ok:false + error。这里只镜像本插件真正读到的两个字段（ok、error.message），
+ * 两版的真类型都能结构赋值进来。
+ */
+export type RenameResult = Promise<
+  | { readonly ok: true }
+  | { readonly ok: false; readonly error: { readonly message: string } }
+>
+
+/**
+ * 待处理交互的选择器 hook（0.1.2 的标准 prop `useSessionPendingInteraction`）；
+ * 0.1.1 没有这个 prop，运行时读到 undefined。本地镜像只描述本插件读到的形状
+ * （按会话 id 的只读 Map + 选择器调用），不从
+ * `@deepseek-ai/dsh-client-ui-session/client` 拿类型——那个包 0.1.1 装不到。
+ */
+export type UsePendingInteractions =
+  <S>(sel: (m: ReadonlyMap<SessionId, unknown>) => S, eq?: (a: S, b: S) => boolean) => S

package/src/client/debug.ts

@@ -1,4 +1,4 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from './compat/types.ts'
 /**
  * Debug badge — ?mobile-nav-debug=1
  * Renders a live state overlay (URL, viewport, media queries, shell chrome,

package/src/client/effects/aionui-compat.ts

@@ -1,4 +1,4 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 
 /** dsh-web-ui 兼容：explorer / preview 列的显隐标记与升起动画（同域同机制，合并一处）。 */
 export function installAionuiCompat(ctx: ClientContext): void {

package/src/client/effects/gestures.ts

@@ -1,4 +1,4 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 import { GO_HOME_EVENT } from '../nav-store.ts'
 
 /** Phone breakpoint — same query every phone-only effect in this plugin uses. */

package/src/client/effects/header-status.ts

@@ -1,4 +1,4 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 import { dotState } from '../session-dot.ts'
 
 /**
@@ -20,11 +20,30 @@ export function installHeaderStatusDot(ctx: ClientContext): void {
       if (frame === null) return
       const { current, byId } = ctx.sessions.list.getSnapshot()
       const row = current === undefined ? undefined : byId[current]
-      const state = row === undefined ? undefined : dotState(row)
+      // 0.1.2 的待处理交互来源，每次现查：本插件的 inject 不含 uiSession（加了
+      // 0.1.1 就不激活），apply 此刻服务未必注册好；每次算 dot 时现查，注册顺序
+      // 就不再是问题。0.1.1 上没有这个服务，这里恒 undefined，黄点只由行字段决定。
+      const uiSession = ctx.get('uiSession')
+      const pending = current === undefined ? false
+        : uiSession?.pendingInteractions.getSnapshot().has(current) === true
+      const state = row === undefined ? undefined : dotState(row, pending)
       if (state === undefined) frame.removeAttribute('data-mobile-nav-dot')
       else frame.setAttribute('data-mobile-nav-dot', state)
     }
     apply()
-    return ctx.sessions.list.subscribe(apply)
+    // Two sources can push the dot now (session list + the 0.1.2 pending
+    // map); probe uiSession once more right here and subscribe to whichever
+    // exist. 0.1.1 only ever has the first. Degradation note: if uiSession
+    // has not registered by this moment (this plugin ran before it), only
+    // the list subscription is attached — the dot stays correct because
+    // every later list change re-runs apply(), whose fresh probe then sees
+    // the service; a pending-only change before any list change would be
+    // missed until then.
+    const unsubscribes: Array<() => void> = [ctx.sessions.list.subscribe(apply)]
+    const pendingSource = ctx.get('uiSession')?.pendingInteractions
+    if (pendingSource !== undefined) unsubscribes.push(pendingSource.subscribe(apply))
+    return () => {
+      for (const off of unsubscribes) off()
+    }
   }, 'dsh-mobile-nav: header status dot')
 }

package/src/client/effects/keyboard-avoid.ts

@@ -1,4 +1,4 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 import { clientConfig, KEYBOARD_DEFAULTS, type KeyboardTuning } from '../client-config.ts'
 
 /** Phone breakpoint — same query every phone-only effect in this plugin uses. */

package/src/client/effects/keyboard-guard.ts

@@ -1,4 +1,4 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 
 /** Phone breakpoint — same query every phone-only effect in this plugin uses. */
 const PHONE_QUERY = '(max-width: 767px)'

package/src/client/effects/modal-back.ts

@@ -18,7 +18,7 @@
  * dialogs keep their own behaviour untouched (the repo's desktop no-op rule).
  */
 
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 import { hasLayer, popLayer, pushLayer } from '../history-nav.ts'
 
 const PHONE = '(max-width: 767px)'

package/src/client/effects/model-sheet-extras.ts

@@ -0,0 +1,159 @@
+import type { ClientContext } from '../compat/types.ts'
+
+/** Phone breakpoint — same query every phone-only effect in this plugin uses. */
+const PHONE_QUERY = '(max-width: 767px)'
+
+/** The model pill itself. Absent in a subagent session — see `sync`. */
+const MODEL_SEAT_SELECTOR = '[data-slot="conversation.input.model"]'
+
+/** The model pill's own popup, which section 4 of composer.css.ts turns into a bottom sheet. */
+const MENU_SELECTOR = '[data-slot="conversation.input.model"] [class$="_menu"]'
+
+/**
+ * The third-party composer controls this effect relocates. Both register into
+ * `conversation.input.right`; moving the slot container rather than its
+ * children keeps them together and leaves exactly one node to put back.
+ */
+const EXTRAS_SELECTOR = '[data-slot="conversation.input.right"]'
+
+/**
+ * dsh-vision-router's own mount marker. Used here only to answer "is there
+ * anything in this slot BESIDES the vision toggle" — see `worthMoving`.
+ */
+const VISION_SELECTOR = '[data-vision-router-mode-toggle]'
+
+/**
+ * Set on the container while this effect manages it, in the row and in the
+ * sheet alike. It is the styling hook for both halves in composer.css.ts, and
+ * it is deliberately what the row's `display: none` keys off: without the
+ * marker the controls stay exactly where the host put them, so a version of
+ * this file that declines to act — or never runs at all — cannot leave them
+ * hidden in the row and absent from the sheet, i.e. unreachable.
+ */
+const MANAGED = 'data-zen-sheet-extras'
+
+/**
+ * Is the slot holding anything that actually costs the row width?
+ *
+ * The row is one nowrap flex line whose only elastic item is the model pill
+ * (composer.css.ts section 1), so entries here are paid for out of the model
+ * name. But that is only a problem once something WIDE lands in the slot —
+ * today dsh-plugin-subscriptions' speed chip, which renders "速度 · 标准" and
+ * eats ~70px. dsh-vision-router's toggle alone is a 28px icon that the row
+ * accommodates fine, and moving it on its own would cost a tap (it becomes
+ * two: open the sheet, then toggle) to buy width nobody needed.
+ *
+ * So: relocate only when the slot holds an entry that is not the vision
+ * toggle. With no such entry — subscriptions not installed, or installed but
+ * not contributing on this model — nothing moves and the row keeps its one
+ * icon, which is the behaviour asked for (user review, 2026-09-06).
+ *
+ * Why this rather than sniffing for subscriptions by name: the slot system
+ * adds no per-registration marker (measured — entries render straight into the
+ * container) and subscriptions marks nothing of its own, so naming it would
+ * mean adding a marker to our fork of that plugin and anchoring on it. That
+ * marker dies the day the fork is dropped, and the feature would go quiet
+ * with nothing to catch it. The width question is the real question anyway,
+ * and this asks it directly.
+ */
+function worthMoving(extras: Element): boolean {
+  return [...extras.children].some(child => !child.matches(VISION_SELECTOR))
+}
+
+/**
+ * Phone: park the composer row's third-party controls inside the model sheet.
+ *
+ * With the speed chip and the vision toggle both present on a GPT model the
+ * row runs out of width. Both are model-scoped settings, so the model sheet —
+ * which already holds 模型 and 推理等级 — is where they belong (user request,
+ * 2026-09-06).
+ *
+ * Why move the real controls instead of drawing our own rows that drive them:
+ * the same reason native-trigger-overlay.ts moves the real trigger. A stand-in
+ * has to script the original, which is a road this plugin does not go down —
+ * beyond the trusted-input wall that effect documents, our own rows would have
+ * to mirror every piece of state (speed tier, disabled, aria-pressed, whether
+ * a vision twin exists for the current model) and would rot on the next
+ * upstream restyle. Moving the node keeps one source of truth: their React
+ * roots go on owning and updating these elements, we only change where they
+ * hang.
+ *
+ * Measured 2026-09-06 (DSH 0.1.2, 390px) before writing this — the two things
+ * that would have killed the approach both hold: a relocated control survives
+ * host re-renders (typing into the composer re-renders the row and does not
+ * yank it back) and stays hit-testable at its new position.
+ *
+ * Restoring on close is not cosmetic. The sheet unmounts when it closes and
+ * anything still inside goes with it, so the controls would vanish from the
+ * page while their React roots kept updating detached nodes. The observer
+ * therefore watches the menu leaving too, and the parked node is held as a
+ * reference rather than looked up — once the menu is detached a document
+ * query can no longer find it.
+ */
+export function installModelSheetExtras(ctx: ClientContext): void {
+  ctx.effect(() => {
+    const phone = window.matchMedia(PHONE_QUERY)
+    /** The container while parked in the sheet, plus where to put it back. */
+    let parked: { node: Element, parent: Element, next: Node | null } | null = null
+
+    const park = (node: Element, menu: Element): void => {
+      if (parked !== null || node.parentElement === null) return
+      parked = { node, parent: node.parentElement, next: node.nextSibling }
+      menu.appendChild(node)
+    }
+
+    const unpark = (): void => {
+      if (parked === null) return
+      const { node, parent, next } = parked
+      parked = null
+      // The menu may already be detached, having taken the container with it.
+      // The node itself is still live either way; re-home it only if its old
+      // parent is still on the page (when the whole composer went away, the
+      // owning React roots rebuild the slot on the next mount).
+      if (parent.isConnected) parent.insertBefore(node, next)
+    }
+
+    /** Hand the container back to the host, marker and all. */
+    const release = (node: Element | null): void => {
+      unpark()
+      node?.removeAttribute(MANAGED)
+    }
+
+    const sync = (): void => {
+      const extras = document.querySelector(EXTRAS_SELECTOR)
+      if (extras === null) { unpark(); return }
+      // No model pill, no sheet to park into — a subagent session has none.
+      // Claiming the slot there would hide the controls from the row with
+      // nowhere to show them instead, which is the unreachable state the
+      // marker is meant to prevent.
+      const seat = document.querySelector(MODEL_SEAT_SELECTOR)
+      if (!phone.matches || seat === null || !worthMoving(extras)) { release(extras); return }
+      extras.setAttribute(MANAGED, '')
+      const menu = document.querySelector(MENU_SELECTOR)
+      if (menu === null) unpark()
+      else park(extras, menu)
+    }
+
+    // Synchronous in the observer callback, never behind rAF: the callback is
+    // a microtask and runs before this frame paints, so the controls are in
+    // the sheet the first time it is drawn. A rAF would land a frame late and
+    // show one frame of the sheet without them (AGENTS.md's "晚一帧" rule).
+    // Body-level childList is the same shape modal-back.ts uses; aria-expanded
+    // is watched too so a close that reuses the node still re-syncs.
+    const observer = new MutationObserver(sync)
+    observer.observe(document.body, {
+      childList: true,
+      subtree: true,
+      attributes: true,
+      attributeFilter: ['aria-expanded'],
+    })
+    phone.addEventListener('change', sync)
+    sync()
+
+    return () => {
+      observer.disconnect()
+      phone.removeEventListener('change', sync)
+      release(document.querySelector(EXTRAS_SELECTOR))
+    }
+  }, 'dsh-mobile-nav: model sheet extras')
+}

package/src/client/effects/native-trigger-overlay.ts

@@ -21,7 +21,7 @@
  * tap can only ever reach the real thing — no double handling.
  */
 
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 
 const PHONE = '(max-width: 767px)'
 const HEADER = '[data-phase] header'

package/src/client/effects/phone-chrome.ts

@@ -1,4 +1,4 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 
 /**
  * Phone chrome: KEEP the system status bar (no fullscreen) and make it

package/src/client/effects/turn-fold.ts

@@ -1,4 +1,4 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 import { clientConfig } from '../client-config.ts'
 import { NS } from '../locales.ts'
 

package/src/client/effects/welcome-notice.ts

@@ -1,4 +1,4 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 
 /** Per-browser opt-out flag; localStorage because remote (non-loopback)
     connections never persist the acknowledgement host-side. */

package/src/client/effects/workbench-ref-close.ts

@@ -1,4 +1,4 @@
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ClientContext } from '../compat/types.ts'
 
 /** Phone breakpoint — same query every phone-only effect in this plugin uses. */
 const PHONE_QUERY = '(max-width: 767px)'