[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_108":109},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":46,"_48":49,"_50":51,"_52":53,"_54":-5,"_55":46,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":46,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90},"apiUrl","https://odel.app/api","creator","abduljabbarbxr","moduleId","cornea","@abduljabbarbxr/cornea","displayName","Cornea, deterministic visual inspection","tagline","Deterministic visual inspection for AI agents. Overlap, overflow, contrast, quality.","iconKey","https://avatars.githubusercontent.com/u/60580233?v=4","category","local","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","pricingModel","free","creatorUserId","system:external-import","createdAt",1788582440000,"updatedAt","sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.AbduljabbarBXR%2Fcornea","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",1,"upstreamUpdatedAt",1788538124000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/AbduljabbarBXR/cornea","githubRepoFullName","AbduljabbarBXR/cornea","releaseId","ext-abduljabbarbxr-cornea","version","0.2.2","descriptionMarkdown","# Cornea \n\n**Deterministic visual inspection for AI agents. The eyes a coding agent never had.**\n\nCornea gives a coding agent that builds web pages a real way to *see* them. As a **token-cheap, deterministic structural model** it can reason over exactly, instead of megabytes of screenshots and raw DOM dumped into context.\n\nAn agent doesn't need a *photo* of a page. It needs to know **is my layout broken, and how.** Cornea computes an abstract *visual geometry model* of every element (box, position, z-order, computed styles) and derives inspection conclusions. **overlap, overflow, contrast, quality**. Then exposes them as native tools on **three surfaces**: CLI, MCP, and HTTP API.\n\n> One promise holds everything together: **same input → byte-identical output.** No Chromium, no sub-pixel variance, no server. A single ~1.4 MB binary.\n\n---\n\n## Quick start\n\n```bash\n# Build (Rust 1.98+, edition 2024)\ncargo build --release\n\n# Inspect a file, the simplest way to use Cornea\n./target/release/cornea tests/fixtures/sample-bugs.html 360\n```\n\n> Requires only `cargo`. No browser, no Node, no system dependencies. Builds fine on a phone-class device.\n\n**Or install the `cornea` command from npm (no Rust toolchain needed):**\n\n```bash\nnpm install -g optrex # provides the cornea command\ncornea --help\n```\n\n---\n\n## Visual guide: what Cornea does\n\nTake this page below. It looks fine as source. But it's hiding four layout bugs. Cornea finds every one.\n\n```html\n\n

Card 1

Card 2

Card 3

Left overlap

Right overlap

...

Hard to read on white

\n```\n\nRun it and Cornea reports the damage instantly:\n\n```text\n$ ./target/release/cornea tests/fixtures/sample-bugs.html 360\n\n{\n \"html_file\": \"tests/fixtures/sample-bugs.html\",\n \"viewport_w\": 360.0,\n \"element_count\": 17,\n \"est_tokens\": 1068, // <-- entire page read for ~1k tokens\n \"report\": {\n \"total_elements\": 17,\n \"visible_elements\": 14,\n \"overlaps\": [ ... 7 collisions ... ],\n \"overflows\": [ ... 1 clipped ... ],\n \"contrast\": [ ... 2 AA failures ... ],\n \"quality\": { \"score\": 0.06, \"label\": \"broken\" }\n }\n}\n```\n\nEach finding is precise and actionable:\n\n| Finding | Detail |\n|--------|--------|\n| **Overlap** | `section.row ⇄ div.overlap-right`, area 20000 px². The absolutely-positioned boxes cover the cards |\n| **Overflow** | `div.overflow-bad`: right edge `600` exceeds viewport `360` → clipped |\n| **Contrast** | black on `blue`: ratio `2.44:1`. Fails WCAG AA (needs 4.5) |\n| **Contrast** | `#cccccc` on white: ratio `1.61:1`. Fails WCAG AA |\n\nThat is the value: **hundreds of tokens, not hundreds of kilobytes**, and a deterministic answer the agent can act on and re-verify.\n\n---\n\n## Visual guide: the three surfaces\n\nCornea is **one engine, three doors.** All three returns identical inspection JSON because they funnel through a single shared dispatch.\n\n### 1. CLI. Inspect a file\n\n```bash\ncornea [viewport_width] [viewport_height] [--js]\n```\n\n```text\n$ cornea page.html 360\n{\n \"html_file\": \"page.html\",\n \"viewport_w\": 360.0,\n \"element_count\": 42,\n \"json_bytes\": 8124,\n \"est_tokens\": 2193,\n \"report\": { \"total_elements\": 42, \"visible_elements\": 38, \"overlaps\": [], \"overflows\": [], \"contrast\": [], \"quality\": { \"score\": 1.0, \"label\": \"good\" } }\n}\n```\n\n### 2. MCP. Native agent tools over stdio\n\n```bash\ncornea --serve\n```\n\nAn agent calls `layout.*` tools directly; it passes the page source, or a\nlive URL (see URL capture below), per call:\n\n```json\n→ {\"method\":\"tools/call\",\"params\":{\"name\":\"layout.overlaps\",\n \"arguments\":{\"html\":\"

...\"\n ,\"width\":360}}}\n← {\"id\":1,\"result\":{\"content\":[{\"text\":\"[{\\\"a_sel\\\":\\\"...div \\u21c4 ...div\\\",\\\"area\\\":20000}]\"}]}}\n```\n\n| Tool | Returns |\n|------|---------|\n| `layout.inspect` | Full visual model + report |\n| `layout.overlaps` | Elements whose boxes collide |\n| `layout.overflow` | Clipped / collapsed / off-screen |\n| `layout.contrast` | WCAG AA ratios for text elements |\n| `layout.quality` | 0..1 health score + issue list |\n| `layout.fidelity` | Which CSS features are exact vs approximated |\n\n### 3. HTTP API. Call from anything\n\n```bash\ncornea --serve-http [addr] # default 127.0.0.1:8080\n```\n\n```bash\ncurl -s -X POST http://127.0.0.1:8080/inspect \\\n -H 'Content-Type: application/json' \\\n -d '{\"html\":\"

bady

\",\"width\":360}'\n```\n\n```text\n{\"total_elements\":1,\"contrast\":[{\"selector\":\"...>p\",\"fg\":\"#cccccc\",\"bg\":\"#ffffff\",\n \"ratio\":1.61,\"pass_aa\":false}]}\n```\n\n| Route | Method | Returns |\n|-------|--------|---------|\n| `/inspect` | POST | Full report |\n| `/overlaps` | POST | Collisions |\n| `/overflow` | POST | Clipped / collapsed / off-screen |\n| `/contrast` | POST | WCAG ratios |\n| `/quality` | POST | Health score |\n| `/fidelity` | GET | Engine capabilities |\n| `/health` | GET | Liveness |\n\n---\n\n## Watching a live page (URL capture)\n\nEvery surface accepts a URL where the HTML would go. Cornea fetches the\npage, inlines its external stylesheets and external scripts (relative\nURLs resolved against the page), then inspects what a browser would\nactually show. That is the live coding session loop: run your dev server,\npoint cornea at it, read the layout verdict.\n\n```bash\ncornea http://localhost:3000 390\n```\n\n```json\n{ \"url\": \"http://localhost:3000\", \"width\": 390, \"height\": 844 } // HTTP /inspect\n```\n\n```json\n{ \"method\": \"tools/call\", \"params\": { \"name\": \"layout.quality\",\n \"arguments\": { \"url\": \"http://localhost:3000\", \"width\": 390 } } } // MCP\n```\n\nHonesty around capture:\n\n- Failed fetches leave the original tag in place and record a note, so the\n report warnings still flag what did not load.\n- A positive `height` emulates a fixed viewport (screenshot frame, iframe,\n email) and enables below the fold clipping checks. Default 0 means an\n unbounded scrolling page.\n- Capture is a snapshot in time. Determinism holds engine side: the same\n fetched bytes always produce the same report.\n- Plain HTTP is supported natively. HTTPS pages need a TLS stack, which the\n binary does not carry; capture from a local http dev server or pre inline\n the page with a fetch layer of your own.\n\n---\n\n## Architecture\n\n```\n ┌─────────────────────────────────────┐\n HTML + CSS ──► │ cornea (one binary) │\n │ │\n │ dom.rs html5ever ──► tree │\n │ css.rs