pi-harness-runtime 0.9.2 → 0.9.5

package/packages/quota-manager/test/quota.test.ts

@@ -0,0 +1,432 @@
+/**
+ * Quota Manager Tests
+ */
+
+import { describe, it, expect, beforeEach } from "bun:test";
+import {
+	QuotaManager,
+	parseMiniMaxError,
+	parseOpenAIError,
+} from "../src/quota-manager.js";
+import { TUIUsageMonitor } from "../src/tui-usage-monitor.js";
+
+describe("QuotaManager", () => {
+	let manager: QuotaManager;
+
+	beforeEach(() => {
+		manager = new QuotaManager(30 * 60 * 1000);
+	});
+
+	describe("recordSignal", () => {
+		it("records a basic signal", () => {
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				usedPct: 50,
+			});
+
+			const signal = manager.getLatestSignal("minimax", "5h");
+			expect(signal).not.toBeNull();
+			expect(signal!.usedPct).toBe(50);
+			expect(signal!.remainingPct).toBe(50);
+			expect(signal!.exhausted).toBe(false);
+		});
+
+		it("records exhausted signal", () => {
+			manager.recordSignal({
+				provider: "openai",
+				source: "api_response",
+				windowType: "daily",
+				usedPct: 100,
+				exhausted: true,
+			});
+
+			const signal = manager.getLatestSignal("openai", "daily");
+			expect(signal!.exhausted).toBe(true);
+		});
+
+		it("stores multiple signals per provider", () => {
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				usedPct: 30,
+			});
+			manager.recordSignal({
+				provider: "minimax",
+				source: "playwright",
+				windowType: "daily",
+				usedPct: 70,
+			});
+
+			const signals = manager.getSignals("minimax");
+			expect(signals.length).toBeGreaterThanOrEqual(2);
+		});
+	});
+
+	describe("getLatestSignal", () => {
+		it("returns most recent by capturedAt", async () => {
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				usedPct: 10,
+			});
+			await new Promise((r) => setTimeout(r, 2));
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				usedPct: 80,
+			});
+
+			const latest = manager.getLatestSignal("minimax", "5h");
+			expect(latest!.usedPct).toBe(80);
+		});
+
+		it("returns null for unknown provider", () => {
+			expect(manager.getLatestSignal("unknown")).toBeNull();
+		});
+	});
+
+	describe("getProviderState", () => {
+		it("available when under 90%", () => {
+			manager.recordSignal({
+				provider: "openai",
+				source: "api_response",
+				windowType: "daily",
+				usedPct: 50,
+			});
+
+			const state = manager.getProviderState("openai");
+			expect(state.available).toBe(true);
+			expect(state.limited).toBe(false);
+			expect(state.exhausted).toBe(false);
+		});
+
+		it("limited when at 90%+", () => {
+			manager.recordSignal({
+				provider: "openai",
+				source: "api_response",
+				windowType: "daily",
+				usedPct: 95,
+			});
+
+			const state = manager.getProviderState("openai");
+			expect(state.limited).toBe(true);
+			expect(state.available).toBe(false);
+		});
+
+		it("exhausted when at 100%", () => {
+			manager.recordSignal({
+				provider: "openai",
+				source: "api_response",
+				windowType: "daily",
+				usedPct: 100,
+			});
+
+			const state = manager.getProviderState("openai");
+			expect(state.exhausted).toBe(true);
+		});
+
+		it("exhausted when explicit flag set", () => {
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				exhausted: true,
+			});
+
+			const state = manager.getProviderState("minimax");
+			expect(state.exhausted).toBe(true);
+		});
+
+		it("includes next available time", () => {
+			const future = new Date(Date.now() + 3600000).toISOString();
+			manager.recordSignal({
+				provider: "openai",
+				source: "api_response",
+				windowType: "daily",
+				exhausted: true,
+				resetsAt: future,
+			});
+
+			const state = manager.getProviderState("openai");
+			expect(state.nextAvailableAt).toBeDefined();
+		});
+	});
+
+	describe("isAvailable / isExhausted", () => {
+		it("isAvailable true when under 90%", () => {
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				usedPct: 50,
+			});
+			expect(manager.isAvailable("minimax")).toBe(true);
+		});
+
+		it("isExhausted true when exhausted", () => {
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				exhausted: true,
+			});
+			expect(manager.isExhausted("minimax")).toBe(true);
+		});
+	});
+
+	describe("selectBestProvider", () => {
+		it("returns provider with most remaining quota", () => {
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				usedPct: 80,
+			});
+			manager.recordSignal({
+				provider: "openai",
+				source: "api_response",
+				windowType: "5h",
+				usedPct: 30,
+			});
+
+			const best = manager.selectBestProvider(["minimax", "openai"]);
+			expect(best).toBe("openai");
+		});
+
+		it("returns null when all exhausted", () => {
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				exhausted: true,
+			});
+			manager.recordSignal({
+				provider: "openai",
+				source: "api_response",
+				windowType: "5h",
+				exhausted: true,
+			});
+
+			expect(manager.selectBestProvider(["minimax", "openai"])).toBeNull();
+		});
+
+		it("returns null for empty list", () => {
+			expect(manager.selectBestProvider([])).toBeNull();
+		});
+	});
+
+	describe("clearStale", () => {
+		it("clears old signals", () => {
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				usedPct: 50,
+			});
+
+			// Manually add a stale signal (simulated)
+			manager.clearStale();
+
+			const signals = manager.getSignals("minimax");
+			expect(signals.length).toBeGreaterThanOrEqual(0);
+		});
+	});
+
+	describe("generateReport", () => {
+		it("generates report for known providers", () => {
+			manager.recordSignal({
+				provider: "minimax",
+				source: "api_response",
+				windowType: "5h",
+				usedPct: 45,
+			});
+
+			const report = manager.generateReport(["minimax"]);
+			expect(report).toContain("minimax");
+			expect(report).toContain("AVAILABLE");
+		});
+
+		it("shows EXHAUSTED for exhausted providers", () => {
+			manager.recordSignal({
+				provider: "openai",
+				source: "api_response",
+				windowType: "daily",
+				exhausted: true,
+			});
+
+			const report = manager.generateReport(["openai"]);
+			expect(report).toContain("EXHAUSTED");
+		});
+	});
+});
+
+describe("parseMiniMaxError", () => {
+	it("parses quota error code 2056", () => {
+		const result = parseMiniMaxError({
+			message: "Error code: 2056 - Rate limit exceeded",
+		});
+		expect(result).not.toBeNull();
+		expect(result!.provider).toBe("minimax");
+		expect(result!.exhausted).toBe(true);
+	});
+
+	it("parses quota keyword", () => {
+		const result = parseMiniMaxError({ message: "quota exceeded" });
+		expect(result).not.toBeNull();
+		expect(result!.exhausted).toBe(true);
+	});
+
+	it("returns null for unrelated errors", () => {
+		const result = parseMiniMaxError({ message: "Invalid request" });
+		expect(result).toBeNull();
+	});
+
+	it("extracts retry time in seconds", () => {
+		const result = parseMiniMaxError({
+			message: "rate limit exceeded. Retry after 30 seconds",
+		});
+		expect(result).not.toBeNull();
+		expect(result!.retryAfterMs).toBe(30000);
+	});
+
+	it("extracts retry time in minutes", () => {
+		const result = parseMiniMaxError({
+			message: "rate limit exceeded. Retry after 2 minutes",
+		});
+		expect(result).not.toBeNull();
+		expect(result!.retryAfterMs).toBe(120000);
+	});
+});
+
+describe("parseOpenAIError", () => {
+	it("parses insufficient_quota", () => {
+		const result = parseOpenAIError({
+			code: "insufficient_quota",
+			message: "Quota exceeded",
+		});
+		expect(result).not.toBeNull();
+		expect(result!.provider).toBe("openai");
+		expect(result!.exhausted).toBe(true);
+	});
+
+	it("parses context_length_exceeded", () => {
+		const result = parseOpenAIError({
+			code: "context_length_exceeded",
+			message: "Too many tokens",
+		});
+		expect(result).not.toBeNull();
+		expect(result!.exhausted).toBe(true);
+	});
+
+	it("parses 429 rate limit", () => {
+		const result = parseOpenAIError({
+			message: "HTTP 429: Rate limit exceeded",
+		});
+		expect(result).not.toBeNull();
+		expect(result!.exhausted).toBe(true);
+		expect(result!.windowType).toBe("5h");
+	});
+
+	it("returns null for unrelated errors", () => {
+		const result = parseOpenAIError({
+			code: "invalid_request_error",
+			message: "Bad request",
+		});
+		expect(result).toBeNull();
+	});
+});
+
+describe("TUIUsageMonitor", () => {
+	let manager: QuotaManager;
+	let monitor: TUIUsageMonitor;
+
+	beforeEach(() => {
+		manager = new QuotaManager();
+		monitor = new TUIUsageMonitor({ quotaManager: manager });
+	});
+
+	describe("detectProvider", () => {
+		it("detects OpenAI", () => {
+			expect(monitor.detectProvider("OpenAI GPT-4 quota exceeded")).toBe(
+				"openai",
+			);
+		});
+
+		it("detects GLM", () => {
+			expect(monitor.detectProvider("GLM rate limit exceeded")).toBe("glm");
+		});
+
+		it("detects Anthropic Claude", () => {
+			expect(monitor.detectProvider("Claude overloaded_error")).toBe(
+				"anthropic",
+			);
+		});
+
+		it("detects OpenRouter", () => {
+			expect(monitor.detectProvider("OpenRouter quota exhausted")).toBe(
+				"openrouter",
+			);
+		});
+
+		it("returns null for unknown", () => {
+			expect(monitor.detectProvider("Random message")).toBeNull();
+		});
+	});
+
+	describe("processMessage", () => {
+		it("processes OpenAI quota message", () => {
+			const signal = monitor.processMessage(
+				"OpenAI insufficient_quota: daily limit reached",
+			);
+			expect(signal).not.toBeNull();
+			expect(signal!.provider).toBe("openai");
+		});
+
+		it("processes rate limit message", () => {
+			const signal = monitor.processMessage(
+				"Claude rate_limit_error: try again in 30 seconds",
+			);
+			expect(signal).not.toBeNull();
+			expect(signal!.provider).toBe("anthropic");
+			expect(signal!.limitType).toBe("rate_limit");
+		});
+
+		it("processes context window message", () => {
+			const signal = monitor.processMessage(
+				"OpenAI context_length_exceeded: too many tokens",
+			);
+			expect(signal).not.toBeNull();
+			expect(signal!.limitType).toBe("context_window");
+		});
+
+		it("returns null for non-quota messages", () => {
+			const signal = monitor.processMessage("Hello world, this is just a test");
+			expect(signal).toBeNull();
+		});
+
+		it("records to QuotaManager", () => {
+			monitor.processMessage("OpenAI quota exhausted at 100%");
+			expect(manager.getSignals("openai").length).toBeGreaterThan(0);
+		});
+
+		it("stores last signal per provider", () => {
+			monitor.processMessage("OpenAI quota exhausted at 100%");
+			monitor.processMessage("GLM quota exhausted");
+			const openaiSignal = monitor.getLastSignal("openai");
+			const glmSignal = monitor.getLastSignal("glm");
+			expect(openaiSignal?.provider).toBe("openai");
+			expect(glmSignal?.provider).toBe("glm");
+		});
+
+		it("clears stored signals", () => {
+			monitor.processMessage("OpenAI GPT-4 quota exhausted");
+			monitor.clear();
+			expect(monitor.getLastSignal("openai")).toBeNull();
+		});
+	});
+});

package/packages/quota-manager/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}

package/packages/rate-limiter/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Rate Limiter — Main Entry (RFC-0023)
+ */
+export { RateLimiter } from "./limiter.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/rate-limiter/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,mBAAmB,YAAY,CAAC"}

package/packages/rate-limiter/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * Rate Limiter — Main Entry (RFC-0023)
+ */
+export { RateLimiter } from "./limiter.js";
+//# sourceMappingURL=index.js.map

package/packages/rate-limiter/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/packages/rate-limiter/dist/limiter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Rate Limiter — Core (RFC-0023)
+ */
+import type { BucketState, RateLimitConfig, RateLimitResult, RateLimitStats } from "./types.js";
+export declare class RateLimiter {
+    private config;
+    private buckets;
+    private stats;
+    constructor(config: RateLimitConfig);
+    consume(key?: string, tokens?: number): RateLimitResult;
+    reset(key?: string): void;
+    peek(key?: string): BucketState;
+    getStats(key?: string): RateLimitStats;
+    listKeys(): string[];
+    size(): number;
+    private resolveKey;
+    private refill;
+    private recordRequest;
+}
+//# sourceMappingURL=limiter.d.ts.map

package/packages/rate-limiter/dist/limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limiter.d.ts","sourceRoot":"","sources":["../src/limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,WAAW,EAEX,eAAe,EAEf,eAAe,EAEf,cAAc,EACd,MAAM,YAAY,CAAC;AAEpB,qBAAa,WAAW;IACvB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,KAAK,CAAqC;IAElD,YAAY,MAAM,EAAE,eAAe,EAUlC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,eAAe,CAyBjD;IAED,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAGxB;IAED,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAK9B;IAED,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CASrC;IAED,QAAQ,IAAI,MAAM,EAAE,CAEnB;IAED,IAAI,IAAI,MAAM,CAEb;IAED,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,MAAM;IAgBd,OAAO,CAAC,aAAa;CAWrB"}

package/packages/rate-limiter/dist/limiter.js

@@ -0,0 +1,101 @@
+/**
+ * Rate Limiter — Core (RFC-0023)
+ */
+export class RateLimiter {
+    config;
+    buckets = new Map();
+    stats = new Map();
+    constructor(config) {
+        this.config = {
+            algorithm: config.algorithm ?? "token-bucket",
+            capacity: config.capacity ?? 100,
+            refillRate: config.refillRate ?? 10,
+            refillIntervalMs: config.refillIntervalMs ?? 1000,
+            scope: config.scope ?? "global",
+        };
+        this.buckets.set("__global__", { tokens: this.config.capacity, lastRefill: Date.now() });
+        this.stats.set("__global__", { key: "__global__", totalRequests: 0, allowedRequests: 0, rejectedRequests: 0, hitRate: 0 });
+    }
+    consume(key, tokens = 1) {
+        const effectiveKey = this.resolveKey(key);
+        const now = Date.now();
+        this.refill(effectiveKey, now);
+        const state = this.buckets.get(effectiveKey);
+        if (state.tokens >= tokens) {
+            state.tokens -= tokens;
+            this.recordRequest(effectiveKey, true);
+            return {
+                allowed: true,
+                remaining: Math.floor(state.tokens),
+                resetAt: now + this.config.refillIntervalMs,
+            };
+        }
+        const retryAfterMs = Math.ceil((tokens - state.tokens) / this.config.refillRate * this.config.refillIntervalMs);
+        this.recordRequest(effectiveKey, false);
+        return {
+            allowed: false,
+            remaining: Math.floor(state.tokens),
+            resetAt: now + retryAfterMs,
+            retryAfterMs,
+        };
+    }
+    reset(key) {
+        const effectiveKey = this.resolveKey(key);
+        this.buckets.set(effectiveKey, { tokens: this.config.capacity, lastRefill: Date.now() });
+    }
+    peek(key) {
+        const effectiveKey = this.resolveKey(key);
+        const now = Date.now();
+        this.refill(effectiveKey, now);
+        return { ...(this.buckets.get(effectiveKey) ?? { tokens: this.config.capacity, lastRefill: now }) };
+    }
+    getStats(key) {
+        const effectiveKey = this.resolveKey(key);
+        return this.stats.get(effectiveKey) ?? {
+            key: effectiveKey,
+            totalRequests: 0,
+            allowedRequests: 0,
+            rejectedRequests: 0,
+            hitRate: 0,
+        };
+    }
+    listKeys() {
+        return [...this.buckets.keys()].filter((k) => k !== "__global__");
+    }
+    size() {
+        return this.buckets.size;
+    }
+    resolveKey(key) {
+        if (this.config.scope === "global")
+            return "__global__";
+        return key ?? "__default__";
+    }
+    refill(key, now) {
+        let state = this.buckets.get(key);
+        if (!state) {
+            state = { tokens: this.config.capacity, lastRefill: now };
+            this.buckets.set(key, state);
+            this.stats.set(key, { key, totalRequests: 0, allowedRequests: 0, rejectedRequests: 0, hitRate: 0 });
+        }
+        if (now - state.lastRefill < this.config.refillIntervalMs)
+            return;
+        const intervals = Math.floor((now - state.lastRefill) / this.config.refillIntervalMs);
+        const toAdd = intervals * this.config.refillRate;
+        state.tokens = Math.min(this.config.capacity, state.tokens + toAdd);
+        state.lastRefill = state.lastRefill + intervals * this.config.refillIntervalMs;
+    }
+    recordRequest(key, allowed) {
+        let s = this.stats.get(key);
+        if (!s) {
+            s = { key, totalRequests: 0, allowedRequests: 0, rejectedRequests: 0, hitRate: 0 };
+            this.stats.set(key, s);
+        }
+        s.totalRequests++;
+        if (allowed)
+            s.allowedRequests++;
+        else
+            s.rejectedRequests++;
+        s.hitRate = s.totalRequests > 0 ? s.allowedRequests / s.totalRequests : 0;
+    }
+}
+//# sourceMappingURL=limiter.js.map

package/packages/rate-limiter/dist/limiter.js.map

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

package/packages/rate-limiter/dist/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Rate Limiter — Types (RFC-0023)
+ */
+export type RateLimitScope = "global" | "per-client" | "per-key";
+export type RateLimitAlgorithm = "token-bucket" | "leaky-bucket" | "sliding-window";
+export interface RateLimitConfig {
+    algorithm: RateLimitAlgorithm;
+    capacity: number;
+    refillRate: number;
+    refillIntervalMs: number;
+    scope?: RateLimitScope;
+}
+export interface RateLimitRecord {
+    key: string;
+    tokens: number;
+    lastRefill: number;
+    consumed: number;
+}
+export interface RateLimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetAt: number;
+    retryAfterMs?: number;
+}
+export interface RateLimitStats {
+    key: string;
+    totalRequests: number;
+    allowedRequests: number;
+    rejectedRequests: number;
+    hitRate: number;
+}
+export interface BucketState {
+    tokens: number;
+    lastRefill: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/rate-limiter/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEpF,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACnB"}

package/packages/rate-limiter/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Rate Limiter — Types (RFC-0023)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/rate-limiter/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/packages/rate-limiter/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pi/rate-limiter",
+  "version": "0.9.5",
+  "type": "module",
+  "description": "Rate limiting with token bucket algorithm (RFC-0023)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "bun-types": "^1.0.0"
+  }
+}

package/packages/rate-limiter/src/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Rate Limiter — Main Entry (RFC-0023)
+ */
+
+export { RateLimiter } from "./limiter.js";
+export type * from "./types.js";