token-monitor/recommend.js

#!/usr/bin/env node
/**
 * recommend.js — Select optimal provider using token budget intelligence
 *
 * Reads from the cached token-monitor run (if fresh) or probes directly.
 * Returns the best Teams provider considering 7d budget utilization.
 *
 * Selection rules:
 *   1. status must be "allowed"
 *   2. Scan chain in order; take first with utilization_7d < SWITCH_THRESHOLD
 *   3. If none under threshold, take lowest-utilization allowed provider
 *   4. If no allowed Teams providers, return emergency=true (shelley-proxy)
 *
 * Usage:
 *   node recommend.js                              # JSON output
 *   node recommend.js --threshold 0.80             # switch above 80% 7d
 *   node recommend.js --chain "vigilio,ludo,molto" # provider order
 *
 * Output JSON:
 *   { provider, model, reason, emergency, alternatives }
 */

import { getProviders } from './providers/index.js';
import { probeTeamsProvider } from './providers/anthropic-teams.js';
import { getCachedRun } from './logger.js';

const args = process.argv.slice(2);

// Parse --threshold
const threshIdx = args.indexOf('--threshold');
const SWITCH_THRESHOLD = threshIdx !== -1 ? parseFloat(args[threshIdx + 1]) : 0.75;

// Parse --chain
const chainIdx = args.indexOf('--chain');
const DEFAULT_CHAIN = ['team-vigilio', 'team-ludo', 'team-molto', 'team-nadja'];
const PROVIDER_CHAIN = chainIdx !== -1
  ? args[chainIdx + 1].split(',').map(s => s.trim())
  : DEFAULT_CHAIN;

const DEFAULT_MODEL = 'claude-sonnet-4-6';
const EMERGENCY_FALLBACK = 'shelley-proxy';

// Format utilization as percentage string
function pct(v) {
  if (v == null) return '?';
  return `${Math.round(v * 100)}%`;
}

async function getProviderData() {
  // Try fresh cache first (within 20 minutes from monitor.js runs)
  const cached = getCachedRun(20);
  if (cached && cached.providers) {
    // Cache hit — but check if all chain members are invalid_key
    // If so, probe fresh: invalid_key can be transient (API 401s during key rotation)
    // vs. rejected/exhausted which are stable budget states worth caching
    const chainProviders = PROVIDER_CHAIN
      .map(name => cached.providers[name])
      .filter(Boolean);
    const allInvalidOrMissing = chainProviders.length === 0 ||
      chainProviders.every(p => p.status === 'invalid_key' || p.status === 'error');
    if (!allInvalidOrMissing) {
      return { source: 'cache', providers: cached.providers };
    }
    // All invalid — fall through to fresh probe
  }

  // No cache — probe Teams providers directly (no full monitor run, targeted probes only)
  const allProviders = getProviders();
  const providers = {};

  for (const name of PROVIDER_CHAIN) {
    const p = allProviders[name];
    if (!p || p.type !== 'teams-direct') continue;
    try {
      const result = await probeTeamsProvider(p.name, p.baseUrl, p.apiKey);
      providers[name] = result;
    } catch (e) {
      providers[name] = { type: 'teams-direct', status: 'error', utilization_7d: null };
    }
  }

  return { source: 'fresh', providers };
}

async function main() {
  const { source, providers } = await getProviderData();

  // Filter to chain members that are Teams providers with data
  const candidates = PROVIDER_CHAIN
    .filter(name => providers[name] && providers[name].type === 'teams-direct')
    .map(name => ({ name, ...providers[name] }));

  // Phase 1: first provider under threshold with status=allowed
  let best = null;
  for (const p of candidates) {
    if (p.status === 'allowed') {
      const util7d = p.utilization_7d ?? 0;
      if (util7d < SWITCH_THRESHOLD) {
        best = {
          name: p.name,
          reason: `7d at ${pct(util7d)}, 5h at ${pct(p.utilization_5h)} — under ${pct(SWITCH_THRESHOLD)} threshold (data: ${source})`,
        };
        break;
      }
    }
  }

  // Phase 2: all over threshold — pick lowest 7d utilization that's still allowed
  if (!best) {
    let lowestUtil = Infinity;
    let lowestCandidate = null;
    for (const p of candidates) {
      if (p.status === 'allowed') {
        const util7d = p.utilization_7d ?? 0;
        if (util7d < lowestUtil) {
          lowestUtil = util7d;
          lowestCandidate = p;
        }
      }
    }
    if (lowestCandidate) {
      best = {
        name: lowestCandidate.name,
        reason: `all over threshold — best available at ${pct(lowestUtil)} 7d (data: ${source})`,
      };
    }
  }

  // Build alternatives summary
  const alternatives = candidates
    .filter(p => !best || p.name !== best.name)
    .map(p => ({
      name: p.name,
      status: p.status,
      utilization_7d: p.utilization_7d,
      utilization_5h: p.utilization_5h,
    }));

  // Phase 3: no allowed Teams providers
  if (!best) {
    console.log(JSON.stringify({
      provider: EMERGENCY_FALLBACK,
      model: DEFAULT_MODEL,
      reason: 'all Teams providers exhausted — emergency fallback',
      emergency: true,
      alternatives,
    }, null, 2));
    return;
  }

  console.log(JSON.stringify({
    provider: best.name,
    model: DEFAULT_MODEL,
    reason: best.reason,
    emergency: false,
    alternatives,
  }, null, 2));
}

main().catch(e => {
  // Safe fallback — never crash beat.sh
  console.log(JSON.stringify({
    provider: 'team-vigilio',
    model: DEFAULT_MODEL,
    reason: `recommend.js error — defaulting: ${e.message}`,
    emergency: false,
    alternatives: [],
  }, null, 2));
  process.exit(0);
});