@goodandready/dsh-model-sync 0.4.9 → 0.5.1

package/README.md

@@ -78,6 +78,9 @@ graph LR
 
 ## ✨ Key Features
 
+* 💰 **Built-in Reference Pricing Database**: Canonical token pricing database automatically enriches models for OpenAI, Anthropic, Groq, Mistral, xAI, and DeepSeek, enabling cost-limit filtering and `@cheap` auto-resolution even when upstream APIs omit pricing metadata.
+* 🎯 **Dynamic Smart Virtual Aliases & Auto-Fallback**: Route requests to virtual aliases like `@fast`, `@cheap`, and `@best-code`, with automatic fallback chains when circuit breakers open or health probes fail.
+* 🔔 **External Diff Webhooks & Event Dispatching**: Real-time webhook notifications with HMAC-SHA256 signature verification and Cordis `model-sync/diff` events when models are added, deprecated, or prices change.
 * ⚡ **High-Performance Policy Filtering**: Fast-path evaluation in `filterModels` bypasses regular expressions and array filtering when no filtering policy is configured, guaranteeing zero-overhead discovery runs.
 * 🔄 **One-Click In-App Updates**: Built-in update checker in Settings with automatic npm cache bypass on demand (`?fresh=1` / `Cache-Control: no-cache`), ensuring instantaneous discovery of new package releases.
 * 🔄 **Automated Catalog Discovery**: Syncs model lists, aliases, context windows, and capability flags (`vision`, `tools`, `reasoning`, `embeddings`) across 25+ providers.

package/README.ru.md

@@ -78,6 +78,9 @@ graph LR
 
 ## ✨ Ключевые возможности
 
+* 💰 **Встроенная база эталонных цен токенов**: Автоматическое обогащение моделей тарифами для OpenAI, Anthropic, Groq, Mistral, xAI и DeepSeek, обеспечивающее работу лимитов цен и псевдонима `@cheap` даже при отсутствии метаданных в API провайдера.
+* 🎯 **Динамические «умные» псевдонимы и авто-фоллбэк**: Поддержка виртуальных алиасов (`@fast`, `@cheap`, `@best-code`) и цепочек резервирования с автопереключением при размыкании Circuit Breaker.
+* 🔔 **Внешние Diff Webhooks и диспетчеризация событий**: Уведомления в реальном времени с проверкой подписи HMAC-SHA256 и событиями Cordis `model-sync/diff` при добавлении моделей, их устаревании или изменении цен.
 * ⚡ **Высокопроизводительная фильтрация моделей**: Быстрый путь (`fast-path`) в `filterModels` мгновенно возвращает каталог при отсутствии активных правил политики, исключая лишнюю компиляцию regex и прогоны массивов.
 * 🔄 **Обновление плагина в один клик**: Встроенный механизм проверки обновлений в Настройках со сбросом кэша npm при ручном запросе (`?fresh=1` / `Cache-Control: no-cache`), гарантирующий получение актуальной версии.
 * 🔄 **Автоматическое обнаружение каталога**: синхронизация списков моделей, алиасов, контекстных окон и флагов возможностей (`vision`, `tools`, `reasoning`, `embeddings`) для 25+ провайдеров.

package/README.zh.md

@@ -78,6 +78,9 @@ graph LR
 
 ## ✨ 核心特性
 
+* 💰 **内置基准价格数据库**：自动为 OpenAI、Anthropic、Groq、Mistral、xAI 和 DeepSeek 模型补充 Token 价格数据，即使服务商接口未返回价格，也可无缝支持成本上限过滤与 `@cheap` 别名解析。
+* 🎯 **动态智能虚拟别名与故障转移**：支持 `@fast`、`@cheap`、`@best-code` 等虚拟别名及故障转移链，在熔断器打开或健康检查失败时自动切换至备用模型。
+* 🔔 **外部差异通知 Webhook 与事件分发**：支持 HMAC-SHA256 签名验证的实时 Webhook 通知与 Cordis `model-sync/diff` 事件，可在新模型上线、模型废弃或价格变更时即时推送。
 * ⚡ **高性能模型策略过滤**：在未配置过滤策略时，`filterModels` 采用快速路径直接返回模型目录，避免不必要的正则表达式编译和数组遍历。
 * 🔄 **一键检查与更新**：内置设置面板更新检查，在手动刷新时通过 `?fresh=1` 或 `Cache-Control: no-cache` 绕过 npm 缓存，即时获取最新版本。
 * 🔄 **自动化目录同步**：自动对齐 25+ 服务商的模型清单、别名、上下文窗口及能力标签（`vision`、`tools`、`reasoning`、`embeddings`）。

package/lib/alias-resolver.js

@@ -0,0 +1,216 @@
+export const VIRTUAL_STRATEGIES = Object.freeze(['fastest', 'cheapest', 'best-code'])
+
+export function isVirtualAlias(name) {
+  if (typeof name !== 'string') return false
+  const clean = name.trim().toLowerCase()
+  return clean === '@fast' || clean === '@cheap' || clean === '@best-code' || clean.startsWith('@')
+}
+
+export function validateAliasName(name) {
+  if (typeof name !== 'string') return false
+  const clean = name.trim()
+  return /^@?[a-zA-Z0-9_\-.]{1,64}$/.test(clean)
+}
+
+function modelScoreForCode(provider, model) {
+  let score = 0
+  const id = String(model?.id ?? '').toLowerCase()
+  const name = String(model?.name ?? '').toLowerCase()
+
+  if (model?.capabilities?.code) score += 100
+  if (model?.capabilities?.reasoning) score += 50
+
+  if (id.includes('claude-3-7-sonnet') || id.includes('claude-3-5-sonnet') || id.includes('claude-3.5-sonnet')) score += 200
+  else if (id.includes('o3') || id.includes('o1') || id.includes('gpt-4o')) score += 180
+  else if (id.includes('deepseek-r1') || id.includes('deepseek-v3') || id.includes('deepseek-coder')) score += 170
+  else if (id.includes('qwen-2.5-coder') || id.includes('qwen2.5-coder') || id.includes('qwen-coder')) score += 160
+  else if (id.includes('codestral') || id.includes('devin') || id.includes('code')) score += 120
+
+  if (model?.contextWindow && model.contextWindow >= 128000) score += 20
+  return score
+}
+
+function estimateLatency(provider, model, probes = {}) {
+  const key = String(provider) + ':' + String(model.id)
+  if (probes[key]?.latencyMs && Number.isFinite(probes[key].latencyMs)) {
+    return probes[key].latencyMs
+  }
+  let base = 800
+  const prov = String(provider).toLowerCase()
+  if (prov === 'groq' || prov === 'cerebras') base = 120
+  else if (prov === 'fireworks') base = 250
+  else if (prov === 'together') base = 350
+  else if (prov === 'deepseek') base = 400
+  else if (prov === 'openai') base = 500
+
+  const id = String(model.id).toLowerCase()
+  if (id.includes('flash') || id.includes('instant') || id.includes('turbo') || id.includes('haiku')) base *= 0.6
+  if (id.includes('mini') || id.includes('8b') || id.includes('7b')) base *= 0.7
+  if (id.includes('reasoning') || id.includes('r1') || id.includes('o1')) base *= 2.5
+  return Math.round(base)
+}
+
+export function resolveAlias(aliasName, {
+  aliases = {},
+  modelCatalogs = {},
+  healthResults = [],
+  isCircuitOpen = () => false,
+  modelProbes = {},
+} = {}) {
+  if (typeof aliasName !== 'string' || !aliasName.trim()) {
+    throw Object.assign(new Error('alias name is required'), { code: 'INVALID_ALIAS' })
+  }
+  const clean = aliasName.trim()
+  const custom = aliases[clean]
+
+  // 1. Fallback chain alias
+  if (custom?.targets && Array.isArray(custom.targets) && custom.targets.length > 0) {
+    const skipped = []
+    for (let i = 0; i < custom.targets.length; i++) {
+      const target = custom.targets[i]
+      const circuitBlocked = isCircuitOpen(target.provider)
+      const healthFail = healthResults.find((h) => h.provider === target.provider && h.status === 'error')
+      if (circuitBlocked || healthFail) {
+        skipped.push({ ...target, reason: circuitBlocked ? 'circuit_open' : 'health_failed' })
+        continue
+      }
+      return {
+        alias: clean,
+        provider: target.provider,
+        model: target.model,
+        fallbackUsed: i > 0,
+        index: i,
+        skipped,
+        reason: i > 0 ? 'fallback_selected' : 'primary_healthy',
+      }
+    }
+    // All targets had issues, return first as best-effort with warning
+    return {
+      alias: clean,
+      provider: custom.targets[0].provider,
+      model: custom.targets[0].model,
+      fallbackUsed: true,
+      warning: 'all_targets_unhealthy',
+      skipped,
+    }
+  }
+
+  // 2. Static explicit alias
+  if (custom?.provider && custom?.model && !custom.strategy) {
+    const circuitBlocked = isCircuitOpen(custom.provider)
+    return {
+      alias: clean,
+      provider: custom.provider,
+      model: custom.model,
+      fallbackUsed: false,
+      ...(circuitBlocked ? { warning: 'circuit_open', circuitOpen: true } : {}),
+    }
+  }
+
+  // 3. Strategy resolution (@fast, @cheap, @best-code or custom.strategy)
+  let strategy = custom?.strategy
+  const lower = clean.toLowerCase()
+  if (!strategy && isVirtualAlias(clean)) {
+    if (lower === '@fast') strategy = 'fastest'
+    else if (lower === '@cheap') strategy = 'cheapest'
+    else if (lower === '@best-code') strategy = 'best-code'
+  }
+
+  if (strategy) {
+    if (!VIRTUAL_STRATEGIES.includes(strategy)) {
+      throw Object.assign(new Error(`Invalid strategy: ${strategy}`), { code: 'INVALID_STRATEGY' })
+    }
+    const available = []
+    for (const [provider, models] of Object.entries(modelCatalogs)) {
+      if (isCircuitOpen(provider)) continue
+      if (!Array.isArray(models)) continue
+      for (const m of models) {
+        if (!m?.id) continue
+        available.push({ provider, model: m })
+      }
+    }
+
+    if (available.length === 0) {
+      return { alias: clean, strategy, resolved: null, error: 'NO_HEALTHY_MODELS' }
+    }
+
+    if (strategy === 'fastest') {
+      const scored = available.map((item) => ({
+        ...item,
+        latencyMs: estimateLatency(item.provider, item.model, modelProbes),
+      }))
+      scored.sort((a, b) => a.latencyMs - b.latencyMs)
+      const best = scored[0]
+      return {
+        alias: clean,
+        strategy: 'fastest',
+        provider: best.provider,
+        model: best.model.id,
+        name: best.model.name || best.model.id,
+        latencyMs: best.latencyMs,
+        fallbackUsed: false,
+        reason: 'lowest_latency',
+      }
+    }
+
+    if (strategy === 'cheapest') {
+      const priced = available.filter((item) => {
+        const p = item.model?.pricing
+        return p && (Number.isFinite(p.inputPerToken) || Number.isFinite(p.outputPerToken))
+      }).map((item) => {
+        const p = item.model.pricing
+        const cost = (p.inputPerToken || 0) + (p.outputPerToken || 0)
+        return { ...item, cost }
+      })
+
+      if (priced.length > 0) {
+        priced.sort((a, b) => a.cost - b.cost)
+        const best = priced[0]
+        return {
+          alias: clean,
+          strategy: 'cheapest',
+          provider: best.provider,
+          model: best.model.id,
+          name: best.model.name || best.model.id,
+          pricing: best.model.pricing,
+          costPerToken: best.cost,
+          fallbackUsed: false,
+          reason: 'lowest_price',
+        }
+      }
+      // If no pricing metadata available, pick a mini/flash model as fallback
+      const fallback = available.find((a) => /(mini|flash|small|lite)/i.test(a.model.id)) || available[0]
+      return {
+        alias: clean,
+        strategy: 'cheapest',
+        provider: fallback.provider,
+        model: fallback.model.id,
+        name: fallback.model.name || fallback.model.id,
+        fallbackUsed: true,
+        reason: 'heuristic_cheapest_fallback',
+      }
+    }
+
+    if (strategy === 'best-code') {
+      const scored = available.map((item) => ({
+        ...item,
+        score: modelScoreForCode(item.provider, item.model),
+      }))
+      scored.sort((a, b) => b.score - a.score)
+      const best = scored[0]
+      return {
+        alias: clean,
+        strategy: 'best-code',
+        provider: best.provider,
+        model: best.model.id,
+        name: best.model.name || best.model.id,
+        capabilities: best.model.capabilities,
+        score: best.score,
+        fallbackUsed: false,
+        reason: 'top_coding_capability',
+      }
+    }
+  }
+
+  throw Object.assign(new Error("Unknown alias: " + clean), { code: 'UNKNOWN_ALIAS' })
+}

package/lib/client.js

@@ -5,6 +5,14 @@ window.__ModuleLoader__.load({
     var exports = module.exports
     const React = require('react')
 
+    let ChevronIcon = null
+    try {
+      const primitives = require('@deepseek-ai/dsh-client-ui-primitives')
+      ChevronIcon = primitives && primitives.IconChevronDownOutline14
+    } catch {
+      /* Optional core chevron primitive not available; SVG fallback used */
+    }
+
     const CSS = '.dms-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none;margin:0;padding:0;overflow:hidden;box-sizing:border-box}' +
       '.dms-card-open{background:var(--dsw-alias-bg-layer-3);border-color:var(--dsw-alias-border-l2)}' +
       '.dms-card-header{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;display:flex;align-items:center;gap:12px;padding:14px 16px}' +
@@ -202,6 +210,18 @@ window.__ModuleLoader__.load({
       scheduleEnabled: 'Enable background schedule',
       intervalMinutes: 'Interval (minutes)',
       autoApplySchedule: 'Auto-apply changes',
+      diffWebhooks: 'External Diff Webhooks',
+      diffWebhookUrl: 'Webhook URL',
+      diffWebhookSecret: 'Webhook Secret (optional)',
+      notifyOnModelAdded: 'Notify on new models',
+      notifyOnModelDeprecated: 'Notify on deprecated / removed models',
+      notifyOnPriceChanged: 'Notify on price changes',
+      saveWebhook: 'Save Webhook Settings',
+      testWebhook: 'Test Webhook',
+      webhookTesting: 'Testing...',
+      webhookSuccess: 'Webhook test succeeded',
+      webhookFailed: 'Webhook test failed: %s',
+      webhookSaved: 'Webhook settings saved',
       saveScheduler: 'Save scheduler',
       schedulerSaved: 'Saved',
       scopeUnavailable: 'Settings service unavailable.',
@@ -222,6 +242,13 @@ window.__ModuleLoader__.load({
       importError: 'Import failed: %s',
       importPlaceholder: 'Paste JSON configuration here…',
       modelAliases: 'Model Aliases',
+      virtualAliases: 'Virtual Smart Aliases',
+      resolveAlias: 'Test Resolve',
+      resolvingAlias: 'Resolving...',
+      virtualAliasDesc: 'Dynamic aliases route to optimal models based on latency, pricing, and health probes.',
+      aliasFastDesc: 'Fastest response time among healthy models',
+      aliasCheapDesc: 'Lowest token pricing available',
+      aliasBestCodeDesc: 'Top coding & reasoning capabilities',
       aliasPlaceholder: 'Alias (e.g. gpt-4o-latest)',
       targetModel: 'Target model',
       addAlias: 'Save alias',
@@ -333,6 +360,18 @@ window.__ModuleLoader__.load({
       scheduleEnabled: '开启后台定时同步',
       intervalMinutes: '间隔时间（分钟）',
       autoApplySchedule: '自动应用变更',
+      diffWebhooks: '外部差异通知 Webhook',
+      diffWebhookUrl: 'Webhook 地址',
+      diffWebhookSecret: 'Webhook 密钥（可选）',
+      notifyOnModelAdded: '新模型添加时通知',
+      notifyOnModelDeprecated: '模型废弃/移除时通知',
+      notifyOnPriceChanged: '模型价格变更时通知',
+      saveWebhook: '保存 Webhook 设置',
+      testWebhook: '测试 Webhook',
+      webhookTesting: '正在测试...',
+      webhookSuccess: 'Webhook 测试成功',
+      webhookFailed: 'Webhook 测试失败：%s',
+      webhookSaved: 'Webhook 设置已保存',
       saveScheduler: '保存计划',
       schedulerSaved: '已保存',
       scopeUnavailable: '设置服务不可用。',
@@ -353,6 +392,13 @@ window.__ModuleLoader__.load({
       importError: '导入失败：%s',
       importPlaceholder: '在此粘贴 JSON 配置内容…',
       modelAliases: '模型别名映射',
+      virtualAliases: '智能虚拟别名',
+      resolveAlias: '解析测试',
+      resolvingAlias: '正在解析...',
+      virtualAliasDesc: '动态别名根据实时延迟、定价与可用性探测动态路由至最优模型。',
+      aliasFastDesc: '所有健康模型中响应延迟最低',
+      aliasCheapDesc: 'Token 单价最低的可用模型',
+      aliasBestCodeDesc: '代码与推理能力评分最优',
       aliasPlaceholder: '别名（例如 gpt-4o-latest）',
       targetModel: '目标模型',
       addAlias: '保存别名',
@@ -519,6 +565,8 @@ window.__ModuleLoader__.load({
       const [aliasDraft, setAliasDraft] = React.useState({ alias: '', provider: '', model: '' })
       const [aliasMsg, setAliasMsg] = React.useState('')
       const [aliasErr, setAliasErr] = React.useState('')
+      const [resolvedAliases, setResolvedAliases] = React.useState({})
+      const [resolvingKey, setResolvingKey] = React.useState('')
 
       const [importText, setImportText] = React.useState('')
       const [importMsg, setImportMsg] = React.useState('')
@@ -534,6 +582,10 @@ window.__ModuleLoader__.load({
       const snapStatus = snapshot?.status || 'loading'
       const stored = snapshot?.value || {}
       const [schedDraft, setSchedDraft] = React.useState(null)
+      const [webhookDraft, setWebhookDraft] = React.useState(null)
+      const [webhookMsg, setWebhookMsg] = React.useState('')
+      const [webhookErr, setWebhookErr] = React.useState('')
+      const [webhookTesting, setWebhookTesting] = React.useState(false)
       const [schedMsg, setSchedMsg] = React.useState('')
       const [schedErr, setSchedErr] = React.useState('')
 
@@ -543,6 +595,48 @@ window.__ModuleLoader__.load({
         }
       }, [snapStatus, stored, schedDraft])
 
+      const saveWebhook = async () => {
+        if (!scope || !webhookDraft) return
+        setBusy(true); setWebhookErr(''); setWebhookMsg('')
+        try {
+          await scope.set('diffWebhookUrl', webhookDraft.diffWebhookUrl || '')
+          await scope.set('diffWebhookSecret', webhookDraft.diffWebhookSecret || '')
+          await scope.set('notifyOnModelAdded', !!webhookDraft.notifyOnModelAdded)
+          await scope.set('notifyOnModelDeprecated', !!webhookDraft.notifyOnModelDeprecated)
+          await scope.set('notifyOnPriceChanged', !!webhookDraft.notifyOnPriceChanged)
+          setWebhookMsg(t.webhookSaved)
+        } catch (e) {
+          setWebhookErr(String(e?.message ?? e))
+        } finally {
+          setBusy(false)
+        }
+      }
+
+      const testWebhook = async () => {
+        if (!webhookDraft?.diffWebhookUrl) return
+        setWebhookTesting(true); setWebhookErr(''); setWebhookMsg('')
+        try {
+          const res = await fetch(`${API}/webhook/test`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({
+              url: webhookDraft.diffWebhookUrl,
+              secret: webhookDraft.diffWebhookSecret || '',
+            }),
+          })
+          const body = await res.json()
+          if (res.ok && body.ok) {
+            setWebhookMsg(t.webhookSuccess)
+          } else {
+            setWebhookErr((t.webhookFailed || 'Webhook test failed: %s').replace('%s', body.error || `HTTP ${body.status || res.status}`))
+          }
+        } catch (e) {
+          setWebhookErr((t.webhookFailed || 'Webhook test failed: %s').replace('%s', String(e?.message ?? e)))
+        } finally {
+          setWebhookTesting(false)
+        }
+      }
+
       const saveScheduler = async () => {
         if (!scope || !schedDraft) return
         setBusy(true); setSchedErr(''); setSchedMsg('')
@@ -918,6 +1012,55 @@ window.__ModuleLoader__.load({
       const visibleChoices = filteredChoices.slice(0, pageSize)
       const button = (label, onClick, variant) => React.createElement('button', { type: 'button', disabled: busy, onClick, className: 'dms-btn' + (variant ? ' dms-btn-' + variant : '') }, label)
 
+
+      const renderWebhooks = () => {
+        return React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 8, width: '100%' } },
+          snapStatus === 'loading' ? React.createElement('small', null, t.loading) : null,
+          snapStatus === 'unavailable' ? React.createElement('small', { style: { color: 'var(--dsw-alias-label-secondary)' } }, t.scopeUnavailable) : null,
+          webhookDraft ? React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 8, marginTop: 4 } },
+            React.createElement('label', { style: { display: 'flex', alignItems: 'center', gap: 7, fontSize: 12 } },
+              React.createElement('span', { style: { minWidth: 160 } }, t.diffWebhookUrl + ':'),
+              React.createElement('input', {
+                type: 'url',
+                placeholder: 'https://example.com/webhook',
+                value: webhookDraft.diffWebhookUrl,
+                onChange: (e) => setWebhookDraft((d) => ({ ...d, diffWebhookUrl: e.target.value })),
+                disabled: busy || webhookTesting,
+                style: { flex: '1 1 240px', padding: '4px 8px', borderRadius: 6, border: '1px solid var(--dsw-alias-border-l2)', background: 'var(--dsw-alias-bg-layer-2)', color: 'inherit' }
+              })
+            ),
+            React.createElement('label', { style: { display: 'flex', alignItems: 'center', gap: 7, fontSize: 12 } },
+              React.createElement('span', { style: { minWidth: 160 } }, t.diffWebhookSecret + ':'),
+              React.createElement('input', {
+                type: 'password',
+                placeholder: '••••••••',
+                value: webhookDraft.diffWebhookSecret,
+                onChange: (e) => setWebhookDraft((d) => ({ ...d, diffWebhookSecret: e.target.value })),
+                disabled: busy || webhookTesting,
+                style: { flex: '1 1 240px', padding: '4px 8px', borderRadius: 6, border: '1px solid var(--dsw-alias-border-l2)', background: 'var(--dsw-alias-bg-layer-2)', color: 'inherit' }
+              })
+            ),
+            React.createElement('label', { style: { display: 'flex', alignItems: 'center', gap: 7, fontSize: 12, cursor: 'pointer' } },
+              React.createElement('input', { type: 'checkbox', checked: !!webhookDraft.notifyOnModelAdded, onChange: (e) => setWebhookDraft((d) => ({ ...d, notifyOnModelAdded: e.target.checked })), disabled: busy }),
+              t.notifyOnModelAdded
+            ),
+            React.createElement('label', { style: { display: 'flex', alignItems: 'center', gap: 7, fontSize: 12, cursor: 'pointer' } },
+              React.createElement('input', { type: 'checkbox', checked: !!webhookDraft.notifyOnModelDeprecated, onChange: (e) => setWebhookDraft((d) => ({ ...d, notifyOnModelDeprecated: e.target.checked })), disabled: busy }),
+              t.notifyOnModelDeprecated
+            ),
+            React.createElement('label', { style: { display: 'flex', alignItems: 'center', gap: 7, fontSize: 12, cursor: 'pointer' } },
+              React.createElement('input', { type: 'checkbox', checked: !!webhookDraft.notifyOnPriceChanged, onChange: (e) => setWebhookDraft((d) => ({ ...d, notifyOnPriceChanged: e.target.checked })), disabled: busy }),
+              t.notifyOnPriceChanged
+            ),
+            React.createElement('div', { style: { display: 'flex', alignItems: 'center', gap: 8, marginTop: 4 } },
+              button(t.saveWebhook, saveWebhook, 'primary'),
+              button(webhookTesting ? t.webhookTesting : t.testWebhook, testWebhook, 'secondary'),
+              webhookMsg ? React.createElement('small', { style: { color: 'var(--dsw-alias-state-success-primary)' } }, webhookMsg) : null,
+              webhookErr ? React.createElement('small', { style: { color: 'var(--dsw-alias-state-error-primary)' } }, webhookErr) : null
+            )
+          ) : null
+        )
+      }
       const renderNotifications = () => {
         const entries = status?.notifications ?? []
         if (entries.length === 0) return React.createElement('small', { style: { display: 'block', marginTop: 6 } }, t.noNotifications)
@@ -945,12 +1088,37 @@ window.__ModuleLoader__.load({
       const renderAliases = () => {
         const aliasMap = status?.aliases ?? {}
         const entries = Object.entries(aliasMap)
-        return React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 8, width: '100%' } },
+        const smartPresets = [
+          { name: '@fast', label: t.aliasFastDesc },
+          { name: '@cheap', label: t.aliasCheapDesc },
+          { name: '@best-code', label: t.aliasBestCodeDesc },
+        ]
+
+        return React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 10, width: '100%' } },
+          React.createElement('div', { style: { fontSize: 12, color: 'var(--dsw-alias-label-secondary)', marginBottom: 2 } }, t.virtualAliasDesc),
+          React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 6 } },
+            smartPresets.map((p) => {
+              const res = resolvedAliases[p.name]
+              const isResolving = resolvingKey === p.name
+              return React.createElement('div', { key: p.name, style: { display: 'flex', flexDirection: 'column', gap: 4, padding: '8px 10px', border: '1px solid var(--dsw-alias-border-l2)', borderRadius: 6, background: 'var(--dsw-alias-bg-layer-2)' } },
+                React.createElement('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center' } },
+                  React.createElement('div', { style: { display: 'flex', gap: 8, alignItems: 'center' } },
+                    React.createElement('strong', { style: { fontFamily: 'monospace', fontSize: 13, color: 'var(--dsw-alias-state-brand-primary)' } }, p.name),
+                    React.createElement('span', { style: { fontSize: 12, color: 'var(--dsw-alias-label-secondary)' } }, p.label)
+                  ),
+                  button(isResolving ? t.resolvingAlias : t.resolveAlias, () => resolveSmartAlias(p.name), 'secondary')
+                ),
+                res ? (res.error ? React.createElement('small', { style: { color: 'var(--dsw-alias-state-error-primary)' } }, res.error)
+                  : React.createElement('small', { style: { color: 'var(--dsw-alias-state-success-primary)' } }, `→ ${res.provider} / ${res.model} (${res.reason || res.strategy}${res.latencyMs ? ` · ${res.latencyMs}ms` : ''})`)) : null
+              )
+            })
+          ),
           entries.length === 0 ? React.createElement('small', { style: { display: 'block', marginTop: 4 } }, t.noAliases) : entries.map(([aliasName, data]) => {
+            const targetText = data.targets ? `${data.targets.length} fallback targets` : data.strategy ? `strategy: ${data.strategy}` : `${data.provider} / ${data.model}`
             return React.createElement('div', { key: aliasName, className: 'dms-row', style: { justifyContent: 'space-between', padding: '6px 10px', border: '1px solid var(--dsw-alias-border-l2)', borderRadius: 6, background: 'var(--dsw-alias-bg-layer-2)' } },
               React.createElement('div', { style: { display: 'flex', gap: 8, alignItems: 'center' } },
                 React.createElement('strong', { style: { fontFamily: 'monospace', fontSize: 13 } }, aliasName),
-                React.createElement('span', { style: { color: 'var(--dsw-alias-label-secondary)', fontSize: 12 } }, `→ ${data.provider} / ${data.model}`)
+                React.createElement('span', { style: { color: 'var(--dsw-alias-label-secondary)', fontSize: 12 } }, `→ ${targetText}`)
               ),
               button(t.removeAlias, () => deleteAlias(aliasName), 'danger')
             )
@@ -1212,6 +1380,10 @@ window.__ModuleLoader__.load({
           React.createElement('div', { className: 'dms-section-title' }, React.createElement('strong', null, t.notifications)),
           renderNotifications()
         ),
+        React.createElement('div', { className: 'dms-section-card dms-section' },
+          React.createElement('div', { className: 'dms-section-title' }, React.createElement('strong', null, t.diffWebhooks)),
+          renderWebhooks()
+        ),
         React.createElement('div', { className: 'dms-section-card dms-section' },
           React.createElement('div', { className: 'dms-section-title' }, React.createElement('strong', null, t.credentials)),
           credentialStatus === null ? React.createElement('small', { style: { display: 'block', marginTop: 6 } }, t.loading) : (credentialStatus.results ?? []).length === 0 ? React.createElement('small', { style: { display: 'block', marginTop: 6 } }, t.noProviders) : (credentialStatus.results ?? []).map((item) => React.createElement('div', { key: item.provider, style: { marginTop: 6 } }, React.createElement('span', null, `${item.provider}: ${item.rotation?.configured ? `${item.rotation.keyCount} refs` : 'single ref'}${item.lastRequest ? ` · ${item.lastRequest.status}` : ''}`), (item.refs ?? []).map((ref) => React.createElement('small', { key: ref.ref || ref.label, style: { display: 'block', marginLeft: 12 } }, `${ref.order}. ${ref.label} · ${ref.configured === true ? t.credentialReady : t.missingCredential}${ref.source && ref.source !== 'unknown' ? ` · ${ref.source}` : ''}${ref.lastResolution?.status ? ` · ${ref.lastResolution.status}` : ''}`))))
@@ -1261,9 +1433,11 @@ window.__ModuleLoader__.load({
             React.createElement('span', { className: 'dms-card-description' }, t.desc)
           ),
           cardBadge ? React.createElement('span', { style: { background: 'var(--dsw-alias-state-business-primary)', color: 'white', padding: '2px 6px', borderRadius: 6, fontSize: 11, marginLeft: 8 } }, `+${cardBadge}`) : null,
-          React.createElement('svg', { width: 14, height: 14, className: 'dms-card-chevron' + (open ? ' dms-card-chevron-open' : ''), viewBox: '0 0 14 14', fill: 'none', 'aria-hidden': 'true' },
-            React.createElement('path', { d: 'M11.8486 5.5L11.4238 5.92383L8.69727 8.65137C8.44157 8.90706 8.21562 9.13382 8.01172 9.29785C7.79912 9.46883 7.55595 9.61756 7.25 9.66602C7.08435 9.69222 6.91565 9.69222 6.75 9.66602C6.44405 9.61756 6.20088 9.46883 5.98828 9.29785C5.78438 9.13382 5.55843 8.90706 5.30273 8.65137L2.57617 5.92383L2.15137 5.5L3 4.65137L3.42383 5.07617L6.15137 7.80273C6.42595 8.07732 6.59876 8.24849 6.74023 8.3623C6.87291 8.46904 6.92272 8.47813 6.9375 8.48047C6.97895 8.48703 7.02105 8.48703 7.0625 8.48047C7.07728 8.47813 7.12709 8.46904 7.25977 8.3623C7.40124 8.24849 7.57405 8.07732 7.84863 7.80273L10.5762 5.07617L11 4.65137L11.8486 5.5', fill: 'currentColor' })
-          )
+          ChevronIcon
+            ? React.createElement(ChevronIcon, { width: 14, height: 14, className: 'dms-card-chevron' + (open ? ' dms-card-chevron-open' : ''), 'aria-hidden': 'true' })
+            : React.createElement('svg', { width: 14, height: 14, className: 'dms-card-chevron' + (open ? ' dms-card-chevron-open' : ''), viewBox: '0 0 14 14', fill: 'none', 'aria-hidden': 'true' },
+                React.createElement('path', { d: 'M11.8486 5.5L11.4238 5.92383L8.69727 8.65137C8.44157 8.90706 8.21562 9.13382 8.01172 9.29785C7.79912 9.46883 7.55595 9.61756 7.25 9.66602C7.08435 9.69222 6.91565 9.69222 6.75 9.66602C6.44405 9.61756 6.20088 9.46883 5.98828 9.29785C5.78438 9.13382 5.55843 8.90706 5.30273 8.65137L2.57617 5.92383L2.15137 5.5L3 4.65137L3.42383 5.07617L6.15137 7.80273C6.42595 8.07732 6.59876 8.24849 6.74023 8.3623C6.87291 8.46904 6.92272 8.47813 6.9375 8.48047C6.97895 8.48703 7.02105 8.48703 7.0625 8.48047C7.07728 8.47813 7.12709 8.46904 7.25977 8.3623C7.40124 8.24849 7.57405 8.07732 7.84863 7.80273L10.5762 5.07617L11 4.65137L11.8486 5.5', fill: 'currentColor' })
+              )
         ),
         (page || open) ? React.createElement('div', { className: 'dms-card-body' }, React.createElement(ErrorBoundary, null, React.createElement(ModelSyncSection, { ctx, includeIntro: false }))) : null
       )

package/lib/diff-notifier.js

@@ -0,0 +1,196 @@
+import { createHmac } from "node:crypto"
+
+export function extractDiffEvents(results, options = {}) {
+  const notifyOnModelAdded = options.notifyOnModelAdded !== false
+  const notifyOnModelDeprecated = options.notifyOnModelDeprecated !== false
+  const notifyOnPriceChanged = options.notifyOnPriceChanged !== false
+
+  const added = []
+  const deprecated = []
+  const priceChanged = []
+
+  const rows = Array.isArray(results) ? results : []
+  for (const row of rows) {
+    const provider = String(row?.provider ?? "")
+    const diff = row?.diff ?? {}
+
+    if (notifyOnModelAdded && Array.isArray(diff.added)) {
+      for (const model of diff.added) {
+        if (!model?.id) continue
+        added.push({
+          provider,
+          id: model.id,
+          name: model.name || model.id,
+          ...(model.contextWindow !== undefined ? { contextWindow: model.contextWindow } : {}),
+          ...(model.pricing ? { pricing: model.pricing } : {}),
+        })
+      }
+    }
+
+    if (notifyOnModelDeprecated) {
+      if (Array.isArray(diff.removed)) {
+        for (const model of diff.removed) {
+          if (!model?.id) continue
+          deprecated.push({
+            provider,
+            id: model.id,
+            name: model.name || model.id,
+            reason: "removed",
+          })
+        }
+      }
+      if (Array.isArray(diff.changed)) {
+        for (const pair of diff.changed) {
+          const beforeDep = pair?.before?.lifecycle?.deprecated === true
+          const afterDep = pair?.after?.lifecycle?.deprecated === true
+          const beforeDate = pair?.before?.lifecycle?.deprecationDate
+          const afterDate = pair?.after?.lifecycle?.deprecationDate
+          if ((afterDep && !beforeDep) || (afterDate && afterDate !== beforeDate)) {
+            deprecated.push({
+              provider,
+              id: pair.after.id,
+              name: pair.after.name || pair.after.id,
+              reason: "deprecated",
+              ...(afterDate ? { deprecationDate: afterDate } : {}),
+            })
+          }
+        }
+      }
+      if (Array.isArray(row?.stale)) {
+        for (const model of row.stale) {
+          if (!model?.id) continue
+          deprecated.push({
+            provider,
+            id: model.id,
+            name: model.name || model.id,
+            reason: "stale",
+          })
+        }
+      }
+    }
+
+    if (notifyOnPriceChanged && Array.isArray(diff.changed)) {
+      for (const pair of diff.changed) {
+        const bp = pair?.before?.pricing
+        const ap = pair?.after?.pricing
+        if (bp || ap) {
+          const inputDiff = bp?.inputPerToken !== ap?.outputPerToken && bp?.inputPerToken !== ap?.inputPerToken
+          const outputDiff = bp?.outputPerToken !== ap?.outputPerToken
+          if (inputDiff || outputDiff) {
+            priceChanged.push({
+              provider,
+              id: pair.after.id,
+              name: pair.after.name || pair.after.id,
+              oldPricing: bp || null,
+              newPricing: ap || null,
+            })
+          }
+        }
+      }
+    }
+  }
+
+  return {
+    hasEvents: added.length > 0 || deprecated.length > 0 || priceChanged.length > 0,
+    timestamp: Date.now(),
+    counts: {
+      added: added.length,
+      deprecated: deprecated.length,
+      priceChanged: priceChanged.length,
+    },
+    added,
+    deprecated,
+    priceChanged,
+  }
+}
+
+export async function sendWebhookNotification(url, secret, payload, { fetchImpl = globalThis.fetch, timeoutMs = 5000 } = {}) {
+  if (typeof url !== "string" || !url.trim()) {
+    return { ok: false, error: "URL is required" }
+  }
+  let parsedUrl
+  try {
+    parsedUrl = new URL(url.trim())
+    if (parsedUrl.protocol !== "http:" && parsedUrl.protocol !== "https:") {
+      return { ok: false, error: "URL must use http or https protocol" }
+    }
+  } catch (err) {
+    return { ok: false, error: "Invalid URL: " + (err?.message || String(err)) }
+  }
+
+  const body = JSON.stringify(payload)
+  const headers = {
+    "content-type": "application/json",
+    "user-agent": "dsh-model-sync/diff-notifier",
+  }
+  if (secret && typeof secret === "string" && secret.trim()) {
+    const signature = createHmac("sha256", secret.trim()).update(body).digest("hex")
+    headers["x-hub-signature-256"] = "sha256=" + signature
+    headers["x-signature"] = signature
+  }
+
+  const controller = typeof AbortController !== "undefined" ? new AbortController() : null
+  const timer = controller ? setTimeout(() => controller.abort(new Error("Webhook request timed out")), timeoutMs) : null
+
+  try {
+    const res = await fetchImpl(parsedUrl.toString(), {
+      method: "POST",
+      headers,
+      body,
+      ...(controller ? { signal: controller.signal } : {}),
+    })
+    if (timer) clearTimeout(timer)
+    return { ok: res.ok, status: res.status }
+  } catch (err) {
+    if (timer) clearTimeout(timer)
+    return { ok: false, error: err?.message || String(err) }
+  }
+}
+
+export async function dispatchDiffNotifications(ctx, config, results, { fetchImpl = globalThis.fetch } = {}) {
+  const events = extractDiffEvents(results, config)
+  if (!events.hasEvents) {
+    return { ok: true, events, dispatched: false }
+  }
+
+  try {
+    if (typeof ctx?.emit === "function") {
+      ctx.emit("model-sync/diff", events)
+    }
+  } catch (err) {
+    if (typeof ctx?.logger?.debug === "function") {
+      ctx.logger.debug("[dsh-model-sync] emit model-sync/diff error:", err)
+    }
+  }
+
+  try {
+    if (typeof ctx?.pluginNotify?.send === "function") {
+      const summary = `Model Sync: +${events.counts.added} added, -${events.counts.deprecated} deprecated, ~${events.counts.priceChanged} price changed`
+      await ctx.pluginNotify.send({
+        source: "dsh-model-sync",
+        title: "Model Sync Catalog Changes",
+        message: summary,
+        data: events,
+      })
+    }
+  } catch (err) {
+    if (typeof ctx?.logger?.debug === "function") {
+      ctx.logger.debug("[dsh-model-sync] pluginNotify error:", err)
+    }
+  }
+
+  let webhookResult = null
+  if (config?.diffWebhookUrl && typeof config.diffWebhookUrl === "string" && config.diffWebhookUrl.trim()) {
+    webhookResult = await sendWebhookNotification(
+      config.diffWebhookUrl,
+      config.diffWebhookSecret,
+      {
+        event: "model-sync.diff",
+        ...events,
+      },
+      { fetchImpl }
+    )
+  }
+
+  return { ok: true, events, dispatched: true, webhook: webhookResult }
+}

package/lib/http.js

@@ -1,3 +1,12 @@
+import { validateAliasName } from './alias-resolver.js'
+function normalizeWebhookTestRequest(body) {
+  if (!body || typeof body !== "object") throw Object.assign(new Error("body is required"), { code: "INVALID_REQUEST" })
+  if (typeof body.url !== "string" || !body.url.trim()) throw Object.assign(new Error("url is required"), { code: "INVALID_REQUEST" })
+  return {
+    url: body.url.trim(),
+    secret: typeof body.secret === "string" ? body.secret.trim() : "",
+  }
+}
 import crypto from 'node:crypto'
 import { validatePolicy } from './policy.js'
 
@@ -137,8 +146,26 @@ export function normalizeBatchTryRequest(body) {
 export function normalizeAliasRequest(body) {
   if (body === null || typeof body !== 'object' || Array.isArray(body)) throw new Error('request body must be an object')
   if (typeof body.alias !== 'string' || !body.alias.trim()) throw new Error('alias is required')
-  if (!/^[a-zA-Z0-9_\-.]{1,64}$/.test(body.alias.trim())) throw new Error('alias must be 1-64 alphanumeric characters or _-.')
+  if (!validateAliasName(body.alias)) throw new Error('alias must be 1-64 alphanumeric characters, @ or _-.')
   if (body.action === 'delete') return { action: 'delete', alias: body.alias.trim() }
+  if (Array.isArray(body.targets) && body.targets.length > 0) {
+    if (body.targets.length > 50) throw new Error('targets array is too long')
+    for (const t of body.targets) {
+      if (typeof t === 'string') {
+        if (!t || t.length > 256) throw new Error('target must be a short string')
+      } else if (t && typeof t === 'object') {
+        if (typeof t.provider !== 'string' || !t.provider || t.provider.length > 128) throw new Error('target provider must be a short string')
+        if (typeof t.model !== 'string' || !t.model || t.model.length > 256) throw new Error('target model must be a short string')
+      } else {
+        throw new Error('invalid target format')
+      }
+    }
+    return { action: 'set', alias: body.alias.trim(), targets: body.targets }
+  }
+  if (typeof body.strategy === 'string' && body.strategy.trim()) {
+    if (body.strategy.length > 64) throw new Error('strategy must be a short string')
+    return { action: 'set', alias: body.alias.trim(), strategy: body.strategy.trim() }
+  }
   if (typeof body.provider !== 'string' || !body.provider.trim() || body.provider.length > 128) throw new Error('provider must be a short string')
   if (typeof body.model !== 'string' || !body.model.trim() || body.model.length > 256) throw new Error('model must be a short string')
   return { action: 'set', alias: body.alias.trim(), provider: body.provider.trim(), model: body.model.trim() }
@@ -245,6 +272,17 @@ export function registerHttpApi(ctx, synchronizer, { getSchedulerStatus = () =>
     if (route === 'aliases' && req.method === 'GET') {
       return json(res, 200, { aliases: synchronizer.getAliases() })
     }
+    if (route === 'aliases-resolve') {
+      if (req.method !== 'GET') return json(res, 405, { error: { code: 'method', message: 'GET only' } })
+      try {
+        const urlObj = new URL(req.url, 'http://127.0.0.1')
+        const alias = urlObj.searchParams.get('alias')
+        if (!alias) return json(res, 400, { error: { code: 'bad-request', message: 'alias query parameter is required' } })
+        return json(res, 200, synchronizer.resolveAlias(alias))
+      } catch (error) {
+        return json(res, 400, { error: { code: error?.code ?? 'resolve-failed', message: error instanceof Error ? error.message : String(error) } })
+      }
+    }
     if (route === 'import') {
       if (req.method !== 'POST') return json(res, 405, { error: { code: 'method', message: 'POST only' } })
       try {
@@ -277,6 +315,7 @@ export function registerHttpApi(ctx, synchronizer, { getSchedulerStatus = () =>
         : route === 'health' ? normalizeHealthRequest(body)
         : route === 'credentials-check' ? normalizeCredentialCheckRequest(body)
         : route === 'notification-read' || route === 'notification-acknowledge' ? normalizeNotificationAction(body)
+        : route === 'webhook-test' ? normalizeWebhookTestRequest(body)
         : route === 'rollback' ? normalizeHistoryRollbackRequest(body)
         : normalizeRunRequest(body)
     }
@@ -292,6 +331,7 @@ export function registerHttpApi(ctx, synchronizer, { getSchedulerStatus = () =>
         : route === 'credentials-check' ? { health: await synchronizer.health(options), credentials: await synchronizer.credentialDiagnostics(options) }
         : route === 'notification-read' ? await synchronizer.updateNotification(options.id, 'read')
         : route === 'notification-acknowledge' ? await synchronizer.updateNotification(options.id, 'acknowledged')
+        : route === 'webhook-test' ? await synchronizer.testWebhook(options)
         : route === 'rollback' ? await synchronizer.rollbackHistory(options)
         : await synchronizer.run(options)
       return json(res, 200, { ...result, providers: synchronizer.listProviders() })
@@ -309,6 +349,7 @@ export function registerHttpApi(ctx, synchronizer, { getSchedulerStatus = () =>
     ctx.webServer.register({ kind: 'exact', path: `${BASE}/export`, handler: makeHandler('export') }),
     ctx.webServer.register({ kind: 'exact', path: `${BASE}/import`, handler: makeHandler('import') }),
     ctx.webServer.register({ kind: 'exact', path: `${BASE}/aliases`, handler: makeHandler('aliases') }),
+    ctx.webServer.register({ kind: 'exact', path: `${BASE}/aliases/resolve`, handler: makeHandler('aliases-resolve') }),
     ctx.webServer.register({ kind: 'exact', path: `${BASE}/health`, handler: makeHandler('health') }),
     ctx.webServer.register({ kind: 'exact', path: `${BASE}/selection`, handler: makeHandler('selection') }),
     ctx.webServer.register({ kind: 'exact', path: `${BASE}/policy`, handler: makeHandler('policy') }),
@@ -320,5 +361,6 @@ export function registerHttpApi(ctx, synchronizer, { getSchedulerStatus = () =>
     ctx.webServer.register({ kind: 'exact', path: BASE + '/notifications', handler: makeHandler('notifications') }),
     ctx.webServer.register({ kind: 'exact', path: BASE + '/notifications/read', handler: makeHandler('notification-read') }),
     ctx.webServer.register({ kind: 'exact', path: BASE + '/notifications/acknowledge', handler: makeHandler('notification-acknowledge') }),
+    ctx.webServer.register({ kind: 'exact', path: BASE + '/webhook/test', handler: makeHandler('webhook-test') }),
   ]
 }

package/lib/index.js

@@ -26,6 +26,11 @@ export const Config = Schema.object({
   circuitBreakerCooldownMinutes: Schema.number().default(5),
   historyLimit: Schema.number().default(50),
   notificationLimit: Schema.number().default(50),
+  diffWebhookUrl: Schema.string().default(),
+  diffWebhookSecret: Schema.string().default(),
+  notifyOnModelAdded: Schema.boolean().default(true),
+  notifyOnModelDeprecated: Schema.boolean().default(true),
+  notifyOnPriceChanged: Schema.boolean().default(true),
   notifications: Schema.array(Schema.object({
     id: Schema.string().required(),
     fingerprint: Schema.string().required(),
@@ -65,8 +70,13 @@ export const Config = Schema.object({
     autoApply: Schema.boolean().default(false),
   })).default([]),
   aliases: Schema.dict(Schema.object({
-    provider: Schema.string().required(),
-    model: Schema.string().required(),
+    provider: Schema.string(),
+    model: Schema.string(),
+    targets: Schema.array(Schema.object({
+      provider: Schema.string().required(),
+      model: Schema.string().required(),
+    })),
+    strategy: Schema.string(),
     updatedAt: Schema.number().default(0),
   }).loose()).default({}),
   modelSelections: Schema.dict(Schema.array(Schema.string())).default({}),

package/lib/models.js

@@ -1,3 +1,4 @@
+import { lookupReferencePricing } from './pricing-database.js'
 const FIELD_ALIASES = Object.freeze({
   contextWindow: [
     'contextWindow', 'context_window', 'contextLength', 'context_length',
@@ -292,7 +293,7 @@ export function normalizeModel(provider, row) {
   const contextWindow = firstNumber(row, FIELD_ALIASES.contextWindow)
   const maxTokens = firstNumber(row, FIELD_ALIASES.maxTokens)
   const capabilities = normalizeCapabilities(row)
-  const pricing = normalizePricing(row)
+  const pricing = normalizePricing(row) ?? lookupReferencePricing(effectiveProvider || provider, id)
   const tags = normalizeTags(row)
   const aliases = normalizeAliases(row, id)
   const lifecycle = normalizeLifecycle(row)

package/lib/pricing-database.js

@@ -0,0 +1,138 @@
+function cleanTokenPrice(val) {
+  if (typeof val !== 'number' || !Number.isFinite(val)) return 0
+  return Math.round((val / 1000000) * 1e12) / 1e12
+}
+
+function perMillion(inputUSD, outputUSD, extra = {}) {
+  const res = {
+    inputPerToken: cleanTokenPrice(inputUSD),
+    outputPerToken: cleanTokenPrice(outputUSD),
+    currency: 'USD',
+    source: 'reference',
+  }
+  if (extra.cacheReadUSD !== undefined) {
+    res.cacheReadPerToken = cleanTokenPrice(extra.cacheReadUSD)
+  }
+  if (extra.cacheWriteUSD !== undefined) {
+    res.cacheWritePerToken = cleanTokenPrice(extra.cacheWriteUSD)
+  }
+  return Object.freeze(res)
+}
+
+export const REFERENCE_PRICING = Object.freeze({
+  openai: {
+    'gpt-4o': perMillion(2.5, 10),
+    'gpt-4o-mini': perMillion(0.15, 0.6),
+    'gpt-4-turbo': perMillion(10, 30),
+    'gpt-4': perMillion(30, 60),
+    'gpt-3.5-turbo': perMillion(0.5, 1.5),
+    'o1': perMillion(15, 60),
+    'o1-preview': perMillion(15, 60),
+    'o1-mini': perMillion(1.1, 4.4),
+    'o3-mini': perMillion(1.1, 4.4),
+    'chatgpt-4o-latest': perMillion(5, 15),
+  },
+  anthropic: {
+    'claude-3-7-sonnet': perMillion(3, 15),
+    'claude-3-5-sonnet': perMillion(3, 15),
+    'claude-3-5-haiku': perMillion(0.8, 4),
+    'claude-3-opus': perMillion(15, 75),
+    'claude-3-haiku': perMillion(0.25, 1.25),
+  },
+  groq: {
+    'llama-3.3-70b-versatile': perMillion(0.59, 0.79),
+    'llama-3.3-70b-specdec': perMillion(0.59, 0.99),
+    'llama-3.1-70b-versatile': perMillion(0.59, 0.79),
+    'llama-3.1-8b-instant': perMillion(0.05, 0.08),
+    'llama3-70b-8192': perMillion(0.59, 0.79),
+    'llama3-8b-8192': perMillion(0.05, 0.08),
+    'mixtral-8x7b-32768': perMillion(0.24, 0.24),
+    'gemma2-9b-it': perMillion(0.2, 0.2),
+    'deepseek-r1-distill-llama-70b': perMillion(0.75, 0.99),
+    'deepseek-r1-distill-qwen-32b': perMillion(0.59, 0.79),
+    'qwen-2.5-32b': perMillion(0.59, 0.79),
+    'qwen-2.5-coder-32b': perMillion(0.59, 0.79),
+  },
+  mistral: {
+    'mistral-large': perMillion(2, 6),
+    'mistral-small': perMillion(0.1, 0.3),
+    'codestral': perMillion(0.3, 0.9),
+    'ministral-8b': perMillion(0.1, 0.1),
+    'ministral-3b': perMillion(0.04, 0.04),
+    'pixtral-large': perMillion(2, 6),
+    'pixtral-12b': perMillion(0.15, 0.15),
+    'open-mistral-7b': perMillion(0.2, 0.2),
+    'open-mixtral-8x7b': perMillion(0.7, 0.7),
+  },
+  xai: {
+    'grok-2': perMillion(2, 10),
+    'grok-2-mini': perMillion(0.2, 1),
+    'grok-2-vision': perMillion(2, 10),
+    'grok-beta': perMillion(5, 15),
+  },
+  deepseek: {
+    'deepseek-chat': perMillion(0.14, 0.28, { cacheReadUSD: 0.014 }),
+    'deepseek-reasoner': perMillion(0.55, 2.19, { cacheReadUSD: 0.14 }),
+    'deepseek-coder': perMillion(0.14, 0.28),
+  },
+  google: {
+    'gemini-2.0-flash': perMillion(0.1, 0.4),
+    'gemini-1.5-pro': perMillion(1.25, 5),
+    'gemini-1.5-flash': perMillion(0.075, 0.3),
+    'gemini-1.5-flash-8b': perMillion(0.0375, 0.15),
+  },
+})
+
+function cleanId(id) {
+  if (typeof id !== 'string') return ''
+  return id
+    .toLowerCase()
+    .trim()
+    .replace(/^models\//, '')
+    .replace(/:latest$/, '')
+    .replace(/-latest$/, '')
+    .replace(/-(202\d{5}|202\d-\d{2}-\d{2}|\d{4})$/, '')
+}
+
+export function lookupReferencePricing(provider, modelId) {
+  if (typeof modelId !== 'string' || !modelId.trim()) return undefined
+  const provKey = String(provider || '').toLowerCase().trim()
+  const rawId = modelId.toLowerCase().trim()
+  const cleaned = cleanId(rawId)
+
+  // 1. Direct check in provider table
+  const table = REFERENCE_PRICING[provKey]
+  if (table) {
+    if (table[rawId]) return { ...table[rawId] }
+    if (table[cleaned]) return { ...table[cleaned] }
+    for (const [key, val] of Object.entries(table)) {
+      if (rawId.startsWith(key) || cleaned.startsWith(key)) return { ...val }
+    }
+  }
+
+  // 2. Vendor prefix check (e.g. "openai/gpt-4o" or "anthropic/claude-3-5-sonnet")
+  const slashIdx = rawId.indexOf('/')
+  if (slashIdx > 0) {
+    const subProv = rawId.slice(0, slashIdx)
+    const subId = rawId.slice(slashIdx + 1)
+    const subCleaned = cleanId(subId)
+    const subTable = REFERENCE_PRICING[subProv]
+    if (subTable) {
+      if (subTable[subId]) return { ...subTable[subId] }
+      if (subTable[subCleaned]) return { ...subTable[subCleaned] }
+      for (const [key, val] of Object.entries(subTable)) {
+        if (subId.startsWith(key) || subCleaned.startsWith(key)) return { ...val }
+      }
+    }
+  }
+
+  // 3. Fallback search across all tables if cleaned matches well-known key
+  for (const [p, t] of Object.entries(REFERENCE_PRICING)) {
+    if (t[cleaned]) return { ...t[cleaned] }
+    for (const [key, val] of Object.entries(t)) {
+      if (cleaned.startsWith(key)) return { ...val }
+    }
+  }
+
+  return undefined
+}

package/lib/synchronizer-helpers.js

@@ -1,4 +1,7 @@
 import { statusOfError } from './reliability.js'
+import { historyEntry } from './history.js'
+import { normalizeModels } from './models.js'
+import { catalogPatch } from './reconcile.js'
 
 export const PIAI_NS = 'llm-pi-ai'
 export const DEFAULT_RELIABILITY = Object.freeze({
@@ -124,3 +127,38 @@ export function rotationRefs(settings, provider) {
     return []
   }
 }
+
+export function refsFor(row, settings) {
+  const profile = profileOf(settings, row.provider)
+  const refs = [
+    row.apiKeyEnv,
+    profile.credentialRef,
+    ...(Array.isArray(profile.credentialRefs) ? profile.credentialRefs : []),
+    ...(Array.isArray(profile.apiKeyRefs) ? profile.apiKeyRefs : []),
+    ...rotationRefs(settings, row.provider),
+  ]
+  return [...new Set(refs.filter((ref) => typeof ref === 'string' && ref.trim()).map((ref) => ref.trim()))].slice(0, 32)
+}
+
+export async function performHistoryRollback({ ctx, config, providers = [], historyId, provider } = {}) {
+  if (typeof historyId !== 'string' || !historyId) throw Object.assign(new Error('historyId is required'), { code: 'INVALID_HISTORY' })
+  if (typeof provider !== 'string' || !provider) throw Object.assign(new Error('provider is required'), { code: 'INVALID_HISTORY' })
+  const entry = historyEntry(config.history, historyId)
+  if (!entry) throw Object.assign(new Error(`history entry not found: ${historyId}`), { code: 'HISTORY_NOT_FOUND' })
+  const snapshot = (entry.providers ?? []).find((row) => row.provider === provider)
+  if (!snapshot || !Array.isArray(snapshot.before)) throw Object.assign(new Error(`history snapshot not found: ${provider}`), { code: 'HISTORY_NOT_FOUND' })
+  if (!providers.some((row) => row.provider === provider && row.configured)) throw Object.assign(new Error(`provider is not configured: ${provider}`), { code: 'PROVIDER_NOT_CONFIGURED' })
+  const settings = settingsOf(ctx)
+  const section = settings?.get?.(PIAI_NS)
+  const descriptor = descriptorOf(settings, PIAI_NS)
+  if (!section || !descriptor || typeof settings.replace !== 'function') {
+    throw Object.assign(new Error('llm-pi-ai settings are not writable'), { code: 'SETTINGS_UNAVAILABLE' })
+  }
+  const current = normalizeModels(provider, profileOf(settings, provider).models ?? [])
+  const target = normalizeModels(provider, snapshot.before)
+  if (JSON.stringify(current) === JSON.stringify(target)) {
+    return { historyId, provider, models: target, applied: false, allowlistUntouched: true }
+  }
+  await replaceWithRetry(settings, PIAI_NS, (sec) => catalogPatch(sec, provider, target))
+  return { historyId, provider, models: target, applied: true, allowlistUntouched: true }
+}

package/lib/synchronizer-transfer.js

@@ -1,4 +1,14 @@
-export function createConfigTransfer({ getConfig = () => ({}), saveConfig = async () => {}, listProviders = () => [], validatePolicy } = {}) {
+import { resolveAlias as resolveSmartAlias, validateAliasName, VIRTUAL_STRATEGIES, isVirtualAlias } from './alias-resolver.js'
+
+export function createConfigTransfer({
+  getConfig = () => ({}),
+  saveConfig = async () => {},
+  listProviders = () => [],
+  validatePolicy,
+  isCircuitOpen = () => false,
+  getHealthResults = () => [],
+  getModelProbes = () => ({}),
+} = {}) {
   function exportConfig() {
     const config = getConfig() ?? {}
     const pmap = {}
@@ -56,8 +66,23 @@ export function createConfigTransfer({ getConfig = () => ({}), saveConfig = asyn
     if (data.aliases && typeof data.aliases === 'object') {
       const currentAliases = structuredClone(config.aliases ?? {})
       for (const [k, v] of Object.entries(data.aliases)) {
-        if (typeof k === 'string' && /^[a-zA-Z0-9_\-.]{1,64}$/.test(k.trim()) && v && typeof v === 'object' && typeof v.provider === 'string' && typeof v.model === 'string') {
-          currentAliases[k.trim()] = { provider: v.provider, model: v.model, updatedAt: Date.now() }
+        if (validateAliasName(k) && v && typeof v === 'object') {
+          const entry = { updatedAt: Date.now() }
+          if (Array.isArray(v.targets)) {
+            entry.targets = v.targets
+          } else if (v.strategy && typeof v.strategy === 'string') {
+            const strat = v.strategy.trim()
+            if (VIRTUAL_STRATEGIES.includes(strat)) {
+              entry.strategy = strat
+              entry.isVirtual = isVirtualAlias(k)
+            } else {
+              continue
+            }
+          } else if (v.provider && v.model) {
+            entry.provider = v.provider
+            entry.model = v.model
+          }
+          currentAliases[k.trim()] = entry
           importedAliases.push(k.trim())
         }
       }
@@ -83,19 +108,35 @@ export function createConfigTransfer({ getConfig = () => ({}), saveConfig = asyn
     return config.aliases ?? {}
   }
 
-  async function setAlias({ alias, provider, model } = {}) {
-    if (typeof alias !== 'string' || !/^[a-zA-Z0-9_\-.]{1,64}$/.test(alias.trim())) {
-      throw Object.assign(new Error('alias must be 1-64 alphanumeric characters or _-.'), { code: 'INVALID_ALIAS' })
+  async function setAlias({ alias, provider, model, targets, strategy } = {}) {
+    if (!validateAliasName(alias)) {
+      throw Object.assign(new Error('alias must be 1-64 alphanumeric characters, @ or _-.'), { code: 'INVALID_ALIAS' })
     }
     const trimmedAlias = alias.trim()
-    if (typeof provider !== 'string' || !provider) throw new Error('provider is required')
-    if (typeof model !== 'string' || !model) throw new Error('model is required')
-    if (typeof saveConfig !== 'function') throw Object.assign(new Error('dsh-model-sync settings are not writable'), { code: 'CONFIG_UNAVAILABLE' })
     const config = getConfig() ?? {}
     const currentAliases = structuredClone(config.aliases ?? {})
-    currentAliases[trimmedAlias] = { provider, model, updatedAt: Date.now() }
+
+    if (Array.isArray(targets) && targets.length > 0) {
+      currentAliases[trimmedAlias] = { targets, updatedAt: Date.now() }
+    } else if (strategy !== undefined && strategy !== null && strategy !== '') {
+      const cleanStrategy = typeof strategy === 'string' ? strategy.trim() : ''
+      if (!VIRTUAL_STRATEGIES.includes(cleanStrategy)) {
+        throw Object.assign(new Error(`Invalid strategy: ${strategy}. Supported: ${VIRTUAL_STRATEGIES.join(', ')}`), { code: 'INVALID_STRATEGY' })
+      }
+      currentAliases[trimmedAlias] = {
+        strategy: cleanStrategy,
+        isVirtual: isVirtualAlias(trimmedAlias),
+        updatedAt: Date.now(),
+      }
+    } else {
+      if (typeof provider !== 'string' || !provider) throw new Error('provider is required')
+      if (typeof model !== 'string' || !model) throw new Error('model is required')
+      currentAliases[trimmedAlias] = { provider, model, updatedAt: Date.now() }
+    }
+
+    if (typeof saveConfig !== 'function') throw Object.assign(new Error('dsh-model-sync settings are not writable'), { code: 'CONFIG_UNAVAILABLE' })
     await saveConfig({ aliases: currentAliases })
-    return { alias: trimmedAlias, provider, model, aliases: currentAliases }
+    return { alias: trimmedAlias, ...currentAliases[trimmedAlias], aliases: currentAliases }
   }
 
   async function deleteAlias({ alias } = {}) {
@@ -108,11 +149,23 @@ export function createConfigTransfer({ getConfig = () => ({}), saveConfig = asyn
     return { alias: alias.trim(), deleted: true, aliases: currentAliases }
   }
 
+  function resolveAlias(aliasName) {
+    const config = getConfig() ?? {}
+    return resolveSmartAlias(aliasName, {
+      aliases: config.aliases ?? {},
+      modelCatalogs: config.modelCatalogs ?? {},
+      isCircuitOpen,
+      healthResults: typeof getHealthResults === 'function' ? getHealthResults() : [],
+      modelProbes: typeof getModelProbes === 'function' ? getModelProbes() : {},
+    })
+  }
+
   return {
     exportConfig,
     importConfig,
     getAliases,
     setAlias,
     deleteAlias,
+    resolveAlias,
   }
 }

package/lib/synchronizer.js

@@ -1,3 +1,4 @@
+import { dispatchDiffNotifications, sendWebhookNotification } from "./diff-notifier.js"
 import { listApiKeyProviders } from './inventory.js'
 import { createProviderAdapterRegistry } from './adapter-registry.js'
 import { createCredentialResolver } from './credentials.js'
@@ -5,7 +6,7 @@ import { reconcileModels, catalogPatch } from './reconcile.js'
 import { normalizeModels } from './models.js'
 import { filterModels, normalizePolicy, validatePolicy } from './policy.js'
 import { createTimeoutSignal, isRetryableError, mapWithConcurrency, retryWithBackoff, statusOfError } from './reliability.js'
-import { appendHistory, createHistoryEntry, historyEntry, listHistory } from './history.js'
+import { appendHistory, createHistoryEntry, listHistory } from './history.js'
 import { lifecycleOptions, lifecycleStatus, selectableModels, updateLifecycle } from './lifecycle.js'
 import { appendNotification, listNotifications, createSyncReport, updateNotification } from './reporting.js'
 
@@ -23,6 +24,8 @@ import {
   adapterErrorType,
   replaceWithRetry,
   rotationRefs,
+  refsFor,
+  performHistoryRollback,
 } from './synchronizer-helpers.js'
 import { createConfigTransfer } from './synchronizer-transfer.js'
 import { createModelProber } from './synchronizer-prober.js'
@@ -49,18 +52,6 @@ export function createModelSynchronizer(ctx, { getConfig = () => ({}), saveConfi
     return registry.select(profile, config.adapterRegistry?.[profile.provider])
   }
 
-  function refsFor(row, settings) {
-    const profile = profileOf(settings, row.provider)
-    const refs = [
-      row.apiKeyEnv,
-      profile.credentialRef,
-      ...(Array.isArray(profile.credentialRefs) ? profile.credentialRefs : []),
-      ...(Array.isArray(profile.apiKeyRefs) ? profile.apiKeyRefs : []),
-      ...rotationRefs(settings, row.provider),
-    ]
-    return [...new Set(refs.filter((ref) => typeof ref === 'string' && ref.trim()).map((ref) => ref.trim()))].slice(0, 32)
-  }
-
   function circuitOpen(provider, reliability) {
     if (reliability.circuitBreakerFailures <= 0) return null
     const state = circuits.get(provider)
@@ -413,6 +404,18 @@ export function createModelSynchronizer(ctx, { getConfig = () => ({}), saveConfi
           result.historyError = errorMessage(error)
         }
       }
+      if (!dryRun || options.forceNotify) {
+        try {
+          const notifyResult = await dispatchDiffNotifications(ctx, config, results)
+          if (notifyResult?.dispatched) {
+            result.diffNotifications = notifyResult
+          }
+        } catch (err) {
+          if (typeof ctx?.logger?.debug === "function") {
+            ctx.logger.debug("[dsh-model-sync] dispatchDiffNotifications error:", err)
+          }
+        }
+      }
       result.notifications = notificationLedger()
       lastRun = result
       return result
@@ -449,32 +452,8 @@ export function createModelSynchronizer(ctx, { getConfig = () => ({}), saveConfi
   }
 
   const prober = createModelProber({ health })
-  const tryModel = prober.tryModel
-  const batchTryModels = prober.batchTryModels
 
-  async function rollbackHistory({ historyId, provider } = {}) {
-    if (typeof historyId !== 'string' || !historyId) throw Object.assign(new Error('historyId is required'), { code: 'INVALID_HISTORY' })
-    if (typeof provider !== 'string' || !provider) throw Object.assign(new Error('provider is required'), { code: 'INVALID_HISTORY' })
-    const config = getConfig() ?? {}
-    const entry = historyEntry(config.history, historyId)
-    if (!entry) throw Object.assign(new Error(`history entry not found: ${historyId}`), { code: 'HISTORY_NOT_FOUND' })
-    const snapshot = (entry.providers ?? []).find((row) => row.provider === provider)
-    if (!snapshot || !Array.isArray(snapshot.before)) throw Object.assign(new Error(`history snapshot not found: ${provider}`), { code: 'HISTORY_NOT_FOUND' })
-    if (!providers().some((row) => row.provider === provider && row.configured)) throw Object.assign(new Error(`provider is not configured: ${provider}`), { code: 'PROVIDER_NOT_CONFIGURED' })
-    const settings = settingsOf(ctx)
-    const section = settings?.get?.(PIAI_NS)
-    const descriptor = descriptorOf(settings, PIAI_NS)
-    if (!section || !descriptor || typeof settings.replace !== 'function') {
-      throw Object.assign(new Error('llm-pi-ai settings are not writable'), { code: 'SETTINGS_UNAVAILABLE' })
-    }
-    const current = normalizeModels(provider, profileOf(settings, provider).models ?? [])
-    const target = normalizeModels(provider, snapshot.before)
-    if (JSON.stringify(current) === JSON.stringify(target)) {
-      return { historyId, provider, models: target, applied: false, allowlistUntouched: true }
-    }
-    await replaceWithRetry(settings, PIAI_NS, (section) => catalogPatch(section, provider, target))
-    return { historyId, provider, models: target, applied: true, allowlistUntouched: true }
-  }
+  const rollbackHistory = (opts) => performHistoryRollback({ ctx, config: getConfig() ?? {}, providers: providers(), ...opts })
 
   async function setModelPolicy(provider, policy) {
     if (typeof provider !== 'string' || !provider) throw new Error('provider is required')
@@ -551,12 +530,9 @@ export function createModelSynchronizer(ctx, { getConfig = () => ({}), saveConfi
     saveConfig,
     listProviders: providers,
     validatePolicy,
+    isCircuitOpen: (p) => Boolean(circuits.get(p)?.blockedUntil > Date.now()),
+    getHealthResults: () => lastHealth?.results ?? [],
   })
-  const exportConfig = transfer.exportConfig
-  const importConfig = transfer.importConfig
-  const getAliases = transfer.getAliases
-  const setAlias = transfer.setAlias
-  const deleteAlias = transfer.deleteAlias
 
   return Object.freeze({
     listProviders: providers,
@@ -569,19 +545,15 @@ export function createModelSynchronizer(ctx, { getConfig = () => ({}), saveConfi
     setModelPolicy,
     listPolicies,
     health,
-    tryModel,
-    batchTryModels,
-    exportConfig,
-    importConfig,
-    getAliases,
-    setAlias,
-    deleteAlias,
+    ...prober,
+    ...transfer,
     credentialDiagnostics,
     history,
     report: () => structuredClone(lastReport),
     notifications: notificationLedger,
     updateNotification: updateNotificationState,
     rollbackHistory,
+    testWebhook: async ({ url, secret }) => sendWebhookNotification(url, secret, { event: 'model-sync.test', timestamp: Date.now(), test: true }),
     status: () => ({ running: Boolean(running), lastRun, lastHealth, lastReport: structuredClone(lastReport), notifications: notificationLedger(), history: history(), policies: listPolicies(), lifecycle: structuredClone(getConfig()?.modelLifecycle ?? {}), aliases: structuredClone(getConfig()?.aliases ?? {}) }),
   })
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-model-sync",
-  "version": "0.4.9",
+  "version": "0.5.1",
   "description": "Automatic model catalog synchronization for API-key DeepSeek Harness providers.",
   "keywords": [
     "deepseek-harness",