@tzyc/dsh-model-visibility 0.0.0-stage → 1.9.0

package/lib/provider-write.js

@@ -0,0 +1,175 @@
+/**
+ * Write manual capabilities into the model provider's own settings.
+ *
+ * A manual override fixes what the page shows, but the composer, the adapter
+ * and every other reader still see the provider config. When the user edits a
+ * model here they usually mean "this is what the model really is", so this
+ * module mirrors the writable fields into the `llm-pi-ai` provider profile:
+ * `input`, `contextWindow` and `reasoningEfforts`.
+ *
+ * Only provider fields with an exact equivalent are written:
+ * - `kind` has no provider field (it is a display grouping);
+ * - `defaultEffort` is not per model in the provider schema (the route-level
+ *   `reasoning` default applies to a whole provider), so it stays local;
+ * - an off-only ladder is rejected by the provider schema ("offers no level
+ *   beyond off"), so it also stays local.
+ *
+ * The settings service exposes live, volatile provider configs; writing goes
+ * through `settings.mutate(ns, ops)` with explicit path ops so the existing
+ * `models` array entry is edited by index instead of being replaced wholesale
+ * (`modelOverrides` is illegal once a `models` list exists, so appending is not
+ * an option either).
+ *
+ * @module lib/provider-write
+ */
+
+/** Fields this module knows how to mirror into a provider profile. */
+export const PROVIDER_WRITE_FIELDS = ['input', 'contextWindow', 'reasoningEfforts']
+
+/** Plain-object guard. */
+function isRecord(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+/** Best-effort message from an unknown thrown value. */
+function messageOf(error) {
+  if (error === null || error === undefined) return undefined
+  if (typeof error === 'string') return error
+  if (typeof error.message === 'string') return error.message
+  return String(error)
+}
+
+/**
+ * Convert a manual ladder into the provider `reasoningEfforts` shape.
+ *
+ * `off` maps to `null` ("supported, send nothing"), every other level maps to
+ * its own id as the wire value. Returns undefined when there is nothing worth
+ * writing: an unset ladder, or one that only offers `off` (provider config
+ * rejects that as "offers no level beyond off").
+ * @param override - sanitized override entry.
+ * @returns a provider ladder, `false` for "no reasoning", or undefined.
+ */
+export function effortsForProvider(override) {
+  if (override?.reasoningSupported === false) return false
+  if (!Array.isArray(override?.efforts) || override.efforts.length === 0) return undefined
+  const ladder = {}
+  let beyondOff = false
+  for (const effort of override.efforts) {
+    const id = typeof effort === 'string' ? effort : effort?.id
+    if (typeof id !== 'string' || id === '') continue
+    if (id === 'off') ladder.off = null
+    else {
+      ladder[id] = id
+      beyondOff = true
+    }
+  }
+  return beyondOff ? ladder : undefined
+}
+
+/**
+ * The provider fields an override implies.
+ * @param override - sanitized override entry.
+ * @returns `{input?, contextWindow?, reasoningEfforts?}`; empty when nothing is writable.
+ */
+export function providerPatch(override) {
+  const patch = {}
+  if (Array.isArray(override?.input) && override.input.length > 0) patch.input = [...override.input]
+  if (Number.isSafeInteger(override?.contextWindow) && override.contextWindow > 0) {
+    patch.contextWindow = override.contextWindow
+  }
+  const efforts = effortsForProvider(override)
+  if (efforts !== undefined) patch.reasoningEfforts = efforts
+  return patch
+}
+
+/**
+ * Find the settings entry that owns one provider.
+ *
+ * Several settings namespaces can carry a `providers` dict (for example a test
+ * double or a future second adapter), so prefer the `llm-pi-ai` namespace and
+ * otherwise fall back to the first namespace that declares the provider.
+ * @param settings - the `settings` service.
+ * @param providerId - provider id from the override.
+ * @returns `{ns, models}` or undefined.
+ */
+export function findProviderEntry(settings, providerId) {
+  if (typeof settings?.describe !== 'function' || typeof providerId !== 'string') return undefined
+  const descriptors = settings.describe()
+  if (!Array.isArray(descriptors)) return undefined
+  const matches = []
+  for (const descriptor of descriptors) {
+    const providers = descriptor?.value?.providers
+    if (!isRecord(providers)) continue
+    const profile = providers[providerId]
+    if (!isRecord(profile)) continue
+    matches.push({
+      ns: descriptor.ns,
+      models: Array.isArray(profile.models) ? profile.models : undefined,
+      preferred: String(descriptor.ns ?? '').includes('pi-ai') ? 1 : 0,
+    })
+  }
+  if (matches.length === 0) return undefined
+  matches.sort((left, right) => right.preferred - left.preferred)
+  const best = matches[0]
+  return { ns: best.ns, models: best.models }
+}
+
+/**
+ * Mirror the writable parts of one override into the provider settings.
+ *
+ * Never throws: the caller keeps the local override when a write cannot happen,
+ * so a read-only profile or a probe-only install still behaves like before.
+ * @param settings - the `settings` service (needs `describe` and `mutate`).
+ * @param override - sanitized override entry.
+ * @returns `{written, fields, ns?, reason?, message?}`.
+ */
+export async function writeCapabilities(settings, override) {
+  const fields = Object.keys(providerPatch(override))
+  if (fields.length === 0) return { written: false, fields, reason: 'nothing' }
+  if (typeof settings?.mutate !== 'function' || typeof settings?.describe !== 'function') {
+    return { written: false, fields, reason: 'unsupported' }
+  }
+
+  let entry
+  try {
+    entry = findProviderEntry(settings, override.provider)
+  } catch (error) {
+    return { written: false, fields, reason: 'describe-failed', message: messageOf(error) }
+  }
+  if (entry === undefined) return { written: false, fields, reason: 'provider-missing' }
+  if (entry.models === undefined) return { written: false, fields, reason: 'models-missing' }
+
+  const index = entry.models.findIndex((model) => isRecord(model) && model.id === override.model)
+  if (index < 0) return { written: false, fields, reason: 'model-missing' }
+
+  const patch = providerPatch(override)
+  const path = ['providers', override.provider, 'models', String(index)]
+  const ops = fields.map((field) => ({ op: 'set', path: [...path, field], value: patch[field] }))
+  try {
+    await settings.mutate(entry.ns, ops)
+  } catch (error) {
+    return { written: false, fields, reason: 'settings-failed', message: messageOf(error) }
+  }
+  return { written: true, fields, ns: entry.ns }
+}
+
+/**
+ * Remove the fields that have just been mirrored into the provider config.
+ * @param override - sanitized override entry that was written.
+ * @param fields - fields reported as written.
+ * @returns the remaining local override (may contain only provider/model).
+ */
+export function stripWrittenFields(override, fields) {
+  const remaining = { provider: override.provider, model: override.model }
+  if (!fields.includes('input') && override.input !== undefined) remaining.input = override.input
+  if (!fields.includes('contextWindow') && override.contextWindow !== undefined) {
+    remaining.contextWindow = override.contextWindow
+  }
+  if (!fields.includes('reasoningEfforts')) {
+    if (override.efforts !== undefined) remaining.efforts = override.efforts
+    if (override.defaultEffort !== undefined) remaining.defaultEffort = override.defaultEffort
+    if (override.reasoningSupported === false) remaining.reasoningSupported = false
+  }
+  if (override.kind !== undefined) remaining.kind = override.kind
+  return remaining
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Model Visibility",
+    "description": "Choose which models appear in the chat composer's model list, toggle or collapse whole provider groups, and read each model's real capabilities (adapter declarations, relay model lists, built-in catalog, vendor corrections) with colour-coded image, video and embedding labels, plus a hard re-fetch of every model's modalities and reasoning efforts, manual per-model overrides for kind, context window, input modalities and effort levels (optionally written back into the model provider's settings), and an optional image-input alignment for relay routes."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "模型显示",
+    "description": "在设置里选择哪些模型出现在聊天输入框的模型列表中，按分组一键显示或隐藏，也可以整组折叠；每个模型标注真实能力（适配器声明、中转站模型列表、内置目录补全、厂商文档校正），生图 / 生视频等类型用不同颜色区分，支持强制重新获取全部模型的模态与思考强度，并可为任意模型手动指定类型、上下文、输入模态与思考强度档位（可同时写回模型提供商的设置）；还可选让输入框按能力标注实际放行图像。"
+  }
+}

package/package.json

@@ -1,6 +1,64 @@
-{
-  "name": "@tzyc/dsh-model-visibility",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@tzyc/dsh-model-visibility",
+  "version": "1.9.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "description": "Choose which models appear in the chat composer's model list, with per-provider groups, per-model capability tags sourced from the adapter, the relay model list, a built-in catalog, vendor corrections and manual overrides, separate coloured labels for image/video generation models, name search and capability filters, collapsible provider groups, a hard capability re-fetch, per-model overrides that can also be written back into the model provider's own settings, and an image-input alignment (on by default) for relay routes.",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "lib",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "screenshots.json",
+    "docs"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs",
+    "catalog": "node scripts/build-catalog.mjs"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-model-selection",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TZYCeng/dsh-model-visibility.git"
+  },
+  "homepage": "https://github.com/TZYCeng/dsh-model-visibility#readme",
+  "bugs": {
+    "url": "https://github.com/TZYCeng/dsh-model-visibility/issues"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "dsh",
+    "model-visibility",
+    "model-selector"
+  ],
+  "author": "TZYCeng",
+  "license": "MIT"
+}

package/screenshots.json

@@ -0,0 +1,4 @@
+[
+  "docs/settings-page.png",
+  "docs/capability-tags.png"
+]