saros-proxy 0.7.4 → 0.9.0

package/dist/usage-client.js

@@ -0,0 +1,124 @@
+/**
+ * usage-client.ts — Per-key quota usage from the upstream usage API.
+ *
+ * GET <upstream>/zen/go/v1/usage (Bearer = the proxy's own API key) returns:
+ *   {"usage":{"rolling":{"status":"ok","percent":12,"resetsAt":"…"},
+ *             "weekly":{…},"monthly":{…}}}
+ *
+ * Refresh strategy: stale-while-revalidate on demand. `maybeRefreshUsage`
+ * is called on the request path; when data is older than USAGE_REFRESH_TTL_MS
+ * and no refresh is in flight, it fires a background refresh for every key.
+ * Failures keep the last known values (weighted rotation just keeps working
+ * with slightly stale percentages).
+ */
+import { logger } from './logger.js';
+import { USAGE_FETCH_TIMEOUT_MS, USAGE_PATH, USAGE_REFRESH_TTL_MS } from './constants.js';
+import { updateKeyUsage } from './proxy-logic.js';
+import { getProvider, inferProvider } from './providers/index.js';
+function parsePercent(window) {
+    const percent = window?.percent;
+    if (typeof percent !== 'number' || !Number.isFinite(percent))
+        return 0;
+    return Math.min(100, Math.max(0, percent));
+}
+/** Parse a usage API response body into KeyUsage (throws on contract violation). */
+export function parseUsageResponse(body) {
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        throw new Error('usage response is not valid JSON');
+    }
+    const usage = parsed?.usage;
+    if (!usage || typeof usage !== 'object') {
+        throw new Error('usage response missing "usage" object');
+    }
+    const rolling = parsePercent(usage.rolling);
+    const weekly = parsePercent(usage.weekly);
+    const monthly = parsePercent(usage.monthly);
+    return {
+        rollingPercent: rolling,
+        weeklyPercent: weekly,
+        monthlyPercent: monthly,
+        usedPercent: Math.max(rolling, weekly, monthly),
+        rollingResetsAt: typeof usage.rolling?.resetsAt === 'string' ? usage.rolling.resetsAt : undefined,
+        weeklyResetsAt: typeof usage.weekly?.resetsAt === 'string' ? usage.weekly.resetsAt : undefined,
+        monthlyResetsAt: typeof usage.monthly?.resetsAt === 'string' ? usage.monthly.resetsAt : undefined,
+    };
+}
+/**
+ * Fetch current usage for one key. Returns null on any failure
+ * (network, timeout, non-200, contract violation) — callers treat null as
+ * "no fresh data".
+ */
+export async function fetchKeyUsage(upstreamBaseUrl, apiKey, usagePath = USAGE_PATH) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), USAGE_FETCH_TIMEOUT_MS);
+    try {
+        const response = await fetch(new URL(usagePath, upstreamBaseUrl), {
+            headers: { Authorization: `Bearer ${apiKey}`, Accept: 'application/json' },
+            signal: controller.signal,
+        });
+        // Keep the abort armed through the body read: a stalled body after a 200
+        // must still time out, or refreshInFlight stays true forever and usage
+        // rotation freezes on stale percentages.
+        if (!response.ok)
+            return null;
+        return parseUsageResponse(await response.text());
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// ---------------------------------------------------------------------------
+// Stale-while-revalidate coordinator (one per proxy process)
+// ---------------------------------------------------------------------------
+let lastRefreshAt = 0;
+let refreshInFlight = false;
+/** Test seam: reset coordinator state. */
+export function resetUsageRefreshState() {
+    lastRefreshAt = 0;
+    refreshInFlight = false;
+}
+/**
+ * Kick off a background refresh of every key's usage when the cached data is
+ * older than USAGE_REFRESH_TTL_MS. Fire-and-forget: never throws, never blocks
+ * the request path, deduplicates concurrent calls.
+ */
+export function maybeRefreshUsage(state, config) {
+    const now = Date.now();
+    if (refreshInFlight || now - lastRefreshAt < USAGE_REFRESH_TTL_MS)
+        return;
+    refreshInFlight = true;
+    lastRefreshAt = now;
+    void (async () => {
+        try {
+            const entries = await Promise.all(state.keys.map(async (k) => {
+                const provider = getProvider(inferProvider({ label: k.label, key: k.key, provider: k.provider }));
+                // Providers without a queryable usage API (commandcode) are skipped —
+                // weighted rotation simply treats them as having no fresh data.
+                if (!provider || !provider.usagePath())
+                    return [k.label, null];
+                const base = config.upstreams?.[provider.id] ?? (provider.id === 'opencode-go' ? config.upstreamBaseUrl : provider.baseUrl);
+                const usage = await fetchKeyUsage(base, k.key, provider.usagePath());
+                return [k.label, usage];
+            }));
+            const usable = entries.filter(([, u]) => u !== null);
+            if (usable.length > 0) {
+                updateKeyUsage(state, new Map(usable.map(([label, u]) => [label, u.usedPercent])));
+                logger.debug({ keys: usable.map(([l]) => l) }, 'key usage refreshed');
+            }
+        }
+        catch (err) {
+            logger.debug({ err }, 'usage refresh failed');
+        }
+        finally {
+            refreshInFlight = false;
+        }
+    })();
+}
+//# sourceMappingURL=usage-client.js.map

package/dist/usage-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-client.js","sourceRoot":"","sources":["../src/usage-client.ts"],"names":[],"mappings":"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"}

package/dist/validation.d.ts

@@ -10,7 +10,11 @@
 export declare function isValidPort(value: unknown): value is number;
 /**
  * Check if the given string looks like a valid API key.
- * Must start with `sk-` and be at least {@link MIN_KEY_LENGTH} characters long.
+ *
+ * Multi-provider aware: accepts `sk-` (opencode-go / commandcode console
+ * keys) and `user_` (commandcode tokens) of at least {@link MIN_KEY_LENGTH}
+ * characters. Structural check only — provider identity is confirmed by the
+ * smoke test in `identifyKey()`.
  */
 export declare function isValidApiKey(key: unknown): key is string;
 /**
@@ -28,7 +32,3 @@ export declare function isValidHttpsUrl(url: unknown): url is string;
  * @returns `true` if the value is a positive integer in the given range.
  */
 export declare function isValidPositiveInt(val: string, min?: number, max?: number): boolean;
-/**
- * Check if the given string is a valid workspace ID (matches `wrk_[A-Za-z0-9]+`).
- */
-export declare function isValidWorkspaceId(id: unknown): id is string;

package/dist/validation.js

@@ -4,7 +4,7 @@
  * Centralises input validation patterns used across config.ts and setup.ts
  * to ensure consistent rules and reduce duplication.
  */
-import { API_KEY_PREFIX, MIN_KEY_LENGTH, WORKSPACE_ID_REGEX } from './constants.js';
+import { isPlausibleKey } from './providers/index.js';
 /**
  * Check if the given value is a valid TCP port number (1–65535).
  */
@@ -19,10 +19,14 @@ export function isValidPort(value) {
 }
 /**
  * Check if the given string looks like a valid API key.
- * Must start with `sk-` and be at least {@link MIN_KEY_LENGTH} characters long.
+ *
+ * Multi-provider aware: accepts `sk-` (opencode-go / commandcode console
+ * keys) and `user_` (commandcode tokens) of at least {@link MIN_KEY_LENGTH}
+ * characters. Structural check only — provider identity is confirmed by the
+ * smoke test in `identifyKey()`.
  */
 export function isValidApiKey(key) {
-    return typeof key === 'string' && key.startsWith(API_KEY_PREFIX) && key.length >= MIN_KEY_LENGTH;
+    return typeof key === 'string' && isPlausibleKey(key);
 }
 /**
  * Check if the given value is a valid HTTPS URL.
@@ -55,10 +59,4 @@ export function isValidPositiveInt(val, min = 1, max = 100) {
     const n = Number.parseInt(trimmed, 10);
     return n >= min && n <= max;
 }
-/**
- * Check if the given string is a valid workspace ID (matches `wrk_[A-Za-z0-9]+`).
- */
-export function isValidWorkspaceId(id) {
-    return typeof id === 'string' && WORKSPACE_ID_REGEX.test(id);
-}
 //# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpF;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC;AAC9F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,cAAc,CAAC;AACnG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG;IAChE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAW;IAC5C,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC;AAC9F,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG;IAChE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC;AAC9B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saros-proxy",
-  "version": "0.7.4",
+  "version": "0.9.0",
   "description": "Saros — predictive multi-account proxy for the OpenCode-Go API. Cycles between accounts before they exhaust.",
   "type": "module",
   "bin": {
@@ -21,11 +21,15 @@
     "test": "vitest",
     "coverage": "vitest run --coverage",
     "test:npm": "vitest run test/npm-package.test.ts",
+    "test:live-model": "npm run build && vitest run --config vitest.e2e.config.ts test/live-model.e2e.test.ts",
     "test:source": "vitest run test/source-install.test.ts",
+    "test:install": "npm run build && vitest run --config vitest.e2e.config.ts test/install.e2e.test.ts",
+    "test:model-e2e": "npm run build && vitest run --config vitest.e2e.config.ts test/model-e2e.test.ts",
     "test:docker": "vitest run test/docker-install.test.ts",
     "docker:build": "docker compose build proxy",
     "docker:run": "docker compose up proxy",
-    "docker:test": "docker compose run --rm test"
+    "docker:test": "docker compose run --rm test",
+    "test:e2e": "npm run build && vitest run --config vitest.e2e.config.ts"
   },
   "keywords": [
     "opencode",