harness-dispatch 0.4.0

package/dist/leaderboard.js

@@ -0,0 +1,287 @@
+/**
+ * Leaderboard-based quality scoring for harness-dispatch.
+ *
+ * Ported from `coding_agent.leaderboard`. Fetches Arena ELO scores from the
+ * public wulong.dev API with a 24-hour cache. Scores are used as routing
+ * quality multipliers — higher ELO → higher routing priority within the
+ * same tier.
+ *
+ * API reference: https://blog.wulong.dev/posts/i-built-an-auto-updating-archive-of-every-ai-arena-leaderboard/
+ * Endpoint:      https://api.wulong.dev/arena-ai-leaderboards/v1/leaderboard?name=code
+ */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+// ---------------------------------------------------------------------------
+// Constants — load-bearing, preserved from Python
+// ---------------------------------------------------------------------------
+export const LEADERBOARD_URL = "https://api.wulong.dev/arena-ai-leaderboards/v1/leaderboard?name=code";
+export const CACHE_TTL_MS = 24 * 3600 * 1000; // 24 hours
+export const FETCH_TIMEOUT_MS = 8000;
+// Tier auto-derivation thresholds (Arena ELO, calibrated April 2026)
+export const TIER1_ELO_MIN = 1350;
+export const TIER2_ELO_MIN = 1200;
+// High-thinking threshold relaxation
+export const THINKING_THRESHOLD_BOOST = 25;
+// Thinking level score multipliers
+export const THINKING_MULTIPLIERS = {
+    high: 1.15,
+    medium: 1.07,
+    low: 1.0,
+};
+// ELO normalization range → quality_score in [QUALITY_MIN, QUALITY_MAX]
+export const ELO_NORM_MIN = 1000;
+export const ELO_NORM_MAX = 1600;
+export const QUALITY_MIN = 0.6;
+export const QUALITY_MAX = 1.0;
+export const QUALITY_DEFAULT = 0.85;
+// User-Agent required — API returns 403 without it
+const USER_AGENT = "harness-dispatch/0.4 (leaderboard quality scoring)";
+// ---------------------------------------------------------------------------
+// Benchmark file resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve `data/coding_benchmarks.json` relative to this module.
+ *
+ * Walks up from wherever this module lives (dist/ when built, src/ when
+ * running via tsx) to find the package root containing `data/`.
+ */
+function resolveBenchmarkPath() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    // Walk up a few levels looking for data/coding_benchmarks.json.
+    // Handles src/, dist/, or deeper nesting.
+    let dir = here;
+    for (let i = 0; i < 6; i += 1) {
+        const candidate = path.join(dir, "data", "coding_benchmarks.json");
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    // Fall back to a "reasonable" path — caller just sees an empty benchmark map.
+    return path.join(here, "..", "data", "coding_benchmarks.json");
+}
+// ---------------------------------------------------------------------------
+// Helpers (exposed for testing)
+// ---------------------------------------------------------------------------
+export function normalizeElo(elo) {
+    let ratio = (elo - ELO_NORM_MIN) / (ELO_NORM_MAX - ELO_NORM_MIN);
+    ratio = Math.max(0, Math.min(1, ratio));
+    return QUALITY_MIN + (QUALITY_MAX - QUALITY_MIN) * ratio;
+}
+/**
+ * Case-insensitive partial-match lookup.
+ *
+ * Three-tier fallback (identical to Python `_fuzzy_match`):
+ *   1. Exact match after lowercasing.
+ *   2. Query is a substring of a leaderboard name → prefer the shortest
+ *      match (most specific entry that still contains the query).
+ *   3. All query words appear in the leaderboard name (order-insensitive) →
+ *      again prefer the shortest match.
+ */
+export function fuzzyMatch(query, scores) {
+    const q = query.toLowerCase().trim();
+    if (!q) {
+        return null;
+    }
+    // 1. Exact
+    if (Object.prototype.hasOwnProperty.call(scores, q)) {
+        return scores[q] ?? null;
+    }
+    // 2. Substring — query appears inside a leaderboard entry; prefer shortest.
+    const substrHits = [];
+    for (const [k, v] of Object.entries(scores)) {
+        if (k.includes(q)) {
+            substrHits.push([k, v]);
+        }
+    }
+    if (substrHits.length > 0) {
+        substrHits.sort((a, b) => a[0].length - b[0].length);
+        return substrHits[0][1];
+    }
+    // 3. All words appear in entry; prefer shortest.
+    const words = q.split(/\s+/).filter(Boolean);
+    const wordHits = [];
+    for (const [k, v] of Object.entries(scores)) {
+        if (words.every((w) => k.includes(w))) {
+            wordHits.push([k, v]);
+        }
+    }
+    if (wordHits.length > 0) {
+        wordHits.sort((a, b) => a[0].length - b[0].length);
+        return wordHits[0][1];
+    }
+    return null;
+}
+export class LeaderboardCache {
+    data = {};
+    fetchedAt = 0; // epoch ms
+    fetchFailed = false;
+    /** In-flight fetch promise — callers await it to serialize access. */
+    inflight = null;
+    benchmark = {};
+    benchmarkLoadedFlag = false;
+    benchmarkPath;
+    constructor(benchmarkPath) {
+        this.benchmarkPath = benchmarkPath ?? resolveBenchmarkPath();
+        this.loadBenchmarkFileSync();
+    }
+    // ------------------------------------------------------------------
+    // Public surface
+    // ------------------------------------------------------------------
+    benchmarkLoaded() {
+        return this.benchmarkLoadedFlag;
+    }
+    cacheAgeMs() {
+        if (this.fetchedAt === 0) {
+            return null;
+        }
+        return Date.now() - this.fetchedAt;
+    }
+    async getScores() {
+        await this.ensureFetched();
+        return this.data;
+    }
+    async getElo(leaderboardModel) {
+        if (!leaderboardModel) {
+            return null;
+        }
+        const scores = await this.getScores();
+        if (Object.keys(scores).length === 0) {
+            return null;
+        }
+        return fuzzyMatch(leaderboardModel, scores);
+    }
+    async getQualityScore(leaderboardModel, thinkingLevel) {
+        const mult = (thinkingLevel && THINKING_MULTIPLIERS[thinkingLevel]) ?? 1.0;
+        // 1. Blended benchmark file
+        if (leaderboardModel && this.benchmarkLoadedFlag) {
+            const bs = fuzzyMatch(leaderboardModel, this.benchmark);
+            if (bs !== null) {
+                const elo = await this.getElo(leaderboardModel);
+                return { qualityScore: bs * mult, elo };
+            }
+        }
+        // 2. Live Arena ELO
+        const elo = leaderboardModel ? await this.getElo(leaderboardModel) : null;
+        if (elo !== null) {
+            return { qualityScore: normalizeElo(elo) * mult, elo };
+        }
+        // 3. Default
+        return { qualityScore: QUALITY_DEFAULT * mult, elo: null };
+    }
+    async autoTier(leaderboardModel, thinkingLevel, fallbackTier) {
+        const elo = leaderboardModel ? await this.getElo(leaderboardModel) : null;
+        if (elo === null) {
+            return fallbackTier;
+        }
+        const boost = thinkingLevel === "high" ? THINKING_THRESHOLD_BOOST : 0;
+        if (elo + boost >= TIER1_ELO_MIN) {
+            return 1;
+        }
+        if (elo + boost >= TIER2_ELO_MIN) {
+            return 2;
+        }
+        return 3;
+    }
+    // ------------------------------------------------------------------
+    // Internal — fetch coordination
+    // ------------------------------------------------------------------
+    /** Ensure a fresh fetch has happened (or is in-flight); safe to call concurrently. */
+    async ensureFetched() {
+        const age = Date.now() - this.fetchedAt;
+        if (Object.keys(this.data).length > 0 && age < CACHE_TTL_MS) {
+            return;
+        }
+        if (this.fetchFailed && age < CACHE_TTL_MS) {
+            // Suppress repeated retries within the same TTL window.
+            return;
+        }
+        if (this.inflight) {
+            await this.inflight;
+            return;
+        }
+        this.inflight = this.doFetch().finally(() => {
+            this.inflight = null;
+        });
+        await this.inflight;
+    }
+    async doFetch() {
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+            let response;
+            try {
+                response = await fetch(LEADERBOARD_URL, {
+                    headers: { "User-Agent": USER_AGENT },
+                    signal: controller.signal,
+                });
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            if (!response.ok) {
+                this.fetchFailed = true;
+                // Update fetchedAt so the failure-suppression window starts now.
+                this.fetchedAt = Date.now();
+                return;
+            }
+            const payload = (await response.json());
+            const models = Array.isArray(payload.models) ? payload.models : [];
+            const parsed = {};
+            for (const m of models) {
+                if (typeof m.model === "string" && typeof m.score === "number") {
+                    parsed[m.model.toLowerCase()] = m.score;
+                }
+            }
+            if (Object.keys(parsed).length > 0) {
+                this.data = parsed;
+                this.fetchedAt = Date.now();
+                this.fetchFailed = false;
+            }
+            else {
+                this.fetchFailed = true;
+                this.fetchedAt = Date.now();
+            }
+        }
+        catch {
+            this.fetchFailed = true;
+            this.fetchedAt = Date.now();
+            // Return stale data rather than crashing routing.
+        }
+    }
+    // ------------------------------------------------------------------
+    // Benchmark file
+    // ------------------------------------------------------------------
+    loadBenchmarkFileSync() {
+        // Sync load at construction to match Python behaviour (loaded once at
+        // startup). Swallow all errors — missing/malformed file just falls back
+        // to the Arena API.
+        try {
+            if (!existsSync(this.benchmarkPath)) {
+                return;
+            }
+            // Sync IO here is acceptable: constructor runs once at startup.
+            const raw = readFileSync(this.benchmarkPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            const out = {};
+            const models = parsed.models ?? {};
+            for (const [k, v] of Object.entries(models)) {
+                const score = v?.coding_score;
+                if (typeof score === "number") {
+                    out[k.toLowerCase()] = score;
+                }
+            }
+            this.benchmark = out;
+            this.benchmarkLoadedFlag = Object.keys(out).length > 0;
+        }
+        catch {
+            // Malformed — silently fall back.
+        }
+    }
+}
+//# sourceMappingURL=leaderboard.js.map

package/dist/leaderboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard.js","sourceRoot":"","sources":["../src/leaderboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAC1B,uEAAuE,CAAC;AAE1E,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,WAAW;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAErC,qEAAqE;AACrE,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAElC,qCAAqC;AACrC,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C,mCAAmC;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,GAAG;CACT,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,mDAAmD;AACnD,MAAM,UAAU,GAAG,oDAAoD,CAAC;AAExE,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;;;GAKG;AACH,SAAS,oBAAoB;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,gEAAgE;IAChE,0CAA0C;IAC1C,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,wBAAwB,CAAC,CAAC;QACnE,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM;QACR,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,8EAA8E;IAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,wBAAwB,CAAC,CAAC;AACjE,CAAC;AAED,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,KAAK,GAAG,CAAC,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC,CAAC;IACjE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IACxC,OAAO,WAAW,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,KAAK,CAAC;AAC3D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,MAA8B;IAE9B,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW;IACX,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC3B,CAAC;IAED,4EAA4E;IAC5E,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACrD,OAAO,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,iDAAiD;IACjD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACnD,OAAO,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAWD,MAAM,OAAO,gBAAgB;IACnB,IAAI,GAA2B,EAAE,CAAC;IAClC,SAAS,GAAG,CAAC,CAAC,CAAC,WAAW;IAC1B,WAAW,GAAG,KAAK,CAAC;IAC5B,sEAAsE;IAC9D,QAAQ,GAAyB,IAAI,CAAC;IACtC,SAAS,GAA2B,EAAE,CAAC;IACvC,mBAAmB,GAAG,KAAK,CAAC;IAC5B,aAAa,CAAS;IAE9B,YAAY,aAAsB;QAChC,IAAI,CAAC,aAAa,GAAG,aAAa,IAAI,oBAAoB,EAAE,CAAC;QAC7D,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;IAED,qEAAqE;IACrE,iBAAiB;IACjB,qEAAqE;IAErE,eAAe;QACb,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,gBAAoC;QAC/C,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,UAAU,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,gBAAoC,EACpC,aAAwC;QAExC,MAAM,IAAI,GACR,CAAC,aAAa,IAAI,oBAAoB,CAAC,aAAa,CAAC,CAAC,IAAI,GAAG,CAAC;QAEhE,4BAA4B;QAC5B,IAAI,gBAAgB,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACjD,MAAM,EAAE,GAAG,UAAU,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACxD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBAChD,OAAO,EAAE,YAAY,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,GAAG,GAAG,gBAAgB,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1E,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC;QACzD,CAAC;QAED,aAAa;QACb,OAAO,EAAE,YAAY,EAAE,eAAe,GAAG,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,gBAAoC,EACpC,aAAwC,EACxC,YAAoB;QAEpB,MAAM,GAAG,GAAG,gBAAgB,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1E,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,KAAK,GAAG,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,IAAI,GAAG,GAAG,KAAK,IAAI,aAAa,EAAE,CAAC;YACjC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,GAAG,GAAG,KAAK,IAAI,aAAa,EAAE,CAAC;YACjC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,qEAAqE;IACrE,gCAAgC;IAChC,qEAAqE;IAErE,sFAAsF;IAC9E,KAAK,CAAC,aAAa;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QACxC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,YAAY,EAAE,CAAC;YAC5D,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,IAAI,GAAG,GAAG,YAAY,EAAE,CAAC;YAC3C,wDAAwD;YACxD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,QAAQ,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;YACrE,IAAI,QAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,KAAK,CAAC,eAAe,EAAE;oBACtC,OAAO,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE;oBACrC,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;YACL,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBACxB,iEAAiE;gBACjE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YACD,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAErC,CAAC;YACF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC/D,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;gBAC1C,CAAC;YACH,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;gBACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC5B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,kDAAkD;QACpD,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,iBAAiB;IACjB,qEAAqE;IAE7D,qBAAqB;QAC3B,sEAAsE;QACtE,wEAAwE;QACxE,oBAAoB;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;gBACpC,OAAO;YACT,CAAC;YACD,gEAAgE;YAChE,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAE5B,CAAC;YACF,MAAM,GAAG,GAA2B,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;YACnC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5C,MAAM,KAAK,GAAG,CAAC,EAAE,YAAY,CAAC;gBAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBAC9B,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;YACrB,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;CAEF"}

package/dist/mcp/config-hot-reload.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Config hot-reload for the MCP server.
+ *
+ * Ported from Python `server.py:_maybe_reload_config`. Rather than file-system
+ * watchers (which are flaky on Windows + WSL mounts), we poll the config
+ * file's mtime between tool calls. A reload rebuilds the dispatcher map,
+ * quota cache, and router — while preserving circuit-breaker state for any
+ * service that still exists in the new config.
+ *
+ * Concurrency: the reload is guarded by a mutex so that simultaneous
+ * tool-calls can't race on global state replacement. Only the first caller
+ * performs the reload; the rest wait behind the mutex and pick up the
+ * already-refreshed state.
+ */
+import { LeaderboardCache } from "../leaderboard.js";
+import { QuotaCache } from "../quota.js";
+import { Router } from "../router.js";
+import type { RouterConfig } from "../types.js";
+import { type DispatcherMap } from "./dispatcher-factory.js";
+export interface RuntimeState {
+    config: RouterConfig;
+    dispatchers: DispatcherMap;
+    quota: QuotaCache;
+    router: Router;
+    leaderboard: LeaderboardCache;
+    mtimeMs: number;
+    /**
+     * Where this runtime's config came from (undefined = auto-detect). Jobs
+     * pass it to their detached runner process so a run bootstraps against
+     * the SAME config file as the server that started it, not whatever the
+     * runner's cwd happens to contain.
+     */
+    configPath?: string;
+}
+/** A mutable holder you pass to tool handlers so hot-reloads are picked up. */
+export declare class RuntimeHolder {
+    state: RuntimeState;
+    constructor(state: RuntimeState);
+    replace(next: RuntimeState): void;
+}
+/**
+ * Bootstrap the full runtime from a config path. Used on server start and
+ * again (internally) when a reload is triggered.
+ */
+export declare function bootstrapRuntime(opts: {
+    configPath?: string;
+    leaderboard?: LeaderboardCache;
+}): Promise<RuntimeState>;
+/**
+ * Reload helper — pairs with a RuntimeHolder for in-place swap.
+ *
+ * If the config file's mtime has not moved since we last reloaded, the call
+ * is a cheap no-op. Circuit-breaker state from the previous router is
+ * preserved for every service that still exists in the new config.
+ */
+export declare class ConfigHotReloader {
+    private readonly holder;
+    private readonly configPath?;
+    private readonly mutex;
+    constructor(holder: RuntimeHolder, configPath?: string | undefined);
+    /** Returns true iff a reload actually happened. Swallows all errors. */
+    maybeReload(): Promise<boolean>;
+}
+//# sourceMappingURL=config-hot-reload.d.ts.map

package/dist/mcp/config-hot-reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-hot-reload.d.ts","sourceRoot":"","sources":["../../src/mcp/config-hot-reload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,aAAa,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+EAA+E;AAC/E,qBAAa,aAAa;IACxB,KAAK,EAAE,YAAY,CAAC;gBACR,KAAK,EAAE,YAAY;IAG/B,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;CAGlC;AAYD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,GAAG,OAAO,CAAC,YAAY,CAAC,CAmBxB;AAkBD;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAJ9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAGlB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,MAAM,YAAA;IAGtC,wEAAwE;IAClE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAwCtC"}

package/dist/mcp/config-hot-reload.js

@@ -0,0 +1,144 @@
+/**
+ * Config hot-reload for the MCP server.
+ *
+ * Ported from Python `server.py:_maybe_reload_config`. Rather than file-system
+ * watchers (which are flaky on Windows + WSL mounts), we poll the config
+ * file's mtime between tool calls. A reload rebuilds the dispatcher map,
+ * quota cache, and router — while preserving circuit-breaker state for any
+ * service that still exists in the new config.
+ *
+ * Concurrency: the reload is guarded by a mutex so that simultaneous
+ * tool-calls can't race on global state replacement. Only the first caller
+ * performs the reload; the rest wait behind the mutex and pick up the
+ * already-refreshed state.
+ */
+import { promises as fs } from "node:fs";
+import { loadConfig } from "../config.js";
+import { setJobRetentionDays } from "../jobs.js";
+import { LeaderboardCache } from "../leaderboard.js";
+import { QuotaCache } from "../quota.js";
+import { Router } from "../router.js";
+import { buildDispatchers } from "./dispatcher-factory.js";
+/** A mutable holder you pass to tool handlers so hot-reloads are picked up. */
+export class RuntimeHolder {
+    state;
+    constructor(state) {
+        this.state = state;
+    }
+    replace(next) {
+        this.state = next;
+    }
+}
+async function statMtime(path) {
+    if (!path)
+        return 0;
+    try {
+        const stat = await fs.stat(path);
+        return stat.mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Bootstrap the full runtime from a config path. Used on server start and
+ * again (internally) when a reload is triggered.
+ */
+export async function bootstrapRuntime(opts) {
+    const config = await loadConfig(opts.configPath);
+    // Runs at boot AND on every hot reload, so config-driven retention tracks
+    // the live config.
+    setJobRetentionDays(config.retention?.jobsDays);
+    const dispatchers = await buildDispatchers(config);
+    const quota = new QuotaCache(dispatchers);
+    const leaderboard = opts.leaderboard ?? new LeaderboardCache();
+    const router = new Router(config, quota, dispatchers, leaderboard);
+    const mtimeMs = await statMtime(opts.configPath);
+    return {
+        config,
+        dispatchers,
+        quota,
+        router,
+        leaderboard,
+        mtimeMs,
+        ...(opts.configPath !== undefined ? { configPath: opts.configPath } : {}),
+    };
+}
+/** Gate that serialises concurrent reload attempts. */
+class Mutex {
+    tail = Promise.resolve();
+    async run(task) {
+        const prev = this.tail;
+        let release;
+        this.tail = new Promise((r) => (release = r));
+        try {
+            await prev;
+            return await task();
+        }
+        finally {
+            release();
+        }
+    }
+}
+/**
+ * Reload helper — pairs with a RuntimeHolder for in-place swap.
+ *
+ * If the config file's mtime has not moved since we last reloaded, the call
+ * is a cheap no-op. Circuit-breaker state from the previous router is
+ * preserved for every service that still exists in the new config.
+ */
+export class ConfigHotReloader {
+    holder;
+    configPath;
+    mutex = new Mutex();
+    constructor(holder, configPath) {
+        this.holder = holder;
+        this.configPath = configPath;
+    }
+    /** Returns true iff a reload actually happened. Swallows all errors. */
+    async maybeReload() {
+        if (!this.configPath)
+            return false;
+        const mtimeMs = await statMtime(this.configPath);
+        if (mtimeMs === 0)
+            return false;
+        if (mtimeMs <= this.holder.state.mtimeMs)
+            return false;
+        return this.mutex.run(async () => {
+            // Re-check after acquiring the lock — another caller may have already
+            // reloaded, in which case we bail without redoing the work.
+            const current = this.holder.state.mtimeMs;
+            if (mtimeMs <= current)
+                return false;
+            let next;
+            try {
+                const bootOpts = {
+                    leaderboard: this.holder.state.leaderboard,
+                };
+                if (this.configPath !== undefined)
+                    bootOpts.configPath = this.configPath;
+                next = await bootstrapRuntime(bootOpts);
+            }
+            catch {
+                // Malformed edits shouldn't crash the server — keep the old state.
+                return false;
+            }
+            // Preserve circuit-breaker state for services that still exist.
+            const oldRouter = this.holder.state.router;
+            const oldBreakerStatus = oldRouter.circuitBreakerStatus();
+            for (const [name, status] of Object.entries(oldBreakerStatus)) {
+                if (!(name in next.config.services))
+                    continue;
+                const nb = next.router.getBreaker(name);
+                if (!nb)
+                    continue;
+                if (status.tripped) {
+                    nb.trip(status.cooldownRemainingSec ?? undefined);
+                }
+            }
+            this.holder.replace(next);
+            return true;
+        });
+    }
+}
+//# sourceMappingURL=config-hot-reload.js.map

package/dist/mcp/config-hot-reload.js.map

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

package/dist/mcp/dispatcher-factory.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Dispatcher factory — shared between the CLI (`bin.ts`) and the MCP server.
+ *
+ * Exactly two dispatcher classes exist: GenericCliDispatcher for every
+ * `type: cli` route (built-in harness or user-added — see the shipped
+ * config.default.yaml for how the 4 built-ins get their default behavior)
+ * and OpenAICompatibleDispatcher for `type: openai_compatible`. `harness:`
+ * no longer selects a dispatcher class — it only picks which CLI_DEFAULTS
+ * entry a route inherits metadata/protocol from at config-load time (see
+ * config.ts). Dispatch itself never branches on harness name.
+ */
+import type { Dispatcher } from "../dispatchers/base.js";
+import type { RouterConfig, ServiceConfig } from "../types.js";
+/** Map of enabled service name -> dispatcher instance. */
+export type DispatcherMap = Record<string, Dispatcher>;
+/** Build one dispatcher from a service config. */
+export declare function makeDispatcher(svc: ServiceConfig): Dispatcher;
+/** Build a dispatcher map for every enabled service in the config. */
+export declare function buildDispatchers(config: RouterConfig): DispatcherMap;
+//# sourceMappingURL=dispatcher-factory.d.ts.map

package/dist/mcp/dispatcher-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-factory.d.ts","sourceRoot":"","sources":["../../src/mcp/dispatcher-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/D,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEvD,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,CAG7D;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAOpE"}

package/dist/mcp/dispatcher-factory.js

@@ -0,0 +1,30 @@
+/**
+ * Dispatcher factory — shared between the CLI (`bin.ts`) and the MCP server.
+ *
+ * Exactly two dispatcher classes exist: GenericCliDispatcher for every
+ * `type: cli` route (built-in harness or user-added — see the shipped
+ * config.default.yaml for how the 4 built-ins get their default behavior)
+ * and OpenAICompatibleDispatcher for `type: openai_compatible`. `harness:`
+ * no longer selects a dispatcher class — it only picks which CLI_DEFAULTS
+ * entry a route inherits metadata/protocol from at config-load time (see
+ * config.ts). Dispatch itself never branches on harness name.
+ */
+import { GenericCliDispatcher } from "../dispatchers/generic-cli.js";
+import { OpenAICompatibleDispatcher } from "../dispatchers/openai-compatible.js";
+/** Build one dispatcher from a service config. */
+export function makeDispatcher(svc) {
+    if (svc.type === "openai_compatible")
+        return new OpenAICompatibleDispatcher(svc);
+    return new GenericCliDispatcher(svc);
+}
+/** Build a dispatcher map for every enabled service in the config. */
+export function buildDispatchers(config) {
+    const out = {};
+    for (const [name, svc] of Object.entries(config.services)) {
+        if (!svc.enabled)
+            continue;
+        out[name] = makeDispatcher(svc);
+    }
+    return out;
+}
+//# sourceMappingURL=dispatcher-factory.js.map

package/dist/mcp/dispatcher-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-factory.js","sourceRoot":"","sources":["../../src/mcp/dispatcher-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAOjF,kDAAkD;AAClD,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB;QAAE,OAAO,IAAI,0BAA0B,CAAC,GAAG,CAAC,CAAC;IACjF,OAAO,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,SAAS;QAC3B,GAAG,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/mcp/resources.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ConfigHotReloader, RuntimeHolder } from "./config-hot-reload.js";
+export interface ResourceDeps {
+    holder: RuntimeHolder;
+    reloader?: ConfigHotReloader;
+}
+export declare function registerResources(server: McpServer, deps: ResourceDeps): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/mcp/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE/E,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAkBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CA4C7E"}

package/dist/mcp/resources.js

@@ -0,0 +1,45 @@
+import { buildStatus, renderStatusText } from "../status.js";
+async function ensureFreshConfig(reloader) {
+    if (reloader)
+        await reloader.maybeReload();
+}
+async function currentStatus(deps) {
+    await ensureFreshConfig(deps.reloader);
+    const state = deps.holder.state;
+    return buildStatus(state.config, state.dispatchers, state.quota, state.router, state.leaderboard);
+}
+export function registerResources(server, deps) {
+    server.registerResource("status", "harness-dispatch://status", {
+        title: "Harness Router Status",
+        description: "Human-readable route availability, quota, and breaker state.",
+        mimeType: "text/plain",
+    }, async () => {
+        const status = await currentStatus(deps);
+        return {
+            contents: [
+                {
+                    uri: "harness-dispatch://status",
+                    mimeType: "text/plain",
+                    text: renderStatusText(status),
+                },
+            ],
+        };
+    });
+    server.registerResource("status-json", "harness-dispatch://status.json", {
+        title: "Harness Router Status JSON",
+        description: "Structured route availability, quota, and breaker state.",
+        mimeType: "application/json",
+    }, async () => {
+        const status = await currentStatus(deps);
+        return {
+            contents: [
+                {
+                    uri: "harness-dispatch://status.json",
+                    mimeType: "application/json",
+                    text: JSON.stringify(status, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAQ7D,KAAK,UAAU,iBAAiB,CAAC,QAAuC;IACtE,IAAI,QAAQ;QAAE,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAkB;IAC7C,MAAM,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAChC,OAAO,WAAW,CAChB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,WAAW,CAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,IAAkB;IACrE,MAAM,CAAC,gBAAgB,CACrB,QAAQ,EACR,2BAA2B,EAC3B;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,YAAY;KACvB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,2BAA2B;oBAChC,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC;iBAC/B;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACrB,aAAa,EACb,gCAAgC,EAChC;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,0DAA0D;QACvE,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,gCAAgC;oBACrC,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}