@jeffusion/bungee-core 5.9.0 → 5.11.0

package/dist/plugins/models-dev/manifest.json

@@ -0,0 +1,199 @@
+{
+  "name": "models-dev",
+  "version": "1.0.0",
+  "schemaVersion": 2,
+  "artifactKind": "runtime-plugin",
+  "main": "index.js",
+  "capabilities": [
+    "hooks",
+    "api",
+    "dynamicRuntimeLoad",
+    "controlPlane",
+    "nativeWidgetsStatic"
+  ],
+  "uiExtensionMode": "native-static",
+  "engines": {
+    "bungee": "^5.0.0"
+  },
+  "runtimeScope": "global",
+  "control": {
+    "entry": "control.js",
+    "rpc": []
+  },
+  "builtin": true,
+  "author": "Bungee Team",
+  "ui": {
+    "components": [
+      {
+        "name": "ModelsDevSettings",
+        "entry": "ui/ModelsDevSettings.svelte"
+      }
+    ]
+  },
+  "services": {
+    "provides": [
+      {
+        "id": "models-dev.catalog.v1",
+        "version": 1,
+        "process": "control",
+        "kind": "local"
+      },
+      {
+        "id": "models-dev.catalog.snapshot.v1",
+        "version": 1,
+        "process": "control",
+        "kind": "snapshot"
+      },
+      {
+        "id": "models-dev.catalog.v1",
+        "version": 1,
+        "process": "worker",
+        "kind": "local"
+      }
+    ],
+    "consumes": [
+      {
+        "id": "models-dev.catalog.snapshot.v1",
+        "version": 1,
+        "process": "worker",
+        "plugin": "models-dev",
+        "kind": "snapshot"
+      }
+    ]
+  },
+  "contributes": {
+    "api": [
+      {
+        "path": "/catalog/status",
+        "methods": [
+          "GET"
+        ],
+        "handler": "getCatalogStatus",
+        "execution": "control",
+        "capability": "config.read"
+      },
+      {
+        "path": "/catalog/providers",
+        "methods": [
+          "GET"
+        ],
+        "handler": "getCatalogProviders",
+        "execution": "control",
+        "capability": "config.read"
+      },
+      {
+        "path": "/catalog/models",
+        "methods": [
+          "GET"
+        ],
+        "handler": "getCatalogModels",
+        "execution": "control",
+        "capability": "config.read"
+      },
+      {
+        "path": "/catalog/settings",
+        "methods": [
+          "PUT"
+        ],
+        "handler": "configureCatalog",
+        "execution": "control",
+        "capability": "config.write"
+      },
+      {
+        "path": "/catalog/refresh",
+        "methods": [
+          "POST"
+        ],
+        "handler": "refreshCatalog",
+        "execution": "control",
+        "capability": "config.write"
+      }
+    ],
+    "settings": "/catalog/status",
+    "nativeSettingsComponent": "ModelsDevSettings"
+  },
+  "metadata": {
+    "name": "metadata.name",
+    "description": "plugin.description",
+    "icon": "cloud_download"
+  },
+  "configSchema": [],
+  "translations": {
+    "en": {
+      "metadata.name": "Models.dev Catalog",
+      "plugin.description": "Models and prices from models.dev for model selection and cost estimates",
+      "settings.title": "Catalog settings",
+      "settings.description": "Manage the shared models.dev catalog used for model choices and price estimates.",
+      "settings.autoRefresh": "Automatic refresh",
+      "settings.interval": "Refresh interval (hours)",
+      "settings.timeout": "Download timeout (seconds)",
+      "settings.increase": "Increase",
+      "settings.decrease": "Decrease",
+      "settings.save": "Save settings",
+      "settings.saving": "Saving",
+      "settings.saved": "Settings saved",
+      "settings.refresh": "Refresh now",
+      "settings.refreshing": "Refreshing",
+      "settings.catalog": "Model catalog",
+      "settings.state": "Status",
+      "settings.version": "Version",
+      "settings.lastSuccess": "Fetched at",
+      "settings.nextRefresh": "Next automatic refresh",
+      "settings.modelCount": "Models loaded",
+      "settings.providerCount": "Providers",
+      "settings.ready": "Available",
+      "settings.empty": "Not loaded yet",
+      "settings.stale": "Using last available catalog",
+      "settings.failed": "Unavailable",
+      "settings.never": "No record yet",
+      "settings.disabled": "Disabled",
+      "settings.error": "Operation failed. Please try again.",
+      "settings.invalid": "Enter whole numbers: 1–24 hours for the interval and 5–120 seconds for the timeout.",
+      "settings.failure": "Refresh failed. The last valid catalog is retained.",
+      "settings.timeoutError": "Download timed out",
+      "settings.networkError": "Network or source error",
+      "settings.invalid_catalogError": "Invalid catalog response",
+      "settings.storageError": "Unable to save the catalog",
+      "settings.snapshotError": "Unable to update the catalog",
+      "settings.retry": "Retry"
+    },
+    "zh-CN": {
+      "metadata.name": "models.dev 目录",
+      "plugin.description": "从 models.dev 获取模型目录，供模型选择和价格估算使用",
+      "settings.title": "目录设置",
+      "settings.description": "管理用于模型选择和价格估算的 models.dev 共用目录。",
+      "settings.autoRefresh": "自动刷新",
+      "settings.interval": "刷新间隔（小时）",
+      "settings.timeout": "下载超时（秒）",
+      "settings.increase": "增加",
+      "settings.decrease": "减少",
+      "settings.save": "保存设置",
+      "settings.saving": "正在保存",
+      "settings.saved": "设置已保存",
+      "settings.refresh": "立即刷新",
+      "settings.refreshing": "正在刷新",
+      "settings.catalog": "模型目录",
+      "settings.state": "状态",
+      "settings.version": "版本",
+      "settings.lastSuccess": "抓取时间",
+      "settings.nextRefresh": "下次自动刷新",
+      "settings.modelCount": "已加载模型",
+      "settings.providerCount": "提供商",
+      "settings.ready": "可用",
+      "settings.empty": "尚未加载",
+      "settings.stale": "使用上一次有效目录",
+      "settings.failed": "不可用",
+      "settings.never": "尚无记录",
+      "settings.disabled": "已关闭",
+      "settings.error": "操作失败，请稍后重试。",
+      "settings.invalid": "请输入整数：刷新间隔为 1–24 小时，超时时间为 5–120 秒。",
+      "settings.failure": "刷新失败，保留上一次有效目录。",
+      "settings.timeoutError": "下载超时",
+      "settings.networkError": "网络或数据源错误",
+      "settings.invalid_catalogError": "目录内容无效",
+      "settings.storageError": "目录保存失败",
+      "settings.snapshotError": "目录更新失败",
+      "settings.retry": "重试"
+    }
+  }
+}

package/dist/plugins/models-dev/ui/ModelsDevSettings.svelte

@@ -0,0 +1,120 @@
+<script lang="ts">
+  import { onMount } from 'svelte';
+  import { isLoading } from 'svelte-i18n';
+  import { getPluginText } from '$utils/plugin-i18n';
+  import { PanelCard, IndustrialToggle, LoadingIndicator } from '$components/industrial';
+  import { Button } from '$components/ui/button';
+  import { NumberInput } from '$components/ui/number-input';
+  import { Label } from '$components/ui/label';
+  import { requestPluginControl, _ } from '@bungee/plugin-sdk';
+
+  interface CatalogStatus {
+    state: 'empty' | 'ready' | 'stale' | 'failed'; version: number | null;
+    settings: { autoRefresh: boolean; intervalHours: number; timeoutSeconds: number };
+    refreshing: boolean; lastAttemptAt: number | null; lastSuccessAt: number | null;
+    nextRefreshAt: number | null; lastError: string | null; modelCount: number; providerCount: number;
+  }
+  let status = $state<CatalogStatus | null>(null);
+  let autoRefresh = $state(true);
+  let intervalHours = $state<number | undefined>(24);
+  let timeoutSeconds = $state<number | undefined>(15);
+  let loading = $state(true);
+  let busy = $state(false);
+  let saved = $state(false);
+  let error = $state('');
+  let loadError = $state(false);
+  let alive = false;
+  let polling = false;
+  let generation = 0;
+  const controller = new AbortController();
+  const t = (key: string) => $isLoading ? '' : getPluginText(`settings.${key}`, 'models-dev', (id, options) => $_(id, options));
+  const date = (value: number | null) => value === null ? t('never') : new Date(value).toLocaleString();
+
+  async function load(initial = false) {
+    if (polling || busy) return;
+    polling = true;
+    const version = generation;
+    try {
+      const result = await requestPluginControl<CatalogStatus>('models-dev', '/catalog/status', 'GET', undefined, controller.signal);
+      if (!alive || version !== generation) return;
+      // A poll started before a mutation must not overwrite its newer response.
+      if (!busy) status = result;
+      if (initial) {
+        autoRefresh = result.settings.autoRefresh;
+        intervalHours = result.settings.intervalHours;
+        timeoutSeconds = result.settings.timeoutSeconds;
+      }
+      loadError = false;
+    } catch { if (alive && version === generation) loadError = true; }
+    finally { if (alive) loading = false; polling = false; }
+  }
+  async function save() {
+    if (busy || !status) return;
+    saved = false;
+    const hours = Number(intervalHours), timeout = Number(timeoutSeconds);
+    if (intervalHours === undefined || timeoutSeconds === undefined || !Number.isInteger(hours) || hours < 1 || hours > 24 || !Number.isInteger(timeout) || timeout < 5 || timeout > 120) {
+      error = 'invalid'; return;
+    }
+    generation++; busy = true; error = '';
+    try {
+      const result = await requestPluginControl<CatalogStatus>('models-dev', '/catalog/settings', 'PUT',
+        { autoRefresh, intervalHours: hours, timeoutSeconds: timeout }, controller.signal);
+      if (alive) { status = result; saved = true; }
+    } catch { if (alive) error = 'error'; }
+    finally { if (alive) busy = false; }
+  }
+  async function refresh() {
+    if (busy || status?.refreshing) return;
+    generation++; busy = true; error = '';
+    try {
+      const result = await requestPluginControl<CatalogStatus>('models-dev', '/catalog/refresh', 'POST', undefined, controller.signal);
+      if (alive) status = result;
+    } catch { if (alive) error = 'error'; }
+    finally { if (alive) busy = false; }
+  }
+  onMount(() => {
+    alive = true; void load(true);
+    const timer = setInterval(() => void load(), 1000);
+    return () => { alive = false; controller.abort(); clearInterval(timer); };
+  });
+</script>
+
+<div class="space-y-6" data-testid="models-dev-settings">
+  <p class="text-sm text-zinc-400">{t('description')}</p>
+  {#if error || loadError}<p role="alert" class="text-sm text-red-400">{t(error || 'error')}</p>{/if}
+  {#if loading}<LoadingIndicator />
+  {:else if status}
+    <PanelCard title={t('title')}>
+      <form class="space-y-5" onsubmit={(event) => { event.preventDefault(); void save(); }}>
+        <div class="flex items-center justify-between gap-4 border-b border-carbon-600 pb-4">
+          <Label for="models-dev-auto">{t('autoRefresh')}</Label>
+          <IndustrialToggle id="models-dev-auto" label={t('autoRefresh')} bind:checked={autoRefresh} disabled={busy} />
+        </div>
+        <div class="grid gap-5 sm:grid-cols-2">
+          <div class="space-y-2"><Label for="models-dev-interval">{t('interval')}</Label>
+            <NumberInput id="models-dev-interval" data-testid="models-dev-interval" min={1} max={24} bind:value={intervalHours} disabled={busy} required
+              increaseLabel={`${t('increase')} ${t('interval')}`} decreaseLabel={`${t('decrease')} ${t('interval')}`} invalidMessage={t('invalid')} /></div>
+          <div class="space-y-2"><Label for="models-dev-timeout">{t('timeout')}</Label>
+            <NumberInput id="models-dev-timeout" data-testid="models-dev-timeout" min={5} max={120} bind:value={timeoutSeconds} disabled={busy} required
+              increaseLabel={`${t('increase')} ${t('timeout')}`} decreaseLabel={`${t('decrease')} ${t('timeout')}`} invalidMessage={t('invalid')} /></div>
+        </div>
+        <div class="flex items-center gap-4">
+          <Button type="submit" data-testid="models-dev-save" disabled={busy} aria-busy={busy}>{t(busy ? 'saving' : 'save')}</Button>
+          {#if saved}<span role="status" class="text-sm text-emerald-400">{t('saved')}</span>{/if}
+        </div>
+      </form>
+    </PanelCard>
+    <PanelCard title={t('catalog')}>
+      <div slot="actions"><Button variant="outline" data-testid="models-dev-refresh" disabled={busy || status.refreshing} aria-busy={status.refreshing} onclick={() => void refresh()}>{t(status.refreshing ? 'refreshing' : 'refresh')}</Button></div>
+      <dl class="grid gap-5 text-sm sm:grid-cols-2 lg:grid-cols-3">
+        <div class="space-y-2"><dt class="text-zinc-400">{t('state')}</dt><dd data-testid="models-dev-state">{t(status.state)}</dd></div>
+        <div class="space-y-2"><dt class="text-zinc-400">{t('version')}</dt><dd data-testid="models-dev-version">{status.version ?? t('never')}</dd></div>
+        <div class="space-y-2"><dt class="text-zinc-400">{t('lastSuccess')}</dt><dd data-testid="models-dev-fetched-at">{date(status.lastSuccessAt)}</dd></div>
+        <div class="space-y-2"><dt class="text-zinc-400">{t('modelCount')}</dt><dd>{status.modelCount}</dd></div>
+        <div class="space-y-2"><dt class="text-zinc-400">{t('providerCount')}</dt><dd>{status.providerCount}</dd></div>
+        <div class="space-y-2"><dt class="text-zinc-400">{t('nextRefresh')}</dt><dd>{status.nextRefreshAt === null ? t(status.settings.autoRefresh ? 'never' : 'disabled') : date(status.nextRefreshAt)}</dd></div>
+      </dl>
+      {#if status.lastError}<p role="status" data-testid="models-dev-error" class="mt-5 border-l-2 border-amber-400 pl-3 text-sm text-amber-400">{t(`${status.lastError}Error`)} · {t('failure')}</p>{/if}
+    </PanelCard>
+  {:else}<Button variant="outline" onclick={() => void load(true)}>{t('retry')}</Button>{/if}
+</div>