dsh-manage-session 0.5.7 → 2.0.4

package/src/client/host-api.ts

@@ -1,19 +1,19 @@
 /**
- * 客户端 host 调用助手：一切经 fenced `/session-steward/api/<method>` 路由，
+ * 客户端 host 调用助手：一切经 fenced `/manage-session/api/<method>` 路由，
  * 不 value-import 任何官方包（与 dsh-session-search-toggle 的 host-api.ts 同范式，
- * 仅把路由前缀换成会话管家自己的）。
+ * 仅把路由前缀换成会话管理自己的）。
  */
 
 /** 单次 host 调用超时（导入类大响应可单独放宽）。 */
 const FETCH_TIMEOUT = 20_000
 
-/** POST 一个 JSON body 到会话管家的 fenced API（items 形状）。 */
+/** POST 一个 JSON body 到会话管理的 fenced API（items 形状）。 */
 export function callHost<T>(method: string, body: unknown): Promise<{ ok: boolean; items: T[]; error?: string }> {
   const controller = typeof AbortController === 'undefined' ? undefined : new AbortController()
   const timer = controller !== undefined && typeof setTimeout === 'function'
     ? setTimeout(() => { controller.abort() }, FETCH_TIMEOUT)
     : undefined
-  return fetch(`/session-steward/api/${method}`, {
+  return fetch(`/manage-session/api/${method}`, {
     method: 'POST',
     headers: { 'content-type': 'application/json' },
     body: JSON.stringify(body),
@@ -47,7 +47,7 @@ export function callHostAny<T>(
   const timer = typeof setTimeout === 'function'
     ? setTimeout(() => { controller?.abort() }, timeout)
     : undefined
-  return fetch(`/session-steward/api/${method}`, {
+  return fetch(`/manage-session/api/${method}`, {
     method: 'POST',
     headers: { 'content-type': 'application/json' },
     body: JSON.stringify(body),
@@ -184,12 +184,78 @@ export interface SourceMigrateResponse {
   error?: string
 }
 
+/**
+ * 兼容别名：合并包时代的 `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 interface HealthStatusResponse {
   ok: boolean
-  switches?: { enabled: boolean; historyFiles: boolean; healthCheck: boolean }
+  switches?: { enabled: boolean; historyFiles: boolean; healthCheck: boolean; directDelete?: boolean }
   historyMethods?: string[]
   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)
+}