dsh-manage-session 2.0.3 → 2.0.4

package/src/client/card.tsx

@@ -1,154 +1,154 @@
-/**
- * 设置卡（插件配置行）：一个可折叠抽屉 —— 会话历史文件 / 健康检查。
- *
- * **chrome 必须自己渲染**：宿主不为贡献卡提供任何外壳，标题、说明、
- * 展开/收起全归插件自己所有。早期版本只渲染裸行，与同分区其它插件
- * 的抽屉形态不一致，还让 `card.title` / `card.desc` 成为死文案。
- *
- * 读写走 configForms（`configForms.get(STEWARD_ENTRY_ID)`，以本插件 entry 为键；
- * 旧宿主回退 settingsScope 绑定）的显式 `set`。0.1.7 起本卡挂在插件族共用
- * 设置节（`dsh-family.tab`，dsh-thinking-levels 顶级「起子插件设置」节声明）里，
- * 与同节其它抽屉一样默认展开。
- */
-import { createElement, useState, useSyncExternalStore, type JSX } from 'react'
-import { DEFAULT_CONFIG, type StewardConfig } from '../config.ts'
-import { translate, type LocaleKey } from './locales.ts'
-
-/** 卡片字典面。 */
-export type CardTranslate = (key: LocaleKey, params?: Record<string, unknown>) => string
-
-/** 设置 scope 面（结构化镜像，与 toggle 的 SwitchCardScope 同形状）。 */
-export interface StewardCardScope {
-  getSnapshot(): {
-    status: 'ready' | 'loading' | 'unavailable'
-    value: StewardConfig | undefined
-    revision?: number
-    writable: boolean
-  }
-  subscribe(listener: () => void): () => void
-  set(field: string, value: unknown): Promise<void>
-}
-
-/** 卡片入参。 */
-export interface StewardCardProps {
-  t?: CardTranslate
-  scope: StewardCardScope
-}
-
-/** 一行设置项。 */
-function Row(props: { title: string; desc?: string; control: JSX.Element }): JSX.Element {
-  return createElement('div', { className: 'dms_setRow' }, [
-    createElement('div', { key: 'text', className: 'dms_setText' }, [
-      createElement('span', { key: 't', className: 'dms_setTitle' }, props.title),
-      props.desc !== undefined && createElement('span', { key: 'd', className: 'dms_setDesc' }, props.desc),
-    ]),
-    createElement('div', { key: 'ctl' }, props.control),
-  ])
-}
-
-/** 一个布尔开关（原生 checkbox 语义，样式由本插件 CSS 提供）。 */
-function Toggle(props: { checked: boolean; disabled?: boolean; onChange: (checked: boolean) => void }): JSX.Element {
-  return createElement('label', { className: `dms_toggle${props.checked ? ' dms_toggleOn' : ''}` }, [
-    createElement('input', {
-      key: 'i',
-      type: 'checkbox',
-      checked: props.checked,
-      disabled: props.disabled === true,
-      onChange: (event: { target: { checked: boolean } }) => { props.onChange(event.target.checked) },
-    }),
-    createElement('span', { key: 's', className: 'dms_toggleTrack' }, createElement('span', { className: 'dms_toggleKnob' })),
-  ])
-}
-
-/** 抽屉头：标题 + 说明 + chevron，整块可点。 */
-function Header(props: { t?: CardTranslate; open: boolean; onToggle: () => void }): JSX.Element {
-  return createElement('button', {
-    key: 'head',
-    type: 'button',
-    className: 'dms_setHead',
-    'aria-expanded': props.open,
-    onClick: props.onToggle,
-  }, [
-    createElement('span', { key: 'text', className: 'dms_setHeadText' }, [
-      createElement('span', { key: 't', className: 'dms_setCardTitle' }, translate(props.t, 'card.title')),
-      createElement('span', { key: 'd', className: 'dms_setCardDesc' }, translate(props.t, 'card.desc')),
-    ]),
-    createElement('svg', {
-      key: 'chev',
-      className: 'dms_setChev',
-      width: 16,
-      height: 16,
-      viewBox: '0 0 16 16',
-      'aria-hidden': true,
-    }, createElement('path', {
-      d: 'M4 6l4 4 4-4',
-      fill: 'none',
-      stroke: 'currentColor',
-      strokeWidth: 1.5,
-      strokeLinecap: 'round',
-      strokeLinejoin: 'round',
-    })),
-  ])
-}
-
-/** 插件设置卡主体（抽屉）。默认展开，family 设置节内直接呈现完整面板。 */
-export function StewardSettingsCard({ t, scope }: StewardCardProps): JSX.Element {
-  const snapshot = useSyncExternalStore(
-    (listener) => scope.subscribe(listener),
-    () => scope.getSnapshot(),
-  )
-  const [open, setOpen] = useState(true)
-  const value: Partial<StewardConfig> = snapshot.value ?? {}
-  const writable = snapshot.writable
-
-  const rows: JSX.Element[] = []
-  if (snapshot.status === 'unavailable') {
-    // 拿不到设置服务：抽屉仍要在（否则这个插件在分区里彻底消失），只是里面说明原因。
-    rows.push(createElement('div', { key: 'unavailable', className: 'dms_setDesc' }, translate(t, 'card.unavailable')))
-  } else {
-    rows.push(
-      createElement(Row, {
-        key: 'enabled',
-        title: translate(t, 'card.enabled'),
-        desc: translate(t, 'card.enabled.desc'),
-        control: createElement(Toggle, {
-          checked: value.enabled ?? DEFAULT_CONFIG.enabled,
-          disabled: !writable,
-          onChange: (checked) => { void scope.set('enabled', checked) },
-        }),
-      }),
-      // 2026-10-20 养老院页签退场：historyFiles 开关不再暴露（配置字段保留，
-      // 宿主侧历史文件能力/路由不动）。
-      createElement(Row, {
-        key: 'health',
-        title: translate(t, 'card.health'),
-        desc: translate(t, 'card.health.desc'),
-        control: createElement(Toggle, {
-          checked: value.healthCheck ?? DEFAULT_CONFIG.healthCheck,
-          disabled: !writable,
-          onChange: (checked) => { void scope.set('healthCheck', checked) },
-        }),
-      }),
-      // 直接删除入口（功能①，2026-10-20 用户定标）：缺省关——破坏性入口
-      // 不默认铺开；开启后搜索面板行内出删除按钮（同款两步确认）。
-      createElement(Row, {
-        key: 'directDelete',
-        title: translate(t, 'card.directDelete'),
-        desc: translate(t, 'card.directDelete.desc'),
-        control: createElement(Toggle, {
-          checked: value.directDelete ?? DEFAULT_CONFIG.directDelete,
-          disabled: !writable,
-          onChange: (checked) => { void scope.set('directDelete', checked) },
-        }),
-      }),
-    )
-    if (!writable) rows.push(createElement('div', { key: 'ro', className: 'dms_setDesc' }, translate(t, 'card.readonly')))
-  }
-
-  return createElement('div', {
-    className: `dms_setCard${open ? ' dms_setCardOpen' : ''}`,
-  }, [
-    createElement(Header, { key: 'head', t, open, onToggle: () => { setOpen(current => !current) } }),
-    open && createElement('div', { key: 'body', className: 'dms_setBody' }, rows),
-  ])
-}
+/**
+ * 设置卡（插件配置行）：一个可折叠抽屉 —— 会话历史文件 / 健康检查。
+ *
+ * **chrome 必须自己渲染**：宿主不为贡献卡提供任何外壳，标题、说明、
+ * 展开/收起全归插件自己所有。早期版本只渲染裸行，与同分区其它插件
+ * 的抽屉形态不一致，还让 `card.title` / `card.desc` 成为死文案。
+ *
+ * 读写走 configForms（`configForms.get(STEWARD_ENTRY_ID)`，以本插件 entry 为键；
+ * 旧宿主回退 settingsScope 绑定）的显式 `set`。0.1.7 起本卡挂在插件族共用
+ * 设置节（`dsh-family.tab`，dsh-thinking-levels 顶级「起子插件设置」节声明）里，
+ * 与同节其它抽屉一样默认展开。
+ */
+import { createElement, useState, useSyncExternalStore, type JSX } from 'react'
+import { DEFAULT_CONFIG, type StewardConfig } from '../config.ts'
+import { translate, type LocaleKey } from './locales.ts'
+
+/** 卡片字典面。 */
+export type CardTranslate = (key: LocaleKey, params?: Record<string, unknown>) => string
+
+/** 设置 scope 面（结构化镜像，与 toggle 的 SwitchCardScope 同形状）。 */
+export interface StewardCardScope {
+  getSnapshot(): {
+    status: 'ready' | 'loading' | 'unavailable'
+    value: StewardConfig | undefined
+    revision?: number
+    writable: boolean
+  }
+  subscribe(listener: () => void): () => void
+  set(field: string, value: unknown): Promise<void>
+}
+
+/** 卡片入参。 */
+export interface StewardCardProps {
+  t?: CardTranslate
+  scope: StewardCardScope
+}
+
+/** 一行设置项。 */
+function Row(props: { title: string; desc?: string; control: JSX.Element }): JSX.Element {
+  return createElement('div', { className: 'dms_setRow' }, [
+    createElement('div', { key: 'text', className: 'dms_setText' }, [
+      createElement('span', { key: 't', className: 'dms_setTitle' }, props.title),
+      props.desc !== undefined && createElement('span', { key: 'd', className: 'dms_setDesc' }, props.desc),
+    ]),
+    createElement('div', { key: 'ctl' }, props.control),
+  ])
+}
+
+/** 一个布尔开关（原生 checkbox 语义，样式由本插件 CSS 提供）。 */
+function Toggle(props: { checked: boolean; disabled?: boolean; onChange: (checked: boolean) => void }): JSX.Element {
+  return createElement('label', { className: `dms_toggle${props.checked ? ' dms_toggleOn' : ''}` }, [
+    createElement('input', {
+      key: 'i',
+      type: 'checkbox',
+      checked: props.checked,
+      disabled: props.disabled === true,
+      onChange: (event: { target: { checked: boolean } }) => { props.onChange(event.target.checked) },
+    }),
+    createElement('span', { key: 's', className: 'dms_toggleTrack' }, createElement('span', { className: 'dms_toggleKnob' })),
+  ])
+}
+
+/** 抽屉头：标题 + 说明 + chevron，整块可点。 */
+function Header(props: { t?: CardTranslate; open: boolean; onToggle: () => void }): JSX.Element {
+  return createElement('button', {
+    key: 'head',
+    type: 'button',
+    className: 'dms_setHead',
+    'aria-expanded': props.open,
+    onClick: props.onToggle,
+  }, [
+    createElement('span', { key: 'text', className: 'dms_setHeadText' }, [
+      createElement('span', { key: 't', className: 'dms_setCardTitle' }, translate(props.t, 'card.title')),
+      createElement('span', { key: 'd', className: 'dms_setCardDesc' }, translate(props.t, 'card.desc')),
+    ]),
+    createElement('svg', {
+      key: 'chev',
+      className: 'dms_setChev',
+      width: 16,
+      height: 16,
+      viewBox: '0 0 16 16',
+      'aria-hidden': true,
+    }, createElement('path', {
+      d: 'M4 6l4 4 4-4',
+      fill: 'none',
+      stroke: 'currentColor',
+      strokeWidth: 1.5,
+      strokeLinecap: 'round',
+      strokeLinejoin: 'round',
+    })),
+  ])
+}
+
+/** 插件设置卡主体（抽屉）。默认展开，family 设置节内直接呈现完整面板。 */
+export function StewardSettingsCard({ t, scope }: StewardCardProps): JSX.Element {
+  const snapshot = useSyncExternalStore(
+    (listener) => scope.subscribe(listener),
+    () => scope.getSnapshot(),
+  )
+  const [open, setOpen] = useState(true)
+  const value: Partial<StewardConfig> = snapshot.value ?? {}
+  const writable = snapshot.writable
+
+  const rows: JSX.Element[] = []
+  if (snapshot.status === 'unavailable') {
+    // 拿不到设置服务：抽屉仍要在（否则这个插件在分区里彻底消失），只是里面说明原因。
+    rows.push(createElement('div', { key: 'unavailable', className: 'dms_setDesc' }, translate(t, 'card.unavailable')))
+  } else {
+    rows.push(
+      createElement(Row, {
+        key: 'enabled',
+        title: translate(t, 'card.enabled'),
+        desc: translate(t, 'card.enabled.desc'),
+        control: createElement(Toggle, {
+          checked: value.enabled ?? DEFAULT_CONFIG.enabled,
+          disabled: !writable,
+          onChange: (checked) => { void scope.set('enabled', checked) },
+        }),
+      }),
+      // 2026-10-20 养老院页签退场：historyFiles 开关不再暴露（配置字段保留，
+      // 宿主侧历史文件能力/路由不动）。
+      createElement(Row, {
+        key: 'health',
+        title: translate(t, 'card.health'),
+        desc: translate(t, 'card.health.desc'),
+        control: createElement(Toggle, {
+          checked: value.healthCheck ?? DEFAULT_CONFIG.healthCheck,
+          disabled: !writable,
+          onChange: (checked) => { void scope.set('healthCheck', checked) },
+        }),
+      }),
+      // 直接删除入口（功能①，2026-10-20 用户定标）：缺省关——破坏性入口
+      // 不默认铺开；开启后搜索面板行内出删除按钮（同款两步确认）。
+      createElement(Row, {
+        key: 'directDelete',
+        title: translate(t, 'card.directDelete'),
+        desc: translate(t, 'card.directDelete.desc'),
+        control: createElement(Toggle, {
+          checked: value.directDelete ?? DEFAULT_CONFIG.directDelete,
+          disabled: !writable,
+          onChange: (checked) => { void scope.set('directDelete', checked) },
+        }),
+      }),
+    )
+    if (!writable) rows.push(createElement('div', { key: 'ro', className: 'dms_setDesc' }, translate(t, 'card.readonly')))
+  }
+
+  return createElement('div', {
+    className: `dms_setCard${open ? ' dms_setCardOpen' : ''}`,
+  }, [
+    createElement(Header, { key: 'head', t, open, onToggle: () => { setOpen(current => !current) } }),
+    open && createElement('div', { key: 'body', className: 'dms_setBody' }, rows),
+  ])
+}

package/src/client/host-api.ts

@@ -188,13 +188,13 @@ export interface SourceMigrateResponse {
  * 兼容别名：合并包时代的 `callSteward` 与 `callHostAny` 同实现（同一 fenced
  * 路由、同一返回形状），保留调用面不迁移。
  */
-export const callSteward = callHostAny
-
-/** POST 到 items 形状的 fenced 方法（管理台语料 session-catalog 用）。 */
-export async function callStewardItems<T>(method: string, body: unknown): Promise<{ ok: boolean; items: T[]; error?: string }> {
-  const res = await callHostAny<{ items?: T[] }>(method, body)
-  if (res.ok === true && Array.isArray(res.items)) return { ok: true, items: res.items }
-  return { ok: false, items: [], error: res.error ?? '请求失败' }
+export const callSteward = callHostAny
+
+/** POST 到 items 形状的 fenced 方法（管理台语料 session-catalog 用）。 */
+export async function callStewardItems<T>(method: string, body: unknown): Promise<{ ok: boolean; items: T[]; error?: string }> {
+  const res = await callHostAny<{ items?: T[] }>(method, body)
+  if (res.ok === true && Array.isArray(res.items)) return { ok: true, items: res.items }
+  return { ok: false, items: [], error: res.error ?? '请求失败' }
 }
 
 /** 状态响应。 */
@@ -205,57 +205,57 @@ export interface HealthStatusResponse {
   healthMethods?: string[]
   home?: string
   error?: string
-}
-
-/** One session listed by `session-catalog` (active + archived in one table). */
-export interface HostSessionItem {
-  sessionId: string
-  title: string
-  cwd: string
-  updatedAt: number
-  /** 归档标记（合表语义）：缺省字段按「活跃」对待。 */
-  archived?: boolean
-}
-
-/**
- * 直接删除入口开关（`manage-session.directDelete`，缺省关）。
- * 由 `session-health-status` 的 switches 面读取；旧宿主半无该字段 → false
- * （破坏性入口不出现是安全方向）。
- */
-export async function probeDirectDelete(): Promise<boolean> {
-  const res = await callHostAny<HealthStatusResponse>('session-health-status', {})
-  return res.ok === true && res.switches?.directDelete === true
-}
-
-/**
- * The client sessions service face. Host lines before 0.1.7 exposed session
- * navigation here as `open`; the 0.1.7 contract dropped it ("navigation
- * belongs to view owners") — kept only as the legacy fallback of
- * `openSessionThrough`.
- */
-export interface SwitchSessionsService {
-  open(id: string): void
-}
-
-/**
- * The client ui-workspace face: session navigation has been owned by this
- * service since host 0.1.7 (`openSession`; a bare session id is accepted).
- */
-export interface SwitchUiWorkspaceService {
-  openSession(target: string): void
-}
-
-/**
- * Open a session through whichever face the running host offers:
- * `uiWorkspace.openSession` first (0.1.7+), the pre-0.1.7 `sessions.open` as
- * fallback. Neither present → silent no-op.
- */
-export function openSessionThrough(get: (name: string) => unknown, sessionId: string): void {
-  const uiWorkspace = get('uiWorkspace') as SwitchUiWorkspaceService | undefined
-  if (uiWorkspace !== undefined && typeof uiWorkspace.openSession === 'function') {
-    uiWorkspace.openSession(sessionId)
-    return
-  }
-  const sessions = get('sessions') as SwitchSessionsService | undefined
-  if (sessions !== undefined && typeof sessions.open === 'function') sessions.open(sessionId)
-}
+}
+
+/** One session listed by `session-catalog` (active + archived in one table). */
+export interface HostSessionItem {
+  sessionId: string
+  title: string
+  cwd: string
+  updatedAt: number
+  /** 归档标记（合表语义）：缺省字段按「活跃」对待。 */
+  archived?: boolean
+}
+
+/**
+ * 直接删除入口开关（`manage-session.directDelete`，缺省关）。
+ * 由 `session-health-status` 的 switches 面读取；旧宿主半无该字段 → false
+ * （破坏性入口不出现是安全方向）。
+ */
+export async function probeDirectDelete(): Promise<boolean> {
+  const res = await callHostAny<HealthStatusResponse>('session-health-status', {})
+  return res.ok === true && res.switches?.directDelete === true
+}
+
+/**
+ * The client sessions service face. Host lines before 0.1.7 exposed session
+ * navigation here as `open`; the 0.1.7 contract dropped it ("navigation
+ * belongs to view owners") — kept only as the legacy fallback of
+ * `openSessionThrough`.
+ */
+export interface SwitchSessionsService {
+  open(id: string): void
+}
+
+/**
+ * The client ui-workspace face: session navigation has been owned by this
+ * service since host 0.1.7 (`openSession`; a bare session id is accepted).
+ */
+export interface SwitchUiWorkspaceService {
+  openSession(target: string): void
+}
+
+/**
+ * Open a session through whichever face the running host offers:
+ * `uiWorkspace.openSession` first (0.1.7+), the pre-0.1.7 `sessions.open` as
+ * fallback. Neither present → silent no-op.
+ */
+export function openSessionThrough(get: (name: string) => unknown, sessionId: string): void {
+  const uiWorkspace = get('uiWorkspace') as SwitchUiWorkspaceService | undefined
+  if (uiWorkspace !== undefined && typeof uiWorkspace.openSession === 'function') {
+    uiWorkspace.openSession(sessionId)
+    return
+  }
+  const sessions = get('sessions') as SwitchSessionsService | undefined
+  if (sessions !== undefined && typeof sessions.open === 'function') sessions.open(sessionId)
+}