opencode-deepseek-peak 0.1.0 → 0.2.2

package/install.mjs

@@ -24,28 +24,32 @@ async function install() {
   await mkdir(directory, { recursive: true })
   const jsoncPath = join(directory, "opencode.jsonc")
   const jsonc = await readOptional(jsoncPath)
+  const tuiJsoncPath = join(directory, "tui.jsonc")
+  const tuiJsonc = await readOptional(tuiJsoncPath)
+  // [path, $schema, list key]: V1 TUI plugins live in tui.json under `plugin`.
   const targets = [
-    [jsonc !== undefined ? jsoncPath : join(directory, "opencode.json"), "https://opencode.ai/config.json"],
-    [join(directory, "cli.json"), "https://opencode.ai/v2/cli.json"],
+    [jsonc !== undefined ? jsoncPath : join(directory, "opencode.json"), "https://opencode.ai/config.json", "plugins"],
+    [join(directory, "cli.json"), "https://opencode.ai/v2/cli.json", "plugins"],
+    [tuiJsonc !== undefined ? tuiJsoncPath : join(directory, "tui.json"), "https://opencode.ai/tui.json", "plugin"],
   ]
-  // Validate both documents before writing either one. JSONC edits preserve
+  // Validate every document before writing any of them. JSONC edits preserve
   // comments, trailing commas and unrelated settings.
   const updates = []
-  for (const [path, schema] of targets) {
-    const text = await readOptional(path) ?? JSON.stringify({ $schema: schema, plugins: [] }, null, 2) + "\n"
+  for (const [path, schema, key] of targets) {
+    const text = await readOptional(path) ?? JSON.stringify({ $schema: schema, [key]: [] }, null, 2) + "\n"
     const errors = []
     const config = parse(text, errors, { allowTrailingComma: true })
     if (errors.length || !config || typeof config !== "object" || Array.isArray(config)) {
       throw new Error(`Invalid configuration: ${path}`)
     }
-    const plugins = config.plugins ?? []
-    if (!Array.isArray(plugins)) throw new Error(`Expected a plugins array: ${path}`)
+    const plugins = config[key] ?? []
+    if (!Array.isArray(plugins)) throw new Error(`Expected a ${key} array: ${path}`)
     const present = plugins.some((item) => {
       const spec = typeof item === "string" ? item : item?.package
       return spec === PLUGIN_SPEC || spec?.startsWith(`${PLUGIN_SPEC}@`)
     })
     if (present) continue
-    const result = applyEdits(text, modify(text, ["plugins"], [...plugins, PLUGIN_SPEC], {
+    const result = applyEdits(text, modify(text, [key], [...plugins, PLUGIN_SPEC], {
       formattingOptions: { insertSpaces: true, tabSize: 2 },
     }))
     updates.push([path, result])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-deepseek-peak",
-  "version": "0.1.0",
+  "version": "0.2.2",
   "description": "OpenCode V2 plugin showing DeepSeek peak and off-peak pricing periods",
   "type": "module",
   "keywords": [
@@ -51,6 +51,8 @@
     "jsonc-parser": "^3.3.1"
   },
   "devDependencies": {
+    "@opencode-ai/plugin": "^1.18.16",
+    "@opencode-ai/sdk": "^1.18.16",
     "@opencode/plugin": "^2.0.16",
     "@opentui/core": "^0.5.10",
     "@opentui/solid": "^0.5.10",

package/src/core/display.ts

@@ -1,5 +1,6 @@
 import type { Plugin } from "@opencode/plugin/tui"
-import type { T, TranslationKey } from "../i18n.js"
+import type { LangCode, T, TranslationKey } from "../i18n.js"
+import { nextTransition } from "../schedule.js"
 import type { PeakStatus, TuiSettings } from "../types.js"
 
 export const INITIAL_SETTINGS: TuiSettings = {
@@ -9,6 +10,7 @@ export const INITIAL_SETTINGS: TuiSettings = {
   sidebarEvidence: true,
   toastEveryRequest: false,
   lang: "en",
+  timezone: "local",
 }
 
 export function statusLabel(status: PeakStatus, t: T) {
@@ -26,9 +28,65 @@ const HOLIDAY_KEYS: Record<string, TranslationKey> = {
   "Labour Day": "holiday.labourDay",
 }
 
+export interface LabelOptions {
+  /** Reference instant for the next transition; defaults to now. */
+  now?: Date
+  lang?: LangCode
+  /** IANA time zone; undefined uses the system zone, "UTC" shows the official times. */
+  timeZone?: string
+}
+
+function zoneDate(date: Date, timeZone: string | undefined): string {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+  }).formatToParts(date)
+  const value = (type: Intl.DateTimeFormatPartTypes) => parts.find((part) => part.type === type)?.value ?? ""
+  return `${value("year")}-${value("month")}-${value("day")}`
+}
+
+function formatClock(date: Date, timeZone: string | undefined): string {
+  const parts = new Intl.DateTimeFormat("en-GB", {
+    timeZone,
+    hour: "2-digit",
+    minute: "2-digit",
+    hourCycle: "h23",
+  }).formatToParts(date)
+  const value = (type: Intl.DateTimeFormatPartTypes) => parts.find((part) => part.type === type)?.value ?? ""
+  return `${value("hour")}:${value("minute")}`
+}
+
+/** "10:00 UTC" in UTC mode, "07:00" in the local zone; adds a short weekday on another day. */
+function formatTransitionAt(at: Date, now: Date, lang: LangCode, timeZone: string | undefined): string {
+  const clock = timeZone === "UTC" ? `${formatClock(at, timeZone)} UTC` : formatClock(at, timeZone)
+  if (zoneDate(at, timeZone) === zoneDate(now, timeZone)) return clock
+  const weekday = new Intl.DateTimeFormat(lang, { weekday: "short", timeZone }).format(at)
+  return `${weekday} ${clock}`
+}
+
+/** Localized "peak ends 10:00 UTC" / "peak starts Mon 01:00" for the next change. */
+export function transitionLabel(t: T, options: LabelOptions = {}): string {
+  const now = options.now ?? new Date()
+  const next = nextTransition(now)
+  return t(next.kind === "peakEnd" ? "evidence.peakEnds" : "evidence.peakStarts", {
+    when: formatTransitionAt(next.at, now, options.lang ?? "en", options.timeZone),
+  })
+}
+
+/** Compact sidebar form: ▲ peak starts / ▼ peak ends. Arrows need no translation. */
+export function transitionCompact(options: LabelOptions = {}): string {
+  const now = options.now ?? new Date()
+  const next = nextTransition(now)
+  const arrow = next.kind === "peakEnd" ? "▼" : "▲"
+  return `${arrow} ${formatTransitionAt(next.at, now, options.lang ?? "en", options.timeZone)}`
+}
+
 /** Short, sidebar-friendly, localized version of the status evidence. */
-export function evidenceLabel(status: PeakStatus, t: T): string {
+export function evidenceLabel(status: PeakStatus, t: T, options: LabelOptions = {}): string {
   let label: string
+  let transition = ""
   // An API response header is the source of truth when present.
   if (status.source === "api-header") {
     label = t("evidence.apiHeader", { header: status.evidence.split(":")[0] })
@@ -37,10 +95,11 @@ export function evidenceLabel(status: PeakStatus, t: T): string {
     label = t("evidence.holiday", { name: key ? t(key) : status.holiday })
   } else {
     label = t("evidence.schedule")
+    transition = ` · ${transitionCompact(options)}`
   }
   if (status.evidence.endsWith("(cached)")) label += ` ${t("evidence.cached")}`
   if (status.evidence.includes("no request observed yet")) label += ` ${t("evidence.preview")}`
-  return label
+  return label + transition
 }
 
 /**

package/src/i18n.ts

@@ -10,11 +10,13 @@ export type LangCode = "en" | "pt" | "zh" | "ja" | "ko"
 const EN_T = {
   "period.peak": "PEAK",
   "period.offPeak": "OFF-PEAK",
-  "evidence.schedule": "official schedule",
+  "evidence.schedule": "Official schedule",
   "evidence.apiHeader": "via {header}",
   "evidence.cached": "(cached)",
   "evidence.preview": "(no request yet)",
   "evidence.holiday": "Holiday: {name}",
+  "evidence.peakEnds": "peak ends {when}",
+  "evidence.peakStarts": "peak starts {when}",
   "label.mismatch": "mismatch",
   "toast.title": "DeepSeek pricing",
   "status.title": "DeepSeek Peak",
@@ -22,6 +24,8 @@ const EN_T = {
   "status.noRequest": "No DeepSeek request observed in this session yet.",
   "status.source": "Source",
   "status.evidence": "Evidence",
+  "status.windows": "Peak: 01:00–04:00 and 06:00–10:00 UTC, Mon–Fri, except Chinese public holidays",
+  "status.nextChange": "Next change",
   "status.unavailable": "DeepSeek Peak server plugin is unavailable.",
   "command.status.title": "DeepSeek Peak: Show Status",
   "command.status.description": "Show the last observed DeepSeek pricing period",
@@ -36,6 +40,9 @@ const EN_T = {
   "settings.evidence": "Sidebar evidence",
   "settings.frequency": "Toast frequency",
   "settings.lang": "Language",
+  "settings.timezone": "Timezone",
+  "timezone.local": "Local",
+  "timezone.utc": "UTC",
   "settings.on": "on",
   "settings.off": "off",
   "frequency.change": "on change",
@@ -54,11 +61,13 @@ export type TranslationKey = keyof Translation
 const PT_T: Translation = {
   "period.peak": "PICO",
   "period.offPeak": "FORA DE PICO",
-  "evidence.schedule": "horário oficial",
+  "evidence.schedule": "Horário oficial",
   "evidence.apiHeader": "via {header}",
   "evidence.cached": "(cache)",
   "evidence.preview": "(sem requisição ainda)",
   "evidence.holiday": "Feriado: {name}",
+  "evidence.peakEnds": "pico termina {when}",
+  "evidence.peakStarts": "pico começa {when}",
   "label.mismatch": "divergente",
   "toast.title": "Preço DeepSeek",
   "status.title": "DeepSeek Peak",
@@ -66,6 +75,8 @@ const PT_T: Translation = {
   "status.noRequest": "Nenhuma requisição DeepSeek observada nesta sessão ainda.",
   "status.source": "Fonte",
   "status.evidence": "Evidência",
+  "status.windows": "Pico: 01:00–04:00 e 06:00–10:00 UTC, seg–sex, exceto feriados chineses",
+  "status.nextChange": "Próxima mudança",
   "status.unavailable": "O plugin de servidor do DeepSeek Peak está indisponível.",
   "command.status.title": "DeepSeek Peak: Mostrar status",
   "command.status.description": "Mostra o último período de preço observado da DeepSeek",
@@ -80,6 +91,9 @@ const PT_T: Translation = {
   "settings.evidence": "Evidência na barra lateral",
   "settings.frequency": "Frequência do toast",
   "settings.lang": "Idioma",
+  "settings.timezone": "Fuso horário",
+  "timezone.local": "Local",
+  "timezone.utc": "UTC",
   "settings.on": "ativado",
   "settings.off": "desativado",
   "frequency.change": "ao mudar",
@@ -100,6 +114,8 @@ const ZH_T: Translation = {
   "evidence.cached": "（缓存）",
   "evidence.preview": "（尚无请求）",
   "evidence.holiday": "节假日：{name}",
+  "evidence.peakEnds": "高峰于 {when} 结束",
+  "evidence.peakStarts": "高峰于 {when} 开始",
   "label.mismatch": "不一致",
   "toast.title": "DeepSeek 价格",
   "status.title": "DeepSeek Peak",
@@ -107,6 +123,8 @@ const ZH_T: Translation = {
   "status.noRequest": "此会话尚未观察到 DeepSeek 请求。",
   "status.source": "来源",
   "status.evidence": "证据",
+  "status.windows": "高峰时段：01:00–04:00、06:00–10:00 UTC，周一至周五，中国法定节假日除外",
+  "status.nextChange": "下次变化",
   "status.unavailable": "DeepSeek Peak 服务端插件不可用。",
   "command.status.title": "DeepSeek Peak：显示状态",
   "command.status.description": "显示最近观察到的 DeepSeek 价格时段",
@@ -121,6 +139,9 @@ const ZH_T: Translation = {
   "settings.evidence": "侧边栏证据",
   "settings.frequency": "通知频率",
   "settings.lang": "语言",
+  "settings.timezone": "时区",
+  "timezone.local": "本地",
+  "timezone.utc": "UTC",
   "settings.on": "开",
   "settings.off": "关",
   "frequency.change": "变化时",
@@ -141,6 +162,8 @@ const JA_T: Translation = {
   "evidence.cached": "（キャッシュ）",
   "evidence.preview": "（まだリクエストなし）",
   "evidence.holiday": "祝日：{name}",
+  "evidence.peakEnds": "ピークは {when} に終了",
+  "evidence.peakStarts": "ピークは {when} に開始",
   "label.mismatch": "不一致",
   "toast.title": "DeepSeek 料金",
   "status.title": "DeepSeek Peak",
@@ -148,6 +171,8 @@ const JA_T: Translation = {
   "status.noRequest": "このセッションではまだ DeepSeek リクエストがありません。",
   "status.source": "ソース",
   "status.evidence": "エビデンス",
+  "status.windows": "ピーク：01:00–04:00、06:00–10:00 UTC、月〜金、中国の祝日を除く",
+  "status.nextChange": "次の切り替え",
   "status.unavailable": "DeepSeek Peak サーバープラグインが利用できません。",
   "command.status.title": "DeepSeek Peak：ステータス表示",
   "command.status.description": "最後に観測した DeepSeek 料金期間を表示",
@@ -162,6 +187,9 @@ const JA_T: Translation = {
   "settings.evidence": "サイドバーのエビデンス",
   "settings.frequency": "トースト頻度",
   "settings.lang": "言語",
+  "settings.timezone": "タイムゾーン",
+  "timezone.local": "ローカル",
+  "timezone.utc": "UTC",
   "settings.on": "オン",
   "settings.off": "オフ",
   "frequency.change": "変更時",
@@ -182,6 +210,8 @@ const KO_T: Translation = {
   "evidence.cached": "(캐시)",
   "evidence.preview": "(아직 요청 없음)",
   "evidence.holiday": "공휴일: {name}",
+  "evidence.peakEnds": "피크 {when} 종료",
+  "evidence.peakStarts": "피크 {when} 시작",
   "label.mismatch": "불일치",
   "toast.title": "DeepSeek 요금",
   "status.title": "DeepSeek Peak",
@@ -189,6 +219,8 @@ const KO_T: Translation = {
   "status.noRequest": "이 세션에는 아직 DeepSeek 요청이 없습니다.",
   "status.source": "출처",
   "status.evidence": "근거",
+  "status.windows": "피크: 01:00–04:00, 06:00–10:00 UTC, 월–금, 중국 공휴일 제외",
+  "status.nextChange": "다음 전환",
   "status.unavailable": "DeepSeek Peak 서버 플러그인을 사용할 수 없습니다.",
   "command.status.title": "DeepSeek Peak: 상태 표시",
   "command.status.description": "마지막으로 관측된 DeepSeek 요금 기간 표시",
@@ -203,6 +235,9 @@ const KO_T: Translation = {
   "settings.evidence": "사이드바 근거",
   "settings.frequency": "토스트 빈도",
   "settings.lang": "언어",
+  "settings.timezone": "시간대",
+  "timezone.local": "로컬",
+  "timezone.utc": "UTC",
   "settings.on": "켜짐",
   "settings.off": "꺼짐",
   "frequency.change": "변경 시",

package/src/index.ts

@@ -28,34 +28,41 @@ export default Plugin.define({
         const status = statuses.get(sessionID)
         return status ? { found: true, status } : { found: false }
       },
-      // Lets the TUI show the current period as soon as a session opens with a
-      // DeepSeek model selected, without waiting for the first request.
+      // Re-synthesizes the current period on every call so an idle TUI can
+      // refresh itself without waiting for a request. A recent API header
+      // still wins over the official schedule.
       preview: async (input) => {
         const { sessionID } = input as { sessionID: string }
-        const observed = statuses.get(sessionID)
-        if (observed) return { found: true, status: observed }
         try {
           const session = await context.session.get({ sessionID })
           const model = session.model
           if (!model || !isDeepSeek(model.providerID)) return { found: false }
-          const schedule = scheduleInfo(new Date())
-          const evidence = schedule.holiday
-            ? `Chinese public holiday: ${schedule.holiday} (no request observed yet)`
-            : "Current schedule (no request observed yet)"
+          const observed = statuses.get(sessionID)
+          const now = Date.now()
+          const schedule = scheduleInfo(new Date(now))
+          const cached = apiSignals.get(modelKey(model.providerID, model.id))
+          const api = cached && now - cached.observedAt <= apiSignalTtlMs ? cached : undefined
+          const evidence = api
+            ? `${api.evidence} (cached)`
+            : schedule.holiday
+              ? `Chinese public holiday: ${schedule.holiday}${observed ? "" : " (no request observed yet)"}`
+              : observed
+                ? "DeepSeek official UTC pricing schedule"
+                : "Current schedule (no request observed yet)"
           return {
             found: true,
             status: {
               sessionID,
               providerID: model.providerID,
               modelID: model.id,
-              period: schedule.period,
+              period: api?.period ?? schedule.period,
               scheduledPeriod: schedule.period,
-              source: "official-schedule",
-              phase: "request",
-              mismatch: false,
-              observedAt: Date.now(),
+              source: api ? "api-header" : "official-schedule",
+              phase: observed?.phase ?? "request",
+              mismatch: api ? api.period !== schedule.period : false,
+              observedAt: now,
               evidence,
-              holiday: schedule.holiday,
+              ...(schedule.holiday !== undefined ? { holiday: schedule.holiday } : {}),
             },
           }
         } catch {
@@ -93,7 +100,7 @@ export default Plugin.define({
           : schedule.holiday
             ? `Chinese public holiday: ${schedule.holiday}`
             : "DeepSeek official UTC pricing schedule",
-        holiday: schedule.holiday,
+        ...(schedule.holiday !== undefined ? { holiday: schedule.holiday } : {}),
       })
     })
 
@@ -118,7 +125,7 @@ export default Plugin.define({
         mismatch: api.period !== schedule.period,
         observedAt: now,
         evidence: api.evidence,
-        holiday: schedule.holiday,
+        ...(schedule.holiday !== undefined ? { holiday: schedule.holiday } : {}),
       })
     })
 

package/src/panel/PeakPanel.tsx

@@ -17,6 +17,7 @@ export interface IndicatorProps {
 
 export interface PanelProps extends IndicatorProps {
   evidence: () => boolean
+  timeZone: () => string | undefined
 }
 
 export function PeakPanel(props: PanelProps) {
@@ -51,7 +52,11 @@ export function PeakPanel(props: PanelProps) {
           <For each={segments()}>{(segment) => <span style={{ fg: segment.color }}>{segment.text}</span>}</For>
         </text>
         <Show when={props.evidence() ? props.status() : undefined}>
-          {(status) => <text fg={themeColors(props.context.theme).muted}>{evidenceLabel(status(), t)}</text>}
+          {(status) => (
+            <text wrapMode="none" fg={themeColors(props.context.theme).muted}>
+              {evidenceLabel(status(), t, { lang: props.lang(), timeZone: props.timeZone() })}
+            </text>
+          )}
         </Show>
       </box>
     </Show>

package/src/schedule.ts

@@ -56,6 +56,45 @@ export function scheduleInfo(
   return { period: peakWindow(date) }
 }
 
+export interface Transition {
+  kind: "peakStart" | "peakEnd"
+  /** Instant of the next change of the official schedule. */
+  at: Date
+}
+
+function utcAt(date: Date, dayOffset: number, hour: number): Date {
+  return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate() + dayOffset, hour))
+}
+
+function isPeakDay(date: Date, holidayName: (value: Date) => string | undefined): boolean {
+  const day = date.getUTCDay()
+  return day !== 0 && day !== 6 && holidayName(date) === undefined
+}
+
+/**
+ * Next instant at which the official schedule changes period, considering the
+ * two weekday peak windows and China's public holidays.
+ */
+export function nextTransition(
+  date: Date,
+  holidayName: (value: Date) => string | undefined = chinesePublicHoliday,
+): Transition {
+  if (scheduleInfo(date, holidayName).period === "peak") {
+    return { kind: "peakEnd", at: utcAt(date, 0, date.getUTCHours() < 4 ? 4 : 10) }
+  }
+  // Off-peak: the earliest future peak start on a weekday without a holiday.
+  // A public holiday can run for several consecutive days, so scan further.
+  for (let offset = 0; offset < 15; offset += 1) {
+    if (!isPeakDay(utcAt(date, offset, 0), holidayName)) continue
+    for (const hour of [1, 6]) {
+      const candidate = utcAt(date, offset, hour)
+      if (candidate.getTime() > date.getTime()) return { kind: "peakStart", at: candidate }
+    }
+  }
+  // date-holidays always yields a working weekday within two weeks; keep a fallback.
+  return { kind: "peakStart", at: utcAt(date, 1, 1) }
+}
+
 export function officialPricePeriod(
   date: Date,
   holidayCheck: (value: Date) => boolean = isChinesePublicHoliday,

package/src/tui.tsx

@@ -21,6 +21,8 @@ const mod: Plugin.Definition = {
     // Stored settings may predate the `lang` field.
     const lang = () => (settings.lang ?? detectLang()) as LangCode
     const t = createT(lang)
+    // Local by default; `utc` pins the official schedule times.
+    const timeZone = () => (settings.timezone === "utc" ? "UTC" : undefined)
     const [statuses, setStatuses] = createSignal<Record<string, PeakStatus>>({})
     const lastToast = new Map<string, string>()
 
@@ -40,13 +42,19 @@ const mod: Plugin.Definition = {
     })
 
     const readStatus = async (sessionID: string) => {
-      const result = await client.status({ sessionID }) as { found: boolean; status?: PeakStatus }
-      if (result.found && result.status) return result.status
+      // Preview re-synthesizes the current schedule, so an idle session stays
+      // fresh; it already folds in a recent API header when one exists.
       try {
         const preview = await client.preview({ sessionID }) as { found: boolean; status?: PeakStatus }
-        return preview.found ? preview.status : undefined
-      } catch {
+        if (preview.found && preview.status) return preview.status
         return undefined
+      } catch {
+        try {
+          const result = await client.status({ sessionID }) as { found: boolean; status?: PeakStatus }
+          return result.found ? result.status : undefined
+        } catch {
+          return undefined
+        }
       }
     }
 
@@ -60,10 +68,22 @@ const mod: Plugin.Definition = {
         .catch(() => {})
     }
 
+    // Keep the period and the next-change label fresh while the session is idle.
+    const timer = setInterval(() => {
+      for (const sessionID of Object.keys(statuses())) refresh(sessionID)
+    }, 30_000)
+
     const unregisterCommands = context.ui.slot({
       append: "app",
       render: () => (
-        <CommandRoot context={context} settings={settings} update={update} readStatus={readStatus} lang={lang} />
+        <CommandRoot
+          context={context}
+          settings={settings}
+          update={update}
+          readStatus={readStatus}
+          lang={lang}
+          timeZone={timeZone}
+        />
       ),
     })
     const unregisterSidebar = context.ui.slot({
@@ -77,6 +97,7 @@ const mod: Plugin.Definition = {
             enabled={() => settings.sidebarIndicator !== false}
             evidence={() => settings.sidebarEvidence !== false}
             lang={lang}
+            timeZone={timeZone}
             sessionID={sessionID}
             refresh={refresh}
           />
@@ -101,6 +122,7 @@ const mod: Plugin.Definition = {
     })
 
     return () => {
+      clearInterval(timer)
       unsubscribe()
       unregisterCommands()
       unregisterSidebar()

package/src/types.ts

@@ -3,6 +3,7 @@ import type { LangCode } from "./i18n.js"
 export type PricePeriod = "peak" | "off-peak"
 export type StatusSource = "official-schedule" | "api-header"
 export type StatusPhase = "request" | "response"
+export type TimezoneMode = "local" | "utc"
 
 export interface PeakStatus {
   sessionID: string
@@ -26,4 +27,5 @@ export interface TuiSettings {
   sidebarEvidence: boolean
   toastEveryRequest: boolean
   lang: LangCode
+  timezone: TimezoneMode
 }