tinybeeai 0.0.0-stage → 0.16.1

package/dist/agent/model-errors.js

@@ -0,0 +1,188 @@
+// Model errors (KAT-102). One classifier for every backend: it maps an error, the stderr of a CLI,
+// or an HTTP status to a kind and a human reason. Quota, spend cap, rate limit and an expired
+// sign-in mean "this model cannot answer right now"; they are not a bad reply, so no backend may
+// turn them into a rule-based verdict. Backends throw ModelUnavailableError instead, and the guard
+// in model-guard.ts marks the backend unavailable and moves on to the next one.
+import { redact } from './redact.js';
+import { meterUsage } from './token-meter.js';
+export const REASONS = {
+    spend_cap: 'spend cap reached (set by the owner of the workspace)',
+    quota: 'usage quota or credits used up',
+    rate_limit: 'rate limited or overloaded',
+    auth_expired: 'sign-in expired or was rejected',
+};
+export function isUnavailableKind(kind) {
+    return kind !== 'other';
+}
+// Order matters: a spend cap or a quota message arrives with HTTP 429 as often as a plain rate limit does.
+const SPEND_CAP = /spend(?:ing)?[ -](?:cap|limit)|limit set by (?:the )?(?:owner|admin|organi[sz]ation|workspace)|specified api usage limits|monthly (?:spend|spending|budget)|workspace (?:spend|spending|usage|budget)|budget (?:cap|limit|exceeded)/i;
+const QUOTA = /insufficient[_ ]quota|exceeded your current quota|quota (?:exceeded|exhausted|reached)|credit balance|out of (?:credits|usage)|insufficient (?:credits|funds|balance)|payment required|billing[_ ](?:hard[_ ]limit|not[_ ]active|limit)|usage[ -]limit|hit your (?:usage )?limit|(?:5-hour|five-hour|weekly|daily|monthly) limit|reached your (?:[\w ]{0,30})?limit/i;
+const AUTH = /not (?:logged|signed) in|please (?:log|sign) ?in|(?:codex|claude) (?:login|auth login)|\/login\b|token (?:has )?expired|expired (?:token|session|credentials?)|session expired|refresh token|authentication[_ ]error|invalid[_ ](?:api[_ ]key|x-api-key|authentication|bearer)|invalid api key|incorrect api key|unauthori[sz]ed|oauth token|re-?authenticate/i;
+const RATE = /rate[ _-]?limit|too many requests|requests per (?:min|minute|day|second)|tokens per min|overloaded/i;
+const UNITS = { ms: 1, s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000 };
+function unitMs(u) {
+    const k = u.toLowerCase();
+    if (k.startsWith('ms') || k.startsWith('milli'))
+        return UNITS.ms;
+    if (k.startsWith('s'))
+        return UNITS.s;
+    if (k.startsWith('m'))
+        return UNITS.m;
+    if (k.startsWith('h'))
+        return UNITS.h;
+    return UNITS.d;
+}
+/** "retry after 20 s", "try again in 1 hour 5 minutes", "regain access on 2026-11-01", "usage limit reached|1760000000". */
+export function parseRetryAfter(text, header, now = Date.now()) {
+    const cap = (ms) => (Number.isFinite(ms) && ms > 0 ? Math.min(ms, 7 * 86_400_000) : undefined);
+    if (header !== undefined && header !== null && header !== '') {
+        const n = Number(header);
+        if (Number.isFinite(n))
+            return cap(n * 1000);
+        const at = Date.parse(String(header));
+        if (Number.isFinite(at))
+            return cap(at - now);
+    }
+    const rel = /(?:retry|try again|wait)(?: again)?(?: after| in|:)?\s*((?:\d+(?:\.\d+)?\s*(?:milliseconds?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d)\b[\s,]*(?:and\s*)?)+)/i.exec(text);
+    if (rel) {
+        let total = 0;
+        for (const m of rel[1].matchAll(/(\d+(?:\.\d+)?)\s*(milliseconds?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d)\b/gi))
+            total += Number(m[1]) * unitMs(m[2]);
+        const out = cap(total);
+        if (out)
+            return out;
+    }
+    const epoch = /usage limit reached\|(\d{10})\b/i.exec(text);
+    if (epoch)
+        return cap(Number(epoch[1]) * 1000 - now);
+    const iso = /(?:regain access|resets?|try again|available again|renews?)(?: again)?(?: on| at)?\s*(\d{4}-\d\d-\d\d(?:[T ][\d:.]+(?:Z|[+-]\d\d:?\d\d)?)?)/i.exec(text);
+    if (iso) {
+        const at = Date.parse(iso[1].length === 10 ? `${iso[1]}T00:00:00Z` : iso[1]);
+        if (Number.isFinite(at))
+            return cap(at - now);
+    }
+    return undefined;
+}
+function header(h, name) {
+    if (!h || typeof h !== 'object')
+        return undefined;
+    const get = h.get;
+    if (typeof get === 'function') {
+        const v = get.call(h, name);
+        return typeof v === 'string' ? v : undefined;
+    }
+    const rec = h;
+    const v = rec[name] ?? rec[name.toLowerCase()];
+    return typeof v === 'string' || typeof v === 'number' ? String(v) : undefined;
+}
+/** Flattens whatever a backend caught (string, Error, SDK error, CLI result) into a ModelErrorInput. */
+export function toErrorInput(e) {
+    if (typeof e === 'string')
+        return { message: e };
+    if (!e || typeof e !== 'object')
+        return { message: String(e ?? '') };
+    const o = e;
+    const obj = (v) => (v && typeof v === 'object' ? v : undefined);
+    const body = obj(o.error);
+    const inner = obj(body?.error) ?? body;
+    const parts = [typeof o.message === 'string' ? o.message : '', typeof inner?.message === 'string' ? inner.message : ''].filter(Boolean);
+    const input = { message: [...new Set(parts)].join('\n') };
+    if (typeof o.stderr === 'string')
+        input.stderr = o.stderr;
+    const status = o.status ?? o.statusCode ?? o.api_error_status;
+    if (typeof status === 'number')
+        input.status = status;
+    const type = inner?.type ?? o.type ?? (typeof o.code === 'string' ? o.code : undefined);
+    if (typeof type === 'string')
+        input.type = type;
+    const ra = header(o.headers, 'retry-after') ?? (typeof o.retryAfter === 'number' || typeof o.retryAfter === 'string' ? String(o.retryAfter) : undefined);
+    if (ra)
+        input.retryAfter = ra;
+    return input;
+}
+function tailOf(text, max = 300) {
+    const t = text.trim();
+    return redact(t.length > max ? `...${t.slice(-max)}` : t);
+}
+/**
+ * The classifier every backend calls. `other` means the error says nothing about the model's
+ * availability (a timeout, a bad reply, a missing binary) and the caller keeps its own handling.
+ */
+export function classifyModelError(e, now = Date.now()) {
+    if (e instanceof ModelUnavailableError)
+        return { kind: e.kind, reason: e.reason, detail: e.detail, ...(e.retryAfterMs ? { retryAfterMs: e.retryAfterMs } : {}) };
+    const input = toErrorInput(e);
+    const text = [input.message, input.stderr, input.type].filter(Boolean).join('\n');
+    const status = input.status;
+    let kind = 'other';
+    if (SPEND_CAP.test(text))
+        kind = 'spend_cap';
+    else if (status === 402 || QUOTA.test(text) || /insufficient_quota|billing_not_active/i.test(input.type ?? ''))
+        kind = 'quota';
+    else if (status === 401 || AUTH.test(text))
+        kind = 'auth_expired';
+    else if (status === 429 || status === 529 || RATE.test(text) || /rate_limit|overloaded/i.test(input.type ?? ''))
+        kind = 'rate_limit';
+    if (kind === 'other')
+        return { kind, reason: '', detail: tailOf(text) };
+    const retryAfterMs = parseRetryAfter(text, input.retryAfter, now);
+    return { kind, reason: REASONS[kind], detail: tailOf(text), ...(retryAfterMs ? { retryAfterMs } : {}) };
+}
+/** Thrown by a backend when a call failed because the model cannot answer right now. */
+export class ModelUnavailableError extends Error {
+    kind;
+    reason;
+    detail;
+    retryAfterMs;
+    /** Which backend method raised it, set by the guard when it knows. */
+    method;
+    /** Every backend the guard tried, when none worked. */
+    tried;
+    constructor(problem, opts = {}) {
+        if (problem.kind === 'other')
+            throw new TypeError('ModelUnavailableError needs a quota, spend_cap, rate_limit or auth_expired problem');
+        super(`Model unavailable: ${problem.reason}`, opts.cause === undefined ? undefined : { cause: opts.cause });
+        this.name = 'ModelUnavailableError';
+        this.kind = problem.kind;
+        this.reason = problem.reason;
+        this.detail = problem.detail;
+        if (problem.retryAfterMs)
+            this.retryAfterMs = problem.retryAfterMs;
+    }
+}
+/** The error to throw for a caught failure when it is an availability problem, else undefined. */
+export function unavailableFrom(e) {
+    if (e instanceof ModelUnavailableError)
+        return e;
+    const p = classifyModelError(e);
+    return p.kind === 'other' ? undefined : new ModelUnavailableError(p, { cause: e });
+}
+/**
+ * For catch blocks that would otherwise swallow the error into a rule-based answer. It only looks at the
+ * type: the classifier already ran where the provider error was caught, and a parse failure message must
+ * never be read as a quota problem.
+ */
+export function rethrowIfUnavailable(e) {
+    if (e instanceof ModelUnavailableError)
+        throw e;
+}
+/** Quota, spend cap, rate limit or expired sign-in in what the CLI printed (KAT-102): throws ModelUnavailableError. */
+export function throwIfUnavailable(res, detail, status) {
+    const fromText = /API Error:?\s*(\d{3})/i.exec(detail)?.[1];
+    const problem = classifyModelError({ message: detail, stderr: res.stderr, status: status ?? (fromText ? Number(fromText) : undefined) });
+    if (problem.kind !== 'other')
+        throw new ModelUnavailableError(problem);
+}
+/** Runs a provider call; a quota, spend cap, rate limit or auth failure leaves as ModelUnavailableError, anything else as is. */
+export async function classifyThrown(fn) {
+    try {
+        const out = await fn();
+        // The Anthropic SDK puts the token counts of a reply in `usage` (KAT-362).
+        meterUsage(out?.usage);
+        return out;
+    }
+    catch (e) {
+        throw unavailableFrom(e) ?? e;
+    }
+}
+//# sourceMappingURL=model-errors.js.map

package/dist/agent/model-errors.js.map

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

package/dist/agent/model-guard.js

@@ -0,0 +1,311 @@
+// The one choke point for model calls (KAT-102). getLlm() and the PR review backend are wrapped in
+// this guard, so analyze, score, review, chat, free text (write) and both review passes behave the same way:
+//
+//   1. A call that fails with a quota, spend cap, rate limit or expired sign-in marks that backend
+//      unavailable (model-availability.ts) with a time to look again.
+//   2. The call moves on to the next backend that is signed in and ready, in the order of the model
+//      switcher list (KAT-83), and says so: a step on the run and a push. A subscription (Claude CLI,
+//      Codex CLI) never moves on to a paid per-use key unless allowPaidFallback is on (KAT-188). A team server
+//      never moves on to a CLI login that an admin did not choose (KAT-362).
+//   3. A backend whose wait is over gets the next call first, so work moves back by itself; a timer
+//      (recheckPreferred) tests it when no call comes.
+//   4. When no backend answers, the call throws ModelUnavailableError. Flows end the run as
+//      interrupted, with no verdict, and one push says no model works.
+//
+// The rule-based mock is never a fallback: it would turn "the model is down" into a product verdict.
+import { log } from '../config.js';
+import { notify } from '../notify/push.js';
+import { countedCall } from '../model-usage.js';
+import { currentRunId } from '../queue.js';
+import { ModelUnavailableError } from './model-errors.js';
+import { FAMILY_LABEL, availabilityNow, beginProbe, dueForRecheck, endProbe, getUnavailability, hostLoginWithheld, inCooldown, isPaidFamily, markAvailable, markUnavailable, paidFallbackAllowed, setUsingInstead, } from './model-availability.js';
+import { addStep } from './runs.js';
+import { scrubVerdict } from './team-notes.js';
+const NONE_NOTICE_EVERY_MS = 60 * 60_000;
+let lastNoneNotice = 0;
+const stepped = new Set();
+function push(n) {
+    void notify(n).catch((err) => log.warn(`model: push failed: ${String(err)}`));
+}
+const defaultHooks = {
+    fallback({ from, to, reason }) {
+        log.warn(`model: ${FAMILY_LABEL[from]} unavailable (${reason}); using ${FAMILY_LABEL[to]}`);
+        push({
+            key: `model-fallback:${from}:${to}`,
+            title: `Model unavailable: ${FAMILY_LABEL[from]}`,
+            body: `${reason}. localdost switched to ${FAMILY_LABEL[to]} and goes back when ${FAMILY_LABEL[from]} works again.`,
+            url: '/#/setup',
+            urgency: 'low',
+        });
+    },
+    recovered({ family, wasUsing }) {
+        log.info(`model: ${FAMILY_LABEL[family]} works again${wasUsing ? `; leaving ${FAMILY_LABEL[wasUsing]}` : ''}`);
+        push({
+            key: `model-recovered:${family}`,
+            title: `${FAMILY_LABEL[family]} works again`,
+            body: wasUsing ? `localdost switched back from ${FAMILY_LABEL[wasUsing]}.` : 'Dots use it again.',
+            url: '/#/setup',
+            urgency: 'low',
+        });
+    },
+    noneWorking({ reason }) {
+        log.error(`model: no model works: ${reason}`);
+        push({
+            key: 'model-none-working',
+            title: 'Model unavailable: no model works',
+            body: `${reason}. Runs stop before the verdict and can be retried once a model works.`,
+            url: '/#/setup',
+            urgency: 'high',
+        });
+    },
+    runStep(label, detail, status) {
+        const id = currentRunId();
+        if (!id)
+            return;
+        const key = `${id}:${label}:${detail}`;
+        if (stepped.has(key))
+            return;
+        stepped.add(key);
+        if (stepped.size > 500)
+            stepped.delete(stepped.values().next().value);
+        try {
+            addStep(id, label, detail, status);
+        }
+        catch {
+            /* the run row is gone */
+        }
+    },
+};
+let hooks = defaultHooks;
+/** Test hook: replace some hooks, or all with no argument. */
+export function setGuardHooks(patch) {
+    hooks = patch ? { ...hooks, ...patch } : defaultHooks;
+    if (!patch)
+        lastNoneNotice = 0;
+}
+function summarize(tried, withheld, logins) {
+    let out = tried.length === 1 && !withheld.length && !logins.length ? tried[0].reason : tried.map((t) => `${t.label}: ${t.reason}`).join('; ');
+    // Name the capped subscription and say why the paid key was left alone (KAT-188).
+    if (withheld.length)
+        out += `. Paid fallback is off, so ${withheld.join(' and ')} was not used. Turn it on in Settings > Model to allow it`;
+    // A team server leaves the CLI logins of its machine alone unless an admin chose one (KAT-362).
+    if (logins.length)
+        out += `. This is a team server, so the ${logins.join(' and ')} login on this machine was not used. Choose it in Settings > Model to allow it`;
+    return out;
+}
+/**
+ * Runs `call` on the preferred backend, then on each ready one until one answers. Only
+ * ModelUnavailableError moves it on; any other error leaves as it is.
+ */
+export async function runGuarded(src, call, opts = {}) {
+    const pref = src.preferred();
+    if (!pref)
+        return call(src.primary());
+    const tried = [];
+    const plan = [];
+    /** Paid backends that were ready but left out because allowPaidFallback is off. */
+    const withheld = [];
+    /** CLI logins that were ready but left out because this is a team server and no admin chose them. */
+    const logins = [];
+    const consider = (c) => {
+        if (c.family !== pref && hostLoginWithheld(c.family)) {
+            logins.push(FAMILY_LABEL[c.family]);
+            return;
+        }
+        // A subscription never moves on to a paid per-use key unless the owner allowed it (KAT-188).
+        if (c.family !== pref && isPaidFamily(c.family) && !isPaidFamily(pref) && !paidFallbackAllowed()) {
+            withheld.push(FAMILY_LABEL[c.family]);
+            return;
+        }
+        const e = getUnavailability(c.family);
+        if (!e) {
+            plan.push({ c, probe: false });
+        }
+        else if (dueForRecheck(c.family) && beginProbe(c.family)) {
+            plan.push({ c, probe: true });
+        }
+        else {
+            tried.push({ family: c.family, label: FAMILY_LABEL[c.family], reason: e.reason, skipped: true });
+        }
+    };
+    consider({ family: pref, backend: src.primary() });
+    let othersLoaded = false;
+    const loadOthers = async () => {
+        if (othersLoaded)
+            return;
+        othersLoaded = true;
+        for (const c of await src.others(pref))
+            if (c.family !== pref)
+                consider(c);
+    };
+    // The preferred backend is first. The others are only looked up (a CLI sign-in check) when it did not answer.
+    if (!plan.length)
+        await loadOthers();
+    let last;
+    let cutShort = false;
+    try {
+        for (let i = 0; i < plan.length; i++) {
+            const { c } = plan[i];
+            try {
+                const result = await countedCall(c.family, () => call(c.backend));
+                onAnswered(pref, c.family);
+                return result;
+            }
+            catch (err) {
+                if (!(err instanceof ModelUnavailableError))
+                    throw err;
+                last = err;
+                markUnavailable(c.family, err);
+                tried.push({ family: c.family, label: FAMILY_LABEL[c.family], reason: err.reason });
+                if (opts.canRetry && !opts.canRetry()) {
+                    cutShort = true;
+                    break;
+                }
+                if (i === plan.length - 1)
+                    await loadOthers();
+            }
+            finally {
+                endProbe(c.family);
+            }
+        }
+    }
+    finally {
+        for (const a of plan)
+            endProbe(a.c.family);
+    }
+    const reason = summarize(tried, withheld, logins);
+    const first = getUnavailability(pref);
+    setUsingInstead(pref, undefined);
+    const now = availabilityNow();
+    // A call cut short after streaming text may have had a backend left to try, so it does not say "none works".
+    if (!cutShort && now - lastNoneNotice >= NONE_NOTICE_EVERY_MS) {
+        lastNoneNotice = now;
+        hooks.noneWorking({ tried, reason });
+    }
+    const problem = {
+        kind: first?.kind ?? last?.kind ?? 'quota',
+        reason,
+        detail: last?.detail ?? '',
+        ...(last?.retryAfterMs ? { retryAfterMs: last.retryAfterMs } : {}),
+    };
+    const out = new ModelUnavailableError(problem, { cause: last });
+    out.tried = tried.map((t) => ({ method: t.family, label: t.label, reason: t.reason }));
+    throw out;
+}
+function onAnswered(pref, used) {
+    lastNoneNotice = 0;
+    if (used === pref) {
+        const was = markAvailable(pref);
+        if (was)
+            hooks.recovered({ family: pref, reason: was.reason, ...(was.usingInstead ? { wasUsing: was.usingInstead } : {}) });
+        return;
+    }
+    // A fallback answered; its own earlier failure, if any, is over.
+    markAvailable(used);
+    const e = getUnavailability(pref);
+    if (!e)
+        return;
+    if (setUsingInstead(pref, used))
+        hooks.fallback({ from: pref, to: used, reason: e.reason });
+    hooks.runStep('Model fallback', `Model unavailable: ${e.reason}. Using ${FAMILY_LABEL[used]} instead.`, 'warn');
+}
+/** Wraps a model backend so every call goes through runGuarded. */
+export class GuardedLlm {
+    src;
+    constructor(src) {
+        this.src = src;
+    }
+    /** The backend the settings pick, without the guard. */
+    unwrap() {
+        return this.src.primary();
+    }
+    async analyze(req) {
+        const verdict = await runGuarded(this.src, (l) => l.analyze(req));
+        // The team notes went to these two reviews as context (KAT-383). A copy of them never reaches a comment.
+        return scrubVerdict(req, verdict);
+    }
+    score(ticket) {
+        return runGuarded(this.src, (l) => l.score(ticket));
+    }
+    review(action, watch) {
+        return runGuarded(this.src, (l) => l.review(action, watch));
+    }
+    /**
+     * Free text (generated Playwright specs, KAT-282). Always present on the guard, so callers check
+     * the chosen backend with canWriteText() in llm.ts; a backend without write() (the mock) rejects.
+     */
+    write(req) {
+        return runGuarded(this.src, (l) => (l.write ? l.write(req) : Promise.reject(new Error('this model backend writes no free text'))));
+    }
+    chat(req, onDelta, onTool) {
+        // Text already sent to the reader cannot be taken back: after the first delta a failure ends the call.
+        let streamed = false;
+        return runGuarded(this.src, (l) => l.chat(req, (t) => {
+            streamed = true;
+            onDelta(t);
+        }, onTool), { canRetry: () => !streamed });
+    }
+}
+/** Wraps a PR review backend: the reviewer and the verifier pass each go through runGuarded. */
+export class GuardedQaBackend {
+    src;
+    constructor(src) {
+        this.src = src;
+    }
+    get name() {
+        return this.src.primary().name;
+    }
+    run(ctl, call) {
+        // A failed attempt may have delivered held ranges; the next backend starts from the same place.
+        const snap = ctl.delivery?.snapshot();
+        return runGuarded(this.src, async (b) => {
+            if (snap)
+                ctl.delivery?.restore(snap);
+            return call(b);
+        });
+    }
+    qaReview(input, ctl) {
+        return this.run(ctl, (b) => b.qaReview(input, ctl));
+    }
+    qaVerify(input, claims, ctl) {
+        return this.run(ctl, (b) => b.qaVerify(input, claims, ctl));
+    }
+}
+/**
+ * Tests the preferred backend when its wait is over and no call came. Resolves true when it works
+ * again. `probe` makes one cheap call on the raw backend.
+ */
+export async function recheckPreferred(src, probe) {
+    const pref = src.preferred();
+    if (!pref || !dueForRecheck(pref) || !beginProbe(pref))
+        return false;
+    try {
+        await probe(src.primary());
+        const was = markAvailable(pref);
+        if (was)
+            hooks.recovered({ family: pref, reason: was.reason, ...(was.usingInstead ? { wasUsing: was.usingInstead } : {}) });
+        return true;
+    }
+    catch (err) {
+        if (err instanceof ModelUnavailableError)
+            markUnavailable(pref, err);
+        else
+            markAvailable(pref); // the failure says nothing about availability: calls try the backend again
+        return false;
+    }
+    finally {
+        endProbe(pref);
+    }
+}
+export const RECHECK_TICK_MS = 30_000;
+/** Timer that calls recheckPreferred. Returns the stop function. */
+export function startRecheckTimer(src, probe, everyMs = RECHECK_TICK_MS) {
+    const timer = setInterval(() => void recheckPreferred(src, probe).catch((err) => log.warn(`model: recheck failed: ${String(err)}`)), everyMs);
+    timer.unref();
+    return () => clearInterval(timer);
+}
+/** True when this backend is waiting after a failure. For tests and the model list. */
+export function isWaiting(family) {
+    return inCooldown(family);
+}
+//# sourceMappingURL=model-guard.js.map

package/dist/agent/model-guard.js.map

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