@goodandready/dsh-model-sync 0.4.9 → 0.5.0

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,213 @@
+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) {
+    if (lower === '@fast') strategy = 'fastest'
+    else if (lower === '@cheap') strategy = 'cheapest'
+    else if (lower === '@best-code') strategy = 'best-code'
+  }
+
+  if (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

@@ -202,6 +202,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 +234,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 +352,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 +384,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 +557,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 +574,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 +587,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 +1004,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 +1080,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 +1372,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}` : ''}`))))

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'
 
@@ -245,6 +254,16 @@ export function registerHttpApi(ctx, synchronizer, { getSchedulerStatus = () =>
     if (route === 'aliases' && req.method === 'GET') {
       return json(res, 200, { aliases: synchronizer.getAliases() })
     }
+    if (route === 'aliases-resolve' && req.method === 'GET') {
+      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 +296,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 +312,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 +330,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 +342,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-transfer.js

@@ -1,4 +1,14 @@
-export function createConfigTransfer({ getConfig = () => ({}), saveConfig = async () => {}, listProviders = () => [], validatePolicy } = {}) {
+import { resolveAlias as resolveSmartAlias, validateAliasName } 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,15 @@ 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) entry.strategy = v.strategy
+          else if (v.provider && v.model) {
+            entry.provider = v.provider
+            entry.model = v.model
+          }
+          currentAliases[k.trim()] = entry
           importedAliases.push(k.trim())
         }
       }
@@ -83,19 +100,27 @@ 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 && typeof strategy === 'string') {
+      currentAliases[trimmedAlias] = { strategy, 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 +133,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'
@@ -413,6 +414,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
@@ -551,12 +564,15 @@ 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
+  const resolveAlias = transfer.resolveAlias
 
   return Object.freeze({
     listProviders: providers,
@@ -576,12 +592,14 @@ export function createModelSynchronizer(ctx, { getConfig = () => ({}), saveConfi
     getAliases,
     setAlias,
     deleteAlias,
+    resolveAlias,
     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.0",
   "description": "Automatic model catalog synchronization for API-key DeepSeek Harness providers.",
   "keywords": [
     "deepseek-harness",