@tokenbuddy/tokenbuddy 1.0.29 → 1.0.30

package/dist/src/daemon.d.ts

@@ -77,6 +77,7 @@ export declare class TokenbuddyDaemon {
     private activePurchases;
     private readonly modelIndex;
     private readonly prewarmCache;
+    private readonly sellerMetadataCache;
     private readonly creditTracker;
     private readonly sellerPool;
     private readonly routeFailover;
@@ -95,6 +96,7 @@ export declare class TokenbuddyDaemon {
     private scheduleClawtipActivationWait;
     private clawtipRechargeQr;
     private lastRegistrySnapshot;
+    private forceRegistrySnapshotForTest;
     private fetchRegistry;
     private saveTrustedRegistryCache;
     private loadTrustedRegistryCache;
@@ -105,6 +107,7 @@ export declare class TokenbuddyDaemon {
     private initStateSnapshot;
     private buildInitDoctorReport;
     private initDoctorCatalogSnapshot;
+    private refreshSellerRuntimeMetrics;
     private endpointProtocol;
     private extractModelId;
     private stripLocalClaudeOneMMarker;
@@ -138,6 +141,9 @@ export declare class TokenbuddyDaemon {
     private logPurchaseLedgerRecorded;
     private logTokenBalanceReconciled;
     private listSellerBackedModels;
+    private sellerCatalogWithRuntimeMetrics;
+    private refreshSellerRouteMetadata;
+    private routeMetricFromPoolEntry;
     private readUsage;
     private parseSellerSettlementSummary;
     private recordReconciledInference;
@@ -188,26 +194,27 @@ export declare class TokenbuddyDaemon {
     /**
      * tb-ui v1 `GET /routing/preview` 和 `PUT /routing/strategy` 复用的 preview 计算。
      * 接受任意 routing 覆盖（来自 request body）算「假如改成这个，路由会是啥」。
-     * 不修改任何内部 state，**纯函数式**。
+     * 不修改 routing state；registry / seller metadata 可按需刷新，保证 preview
+     * 使用的候选和折扣信息与真实请求路径一致。
      */
     buildRoutingPreview(input: {
         modelId?: string;
         protocol?: string;
         paymentMethod?: string;
         routing?: Partial<BuyerSellerRoutingConfig>;
-    }): {
+    }): Promise<{
         modelId: string;
         protocol: string;
         paymentMethod: string;
         plan: SellerRoutePlan | {
             error: string;
         };
-    };
+    }>;
     private runStartupPrewarmSweep;
     private resolvePrewarmProtocol;
     stop(): void;
     /**
-     * @internal — test-only seam to inject a registry snapshot without
+     * @internal - test-only hook to inject a registry snapshot without
      * hitting the network. Used by `tests/control-plane-ui-endpoints.test.ts`
      * to drive `buildRoutingPreview` deterministically. Production code
      * must NOT call this; the real `fetchRegistry()` populates the snapshot.

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

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

package/dist/src/daemon.js

@@ -19,6 +19,7 @@ import { SellerPool } from "./seller-pool.js";
 import { RouteFailover } from "./route-failover.js";
 import { PrewarmScheduler } from "./prewarm-scheduler.js";
 import { SellerConcurrencyLimiter } from "./seller-concurrency-limiter.js";
+import { SellerMetadataCache } from "./seller-metadata-cache.js";
 import { planSellerRouteSet } from "./seller-route-planner.js";
 import { assertSellerRoutingConfig, mergeSellerRoutingConfig, normalizeSellerRoutingConfig, parseSellerIdList, ROUTING_CONFIG_KEY } from "./seller-routing-config.js";
 import { assertInitSetupSteps, buildCompletedInitSetupMarker, INIT_SETUP_CONFIG_KEY, INIT_SETUP_STEPS, isFreshInitMachine, normalizeInitSetupMarker, resolveInitRecommendedModels, } from "./init-setup.js";
@@ -186,6 +187,16 @@ function parseSellerSettlementObject(raw) {
         return undefined;
     }
 }
+function sellerAttemptRequestContext(requestId, idempotencyKey, routeIndex, attempt, retryOrdinal) {
+    if (routeIndex === 0 && attempt === 0 && retryOrdinal === 0) {
+        return { requestId, idempotencyKey };
+    }
+    const suffix = `r${routeIndex}_a${attempt}_n${retryOrdinal}`;
+    return {
+        requestId: `${requestId}_${suffix}`,
+        idempotencyKey: `${idempotencyKey}_${suffix}`
+    };
+}
 function arrayLength(value) {
     return Array.isArray(value) ? value.length : undefined;
 }
@@ -296,6 +307,7 @@ export class TokenbuddyDaemon {
     // "fetchRegistry + manifest per request" path.
     modelIndex = new ModelIndex();
     prewarmCache = new PrewarmCache();
+    sellerMetadataCache = new SellerMetadataCache();
     creditTracker = new CreditTracker();
     sellerPool = new SellerPool({
         modelIndex: this.modelIndex,
@@ -360,11 +372,15 @@ export class TokenbuddyDaemon {
                 const now = Date.now();
                 const body = await res.json();
                 const upstream = body.upstream;
+                const latency = body.latency;
                 const upstreamErrorClass = upstream?.lastErrorClass ?? upstream?.last_error_class;
                 return {
                     ok: true,
                     latencyMs: now - startedAt,
                     httpStatus: res.status,
+                    ttftMs: finiteNumber(latency?.ttftMs ?? latency?.ttft_ms),
+                    avgInferenceMs: finiteNumber(latency?.avgInferenceMs ?? latency?.avg_inference_ms),
+                    avgTokensPerSecond: finiteNumber(latency?.avgTokensPerSecond ?? latency?.avg_tokens_per_second),
                     upstreamStatus: typeof upstream?.status === "string"
                         ? upstream.status
                         : undefined,
@@ -581,6 +597,7 @@ export class TokenbuddyDaemon {
     // trades freshness for availability: requests still route, but the
     // model set is whatever was cached before the registry outgrew 1MB.
     lastRegistrySnapshot = null;
+    forceRegistrySnapshotForTest = false;
     async fetchRegistry() {
         try {
             const fetched = await fetchSellerRegistryWithTrust(this.config.sellerRegistryUrl);
@@ -817,7 +834,7 @@ export class TokenbuddyDaemon {
         const payments = this.livePayments().filter((payment) => payment.enabled);
         const clients = this.clientToolsSummary();
         const routeModelId = this.resolveFocusSet()[0] || catalog.models[0]?.id;
-        const routingPreview = routeModelId ? this.buildRoutingPreview({ modelId: routeModelId, routing: currentRouting }) : undefined;
+        const routingPreview = routeModelId ? await this.buildRoutingPreview({ modelId: routeModelId, routing: currentRouting }) : undefined;
         const checks = [
             {
                 id: "local_service",
@@ -939,6 +956,43 @@ export class TokenbuddyDaemon {
             };
         }
     }
+    async refreshSellerRuntimeMetrics(route, requestId) {
+        let timer;
+        try {
+            const ac = new AbortController();
+            timer = setTimeout(() => ac.abort(new Error("health timeout")), this.config.warmupProbeTimeoutMs ?? 3000);
+            const startedAt = Date.now();
+            const res = await fetch(`${route.seller.url.replace(/\/+$/, "")}/health`, { signal: ac.signal });
+            if (!res.ok) {
+                logger.warn("pool.runtime_metrics.refresh_failed", "seller health refresh failed after inference", {
+                    requestId,
+                    sellerId: route.seller.id,
+                    status: res.status,
+                    durationMs: Date.now() - startedAt
+                });
+                return;
+            }
+            const body = await res.json();
+            const latency = body.latency;
+            this.sellerPool.recordRuntimeMetrics(route.seller.id, {
+                ttftMs: finiteNumber(latency?.ttftMs ?? latency?.ttft_ms),
+                avgInferenceMs: finiteNumber(latency?.avgInferenceMs ?? latency?.avg_inference_ms),
+                avgTokensPerSecond: finiteNumber(latency?.avgTokensPerSecond ?? latency?.avg_tokens_per_second)
+            });
+        }
+        catch (error) {
+            logger.warn("pool.runtime_metrics.refresh_failed", "seller health refresh failed after inference", {
+                requestId,
+                sellerId: route.seller.id,
+                errorMessage: error instanceof Error ? error.message : String(error)
+            });
+        }
+        finally {
+            if (timer) {
+                clearTimeout(timer);
+            }
+        }
+    }
     endpointProtocol(endpoint) {
         if (endpoint === "/v1/chat/completions") {
             return "chat_completions";
@@ -1033,6 +1087,7 @@ export class TokenbuddyDaemon {
         const registry = await this.fetchRegistry();
         const routing = resolveSellerRoutingForModel(this.refreshSellerRoutingConfig(), modelId);
         const registrySellers = reorderDefaultSellerFirst(registry.sellers, registry.defaultSeller);
+        await this.refreshSellerRouteMetadata(registrySellers);
         this.sellerPool.ensureRegistrySellers(registrySellers);
         this.scheduleLazyPrewarmIfNeeded(modelId, protocol, paymentMethod);
         this.sellerPool.recycleOpenCircuits();
@@ -1046,21 +1101,12 @@ export class TokenbuddyDaemon {
             registrySellers,
             routing,
             prewarmCandidates: this.prewarmCache.get(modelId, protocol, paymentMethod)?.candidates,
-            sellerMetrics: Array.from(poolById.values()).map((entry) => ({
-                sellerId: entry.sellerId,
-                healthScore: entry.healthScore,
-                avgLatencyMs: entry.avgLatencyMs,
-                ttftMs: entry.ttftMs,
-                avgInferenceMs: entry.avgInferenceMs,
-                circuit: entry.circuit,
-                capacityBlockedUntil: entry.capacityBlockedUntil,
-                ...(concurrencySnapshot.enabled
-                    ? {
-                        localConcurrencyActive: localConcurrencyBySellerId.get(entry.sellerId) ?? 0,
-                        localConcurrencyLimit: concurrencySnapshot.maxInFlightPerSeller
-                    }
-                    : {})
-            })),
+            sellerMetrics: Array.from(poolById.values()).map((entry) => this.routeMetricFromPoolEntry(entry, concurrencySnapshot.enabled
+                ? {
+                    localConcurrencyActive: localConcurrencyBySellerId.get(entry.sellerId) ?? 0,
+                    localConcurrencyLimit: concurrencySnapshot.maxInFlightPerSeller
+                }
+                : undefined)),
             now: Date.now()
         });
         logger.info("route.candidates.prewarmed", "seller route candidates prewarmed", {
@@ -1314,7 +1360,8 @@ export class TokenbuddyDaemon {
     }
     logTokenBalanceReconciled(route, requestId, settlement) {
         logger.info("token.balance.reconciled", "seller token balance reconciled from settlement", {
-            requestId: settlement.requestId || requestId,
+            requestId,
+            sellerRequestId: settlement.requestId !== requestId ? settlement.requestId : undefined,
             sellerKey: route.seller.id,
             model: route.modelId,
             remainingCreditMicros: settlement.remainingCreditMicros,
@@ -1339,7 +1386,7 @@ export class TokenbuddyDaemon {
             }
             return {
                 models: catalog.models,
-                sellers: catalog.sellers
+                sellers: this.sellerCatalogWithRuntimeMetrics(catalog.sellers)
             };
         }
         catch (error) {
@@ -1350,10 +1397,46 @@ export class TokenbuddyDaemon {
             const snapshot = catalogSnapshotFromRegistry(cached);
             return {
                 models: snapshot.models,
-                sellers: snapshot.sellers
+                sellers: this.sellerCatalogWithRuntimeMetrics(snapshot.sellers)
             };
         }
     }
+    sellerCatalogWithRuntimeMetrics(sellers) {
+        const runtimeBySellerId = new Map(this.sellerPool.snapshot().map((entry) => [entry.sellerId, entry]));
+        return sellers.map((seller) => {
+            const runtime = runtimeBySellerId.get(seller.id);
+            return {
+                ...seller,
+                ttftMs: runtime?.ttftMs ?? seller.ttftMs,
+                avgTokensPerSecond: runtime?.avgTokensPerSecond ?? seller.avgTokensPerSecond ?? 0
+            };
+        });
+    }
+    async refreshSellerRouteMetadata(sellers) {
+        try {
+            await this.sellerMetadataCache.refreshIfStale(sellers.filter(isBuyerVisibleRegistrySeller));
+        }
+        catch (error) {
+            logger.warn("route.metadata.refresh_failed", "seller route metadata refresh failed", {
+                errorMessage: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    routeMetricFromPoolEntry(entry, concurrency) {
+        const metadata = this.sellerMetadataCache.snapshot().find((item) => item.sellerId === entry.sellerId);
+        return {
+            sellerId: entry.sellerId,
+            healthScore: entry.healthScore,
+            avgLatencyMs: entry.avgLatencyMs,
+            ttftMs: entry.ttftMs,
+            avgInferenceMs: entry.avgInferenceMs,
+            avgTokensPerSecond: entry.avgTokensPerSecond,
+            discountRatio: metadata?.discountRatio,
+            circuit: entry.circuit,
+            capacityBlockedUntil: entry.capacityBlockedUntil,
+            ...(concurrency ?? {})
+        };
+    }
     readUsage(bodyText) {
         const fallback = {
             promptTokens: 0,
@@ -1396,8 +1479,11 @@ export class TokenbuddyDaemon {
             this.logTokenBalanceReconciled(route, requestId, settlement);
         }
         const settledMicros = settlement?.settledMicros;
+        const sellerRequestId = settlement?.requestId && settlement.requestId !== requestId
+            ? settlement.requestId
+            : undefined;
         this.tokenStore.recordInferenceLedger({
-            requestId: settlement?.requestId || requestId,
+            requestId,
             sellerKey: route.seller.id,
             modelId: route.modelId,
             endpoint,
@@ -1422,7 +1508,7 @@ export class TokenbuddyDaemon {
             paymentMethod: extras?.paymentMethod
         });
         logger.info("inference.ledger.recorded", "safe inference ledger recorded", {
-            requestId: settlement?.requestId || requestId,
+            requestId,
             sellerKey: route.seller.id,
             model: route.modelId,
             endpoint,
@@ -1435,6 +1521,7 @@ export class TokenbuddyDaemon {
             completionTokens: usage.completionTokens,
             balanceSnapshotMicros: settlement?.remainingCreditMicros,
             balanceSource: settlement ? "seller_authoritative" : "estimated",
+            sellerRequestId,
             ttftMs: extras?.ttftMs,
             fallbackCount: extras?.fallbackCount,
             routeReason: extras?.routeReason,
@@ -2069,21 +2156,25 @@ export class TokenbuddyDaemon {
                             // the `X-TokenBuddy-Deadline-Ms` header (PR-6) can propagate
                             // it to their own upstream fetch via the same signal.
                             const deadlineMs = this.requestDeadlineMs();
-                            const sendSellerRequest = async (token) => {
+                            const sendSellerRequest = async (token, retryOrdinal = 0) => {
+                                const attemptContext = sellerAttemptRequestContext(requestId, idempotencyKey, routeIndex, attempt, retryOrdinal);
                                 const requestAc = new AbortController();
                                 const requestTimer = setTimeout(() => requestAc.abort(new Error("buyer deadline exceeded")), deadlineMs);
                                 const headers = {
                                     "Content-Type": "application/json",
                                     "Authorization": `Bearer ${token}`,
-                                    "X-Request-Id": requestId,
-                                    "Idempotency-Key": idempotencyKey
+                                    "X-Request-Id": attemptContext.requestId,
+                                    "Idempotency-Key": attemptContext.idempotencyKey
                                 };
                                 headers["X-TokenBuddy-Deadline-Ms"] = String(deadlineMs);
                                 try {
                                     return await fetch(`${sellerUrl}${endpoint}`, {
                                         method: "POST",
                                         headers,
-                                        body: JSON.stringify(upstreamBody),
+                                        body: JSON.stringify({
+                                            ...upstreamBody,
+                                            requestId: attemptContext.requestId
+                                        }),
                                         signal: requestAc.signal
                                     });
                                 }
@@ -2227,6 +2318,7 @@ export class TokenbuddyDaemon {
                                     res.write(settlementTrailing.downstream);
                                 }
                                 res.end();
+                                void this.refreshSellerRuntimeMetrics(route, requestId);
                                 this.recordReconciledInference(route, endpoint, requestId, { promptTokens: 0, completionTokens: 0, billedMicros: Math.max(1, bytes) }, this.parseSellerSettlementSummary(upstreamResponse.headers) ?? settlementTrailing.settlement ?? settlementExtractor.current(), this.inferPromptForHash(body), undefined, {
                                     ttftMs: firstByteAt ? firstByteAt - startedAt : undefined,
                                     fallbackCount: routeIndex,
@@ -2243,6 +2335,7 @@ export class TokenbuddyDaemon {
                             markFirstByte();
                             res.send(responseBody);
                             const usage = this.readUsage(responseBody);
+                            void this.refreshSellerRuntimeMetrics(route, requestId);
                             this.recordReconciledInference(route, endpoint, requestId, usage, this.parseSellerSettlementSummary(upstreamResponse.headers), this.inferPromptForHash(body), responseBody, {
                                 ttftMs: firstByteAt ? firstByteAt - startedAt : undefined,
                                 fallbackCount: routeIndex,
@@ -2757,10 +2850,10 @@ export class TokenbuddyDaemon {
         });
         // 2) GET /routing/preview — 算「假如改完会怎样」，不改 state
         //   query: modelId? protocol? paymentMethod? mode? scorer? sellerId? sellerIds?(逗号分隔)
-        controlApp.get("/routing/preview", (req, res) => {
+        controlApp.get("/routing/preview", async (req, res) => {
             try {
                 const override = buildRoutingConfigFromQuery(req.query);
-                const result = this.buildRoutingPreview({
+                const result = await this.buildRoutingPreview({
                     modelId: typeof req.query.modelId === "string" ? req.query.modelId : undefined,
                     protocol: typeof req.query.protocol === "string" ? req.query.protocol : undefined,
                     paymentMethod: typeof req.query.paymentMethod === "string" ? req.query.paymentMethod : undefined,
@@ -2789,7 +2882,7 @@ export class TokenbuddyDaemon {
             }
         });
         // 3) PUT /routing/strategy — 写策略 + 热更新 + 返回 preview
-        controlApp.put("/routing/strategy", (req, res) => {
+        controlApp.put("/routing/strategy", async (req, res) => {
             try {
                 const body = (req.body ?? {});
                 const normalized = normalizeSellerRoutingConfig(body);
@@ -2803,7 +2896,7 @@ export class TokenbuddyDaemon {
                     sellerId: current.sellerId,
                     sellerIds: current.sellerIds
                 });
-                const preview = this.buildRoutingPreview({ routing: current });
+                const preview = await this.buildRoutingPreview({ routing: current });
                 const previewPayload = "error" in preview.plan
                     ? { error: preview.plan.error }
                     : {
@@ -3012,10 +3105,11 @@ export class TokenbuddyDaemon {
     /**
      * tb-ui v1 `GET /routing/preview` 和 `PUT /routing/strategy` 复用的 preview 计算。
      * 接受任意 routing 覆盖（来自 request body）算「假如改成这个，路由会是啥」。
-     * 不修改任何内部 state，**纯函数式**。
+     * 不修改 routing state；registry / seller metadata 可按需刷新，保证 preview
+     * 使用的候选和折扣信息与真实请求路径一致。
      */
-    buildRoutingPreview(input) {
-        const registry = this.lastRegistrySnapshot;
+    async buildRoutingPreview(input) {
+        const registry = this.lastRegistrySnapshot ?? (this.forceRegistrySnapshotForTest ? null : await this.fetchRegistry());
         const focusFirst = this.resolveFocusSet()[0];
         const registryFirst = registry?.sellers[0]?.models?.[0];
         const modelId = input.modelId?.trim() || focusFirst || registryFirst || "";
@@ -3033,6 +3127,7 @@ export class TokenbuddyDaemon {
             : current;
         const resolvedRouting = resolveSellerRoutingForModel(routing, modelId);
         const registrySellers = reorderDefaultSellerFirst(registry.sellers, registry.defaultSeller);
+        await this.refreshSellerRouteMetadata(registrySellers);
         this.sellerPool.ensureRegistrySellers(registrySellers);
         const poolById = new Map(this.sellerPool.snapshot().map((entry) => [entry.sellerId, entry]));
         const plan = planSellerRouteSet({
@@ -3042,15 +3137,7 @@ export class TokenbuddyDaemon {
             registrySellers,
             routing: resolvedRouting,
             prewarmCandidates: this.prewarmCache.get(modelId, protocol, paymentMethod)?.candidates,
-            sellerMetrics: Array.from(poolById.values()).map((entry) => ({
-                sellerId: entry.sellerId,
-                healthScore: entry.healthScore,
-                avgLatencyMs: entry.avgLatencyMs,
-                ttftMs: entry.ttftMs,
-                avgInferenceMs: entry.avgInferenceMs,
-                circuit: entry.circuit,
-                capacityBlockedUntil: entry.capacityBlockedUntil
-            })),
+            sellerMetrics: Array.from(poolById.values()).map((entry) => this.routeMetricFromPoolEntry(entry)),
             now: Date.now()
         });
         return { modelId, protocol, paymentMethod, plan };
@@ -3098,12 +3185,13 @@ export class TokenbuddyDaemon {
         this.tokenStore.close();
     }
     /**
-     * @internal — test-only seam to inject a registry snapshot without
+     * @internal - test-only hook to inject a registry snapshot without
      * hitting the network. Used by `tests/control-plane-ui-endpoints.test.ts`
      * to drive `buildRoutingPreview` deterministically. Production code
      * must NOT call this; the real `fetchRegistry()` populates the snapshot.
      */
     setLastRegistrySnapshotForTest(snapshot) {
+        this.forceRegistrySnapshotForTest = true;
         this.lastRegistrySnapshot = snapshot;
     }
 }