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
/**
* Gate de estágio × engine sem `metadata`.
*
* `assertValidEngine()` (engines/registry.ts) valida `id`, `apply`, `compress`,
* `getConfigSchema` e `validateConfig` — NÃO exige `metadata`. Uma engine sem
* esse campo é, portanto, um registro legal. Mas `canRunAtCompressionStage`
* lia `engine.metadata.executionStages` sem guarda, então essa engine legal
* derrubava o pipeline inteiro com `TypeError: Cannot read properties of
* undefined` — em vez de falhar aberto, que é o contrato da compressão.
*
* O fallback documentado para quem não declara `executionStages` é "só
* pre-translation". Metadata ausente é o mesmo caso de "não declarou", e tem de
* cair no mesmo fallback.
*/
import { describe, it, beforeEach, afterEach } from "node:test";
import assert from "node:assert/strict";
import {
registerCompressionEngine,
unregisterCompressionEngine,
} from "../../../open-sse/services/compression/engines/registry.ts";
import { applyStackedCompression } from "../../../open-sse/services/compression/strategySelector.ts";
import type { CompressionEngine } from "../../../open-sse/services/compression/engines/types.ts";
const ENGINE_ID = "metadata-less-test-engine";
const body = () => ({ messages: [{ role: "user", content: "hello world" }] });
describe("stage gate — engine sem metadata", () => {
beforeEach(() => {
// Registro deliberadamente sem `metadata`: é o que assertValidEngine aceita.
registerCompressionEngine({
id: ENGINE_ID,
name: "metadata-less test engine",
targets: ["messages"],
stackable: true,
apply(input: Record<string, unknown>) {
return { body: input, compressed: false, stats: null };
},
compress() {
return { text: "", stats: null };
},
getConfigSchema() {
return [];
},
validateConfig() {
return { valid: true, errors: [] };
},
} as unknown as CompressionEngine);
});
afterEach(() => unregisterCompressionEngine(ENGINE_ID));
it("não derruba o pipeline no estágio pré-tradução (default)", () => {
const r = applyStackedCompression(body(), [{ engine: ENGINE_ID }]);
assert.equal(r.compressed, false);
assert.deepEqual(r.body, body());
});
it("não derruba o pipeline no estágio pós-tradução — pula pelo fallback", () => {
const r = applyStackedCompression(body(), [{ engine: ENGINE_ID }], {
compressionStage: "post-translation",
});
assert.equal(r.compressed, false);
assert.deepEqual(r.body, body());
// Fallback documentado: quem não declara estágio só roda pre-translation.
assert.ok(
r.stats?.validationWarnings?.some((w) => w.includes(ENGINE_ID) && w.includes("skipped")),
`esperado aviso de skip por estágio, veio ${JSON.stringify(r.stats?.validationWarnings)}`
);
});
});