Files
OmniRoute/tests/unit/compression/image-aware-tokens.test.ts
Diego Rodrigues de Sa e Souza fd7e4c10e5 feat(compression): omniglyph engine (context-as-image, Fable 5 direct) — stack + single mode (#6556)
* feat(compression): dependência omniglyph (file:) + smoke de import

* feat(compression): engine omniglyph — contexto-como-imagem com gates fail-closed

* fix(compression): omniglyph adapter fail-open no transform (try/catch)

* feat(compression): registra omniglyph no registry e catálogo (single mode, stackPriority 90)

* feat(compression): modo único omniglyph (async), selecionar o modo é o enable

* feat(compression): plumbing supportsVision + providerTransport até os engines

* feat(compression): estimador de tokens image-aware — modo stacked mantém a saída do omniglyph

* docs(compression): corrige comentário do prefixo base64 no decode PNG (64 chars)

* feat(compression): registra omniglyph nas listas de modo/engine (db, combo, deriveDefaultPlan, mcp)

* feat(dashboard): dedicated OmniGlyph engine screen (context-as-image)

Adds a per-engine detail page at /dashboard/context/omniglyph, alongside the
other compression engines in the sidebar. Four sections: the economics (measured
savings), a REAL before→after (dense text vs the rendered PNG page, not a mockup),
the fail-closed gate flow, and the enable control wired to /api/settings/compression
(preview engine, off by default). Sidebar entry + i18n label across all locales.

* chore(compression): consume published omniglyph@^1.0.0 from the npm registry

Replaces the local file: dependency used during the preview phase — npm ci
now resolves omniglyph from the registry with integrity, unblocking CI.

* fix(compression): satisfy v3.8.47 quality gates for the omniglyph engine

- dependency-allowlist: approve omniglyph (own package, published from
  diegosouzapw/OmniGlyph; supply-chain review done by the maintainer)
- ladder maps (#6533 guard): rank omniglyph 80 (stackPriority 90, runs after
  every text engine) with expectedReductionFactor 0.35 (measured 0.23-0.33)
- drop the two explicit any casts in omniglyph tests (no-explicit-any is
  error-level in tests since #6218)

* chore(compression): rebaseline strategySelector for the omniglyph mode dispatch

+18 lines of cohesive dispatch/type wiring at the existing mode chokepoints
(sync no-op + async single-mode branch + providerTransport on the options
types) — not extractable without hiding the dispatch boundary, mirroring the
prior compression rebaselines. Also drops an unused eslint-disable directive
in image-aware-tokens.test.ts (warning-level red under --max-warnings 0).

* chore(quality): register inherited base tests in stryker tap.testFiles

masked-200-exhaustion-fallback-6427 and headroom-codex-quota-snapshot-6379
arrived via the base merge without their stryker registration —
check:mutation-test-coverage --strict requires covering tests to be listed.

* refactor(compression): keep omniglyph wiring under the complexity gate

- extract the async single-mode resolution to engines/omniglyphSingleMode.ts
  (runCompressionAsync was at complexity 17 after the mode branch; back <=15)
- split OmniglyphContextPageClient into section components (was 161 lines in
  one function; every function now under the 80-line cap)
- complexity baseline 2052->2053: the +1 is inherited base drift (the ratchet
  does not run on fast-path merges — same pattern as the v3.8.44/46
  rebaselines); this PR's own code is measured complexity-net-zero

* chore(quality): register 3 more inherited base tests in stryker tap.testFiles

route-guard-middleware-local-only, combo-diagnostics-trace and
idempotency-fusion-collision arrived via the latest base merge without their
stryker registration (fast-path merges skip check:mutation-test-coverage).

* chore(quality): cognitive-complexity baseline 883->884 (inherited base drift)

check:cognitive-complexity measures 884 identically on the pristine
origin/release/v3.8.47 tip and on this HEAD — the PR itself is
cognitive-net-zero (single-mode resolution extracted to its own module,
page client split into section components). Same inherited-drift pattern
as the v3.8.4x release rebaselines.

---------

Co-authored-by: diegosouzapw <diegosouzapw@devbox.local>
2026-07-08 07:56:44 -03:00

70 lines
2.7 KiB
TypeScript

import { test } from "node:test";
import assert from "node:assert";
import { estimateCompressionTokens } from "../../../open-sse/services/compression/stats.ts";
import { transformAnthropicMessages } from "omniglyph";
const CHARS_PER_TOKEN = 4;
// Corpo Claude denso o bastante para o gate de rentabilidade do omniglyph converter
// (mesmo fixture usado em omniglyph-adapter.test.ts / omniglyph-plumbing.test.ts).
const DENSE =
"X".repeat(500) +
"\n" +
Array.from(
{ length: 400 },
(_, i) => `const row_${i} = compute(${i * 17}, "${"v".repeat(80)}");`
).join("\n");
const DENSE_CLAUDE_BODY = {
model: "claude-fable-5",
max_tokens: 128,
system: DENSE,
messages: [{ role: "user", content: [{ type: "text", text: "oi" }] }],
};
test("estimateCompressionTokens é image-aware: encolhe de verdade numa página omniglyph real", async () => {
const encoded = new TextEncoder().encode(JSON.stringify(DENSE_CLAUDE_BODY));
const result = await transformAnthropicMessages({ body: encoded, model: "claude-fable-5" });
assert.ok(
result.applied,
`omniglyph deveria ter convertido o corpo denso (reason=${result.reason})`
);
const outBody = JSON.parse(new TextDecoder().decode(result.body)) as Record<string, unknown>;
assert.ok(
JSON.stringify(outBody).includes('"type":"image"'),
"saída deveria conter bloco de imagem"
);
const naiveCharEstimate = Math.ceil(JSON.stringify(outBody).length / CHARS_PER_TOKEN);
const imageAwareEstimate = estimateCompressionTokens(outBody);
const originalTextEstimate = estimateCompressionTokens(DENSE_CLAUDE_BODY);
console.log(
`naive-char=${naiveCharEstimate} image-aware=${imageAwareEstimate} original-text=${originalTextEstimate}`
);
// O estimador ciente de imagem deve ser MUITO menor que o char-count ingênuo do
// próprio base64 (prova que o base64 não é contado por char).
assert.ok(
imageAwareEstimate < naiveCharEstimate,
`esperado image-aware (${imageAwareEstimate}) < naive-char (${naiveCharEstimate})`
);
// E deve representar encolhimento real frente ao texto original (não só frente ao
// próprio char-count do PNG).
assert.ok(
imageAwareEstimate < originalTextEstimate,
`esperado image-aware (${imageAwareEstimate}) < original-text (${originalTextEstimate})`
);
});
test("regressão: corpo sem imagem estima o MESMO valor de antes (char-count puro)", () => {
const plainBody = {
model: "claude-sonnet-5",
max_tokens: 128,
system: "prompt curto",
messages: [{ role: "user", content: [{ type: "text", text: "olá, tudo bem?" }] }],
};
const expected = Math.ceil(JSON.stringify(plainBody).length / CHARS_PER_TOKEN);
assert.equal(estimateCompressionTokens(plainBody), expected);
});