@tokenbuddy/tokenbuddy 1.0.9 → 1.0.11

package/dist/src/credit-tracker.js

@@ -0,0 +1,220 @@
+import { createModuleLogger } from "@tokenbuddy/logging";
+const logger = createModuleLogger("tb-proxyd:credit-tracker");
+/**
+ * Default window after a successful purchase during which failover is
+ * softened (see buyer-driven-fallback-design.md §17.3). 30 seconds is the
+ * v1.1 starting point; v1.2 keeps the same value.
+ */
+export const DEFAULT_FRESH_PURCHASE_WINDOW_MS = 30_000;
+/**
+ * Default threshold of "still considered fresh": the current balance must
+ * still cover this fraction of the last purchase amount for the entry to
+ * be treated as "刚买". 0.5 means "at least half of the purchased credit is
+ * still untouched".
+ */
+export const DEFAULT_FRESH_PURCHASE_THRESHOLD = 0.5;
+/**
+ * Maximum number of automatic purchases a single session may trigger per
+ * minute. When the budget is exhausted, route-failover must `切` rather than
+ * `重买` (see §17.5).
+ */
+export const DEFAULT_PURCHASE_BUDGET_PER_MINUTE = 3;
+/**
+ * Tracks per-seller credit state for the buyer-driven-fallback design's
+ * "balance protection" rules. The tracker is intentionally agnostic of the
+ * actual seller HTTP layer: callers feed in `recordPurchase`,
+ * `recordSpend`, and `transferLeftover` events as they observe them, and
+ * the tracker answers "is this seller still inside its fresh-purchase
+ * window?" / "may I auto-purchase again this minute?".
+ *
+ * The tracker is process-local: a buyer restart resets the session
+ * counters. See §17.11.4 for the rationale.
+ */
+export class CreditTracker {
+    freshPurchaseWindowMs;
+    freshPurchaseThreshold;
+    purchaseBudgetPerMinute;
+    now;
+    entries = new Map();
+    purchaseTimestamps = [];
+    totalWastedMicros = 0;
+    wastedSinceLastDoctorRun = 0;
+    constructor(options = {}) {
+        this.freshPurchaseWindowMs = options.freshPurchaseWindowMs ?? DEFAULT_FRESH_PURCHASE_WINDOW_MS;
+        this.freshPurchaseThreshold = options.freshPurchaseThreshold ?? DEFAULT_FRESH_PURCHASE_THRESHOLD;
+        this.purchaseBudgetPerMinute = options.purchaseBudgetPerMinute ?? DEFAULT_PURCHASE_BUDGET_PER_MINUTE;
+        this.now = options.now ?? Date.now;
+    }
+    /**
+     * Register a successful purchase. Updates the seller's balance, the
+     * session-wide budget window, and the "fresh purchase" timestamps. If
+     * the seller is unknown, an entry is created.
+     */
+    recordPurchase(sellerId, amountMicros, balanceMicros) {
+        if (!Number.isFinite(amountMicros) || amountMicros <= 0) {
+            throw new Error("recordPurchase requires a positive amountMicros");
+        }
+        const ts = this.now();
+        const previous = this.entries.get(sellerId);
+        const entry = {
+            sellerId,
+            lastPurchaseAt: ts,
+            lastPurchaseAmountMicros: amountMicros,
+            currentBalanceMicros: Math.max(0, balanceMicros),
+            leftoverCreditMicros: previous?.leftoverCreditMicros ?? 0,
+            lastUpdatedAt: ts
+        };
+        this.entries.set(sellerId, entry);
+        this.purchaseTimestamps.push(ts);
+        this.prunePurchaseTimestamps(ts);
+        logger.info("credit.purchase.recorded", "seller credit purchase recorded", {
+            sellerId,
+            amountMicros,
+            balanceMicros: entry.currentBalanceMicros,
+            purchasesInLastMinute: this.purchaseTimestamps.length
+        });
+        return entry;
+    }
+    /**
+     * Update the seller's current balance after a successful inference. The
+     * amount spent is implicit (`previous - next`) so the caller does not
+     * have to track it. A non-positive `balanceMicros` is treated as 0.
+     */
+    recordSpend(sellerId, balanceMicros) {
+        const previous = this.entries.get(sellerId);
+        if (!previous) {
+            return undefined;
+        }
+        const next = {
+            ...previous,
+            currentBalanceMicros: Math.max(0, balanceMicros),
+            lastUpdatedAt: this.now()
+        };
+        this.entries.set(sellerId, next);
+        return next;
+    }
+    /**
+     * Move the seller's remaining balance to the `leftoverCreditMicros`
+     * bucket. Called when failover triggers while a balance is still
+     * available. The pool's pre-warm / probe logic can later attempt to
+     * consume the leftover credit (see PR-3.1). The wasted amount is also
+     * added to the session-level counters.
+     */
+    transferLeftoverToWasted(sellerId, reason) {
+        const previous = this.entries.get(sellerId);
+        if (!previous) {
+            return 0;
+        }
+        const wasted = previous.currentBalanceMicros;
+        if (wasted <= 0) {
+            return 0;
+        }
+        const next = {
+            ...previous,
+            currentBalanceMicros: 0,
+            leftoverCreditMicros: previous.leftoverCreditMicros + wasted,
+            lastUpdatedAt: this.now()
+        };
+        this.entries.set(sellerId, next);
+        this.totalWastedMicros += wasted;
+        this.wastedSinceLastDoctorRun += wasted;
+        logger.warn("credit.leftover.wasted", "leftover credit logged as wasted on failover", {
+            sellerId,
+            wastedMicros: wasted,
+            reason,
+            totalWastedMicros: this.totalWastedMicros
+        });
+        return wasted;
+    }
+    /**
+     * Consume leftover credit when the seller recovers and a probe
+     * successfully burns it down. Returns the amount actually consumed.
+     */
+    consumeLeftover(sellerId, amountMicros) {
+        const previous = this.entries.get(sellerId);
+        if (!previous || previous.leftoverCreditMicros <= 0) {
+            return 0;
+        }
+        const consume = Math.max(0, Math.min(amountMicros, previous.leftoverCreditMicros));
+        if (consume <= 0) {
+            return 0;
+        }
+        const next = {
+            ...previous,
+            leftoverCreditMicros: previous.leftoverCreditMicros - consume,
+            lastUpdatedAt: this.now()
+        };
+        this.entries.set(sellerId, next);
+        logger.info("credit.leftover.consumed", "leftover credit consumed by recovery probe", {
+            sellerId,
+            consumedMicros: consume,
+            remainingMicros: next.leftoverCreditMicros
+        });
+        return consume;
+    }
+    /**
+     * Returns `true` when the seller is still inside the fresh-purchase
+     * window: at least `freshPurchaseThreshold` of the most recent
+     * purchase is still unused, and the window has not elapsed. Sellers
+     * with no recorded purchase are never "fresh".
+     */
+    isInFreshPurchaseWindow(sellerId, now = this.now()) {
+        const entry = this.entries.get(sellerId);
+        if (!entry || entry.lastPurchaseAmountMicros <= 0) {
+            return false;
+        }
+        if (now - entry.lastPurchaseAt > this.freshPurchaseWindowMs) {
+            return false;
+        }
+        const ratio = entry.currentBalanceMicros / entry.lastPurchaseAmountMicros;
+        return ratio >= this.freshPurchaseThreshold;
+    }
+    /**
+     * Returns `true` when the per-minute auto-purchase budget is still
+     * available. Used by `route-failover` to refuse auto-repurchase and
+     * force a clean `切` once the session is at risk of over-spending.
+     */
+    canAutoPurchase(now = this.now()) {
+        this.prunePurchaseTimestamps(now);
+        return this.purchaseTimestamps.length < this.purchaseBudgetPerMinute;
+    }
+    /**
+     * Snapshot for `tb doctor`. Mirrors the design's "Credit Usage" block.
+     */
+    summary() {
+        return {
+            totalWastedMicros: this.totalWastedMicros,
+            wastedSinceLastDoctorRun: this.wastedSinceLastDoctorRun,
+            purchasesInLastMinute: this.purchaseTimestamps.length,
+            purchaseBudgetPerMinute: this.purchaseBudgetPerMinute,
+            freshPurchaseWindowMs: this.freshPurchaseWindowMs,
+            freshPurchaseThreshold: this.freshPurchaseThreshold,
+            perSeller: Array.from(this.entries.values()).map((entry) => ({
+                sellerId: entry.sellerId,
+                currentBalanceMicros: entry.currentBalanceMicros,
+                lastPurchaseAmountMicros: entry.lastPurchaseAmountMicros,
+                lastPurchaseAt: entry.lastPurchaseAt,
+                leftoverCreditMicros: entry.leftoverCreditMicros
+            }))
+        };
+    }
+    getEntry(sellerId) {
+        return this.entries.get(sellerId);
+    }
+    resetDoctorRunCounter() {
+        this.wastedSinceLastDoctorRun = 0;
+    }
+    clear() {
+        this.entries.clear();
+        this.purchaseTimestamps.length = 0;
+        this.totalWastedMicros = 0;
+        this.wastedSinceLastDoctorRun = 0;
+    }
+    prunePurchaseTimestamps(now) {
+        const cutoff = now - 60_000;
+        while (this.purchaseTimestamps.length > 0 && this.purchaseTimestamps[0] < cutoff) {
+            this.purchaseTimestamps.shift();
+        }
+    }
+}
+//# sourceMappingURL=credit-tracker.js.map

package/dist/src/credit-tracker.js.map

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

package/dist/src/daemon.d.ts

@@ -5,6 +5,9 @@ export interface DaemonConfig {
     sellerRegistryUrl: string;
     selectionMode?: "auto" | "manual";
     selectedSellerId?: string;
+    warmupModels?: string[];
+    warmupRefreshIntervalSecs?: number;
+    warmupProbeTimeoutMs?: number;
 }
 export declare class TokenbuddyDaemon {
     private config;
@@ -14,9 +17,17 @@ export declare class TokenbuddyDaemon {
     private selectionMode;
     private selectedSellerId?;
     private activePurchases;
+    private readonly modelIndex;
+    private readonly prewarmCache;
+    private readonly creditTracker;
+    private readonly sellerPool;
+    private readonly routeFailover;
+    private readonly prewarmScheduler;
     constructor(config: DaemonConfig);
+    private buildHealthProber;
     private activeControlPort;
     private activeProxyPort;
+    private lastRegistrySnapshot;
     private fetchRegistry;
     private runtimeSummary;
     private endpointProtocol;
@@ -27,11 +38,23 @@ export declare class TokenbuddyDaemon {
     private applyResolvedModelToBody;
     private defaultPaymentMethod;
     private selectSellerRoutes;
-    private logRouteSelected;
-    private shouldFailoverStatus;
-    private logFailover;
     private failoverErrorMessage;
-    private selectSeller;
+    /**
+     * Map an HTTP status from a failed seller call to a `FailureKind` that
+     * the route-failover controller understands. Hard 4xx (other than
+     * auth/insufficient) means the seller is wrong for the request; 5xx
+     * and 429 are treated as transient and eligible for the soft-failure
+     * retry budget. The v1.1 "insufficient funds" check stays on the
+     * caller side because it short-circuits the failure path with a
+     * re-purchase.
+     */
+    private classifyFailureStatus;
+    /**
+     * Emit the structured failover log line. The decision itself is
+     * produced by `RouteFailover.decide`; this helper exists only to keep
+     * the controller loop readable.
+     */
+    private handleFailoverDecision;
     private listSellerBackedModels;
     private readUsage;
     private parseSellerSettlementSummary;
@@ -42,6 +65,21 @@ export declare class TokenbuddyDaemon {
     private inferPromptForHash;
     private autoPurchaseAmountUsdMicros;
     private tokenRebuyMinBalanceMicros;
+    /**
+     * v1.2 §8: hard per-request deadline. The buyer refuses to wait longer
+     * than this for a single seller; on expiry the request is aborted and
+     * the route-failover controller can either retry the same seller with
+     * a smaller body or fail over. Configurable via
+     * `TB_PROXYD_REQUEST_DEADLINE_MS` (default 30s).
+     */
+    private requestDeadlineMs;
+    /**
+     * Safety margin subtracted from the cached token's `expiresAt` before
+     * deciding to reuse it. Buying a new token 60s before expiry gives the
+     * upstream enough headroom to reject any in-flight calls under the old
+     * token before the buyer assumes the new one is valid.
+     */
+    private tokenExpirySafetyMarginMs;
     private getOrPurchaseToken;
     private resolvePaymentProof;
     private runClawtipProofCommand;
@@ -49,6 +87,13 @@ export declare class TokenbuddyDaemon {
     private copyUpstreamHeaders;
     private forwardProxyRequest;
     start(): void;
+    /**
+     * v1.2 §18.4: build the focus set from the explicit config, the env
+     * override, and the historical usage in the buyer store. The order of
+     * precedence: explicit config > env > historical > empty.
+     */
+    private resolveFocusSet;
+    private runStartupPrewarmSweep;
     stop(): void;
 }
 //# sourceMappingURL=daemon.d.ts.map

package/dist/src/daemon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/daemon.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA4WD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAC,CAAM;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAM;IAC1B,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAElC,OAAO,CAAC,eAAe,CAAsC;gBAEjD,MAAM,EAAE,YAAY;IAchC,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,eAAe;YAKT,aAAa;IAI3B,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,0BAA0B;IAOlC,OAAO,CAAC,sBAAsB;IAoB9B,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,wBAAwB;IAehC,OAAO,CAAC,oBAAoB;YAKd,kBAAkB;IAiEhC,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,oBAAoB;YAId,YAAY;YAOZ,sBAAsB;IAWpC,OAAO,CAAC,SAAS;IA8BjB,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,yBAAyB;YAkDnB,oBAAoB;IA0ClC,OAAO,CAAC,2BAA2B;YAcrB,4BAA4B;IAkB1C,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,2BAA2B;IASnC,OAAO,CAAC,0BAA0B;YASpB,kBAAkB;YA8JlB,mBAAmB;IA2BjC,OAAO,CAAC,sBAAsB;IAkF9B,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,mBAAmB;YAUb,mBAAmB;IAmO1B,KAAK;IA8QL,IAAI;CAKZ"}
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/daemon.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAI1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAkJD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAC,CAAM;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAM;IAC1B,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAElC,OAAO,CAAC,eAAe,CAAsC;IAK7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAIxB;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAG3B;IAIH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;gBAEzC,MAAM,EAAE,YAAY;IAwBhC,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,oBAAoB,CAAuC;YAErD,aAAa;IAgC3B,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,0BAA0B;IAOlC,OAAO,CAAC,sBAAsB;IAoB9B,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,wBAAwB;IAehC,OAAO,CAAC,oBAAoB;YAKd,kBAAkB;IAyDhC,OAAO,CAAC,oBAAoB;IAI5B;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;YAqBhB,sBAAsB;IAWpC,OAAO,CAAC,SAAS;IA8BjB,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,yBAAyB;YAkDnB,oBAAoB;IA0ClC,OAAO,CAAC,2BAA2B;YAcrB,4BAA4B;IAkB1C,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,2BAA2B;IASnC,OAAO,CAAC,0BAA0B;IASlC;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;YAYnB,kBAAkB;YA4KlB,mBAAmB;IA2BjC,OAAO,CAAC,sBAAsB;IAkF9B,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,mBAAmB;YAUb,mBAAmB;IAwU1B,KAAK;IA8TZ;;;;OAIG;IACH,OAAO,CAAC,eAAe;YAaT,sBAAsB;IAmB7B,IAAI;CAMZ"}