dsh-endpoint 0.0.0-stage → 1.0.0

package/src/admin.js

@@ -0,0 +1,178 @@
+import { readFile, rename, writeFile, mkdir } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/** Fields the settings page may write into the user overlay. */
+const CONFIG_KEYS = ['host', 'port', 'defaultModel', 'modelAliases', 'session', 'limits', 'log']
+
+/**
+ * The page writes a user overlay (`$DSH_HOME/dsh-endpoint/config.json`) instead
+ * of the Cordis entry config: the browser cannot reach the loader, and this is
+ * the same two-layer shape other plugins use (bootstrap config + user file).
+ */
+export async function readOverlay(root) {
+  try {
+    const raw = await readFile(join(root, 'config.json'), 'utf8')
+    const parsed = JSON.parse(raw)
+    return parsed !== null && typeof parsed === 'object' ? parsed : {}
+  } catch (error) {
+    if (error?.code === 'ENOENT') return {}
+    throw error
+  }
+}
+
+export async function writeOverlay(root, overlay) {
+  await mkdir(root, { recursive: true })
+  const file = join(root, 'config.json')
+  const tmp = `${file}.tmp`
+  await writeFile(tmp, `${JSON.stringify(overlay, null, 2)}\n`, 'utf8')
+  await rename(tmp, file)
+}
+
+/** Deep-merge the user overlay over the entry config for the keys we own. */
+export function mergeConfig(base, overlay) {
+  const out = { ...base }
+  for (const key of CONFIG_KEYS) {
+    if (!Object.hasOwn(overlay, key)) continue
+    const next = overlay[key]
+    const current = base[key]
+    if (isPlainObject(next) && isPlainObject(current)) out[key] = { ...current, ...next }
+    else out[key] = next
+  }
+  return out
+}
+
+/**
+ * Validate and normalise a patch coming from the settings page.
+ * @returns {{ patch: object, restartRequired: boolean }}
+ */
+export function normalisePatch(input, base) {
+  if (!isPlainObject(input)) throw new Error('body must be a JSON object')
+  const patch = {}
+  let restartRequired = false
+  let rebind = false
+
+  if ('host' in input) {
+    const host = input.host
+    if (typeof host !== 'string' || host.length === 0) throw new Error('host must be a non-empty string')
+    if (host !== base.host) rebind = true
+    patch.host = host
+  }
+  if ('port' in input) {
+    const port = Number(input.port)
+    if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error('port must be an integer 0-65535')
+    if (port !== base.port) rebind = true
+    patch.port = port
+  }
+  if ('defaultModel' in input) {
+    if (typeof input.defaultModel !== 'string') throw new Error('defaultModel must be a string')
+    patch.defaultModel = input.defaultModel
+  }
+  if ('modelAliases' in input) {
+    if (!isPlainObject(input.modelAliases)) throw new Error('modelAliases must be an object')
+    for (const [name, target] of Object.entries(input.modelAliases)) {
+      if (typeof target !== 'string' || !target.includes('/')) {
+        throw new Error(`modelAliases.${name} must be "provider/model"`)
+      }
+    }
+    patch.modelAliases = input.modelAliases
+  }
+  if ('session' in input) {
+    const session = input.session
+    if (!isPlainObject(session)) throw new Error('session must be an object')
+    const next = {}
+    if ('mirror' in session) {
+      if (typeof session.mirror !== 'boolean') throw new Error('session.mirror must be a boolean')
+      if (session.mirror !== base.session.mirror) restartRequired = true
+      next.mirror = session.mirror
+    }
+    if ('mappingTtlDays' in session) {
+      const days = Number(session.mappingTtlDays)
+      if (!Number.isFinite(days) || days < 0) throw new Error('session.mappingTtlDays must be >= 0')
+      next.mappingTtlDays = days
+    }
+    if ('workspacePath' in session) {
+      if (typeof session.workspacePath !== 'string') throw new Error('session.workspacePath must be a string')
+      if (session.workspacePath !== base.session.workspacePath) restartRequired = true
+      next.workspacePath = session.workspacePath
+    }
+    patch.session = next
+  }
+
+  return { patch, restartRequired, rebind }
+}
+
+/** Register the settings-page routes on the GUI web server (loopback only). */
+export function registerAdminRoutes(ctx, options) {
+  if (typeof ctx?.inject !== 'function') return
+  const { root, getConfig, onSave, getState, log } = options
+  ctx.inject(['webServer'], (webCtx) => {
+    webCtx.effect(() =>
+      webCtx.webServer.register({
+        kind: 'prefix',
+        path: '/dsh-endpoint',
+        handler: (req, res) => {
+          void handleAdmin(req, res, { root, getConfig, onSave, getState, log })
+        },
+      }),
+    )
+  })
+}
+
+async function handleAdmin(req, res, { root, getConfig, onSave, getState, log }) {
+  if (!isLoopback(req.socket?.remoteAddress)) {
+    return sendJson(res, 403, { error: 'loopback only' })
+  }
+  const url = new URL(req.url ?? '/', 'http://localhost')
+  try {
+    if (req.method === 'GET' && url.pathname === '/dsh-endpoint/state') {
+      return sendJson(res, 200, await getState())
+    }
+    if (req.method === 'GET' && url.pathname === '/dsh-endpoint/config') {
+      return sendJson(res, 200, getConfig())
+    }
+    if (req.method === 'PUT' && url.pathname === '/dsh-endpoint/config') {
+      const body = await readJson(req)
+      const { patch, restartRequired, rebind } = normalisePatch(body, getConfig())
+      const current = await readOverlay(root)
+      const overlay = { ...current, ...patch, ...(patch.session ? { session: { ...(current.session ?? {}), ...patch.session } } : {}) }
+      await writeOverlay(root, overlay)
+      const effective = mergeConfig(getConfig(), overlay)
+      await onSave?.(effective, patch)
+      log?.(
+        'info',
+        `settings page saved config${rebind ? ' (listener rebound)' : ''}${restartRequired ? ' (restart required)' : ''}`,
+      )
+      return sendJson(res, 200, { saved: true, restartRequired, rebound: rebind, config: effective })
+    }
+    return sendJson(res, 404, { error: 'not found' })
+  } catch (error) {
+    return sendJson(res, 400, { error: String(error?.message ?? error) })
+  }
+}
+
+function isLoopback(address) {
+  if (typeof address !== 'string') return false
+  return address === '::1' || address === '127.0.0.1' || address.startsWith('127.') || address.startsWith('::ffff:127.')
+}
+
+function isPlainObject(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+async function readJson(req) {
+  const chunks = []
+  let size = 0
+  for await (const chunk of req) {
+    size += chunk.length
+    if (size > 256 * 1024) throw new Error('body too large')
+    chunks.push(chunk)
+  }
+  if (chunks.length === 0) return {}
+  return JSON.parse(Buffer.concat(chunks).toString('utf8'))
+}
+
+function sendJson(res, status, payload) {
+  const body = JSON.stringify(payload)
+  res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'content-length': Buffer.byteLength(body) })
+  res.end(body)
+}

package/src/client.js

@@ -0,0 +1,517 @@
+/**
+ * Client half for dsh-endpoint.
+ *
+ * Loaded by DSH's module loader as a plain script (no top-level import/export):
+ * the factory receives `require` and must return the module object. It declares
+ * `inject: ['slots', 'locale']` — both are required before `apply` runs, and
+ * accessing either without declaring it would fail the client boot.
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-endpoint',
+  factory: function (require) {
+    var React = require('react')
+    var h = React.createElement
+
+    var NS = 'dsh-endpoint'
+
+    var DICT = {
+      zh: {
+        nav: '模型端点',
+        status: '状态',
+        address: '运行地址',
+        providers: 'Provider',
+        providersEmpty: '未注册',
+        sessions: '镜像会话',
+        mappings: '{n} 条映射',
+        endpoint: '端点',
+        host: '监听地址',
+        hostLocal: '127.0.0.1（仅本机）',
+        hostAll: '0.0.0.0（所有网卡）',
+        hostHintLocal: '仅本机可访问',
+        hostHintAll: '⚠ 没有鉴权，同网段任何人都能调用',
+        port: '端口',
+        models: '模型',
+        defaultModel: '默认模型',
+        defaultModelHint: '请求不带 model 时使用，格式 provider/model',
+        aliases: '模型别名',
+        aliasesHint: 'JSON 对象，例如 {"gpt-4o": "opencode-go/deepseek-v4.1-flash"}',
+        mirror: '会话镜像',
+        mirrorOn: '把每段 API 对话写成一个 DSH 会话（侧栏可见、只读）',
+        ttl: '映射保留',
+        ttlHint: '外部会话 ID 超过这个天数没再用，就解绑并归档',
+        ttlUnit: '天',
+        workspace: '工作区目录',
+        workspaceHint: '镜像会话归属的 workspace；留空用 $DSH_HOME/dsh-endpoint/conversations',
+        save: '保存',
+        saving: '保存中…',
+        savedLive: '已保存，即时生效。',
+        savedRebound: '已保存，监听地址已切换。',
+        savedRestart: '已保存。镜像开关 / 工作区目录需要重载插件后生效。',
+        client: '客户端接入',
+        loading: '正在读取端点状态…',
+        readStateFailed: '状态读取失败：',
+        readConfigFailed: '配置读取失败：',
+        saveFailed: '保存失败',
+        aliasesInvalid: '模型别名不是合法 JSON：',
+      },
+      en: {
+        nav: 'Model Endpoint',
+        status: 'Status',
+        address: 'Address',
+        providers: 'Providers',
+        providersEmpty: 'none registered',
+        sessions: 'Mirrored sessions',
+        mappings: '{n} mappings',
+        endpoint: 'Endpoint',
+        host: 'Listen address',
+        hostLocal: '127.0.0.1 (local only)',
+        hostAll: '0.0.0.0 (all interfaces)',
+        hostHintLocal: 'Reachable only from this machine',
+        hostHintAll: '⚠ No authentication: anyone on this network can use it',
+        port: 'Port',
+        models: 'Models',
+        defaultModel: 'Default model',
+        defaultModelHint: 'Used when a request omits `model`, as provider/model',
+        aliases: 'Model aliases',
+        aliasesHint: 'JSON object, e.g. {"gpt-4o": "opencode-go/deepseek-v4.1-flash"}',
+        mirror: 'Session mirror',
+        mirrorOn: 'Write each API conversation into a DSH session (visible in the sidebar, read-only)',
+        ttl: 'Mapping retention',
+        ttlHint: 'Days an external conversation id keeps its session after its last use',
+        ttlUnit: 'days',
+        workspace: 'Workspace directory',
+        workspaceHint: 'Workspace that groups mirrored sessions; empty means $DSH_HOME/dsh-endpoint/conversations',
+        save: 'Save',
+        saving: 'Saving…',
+        savedLive: 'Saved and applied.',
+        savedRebound: 'Saved; the listener moved to the new address.',
+        savedRestart: 'Saved. The mirror switch / workspace directory need a plugin reload.',
+        client: 'Client setup',
+        loading: 'Loading endpoint state…',
+        readStateFailed: 'Could not read status: ',
+        readConfigFailed: 'Could not read config: ',
+        saveFailed: 'Save failed',
+        aliasesInvalid: 'Model aliases are not valid JSON: ',
+      },
+    }
+
+    var TOKEN = {
+      text: 'var(--dsw-alias-label-primary)',
+      dim: 'var(--dsw-alias-label-tertiary, #8b8b8b)',
+      border: 'var(--dsw-alias-border-l2, #3a3a3a)',
+      bg: 'var(--dsw-alias-bg-layer-1, #1f1f1f)',
+      accent: 'var(--dsw-alias-state-business-primary, #4f8cff)',
+    }
+
+    var S = {
+      page: { maxWidth: 720, display: 'flex', flexDirection: 'column', gap: 16, color: TOKEN.text },
+      card: {
+        border: '1px solid ' + TOKEN.border,
+        borderRadius: 12,
+        padding: 16,
+        display: 'flex',
+        flexDirection: 'column',
+        gap: 12,
+      },
+      title: { fontSize: 13, fontWeight: 600, color: TOKEN.dim, letterSpacing: '0.02em' },
+      row: { display: 'flex', alignItems: 'flex-start', gap: 16, minHeight: 34 },
+      label: { width: 120, flex: 'none', fontSize: 13, lineHeight: '30px' },
+      control: { flex: 1, display: 'flex', flexDirection: 'column', gap: 4, minWidth: 0 },
+      input: {
+        width: '100%',
+        boxSizing: 'border-box',
+        height: 30,
+        padding: '0 10px',
+        borderRadius: 8,
+        border: '1px solid ' + TOKEN.border,
+        background: TOKEN.bg,
+        color: TOKEN.text,
+        fontSize: 13,
+        outline: 'none',
+      },
+      area: {
+        width: '100%',
+        boxSizing: 'border-box',
+        minHeight: 90,
+        padding: '8px 10px',
+        borderRadius: 8,
+        border: '1px solid ' + TOKEN.border,
+        background: TOKEN.bg,
+        color: TOKEN.text,
+        fontFamily: 'ui-monospace, Menlo, monospace',
+        fontSize: 12,
+        resize: 'vertical',
+      },
+      hint: { fontSize: 12, color: TOKEN.dim, lineHeight: '18px' },
+      button: {
+        alignSelf: 'flex-start',
+        height: 30,
+        padding: '0 16px',
+        borderRadius: 8,
+        border: 'none',
+        background: TOKEN.accent,
+        color: '#fff',
+        fontSize: 13,
+        cursor: 'pointer',
+      },
+      mono: {
+        fontFamily: 'ui-monospace, Menlo, monospace',
+        fontSize: 12,
+        padding: '8px 10px',
+        borderRadius: 8,
+        border: '1px solid ' + TOKEN.border,
+        background: TOKEN.bg,
+        overflowX: 'auto',
+        whiteSpace: 'pre',
+      },
+      pill: {
+        display: 'inline-block',
+        padding: '2px 8px',
+        borderRadius: 999,
+        border: '1px solid ' + TOKEN.border,
+        fontSize: 12,
+        marginRight: 6,
+        color: TOKEN.text,
+      },
+      ok: { fontSize: 12, color: '#3fb950' },
+      err: { fontSize: 12, color: '#f85149' },
+    }
+
+    function Field(props) {
+      return h(
+        'div',
+        { style: S.row },
+        h('div', { style: S.label }, props.label),
+        h(
+          'div',
+          { style: S.control },
+          props.children,
+          props.hint === undefined ? null : h('div', { style: S.hint }, props.hint),
+        ),
+      )
+    }
+
+    function EndpointSection(props) {
+      var t = props.t
+      var locale = props.locale
+      var store = React.useMemo(
+        function () {
+          return {
+            subscribe: function (callback) {
+              return locale.subscribe(callback)
+            },
+            get: function () {
+              return locale.getSnapshot()
+            },
+          }
+        },
+        [locale],
+      )
+      // Re-render on locale switches; `t` itself reads the active locale at call time.
+      React.useSyncExternalStore(store.subscribe, store.get)
+
+      var statusHook = React.useState(null)
+      var status = statusHook[0]
+      var setStatus = statusHook[1]
+      var formHook = React.useState(null)
+      var form = formHook[0]
+      var setForm = formHook[1]
+      var msgHook = React.useState(null)
+      var message = msgHook[0]
+      var setMessage = msgHook[1]
+      var busyHook = React.useState(false)
+      var busy = busyHook[0]
+      var setBusy = busyHook[1]
+
+      React.useEffect(function () {
+        var cancelled = false
+        fetch('/dsh-endpoint/state')
+          .then(function (response) {
+            return response.json()
+          })
+          .then(function (value) {
+            if (!cancelled) setStatus(value)
+          })
+          .catch(function (error) {
+            if (!cancelled) setMessage({ kind: 'err', text: t('readStateFailed') + String(error) })
+          })
+        fetch('/dsh-endpoint/config')
+          .then(function (response) {
+            return response.json()
+          })
+          .then(function (config) {
+            if (cancelled) return
+            setForm({
+              host: config.host,
+              port: config.port,
+              defaultModel: config.defaultModel || '',
+              aliases: JSON.stringify(config.modelAliases || {}, null, 2),
+              mirror: config.session ? config.session.mirror !== false : true,
+              ttl: config.session ? config.session.mappingTtlDays : 3,
+              workspacePath: config.session ? config.session.workspacePath || '' : '',
+            })
+          })
+          .catch(function (error) {
+            if (!cancelled) setMessage({ kind: 'err', text: t('readConfigFailed') + String(error) })
+          })
+        return function () {
+          cancelled = true
+        }
+      }, [])
+
+      var update = function (patch) {
+        setForm(function (current) {
+          return Object.assign({}, current, patch)
+        })
+        setMessage(null)
+      }
+
+      var save = function () {
+        var aliases
+        try {
+          aliases = JSON.parse(form.aliases || '{}')
+        } catch (error) {
+          setMessage({ kind: 'err', text: t('aliasesInvalid') + String(error.message || error) })
+          return
+        }
+        setBusy(true)
+        setMessage(null)
+        fetch('/dsh-endpoint/config', {
+          method: 'PUT',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({
+            host: form.host,
+            port: Number(form.port),
+            defaultModel: form.defaultModel,
+            modelAliases: aliases,
+            session: {
+              mirror: form.mirror,
+              mappingTtlDays: Number(form.ttl),
+              workspacePath: form.workspacePath,
+            },
+          }),
+        })
+          .then(function (response) {
+            return response.json().then(function (body) {
+              return { ok: response.ok, body: body }
+            })
+          })
+          .then(function (result) {
+            if (!result.ok) throw new Error(result.body.error || t('saveFailed'))
+            var text = result.body.restartRequired
+              ? t('savedRestart')
+              : result.body.rebound
+                ? t('savedRebound')
+                : t('savedLive')
+            setMessage({ kind: 'ok', text: text })
+            if (result.body.config) {
+              setStatus(function (current) {
+                return Object.assign({}, current, {
+                  host: result.body.config.host,
+                  port: result.body.config.port,
+                  url: 'http://' + result.body.config.host + ':' + result.body.config.port,
+                })
+              })
+            }
+          })
+          .catch(function (error) {
+            setMessage({ kind: 'err', text: String(error.message || error) })
+          })
+          .then(function () {
+            setBusy(false)
+          })
+      }
+
+      if (form === null) {
+        return h('div', { style: S.page }, h('div', { style: S.hint }, message === null ? t('loading') : message.text))
+      }
+
+      var statusChildren =
+        status === null
+          ? [h('div', { key: 'loading', style: S.hint }, t('loading'))]
+          : [
+              h(Field, { key: 'url', label: t('address') }, h('div', { style: S.mono }, status.url)),
+              h(
+                Field,
+                { key: 'providers', label: t('providers') },
+                h(
+                  'div',
+                  null,
+                  (status.providers || []).map(function (name) {
+                    return h('span', { key: name, style: S.pill }, name)
+                  }),
+                  (status.providers || []).length === 0 ? h('span', { style: S.hint }, t('providersEmpty')) : null,
+                ),
+              ),
+              h(
+                Field,
+                { key: 'sessions', label: t('sessions'), hint: status.stateRoot },
+                h('div', { style: S.hint }, t('mappings').replace('{n}', String(status.sessions || 0))),
+              ),
+            ]
+
+      return h(
+        'div',
+        { style: S.page },
+        h('div', { style: S.card }, [h('div', { key: 't', style: S.title }, t('status'))].concat(statusChildren)),
+        h(
+          'div',
+          { style: S.card },
+          h('div', { style: S.title }, t('endpoint')),
+          h(
+            Field,
+            {
+              label: t('host'),
+              hint: form.host === '0.0.0.0' ? t('hostHintAll') : t('hostHintLocal'),
+            },
+            h(
+              'select',
+              {
+                style: S.input,
+                value: form.host,
+                onChange: function (event) {
+                  update({ host: event.target.value })
+                },
+              },
+              h('option', { value: '127.0.0.1' }, t('hostLocal')),
+              h('option', { value: '0.0.0.0' }, t('hostAll')),
+            ),
+          ),
+          h(
+            Field,
+            { label: t('port') },
+            h('input', {
+              style: S.input,
+              type: 'number',
+              value: form.port,
+              onChange: function (event) {
+                update({ port: event.target.value })
+              },
+            }),
+          ),
+        ),
+        h(
+          'div',
+          { style: S.card },
+          h('div', { style: S.title }, t('models')),
+          h(
+            Field,
+            { label: t('defaultModel'), hint: t('defaultModelHint') },
+            h('input', {
+              style: S.input,
+              value: form.defaultModel,
+              placeholder: 'opencode-go/deepseek-v4.1-flash',
+              onChange: function (event) {
+                update({ defaultModel: event.target.value })
+              },
+            }),
+          ),
+          h(
+            Field,
+            { label: t('aliases'), hint: t('aliasesHint') },
+            h('textarea', {
+              style: S.area,
+              value: form.aliases,
+              onChange: function (event) {
+                update({ aliases: event.target.value })
+              },
+            }),
+          ),
+        ),
+        h(
+          'div',
+          { style: S.card },
+          h('div', { style: S.title }, t('mirror')),
+          h(
+            Field,
+            { label: t('mirror') },
+            h(
+              'label',
+              { style: { display: 'flex', alignItems: 'center', gap: 8, fontSize: 13, lineHeight: '30px' } },
+              h('input', {
+                type: 'checkbox',
+                checked: form.mirror,
+                onChange: function (event) {
+                  update({ mirror: event.target.checked })
+                },
+              }),
+              t('mirrorOn'),
+            ),
+          ),
+          h(
+            Field,
+            { label: t('ttl'), hint: t('ttlHint') },
+            h(
+              'div',
+              { style: { display: 'flex', alignItems: 'center', gap: 8 } },
+              h('input', {
+                style: Object.assign({}, S.input, { width: 100 }),
+                type: 'number',
+                value: form.ttl,
+                onChange: function (event) {
+                  update({ ttl: event.target.value })
+                },
+              }),
+              h('span', { style: S.hint }, t('ttlUnit')),
+            ),
+          ),
+          h(
+            Field,
+            { label: t('workspace'), hint: t('workspaceHint') },
+            h('input', {
+              style: S.input,
+              value: form.workspacePath,
+              onChange: function (event) {
+                update({ workspacePath: event.target.value })
+              },
+            }),
+          ),
+        ),
+        h(
+          'div',
+          { style: { display: 'flex', alignItems: 'center', gap: 12 } },
+          h('button', { style: S.button, onClick: save, disabled: busy }, busy ? t('saving') : t('save')),
+          message === null ? null : h('span', { style: message.kind === 'ok' ? S.ok : S.err }, message.text),
+        ),
+        h(
+          'div',
+          { style: S.card },
+          h('div', { style: S.title }, t('client')),
+          h(
+            'div',
+            { style: S.mono },
+            'export OPENAI_BASE_URL=' +
+              (status ? status.url : 'http://127.0.0.1:43130') +
+              '/v1\nexport OPENAI_API_KEY=anything',
+          ),
+        ),
+      )
+    }
+
+    function apply(ctx) {
+      ctx.effect(function () {
+        return ctx.locale.register(NS, { zh: DICT.zh, en: DICT.en })
+      }, 'dsh-endpoint: dictionaries')
+      var t = ctx.locale.bind(NS)
+
+      ctx.slots.inject('settings.section', function* () {
+        yield ctx.slots.register(
+          {
+            name: 'settings.section',
+            id: 'endpoint-config',
+            order: 40,
+            label: function () {
+              return t('nav')
+            },
+            inject: function () {
+              return { t: t, locale: ctx.locale }
+            },
+          },
+          EndpointSection,
+        )
+      })
+    }
+
+    return { name: 'dsh-endpoint', inject: ['slots', 'locale'], apply: apply }
+  },
+})