dsh-router-core 0.1.0

package/src/client/sidebar-entry.ts

@@ -0,0 +1,167 @@
+/**
+ * Mount a self-healing sidebar entry for the 路由系统 (Routing System),
+ * placed directly ABOVE dsh-mnemon's 记忆系统 entry when that is present.
+ *
+ * The DOM pattern mirrors dsh-mnemon's sidebar-entry.ts: an official-style
+ * row under the New Session row, with a MutationObserver keeping it in place
+ * as the shell re-renders. We deliberately order the family selector so the
+ * router entry sits above the memory entry.
+ */
+import { ROUTER_ENTRY_SELECTOR, ROUTER_TITLE } from '../shared.ts'
+import type { RouterWorkspaceController } from './workspace-controller.ts'
+
+/** Other plugin families that occupy the same sidebar region. */
+const FAMILY_SELECTOR =
+  '[data-dsh-taskboard-entry], [data-dsh-ssh-entry], [data-dsh-mnemon-entry], [data-dsh-router-entry]'
+
+/** The entry we want to sit above (dsh-mnemon's 记忆系统), when present. */
+const ABOVE_TARGET_SELECTOR = '[data-dsh-mnemon-entry]'
+
+function sidebarRoot(): HTMLElement | undefined {
+  const column = document.querySelector<HTMLElement>(
+    '[data-pane="sidebar"], [class*="sidebarCol"], .dshDesktopUpstreamSidebar',
+  )
+  if (column === null) return undefined
+  return column.querySelector<HTMLElement>('[class*="logoRow"]')?.parentElement
+    ?? (column.firstElementChild as HTMLElement | undefined)
+}
+
+function newSessionButton(root: HTMLElement): HTMLButtonElement | undefined {
+  const nested = root.querySelector<HTMLButtonElement>('button[class*="newSession"]')
+  if (nested !== null) return nested
+  for (const child of root.children) {
+    if (child.tagName === 'BUTTON') return child as HTMLButtonElement
+  }
+  return undefined
+}
+
+function createIcon(): SVGSVGElement {
+  const namespace = 'http://www.w3.org/2000/svg'
+  const icon = document.createElementNS(namespace, 'svg')
+  icon.setAttribute('viewBox', '0 0 16 16')
+  icon.setAttribute('width', '18')
+  icon.setAttribute('height', '18')
+  icon.setAttribute('fill', 'none')
+  icon.setAttribute('stroke', 'currentColor')
+  icon.setAttribute('stroke-width', '1.5')
+  icon.setAttribute('stroke-linecap', 'round')
+  icon.setAttribute('stroke-linejoin', 'round')
+  icon.setAttribute('aria-hidden', 'true')
+  // A simple node-graph "route" glyph: three dots joined by two paths.
+  const c1 = document.createElementNS(namespace, 'circle')
+  c1.setAttribute('cx', '3.5'); c1.setAttribute('cy', '3.5'); c1.setAttribute('r', '1.6')
+  const c2 = document.createElementNS(namespace, 'circle')
+  c2.setAttribute('cx', '12.5'); c2.setAttribute('cy', '3.5'); c2.setAttribute('r', '1.6')
+  const c3 = document.createElementNS(namespace, 'circle')
+  c3.setAttribute('cx', '8'); c3.setAttribute('cy', '12.5'); c3.setAttribute('r', '1.6')
+  const p1 = document.createElementNS(namespace, 'path')
+  p1.setAttribute('d', 'M5.1 3.5h6.8')
+  const p2 = document.createElementNS(namespace, 'path')
+  p2.setAttribute('d', 'M3.5 5.1v4.3c0 1.7 2 2.2 3 2.4')
+  const p3 = document.createElementNS(namespace, 'path')
+  p3.setAttribute('d', 'M12.5 5.1v4.3c0 1.7-2 2.2-3 2.4')
+  icon.append(c1, c2, c3, p1, p2, p3)
+  return icon
+}
+
+function createEntry(controller: RouterWorkspaceController): { entry: HTMLButtonElement; label: HTMLSpanElement } {
+  const entry = document.createElement('button')
+  entry.type = 'button'
+  entry.dataset.dshRouterEntry = ''
+  entry.className = 'dshr-entry'
+  const icon = document.createElement('span')
+  icon.className = 'dshr-entryIcon'
+  icon.append(createIcon())
+  const label = document.createElement('span')
+  label.className = 'dshr-entryLabel'
+  entry.append(icon, label)
+  entry.addEventListener('click', () => { controller.toggle() })
+  return { entry, label }
+}
+
+function placeEntry(root: HTMLElement, entry: HTMLButtonElement): boolean {
+  const button = newSessionButton(root)
+  if (button === undefined) return false
+  if (entry.parentElement === root) return true
+  const row = button.closest('[class*="logoRow"]')
+  const base = row !== null && row.parentElement === root ? row : button
+  const family = Array.from(root.children).filter(
+    (element): element is HTMLElement =>
+      element instanceof HTMLElement && element.matches(FAMILY_SELECTOR),
+  )
+  // Prefer to sit directly above dsh-mnemon's entry; otherwise after the
+  // last known family entry, else after the New Session row.
+  const aboveTarget = Array.from(root.children).find(
+    (element): element is HTMLElement =>
+      element instanceof HTMLElement && element.matches(ABOVE_TARGET_SELECTOR),
+  )
+  let anchor: Element | null
+  if (aboveTarget !== undefined) {
+    anchor = aboveTarget
+  } else {
+    anchor = family.at(-1)?.nextElementSibling ?? base.nextElementSibling
+  }
+  root.insertBefore(entry, anchor)
+  return true
+}
+
+/** Mount a self-healing 路由系统 entry above the 记忆系统 row. */
+export function mountRouterSidebarEntry(
+  controller: RouterWorkspaceController,
+): () => void {
+  const { entry, label } = createEntry(controller)
+  let root: HTMLElement | undefined
+  let placed = false
+
+  const syncLabel = (): void => {
+    if (entry.getAttribute('aria-label') !== ROUTER_TITLE) entry.setAttribute('aria-label', ROUTER_TITLE)
+    if (entry.title !== ROUTER_TITLE) entry.title = ROUTER_TITLE
+    if (label.textContent !== ROUTER_TITLE) label.textContent = ROUTER_TITLE
+  }
+
+  const rootObserver = new MutationObserver(() => {
+    if (root === undefined || !root.isConnected) {
+      placed = false
+      tryPlace()
+      return
+    }
+    if (!root.contains(entry)) placed = placeEntry(root, entry)
+  })
+
+  const tryPlace = (): void => {
+    syncLabel()
+    if (root !== undefined && !root.isConnected) {
+      rootObserver.disconnect()
+      root = undefined
+      placed = false
+    }
+    if (placed && document.body.contains(entry)) return
+    if (placed) {
+      rootObserver.disconnect()
+      root = undefined
+      placed = false
+    }
+    root ??= sidebarRoot()
+    if (root === undefined) return
+    placed = placeEntry(root, entry)
+    if (placed) rootObserver.observe(root, { childList: true, subtree: true })
+  }
+
+  const waitObserver = new MutationObserver(tryPlace)
+  waitObserver.observe(document.body, { childList: true, subtree: true })
+
+  const syncActive = (): void => {
+    if (controller.getSnapshot().open) entry.dataset.active = 'true'
+    else delete entry.dataset.active
+  }
+  const unsubscribe = controller.subscribe(syncActive)
+  syncActive()
+  tryPlace()
+
+  return () => {
+    waitObserver.disconnect()
+    rootObserver.disconnect()
+    unsubscribe()
+    entry.remove()
+  }
+}

package/src/client/workspace-controller.ts

@@ -0,0 +1,26 @@
+export interface RouterWorkspaceSnapshot {
+  open: boolean
+}
+
+/** Small framework-neutral state holder shared by the sidebar row and panel. */
+export class RouterWorkspaceController {
+  private snapshot: RouterWorkspaceSnapshot = { open: false }
+  private readonly listeners = new Set<() => void>()
+
+  getSnapshot = (): RouterWorkspaceSnapshot => this.snapshot
+
+  subscribe = (listener: () => void): (() => void) => {
+    this.listeners.add(listener)
+    return () => { this.listeners.delete(listener) }
+  }
+
+  open(): void { this.setOpen(true) }
+  close(): void { this.setOpen(false) }
+  toggle(): void { this.setOpen(!this.snapshot.open) }
+
+  private setOpen(open: boolean): void {
+    if (this.snapshot.open === open) return
+    this.snapshot = { open }
+    for (const listener of this.listeners) listener()
+  }
+}

package/src/client/workspace-mount.tsx

@@ -0,0 +1,117 @@
+/**
+ * Mount the 路由系统 center-column takeover panel, mirroring dsh-mnemon's
+ * workspace-mount.tsx: a React root appended to the conversation column,
+ * shown via `data-dsh-router-active` on <html>, and coordinated with the
+ * other sidebar panels (taskboard / ssh / mnemon) through the shared
+ * `dsh-panel-activate` event.
+ */
+import { useEffect } from 'react'
+import { createRoot, type Root } from 'react-dom/client'
+import { ROUTER_ACTIVE_ATTR, ROUTER_TITLE, ROUTER_VIEW_SELECTOR } from '../shared.ts'
+import { RouterView } from './RouterView.tsx'
+import { mountRouterSidebarEntry } from './sidebar-entry.ts'
+import { RouterWorkspaceController } from './workspace-controller.ts'
+
+const CONVERSATION_COLUMN_SELECTOR =
+  '[data-pane="conversation"], [class*="centerCol"], .dshDesktopConversationSurface'
+const ACTIVATE_EVENT = 'dsh-panel-activate'
+const SIDEBAR_CONTEXT_SELECTOR =
+  '[class*="sessionRow"], [class*="projectRow"], [class*="searchResultRow"], [class*="searchResultWorkspace"], [class*="newSession"]'
+
+function conversationColumn(): HTMLElement | undefined {
+  return document.querySelector<HTMLElement>(CONVERSATION_COLUMN_SELECTOR) ?? undefined
+}
+
+function mountPanel(controller: RouterWorkspaceController): () => void {
+  function Panel(): JSX.Element {
+    useEffect(() => {
+      // Keep the panel title in the browser tab for orientation, like the
+      // official panels do.
+      const original = document.title
+      document.title = ROUTER_TITLE
+      return () => { document.title = original }
+    }, [])
+    return <RouterView onBack={() => controller.close()} />
+  }
+
+  let root: Root | undefined
+  let container: HTMLDivElement | undefined
+
+  const ensure = (): void => {
+    if (container !== undefined && container.isConnected) return
+    if (container !== undefined) {
+      root?.unmount()
+      root = undefined
+      container = undefined
+    }
+    const column = conversationColumn()
+    if (column === undefined) return
+    container = document.createElement('div')
+    container.dataset.dshRouterView = ''
+    container.className = 'dshr-panelView'
+    column.append(container)
+    root = createRoot(container)
+    root.render(<Panel />)
+  }
+
+  const waitObserver = new MutationObserver(ensure)
+  waitObserver.observe(document.body, { childList: true, subtree: true })
+
+  let suppressCompatibilityClose = false
+  const applyActive = (): void => {
+    if (!controller.getSnapshot().open) {
+      document.documentElement.removeAttribute(ROUTER_ACTIVE_ATTR)
+      return
+    }
+    // Announce the other panels so they close; mirror dsh-mnemon's
+    // compatibility broadcast (taskboard/ssh listen to 'ssh'/'taskboard').
+    suppressCompatibilityClose = true
+    document.dispatchEvent(new CustomEvent(ACTIVATE_EVENT, { detail: 'ssh' }))
+    document.dispatchEvent(new CustomEvent(ACTIVATE_EVENT, { detail: 'taskboard' }))
+    suppressCompatibilityClose = false
+    document.documentElement.setAttribute(ROUTER_ACTIVE_ATTR, '')
+    document.dispatchEvent(new CustomEvent(ACTIVATE_EVENT, { detail: 'router' }))
+  }
+
+  const onOtherPanelActivate = (event: Event): void => {
+    if (suppressCompatibilityClose || !controller.getSnapshot().open) return
+    const detail = (event as CustomEvent<unknown>).detail
+    if (detail === 'taskboard' || detail === 'ssh' || detail === 'mnemon') controller.close()
+  }
+
+  const onSidebarContextClick = (event: MouseEvent): void => {
+    if (!controller.getSnapshot().open) return
+    const target = event.target
+    if (target instanceof Element && target.closest(SIDEBAR_CONTEXT_SELECTOR) !== null) controller.close()
+  }
+
+  document.addEventListener('click', onSidebarContextClick, true)
+  document.addEventListener(ACTIVATE_EVENT, onOtherPanelActivate)
+  const unsubscribe = controller.subscribe(applyActive)
+  applyActive()
+  ensure()
+
+  return () => {
+    document.removeEventListener('click', onSidebarContextClick, true)
+    document.removeEventListener(ACTIVATE_EVENT, onOtherPanelActivate)
+    waitObserver.disconnect()
+    unsubscribe()
+    document.documentElement.removeAttribute(ROUTER_ACTIVE_ATTR)
+    root?.unmount()
+    root = undefined
+    container?.remove()
+    container = undefined
+  }
+}
+
+/** Mount the sidebar row and its stateful center-column workspace as one unit. */
+export function mountRouterWorkspace(): () => void {
+  if (typeof document === 'undefined' || typeof window === 'undefined') return () => {}
+  const controller = new RouterWorkspaceController()
+  const disposeEntry = mountRouterSidebarEntry(controller)
+  const disposePanel = mountPanel(controller)
+  return () => {
+    disposePanel()
+    disposeEntry()
+  }
+}

package/src/credential-store.ts

@@ -0,0 +1,64 @@
+/**
+ * 通用凭证存储 —— dsh-router 核心统一管账号凭证（SQLite，参考 9router 的
+ * providerConnections 表：凭证作为不透明 JSON blob 存单表 data 列）。
+ *
+ * 凭证是供应商特有的不透明数据（js 定义格式），核心只负责存储/增删/生命周期，
+ * 不解析内容。库文件：`{authDir}/credentials.sqlite`，表：
+ *   credentials(supplier TEXT, uid TEXT, data TEXT, PRIMARY KEY(supplier, uid))
+ */
+import { DatabaseSync } from 'node:sqlite'
+import { mkdirSync } from 'node:fs'
+import { join } from 'node:path'
+
+/** 通用凭证存储。 */
+export class CredentialStore {
+  private db: DatabaseSync
+
+  constructor(authDir: string) {
+    if (authDir !== '' && authDir !== '.') mkdirSync(authDir, { recursive: true })
+    const dbFile = join(authDir, 'credentials.sqlite')
+    this.db = new DatabaseSync(dbFile)
+    this.db.exec(`CREATE TABLE IF NOT EXISTS credentials (
+      supplier TEXT NOT NULL,
+      uid TEXT NOT NULL,
+      data TEXT NOT NULL,
+      PRIMARY KEY (supplier, uid)
+    )`)
+  }
+
+  /** 某供应商的所有凭证 uid。 */
+  list(supplierId: string): string[] {
+    const rows = this.db.prepare('SELECT uid FROM credentials WHERE supplier = ? ORDER BY rowid').all(supplierId) as Array<{ uid: string }>
+    return rows.map((r) => r.uid)
+  }
+
+  /** 读某凭证（不透明 blob）。不存在返回 undefined。 */
+  get<T = unknown>(supplierId: string, uid: string): T | undefined {
+    const row = this.db.prepare('SELECT data FROM credentials WHERE supplier = ? AND uid = ?').get(supplierId, uid) as { data: string } | undefined
+    if (row === undefined) return undefined
+    try {
+      return JSON.parse(row.data) as T
+    } catch {
+      return undefined
+    }
+  }
+
+  /** 存凭证（upsert）。 */
+  save(supplierId: string, uid: string, data: unknown): void {
+    this.db.prepare('INSERT INTO credentials (supplier, uid, data) VALUES (?, ?, ?) ON CONFLICT(supplier, uid) DO UPDATE SET data = excluded.data').run(
+      supplierId,
+      uid,
+      JSON.stringify(data),
+    )
+  }
+
+  /** 删凭证。 */
+  remove(supplierId: string, uid: string): void {
+    this.db.prepare('DELETE FROM credentials WHERE supplier = ? AND uid = ?').run(supplierId, uid)
+  }
+
+  /** 关闭连接（可选）。 */
+  close(): void {
+    this.db.close()
+  }
+}