opencode-jev-model-router 0.1.0

package/dist/jev.js

@@ -0,0 +1,135 @@
+import { readFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { TypeSafeClient } from "@typesafe-ai/sdk";
+import { COMPLEXITY_MAX_SCORE, CONTEXT_WINDOW_TOKENS, QUESTIONS, } from "./config.js";
+let client;
+let cachedKey;
+/** Env vars first, then ~/.config/opencode key files (OpenCode often lacks shell exports). */
+export function resolveApiKey(env = process.env, opts = {}) {
+    const fromEnv = env.JEV_API_KEY || env.JEV_KEY || env.TYPESAFE_API_KEY;
+    if (fromEnv?.trim())
+        return fromEnv.trim();
+    if (opts.skipFiles)
+        return undefined;
+    if (cachedKey && !opts.configDir)
+        return cachedKey;
+    const configDir = opts.configDir ?? join(homedir(), ".config", "opencode");
+    const keyFile = join(configDir, "opencode-jev-router.key");
+    if (existsSync(keyFile)) {
+        try {
+            const raw = readFileSync(keyFile, "utf8").trim();
+            if (raw && !raw.includes("\n")) {
+                if (!opts.configDir)
+                    cachedKey = raw;
+                return raw;
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    const envFile = join(configDir, ".env");
+    if (existsSync(envFile)) {
+        try {
+            for (const line of readFileSync(envFile, "utf8").split("\n")) {
+                const m = /^(?:JEV_API_KEY|JEV_KEY|TYPESAFE_API_KEY)\s*=\s*(.*)$/.exec(line.trim());
+                if (!m)
+                    continue;
+                let value = m[1].trim();
+                if ((value.startsWith('"') && value.endsWith('"')) ||
+                    (value.startsWith("'") && value.endsWith("'"))) {
+                    value = value.slice(1, -1);
+                }
+                if (value) {
+                    if (!opts.configDir)
+                        cachedKey = value;
+                    return value;
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return undefined;
+}
+/** Tests only. */
+export function resetJevClient() {
+    client = undefined;
+    cachedKey = undefined;
+}
+function getClient(config, apiKey) {
+    client ??= new TypeSafeClient({
+        apiKey,
+        timeout: config.timeoutMs,
+        retry: {
+            maxRetries: config.maxRetries,
+            backoffInitialMs: 150,
+            backoffMaxMs: 400,
+        },
+        logLevel: "warn",
+    });
+    return client;
+}
+/**
+ * Ask Jev which tier fits this prompt. Returns null on any failure — never
+ * blocks the user turn.
+ */
+export async function askJev(input, deps = {}) {
+    const { prompt, current, contextTokens, available, routing } = input;
+    const started = Date.now();
+    const abort = new AbortController();
+    const deadline = setTimeout(() => abort.abort(), routing.deadlineMs);
+    const request = {
+        state: {
+            request: prompt,
+            session: { current_model: current, context_tokens: contextTokens },
+            environment: { available_models: available },
+        },
+        questions: QUESTIONS,
+    };
+    const fail = (message) => {
+        deps.onError?.(message);
+        return null;
+    };
+    try {
+        const apiKey = (deps.resolveKey ?? (() => resolveApiKey()))();
+        if (!apiKey) {
+            return fail("Jev API key missing (set JEV_KEY or ~/.config/opencode/opencode-jev-router.key)");
+        }
+        const systemOne = deps.systemOne ??
+            ((req, options) => getClient(routing, apiKey).systemOne(req, options));
+        const result = await systemOne(request, { signal: abort.signal });
+        const answers = result.answers;
+        const answer = answers.model_tier;
+        const task_complexity = answers.task_complexity;
+        const reasoning_required = answers.reasoning_required;
+        const tool_complexity = answers.tool_complexity;
+        if (!answer ||
+            typeof answer.choice !== "string" ||
+            typeof answer.confidence !== "number" ||
+            !Number.isFinite(answer.confidence)) {
+            return fail("Jev returned a malformed model_tier answer");
+        }
+        return {
+            choice: answer.choice,
+            confidence: answer.confidence,
+            metrics: {
+                taskComplexity: (task_complexity?.score ?? 0) / COMPLEXITY_MAX_SCORE,
+                reasoningRequired: (reasoning_required?.score ?? 0) / COMPLEXITY_MAX_SCORE,
+                toolComplexity: (tool_complexity?.score ?? 0) / COMPLEXITY_MAX_SCORE,
+                contextSize: Math.min(contextTokens / CONTEXT_WINDOW_TOKENS, 1),
+            },
+            ms: Date.now() - started,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return fail(`Jev call failed: ${message}`);
+    }
+    finally {
+        clearTimeout(deadline);
+    }
+}
+//# sourceMappingURL=jev.js.map

package/dist/jev.js.map

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

package/dist/models.d.ts

@@ -0,0 +1,47 @@
+import type { ModelRef, RouterConfig, Tier } from "./types.js";
+import type { QuotaStore } from "./quota.js";
+/**
+ * Parse an OpenCode model ref. Split only on the first slash so OpenRouter-style
+ * IDs like `openrouter/deepseek/deepseek-v3.2` keep the rest intact.
+ */
+export declare function parseModelRef(ref: string): ModelRef | undefined;
+export declare function formatModelRef(model: ModelRef): string;
+export type KnownModels = Set<string> | undefined;
+/** All configured model refs for a tier (primary + fallbacks). */
+export declare function tierCandidates(config: RouterConfig, tier: Tier): string[];
+/** Every model the router manages (for pin detection). */
+export declare function managedModelSet(config: RouterConfig): Set<string>;
+export declare function isManagedModel(config: RouterConfig, model: {
+    providerID: string;
+    modelID: string;
+} | undefined): boolean;
+export type SelectOptions = {
+    known?: KnownModels;
+    quota?: QuotaStore;
+    now?: number;
+    /** Wall clock for peak/off-peak reordering (defaults to new Date(now)). */
+    at?: Date;
+};
+/**
+ * Resolve a tier to the first eligible concrete model (primary then fallbacks).
+ * During DeepSeek peak hours, non-DeepSeek candidates are tried first.
+ */
+export declare function modelForTier(config: RouterConfig, tier: Tier, opts?: SelectOptions): {
+    model: ModelRef;
+    usedFallback: boolean;
+} | undefined;
+/** Infer which configured tier a model belongs to (primary preferred over fallback). */
+export declare function tierOfModel(config: RouterConfig, model: {
+    providerID: string;
+    modelID: string;
+} | undefined, fallback?: Tier): Tier;
+/** Tiers that are enabled and have a parseable primary (ignores quota). */
+export declare function configAvailableTiers(config: RouterConfig, known?: KnownModels): Tier[];
+/** Tiers that currently have at least one eligible (non-exhausted) model. */
+export declare function resolveAvailableTiers(config: RouterConfig, opts?: SelectOptions): Tier[];
+/** True when `model` is still a non-exhausted, known candidate for `tier`. */
+export declare function isEligibleCandidate(config: RouterConfig, tier: Tier, model: {
+    providerID: string;
+    modelID: string;
+}, opts?: SelectOptions): boolean;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAO/D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEtD;AAED,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;AAMlD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CASzE;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAMjE;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GACzD,OAAO,CAGT;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,EAAE,CAAC,EAAE,IAAI,CAAC;CACX,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,IAAI,EACV,IAAI,GAAE,aAAkB,GACvB;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAoBxD;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAC1D,QAAQ,GAAE,IAAiB,GAC1B,IAAI,CAkBN;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,WAAW,GAClB,IAAI,EAAE,CAYR;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,aAAkB,GACvB,IAAI,EAAE,CAIR;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC9C,IAAI,GAAE,aAAkB,GACvB,OAAO,CAMT"}

package/dist/models.js

@@ -0,0 +1,132 @@
+import { TIER_NAMES } from "./types.js";
+import { orderCandidatesForSchedule } from "./schedule.js";
+/**
+ * Parse an OpenCode model ref. Split only on the first slash so OpenRouter-style
+ * IDs like `openrouter/deepseek/deepseek-v3.2` keep the rest intact.
+ */
+export function parseModelRef(ref) {
+    const slash = ref.indexOf("/");
+    if (slash <= 0 || slash === ref.length - 1)
+        return undefined;
+    return {
+        providerID: ref.slice(0, slash),
+        modelID: ref.slice(slash + 1),
+    };
+}
+export function formatModelRef(model) {
+    return `${model.providerID}/${model.modelID}`;
+}
+function isKnown(ref, known) {
+    return !known || known.has(ref);
+}
+/** All configured model refs for a tier (primary + fallbacks). */
+export function tierCandidates(config, tier) {
+    const tierConfig = config.tiers[tier];
+    if (!tierConfig || tierConfig.enabled === false)
+        return [];
+    const out = [];
+    if (tierConfig.model)
+        out.push(tierConfig.model);
+    for (const fb of tierConfig.fallbacks ?? []) {
+        if (fb && !out.includes(fb))
+            out.push(fb);
+    }
+    return out;
+}
+/** Every model the router manages (for pin detection). */
+export function managedModelSet(config) {
+    const set = new Set();
+    for (const name of TIER_NAMES) {
+        for (const ref of tierCandidates(config, name))
+            set.add(ref);
+    }
+    return set;
+}
+export function isManagedModel(config, model) {
+    if (!model)
+        return false;
+    return managedModelSet(config).has(formatModelRef(model));
+}
+/**
+ * Resolve a tier to the first eligible concrete model (primary then fallbacks).
+ * During DeepSeek peak hours, non-DeepSeek candidates are tried first.
+ */
+export function modelForTier(config, tier, opts = {}) {
+    const tierConfig = config.tiers[tier];
+    if (!tierConfig || tierConfig.enabled === false)
+        return undefined;
+    const at = opts.at ??
+        (typeof opts.now === "number" ? new Date(opts.now) : new Date());
+    const candidates = orderCandidatesForSchedule(tierCandidates(config, tier), at);
+    const primary = tierConfig.model;
+    for (let i = 0; i < candidates.length; i += 1) {
+        const raw = candidates[i];
+        const parsed = parseModelRef(raw);
+        if (!parsed)
+            continue;
+        if (!isKnown(raw, opts.known))
+            continue;
+        if (opts.quota?.isExhausted(raw, opts.now))
+            continue;
+        const model = tierConfig.variant
+            ? { ...parsed, variant: tierConfig.variant }
+            : parsed;
+        return { model, usedFallback: raw !== primary };
+    }
+    return undefined;
+}
+/** Infer which configured tier a model belongs to (primary preferred over fallback). */
+export function tierOfModel(config, model, fallback = "balanced") {
+    if (!model)
+        return fallback;
+    const ref = formatModelRef(model);
+    for (const name of TIER_NAMES) {
+        if (config.tiers[name]?.model === ref)
+            return name;
+    }
+    for (const name of TIER_NAMES) {
+        const fallbacks = config.tiers[name]?.fallbacks ?? [];
+        if (fallbacks.includes(ref))
+            return name;
+    }
+    for (const name of TIER_NAMES) {
+        for (const candidate of tierCandidates(config, name)) {
+            const parsed = parseModelRef(candidate);
+            if (parsed && parsed.modelID === model.modelID)
+                return name;
+        }
+    }
+    return fallback;
+}
+/** Tiers that are enabled and have a parseable primary (ignores quota). */
+export function configAvailableTiers(config, known) {
+    return TIER_NAMES.filter((name) => {
+        const tier = config.tiers[name];
+        if (!tier || tier.enabled === false)
+            return false;
+        const primary = parseModelRef(tier.model);
+        if (!primary)
+            return false;
+        if (known && !known.has(tier.model)) {
+            // Primary unknown — still config-available if a fallback is known
+            return (tier.fallbacks ?? []).some((fb) => known.has(fb));
+        }
+        return true;
+    });
+}
+/** Tiers that currently have at least one eligible (non-exhausted) model. */
+export function resolveAvailableTiers(config, opts = {}) {
+    return TIER_NAMES.filter((name) => modelForTier(config, name, opts) !== undefined);
+}
+/** True when `model` is still a non-exhausted, known candidate for `tier`. */
+export function isEligibleCandidate(config, tier, model, opts = {}) {
+    const ref = formatModelRef(model);
+    if (!tierCandidates(config, tier).includes(ref))
+        return false;
+    if (!isKnown(ref, opts.known))
+        return false;
+    if (opts.quota?.isExhausted(ref, opts.now))
+        return false;
+    return true;
+}
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

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

package/dist/policy.d.ts

@@ -0,0 +1,33 @@
+import type { JevAnswer, PolicyDecision, RouterConfig, Tier } from "./types.js";
+export type OverridePattern = {
+    tier: Tier;
+    re: RegExp;
+};
+/** Build override matchers from enabled tiers' aliases. */
+export declare function buildOverridePatterns(tiers: RouterConfig["tiers"]): OverridePattern[];
+/** The tier the user named explicitly in the prompt, or null. */
+export declare function detectOverride(prompt: string | undefined | null, patterns: OverridePattern[]): Tier | null;
+/**
+ * Nearest runnable tier.
+ * - If the tier is config-available but not eligible (quota), step **down**.
+ * - If the tier is not config-available, step **up** (never into `long` unless asked).
+ */
+export declare function clampToAvailable(tier: Tier, eligible: Tier[], configAvailable: Tier[]): Tier | null;
+export type DecideInput = {
+    prompt: string;
+    jev: JevAnswer | null;
+    current: Tier;
+    /** Tiers with at least one non-exhausted model. */
+    available: Tier[];
+    /** Tiers enabled/valid ignoring quota. */
+    configAvailable: Tier[];
+    contextTokens?: number;
+    overridePatterns: OverridePattern[];
+    thresholds: Pick<RouterConfig["routing"], "minimumConfidence" | "uncertainCeiling" | "downgradeMaxContextTokens">;
+};
+/**
+ * Turns a Jev answer into the tier we will actually run. Pure and total: any
+ * missing, malformed, or unavailable input falls back to the model already in use.
+ */
+export declare function decide(input: DecideInput): PolicyDecision;
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,IAAI,EACL,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,2DAA2D;AAC3D,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAC3B,eAAe,EAAE,CAoBnB;AAMD,iEAAiE;AACjE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACjC,QAAQ,EAAE,eAAe,EAAE,GAC1B,IAAI,GAAG,IAAI,CAGb;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,IAAI,EAAE,EAChB,eAAe,EAAE,IAAI,EAAE,GACtB,IAAI,GAAG,IAAI,CAeb;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,IAAI,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,IAAI,EAAE,CAAC;IAClB,0CAA0C;IAC1C,eAAe,EAAE,IAAI,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,UAAU,EAAE,IAAI,CACd,YAAY,CAAC,SAAS,CAAC,EACvB,mBAAmB,GAAG,kBAAkB,GAAG,2BAA2B,CACvE,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAiEzD"}

package/dist/policy.js

@@ -0,0 +1,100 @@
+import { TIER_NAMES, isTier, rankOf } from "./types.js";
+/** Build override matchers from enabled tiers' aliases. */
+export function buildOverridePatterns(tiers) {
+    const patterns = [];
+    for (const name of TIER_NAMES) {
+        if (tiers[name]?.enabled === false)
+            continue;
+        const aliases = tiers[name]?.aliases ?? [name];
+        const unique = [...new Set(aliases.map((a) => a.trim()).filter(Boolean))];
+        if (!unique.length)
+            continue;
+        const alt = unique.map(escapeRegExp).join("|");
+        // "use|switch to" only — avoid "focus on long" / "with fast refresh".
+        // Require end, punctuation, or "to/for …" after the alias so
+        // "use strong typing" and "use fast-glob" do not match.
+        patterns.push({
+            tier: name,
+            re: new RegExp(`\\b(?:use|switch to)\\s+(?:${alt})(?![\\w-])(?:\\s+model)?(?:\\s+please)?(?=\\s+to\\b|\\s+for\\b|[.,;:!?]|\\s*$)`, "i"),
+        });
+    }
+    return patterns;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/** The tier the user named explicitly in the prompt, or null. */
+export function detectOverride(prompt, patterns) {
+    const hit = patterns.find((p) => p.re.test(prompt ?? ""));
+    return hit ? hit.tier : null;
+}
+/**
+ * Nearest runnable tier.
+ * - If the tier is config-available but not eligible (quota), step **down**.
+ * - If the tier is not config-available, step **up** (never into `long` unless asked).
+ */
+export function clampToAvailable(tier, eligible, configAvailable) {
+    if (eligible.includes(tier))
+        return tier;
+    const rank = rankOf(tier);
+    if (configAvailable.includes(tier)) {
+        const down = TIER_NAMES.filter((t, i) => i < rank && eligible.includes(t));
+        return down.length ? down[down.length - 1] : null;
+    }
+    const up = TIER_NAMES.filter((t, i) => i > rank && eligible.includes(t) && (t !== "long" || tier === "long"));
+    if (up.length)
+        return up[0];
+    const down = TIER_NAMES.filter((t, i) => i < rank && eligible.includes(t));
+    return down.length ? down[down.length - 1] : null;
+}
+/**
+ * Turns a Jev answer into the tier we will actually run. Pure and total: any
+ * missing, malformed, or unavailable input falls back to the model already in use.
+ */
+export function decide(input) {
+    const { prompt, jev, current, available, configAvailable, contextTokens = 0, overridePatterns, thresholds, } = input;
+    const settle = (tier, reason) => {
+        const final = clampToAvailable(tier, available, configAvailable) ?? current;
+        let why = reason;
+        if (final !== tier) {
+            why = configAvailable.includes(tier)
+                ? `${reason}+quota-down`
+                : `${reason}+unavailable`;
+        }
+        if (final === current && available.length === 0) {
+            why = "quota-exhausted/no-change";
+        }
+        else if (final === current) {
+            why = `${why}/no-change`;
+        }
+        return {
+            tier: final,
+            reason: why,
+            changed: final !== current,
+        };
+    };
+    const override = detectOverride(prompt, overridePatterns);
+    if (override)
+        return settle(override, "override");
+    if (!available.length) {
+        return { tier: current, reason: "quota-exhausted/no-change", changed: false };
+    }
+    if (!jev || !isTier(jev.choice))
+        return settle(current, "jev-unavailable");
+    let target = jev.choice;
+    if (jev.confidence < thresholds.minimumConfidence) {
+        if (rankOf(target) < rankOf(current)) {
+            return settle(current, "low-confidence-no-downgrade");
+        }
+        const ceiling = Math.max(rankOf(current), rankOf(thresholds.uncertainCeiling));
+        if (rankOf(target) > ceiling) {
+            return settle(TIER_NAMES[ceiling], "low-confidence-capped");
+        }
+    }
+    if (rankOf(target) < rankOf(current) &&
+        contextTokens > thresholds.downgradeMaxContextTokens) {
+        return settle(current, "downgrade-not-worth-cache-rebuild");
+    }
+    return settle(target, "jev");
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

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

package/dist/prompt.d.ts

@@ -0,0 +1,12 @@
+export type TextPartLike = {
+    type?: string;
+    text?: string;
+    synthetic?: boolean;
+    ignored?: boolean;
+};
+/**
+ * Extract bounded non-synthetic user text for routing.
+ * Returns empty string when there is nothing usable or the payload is too large.
+ */
+export declare function extractPromptText(parts: TextPartLike[] | undefined, maxBytes: number): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EAAE,GAAG,SAAS,EACjC,QAAQ,EAAE,MAAM,GACf,MAAM,CA6BR"}

package/dist/prompt.js

@@ -0,0 +1,32 @@
+/**
+ * Extract bounded non-synthetic user text for routing.
+ * Returns empty string when there is nothing usable or the payload is too large.
+ */
+export function extractPromptText(parts, maxBytes) {
+    const text = (parts || [])
+        .filter((part) => part &&
+        part.type === "text" &&
+        part.synthetic !== true &&
+        part.ignored !== true &&
+        typeof part.text === "string")
+        .map((part) => (part.text ?? "").trim())
+        .filter(Boolean)
+        .join("\n");
+    if (!text)
+        return "";
+    const bytes = new TextEncoder().encode(text);
+    if (bytes.byteLength <= maxBytes)
+        return text;
+    // Cut on a UTF-8 code-point boundary (never emit U+FFFD).
+    let end = Math.min(maxBytes, bytes.byteLength);
+    while (end > 0 && (bytes[end - 1] & 0xc0) === 0x80)
+        end -= 1;
+    if (end > 0) {
+        const lead = bytes[end - 1];
+        const need = lead >= 0xf0 ? 4 : lead >= 0xe0 ? 3 : lead >= 0xc0 ? 2 : 1;
+        if (need > 1 && end - 1 + need > maxBytes)
+            end -= 1;
+    }
+    return new TextDecoder().decode(bytes.slice(0, end));
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAiC,EACjC,QAAgB;IAEhB,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;SACvB,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,IAAI;QACJ,IAAI,CAAC,IAAI,KAAK,MAAM;QACpB,IAAI,CAAC,SAAS,KAAK,IAAI;QACvB,IAAI,CAAC,OAAO,KAAK,IAAI;QACrB,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAChC;SACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SACvC,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,UAAU,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE9C,0DAA0D;IAC1D,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAE,GAAG,IAAI,CAAC,KAAK,IAAI;QAAE,GAAG,IAAI,CAAC,CAAC;IAC9D,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAE,CAAC;QAC7B,MAAM,IAAI,GACR,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,IAAI,IAAI,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,QAAQ;YAAE,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/quota.d.ts

@@ -0,0 +1,31 @@
+export type ExhaustionEntry = {
+    exhaustedUntil: number;
+    reason: string;
+    markedAt: number;
+};
+export type QuotaState = {
+    [modelRef: string]: ExhaustionEntry;
+};
+/** Allowance / subscription exhaustion — not context-length or bare 429 rate limits. */
+export declare function isQuotaError(err: unknown): boolean;
+export declare function defaultStateDir(): string;
+export declare class QuotaStore {
+    private state;
+    private readonly path;
+    private readonly errorsPath;
+    private readonly now;
+    constructor(opts?: {
+        dir?: string;
+        now?: () => number;
+    });
+    private load;
+    private persist;
+    isExhausted(ref: string, now?: number): boolean;
+    mark(ref: string, untilMs: number, reason: string, now?: number): void;
+    clear(ref?: string): void;
+    list(now?: number): Array<{
+        ref: string;
+    } & ExhaustionEntry>;
+    appendError(record: Record<string, unknown>): void;
+}
+//# sourceMappingURL=quota.d.ts.map

package/dist/quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../src/quota.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAC;CACrC,CAAC;AAIF,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAalD;AAgBD,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAE;IAQvD,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,OAAO;IAgBf,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,OAAO;IAWnD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,IAAI;IAU1E,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IASzB,IAAI,CAAC,GAAG,SAAa,GAAG,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,CAAC;IAWhE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAuBnD"}