dsh-cost-meter 1.6.2 → 1.6.4

package/lib/coding-plans.js

@@ -513,9 +513,12 @@ export const VOLCENGINE_SERVICE = 'ark'
 export const VOLCENGINE_REGION = 'cn-beijing'
 export const VOLCENGINE_VERSION = '2024-01-01'
 // 管控面 Action 白名单(按序尝试;需 AK/SK+HMAC 签名,非 Bearer)。
-// 实测(issue #60 评论 by @sanqiPanax, v1.5.46):GetAFPUsage 无参即可返回 5h/weekly/monthly+daily 三窗,而 GetUsageDetails 裸调 400(缺 Filter.StartTime),
-// GetPersonalPlan 亦需额外参数;为减少一次 400 探测,优先 GetAFPUsage。
-export const VOLCENGINE_ACTIONS = ['GetAFPUsage', 'GetUsageDetails', 'GetPersonalPlan']
+// GetCodingPlanUsage 为 CodingPlan 官方用量接口(issue #71 实测 by @suyukun):
+// 无参即可返回 Result.QuotaUsage[] 三窗(session/weekly/monthly,只含 Percent),
+// 置于首位;GetAFPUsage 实为 AgentPlan 接口(issue #60 评论 by @sanqiPanax,
+// v1.5.46),CodingPlan 用户拿到全 0/空,GetUsageDetails 裸调 400(缺
+// Filter.StartTime),GetPersonalPlan 亦需额外参数,保留作兜底变体。
+export const VOLCENGINE_ACTIONS = ['GetCodingPlanUsage', 'GetAFPUsage', 'GetUsageDetails', 'GetPersonalPlan']
 
 function hmacSha256(key, data) {
   return createHmac('sha256', key).update(data, 'utf8').digest()
@@ -588,8 +591,9 @@ function normalizeVolcWindowName(raw) {
 }
 
 /**
- * 解析火山方舟用量响应(管控面 GetUsageDetails / GetAFPUsage / GetPersonalPlan 等)。
- * 形似 { ResponseMetadata:..., Result: { UsageDetails:[{QuotaType,Total,Used,Remaining,ResetTime}], ... } }
+ * 解析火山方舟用量响应(管控面 GetCodingPlanUsage / GetUsageDetails / GetAFPUsage / GetPersonalPlan 等)。
+ * CodingPlan 官方形态 { Result: { QuotaUsage:[{Level:'session'|'weekly'|'monthly', Percent, ResetTimestamp, Cap}], ... } }(issue #71,
+ * 只返 Percent,无 used/total);或 { ResponseMetadata:..., Result: { UsageDetails:[{QuotaType,Total,Used,Remaining,ResetTime}], ... } }
  * 或 arkcli usage plan 的 { items:[{product:"coding-plan",periods:[{label:"session"/"weekly"/"monthly",percent,reset_at}]}] }
  * 或扁平窗口对象 { fiveHour:{used,limit,reset}, weekly:{...}, monthly:{...} }。
  * 容忍多种字段命名与大小写,百分比由 used/total 推导(或直接取 percent),非法窗口忽略。
@@ -640,7 +644,7 @@ export function parseVolcengineUsage(data) {
   // 尝试定位配额数组字段
   let quotaList = null
   if (root !== null && typeof root === 'object') {
-    quotaList = root.UsageDetails ?? root.usageDetails ?? root.usages ?? root.limits ?? root.quotas ?? root.windows ?? root.periods ?? root.details ?? root.items ?? null
+    quotaList = root.QuotaUsage ?? root.quotaUsage ?? root.UsageDetails ?? root.usageDetails ?? root.usages ?? root.limits ?? root.quotas ?? root.windows ?? root.periods ?? root.details ?? root.items ?? null
     if (!Array.isArray(quotaList) && Array.isArray(root)) quotaList = root
     // 单个Result包装对象里可能直接含窗口字段
     if (quotaList === null && typeof root === 'object' && !Array.isArray(root)) {
@@ -660,7 +664,9 @@ export function parseVolcengineUsage(data) {
     const windows = {}
     for (const entry of quotaList) {
       if (entry === null || typeof entry !== 'object') continue
-      const nameRaw = entry.QuotaType ?? entry.quotaType ?? entry.Type ?? entry.type ?? entry.Label ?? entry.label ?? entry.Period ?? entry.period ?? entry.Name ?? entry.name ?? entry.Window ?? entry.window ?? entry.QuotaName ?? entry.quotaName
+      // GetCodingPlanUsage 的窗口名字段为 Level(session/weekly/monthly,issue #71),
+      // 置于候选最前;其余 Action 沿用 QuotaType 等既有字段。
+      const nameRaw = entry.Level ?? entry.level ?? entry.QuotaType ?? entry.quotaType ?? entry.Type ?? entry.type ?? entry.Label ?? entry.label ?? entry.Period ?? entry.period ?? entry.Name ?? entry.name ?? entry.Window ?? entry.window ?? entry.QuotaName ?? entry.quotaName
       let name = normalizeVolcWindowName(nameRaw)
       if (name === null) continue
       let pct = null

package/lib/index.js

@@ -18,10 +18,10 @@ import fs from 'node:fs'
 import { join } from 'node:path'
 import { credentialRef } from '@deepseek-ai/dsh-credentials'
 import { resolveDshHome } from '@deepseek-ai/dsh-home-paths'
-import { Ledger, applyConfigPatch, localDayKey, pickBalanceInfo, reconcileBalanceDelta, zeroDay, splitLedgerApiCost, repairLedgerPricing } from './store.js'
+import { Ledger, applyConfigPatch, localDayKey, pickBalanceInfo, reconcileBalanceDelta, zeroDay, splitLedgerApiCost, repairLedgerPricing, dedupeWrapperProviderDays } from './store.js'
 import { backfillLegacyLedger, importLegacyHistory, repairForkSeed, repairProviderDupes } from './backfill.js'
 import { createLlmStreamBilling } from './billing-stream.js'
-import { OFFICIAL_PRICING_URL, OFFICIAL_PRICING_URL_ZH, normalizePrice, parsePricingHtml, costOf, providerPriceEntryFor, buildPriceCatalog, usdFromCost } from './pricing.js'
+import { OFFICIAL_PRICING_URL, OFFICIAL_PRICING_URL_ZH, normalizePrice, parsePricingHtml, costOf, providerPriceEntryFor, buildPriceCatalog, usdFromCost, isWrapperProviderId } from './pricing.js'
 import { CODING_PLAN_PROVIDERS, CODING_PLAN_PROVIDER_IDS, queryCodingPlan, scnetTokenPlanWindows, emptyCustomBalance, queryCustomBalance, normalizeVolcengineKey } from './coding-plans.js'
 import { recordSamples, buildPlanStats, canonicalWindowKey, periodStartOf, aggregateUsageSince, enabledPlanSetOf, pruneHourBuckets, suggestPlanAutoClasses } from './plan-billing.js'
 import { fetchWithRetry } from './net.js'
@@ -414,6 +414,11 @@ function makeCostUsageProjection(ledger) {
       } else {
         return state
       }
+      // modlens 视觉包装层(modlens-<upstream> / deepseek-modlens)把同一份 usage
+      // 经上游 llm.stream 再转发一次:日志里同一调用出现两套 header+usage 事件,
+      // 且因 provider 不同绕过 (turn, step) 键去重,投影会翻倍(issue #70)。与账本
+      // 钩子一致,包装层 provider 状态下的 usage 事件跳过,只统计上游真实流。
+      if (isWrapperProviderId(state.provider)) return state
       const buckets = {
         input: usage.inputTokens ?? 0,
         output: usage.outputTokens ?? 0,
@@ -1487,6 +1492,21 @@ export async function runStartupImports(ledger, sessionsRoot) {
       console.log(`[dsh-cost-meter] 包装路由重复计费清洗完成:合并 ${repaired.groups} 组重复条目,扣除 ${repaired.removedCost.toFixed(4)} USD`)
     }
   }
+  // modlens 视觉包装层镜像一次性清洗(issue #70):现行 modlens 在监听器体内
+  // 急切发起上游调用,逃逸 ALS 嵌套标记,上游与包装层(modlens-<upstream> /
+  // deepseek-modlens)各入账一次,token/费用整体翻倍。实时钩子/投影/回放的
+  // 包装层跳过已堵住新污染,此处修正历史存量:镜像对扣除包装层份,仅包装层
+  // 入账的残留(provider-dedup-v1 合并后只剩字母序靠前的包装层键)改挂上游键。
+  if (!ledger.migrations.includes('modlens-wrapper-dedup-v1')) {
+    const repaired = dedupeWrapperProviderDays(ledger.days ?? {})
+    ledger.migrations.push('modlens-wrapper-dedup-v1')
+    if (repaired.removed + repaired.renamed > 0) {
+      // 改挂上游键的条目 provider 变了,plan/api 分类需按新 provider 重算。
+      splitLedgerApiCost(ledger)
+      ledger.scheduleWrite()
+      console.log(`[dsh-cost-meter] modlens 包装层重复计费清洗完成:扣除 ${repaired.removed} 条镜像,${repaired.renamed} 条改挂上游 provider`)
+    }
+  }
   // Plan/API 双轨拆分一次性迁移(issue #64):历史账本按当前分类回溯重算
   // apiCost(真金白银部分),plan 类条目金额只记等值;幂等,标记防重跑。
   if (!ledger.migrations.includes('plan-billing-split-v1')) {
@@ -1577,8 +1597,13 @@ export function apply(ctx) {
   // 体内再发起 ctx.llm.stream(),旧实现在瀑布每层都记账(同请求 ×2~3);
   // createLlmStreamBilling 用 AsyncLocalStorage 深度标记识别嵌套调用,
   // 只由最外层记一次。历史污染由启动期 provider-dedup-v1 清洗兜底。
+  // 包装层跳过(issue #70):现行 modlens(modlens-<upstream> id 方案)在监听器
+  // 体内(瀑布派发期)急切发起上游调用,逃逸 ALS 深度标记,上游与包装层两份
+  // usage 都到达这里——账本对 provider 为包装层 id 的事件直接跳过,只记上游
+  // 真实流;历史翻倍由启动期 modlens-wrapper-dedup-v1 清洗兜底。
   ctx.on('llm/stream', createLlmStreamBilling({
     account: (usage, model, sessionId, atMs, provider) => {
+      if (isWrapperProviderId(provider)) return
       ledger.account({
         input: usage.inputTokens ?? 0,
         output: usage.outputTokens ?? 0,

package/lib/pricing.js

@@ -720,6 +720,37 @@ function deepseekExplicitEntry(modelName, prices, mode) {
   return { entry, billingMode: 'deepseek-peak', priced: true }
 }
 
+/**
+ * 是否 modlens 视觉包装层 provider id(`modlens-<upstream>` / `deepseek-modlens`)。
+ *
+ * modlens 插件(@liustack/modlens)为每条承载纯文本 DeepSeek/GLM 模型的 provider
+ * 路由自动注册「(modlens vision)」包装模型,provider id 形如 `modlens-opencode-go`
+ * (deepseek-official 路由固定为 `deepseek-modlens`)。包装层会在自身监听器体内
+ * 再发起一次上游 llm.stream 转发同一份 usage——该内层分发发生在瀑布派发期,
+ * 逃逸 billing-stream 的 ALS 深度标记,实时钩子与历史回放照单全收会把每次调用
+ * 记两遍(上游 + 包装层,issue #70 实测账本 token/费用整体翻倍)。统一判定函数
+ * 供各计费入口(实时钩子 / 会话投影 / 历史回放 / 账本清洗)跳过包装层、只记上游真实流。
+ */
+export function isWrapperProviderId(provider) {
+  if (typeof provider !== 'string' || provider.length === 0) return false
+  return provider.startsWith('modlens-') || provider === 'deepseek-modlens'
+}
+
+/**
+ * 包装层 provider 对应的上游 provider id:`modlens-opencode-go` → `opencode-go`,
+ * `deepseek-modlens` → `deepseek-official`(modlens 对官方路由的固定包装名);
+ * 非包装层返回 null。供账本清洗把「仅包装层入账」的存量条目改挂回上游键。
+ */
+export function wrapperUpstreamProvider(provider) {
+  if (typeof provider !== 'string' || provider.length === 0) return null
+  if (provider === 'deepseek-modlens') return 'deepseek-official'
+  if (provider.startsWith('modlens-')) {
+    const upstream = provider.slice('modlens-'.length)
+    return upstream.length > 0 ? upstream : null
+  }
+  return null
+}
+
 /**
  * provider-aware 价格查找。provider 缺失时保持旧版 DeepSeek 行为；
  * 已知非 DeepSeek provider 未配置模型时返回 null，避免误套 DeepSeek default。

package/lib/store.js

@@ -18,6 +18,8 @@ import {
   priceEntryFor,
   providerPriceEntryFor,
   usdFromCost,
+  isWrapperProviderId,
+  wrapperUpstreamProvider,
 } from './pricing.js'
 import { CODING_PLAN_PROVIDER_IDS } from './coding-plans.js'
 import { DEFAULT_PLAN_PROVIDER_CLASS, PLAN_PROVIDER_IDS, billingClassOf, enabledPlanSetOf, planProviderIdOf, appendHourBucket, pruneHourBuckets, convertRecentCallsToBuckets, isRoutedThirdPartyCall } from './plan-billing.js'
@@ -140,6 +142,16 @@ export function defaultConfig() {
       plans: true, // 横条含已启用的 Coding Plan 窗口
       promptSeen: false, // 首次更新后的功能引导是否已处理(用户自主决定开关)
     },
+    // 进度条方向(issue #67):各条独立选择填充语义。
+    //  balance = 余额条(官方/自定义):默认 remaining(满条起步随消耗递减);
+    //  budget/go/plan = 预算与额度条:默认 used(空条起步随消耗填满,#57 统一口径)。
+    // 值只能是 'remaining' | 'used',语义为「填充代表什么」。
+    barDirections: {
+      balance: 'remaining',
+      budget: 'used',
+      go: 'used',
+      plan: 'used',
+    },
     usage: {
       position: 'cost', // Token 用量统计显示位置:cost(费用设置) | general(通用设置) | section(独立分节)
     },
@@ -361,6 +373,92 @@ export function repairLedgerPricing(ledger) {
   return { touchedDays, touchedSessions, recostedBuckets }
 }
 
+/**
+ * modlens 视觉包装层镜像一次性清洗(issue #70)。
+ *
+ * 现行 modlens(modlens-<upstream> / deepseek-modlens)在监听器体内急切发起
+ * 上游 llm.stream,逃逸 billing-stream 的 ALS 嵌套标记,同一次调用在上游与
+ * 包装层两个 provider 键下各入账一次(六值桶逐位相同),token/费用整体翻倍。
+ *
+ * 与 provider-dedup-v1(issue #48 指纹合并,保留字母序第一个键)的遗留交互
+ * 需要区分三种形态,逐容器(day 与其下每个 session)处理:
+ *  1. 镜像对:上游键与包装层键六值桶全等 → 从容器合计扣除包装层份并删除
+ *     (真实上游键本就存在,扣减即恢复真实值);
+ *  2. 包装层 ⊃ 上游(#48 合并过旧镜像、之后又积累新镜像的混存形态:
+ *     包装层键 = 合并残留 + 新镜像,上游键 = 新镜像):上游键是包装层键的
+ *     子集 → 扣除并删除上游键,包装层键改挂上游 provider 名;
+ *  3. 无上游键(仅有包装层入账,如 #48 合并后只剩字母序靠前的包装层键):
+ *     包装层键改挂上游 provider 名,合计不动;
+ *  4. 包装层 ⊂ 上游(同日直连 + 包装调用混存:上游键 = 直连量 + 全部包装
+ *     调用量,包装层键是纯镜像子集)→ 从容器合计扣除包装层份并删除。
+ * 六值桶互不为子集(无法安全判定)的条目不动(保守);幂等,二次运行无
+ * 包装层键时返回 0。调用方以账本 migrations 标记保证只跑一次。
+ * @param days - 账本每日记录对象(原地修改)。
+ * @returns { removed, renamed } 扣除删除的镜像条目数 / 改挂上游键的条目数。
+ */
+export function dedupeWrapperProviderDays(days) {
+  const result = { removed: 0, renamed: 0 }
+  const FIELDS = ['input', 'output', 'cacheRead', 'cacheWrite', 'reasoning', 'calls']
+  const num = (v) => (Number.isFinite(Number(v)) ? Number(v) : 0)
+  const fingerprint = (b) => FIELDS.map(f => num(b?.[f])).join('|')
+  const isSubset = (small, big) => FIELDS.every(f => num(small?.[f]) <= num(big?.[f]))
+  const subtractInto = (container, bucket) => {
+    for (const f of [...FIELDS, 'cost', 'apiCost']) {
+      container[f] = Math.max(0, num(container[f]) - num(bucket?.[f]))
+    }
+  }
+  const repairContainer = (container) => {
+    const pm = container?.byProviderModel
+    if (pm === null || typeof pm !== 'object' || Array.isArray(pm)) return
+    for (const key of Object.keys(pm)) {
+      const sep = key.indexOf(':')
+      if (sep <= 0) continue
+      const provider = key.slice(0, sep)
+      if (!isWrapperProviderId(provider)) continue
+      const model = key.slice(sep + 1)
+      const upstream = wrapperUpstreamProvider(provider)
+      if (upstream === null) continue
+      const bucket = pm[key]
+      const twinKey = `${upstream}:${model}`
+      const twin = pm[twinKey]
+      if (twin === undefined) {
+        // 形态 3:仅包装层入账——改挂上游键,容器合计不动。
+        delete pm[key]
+        pm[twinKey] = bucket
+        result.renamed += 1
+      } else if (fingerprint(twin) === fingerprint(bucket)) {
+        // 形态 1:经典镜像对——扣除包装层份并删除,上游键即真实值。
+        subtractInto(container, bucket)
+        delete pm[key]
+        result.removed += 1
+      } else if (isSubset(twin, bucket)) {
+        // 形态 2:上游键 ⊆ 包装层键(混存残留)——扣除并删除上游键,包装层改挂上游。
+        subtractInto(container, twin)
+        delete pm[key]
+        pm[twinKey] = bucket
+        result.renamed += 1
+      } else if (isSubset(bucket, twin)) {
+        // 形态 4:包装层键 ⊆ 上游键(同日直连 + 包装调用混存:上游键含直连量 +
+        // 全部包装调用量,包装层键是纯镜像子集)——扣除包装层份并删除。
+        subtractInto(container, bucket)
+        delete pm[key]
+        result.removed += 1
+      }
+      // 其余:互不为子集,无法安全判定,保守不动。
+    }
+  }
+  for (const day of Object.values(days ?? {})) {
+    if (day === null || typeof day !== 'object') continue
+    repairContainer(day)
+    if (Array.isArray(day.sessions)) {
+      for (const session of day.sessions) {
+        if (session !== null && typeof session === 'object') repairContainer(session)
+      }
+    }
+  }
+  return result
+}
+
 function zeroSession(id) {
   return { id, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0, calls: 0, cost: 0, apiCost: 0, byProviderModel: {} }
 }
@@ -506,6 +604,8 @@ const VALIDATION_MESSAGES = {
     cornerFlag: 'corner.{field} 必须是布尔值',
     quotaStrip: 'quotaStrip 非法',
     quotaStripFlag: 'quotaStrip.{field} 必须是布尔值',
+    barDirections: 'barDirections 非法',
+    barDirectionValue: 'barDirections.{field} 必须是 remaining / used',
     usage: 'usage 非法',
     usagePosition: 'usage.position 必须是 cost / general / section',
     planBilling: 'planBilling 非法',
@@ -583,6 +683,8 @@ const VALIDATION_MESSAGES = {
     cornerFlag: 'corner.{field} must be a boolean',
     quotaStrip: 'Invalid quotaStrip',
     quotaStripFlag: 'quotaStrip.{field} must be a boolean',
+    barDirections: 'Invalid barDirections',
+    barDirectionValue: 'barDirections.{field} must be remaining / used',
     usage: 'Invalid usage',
     usagePosition: 'usage.position must be cost / general / section',
     planBilling: 'Invalid planBilling',
@@ -831,6 +933,18 @@ export function applyConfigPatch(current, patch) {
       if (typeof quotaStrip[field] !== 'boolean') errors.push(vmsg(locale, 'quotaStripFlag', { field }))
     }
   }
+  // 进度条方向(issue #67):四组条各自 remaining / used,非法值整体报错
+  // (客户端提交完整对象,与 corner/quotaStrip 同策略)。
+  const barDirections = candidate.barDirections
+  if (barDirections === null || typeof barDirections !== 'object' || Array.isArray(barDirections)) {
+    errors.push(vmsg(locale, 'barDirections'))
+  } else {
+    for (const field of ['balance', 'budget', 'go', 'plan']) {
+      if (barDirections[field] !== 'remaining' && barDirections[field] !== 'used') {
+        errors.push(vmsg(locale, 'barDirectionValue', { field }))
+      }
+    }
+  }
   // Token 用量统计显示位置校验。
   const usage = candidate.usage
   if (usage === null || typeof usage !== 'object' || Array.isArray(usage)) {
@@ -1036,6 +1150,15 @@ export function sanitizeConfig(raw) {
   strip.enabled = strip.enabled === true
   strip.promptSeen = strip.promptSeen === true
   for (const key of ['budget', 'go', 'plans']) strip[key] = strip[key] !== false
+  // 进度条方向(issue #67):非法值逐键回落默认(balance=remaining,其余=used)。
+  const dirs = out.barDirections !== null && typeof out.barDirections === 'object' && !Array.isArray(out.barDirections)
+    ? out.barDirections : {}
+  out.barDirections = {
+    balance: dirs.balance === 'used' ? 'used' : 'remaining',
+    budget: dirs.budget === 'remaining' ? 'remaining' : 'used',
+    go: dirs.go === 'remaining' ? 'remaining' : 'used',
+    plan: dirs.plan === 'remaining' ? 'remaining' : 'used',
+  }
   // codingPlans:逐家收敛(非法条目整家回落默认;只保留已知提供商)。
   const plans = {}
   if (out.codingPlans !== null && typeof out.codingPlans === 'object') {

package/lib/typert.host.js

@@ -199,6 +199,13 @@ const configSchema = z.object({
     plans: z.boolean(),
     promptSeen: z.boolean(),
   }),
+  // 进度条方向(issue #67):balance/budget/go/plan 各自 remaining | used。
+  barDirections: z.object({
+    balance: z.enum(['remaining', 'used']),
+    budget: z.enum(['remaining', 'used']),
+    go: z.enum(['remaining', 'used']),
+    plan: z.enum(['remaining', 'used']),
+  }).optional(),
   // Token 用量统计显示位置(当前固定 cost;键保留供读侧白名单)。
   usage: z.object({ position: z.enum(['cost', 'general', 'section']) }).optional(),
   // Plan/API 双轨计费分类(issue #64):providers 值 auto/plan/api;models 为 provider:model 显式覆盖。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cost-meter",
-  "version": "1.6.2",
+  "version": "1.6.4",
   "description": "DeepSeek Harness 会话费用统计插件:本会话成本、当日费用、历史记录与官方价格同步,支持多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配)、主流 Coding Plan 订阅额度查询与显示(9 家,含 SCNet Token Plan 本地 Credits 计量与火山方舟 Volcano Ark Coding Plan AK/SK 签名查询)、自定义 Provider 余额查询(可配任意 HTTP 端点)与余额进度条、峰谷计价时段显示与切换前弹窗/系统通知提醒(位置/提前量/类型可配),界面中英双语。Session cost tracking plugin for DeepSeek Harness: per-conversation cost, daily totals, history and official price sync, with multi-vendor model pricing (built-in 90+ model catalog with auto-matching), Coding Plan quota queries & display for 9 vendors (incl. local credits metering for the SCNet Token Plan and Volcano Ark Coding Plan via AK/SK signature), plan/API dual-track billing with per-1% & full-window Token Plan usage estimates, custom provider balance lookup (configurable HTTP endpoint) and balance progress bar, plus peak/off-peak pricing display with pre-switch popup & system-notification alerts (position / lead time / type configurable), in a bilingual (Chinese/English) UI.",
   "type": "module",
   "main": "lib/index.js",
@@ -61,9 +61,9 @@
     "docs/provider-pricing.json"
   ],
   "dependencies": {
-    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6",
-    "zod": "^4.4.3"
+    "@deepseek-ai/dsh-credentials": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-home-paths": "0.1.0-rc.6",
+    "zod": "4.4.3"
   },
   "repository": {
     "type": "git",
@@ -86,5 +86,11 @@
     "en",
     "language"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "scripts": {
+    "build": "node scripts/build.mjs"
+  },
+  "devDependencies": {
+    "esbuild": "^0.28.1"
+  }
 }