audit-tools 0.28.0

package/dist/shared/quota/scheduler.js

@@ -0,0 +1,313 @@
+import { z } from "zod";
+import { DispatchModelTierSchema } from "../types/stepContract.js";
+import { agentHostFallbackConcurrency, classifyProvider, resolveLimits, } from "./limits.js";
+import { computeMaxSafeConcurrency, computeRampUpConcurrency } from "./state.js";
+/**
+ * One entry of the host's model roster, reported at the dispatch handshake
+ * (lowest rank first). `rank` is a RELATIVE capability label that reuses the
+ * `DispatchModelTier` vocabulary so it lines up with each packet's
+ * `model_hint.tier`; the windows are discovered, never assumed. The host still
+ * never names a model to the backend (no-hardcoded-models invariant).
+ */
+export const HostModelRosterEntrySchema = z
+    .object({
+    rank: DispatchModelTierSchema,
+    /** Context window (input tokens) of the model serving this rank. */
+    context_tokens: z.number().int().min(1),
+    /** Output-token cap of the model serving this rank. */
+    output_tokens: z.number().int().min(1),
+    /**
+     * Optional OPAQUE identity for the model serving this rank, used ONLY as a
+     * quota-key segment (`provider/<model_id>`) so quota learning stays
+     * per-model. Never a window authority and never compared against a name
+     * table — the no-hardcoded-models invariant holds.
+     */
+    model_id: z.string().optional(),
+})
+    .strict();
+const HOST_MODEL_RANKS = new Set(["small", "standard", "deep"]);
+/**
+ * Parse and validate a `--host-models` handshake value (JSON array, lowest
+ * rank first) into a roster. Single-sourced here so both orchestrators accept
+ * the identical contract. Malformed input throws so a mistyped handshake fails
+ * loudly instead of silently downgrading to the conservative floor.
+ */
+export function parseHostModelRoster(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`--host-models must be valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!Array.isArray(parsed) || parsed.length === 0) {
+        throw new Error("--host-models must be a non-empty JSON array of {rank, context_tokens, output_tokens} entries.");
+    }
+    return parsed.map((entry, index) => {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            throw new Error(`--host-models[${index}] must be a JSON object.`);
+        }
+        const { rank, context_tokens, output_tokens } = entry;
+        if (typeof rank !== "string" || !HOST_MODEL_RANKS.has(rank)) {
+            throw new Error(`--host-models[${index}].rank must be one of: small, standard, deep.`);
+        }
+        if (!Number.isInteger(context_tokens) || context_tokens <= 0) {
+            throw new Error(`--host-models[${index}].context_tokens must be a positive integer.`);
+        }
+        if (!Number.isInteger(output_tokens) || output_tokens <= 0) {
+            throw new Error(`--host-models[${index}].output_tokens must be a positive integer.`);
+        }
+        const { model_id } = entry;
+        if (model_id !== undefined &&
+            (typeof model_id !== "string" || model_id.trim().length === 0)) {
+            throw new Error(`--host-models[${index}].model_id must be a non-empty string when provided.`);
+        }
+        return {
+            rank: rank,
+            context_tokens: context_tokens,
+            output_tokens: output_tokens,
+            ...(model_id !== undefined ? { model_id: model_id } : {}),
+        };
+    });
+}
+// Named quota tuning defaults (previously inline magic literals). Centralised
+// here, the canonical owner of the wave-scheduling math, so callers that read
+// the same session-config defaults (e.g. the dispatch CLIs) can reference them
+// instead of re-typing the number.
+/** Fraction of a discovered RPM/TPM limit we actually schedule against. */
+export const DEFAULT_SAFETY_MARGIN = 0.8;
+/** Half-life (hours) for decaying learned concurrency evidence. */
+export const DEFAULT_EMPIRICAL_HALF_LIFE_HOURS = 24;
+/** Conservative ceiling applied on first contact with an unconfigured provider. */
+export const DEFAULT_FIRST_CONTACT_CONCURRENCY = 3;
+/**
+ * Real-time quota-source `remaining_pct` thresholds. At/under CRITICAL we throttle
+ * to a single request; at/under LOW we halve the wave.
+ */
+export const QUOTA_REMAINING_PCT_CRITICAL = 0.1;
+export const QUOTA_REMAINING_PCT_LOW = 0.3;
+/** Multiplier applied to the wave when remaining quota is in the LOW band. */
+const QUOTA_LOW_WAVE_MULTIPLIER = 0.5;
+/**
+ * Apply a real-time quota-source snapshot to the current wave size. The snapshot
+ * is the strongest live signal: when quota is near-exhausted we throttle to 1 and
+ * record the reset time as a cooldown; when it is low (but not critical) we halve
+ * the wave.
+ *
+ * Returns the adjusted wave size, binding cap, and cooldown timestamp. When no
+ * adjustment is needed the inputs are returned unchanged.
+ */
+function applyQuotaSourceAdjustment(waveSize, bindingCap, cooldownUntil, quotaSourceSnapshot) {
+    if (quotaSourceSnapshot.remaining_pct != null &&
+        quotaSourceSnapshot.remaining_pct < QUOTA_REMAINING_PCT_CRITICAL) {
+        return {
+            waveSize: 1,
+            bindingCap: waveSize > 1 ? "cooldown" : bindingCap,
+            cooldownUntil: quotaSourceSnapshot.reset_at ?? cooldownUntil,
+        };
+    }
+    if (quotaSourceSnapshot.remaining_pct != null &&
+        quotaSourceSnapshot.remaining_pct < QUOTA_REMAINING_PCT_LOW) {
+        const reduced = Math.max(1, Math.floor(waveSize * QUOTA_LOW_WAVE_MULTIPLIER));
+        if (reduced < waveSize) {
+            return { waveSize: reduced, bindingCap: "cooldown", cooldownUntil };
+        }
+    }
+    return { waveSize, bindingCap, cooldownUntil };
+}
+function sumTopN(sorted, n) {
+    let sum = 0;
+    for (let i = 0; i < Math.min(n, sorted.length); i++)
+        sum += sorted[i];
+    return sum;
+}
+function computeUncappedWaveSize(input) {
+    const { waveSize: initialSize, limits, safetyMargin, avgTokens, slotsSorted, quotaStateEntry, hostConcurrencyLimit, providerName, quota, halfLifeHours, } = input;
+    let current = initialSize;
+    let bindingCap = "none";
+    // Cap by requests-per-minute
+    if (limits.requests_per_minute != null) {
+        const rpmCap = Math.max(1, Math.floor(limits.requests_per_minute * safetyMargin));
+        if (rpmCap < current) {
+            current = rpmCap;
+            bindingCap = "rpm";
+        }
+    }
+    // Cap by input tokens-per-minute
+    if (limits.input_tokens_per_minute != null && avgTokens > 0) {
+        const tpmBudget = limits.input_tokens_per_minute * safetyMargin;
+        if (slotsSorted && slotsSorted.length > 0) {
+            let candidateSize = current;
+            while (candidateSize > 1 && sumTopN(slotsSorted, candidateSize) > tpmBudget) {
+                candidateSize--;
+            }
+            const capped = Math.max(1, candidateSize);
+            if (capped < current) {
+                current = capped;
+                bindingCap = "tpm";
+            }
+        }
+        else {
+            const tpmCap = Math.max(1, Math.floor(tpmBudget / avgTokens));
+            if (tpmCap < current) {
+                current = tpmCap;
+                bindingCap = "tpm";
+            }
+        }
+    }
+    if (quotaStateEntry) {
+        const rampUp = quota.ramp_up_enabled !== false;
+        const cap = rampUp
+            ? computeRampUpConcurrency(quotaStateEntry, halfLifeHours)
+            : computeMaxSafeConcurrency(quotaStateEntry, halfLifeHours);
+        if (cap < current) {
+            current = cap;
+            bindingCap = "learned";
+        }
+        return { size: current, binding_cap: bindingCap };
+    }
+    else if (hostConcurrencyLimit !== null) {
+        // The host explicitly reported its active-subagent capacity. That is a real
+        // concurrency signal, so it supersedes the conservative unknown-provider
+        // fallback. The reported limit is enforced as the hard ceiling by
+        // applyHostConcurrencyLimit() at the call site, so nothing is capped here.
+        return { size: current, binding_cap: bindingCap };
+    }
+    else {
+        const providerType = classifyProvider(providerName);
+        const fallbackCap = providerType === "local"
+            ? quota.unknown_local_concurrency
+            : (quota.unknown_hosted_concurrency ??
+                agentHostFallbackConcurrency(providerName));
+        if (fallbackCap === "unlimited") {
+            // no cap — "unlimited" intentionally skips clamping
+        }
+        else if (typeof fallbackCap === "number" && Number.isFinite(fallbackCap)) {
+            const cap = Math.max(1, Math.floor(fallbackCap));
+            if (cap < current) {
+                current = cap;
+                bindingCap = "fallback";
+            }
+        }
+        // First-contact cap: when no learned history, no configured fallback, AND
+        // no RPM/TPM limits from any source, apply a conservative ceiling.
+        // This triggers only for unconfigured local providers (fallbackCap is
+        // undefined). Hosted providers default to 1 via unknown_hosted_concurrency,
+        // and "unlimited" is an explicit opt-out.
+        if (fallbackCap == null &&
+            limits.requests_per_minute == null &&
+            limits.input_tokens_per_minute == null) {
+            const firstContactCap = Math.max(1, quota.first_contact_concurrency ?? DEFAULT_FIRST_CONTACT_CONCURRENCY);
+            if (firstContactCap < current) {
+                current = firstContactCap;
+                bindingCap = "first_contact";
+            }
+        }
+        return { size: current, binding_cap: bindingCap };
+    }
+}
+export function scheduleWave(options) {
+    const { providerName, sessionConfig, hostModel, requestedConcurrency, estimatedSlotTokens, quotaStateEntry = null, hostConcurrencyLimit = null, quotaSourceSnapshot = null, discoveredLimits = null, } = options;
+    // Descending sort so sumTopN picks the largest slots
+    const slotsSorted = estimatedSlotTokens
+        ? [...estimatedSlotTokens].sort((a, b) => b - a)
+        : null;
+    const avgTokens = slotsSorted && slotsSorted.length > 0
+        ? Math.floor(slotsSorted.reduce((a, b) => a + b, 0) / slotsSorted.length)
+        : 0;
+    const quota = sessionConfig.quota ?? {};
+    const applyHostConcurrencyLimit = (waveSize) => {
+        if (hostConcurrencyLimit === null)
+            return waveSize;
+        return Math.min(waveSize, hostConcurrencyLimit.active_subagents);
+    };
+    if (quota.enabled === false) {
+        const waveSize = Math.max(1, applyHostConcurrencyLimit(requestedConcurrency));
+        const limits = {
+            context_tokens: quota.default_context_tokens ?? 32_000,
+            output_tokens: quota.reserved_output_tokens ?? 4_096,
+            requests_per_minute: null,
+            input_tokens_per_minute: null,
+            output_tokens_per_minute: null,
+        };
+        return {
+            max_concurrent: waveSize,
+            estimated_wave_tokens: slotsSorted ? sumTopN(slotsSorted, waveSize) : waveSize * avgTokens,
+            cooldown_until: null,
+            confidence: "high",
+            source: "default",
+            resolved_limits: limits,
+            host_concurrency_limit: hostConcurrencyLimit,
+            model: hostModel,
+            binding_cap: waveSize < requestedConcurrency ? "host_concurrency" : "none",
+        };
+    }
+    const safetyMargin = quota.safety_margin ?? DEFAULT_SAFETY_MARGIN;
+    const halfLifeHours = quota.empirical_half_life_hours ?? DEFAULT_EMPIRICAL_HALF_LIFE_HOURS;
+    const { limits, source, confidence } = resolveLimits({ providerName, sessionConfig, hostModel, discoveredLimits });
+    // Fill null RPM/TPM from discovered limits (provider query or header extraction)
+    if (discoveredLimits) {
+        limits.requests_per_minute ??= discoveredLimits.requests_per_minute ?? null;
+        limits.input_tokens_per_minute ??= discoveredLimits.input_tokens_per_minute ?? null;
+        limits.output_tokens_per_minute ??= discoveredLimits.output_tokens_per_minute ?? null;
+    }
+    let cooldownUntil = null;
+    // Respect an active cooldown period
+    if (quotaStateEntry?.cooldown_until) {
+        const cooldownExpiry = new Date(quotaStateEntry.cooldown_until).getTime();
+        if (cooldownExpiry > Date.now()) {
+            cooldownUntil = quotaStateEntry.cooldown_until;
+        }
+    }
+    // During an active cooldown we throttle to a single request and skip all cap
+    // logic; otherwise apply RPM/TPM and learned/fallback caps. The host-concurrency
+    // ceiling is enforced uniformly below by applyHostConcurrencyLimit().
+    let waveSize = requestedConcurrency;
+    let bindingCap = "none";
+    if (cooldownUntil) {
+        waveSize = 1;
+        bindingCap = "cooldown";
+    }
+    else {
+        const uncapped = computeUncappedWaveSize({
+            waveSize,
+            limits,
+            safetyMargin,
+            avgTokens,
+            slotsSorted,
+            quotaStateEntry,
+            hostConcurrencyLimit,
+            providerName,
+            quota,
+            halfLifeHours,
+        });
+        waveSize = uncapped.size;
+        bindingCap = uncapped.binding_cap;
+    }
+    // Apply real-time quota source data if available (strongest live signal).
+    if (quotaSourceSnapshot && !cooldownUntil) {
+        ({ waveSize, bindingCap, cooldownUntil } = applyQuotaSourceAdjustment(waveSize, bindingCap, cooldownUntil, quotaSourceSnapshot));
+    }
+    const beforeHostCap = waveSize;
+    waveSize = applyHostConcurrencyLimit(waveSize);
+    if (waveSize < beforeHostCap)
+        bindingCap = "host_concurrency";
+    waveSize = Math.max(1, waveSize);
+    return {
+        max_concurrent: waveSize,
+        estimated_wave_tokens: slotsSorted ? sumTopN(slotsSorted, waveSize) : waveSize * avgTokens,
+        cooldown_until: cooldownUntil,
+        confidence,
+        source,
+        resolved_limits: limits,
+        host_concurrency_limit: hostConcurrencyLimit,
+        model: hostModel,
+        quota_source_snapshot: quotaSourceSnapshot,
+        binding_cap: bindingCap,
+    };
+}
+/** Build the state key used for indexing quota-state.json entries. */
+export function buildProviderModelKey(providerName, hostModel) {
+    return hostModel ? `${providerName}/${hostModel}` : `${providerName}/*`;
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/shared/quota/scheduler.js.map

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

package/dist/shared/quota/slidingWindow.d.ts

@@ -0,0 +1,5 @@
+export interface SlidingWindowResult<T> {
+    results: PromiseSettledResult<T>[];
+}
+export declare function runSlidingWindow<T>(tasks: Array<() => Promise<T>>, concurrency: number, onComplete?: (index: number, result: PromiseSettledResult<T>) => void): Promise<SlidingWindowResult<T>>;
+//# sourceMappingURL=slidingWindow.d.ts.map

package/dist/shared/quota/slidingWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slidingWindow.d.ts","sourceRoot":"","sources":["../../../src/shared/quota/slidingWindow.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;CACpC;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,IAAI,GACpE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CA8BjC"}

package/dist/shared/quota/slidingWindow.js

@@ -0,0 +1,29 @@
+export async function runSlidingWindow(tasks, concurrency, onComplete) {
+    const results = new Array(tasks.length);
+    let nextIndex = 0;
+    async function runOne(index) {
+        let result;
+        try {
+            const value = await tasks[index]();
+            result = { status: "fulfilled", value };
+        }
+        catch (reason) {
+            result = { status: "rejected", reason };
+        }
+        results[index] = result;
+        onComplete?.(index, result);
+        if (nextIndex < tasks.length) {
+            const next = nextIndex++;
+            await runOne(next);
+        }
+    }
+    const initialBatch = Math.min(concurrency, tasks.length);
+    const runners = [];
+    for (let i = 0; i < initialBatch; i++) {
+        const idx = nextIndex++;
+        runners.push(runOne(idx));
+    }
+    await Promise.all(runners);
+    return { results };
+}
+//# sourceMappingURL=slidingWindow.js.map

package/dist/shared/quota/slidingWindow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slidingWindow.js","sourceRoot":"","sources":["../../../src/shared/quota/slidingWindow.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA8B,EAC9B,WAAmB,EACnB,UAAqE;IAErE,MAAM,OAAO,GAA8B,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnE,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,UAAU,MAAM,CAAC,KAAa;QACjC,IAAI,MAA+B,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,MAAM,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,MAAM,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;QACxB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAE5B,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC;YACzB,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/shared/quota/state.d.ts

@@ -0,0 +1,27 @@
+import type { ObservedWaveOutcome, QuotaState, QuotaStateEntry } from "./types.js";
+export declare const MAX_BUCKET_LEVEL = 32;
+export declare function setQuotaStateDir(dir: string): void;
+export declare function getQuotaStatePath(): string;
+export declare function decayWeight(weight: number, elapsedHours: number, halfLifeHours: number): number;
+export declare function applyDecayToEntry(entry: QuotaStateEntry, halfLifeHours: number): QuotaStateEntry;
+export declare function readQuotaState(): Promise<QuotaState>;
+export declare function writeQuotaState(state: QuotaState): Promise<void>;
+export declare function computeMaxSafeConcurrency(entry: QuotaStateEntry, halfLifeHours: number, maxToCheck?: number): number;
+export declare function computeRampUpConcurrency(entry: QuotaStateEntry, halfLifeHours: number, maxToCheck?: number): number;
+export declare const BASE_COOLDOWN_MS = 60000;
+export declare const MAX_COOLDOWN_MS: number;
+export declare function computeBackoffCooldownMs(consecutive429Count: number): number;
+export declare function computeBackoffFailureWeight(consecutive429Count: number): number;
+export declare function recordWaveOutcome(providerModelKey: string, outcome: ObservedWaveOutcome, halfLifeHours: number): Promise<void>;
+/**
+ * Targeted recovery: zero out the failure_weight on a single concurrency bucket
+ * for a given provider-model key. Use this when a sparse or stale failure entry
+ * at level `concurrency` is permanently capping the inferred safe concurrency —
+ * the scan in computeMaxSafeConcurrency breaks at the first bucket whose
+ * failure_weight dominates, so clearing one bad entry unblocks all higher levels.
+ *
+ * This is faster than waiting for the 24-hour decay half-life to clear bad entries.
+ * success_weight is preserved; only the failure evidence is removed.
+ */
+export declare function clearBucketFailureEvidence(providerModelKey: string, concurrency: number): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

package/dist/shared/quota/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/shared/quota/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,mBAAmB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAWtG,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAKnC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,MAAM,CAGR;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,MAAM,GACpB,eAAe,CAWjB;AASD,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CA2B1D;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,MAAM,EACrB,UAAU,SAAmB,GAC5B,MAAM,CAgBR;AAID,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,MAAM,EACrB,UAAU,SAAmB,GAC5B,MAAM,CAYR;AAMD,eAAO,MAAM,gBAAgB,QAAS,CAAC;AACvC,eAAO,MAAM,eAAe,QAAc,CAAC;AAE3C,wBAAgB,wBAAwB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED,wBAAgB,2BAA2B,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAsB,iBAAiB,CACrC,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/shared/quota/state.js

@@ -0,0 +1,204 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { withFileLock } from "./fileLock.js";
+const MIN_EVIDENCE_WEIGHT = 0.5;
+// A failure at concurrency N is evidence against N and the few levels above it
+// (a failure at 5 makes 6, 7, 8, 9 suspect too), so failure weight spreads over
+// this many buckets past the observed concurrency.
+const FAILURE_SPREAD_BUCKETS = 4;
+// computeMaxSafeConcurrency (and computeRampUpConcurrency) scans up to this many
+// levels. Bucket writes are capped at this ceiling so quota-state.json does not
+// grow indefinitely with entries that will never be read back.
+export const MAX_BUCKET_LEVEL = 32;
+let _stateDir;
+let _statePath;
+export function setQuotaStateDir(dir) {
+    _stateDir = dir;
+    _statePath = join(dir, "quota-state.json");
+}
+export function getQuotaStatePath() {
+    if (!_statePath)
+        throw new Error("Quota state dir not set — call setQuotaStateDir() first.");
+    return _statePath;
+}
+export function decayWeight(weight, elapsedHours, halfLifeHours) {
+    if (halfLifeHours <= 0 || weight <= 0)
+        return 0;
+    return weight * Math.pow(0.5, elapsedHours / halfLifeHours);
+}
+export function applyDecayToEntry(entry, halfLifeHours) {
+    const elapsedHours = (Date.now() - new Date(entry.updated_at).getTime()) / (1000 * 60 * 60);
+    if (elapsedHours < 0.001)
+        return entry;
+    const decayed = {};
+    for (const [key, bucket] of Object.entries(entry.buckets)) {
+        decayed[key] = {
+            success_weight: decayWeight(bucket.success_weight, elapsedHours, halfLifeHours),
+            failure_weight: decayWeight(bucket.failure_weight, elapsedHours, halfLifeHours),
+        };
+    }
+    return { ...entry, buckets: decayed };
+}
+function isQuotaState(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const obj = value;
+    const version = obj["version"];
+    return (version === 1 || version === 2) && typeof obj["entries"] === "object";
+}
+export async function readQuotaState() {
+    const statePath = getQuotaStatePath();
+    try {
+        const raw = await readFile(statePath, "utf8");
+        const parsed = JSON.parse(raw);
+        if (isQuotaState(parsed)) {
+            if (parsed.version === 1) {
+                for (const entry of Object.values(parsed.entries)) {
+                    entry.consecutive_429_count ??= 0;
+                }
+            }
+            return parsed;
+        }
+        process.stderr.write(`[quota] ignoring invalid quota state at ${statePath}: expected { version: 1|2, entries: object }\n`);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { version: 2, entries: {} };
+        }
+        process.stderr.write(`[quota] ignoring unreadable quota state at ${statePath}: ${error instanceof Error ? error.message : String(error)}\n`);
+    }
+    return { version: 2, entries: {} };
+}
+export async function writeQuotaState(state) {
+    const stateDir = _stateDir;
+    if (!stateDir)
+        throw new Error("Quota state dir not set — call setQuotaStateDir() first.");
+    await mkdir(stateDir, { recursive: true });
+    const normalized = { ...state, version: 2 };
+    await writeFile(getQuotaStatePath(), JSON.stringify(normalized, null, 2) + "\n", "utf8");
+}
+export function computeMaxSafeConcurrency(entry, halfLifeHours, maxToCheck = MAX_BUCKET_LEVEL) {
+    const decayed = applyDecayToEntry(entry, halfLifeHours);
+    let maxSafe = 1;
+    for (let n = 1; n <= maxToCheck; n++) {
+        const bucket = decayed.buckets[String(n)];
+        if (!bucket)
+            break;
+        if (bucket.success_weight >= MIN_EVIDENCE_WEIGHT &&
+            bucket.failure_weight < MIN_EVIDENCE_WEIGHT) {
+            maxSafe = n;
+        }
+        else {
+            break;
+        }
+    }
+    return maxSafe;
+}
+const RAMP_UP_MIN_SUCCESSES = 2;
+export function computeRampUpConcurrency(entry, halfLifeHours, maxToCheck = MAX_BUCKET_LEVEL) {
+    const maxSafe = computeMaxSafeConcurrency(entry, halfLifeHours, maxToCheck);
+    const decayed = applyDecayToEntry(entry, halfLifeHours);
+    const bucket = decayed.buckets[String(maxSafe)];
+    if (bucket &&
+        bucket.success_weight >= RAMP_UP_MIN_SUCCESSES &&
+        bucket.failure_weight < MIN_EVIDENCE_WEIGHT) {
+        return maxSafe + 1;
+    }
+    return maxSafe;
+}
+function blankEntry() {
+    return { updated_at: new Date().toISOString(), buckets: {}, cooldown_until: null, last_429_at: null };
+}
+export const BASE_COOLDOWN_MS = 60_000;
+export const MAX_COOLDOWN_MS = 15 * 60_000;
+export function computeBackoffCooldownMs(consecutive429Count) {
+    const ms = BASE_COOLDOWN_MS * Math.pow(2, Math.max(0, consecutive429Count - 1));
+    return Math.min(ms, MAX_COOLDOWN_MS);
+}
+export function computeBackoffFailureWeight(consecutive429Count) {
+    return 1.0 + 0.5 * Math.max(0, consecutive429Count - 1);
+}
+export async function recordWaveOutcome(providerModelKey, outcome, halfLifeHours) {
+    const lockPath = getQuotaStatePath() + ".lock";
+    await withFileLock(lockPath, () => recordWaveOutcomeUnsafe(providerModelKey, outcome, halfLifeHours));
+}
+/**
+ * Targeted recovery: zero out the failure_weight on a single concurrency bucket
+ * for a given provider-model key. Use this when a sparse or stale failure entry
+ * at level `concurrency` is permanently capping the inferred safe concurrency —
+ * the scan in computeMaxSafeConcurrency breaks at the first bucket whose
+ * failure_weight dominates, so clearing one bad entry unblocks all higher levels.
+ *
+ * This is faster than waiting for the 24-hour decay half-life to clear bad entries.
+ * success_weight is preserved; only the failure evidence is removed.
+ */
+export async function clearBucketFailureEvidence(providerModelKey, concurrency) {
+    const lockPath = getQuotaStatePath() + ".lock";
+    await withFileLock(lockPath, async () => {
+        const state = await readQuotaState();
+        const entry = state.entries[providerModelKey];
+        if (!entry)
+            return;
+        const bucket = entry.buckets[String(concurrency)];
+        if (!bucket)
+            return;
+        bucket.failure_weight = 0;
+        entry.updated_at = new Date().toISOString();
+        state.entries[providerModelKey] = entry;
+        await writeQuotaState(state);
+    });
+}
+async function recordWaveOutcomeUnsafe(providerModelKey, outcome, halfLifeHours) {
+    const state = await readQuotaState();
+    const entry = applyDecayToEntry(state.entries[providerModelKey] ?? blankEntry(), halfLifeHours);
+    if (outcome.outcome === "success") {
+        entry.consecutive_429_count = 0;
+        entry.cooldown_until = null;
+        // Cap at MAX_BUCKET_LEVEL: levels above this are never read back by
+        // computeMaxSafeConcurrency, so writing them would grow the state file
+        // indefinitely without ever influencing scheduling decisions.
+        const successCeiling = Math.min(outcome.concurrency, MAX_BUCKET_LEVEL);
+        for (let n = 1; n <= successCeiling; n++) {
+            const bucket = entry.buckets[String(n)] ?? { success_weight: 0, failure_weight: 0 };
+            bucket.success_weight += 1.0;
+            entry.buckets[String(n)] = bucket;
+        }
+    }
+    else {
+        const prev429Count = entry.consecutive_429_count ?? 0;
+        const new429Count = outcome.outcome === "rate_limited" ? prev429Count + 1 : prev429Count;
+        entry.consecutive_429_count = new429Count;
+        // last_429_at records a rate-limit/quota signal only. A 'timeout' or generic
+        // 'error' outcome is explicitly distinguished from 'rate_limited' by the
+        // ObservedWaveOutcome contract and must NOT stamp a 429 timestamp, or the
+        // field's meaning (and any consumer keying off it) is corrupted.
+        if (outcome.outcome === "rate_limited") {
+            entry.last_429_at = new Date().toISOString();
+        }
+        if (outcome.outcome === "rate_limited" && new429Count > 0) {
+            const backoffMs = computeBackoffCooldownMs(new429Count);
+            entry.cooldown_until = new Date(Date.now() + backoffMs).toISOString();
+        }
+        else if (outcome.cooldown_until) {
+            entry.cooldown_until = outcome.cooldown_until;
+        }
+        const failureWeight = outcome.outcome === "rate_limited"
+            ? computeBackoffFailureWeight(new429Count)
+            : 1.0;
+        // Spread failure evidence from outcome.concurrency through
+        // outcome.concurrency + FAILURE_SPREAD_BUCKETS, but cap at
+        // MAX_BUCKET_LEVEL + FAILURE_SPREAD_BUCKETS — beyond this ceiling the
+        // scan loop in computeMaxSafeConcurrency will never reach, so additional
+        // entries only bloat the file.
+        const failureCeiling = Math.min(outcome.concurrency + FAILURE_SPREAD_BUCKETS, MAX_BUCKET_LEVEL + FAILURE_SPREAD_BUCKETS);
+        for (let n = outcome.concurrency; n <= failureCeiling; n++) {
+            const bucket = entry.buckets[String(n)] ?? { success_weight: 0, failure_weight: 0 };
+            bucket.failure_weight += failureWeight;
+            entry.buckets[String(n)] = bucket;
+        }
+    }
+    entry.updated_at = new Date().toISOString();
+    state.entries[providerModelKey] = entry;
+    await writeQuotaState(state);
+}
+//# sourceMappingURL=state.js.map

package/dist/shared/quota/state.js.map

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