Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors
TypeScript a2aai-agentsai-gatewayanthropicclaudeclaude-codeclinecodexcopilotcursordeepseekfree-aigeminikimillm-gatewaymcpopenaiopenai-proxyqwentoken-saver
import test from "node:test";
import assert from "node:assert/strict";
const memory = await import("../../open-sse/utils/proxyRefusalMemory.ts");
const listeners = await import("../../open-sse/utils/proxyTransitionListeners.ts");
const bridge = await import("../../src/lib/proxyEvents/proxyTransitionBridge.ts");
const bus = await import("../../src/lib/events/eventBus.ts");
const descriptions = await import("../../src/lib/webhooks/eventDescriptions.ts");
const types = await import("../../src/lib/events/types.ts");
const KEY = "http://[email protected]:8080";
function resetAll(): void {
memory.__resetProxyRefusalMemoryForTesting();
listeners.__resetProxyTransitionListenersForTesting();
bridge.__resetBridgeForTesting();
}
test.beforeEach(() => {
resetAll();
});
test.afterEach(() => {
resetAll();
delete process.env.PROXY_WEBHOOK_REBOUND_MS;
});
test("transition: first set-aside notifies once with key/kind/period/until, repeat returns null silently", () => {
try {
const seen: Array<{ key: string; kind: string; periodMs: number; until: number }> = [];
listeners.onProxyTransition((t) => {
seen.push(t);
});
const periodMs = memory.noteProxyRefusal(KEY, "ip_quota_429", 1_000_000);
assert.ok(typeof periodMs === "number");
assert.equal(seen.length, 1);
assert.equal(seen[0].key, KEY);
assert.equal(seen[0].kind, "ip_quota_429");
assert.equal(seen[0].periodMs, periodMs);
assert.equal(seen[0].until, 1_000_000 + (periodMs as number));
assert.ok(!("streak" in seen[0]), "transition carries no streak (D-OA)");
const again = memory.noteProxyRefusal(KEY, "ip_quota_429", 1_000_001);
assert.equal(again, null);
assert.equal(seen.length, 1);
} finally {
resetAll();
}
});
test("anti-rebound: burst of transitions on one key emits a single bus event", () => {
try {
bridge.registerProxyTransitionBridge();
const received: unknown[] = [];
const off = bus.on("proxy.set_aside", (payload) => {
received.push(payload);
});
try {
const now = 2_000_000;
bridge.__setBridgeNowForTesting(() => now);
for (let i = 0; i < 5; i++) {
bridge.emitSetAside({
key: KEY,
kind: "ip_quota_429",
periodMs: 60_000,
until: now + 60_000,
});
}
assert.equal(received.length, 1);
const payload = received[0] as Record<string, unknown>;
assert.ok(!("streak" in payload), "payload carries no streak (D-OA)");
} finally {
off();
}
} finally {
resetAll();
}
});
test("masking: scheme and port stay clear, user and host masked, null key silent", () => {
try {
assert.equal(
bridge.maskEgressKey("https://[email protected]:8080"),
"https://u***@ho***le:8080"
);
assert.equal(bridge.maskEgressKey("http://host.example:8080"), "http://ho***le:8080");
const masked = bridge.maskEgressKey(KEY);
assert.ok(!masked.includes("[email protected]"), "no full credentials in masked key");
const periodMs = memory.noteProxyRefusal(null, "ip_quota_429", 3_000_000);
assert.equal(periodMs, null);
} finally {
resetAll();
}
});
test("restart: reset state emits nothing and offers no recovered event", () => {
try {
resetAll();
assert.equal(listeners.__listenerCountForTesting(), 0);
assert.ok(!("proxy.recovered" in descriptions.EVENT_DESCRIPTIONS));
} finally {
resetAll();
}
});
test("declarations: both events listed with proxy channel", () => {
try {
assert.ok(descriptions.EVENT_DESCRIPTIONS["proxy.set_aside"]);
assert.ok(descriptions.EVENT_DESCRIPTIONS["proxy.pool.exhausted"]);
assert.ok(descriptions.WEBHOOK_EVENT_VALUES.includes("proxy.set_aside"));
assert.ok(descriptions.WEBHOOK_EVENT_VALUES.includes("proxy.pool.exhausted"));
assert.deepEqual(types.CHANNEL_EVENTS.proxy, ["proxy.set_aside", "proxy.pool.exhausted"]);
} finally {
resetAll();
}
});
test("exhausted foundation: full set-aside emits, partial does not, scope window holds", () => {
try {
const at = 4_000_000;
assert.equal(bridge.shouldEmitPoolExhausted("global", 3, 3, at), true);
assert.equal(bridge.shouldEmitPoolExhausted("global", 3, 3, at + 1_000), false);
assert.equal(bridge.shouldEmitPoolExhausted("global", 3, 2, at + 400_000), false);
const event = bridge.buildPoolExhaustedEvent("global", 3, 3, at);
assert.equal(event.fallback, "fail-closed-serve");
assert.equal(event.timestamp, at);
} finally {
resetAll();
}
});
test("functional: real set-aside through outcome path emits bus event", async () => {
const prevSkip = process.env.PROXY_SKIP_RECENTLY_FAILED;
process.env.PROXY_SKIP_RECENTLY_FAILED = "true";
try {
const { noteProxyOutcome } = await import("../../src/sse/handlers/proxyOutcomeMemory.ts");
const outcomes: unknown[] = [];
const off = bus.on("proxy.set_aside", (payload) => {
outcomes.push(payload);
});
try {
bridge.registerProxyTransitionBridge();
noteProxyOutcome("opencode-go", {
proxy: "http://user:[email protected]:8080",
upstreamStatus: 429,
});
assert.equal(outcomes.length, 1);
const payload = outcomes[0] as Record<string, unknown>;
assert.equal(payload.reason, "ip_quota_429");
assert.ok(!("streak" in payload), "payload carries no streak (D-OA)");
} finally {
off();
}
} finally {
if (prevSkip === undefined) delete process.env.PROXY_SKIP_RECENTLY_FAILED;
else process.env.PROXY_SKIP_RECENTLY_FAILED = prevSkip;
resetAll();
}
});
test("functional: wildcard webhook receives proxy.set_aside delivery", async () => {
const fs = await import("node:fs");
const os = await import("node:os");
const path = await import("node:path");
const dir = fs.mkdtempSync(path.join(os.tmpdir(), "omni-setaside-"));
const prevDataDir = process.env.DATA_DIR;
process.env.DATA_DIR = dir;
try {
const coreDb = await import("../../src/lib/db/core.ts");
coreDb.resetDbInstance();
const webhooksDb = await import("../../src/lib/db/webhooks.ts");
const created = webhooksDb.createWebhook({
url: "https://hooks.example.com/setaside",
events: ["*"],
});
assert.ok(created.id);
const { dispatchEvent } = await import("../../src/lib/webhookDispatcher.ts");
const { deliverWebhook } = await import("../../src/lib/webhookDispatcher.ts");
void deliverWebhook;
const { fetchWebhookUrl } = await import("../../src/shared/network/webhookFetch.ts");
void fetchWebhookUrl;
await dispatchEvent("proxy.set_aside", {
reason: "ip_quota_429",
setAsideUntil: new Date(5_000_000).toISOString(),
durationMs: 60_000,
egressKeyMasked: "https://u***@ho***le:8080",
timestamp: 5_000_000,
});
const { getDeliveries } = await import("../../src/lib/db/webhookDeliveries.ts");
const deliveries = getDeliveries(created.id, 5);
assert.ok(deliveries.length >= 1, "wildcard webhook got a delivery row");
assert.equal(deliveries[0].event_type, "proxy.set_aside");
} finally {
if (prevDataDir === undefined) delete process.env.DATA_DIR;
else process.env.DATA_DIR = prevDataDir;
const coreDb = await import("../../src/lib/db/core.ts");
coreDb.resetDbInstance();
fs.rmSync(dir, { recursive: true, force: true });
resetAll();
}
});
test("pool-exhausted: two set-aside members emit one event, then silence in the window", () => {
const prevSkip = process.env.PROXY_SKIP_RECENTLY_FAILED;
process.env.PROXY_SKIP_RECENTLY_FAILED = "true";
try {
const received: unknown[] = [];
const off = bus.on("proxy.pool.exhausted", (payload) => {
received.push(payload);
});
try {
const at = 6_000_000;
const keyOf = (row: unknown) => (row as { key: string }).key;
const avoided = (key: string | null) => key === "k1" || key === "k2";
assert.equal(
bridge.maybeEmitPoolExhausted("global", [{ key: "k1" }, { key: "k2" }], keyOf, avoided, at),
true
);
assert.equal(received.length, 1);
assert.equal(
bridge.maybeEmitPoolExhausted(
"global",
[{ key: "k1" }, { key: "k2" }],
keyOf,
avoided,
at + 1_000
),
false
);
assert.equal(received.length, 1);
} finally {
off();
}
} finally {
if (prevSkip === undefined) delete process.env.PROXY_SKIP_RECENTLY_FAILED;
else process.env.PROXY_SKIP_RECENTLY_FAILED = prevSkip;
resetAll();
}
});
test("pool-exhausted: one member still eligible emits nothing", () => {
const prevSkip = process.env.PROXY_SKIP_RECENTLY_FAILED;
process.env.PROXY_SKIP_RECENTLY_FAILED = "true";
try {
const received: unknown[] = [];
const off = bus.on("proxy.pool.exhausted", (payload) => {
received.push(payload);
});
try {
const keyOf = (row: unknown) => (row as { key: string }).key;
const avoided = (key: string | null) => key === "k1";
assert.equal(
bridge.maybeEmitPoolExhausted("global", [{ key: "k1" }, { key: "k2" }], keyOf, avoided),
false
);
assert.equal(received.length, 0);
} finally {
off();
}
} finally {
if (prevSkip === undefined) delete process.env.PROXY_SKIP_RECENTLY_FAILED;
else process.env.PROXY_SKIP_RECENTLY_FAILED = prevSkip;
resetAll();
}
});
test("pool-exhausted: flag off emits nothing even when all are set aside", () => {
process.env.PROXY_SKIP_RECENTLY_FAILED = "false";
try {
const received: unknown[] = [];
const off = bus.on("proxy.pool.exhausted", (payload) => {
received.push(payload);
});
try {
const keyOf = (row: unknown) => (row as { key: string }).key;
const avoided = (_key: string | null) => true;
assert.equal(
bridge.maybeEmitPoolExhausted("global", [{ key: "k1" }, { key: "k2" }], keyOf, avoided),
false
);
assert.equal(received.length, 0);
} finally {
off();
}
} finally {
resetAll();
}
});