@tzyc/dsh-model-visibility 1.9.0 → 1.10.0

package/client-src/index.mjs

@@ -0,0 +1,101 @@
+/**
+ * Plugin entry: store wiring, facts inputs and effect registration.
+ *
+ * Assembled with the other modules by `scripts/build-client.mjs`; the bundle
+ * factory returns `{ inject, apply }` exactly like the original single-file
+ * bundle, but every subsystem now lives in its own module.
+ */
+
+const React = require('react')
+const h = React.createElement
+
+import { NS, ENTRY, SECTION_ID } from './constants.mjs'
+import { DICT } from './dict.mjs'
+import { CSS } from './css.mjs'
+import { createCatalog, createOverrides, createUsageApi, createVerifyApi } from './catalog-store.mjs'
+import { makeSection } from './settings-section.mjs'
+import { installComposerFilter } from './composer-filter.mjs'
+
+const inject = ['slots', 'locale', 'configForms', 'remote', 'remote.session']
+
+function apply(ctx) {
+  ctx.effect(() => ctx.locale.register(NS, DICT), 'model-visibility: dictionaries')
+
+  ctx.effect(() => {
+    const tag = document.createElement('style')
+    tag.dataset.plugin = 'dsh-model-visibility'
+    tag.textContent = CSS
+    document.head.appendChild(tag)
+    return () => {
+      tag.remove()
+    }
+  }, 'model-visibility: styles')
+
+  const form = ctx.configForms.get(ENTRY)
+  const catalog = createCatalog(ctx)
+  const overrides = createOverrides()
+  const usage = createUsageApi()
+  const verify = createVerifyApi()
+
+  ctx.effect(() => {
+    const disposers = []
+    disposers.push(
+      ctx.on('connection/reset', () => {
+        catalog.refresh()
+        overrides.load()
+        usage.refresh()
+      }),
+    )
+    if (ctx.remote !== undefined && typeof ctx.remote.$on === 'function') {
+      disposers.push(
+        ctx.remote.$on('llm/adapters-updated', () => {
+          catalog.refresh()
+        }),
+      )
+      for (const event of [
+        'settings/document-updated',
+        'credentials/record-updated',
+        'credentials/reference-updated',
+      ]) {
+        disposers.push(
+          ctx.remote.$on(event, () => {
+            catalog.load()
+          }),
+        )
+      }
+    }
+    return () => {
+      for (const dispose of disposers) {
+        try {
+          dispose()
+        } catch (_error) {
+          // A source may already be gone during teardown.
+        }
+      }
+    }
+  }, 'model-visibility: catalog refresh')
+
+  const Section = makeSection(form, catalog, overrides, usage, verify)
+  ctx.effect(
+    () =>
+      ctx.slots.inject('settings.section', () =>
+        ctx.slots.register(
+          {
+            name: 'settings.section',
+            id: SECTION_ID,
+            order: 12,
+            locale: NS,
+            label: () => ctx.locale.bind(NS)('nav'),
+          },
+          Section,
+        ),
+      ),
+    'model-visibility: settings section',
+  )
+
+  ctx.inject(['modelDirectories'], (scope) => {
+    installComposerFilter(scope, form)
+  })
+}
+
+export { inject, apply }

package/client-src/override-editor.mjs

@@ -0,0 +1,286 @@
+const React = require('react')
+const h = React.createElement
+
+import { modalityLabel, effortLabel, OVERRIDE_MODALITIES, OVERRIDE_EFFORTS } from './format.mjs'
+function providerWriteNote(result, t) {
+  if (result === null || typeof result !== 'object') return null
+  if (result.written === true) {
+    const fields = (Array.isArray(result.fields) ? result.fields : [])
+      .map((field) => t('override.field.' + field))
+      .join('、')
+    return t('override.providerWritten', { fields })
+  }
+  if (result.reason === 'nothing' || result.reason === 'skipped') return null
+  const label = t('override.reason.' + String(result.reason))
+  return t('override.providerSkipped', {
+    reason: label === 'override.reason.' + String(result.reason) ? String(result.reason) : label,
+  })
+}
+
+function ModelOverrideEditor({ entry, name, t, overrides, onClose, onSaved }) {
+  const [kind, setKind] = React.useState(entry.kind || '')
+  const [context, setContext] = React.useState(
+    entry.contextWindow === undefined ? '' : String(entry.contextWindow),
+  )
+  const [input, setInput] = React.useState(
+    () => new Set(Array.isArray(entry.input) ? entry.input : []),
+  )
+  const [efforts, setEfforts] = React.useState(
+    () => new Set((Array.isArray(entry.efforts) ? entry.efforts : []).map((item) => item.id)),
+  )
+  const [noReasoning, setNoReasoning] = React.useState(entry.reasoningSupported === false)
+  const [defaultEffort, setDefaultEffort] = React.useState(
+    typeof entry.defaultEffort === 'string' ? entry.defaultEffort : '',
+  )
+  const [busy, setBusy] = React.useState(false)
+  const [error, setError] = React.useState(null)
+  const [applyToProvider, setApplyToProvider] = React.useState(true)
+
+  const toggleIn = (setter, id) => {
+    setter((previous) => {
+      const next = new Set(previous)
+      if (next.has(id)) next.delete(id)
+      else next.add(id)
+      return next
+    })
+  }
+
+  const fail = (failure) => {
+    setBusy(false)
+    setError(
+      t('override.failed', {
+        message: String(failure && failure.message ? failure.message : failure),
+      }),
+    )
+  }
+
+  const save = () => {
+    const payload = { provider: entry.provider, model: entry.model }
+    if (kind !== '') payload.kind = kind
+    if (context.trim() !== '') {
+      const value = Number(context)
+      if (!Number.isFinite(value) || value <= 0) {
+        setError(t('override.contextInvalid'))
+        return
+      }
+      payload.contextWindow = Math.round(value)
+    }
+    if (input.size > 0) {
+      payload.input = OVERRIDE_MODALITIES.filter((id) => input.has(id))
+    }
+    if (noReasoning) {
+      payload.reasoningSupported = false
+    } else if (efforts.size > 0) {
+      payload.efforts = OVERRIDE_EFFORTS.filter((id) => efforts.has(id)).map((id) => ({ id }))
+      if (defaultEffort !== '' && efforts.has(defaultEffort)) {
+        payload.defaultEffort = defaultEffort
+      }
+    }
+    payload.applyToProvider = applyToProvider
+    setBusy(true)
+    setError(null)
+    Promise.resolve(overrides.save(payload)).then(
+      (result) => {
+        setBusy(false)
+        if (typeof onSaved === 'function') onSaved(result)
+      },
+      fail,
+    )
+  }
+
+  const resetToAuto = () => {
+    setBusy(true)
+    setError(null)
+    Promise.resolve(overrides.remove(entry.provider, entry.model)).then(
+      () => {
+        setBusy(false)
+        if (typeof onSaved === 'function') onSaved()
+      },
+      fail,
+    )
+  }
+
+  const kindOptions = [['', t('override.kindAuto')]].concat(
+    ['chat', 'image', 'video', 'embedding', 'rerank', 'audio', 'classifier', 'translation'].map(
+      (id) => [id, id === 'chat' ? t('page.filter.chat') : t('tag.kind.' + id)],
+    ),
+  )
+  const defaultOptions = [['', t('override.defaultEffortAuto')]].concat(
+    OVERRIDE_EFFORTS.filter((id) => efforts.has(id)).map((id) => [id, effortLabel(id, t)]),
+  )
+  const selectedDefault = efforts.has(defaultEffort) ? defaultEffort : ''
+
+  return h(
+    'div',
+    { className: 'mvp_editor' },
+    h(
+      'div',
+      { className: 'mvp_editorHead' },
+      h('div', { className: 'mvp_editorTitle' }, t('override.title') + ' · ' + name),
+      h('div', { className: 'mvp_editorSub' }, t('override.hint')),
+    ),
+    h(
+      'div',
+      { className: 'mvp_editorGrid' },
+      h(
+        'label',
+        { className: 'mvp_field' },
+        h('span', { className: 'mvp_fieldLabel' }, t('override.kind')),
+        h(
+          'select',
+          {
+            className: 'mvp_select',
+            value: kind,
+            'aria-label': t('override.kind'),
+            onChange: (event) => setKind(event.target.value),
+          },
+          kindOptions.map(([value, label]) => h('option', { key: value, value }, label)),
+        ),
+      ),
+      h(
+        'label',
+        { className: 'mvp_field' },
+        h('span', { className: 'mvp_fieldLabel' }, t('override.context')),
+        h('input', {
+          className: 'mvp_number',
+          type: 'number',
+          min: '1',
+          step: '1',
+          value: context,
+          placeholder: t('override.contextPlaceholder'),
+          'aria-label': t('override.context'),
+          onInput: (event) => setContext(event.target.value),
+        }),
+      ),
+      h(
+        'div',
+        { className: 'mvp_field mvp_field--wide' },
+        h('span', { className: 'mvp_fieldLabel' }, t('override.input')),
+        h(
+          'div',
+          { className: 'mvp_chips' },
+          OVERRIDE_MODALITIES.map((id) =>
+            h(
+              'button',
+              {
+                key: id,
+                type: 'button',
+                className: 'mvp_chip',
+                'aria-pressed': input.has(id),
+                disabled: busy,
+                onClick: () => toggleIn(setInput, id),
+              },
+              modalityLabel(id, t),
+            ),
+          ),
+        ),
+      ),
+      h(
+        'div',
+        { className: 'mvp_field mvp_field--wide' },
+        h('span', { className: 'mvp_fieldLabel' }, t('override.efforts')),
+        h(
+          'div',
+          { className: 'mvp_chips' },
+          h(
+            'button',
+            {
+              type: 'button',
+              className: 'mvp_chip',
+              'aria-pressed': noReasoning,
+              disabled: busy,
+              onClick: () => setNoReasoning((value) => !value),
+            },
+            t('tag.noReasoning'),
+          ),
+          OVERRIDE_EFFORTS.map((id) =>
+            h(
+              'button',
+              {
+                key: id,
+                type: 'button',
+                className: 'mvp_chip',
+                'aria-pressed': !noReasoning && efforts.has(id),
+                disabled: busy || noReasoning,
+                onClick: () => toggleIn(setEfforts, id),
+              },
+              effortLabel(id, t),
+            ),
+          ),
+        ),
+      ),
+      !noReasoning && efforts.size > 0
+        ? h(
+            'label',
+            { className: 'mvp_field' },
+            h('span', { className: 'mvp_fieldLabel' }, t('override.defaultEffort')),
+            h(
+              'select',
+              {
+                className: 'mvp_select',
+                value: selectedDefault,
+                'aria-label': t('override.defaultEffort'),
+                onChange: (event) => setDefaultEffort(event.target.value),
+              },
+              defaultOptions.map(([value, label]) => h('option', { key: value, value }, label)),
+            ),
+          )
+        : null,
+      h(
+        'div',
+        { className: 'mvp_field mvp_field--wide' },
+        h(
+          'label',
+          { className: 'mvp_check' },
+          h('input', {
+            type: 'checkbox',
+            checked: applyToProvider,
+            disabled: busy,
+            onChange: (event) => setApplyToProvider(event.target.checked),
+          }),
+          h('span', null, t('override.provider')),
+        ),
+        h('div', { className: 'mvp_editorNote' }, t('override.providerHint')),
+      ),
+    ),
+    error !== null ? h('div', { className: 'mvp_editorError', role: 'alert' }, error) : null,
+    h(
+      'div',
+      { className: 'mvp_editorFooter' },
+      h('div', { className: 'mvp_editorNote' }, t('override.effortHint')),
+      h(
+        'div',
+        { className: 'mvp_editorActions' },
+        h(
+          'button',
+          {
+            type: 'button',
+            className: 'mvp_button',
+            disabled: busy,
+            title: t('override.resetTitle'),
+            onClick: resetToAuto,
+          },
+          t('override.reset'),
+        ),
+        h(
+          'button',
+          { type: 'button', className: 'mvp_button', disabled: busy, onClick: onClose },
+          t('override.cancel'),
+        ),
+        h(
+          'button',
+          {
+            type: 'button',
+            className: 'mvp_button mvp_button--accent',
+            disabled: busy,
+            onClick: save,
+          },
+          t(busy ? 'override.saving' : 'override.save'),
+        ),
+      ),
+    ),
+  )
+    }
+
+export { ModelOverrideEditor, providerWriteNote }
+

package/client-src/pure.mjs

@@ -0,0 +1,136 @@
+/**
+ * Pure helpers that never touch React or the DOM, so `node --test` can call
+ * them directly.
+ *
+ * @module client-src/pure
+ */
+
+/** Number of one bucket's token sum, guarding partial buckets. */
+export function bucketTotalOf(buckets) {
+  if (!Array.isArray(buckets)) return 0
+  return buckets.reduce((sum, value) => sum + (Number.isFinite(value) ? value : 0), 0)
+}
+
+/** 1234567 → "1.2M"; 4096 → "4.1K"; 0/undefined → "0". */
+export function formatTokens(value) {
+  const tokens = Number.isFinite(value) ? value : 0
+  if (tokens >= 1_000_000) {
+    const millions = Math.round((tokens / 100_000)) / 10
+    return Number.isInteger(millions) ? `${millions}M` : millions.toFixed(1) + 'M'
+  }
+  if (tokens >= 1_000) {
+    const thousands = Math.round(tokens / 100) / 10
+    return Number.isInteger(thousands) ? `${thousands}K` : thousands.toFixed(1) + 'K'
+  }
+  return String(tokens)
+}
+
+/** Local-calendar `YYYY-MM-DD` stamp used by the ledger's day buckets. */
+export function dayKeyOf(time) {
+  const date = new Date(Number.isFinite(time) ? time : Date.now())
+  if (Number.isNaN(date.getTime())) return ''
+  return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`
+}
+
+/** First day (Monday) of the local ISO week of `time`. */
+export function weekKeyOf(time) {
+  const date = new Date(Number.isFinite(time) ? time : Date.now())
+  const weekday = (date.getDay() + 6) % 7
+  date.setDate(date.getDate() - weekday)
+  return dayKeyOf(date.getTime())
+}
+
+/** Local calendar month prefix of `time`. */
+export function monthPrefixOf(time) {
+  return dayKeyOf(time).slice(0, 7)
+}
+
+/**
+ * Apply the section's filters to one catalog.
+ *
+ * Mirrors the settings page exactly; the composer filter is a separate,
+ * simpler pass (visibility only). Inputs are the loaded groups plus the five
+ * filter axes; output keeps the group objects in order with only kept models.
+ */
+export function computeFilteredGroups(groups, { filter = 'all', query = '', multimodalOnly = false, reasoningOnly = false, minContext = 0 } = {}) {
+  const normalized = String(query ?? '').trim().toLowerCase()
+  const filtered = []
+  for (const group of groups ?? []) {
+    const models = []
+    for (const model of group.models ?? []) {
+      if (filter !== 'all' && bucket(model) !== filter) continue
+      if (normalized !== '') {
+        const name = String(model.name ?? '').toLowerCase()
+        const id = String(model.id ?? '').toLowerCase()
+        if (!name.includes(normalized) && !id.includes(normalized)) continue
+      }
+      if (multimodalOnly && !(Array.isArray(model.inputModalities) && model.inputModalities.includes('image'))) {
+        continue
+      }
+      if (reasoningOnly && model.reasoningSupported !== true) continue
+      if (minContext > 0 && !(Number.isFinite(model.contextWindow) && model.contextWindow >= minContext)) {
+        continue
+      }
+      models.push(model)
+    }
+    if (models.length > 0) filtered.push({ ...group, models })
+  }
+  return filtered
+}
+
+function bucket(model) {
+  const kind = model && typeof model.kind === 'string' && model.kind !== '' ? model.kind : 'chat'
+  if (kind === 'image') return 'image'
+  if (kind === 'video') return 'video'
+  if (kind === 'chat') return 'chat'
+  return 'other'
+}
+
+/** Counts per kind bucket for the whole list. */
+export function countKinds(models) {
+  const counts = { chat: 0, image: 0, video: 0, other: 0 }
+  for (const model of models ?? []) counts[bucket(model)] += 1
+  return counts
+}
+
+/** Checker-model candidates from a loaded catalog state. */
+export function checkerRoutesOf(groups) {
+  const routes = []
+  for (const group of groups ?? []) {
+    if (group === null || typeof group !== 'object') continue
+    const models = Array.isArray(group.models) ? group.models : []
+    if (models.length > 0) routes.push({ id: group.id, name: group.name ?? group.id })
+  }
+  return routes
+}
+
+/** Compact label + tooltip for one provider probe diagnostic. */
+export function probeOf(state, group, t) {
+  const list = Array.isArray(state.providers) ? state.providers : []
+  const diagnostic = list.find((item) => item && item.id === group.id)
+  if (diagnostic === undefined) return null
+  const details = [
+    diagnostic.host ? 'host: ' + diagnostic.host : null,
+    diagnostic.status ? 'status: ' + diagnostic.status : null,
+    diagnostic.message ? 'message: ' + diagnostic.message : null,
+    diagnostic.pricing && diagnostic.pricing !== 'skipped' ? 'pricing: ' + diagnostic.pricing : null,
+  ]
+    .filter(Boolean)
+    .join('\n')
+  if (diagnostic.status === 'ok') {
+    return {
+      label:
+        Number(diagnostic.capabilities) > 0
+          ? t('group.probeOk', {
+              models: diagnostic.models ?? 0,
+              caps: diagnostic.capabilities,
+            })
+          : t('group.probeNoCaps', { models: diagnostic.models ?? 0 }),
+      title: details,
+    }
+  }
+  if (diagnostic.status === 'failed' || diagnostic.status === 'unauthorized') {
+    return { label: t('group.probeFailed'), title: details }
+  }
+  return { label: t('group.probeSkipped'), title: details }
+}