@danypops/jittor 0.1.1 → 0.1.2

package/README.md

@@ -35,11 +35,11 @@ Operations currently include `metrics.record`, `metrics.query`, `metrics.prune`,
 
 Provider adapters currently include official OpenRouter key/usage/model telemetry and an explicitly experimental Codex subscription adapter. The Codex adapter follows the pinned open-source CLI `/wham/usage` payload and `x-codex-*` response-header contracts, accepts additional metered limits, and fails closed on malformed windows or impossible percentages. File credentials must be explicitly configured and private (`0600`); Jittor reads only the access token and account ID, never refreshes credentials, and never logs or persists OAuth secrets.
 
-The native Pi extension preflights input and every provider turn, applies model/thinking decisions, records response headers and finalized usage through the daemon, and blocks requests when required telemetry is unsafe. It follows Pi's current authenticated model/provider and synchronizes Pi's available models before every decision, so unavailable catalog routes are never selected. Its responsive Alef-style footer groups repository and AI identity with cumulative usage, a color-coded context-window bar, and current-provider budget telemetry. Codex shows a bounded quota bar for its longest percentage window; OpenRouter remains honest about its unbounded raw spend and does not fabricate a denominator. Unknown and stale telemetry are marked explicitly. Run `/jittor` for detailed burn pressure, freshness, route state, and confirmed emergency-halt/override controls.
+The native Pi extension preflights input and every provider turn, applies model/thinking decisions, records response headers and finalized usage through the daemon, and blocks requests when required telemetry is unsafe. It follows Pi's current authenticated model/provider and synchronizes Pi's available models before every decision, so unavailable catalog routes are never selected. Its responsive integrated footer groups repository and model identity with cumulative usage, a color-coded context-window bar, and current-provider budget telemetry. Codex shows the active model's bounded quota as a draining remaining-budget bar with reset and freshness information. OpenRouter uses the same drain semantics when its official key telemetry exposes a configured limit and remaining balance; keys without a limit remain honest text-only spend and never receive a fabricated denominator. During Pi compaction, the context bar drains as an animation and reports elapsed time. Unknown and stale telemetry are marked explicitly. Run `/jittor` for detailed burn pressure, freshness, route state, and confirmed emergency-halt/override controls.
 
-Blocking always has a daemon-independent escape hatch. `/jittor off` (or `/jittor-off`) immediately enters persisted monitor-only mode and never blocks provider requests. The informational footer is independently controlled with `/jittor footer on` and `/jittor footer off`, so showing status never enables enforcement. `/jittor on` only enables enforcement after telemetry polling and available-route synchronization succeed. Every fail-closed error includes these recovery commands plus the daemon restart command.
+Blocking always has a daemon-independent escape hatch. `/jittor off` immediately enters persisted monitor-only mode and never blocks provider requests. The informational footer is independently controlled with `/jittor footer on` and `/jittor footer off`, so showing status never enables enforcement. `/jittor on` only enables enforcement after telemetry polling and available-route synchronization succeed. Every fail-closed error includes these recovery commands plus the daemon restart command.
 
-Run `/usage` for a colored Unicode token histogram with X/Y axes, provider/model series, input/output/cache totals, refresh, and `24h`, `7d`, `30d`, or `90d` ranges. Left/Right changes range and `r` refreshes. Usage is persisted by the daemon from finalized Pi assistant messages.
+Run `/jittor usage` for a colored Unicode token histogram with X/Y axes, provider/model series, input/output/cache totals, refresh, and `24h`, `7d`, `30d`, or `90d` ranges. Left/Right changes range and `r` refreshes. Usage is persisted by the daemon from finalized Pi assistant messages.
 
 See [`docs/CALIBRATION.md`](docs/CALIBRATION.md) for thresholds and rollback, and [`docs/USAGE_PRIOR_ART.md`](docs/USAGE_PRIOR_ART.md) for the chart design research.
 

package/docs/USAGE_PRIOR_ART.md

@@ -1,6 +1,6 @@
 # Token-usage TUI prior art
 
-Research performed before implementing Jittor's `/usage` frontend.
+Research performed before implementing Jittor's `/jittor usage` frontend.
 
 ## Local agent implementations
 
@@ -60,5 +60,5 @@ Jittor combines the best applicable patterns:
 3. Provider/model-preserving series and input/output/cache totals.
 4. Vertically scaled, colored, stacked Unicode bars with fractional top blocks.
 5. Width-safe X/Y axes and provider/model legend.
-6. Native `/usage` panel with Left/Right range switching and refresh.
+6. Native `/jittor usage` panel with Left/Right range switching and refresh.
 7. Data access only through authenticated daemon `metrics.query`; the extension never opens SQLite or reads provider credentials.

package/extension/src/footer.ts

@@ -6,8 +6,13 @@ import {
 	FOOTER_BAR_MIN_WIDTH,
 	FOOTER_CONTEXT_ACCENT_FRACTION,
 	FOOTER_CONTEXT_ERROR_FRACTION,
+	FOOTER_COMPACTION_DRAIN_STEP_MS,
 	FOOTER_CONTEXT_WARNING_FRACTION,
 	FOOTER_WIDE_TERMINAL_WIDTH,
+	MILLISECONDS_PER_DAY,
+	MILLISECONDS_PER_HOUR,
+	MILLISECONDS_PER_MINUTE,
+	MILLISECONDS_PER_SECOND,
 	TELEMETRY_STALE_AFTER_MS,
 } from "../../src/constants.ts";
 
@@ -42,12 +47,24 @@ interface FooterContext {
 	};
 }
 
-/** A provider usage value suitable for the footer. Null fraction means no known denominator. */
-export interface ProviderBudget {
+/** A bounded quota is explicitly remaining; unbounded values never receive a fabricated bar. */
+export type ProviderBudget = {
+	kind: "bounded";
+	label: string;
+	remainingFraction: number;
+	observedAt?: number;
+	resetsAt?: number;
+	resetText?: string;
+} | {
+	kind: "unbounded";
 	label: string;
-	fraction: number | null;
 	valueText: string;
 	observedAt?: number;
+};
+
+export interface CompactionProgress {
+	startedAt: number;
+	initialFraction: number;
 }
 
 interface UsageTotals {
@@ -116,24 +133,72 @@ function fillColor(fraction: number | null): FooterColor {
 	return "dim";
 }
 
-function contextSegment(context: FooterContext, theme: FooterTheme, width: number, compact: boolean): string {
+function compactionFraction(progress: CompactionProgress, width: number, now: number): number {
+	const initialFilled = Math.round(Math.min(1, Math.max(0, progress.initialFraction)) * width);
+	const drained = Math.floor(Math.max(0, now - progress.startedAt) / FOOTER_COMPACTION_DRAIN_STEP_MS);
+	return Math.max(0, initialFilled - drained) / width;
+}
+
+function contextSegment(
+	context: FooterContext,
+	theme: FooterTheme,
+	width: number,
+	compact: boolean,
+	now: number,
+	compaction?: CompactionProgress,
+): string {
+	const w = barWidth(width);
+	if (compaction) {
+		const fraction = compactionFraction(compaction, w, now);
+		const elapsedSeconds = Math.floor(Math.max(0, now - compaction.startedAt) / MILLISECONDS_PER_SECOND);
+		return `ctx ${theme.fg("accent", progressBar(fraction, w))} compact ${elapsedSeconds}s`;
+	}
 	const usage = context.getContextUsage();
 	const window = usage?.contextWindow ?? context.model?.contextWindow ?? 0;
 	const fraction = usage?.percent === null || usage?.percent === undefined ? null : usage.percent / 100;
-	const bar = theme.fg(fillColor(fraction), progressBar(fraction, barWidth(width)));
+	const bar = theme.fg(fillColor(fraction), progressBar(fraction, w));
 	if (usage?.tokens === null || usage?.tokens === undefined) return `ctx ${bar} ?/${formatTokens(window)}`;
 	const value = compact ? `${Math.round((fraction ?? 0) * 100)}%` : `${formatTokens(usage.tokens)}/${formatTokens(window)}`;
 	return `ctx ${bar} ${value}`;
 }
 
+function minimalContextSegment(
+	context: FooterContext,
+	theme: FooterTheme,
+	width: number,
+	now: number,
+	compaction?: CompactionProgress,
+): string {
+	const w = barWidth(width);
+	if (compaction) {
+		const fraction = compactionFraction(compaction, w, now);
+		return `ctx ${theme.fg("accent", progressBar(fraction, w))}`;
+	}
+	const percent = context.getContextUsage()?.percent;
+	const fraction = percent === null || percent === undefined ? null : percent / 100;
+	return `ctx ${theme.fg(fillColor(fraction), progressBar(fraction, w))}`;
+}
+
+function resetLabel(resetsAt: number | undefined, now: number): string | undefined {
+	if (resetsAt === undefined) return undefined;
+	const remaining = resetsAt - now;
+	if (remaining <= 0) return "reset due";
+	if (remaining >= MILLISECONDS_PER_DAY) return `resets in ${Math.floor(remaining / MILLISECONDS_PER_DAY)}d`;
+	if (remaining >= MILLISECONDS_PER_HOUR) return `resets in ${Math.floor(remaining / MILLISECONDS_PER_HOUR)}h`;
+	return `resets in ${Math.max(1, Math.ceil(remaining / MILLISECONDS_PER_MINUTE))}m`;
+}
+
 function budgetSegment(budget: ProviderBudget | null, theme: FooterTheme, width: number, compact: boolean, now: number): string {
 	const w = barWidth(width);
 	if (!budget) return `budget ${theme.fg("dim", progressBar(null, w))} ?`;
-	if (budget.fraction === null) return `${budget.label} ${budget.valueText}`;
-	const bar = theme.fg(fillColor(budget.fraction), progressBar(budget.fraction, w));
-	const value = compact ? `${Math.round(budget.fraction * 100)}%` : budget.valueText;
 	const stale = budget.observedAt !== undefined && now - budget.observedAt > TELEMETRY_STALE_AFTER_MS;
-	return `${budget.label} ${bar} ${value}${stale ? ` ${theme.fg("warning", "stale")}` : ""}`;
+	const staleText = stale ? ` ${theme.fg("warning", "stale")}` : "";
+	if (budget.kind === "unbounded") return `${budget.label} ${budget.valueText}${staleText}`;
+	const remaining = Math.min(1, Math.max(0, budget.remainingFraction));
+	const bar = theme.fg(fillColor(1 - remaining), progressBar(remaining, w));
+	const value = `${(compact ? Math.round(remaining * 100) : (remaining * 100).toFixed(1))}% left`;
+	const reset = compact ? undefined : resetLabel(budget.resetsAt, now) ?? budget.resetText;
+	return `${budget.label} ${bar} ${value}${reset ? ` · ${reset}` : ""}${staleText}`;
 }
 
 function usageSegment(context: FooterContext): string {
@@ -187,14 +252,16 @@ export function renderFooterLines(
 	thinkingLevel: string,
 	width: number,
 	now = Date.now(),
+	compaction?: CompactionProgress,
 ): string[] {
 	const safeWidth = Math.max(1, width);
 	const repository = repositorySegment(context, footerData, theme);
 	const model = modelSegments(context, footerData, theme, thinkingLevel);
 	const usage = usageSegment(context);
 	const compactUsage = compactUsageSegment(context);
-	const fullContext = contextSegment(context, theme, safeWidth, false);
-	const compactContext = contextSegment(context, theme, safeWidth, true);
+	const fullContext = contextSegment(context, theme, safeWidth, false, now, compaction);
+	const compactContext = contextSegment(context, theme, safeWidth, true, now, compaction);
+	const minimalContext = minimalContextSegment(context, theme, safeWidth, now, compaction);
 	const fullBudget = budgetSegment(providerBudget, theme, safeWidth, false, now);
 	const compactBudget = budgetSegment(providerBudget, theme, safeWidth, true, now);
 	const statuses = [...footerData.getExtensionStatuses().entries()]
@@ -211,6 +278,7 @@ export function renderFooterLines(
 		joinSegments([model.full, compactUsage, compactContext, compactBudget]),
 		joinSegments([model.compact, compactUsage, compactContext, compactBudget]),
 		joinSegments([model.compact, compactContext, compactBudget]),
+		joinSegments([model.compact, minimalContext, compactBudget]),
 	];
 	const line = candidates.find((candidate) => visibleWidth(candidate) <= safeWidth) ?? candidates.at(-1) ?? "";
 	return [truncateToWidth(line, safeWidth, "")];
@@ -218,6 +286,7 @@ export function renderFooterLines(
 
 export interface IntegratedFooterState {
 	providerBudget: ProviderBudget | null;
+	compaction?: CompactionProgress;
 	requestRender?: () => void;
 }
 
@@ -229,7 +298,7 @@ export function installIntegratedFooter(ctx: ExtensionContext, state: Integrated
 		return {
 			invalidate() {},
 			render(width: number): string[] {
-				return renderFooterLines(ctx as unknown as FooterContext, footerData, theme, state.providerBudget, getThinkingLevel(), width);
+				return renderFooterLines(ctx as unknown as FooterContext, footerData, theme, state.providerBudget, getThinkingLevel(), width, Date.now(), state.compaction);
 			},
 			dispose() {
 				unsubscribe?.();

package/extension/src/index.ts

@@ -1,5 +1,5 @@
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { MAX_DYNAMIC_ROUTES } from "../../src/constants.ts";
+import { FOOTER_COMPACTION_RENDER_INTERVAL_MS, MAX_DYNAMIC_ROUTES } from "../../src/constants.ts";
 import type { MetricObservation, StoredMetricObservation } from "../../src/domain/metric.ts";
 import type { PolicyDecision, Route } from "../../src/policy.ts";
 import type { RouterStatus } from "../../src/ports/router-controller.ts";
@@ -32,7 +32,7 @@ async function refreshFooter(client: JittorExtensionClient, state: IntegratedFoo
 	const provider = status.currentRoute?.provider;
 	const query = provider === "openai-codex"
 		? { source: "codex-subscription", metric: "used-fraction", limit: 100, order: "desc" }
-		: provider === "openrouter" ? { source: "openrouter", metric: "usage", limit: 10, order: "desc" } : null;
+		: provider === "openrouter" ? { source: "openrouter", limit: 20, order: "desc" } : null;
 	const metrics = query ? await client.call("metrics.query", query) as StoredMetricObservation[] : [];
 	state.providerBudget = buildFooterBudget(status, metrics);
 	state.requestRender?.();
@@ -171,6 +171,25 @@ export function registerJittorExtension(
 	enforcement: EnforcementControl = persistentEnforcementControl(),
 ): void {
 	const footerState: IntegratedFooterState = { providerBudget: null };
+	let compactionTimer: ReturnType<typeof setInterval> | undefined;
+	const finishCompaction = (): void => {
+		if (compactionTimer) clearInterval(compactionTimer);
+		compactionTimer = undefined;
+		footerState.compaction = undefined;
+		footerState.requestRender?.();
+	};
+	const beginCompaction = (ctx: ExtensionContext, signal: AbortSignal): void => {
+		finishCompaction();
+		const usage = ctx.getContextUsage();
+		footerState.compaction = {
+			startedAt: Date.now(),
+			initialFraction: usage?.percent === null || usage?.percent === undefined ? 1 : usage.percent / 100,
+		};
+		compactionTimer = setInterval(() => footerState.requestRender?.(), FOOTER_COMPACTION_RENDER_INTERVAL_MS);
+		signal.addEventListener("abort", finishCompaction, { once: true });
+		if (signal.aborted) finishCompaction();
+		else footerState.requestRender?.();
+	};
 	const showFooter = (ctx: ExtensionContext): void => {
 		if (enforcement.isFooterEnabled()) installIntegratedFooter(ctx, footerState, () => pi.getThinkingLevel());
 		else ctx.ui.setFooter(undefined);
@@ -201,7 +220,7 @@ export function registerJittorExtension(
 	};
 
 	pi.registerCommand("jittor", {
-		description: "Inspect, enable, or disable Jittor routing",
+		description: "Inspect or control Jittor routing, budgets, and usage",
 		handler: async (args, ctx) => {
 			const action = args.trim().toLowerCase();
 			if (action === "off" || action === "disable") { disable(ctx); return; }
@@ -219,6 +238,10 @@ export function registerJittorExtension(
 				ctx.ui.notify("Jittor informational footer enabled; routing enforcement is unchanged.", "info");
 				return;
 			}
+			if (action === "usage") {
+				await showUsagePanel(ctx, client);
+				return;
+			}
 			if (!enforcement.isEnabled()) {
 				ctx.ui.notify("Jittor is monitor-only. Run /jittor on to re-enable blocking.", "info");
 				return;
@@ -226,20 +249,9 @@ export function registerJittorExtension(
 			await showJittorPanel(ctx, client);
 		},
 	});
-	pi.registerCommand("jittor-off", {
-		description: "Emergency local bypass: disable Jittor blocking without daemon access",
-		handler: async (_args, ctx) => { disable(ctx); },
-	});
-	pi.registerCommand("jittor-on", {
-		description: "Enable Jittor only after telemetry and routes pass readiness",
-		handler: async (_args, ctx) => { await enable(ctx); },
-	});
-	pi.registerCommand("usage", {
-		description: "Show Jittor token usage over time",
-		handler: async (_args, ctx) => { await showUsagePanel(ctx, client); },
-	});
 
 	pi.on("session_start", async (_event, ctx) => {
+		finishCompaction();
 		ctx.ui.setStatus("jittor", undefined);
 		showFooter(ctx);
 		try {
@@ -253,6 +265,18 @@ export function registerJittorExtension(
 		}
 	});
 
+	pi.on("session_before_compact", (event, ctx) => {
+		beginCompaction(ctx, event.signal);
+	});
+
+	pi.on("session_compact", () => {
+		finishCompaction();
+	});
+
+	pi.on("agent_settled", () => {
+		if (footerState.compaction) finishCompaction();
+	});
+
 	pi.on("input", async (event, ctx) => {
 		if (event.source === "extension" || !enforcement.isEnabled()) return { action: "continue" as const };
 		try {
@@ -307,6 +331,7 @@ export function registerJittorExtension(
 	});
 
 	pi.on("session_shutdown", async (_event, ctx) => {
+		finishCompaction();
 		ctx.ui.setStatus("jittor", undefined);
 		ctx.ui.setFooter(undefined);
 	});

package/extension/src/tui.ts

@@ -15,10 +15,35 @@ function latest(rows: StoredMetricObservation[], predicate: (row: StoredMetricOb
 	return rows.filter(predicate).sort((left, right) => right.observedAt - left.observedAt || right.id - left.id)[0];
 }
 
-function longestCodexWindow(rows: StoredMetricObservation[]): StoredMetricObservation | undefined {
-	return rows
-		.filter((row) => row.source === "codex-subscription" && row.metric === "used-fraction" && typeof row.value === "number")
-		.sort((left, right) => Number(right.attributes["windowSeconds"] ?? 0) - Number(left.attributes["windowSeconds"] ?? 0) || right.observedAt - left.observedAt)[0];
+function sanitizedText(value: string): string {
+	return value.replace(/[\r\n\t]/g, " ").replace(/ +/g, " ").trim();
+}
+
+function normalizedIdentity(value: unknown): string {
+	return typeof value === "string" ? value.toLowerCase().replace(/[^a-z0-9]+/g, "") : "";
+}
+
+function longestWindow(rows: StoredMetricObservation[]): StoredMetricObservation | undefined {
+	return [...rows].sort((left, right) =>
+		Number(right.attributes["windowSeconds"] ?? 0) - Number(left.attributes["windowSeconds"] ?? 0)
+		|| right.observedAt - left.observedAt
+		|| right.id - left.id,
+	)[0];
+}
+
+function codexWindowForModel(rows: StoredMetricObservation[], model: string): StoredMetricObservation | undefined {
+	const codexRows = rows.filter((row) => row.source === "codex-subscription" && row.metric === "used-fraction" && typeof row.value === "number");
+	const modelIdentity = normalizedIdentity(model);
+	const matchingAdditional = codexRows.filter((row) => {
+		const limitId = normalizedIdentity(row.attributes["limitId"]);
+		const limitName = normalizedIdentity(row.attributes["limitName"]);
+		return limitId !== "codex" && limitName.length > 0 && limitName === modelIdentity;
+	});
+	if (matchingAdditional.length > 0) return longestWindow(matchingAdditional);
+	return longestWindow(codexRows.filter((row) => {
+		const limitId = normalizedIdentity(row.attributes["limitId"]);
+		return limitId === "codex" || (limitId.length === 0 && row.scope.startsWith("codex:"));
+	}));
 }
 
 function compactWindowName(seconds: number): string {
@@ -36,19 +61,32 @@ function windowName(seconds: number): string {
 export function buildFooterBudget(status: RouterStatus, metrics: StoredMetricObservation[]): ProviderBudget | null {
 	if (!status.ready || !status.currentRoute) return null;
 	if (status.currentRoute.provider === "openai-codex") {
-		const codex = longestCodexWindow(metrics);
+		const codex = codexWindowForModel(metrics, status.currentRoute.model);
 		if (!codex || typeof codex.value !== "number") return null;
+		const resetsAtSeconds = Number(codex.attributes["resetsAt"]);
 		return {
+			kind: "bounded",
 			label: compactWindowName(Number(codex.attributes["windowSeconds"] ?? 0)),
-			fraction: codex.value,
-			valueText: `${(codex.value * 100).toFixed(1)}% used`,
+			remainingFraction: 1 - codex.value,
 			observedAt: codex.observedAt,
+			...(Number.isFinite(resetsAtSeconds) && resetsAtSeconds > 0 ? { resetsAt: resetsAtSeconds * 1_000 } : {}),
 		};
 	}
 	if (status.currentRoute.provider === "openrouter") {
 		const openRouter = latest(metrics, (row) => row.source === "openrouter" && row.metric === "usage" && typeof row.value === "number");
+		const remaining = latest(metrics, (row) => row.source === "openrouter" && row.metric === "remaining-fraction" && typeof row.value === "number");
+		if (remaining && typeof remaining.value === "number" && (!openRouter || remaining.observedAt >= openRouter.observedAt)) {
+			const reset = typeof remaining.attributes["reset"] === "string" ? sanitizedText(remaining.attributes["reset"]) : undefined;
+			return {
+				kind: "bounded",
+				label: "OR",
+				remainingFraction: remaining.value,
+				observedAt: remaining.observedAt,
+				...(reset ? { resetText: `${reset} reset` } : {}),
+			};
+		}
 		if (!openRouter || typeof openRouter.value !== "number") return null;
-		return { label: "spend", fraction: null, valueText: `$${openRouter.value.toFixed(3)}`, observedAt: openRouter.observedAt };
+		return { kind: "unbounded", label: "spend", valueText: `$${openRouter.value.toFixed(3)}`, observedAt: openRouter.observedAt };
 	}
 	return null;
 }
@@ -56,7 +94,7 @@ export function buildFooterBudget(status: RouterStatus, metrics: StoredMetricObs
 export function formatFooterStatus(status: RouterStatus, metrics: StoredMetricObservation[]): string {
 	const budget = buildFooterBudget(status, metrics);
 	if (!budget) return "";
-	return budget.fraction === null ? budget.valueText : `${budget.label} ${(budget.fraction * 100).toFixed(1)}%`;
+	return budget.kind === "unbounded" ? budget.valueText : `${budget.label} ${(budget.remainingFraction * 100).toFixed(1)}% left`;
 }
 
 function nextAction(action: PolicyAction | undefined): string {
@@ -87,10 +125,10 @@ function burnLine(rows: StoredMetricObservation[], current: StoredMetricObservat
 
 export function buildStatusView(status: RouterStatus, metrics: StoredMetricObservation[], now = Date.now()): string[] {
 	const lines = [status.ready ? "Ready" : "Not ready"];
-	const codex = status.currentRoute?.provider === "openai-codex" ? longestCodexWindow(metrics) : undefined;
+	const codex = status.currentRoute?.provider === "openai-codex" ? codexWindowForModel(metrics, status.currentRoute.model) : undefined;
 	if (codex && typeof codex.value === "number") {
 		const seconds = Number(codex.attributes["windowSeconds"] ?? 0);
-		lines.push(`Codex ${windowName(seconds)}: ${(codex.value * 100).toFixed(1)}%`);
+		lines.push(`Codex ${windowName(seconds)}: ${((1 - codex.value) * 100).toFixed(1)}% left`);
 		lines.push(burnLine(metrics, codex, now));
 	}
 	const openRouter = status.currentRoute?.provider === "openrouter"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danypops/jittor",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Just-in-Time Token Optimizing Router for Pi",
   "type": "module",
   "keywords": ["pi-package", "llm-router", "token-budget"],

package/src/constants.ts

@@ -1,4 +1,4 @@
-export const VERSION = "0.1.1";
+export const VERSION = "0.1.2";
 export const SQLITE_SCHEMA_VERSION = 1;
 export const SQLITE_BUSY_TIMEOUT_MS = 5_000;
 export const DEFAULT_QUERY_LIMIT = 1_000;
@@ -13,6 +13,12 @@ export const FOOTER_CONTEXT_ERROR_FRACTION = 0.9;
 export const FOOTER_BAR_MIN_WIDTH = 4;
 export const FOOTER_BAR_MAX_WIDTH = 8;
 export const FOOTER_WIDE_TERMINAL_WIDTH = 100;
+export const FOOTER_COMPACTION_RENDER_INTERVAL_MS = 1_000;
+export const FOOTER_COMPACTION_DRAIN_STEP_MS = 3_000;
+export const MILLISECONDS_PER_SECOND = 1_000;
+export const MILLISECONDS_PER_MINUTE = 60 * MILLISECONDS_PER_SECOND;
+export const MILLISECONDS_PER_HOUR = 60 * MILLISECONDS_PER_MINUTE;
+export const MILLISECONDS_PER_DAY = 24 * MILLISECONDS_PER_HOUR;
 export const LOOPBACK_HOST = "127.0.0.1";
 export const JITTOR_STATE_DIRECTORY = "jittor";
 export const JITTOR_EXTENSION_SETTINGS_FILENAME = "extension.json";

package/src/providers/openrouter-contracts.ts

@@ -164,7 +164,13 @@ export function parseOpenRouterKey(rootValue: unknown, observedAt: number): Open
 	add("usage-monthly", snapshot.usageMonthly);
 	add("limit", limit);
 	add("limit-remaining", remaining);
-	if (limit !== null && limit > 0) snapshot.metrics.push(metric(scope, "used-fraction", usage / limit, "ratio", observedAt));
+	if (limit !== null && limit > 0 && remaining !== null) {
+		const remainingFraction = remaining / limit;
+		if (remainingFraction < 0 || remainingFraction > 1) throw new Error("OpenRouter key remaining fraction is outside its configured limit");
+		const attributes = { limit, remaining, reset: snapshot.reset };
+		snapshot.metrics.push(metric(scope, "remaining-fraction", remainingFraction, "ratio", observedAt, attributes));
+		snapshot.metrics.push(metric(scope, "used-fraction", 1 - remainingFraction, "ratio", observedAt, attributes));
+	}
 	return snapshot;
 }