@dirgha/code 1.33.25 → 1.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -16,6 +16,9 @@
16
16
  * - Logs every failover event via the injected session logger.
17
17
  * - Falls through to the cheapest free model from the catalog when
18
18
  * no paid or family-alternative model is available.
19
+ *
20
+ * Failover blacklist state now lives in health-monitor.ts (unified).
21
+ * This file delegates to health-monitor for persistent blacklist checks.
19
22
  */
20
23
  export interface FailoverTier {
21
24
  model: string;
@@ -44,7 +47,6 @@ export interface FailoverOptions {
44
47
  };
45
48
  }
46
49
  export declare function recordFailover(modelId: string, sessionLogger?: FailoverOptions["sessionLogger"]): void;
47
- export declare function isBlacklisted(modelId: string): boolean;
48
50
  export declare function resetFailoverState(): void;
49
51
  export declare function resetModelBlacklist(modelId: string): void;
50
52
  export declare function buildFailoverChain(modelId: string, opts?: FailoverOptions): FailoverChain;
@@ -16,26 +16,46 @@
16
16
  * - Logs every failover event via the injected session logger.
17
17
  * - Falls through to the cheapest free model from the catalog when
18
18
  * no paid or family-alternative model is available.
19
+ *
20
+ * Failover blacklist state now lives in health-monitor.ts (unified).
21
+ * This file delegates to health-monitor for persistent blacklist checks.
19
22
  */
20
- import { lookupModel, PRICES } from "../intelligence/prices.js";
21
- import { familyAlternatives } from "../providers/family-fallback.js";
23
+ import { isBlacklisted, recordFailoverEvent, resetHealth } from './health-monitor.js';
24
+ import { PRICES } from './prices.js';
25
+ import { lookupModel } from './prices.js';
26
+ import { familyAlternatives } from '../providers/family-fallback.js';
22
27
  // Demoted 2026-05-08 — both models hang on NIM (verified live). Still
23
28
  // in the catalogue for manual `--model` selection; just not auto-picked.
24
29
  const AUTO_FAILOVER_BLACKLIST = new Set([
25
30
  "minimaxai/minimax-m2.7",
26
31
  "meta/llama-4-maverick-17b-128e-instruct",
27
32
  ]);
28
- /**
29
- * Per-session state: tracks consecutive failover counts per model.
30
- * After 5 consecutive failovers on the same model, it is blacklisted
31
- * for the remainder of the session.
32
- */
33
- const FAILOVER_BLACKLIST_THRESHOLD = 5;
34
- const failoverCounts = new Map();
35
- const blacklistedModels = new Set();
33
+ // ──────────────────────────────────────────────────────────
34
+ // One-time warning tracking for unknown models
35
+ // ──────────────────────────────────────────────────────────
36
+ const unknownModelWarned = new Set();
37
+ // ──────────────────────────────────────────────────────────
38
+ // Local helper: is a model blacklisted in the unified health state?
39
+ // ──────────────────────────────────────────────────────────
40
+ function isModelBlacklisted(modelId) {
41
+ const entry = PRICES.find(p => p.model === modelId);
42
+ if (!entry)
43
+ return false; // unknown model – can't check unified state
44
+ return isBlacklisted(entry.provider, modelId);
45
+ }
36
46
  export function recordFailover(modelId, sessionLogger) {
37
- const count = (failoverCounts.get(modelId) ?? 0) + 1;
38
- failoverCounts.set(modelId, count);
47
+ // Update unified blacklist in health-monitor.
48
+ const entry = PRICES.find(p => p.model === modelId);
49
+ if (entry) {
50
+ recordFailoverEvent(entry.provider, modelId);
51
+ }
52
+ else {
53
+ if (!unknownModelWarned.has(modelId)) {
54
+ unknownModelWarned.add(modelId);
55
+ console.warn(`[failover-chain] unknown model: ${modelId}`);
56
+ }
57
+ }
58
+ // Session logger — logs regardless of whether the unified update succeeded.
39
59
  void Promise.resolve().then(async () => {
40
60
  if (sessionLogger) {
41
61
  await sessionLogger
@@ -45,8 +65,6 @@ export function recordFailover(modelId, sessionLogger) {
45
65
  event: "failover",
46
66
  data: {
47
67
  model: modelId,
48
- consecutiveFailovers: count,
49
- blacklisted: count >= FAILOVER_BLACKLIST_THRESHOLD,
50
68
  },
51
69
  })
52
70
  .catch(() => {
@@ -54,28 +72,23 @@ export function recordFailover(modelId, sessionLogger) {
54
72
  });
55
73
  }
56
74
  });
57
- if (count >= FAILOVER_BLACKLIST_THRESHOLD) {
58
- blacklistedModels.add(modelId);
59
- }
60
- }
61
- export function isBlacklisted(modelId) {
62
- return blacklistedModels.has(modelId);
63
75
  }
64
76
  export function resetFailoverState() {
65
- failoverCounts.clear();
66
- blacklistedModels.clear();
77
+ // State is now in health-monitor; use resetHealth(provider, model) per pair to reset.
67
78
  }
68
79
  export function resetModelBlacklist(modelId) {
69
- failoverCounts.delete(modelId);
70
- blacklistedModels.delete(modelId);
80
+ const entry = PRICES.find(p => p.model === modelId);
81
+ if (!entry)
82
+ return;
83
+ resetHealth(entry.provider, modelId);
71
84
  }
72
85
  export function buildFailoverChain(modelId, opts = {}) {
73
86
  const maxTiers = opts.maxTiers ?? 4;
74
87
  const healthThreshold = opts.healthThreshold ?? -1;
75
88
  const seen = new Set();
76
89
  const tiers = [];
77
- // Skip the primary if it is blacklisted this session.
78
- if (!isBlacklisted(modelId)) {
90
+ // Skip the primary if it is blacklisted in unified state.
91
+ if (!isModelBlacklisted(modelId)) {
79
92
  tiers.push({ model: modelId, reason: "user-selected" });
80
93
  seen.add(modelId);
81
94
  }
@@ -88,7 +101,7 @@ export function buildFailoverChain(modelId, opts = {}) {
88
101
  !seen.has(p.model) &&
89
102
  p.provider !== price.provider).sort((a, b) => a.outputPerM + a.inputPerM - (b.outputPerM + b.inputPerM));
90
103
  for (const m of familyModels) {
91
- if (isBlacklisted(m.model))
104
+ if (isModelBlacklisted(m.model))
92
105
  continue;
93
106
  if (!isHealthy(m.provider, opts.healthScores, healthThreshold))
94
107
  continue;
@@ -106,7 +119,7 @@ export function buildFailoverChain(modelId, opts = {}) {
106
119
  // Tier 3 — familyAlternatives registry (cross-family provider map)
107
120
  const fam = familyAlternatives(modelId);
108
121
  for (const alt of fam) {
109
- if (isBlacklisted(alt.model))
122
+ if (isModelBlacklisted(alt.model))
110
123
  continue;
111
124
  if (seen.has(alt.model))
112
125
  continue;
@@ -122,7 +135,7 @@ export function buildFailoverChain(modelId, opts = {}) {
122
135
  p.inputPerM === 0 &&
123
136
  !seen.has(p.model) &&
124
137
  !AUTO_FAILOVER_BLACKLIST.has(p.model));
125
- if (free && !isBlacklisted(free.model) && !seen.has(free.model)) {
138
+ if (free && !isModelBlacklisted(free.model) && !seen.has(free.model)) {
126
139
  tiers.push({ model: free.model, reason: "free-fallback" });
127
140
  seen.add(free.model);
128
141
  if (tiers.length >= maxTiers)
@@ -1 +1 @@
1
- {"version":3,"file":"failover-chain.js","sourceRoot":"","sources":["../../src/intelligence/failover-chain.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"failover-chain.js","sourceRoot":"","sources":["../../src/intelligence/failover-chain.ts"],"names":[],"mappings":"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"}
@@ -9,19 +9,70 @@
9
9
  * 3. Success decays the failure window aggressively. 2 successes = fresh start.
10
10
  * 4. Cooldown level decays over 24h of good behavior.
11
11
  */
12
+ export type HealthKey = `${string}:${string}`;
12
13
  export interface ProviderHealth {
13
14
  provider: string;
15
+ model: string;
16
+ status: 'healthy' | 'cooldown' | 'failover_blacklisted';
14
17
  totalRequests: number;
15
- failures: number;
16
- lastFailure: number;
17
- lastSuccess: number;
18
18
  avgLatencyMs: number;
19
- blacklistedUntil: number | null;
19
+ failureCount: number;
20
+ failoverCount: number;
21
+ failoverBlacklisted: boolean;
20
22
  cooldownLevel: number;
23
+ cooldownUntil: number | null;
24
+ lastSuccessAt: number | null;
25
+ lastFailureAt: number | null;
21
26
  }
22
- export declare function recordSuccess(provider: string, latencyMs: number): void;
23
- export declare function recordFailure(provider: string, _error: string): void;
24
- export declare function isBlacklisted(provider: string): boolean;
25
- export declare function getHealth(provider: string): ProviderHealth | null;
27
+ /**
28
+ * Record a successful API call for a given (provider, model).
29
+ *
30
+ * Resets the failure window, clears failover state, and advances
31
+ * cooldown recovery (decrements cooldown level after 2 consecutive successes).
32
+ * Persists the updated state to disk.
33
+ */
34
+ export declare function recordSuccess(provider: string, model: string, latencyMs: number): void;
35
+ /**
36
+ * Record a failure for a given (provider, model).
37
+ *
38
+ * Counts failures in a rolling window; if the threshold (5) is reached,
39
+ * activates cooldown and increments the cooldown level.
40
+ * Does NOT affect failover state.
41
+ * Persists the updated state to disk.
42
+ */
43
+ export declare function recordFailure(provider: string, model: string, _error: string): void;
44
+ /**
45
+ * Record a failover event for a given (provider, model).
46
+ *
47
+ * Increments the failover counter. If the counter reaches MAX_FAILOVERS (3),
48
+ * marks the model as failover-blacklisted.
49
+ * Does NOT affect cooldown state.
50
+ * Persists the updated state to disk.
51
+ */
52
+ export declare function recordFailoverEvent(provider: string, model: string): void;
53
+ /**
54
+ * Check whether a given (provider, model) is currently blacklisted.
55
+ *
56
+ * A model is blacklisted if either:
57
+ * - failoverBlacklisted is true, OR
58
+ * - a cooldown is active AND no probe is currently in flight.
59
+ *
60
+ * When a cooldown is active and no probe is in flight, one probe is allowed
61
+ * through (sets probeActive=true, returns false). Subsequent calls while the
62
+ * probe is pending will return true (blocked) until the probe resolves via
63
+ * recordSuccess or recordFailure.
64
+ */
65
+ export declare function isBlacklisted(provider: string, model: string): boolean;
66
+ /**
67
+ * Return a snapshot of the health state for a given (provider, model),
68
+ * or null if no entry exists.
69
+ */
70
+ export declare function getHealth(provider: string, model: string): ProviderHealth | null;
71
+ /**
72
+ * Return an array of all tracked health entries.
73
+ */
26
74
  export declare function getAllHealth(): ProviderHealth[];
27
- export declare function resetHealth(provider: string): void;
75
+ /**
76
+ * Remove all health tracking for a given (provider, model) and persist.
77
+ */
78
+ export declare function resetHealth(provider: string, model: string): void;