@goodandready/dsh-clinebot 0.6.4 → 0.6.6

package/lib/cline-client.js

@@ -1,6 +1,5 @@
 import { createHash } from 'node:crypto'
 export {
-  toCredentialRef,
   resolveApiKey,
   saveCredentialKey,
   deleteCredentialKey,
@@ -16,8 +15,6 @@ export {
 
 import {
   DEFAULT_MODEL_ID,
-  PROVIDER_ID,
-  PROVIDER_DISPLAY_NAME,
   parsePlanIncludedModels,
 } from './models.js'
 
@@ -28,7 +25,7 @@ export const DEFAULT_SMOKE_TIMEOUT_MS = 25000
 export const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 30000
 const USAGE_CACHE_TTL_MS = 60000
 
-export { PROVIDER_ID, PROVIDER_DISPLAY_NAME, DEFAULT_MODEL_ID }
+export { DEFAULT_MODEL_ID }
 
 // Credentials helpers extracted to ./credential-refs.js
 

package/lib/credential-refs.js

@@ -25,7 +25,7 @@ function credentialsService(ctx) {
   }
 }
 
-export async function toCredentialRef(name) {
+async function toCredentialRef(name) {
   try {
     const mod = await import('@deepseek-ai/dsh-credentials')
     if (typeof mod.credentialRef === 'function') {

package/lib/http.js

@@ -46,7 +46,7 @@ function header(request, name) {
   return Array.isArray(value) ? value[0] : value
 }
 
-export function isLoopbackAddress(value) {
+function isLoopbackAddress(value) {
   const address = String(value || '').toLowerCase().replace(/^\[|\]$/g, '')
   return address === 'localhost' || address === 'localhost.' || address === '::1'
     || address.startsWith('127.')

package/lib/model-prices.js

@@ -7,7 +7,7 @@
  * no known or overridden rate stays `unpriced` rather than being shown as $0.
  */
 
-export const PRICE_TABLE_VERSION = 1
+const PRICE_TABLE_VERSION = 1
 
 const OPEN_WEIGHT = Object.freeze({ input: 0.15, output: 0.6, cacheRead: 0.003, cacheWrite: null })
 const CLAUDE = Object.freeze({ input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 })

package/lib/models.js

@@ -72,7 +72,7 @@ export function getOriginalModelMaxTokens(nameOrId) {
   return 16384
 }
 
-export function getOriginalModelProvider(nameOrId) {
+function getOriginalModelProvider(nameOrId) {
   const norm = String(nameOrId || '').toLowerCase()
   if (norm.includes('kimi')) return 'Moonshot AI'
   if (norm.includes('qwen')) return 'Alibaba Cloud'

package/lib/provider-sync.js

@@ -43,7 +43,7 @@ export function resolvePathWithHome(p) {
   return p
 }
 
-export async function checkRegisteredInLlm(ctx) {
+async function checkRegisteredInLlm(ctx) {
   try {
     const llm = ctx?.get?.('llm')
     if (llm && typeof llm.listProviders === 'function') {

package/lib/slash-command.js

@@ -1,5 +1,7 @@
 import { publicConfig, plainConfig, Config } from './config.js'
 import { resolveActiveAccountKey, formatProgressBar } from './provider-sync.js'
+import { getBudgetSpend } from './stats-storage.js'
+import { budgetStatus, budgetErrorMessage } from './budget.js'
 import { resolveAccountPool, rotateToNextAccount, getLastRotation } from './account-pool.js'
 import {
   getAllModels,
@@ -148,7 +150,27 @@ export function registerSlashCommand(ctx, { live, getSettingsApi, syncProviderSt
           return `Cline API Ping Failed: ${health.error || 'Host unreachable'}`
         }
 
-        // 6. Subcommand /cline stats (real DSH stream metrics)
+        // 6. Subcommand /cline cost or /cline budget
+        if (subcmd === 'cost' || subcmd === 'budget') {
+          const spend = getBudgetSpend()
+          const daily = budgetStatus({ dailyBudgetUsd: pub.dailyBudgetUsd }, spend)
+          const monthly = budgetStatus({ monthlyBudgetUsd: pub.monthlyBudgetUsd }, spend)
+          const money = (value) => `$${Number(value || 0).toFixed(4)}`
+          const limit = (value) => Number(value) > 0 ? money(value) : 'off'
+          const lines = [
+            `ClineBot Estimated Spend · today ${money(spend.dayCost)} · month ${money(spend.monthCost)}`,
+            '',
+            `Today:   ${money(spend.dayCost)} / ${limit(pub.dailyBudgetUsd)}`,
+            `Month:   ${money(spend.monthCost)} / ${limit(pub.monthlyBudgetUsd)}`,
+            `Daily guard:   ${daily.blocked ? `BLOCKED — ${budgetErrorMessage(daily)}` : 'ok'}`,
+            `Monthly guard: ${monthly.blocked ? `BLOCKED — ${budgetErrorMessage(monthly)}` : 'ok'}`,
+            '',
+            'Set limits in Settings -> ClineBot -> Advanced.',
+          ]
+          return lines.join('\n')
+        }
+
+        // 7. Subcommand /cline stats (real DSH stream metrics)
         if (subcmd === 'stats' || subcmd === 'telemetry') {
           const summary = `ClineBot Telemetry · ${sessionStats.successfulRequests}/${sessionStats.totalRequests} reqs · ~${sessionStats.totalTokensEst} tokens`
           const lines = [
@@ -177,7 +199,7 @@ export function registerSlashCommand(ctx, { live, getSettingsApi, syncProviderSt
           return lines.join('\n')
         }
 
-        // 7. Subcommand /cline test [model] / smoke
+        // 8. Subcommand /cline test [model] / smoke
         if (subcmd === 'test' || subcmd === 'smoke') {
           if (param && !isSupportedModel(param, pub.dynamicModels, pub.modelContextOverrides, pub.customModels)) {
             return `ClineBot: Model "${param}" is not recognized. Use /cline models to see available models.`
@@ -221,7 +243,7 @@ export function registerSlashCommand(ctx, { live, getSettingsApi, syncProviderSt
           return `Smoke Test Failed: ${outcome.error} (HTTP ${outcome.status || 'timeout'})${failoverNotice}`
         }
 
-        // 8. Subcommand /cline quota or /cline balance
+        // 9. Subcommand /cline quota, /cline usage or /cline balance
         const activeKey = await resolveActiveAccountKey(ctx, live())
         if (!activeKey.value) {
           return 'ClineBot: API key is not configured. Open Settings -> Plugins -> ClineBot.'
@@ -234,9 +256,11 @@ export function registerSlashCommand(ctx, { live, getSettingsApi, syncProviderSt
 
         const fiveHour = usage?.windows?.fiveHour
         const weekly = usage?.windows?.weekly
+        const monthly = usage?.windows?.monthly
         const reset5h = fiveHour?.resetsAt ? new Date(fiveHour.resetsAt).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' }) : 'N/A'
         const resetWk = weekly?.resetsAt ? new Date(weekly.resetsAt).toLocaleDateString([], { day: '2-digit', month: '2-digit' }) : 'N/A'
         const resetWkFull = weekly?.resetsAt ? new Date(weekly.resetsAt).toLocaleDateString([], { day: '2-digit', month: '2-digit', year: 'numeric' }) : 'N/A'
+        const resetMo = monthly?.resetsAt ? new Date(monthly.resetsAt).toLocaleDateString([], { day: '2-digit', month: '2-digit', year: 'numeric' }) : 'N/A'
 
         const planRaw = usage?.plan || 'ClinePass'
         const planShort = planRaw.replace(/\s*\(\$\d+\.\d+\/mo\)/i, '').trim()
@@ -268,6 +292,7 @@ export function registerSlashCommand(ctx, { live, getSettingsApi, syncProviderSt
           '',
           `${pad('5-Hour Quota')}${formatProgressBar(fiveHour?.percentUsed)}  (resets: ${reset5h})`,
           `${pad('Weekly Quota')}${formatProgressBar(weekly?.percentUsed)}  (resets: ${resetWkFull})`,
+          `${pad('Monthly Quota')}${formatProgressBar(monthly?.percentUsed)}  (resets: ${resetMo})`,
         )
 
         if (fiveHour?.percentUsed >= 95) {
@@ -315,8 +340,8 @@ export function registerSlashCommand(ctx, { live, getSettingsApi, syncProviderSt
     const unregister = commands.register({
       definitionId: '@goodandready/dsh-clinebot',
       name: 'cline',
-      description: 'Check ClinePass subscription quota, models, accounts and test connectivity (/cline [quota|models|accounts|switch <name>|test [model]|ping|rotate])',
-      input: { hint: '[quota|models|accounts|switch <name>|test [model]|ping|rotate]' },
+      description: 'Check ClinePass quota, cost, models, accounts and connectivity (/cline [quota|usage|cost|models|accounts|switch <name>|test [model]|ping|rotate])',
+      input: { hint: '[quota|usage|cost|models|accounts|switch <name>|test [model]|ping|rotate]' },
       handler: commandHandler,
       execute: commandExecute,
     })

package/lib/stats-storage.js

@@ -84,7 +84,7 @@ function localDateKey(date) {
 }
 
 /** Get active .dsh directory, respecting DSH_HOME and HOME. */
-export function getDshHome() {
+function getDshHome() {
   if (process.env.DSH_HOME) return process.env.DSH_HOME
   const home = process.env.HOME || homedir()
   return path.join(home, '.dsh')
@@ -412,7 +412,7 @@ export function resetStats(customPath) {
  * @param {number} [days]
  * @param {number} [to]
  */
-export function getHeatmap(days = 7, to = Date.now(), model = '') {
+function getHeatmap(days = 7, to = Date.now(), model = '') {
   const count = Math.max(1, Math.min(95, Number(days) || 7))
   const end = new Date(Number.isFinite(Number(to)) ? Number(to) : Date.now())
   const start = new Date(end.getFullYear(), end.getMonth(), end.getDate() - (count - 1))

package/lib/transport/cline-transport.js

@@ -9,17 +9,17 @@
 import { createRequire } from 'node:module'
 
 const require = createRequire(import.meta.url)
-let packageVersion = '0.6.4'
+let packageVersion = '0.6.6'
 try {
   packageVersion = require('../../package.json').version || packageVersion
 } catch {
   /* fallback when package.json is unavailable */
 }
 
-export const USER_AGENT = `@goodandready/dsh-clinebot/${packageVersion}`
-export const DEFAULT_CONNECT_TIMEOUT_MS = 15000
-export const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 30000
-export const DEFAULT_MAX_BODY_BYTES = 10 * 1024 * 1024
+const USER_AGENT = `@goodandready/dsh-clinebot/${packageVersion}`
+const DEFAULT_CONNECT_TIMEOUT_MS = 15000
+const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 30000
+const DEFAULT_MAX_BODY_BYTES = 10 * 1024 * 1024
 
 /**
  * Build the abort-shaped error every transport caller understands.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-clinebot",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "DeepSeek Harness companion for ClineBot / ClinePass: dynamic subscription models sync, quota exhaustion warnings, session metrics, dedicated settings page, live usage limits, and /cline slash-command.",
   "license": "MIT",
   "type": "module",
@@ -100,6 +100,7 @@
     "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
     "@deepseek-ai/schemastery": "~3.18.5",
     "@types/node": "^24.0.0",
+    "esbuild": "^0.28.2",
     "eslint": "^9.39.5",
     "typescript": "^6.0.3"
   },