aigetwey 1.0.1

package/dist/core/quota.js

@@ -0,0 +1,165 @@
+const HOUR_MS = 3600_000;
+const DAY_MS = 24 * HOUR_MS;
+const WEEKDAYS = ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"];
+// ---- timezone-aware calendar math -----------------------------------------
+/** Wall-clock offset (ms) of `tz` at instant `date`: tzWallAsUTC - actualUTC. */
+function tzOffsetMs(date, tz) {
+    const dtf = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        hourCycle: "h23",
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+    });
+    const parts = Object.fromEntries(dtf.formatToParts(date).map((p) => [p.type, p.value]));
+    const asUTC = Date.UTC(Number(parts.year), Number(parts.month) - 1, Number(parts.day), Number(parts.hour), Number(parts.minute), Number(parts.second));
+    return asUTC - date.getTime();
+}
+/** Convert a desired wall-clock time in `tz` to an epoch ms. DST-corrected once. */
+function zonedWallToEpoch(y, mo, d, h, mi, tz) {
+    const guessUTC = Date.UTC(y, mo, d, h, mi);
+    const offset = tzOffsetMs(new Date(guessUTC), tz);
+    let epoch = guessUTC - offset;
+    // re-check once: the offset can differ across a DST boundary
+    const offset2 = tzOffsetMs(new Date(epoch), tz);
+    if (offset2 !== offset)
+        epoch = guessUTC - offset2;
+    return epoch;
+}
+/** Wall-clock parts of `nowMs` in `tz`. */
+function zonedParts(nowMs, tz) {
+    const dtf = new Intl.DateTimeFormat("en-US", {
+        timeZone: tz,
+        hourCycle: "h23",
+        weekday: "long",
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+    });
+    const p = Object.fromEntries(dtf.formatToParts(nowMs).map((x) => [x.type, x.value]));
+    return {
+        year: Number(p.year),
+        month: Number(p.month) - 1,
+        day: Number(p.day),
+        hour: Number(p.hour),
+        minute: Number(p.minute),
+        weekday: String(p.weekday).toLowerCase(),
+    };
+}
+function parseHHMM(reset_at) {
+    const m = /^(\d{1,2}):(\d{2})$/.exec(reset_at ?? "");
+    if (!m)
+        return { h: 0, m: 0 };
+    return { h: Math.min(23, Number(m[1])), m: Math.min(59, Number(m[2])) };
+}
+/**
+ * Next reset instant (epoch ms) strictly after `now` for a quota schedule.
+ *   - 5h:      rolling — windowStart + 5h.
+ *   - daily:   next `reset_at` (HH:MM, default 00:00) wall-clock in tz.
+ *   - weekly:  next `reset_at` weekday (default monday) at 00:00 in tz.
+ *   - monthly: next 1st of month at 00:00 in tz.
+ */
+export function nextResetAt(quota, windowStart, now) {
+    const tz = quota.timezone || "UTC";
+    if (quota.window === "5h")
+        return windowStart + 5 * HOUR_MS;
+    const p = zonedParts(now, tz);
+    if (quota.window === "daily") {
+        const { h, m } = parseHHMM(quota.reset_at);
+        let candidate = zonedWallToEpoch(p.year, p.month, p.day, h, m, tz);
+        if (candidate <= now)
+            candidate = zonedWallToEpoch(p.year, p.month, p.day + 1, h, m, tz);
+        return candidate;
+    }
+    if (quota.window === "weekly") {
+        const target = WEEKDAYS.indexOf((quota.reset_at ?? "monday").toLowerCase());
+        const targetIdx = target === -1 ? 1 : target;
+        const curIdx = WEEKDAYS.indexOf(p.weekday);
+        let daysAhead = (targetIdx - curIdx + 7) % 7;
+        let candidate = zonedWallToEpoch(p.year, p.month, p.day + daysAhead, 0, 0, tz);
+        if (candidate <= now)
+            candidate = zonedWallToEpoch(p.year, p.month, p.day + daysAhead + 7, 0, 0, tz);
+        return candidate;
+    }
+    // monthly: first of next month at 00:00
+    return zonedWallToEpoch(p.year, p.month + 1, 1, 0, 0, tz);
+}
+export class QuotaTracker {
+    now;
+    store;
+    states = new Map();
+    constructor(now = Date.now, store) {
+        this.now = now;
+        this.store = store;
+        if (store) {
+            for (const row of store.load()) {
+                this.states.set(row.provider_id, { windowStart: row.window_start, consumed: row.consumed });
+            }
+        }
+    }
+    /**
+     * Return the live state for a provider, rolling the window over (resetting
+     * consumed to 0) if `now` has crossed the scheduled reset boundary.
+     */
+    current(provider) {
+        if (!provider.quota)
+            return null;
+        const t = this.now();
+        const state = this.states.get(provider.id) ?? { windowStart: t, consumed: 0 };
+        if (!this.states.has(provider.id))
+            this.states.set(provider.id, state);
+        // boundary is the first reset AFTER this window opened — computed from
+        // windowStart, not `now`. Computing it from `now` would always return the
+        // NEXT future boundary and so never detect that we've crossed one.
+        const reset = nextResetAt(provider.quota, state.windowStart, state.windowStart);
+        if (t >= reset) {
+            state.windowStart = t;
+            state.consumed = 0;
+            this.store?.save(provider.id, state.windowStart, state.consumed);
+        }
+        return state;
+    }
+    /** Add consumed tokens for a provider (no-op if it has no quota config). */
+    consume(provider, tokens) {
+        const state = this.current(provider);
+        if (!state)
+            return;
+        state.consumed += Math.max(0, tokens);
+        this.store?.save(provider.id, state.windowStart, state.consumed);
+    }
+    /** True when a token limit is set AND it's been reached in the current window. */
+    isExhausted(provider) {
+        const state = this.current(provider);
+        if (!state || !provider.quota?.limit_tokens)
+            return false;
+        return state.consumed >= provider.quota.limit_tokens;
+    }
+    /** Dashboard view: window, consumed, countdown, and progress for each provider. */
+    snapshot(providers) {
+        const t = this.now();
+        return providers.flatMap((provider) => {
+            if (!provider.quota)
+                return [];
+            const state = this.current(provider);
+            const reset = nextResetAt(provider.quota, state.windowStart, t);
+            const limit = provider.quota.limit_tokens;
+            return [
+                {
+                    provider: provider.id,
+                    window: provider.quota.window,
+                    consumed: state.consumed,
+                    limit_tokens: limit,
+                    reset_in_ms: Math.max(0, reset - t),
+                    pct: limit ? Math.min(1, state.consumed / limit) : undefined,
+                    exhausted: limit ? state.consumed >= limit : false,
+                },
+            ];
+        });
+    }
+}
+//# sourceMappingURL=quota.js.map

package/dist/core/quota.js.map

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

package/dist/core/state.js

@@ -0,0 +1,52 @@
+/**
+ * Mutable holder for the live gateway config, key pool, and quota tracker.
+ *
+ * Config loads once at boot, but the dashboard edits it at runtime. Routes read
+ * `state.config` / `state.pool` / `state.quota` fresh per request (never close
+ * over them), so a successful reload swaps in the new config + pool atomically —
+ * no restart.
+ *
+ * reload() validates and persists BEFORE swapping: an invalid edit throws and
+ * the old config keeps serving. The pool is rebuilt (cooldown is transient), but
+ * the quota tracker is KEPT across reloads — a budget consumed this window must
+ * survive a config edit, else editing config would silently reset every quota.
+ */
+import { parseConfigText, validateConfig, unmaskSecrets, writeConfigFile, } from "../config.js";
+import { KeyPool } from "./keypool.js";
+import { QuotaTracker } from "./quota.js";
+export class GatewayState {
+    configPath;
+    _config;
+    _pool;
+    _quota;
+    constructor(configPath, initial, quota) {
+        this.configPath = configPath;
+        this._config = initial;
+        this._pool = new KeyPool();
+        this._quota = quota ?? new QuotaTracker();
+    }
+    get config() {
+        return this._config;
+    }
+    get pool() {
+        return this._pool;
+    }
+    get quota() {
+        return this._quota;
+    }
+    /**
+     * Validate edited config text, restore masked secrets from the live config,
+     * persist atomically, then swap in a fresh config + pool. Throws without
+     * changing anything if validation fails or a masked key can't be resolved —
+     * the old config keeps serving. The quota tracker is intentionally preserved.
+     */
+    reload(text) {
+        const parsed = parseConfigText(text);
+        const merged = unmaskSecrets(parsed.raw, this._config.raw);
+        const next = validateConfig(merged);
+        writeConfigFile(this.configPath, next.raw);
+        this._config = next;
+        this._pool = new KeyPool();
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/core/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAEL,eAAe,EACf,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,OAAO,YAAY;IAMJ;IALX,OAAO,CAAgB;IACvB,KAAK,CAAU;IACN,MAAM,CAAe;IAEtC,YACmB,UAAkB,EACnC,OAAsB,EACtB,KAAoB;QAFH,eAAU,GAAV,UAAU,CAAQ;QAInC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,KAAK,IAAI,IAAI,YAAY,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAY;QACjB,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,OAAO,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/dist/db.js

@@ -0,0 +1,193 @@
+/**
+ * Usage tracking store, backed by the built-in node:sqlite (no native build).
+ * One `usage` row per upstream request that produced usage; an optional `logs`
+ * table holds request/response summaries for debugging. Unified under DATA_DIR
+ * (default ./data).
+ */
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { createRequire } from "node:module";
+// node:sqlite is a recent builtin; require it dynamically so bundlers/test
+// transformers that don't yet know the `node:sqlite` specifier don't choke.
+const { DatabaseSync } = createRequire(import.meta.url)("node:sqlite");
+const num = (v) => Number(v ?? 0);
+export class UsageDB {
+    db;
+    insertUsage;
+    insertLog;
+    upsertQuota;
+    now;
+    constructor(path, now = Date.now) {
+        if (path !== ":memory:")
+            mkdirSync(dirname(path), { recursive: true });
+        this.db = new DatabaseSync(path);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS usage (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        ts INTEGER NOT NULL,
+        alias TEXT NOT NULL,
+        provider TEXT NOT NULL,
+        model TEXT NOT NULL,
+        tokens_in INTEGER NOT NULL DEFAULT 0,
+        tokens_out INTEGER NOT NULL DEFAULT 0,
+        cached_tokens INTEGER NOT NULL DEFAULT 0,
+        cost REAL NOT NULL DEFAULT 0,
+        status INTEGER NOT NULL,
+        latency_ms INTEGER NOT NULL DEFAULT 0,
+        stream INTEGER NOT NULL DEFAULT 0
+      );
+      CREATE INDEX IF NOT EXISTS idx_usage_ts ON usage(ts);
+      CREATE TABLE IF NOT EXISTS logs (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        ts INTEGER NOT NULL,
+        direction TEXT NOT NULL,
+        provider TEXT NOT NULL DEFAULT '',
+        status INTEGER NOT NULL DEFAULT 0,
+        request_summary TEXT NOT NULL DEFAULT '',
+        response_summary TEXT NOT NULL DEFAULT ''
+      );
+      CREATE INDEX IF NOT EXISTS idx_logs_ts ON logs(ts);
+      CREATE TABLE IF NOT EXISTS quota_state (
+        provider_id TEXT PRIMARY KEY,
+        window_start INTEGER NOT NULL,
+        consumed INTEGER NOT NULL DEFAULT 0,
+        last_reset INTEGER NOT NULL DEFAULT 0
+      );
+    `);
+        this.now = now;
+        this.insertUsage = this.db.prepare(`
+      INSERT INTO usage (ts, alias, provider, model, tokens_in, tokens_out, cached_tokens, cost, status, latency_ms, stream)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        this.insertLog = this.db.prepare(`
+      INSERT INTO logs (ts, direction, provider, status, request_summary, response_summary)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        // upsert keyed on provider_id so each provider keeps one live window row.
+        this.upsertQuota = this.db.prepare(`
+      INSERT INTO quota_state (provider_id, window_start, consumed, last_reset)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(provider_id) DO UPDATE SET window_start = excluded.window_start,
+        consumed = excluded.consumed, last_reset = excluded.last_reset
+    `);
+    }
+    record(row) {
+        this.insertUsage.run(row.ts ?? this.now(), row.alias, row.provider, row.model, row.tokens_in, row.tokens_out, row.cached_tokens, row.cost, row.status, row.latency_ms, row.stream);
+    }
+    log(row) {
+        this.insertLog.run(row.ts ?? this.now(), row.direction, row.provider, row.status, row.request_summary, row.response_summary);
+    }
+    /** Summary over rows with ts >= sinceMs (default: all time). */
+    summary(sinceMs = 0) {
+        const total = this.db
+            .prepare(`SELECT COUNT(*) requests, COALESCE(SUM(tokens_in),0) tokens_in,
+                COALESCE(SUM(tokens_out),0) tokens_out, COALESCE(SUM(cost),0) cost
+         FROM usage WHERE ts >= ?`)
+            .get(sinceMs);
+        const by_provider = this.db
+            .prepare(`SELECT provider, COUNT(*) requests, COALESCE(SUM(tokens_in),0) tokens_in,
+                COALESCE(SUM(tokens_out),0) tokens_out, COALESCE(SUM(cost),0) cost
+         FROM usage WHERE ts >= ? GROUP BY provider ORDER BY cost DESC`)
+            .all(sinceMs);
+        const by_model = this.db
+            .prepare(`SELECT alias, model, COUNT(*) requests, COALESCE(SUM(tokens_in),0) tokens_in,
+                COALESCE(SUM(tokens_out),0) tokens_out, COALESCE(SUM(cost),0) cost
+         FROM usage WHERE ts >= ? GROUP BY alias, model ORDER BY cost DESC`)
+            .all(sinceMs);
+        return {
+            total: {
+                requests: num(total.requests),
+                tokens_in: num(total.tokens_in),
+                tokens_out: num(total.tokens_out),
+                cost: num(total.cost),
+            },
+            by_provider: by_provider.map((r) => ({
+                provider: String(r.provider),
+                requests: num(r.requests),
+                tokens_in: num(r.tokens_in),
+                tokens_out: num(r.tokens_out),
+                cost: num(r.cost),
+            })),
+            by_model: by_model.map((r) => ({
+                alias: String(r.alias),
+                model: String(r.model),
+                requests: num(r.requests),
+                tokens_in: num(r.tokens_in),
+                tokens_out: num(r.tokens_out),
+                cost: num(r.cost),
+            })),
+        };
+    }
+    /**
+     * Bucketed time-series for charts: one point per `bucketMs` interval from
+     * `sinceMs` to now, aligned to the bucket boundary, with zero-filled gaps.
+     */
+    series(sinceMs, bucketMs) {
+        const now = this.now();
+        const start = Math.floor(sinceMs / bucketMs) * bucketMs;
+        const rows = this.db
+            .prepare(`SELECT CAST(ts / ? AS INTEGER) * ? AS bucket, COUNT(*) requests,
+                COALESCE(SUM(tokens_in),0) tokens_in,
+                COALESCE(SUM(tokens_out),0) tokens_out, COALESCE(SUM(cost),0) cost
+         FROM usage WHERE ts >= ? GROUP BY bucket ORDER BY bucket`)
+            .all(bucketMs, bucketMs, sinceMs);
+        const byBucket = new Map();
+        for (const r of rows)
+            byBucket.set(num(r.bucket), r);
+        const out = [];
+        for (let t = start; t <= now; t += bucketMs) {
+            const r = byBucket.get(t);
+            out.push({
+                ts: t,
+                requests: r ? num(r.requests) : 0,
+                tokens_in: r ? num(r.tokens_in) : 0,
+                tokens_out: r ? num(r.tokens_out) : 0,
+                cost: r ? num(r.cost) : 0,
+            });
+        }
+        return out;
+    }
+    /** Most recent usage rows, newest first. For the dashboard logs page. */
+    recent(limit = 100) {
+        const rows = this.db
+            .prepare(`SELECT ts, alias, provider, model, tokens_in, tokens_out, cached_tokens,
+                cost, status, latency_ms, stream
+         FROM usage ORDER BY id DESC LIMIT ?`)
+            .all(Math.max(1, Math.min(limit, 1000)));
+        return rows.map((r) => ({
+            ts: num(r.ts),
+            alias: String(r.alias),
+            provider: String(r.provider),
+            model: String(r.model),
+            tokens_in: num(r.tokens_in),
+            tokens_out: num(r.tokens_out),
+            cached_tokens: num(r.cached_tokens),
+            cost: num(r.cost),
+            status: num(r.status),
+            latency_ms: num(r.latency_ms),
+            stream: num(r.stream),
+        }));
+    }
+    // ---- QuotaStore: one live window row per provider (survives restart) ----
+    loadQuota() {
+        const rows = this.db.prepare(`SELECT provider_id, window_start, consumed FROM quota_state`).all();
+        return rows.map((r) => ({
+            provider_id: String(r.provider_id),
+            window_start: num(r.window_start),
+            consumed: num(r.consumed),
+        }));
+    }
+    saveQuota(providerId, windowStart, consumed) {
+        this.upsertQuota.run(providerId, windowStart, consumed, this.now());
+    }
+    close() {
+        this.db.close();
+    }
+}
+/** Compute USD cost from token counts and per-1M prices. */
+export function computeCost(tokensIn, tokensOut, priceIn, priceOut) {
+    const ci = priceIn ? (tokensIn / 1_000_000) * priceIn : 0;
+    const co = priceOut ? (tokensOut / 1_000_000) * priceOut : 0;
+    return ci + co;
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/headroom/compress.js

@@ -0,0 +1,44 @@
+const DEFAULT_TIMEOUT_MS = 3000;
+// POST messages to Headroom /v1/compress; returns compressed messages + stats or null.
+async function callCompress(url, messages, model, timeoutMs, compressUserMessages) {
+    const endpoint = `${String(url).replace(/\/$/, "")}/v1/compress`;
+    const payload = { messages, model };
+    if (compressUserMessages)
+        payload.config = { compress_user_messages: true };
+    const res = await fetch(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload),
+        signal: AbortSignal.timeout(timeoutMs),
+    });
+    if (!res.ok)
+        return null;
+    const data = (await res.json());
+    if (!Array.isArray(data?.messages))
+        return null;
+    return data;
+}
+/**
+ * Compress messages via the Headroom proxy. Returns the compressed messages +
+ * stats, or null on any failure (caller keeps the original messages).
+ */
+export async function compressWithHeadroom(messages, { url, model, compressUserMessages, timeoutMs = DEFAULT_TIMEOUT_MS }) {
+    if (!url || !Array.isArray(messages) || messages.length === 0)
+        return null;
+    try {
+        return await callCompress(url, messages, model, timeoutMs, compressUserMessages);
+    }
+    catch {
+        return null;
+    }
+}
+export function formatHeadroomLog(stats) {
+    if (!stats)
+        return null;
+    const before = stats.tokens_before || 0;
+    const after = stats.tokens_after || 0;
+    const saved = stats.tokens_saved || 0;
+    const pct = before > 0 ? ((saved / before) * 100).toFixed(1) : "0";
+    return `saved ${saved} tokens / ${before} (${pct}%) ${after ? `after=${after}` : ""}`.trim();
+}
+//# sourceMappingURL=compress.js.map

package/dist/headroom/compress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress.js","sourceRoot":"","sources":["../../src/headroom/compress.ts"],"names":[],"mappings":"AAYA,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAmBhC,uFAAuF;AACvF,KAAK,UAAU,YAAY,CACzB,GAAW,EACX,QAA4B,EAC5B,KAAa,EACb,SAAiB,EACjB,oBAA8B;IAE9B,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC;IACjE,MAAM,OAAO,GAA4B,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7D,IAAI,oBAAoB;QAAE,OAAO,CAAC,MAAM,GAAG,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC;IAC5E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;KACvC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAkB,CAAC;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAA4B,EAC5B,EAAE,GAAG,EAAE,KAAK,EAAE,oBAAoB,EAAE,SAAS,GAAG,kBAAkB,EAAwB;IAE1F,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAA2B;IAC3D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACnE,OAAO,SAAS,KAAK,aAAa,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;AAC/F,CAAC"}

package/dist/headroom/detect.js

@@ -0,0 +1,108 @@
+/**
+ * Headroom CLI detection. "Headroom" is an external context-compression proxy
+ * (a Python tool, `headroom proxy`, default http://localhost:8787) that aigetwey
+ * pipes request messages through. This module only DETECTS it — install, python
+ * interpreter, and whether a proxy is already reachable.
+ *
+ * aigetwey's own implementation.
+ */
+import { execSync } from "node:child_process";
+import { delimiter } from "node:path";
+const IS_WIN = process.platform === "win32";
+const WHICH_CMD = IS_WIN ? "where" : "which";
+// Extra bin dirs often missing from a packaged PATH (Python installs headroom here).
+const EXTRA_BINS = IS_WIN
+    ? [
+        `${process.env.LOCALAPPDATA || ""}\\Programs\\Python\\Python313\\Scripts`,
+        `${process.env.LOCALAPPDATA || ""}\\Programs\\Python\\Python312\\Scripts`,
+        `${process.env.LOCALAPPDATA || ""}\\Programs\\Python\\Python311\\Scripts`,
+        `${process.env.APPDATA || ""}\\Python\\Python313\\Scripts`,
+    ]
+    : [
+        "/usr/local/bin",
+        "/opt/homebrew/bin",
+        `${process.env.HOME || ""}/.local/bin`,
+        "/usr/bin",
+        "/bin",
+    ];
+const EXTENDED_PATH = [...EXTRA_BINS, process.env.PATH || ""].filter(Boolean).join(delimiter);
+const PYTHON_CANDIDATES = ["python3.13", "python3.12", "python3.11", "python3.10", "python3", "python"];
+const MIN_VERSION = [3, 10];
+const HEADROOM_HEALTH_TIMEOUT_MS = 1500;
+const LOOPBACK_HOSTS = new Set(["localhost", "127.0.0.1", "::1", "[::1]", "0.0.0.0"]);
+export const DEFAULT_HEADROOM_URL = process.env.HEADROOM_URL || "http://localhost:8787";
+/** Locate the `headroom` binary, or null if not installed. */
+export function findHeadroomBinary() {
+    try {
+        const out = execSync(`${WHICH_CMD} headroom`, {
+            stdio: ["ignore", "pipe", "ignore"],
+            windowsHide: true,
+            env: { ...process.env, PATH: EXTENDED_PATH },
+        })
+            .toString()
+            .trim();
+        // Windows `where` may return multiple lines — take the first.
+        return out ? (out.split(/\r?\n/)[0] ?? "").trim() || null : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Find a Python interpreter >= 3.10 (headroom-ai requires it), or null. */
+export function findPython310() {
+    for (const candidate of PYTHON_CANDIDATES) {
+        try {
+            const ver = execSync(`${candidate} --version`, {
+                stdio: ["ignore", "pipe", "ignore"],
+                windowsHide: true,
+                env: { ...process.env, PATH: EXTENDED_PATH },
+            })
+                .toString()
+                .trim();
+            const match = ver.match(/(\d+)\.(\d+)/);
+            if (!match)
+                continue;
+            const major = parseInt(match[1], 10);
+            const minor = parseInt(match[2], 10);
+            if (major > MIN_VERSION[0] || (major === MIN_VERSION[0] && minor >= MIN_VERSION[1])) {
+                return candidate;
+            }
+        }
+        catch {
+            // candidate not present, try next
+        }
+    }
+    return null;
+}
+/** Probe a Headroom proxy's /health. */
+export async function probeProxyRunning(url) {
+    if (!url)
+        return false;
+    const base = String(url).replace(/\/$/, "");
+    try {
+        const res = await fetch(`${base}/health`, { signal: AbortSignal.timeout(HEADROOM_HEALTH_TIMEOUT_MS) });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export function isLoopbackHeadroomUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return LOOPBACK_HOSTS.has(parsed.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+/** Aggregate status for the dashboard: installed, running, python interpreter. */
+export async function getHeadroomStatus(url) {
+    const path = findHeadroomBinary();
+    const python = findPython310();
+    const installed = Boolean(path);
+    const running = await probeProxyRunning(url);
+    const localUrl = isLoopbackHeadroomUrl(url);
+    return { installed, path, running, python, localUrl, canStart: installed && localUrl };
+}
+//# sourceMappingURL=detect.js.map

package/dist/headroom/detect.js.map

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