agent-usage-all-in-one 0.7.0 → 0.7.2

package/README.md

@@ -64,9 +64,10 @@ pnpm install
 pnpm dev
 ```
 
-This starts the source daemon, authenticated Vite proxy, hot reload, and dashboard.
+This starts the source daemon, authenticated Vite proxy, hot reload, and dashboard on a random available port.
 Development state is isolated in the ignored `.agent-usage-dev/` directory. Use
-`AGENT_USAGE_DEMO=1 pnpm dev` for demo data or `pnpm dev -- --no-open` to keep the
+`pnpm dev -- --port 3000` (or `AGENT_USAGE_DEV_PORT=3000`) to customize the port,
+`AGENT_USAGE_DEMO=1 pnpm dev` for demo data, or `pnpm dev -- --no-open` to keep the
 browser closed.
 
 ## Install and run

package/README.zh-CN.md

@@ -48,8 +48,8 @@ pnpm install
 pnpm dev
 ```
 
-该命令会启动源码守护进程、带认证的 Vite 代理、热更新和页面。开发数据隔离在已忽略的
-`.agent-usage-dev/` 目录。使用 `AGENT_USAGE_DEMO=1 pnpm dev` 加载演示数据；使用
+该命令会启动源码守护进程、带认证的 Vite 代理、热更新和页面（默认分配随机可用端口）。开发数据隔离在已忽略的
+`.agent-usage-dev/` 目录。使用 `pnpm dev -- --port 3000`（或环境变量 `AGENT_USAGE_DEV_PORT=3000`）自定义端口；使用 `AGENT_USAGE_DEMO=1 pnpm dev` 加载演示数据；使用
 `pnpm dev -- --no-open` 禁止自动打开浏览器。
 
 ## 安装与启动

package/dist/cli.js

@@ -2439,7 +2439,7 @@ var init_usage_application = __esm({
               });
             }
             this.#repository.saveNotificationState(usedKey, String(bucket.usedPercent));
-            const remaining = 100 - bucket.usedPercent;
+            const remaining = Math.max(0, 100 - bucket.usedPercent);
             const level = remaining <= 5 ? "5" : remaining <= 20 ? "20" : "normal";
             const levelKey = `quota-level:${prefix}`;
             const priorLevel = this.#repository.getNotificationState(levelKey) ?? "normal";
@@ -2856,6 +2856,19 @@ var init_catalog = __esm({
   }
 });
 
+// src/core/quota-normalization.ts
+function clampPercent(value) {
+  if (value === null || value === void 0 || !Number.isFinite(value)) {
+    return null;
+  }
+  return Math.min(100, Math.max(0, value));
+}
+var init_quota_normalization = __esm({
+  "src/core/quota-normalization.ts"() {
+    "use strict";
+  }
+});
+
 // src/connectors/claude-code/claude-code-connector.ts
 function incompleteTranscriptFailure(provider) {
   return {
@@ -2869,7 +2882,7 @@ function mapQuota(quota) {
     id: quota.id,
     billingDomainId: "subscription",
     label: quota.label,
-    usedPercent: quota.usedPercent,
+    usedPercent: clampPercent(quota.usedPercent),
     windowDurationMinutes: quota.windowDurationMinutes,
     resetsAt: quota.resetsAt,
     authority: "official-client",
@@ -2890,6 +2903,7 @@ var ClaudeCodeConnector;
 var init_claude_code_connector = __esm({
   "src/connectors/claude-code/claude-code-connector.ts"() {
     "use strict";
+    init_quota_normalization();
     ClaudeCodeConnector = class {
       id = "claude-code";
       displayName = "Claude Code";
@@ -3174,7 +3188,7 @@ function parseClaudeUsageScreen(text, now) {
     quotas.set(id, {
       id,
       label: displayLabel(heading),
-      usedPercent: Number(match[1]),
+      usedPercent: clampPercent(Number(match[1])),
       windowDurationMinutes: windowDurationMinutes(heading),
       resetsAt: resetLine ? parseReset(resetLine, now) : null
     });
@@ -3363,6 +3377,7 @@ var ClaudeUsageAdapterError, ScreenReaderClaudeQuotaClient;
 var init_claude_usage_screen_client = __esm({
   "src/connectors/claude-code/claude-usage-screen-client.ts"() {
     "use strict";
+    init_quota_normalization();
     ClaudeUsageAdapterError = class extends Error {
       code;
       recovery;
@@ -3566,7 +3581,7 @@ function mapQuotaBuckets(response) {
         id: `${key}:${windowName}`,
         billingDomainId: "subscription",
         label: multipleLimits ? `${baseLabel} \xB7 ${windowLabel}` : windowLabel,
-        usedPercent: window.usedPercent,
+        usedPercent: clampPercent(window.usedPercent),
         windowDurationMinutes: window.windowDurationMins,
         resetsAt: window.resetsAt === null ? null : new Date(window.resetsAt * 1e3).toISOString(),
         authority: "official-account"
@@ -3587,6 +3602,7 @@ var nullableNumeric, numeric, rateLimitWindowSchema, rateLimitSnapshotSchema, co
 var init_codex_connector = __esm({
   "src/connectors/codex/codex-connector.ts"() {
     "use strict";
+    init_quota_normalization();
     init_token_normalization();
     nullableNumeric = z2.union([z2.number(), z2.string()]).transform(Number).nullable();
     numeric = z2.union([z2.number(), z2.string()]).transform(Number);
@@ -4346,7 +4362,7 @@ function mapQuota2(response) {
     id,
     billingDomainId: "go-subscription",
     label: LIMITS[id].label,
-    usedPercent: response.usage[id].percent,
+    usedPercent: clampPercent(response.usage[id].percent),
     windowDurationMinutes: LIMITS[id].windowDurationMinutes,
     resetsAt: response.usage[id].resetsAt,
     authority: "official-account",
@@ -4371,6 +4387,7 @@ var LIMITS, OpenCodeGoConnector;
 var init_opencode_go_connector = __esm({
   "src/connectors/opencode-go/opencode-go-connector.ts"() {
     "use strict";
+    init_quota_normalization();
     LIMITS = {
       rolling: { label: "5 hour", amount: 12, windowDurationMinutes: 300 },
       weekly: { label: "Week", amount: 30, windowDurationMinutes: 10080 },
@@ -4467,7 +4484,9 @@ function grokBuildBillingDomains(usage = []) {
 function mapBillingQuota(billing) {
   const config = billing.config;
   if (!config) return [];
-  const usedPercent = config.creditUsagePercent ?? derivePercent(config.used?.val, config.monthlyLimit?.val);
+  const usedPercent = clampPercent(
+    config.creditUsagePercent ?? derivePercent(config.used?.val, config.monthlyLimit?.val)
+  );
   if (usedPercent === null) return [];
   const periodType = config.currentPeriod?.type;
   const period = nativePeriod(periodType, config.currentPeriod ? void 0 : "monthly");
@@ -4525,6 +4544,7 @@ var centSchema, usagePeriodSchema, billingConfigSchema, grokBillingResponseSchem
 var init_grok_build_connector = __esm({
   "src/connectors/grok-build/grok-build-connector.ts"() {
     "use strict";
+    init_quota_normalization();
     centSchema = z6.object({ val: z6.number().default(0) }).passthrough();
     usagePeriodSchema = z6.object({
       type: z6.string().optional(),
@@ -8060,7 +8080,7 @@ function mapQuotaRow(row) {
     id: row.id,
     billingDomainId: row.billing_domain_id,
     label: row.label,
-    usedPercent: row.used_percent,
+    usedPercent: clampPercent(row.used_percent),
     windowDurationMinutes: row.window_duration_minutes,
     resetsAt: row.resets_at,
     authority: row.authority,
@@ -9156,7 +9176,10 @@ function buildRiskSummary(providers) {
       const limitingBucket = [...buckets].sort(
         (left, right) => right.usedPercent - left.usedPercent || left.id.localeCompare(right.id)
       )[0];
-      const remaining = Math.min(...buckets.map((bucket) => 100 - bucket.usedPercent));
+      const remaining = Math.max(
+        0,
+        Math.min(...buckets.map((bucket) => 100 - bucket.usedPercent))
+      );
       const predictsFailure = domain.forecasts.some((forecast) => !forecast.willLastUntilReset);
       const predictsSuccess = domain.forecasts.length > 0 && domain.forecasts.every((forecast) => forecast.willLastUntilReset);
       const coveragePenalty = domain.forecastCoverage === "discontinuous" ? 40 : 0;
@@ -9239,6 +9262,7 @@ var init_sqlite_usage_repository = __esm({
   "src/server/sqlite-usage-repository.ts"() {
     "use strict";
     init_token_normalization();
+    init_quota_normalization();
     init_plan_pricing();
     FRESHNESS_WINDOW_MS = 15 * 60 * 1e3;
     QUERY_INDEXES_SQL = `
@@ -9388,12 +9412,13 @@ var init_sqlite_usage_repository = __esm({
             }
           }
           for (const bucket of snapshot2.quotaBuckets) {
+            const clampedUsedPercent = clampPercent(bucket.usedPercent);
             quotaStatement.run(
               snapshot2.provider.id,
               bucket.id,
               bucket.billingDomainId,
               bucket.label,
-              bucket.usedPercent,
+              clampedUsedPercent,
               bucket.windowDurationMinutes ?? null,
               bucket.resetsAt,
               bucket.authority,
@@ -9418,13 +9443,14 @@ var init_sqlite_usage_repository = __esm({
            authority = excluded.authority`
           );
           for (const bucket of snapshot2.quotaBuckets) {
-            if (bucket.usedPercent === null) continue;
+            const clampedUsedPercent = clampPercent(bucket.usedPercent);
+            if (clampedUsedPercent === null) continue;
             quotaObservationStatement.run(
               snapshot2.provider.id,
               bucket.id,
               bucket.billingDomainId,
               bucket.label,
-              bucket.usedPercent,
+              clampedUsedPercent,
               bucket.resetsAt,
               bucket.authority,
               snapshot2.observedAt