11# ** BiModal Design**
22
3- > ** A design framework for building interfaces that work across the full AI agent
4- > capability spectrum — from HTTP retrievers to protocol-native agents.**
3+ > ** A design framework for building interfaces that work across the full AI
4+ > agent capability spectrum — from HTTP retrievers to protocol-native agents.**
55
66[ ![ License: Apache 2.0] ( https://img.shields.io/badge/License-Apache%202.0-blue.svg )] ( LICENSE )
77[ ![ Status: Research Framework] ( https://img.shields.io/badge/Status-Research%20Framework-yellow.svg )] ( )
@@ -54,14 +54,14 @@ there.
5454
5555Interfaces today face a spectrum of AI consumers, not a single one:
5656
57- | Agent Level | Example | What They See |
58- | --- | --- | --- |
59- | Level 0 — HTTP Retrievers | curl, web scrapers | Raw HTML only |
60- | Level 1 — LLM Browsers | ChatGPT Browse, Perplexity | Parsed HTML, no JS |
61- | Level 2 — Browser Automation | Playwright agents | Full rendered DOM |
62- | Level 3 — Vision Agents | Claude Computer Use | Screenshots |
63- | Level 4 — Tool-Use Agents | OpenAI function calling | API responses |
64- | Level 5 — Protocol-Native | MCP-connected agents | Protocol data |
57+ | Agent Level | Example | What They See |
58+ | ---------------------------- | -------------------------- | --------------- --- |
59+ | Level 0 — HTTP Retrievers | curl, web scrapers | Raw HTML only |
60+ | Level 1 — LLM Browsers | ChatGPT Browse, Perplexity | Parsed HTML, no JS |
61+ | Level 2 — Browser Automation | Playwright agents | Full rendered DOM |
62+ | Level 3 — Vision Agents | Claude Computer Use | Screenshots |
63+ | Level 4 — Tool-Use Agents | OpenAI function calling | API responses |
64+ | Level 5 — Protocol-Native | MCP-connected agents | Protocol data |
6565
6666A CSR-only app with ` <div id="root"></div> ` is invisible to Levels 0-1, fragile
6767for Levels 2-3, and unreachable for Levels 4-5 without an API. Most interfaces
@@ -141,17 +141,17 @@ node fr1-checker.js https://your-site.com --verbose
141141
142142<!-- Layer 3: Structured data with schema.org -->
143143<script type =" application/ld+json" >
144- {
145- " @context" : " https://schema.org" ,
146- " @type" : " Product" ,
147- " name" : " Wireless Headphones" ,
148- " offers" : {
149- " @type" : " Offer" ,
150- " price" : " 99.99" ,
151- " priceCurrency" : " USD" ,
152- " availability" : " https://schema.org/InStock"
144+ {
145+ " @context" : " https://schema.org" ,
146+ " @type" : " Product" ,
147+ " name" : " Wireless Headphones" ,
148+ " offers" : {
149+ " @type" : " Offer" ,
150+ " price" : " 99.99" ,
151+ " priceCurrency" : " USD" ,
152+ " availability" : " https://schema.org/InStock"
153+ }
153154 }
154- }
155155 </script >
156156
157157<!-- Layer 4: API documented via OpenAPI -->
@@ -171,11 +171,11 @@ response. This is Layer 1 of defense in depth — the floor, not the ceiling.
171171
172172v3.0 migrates from custom ` data-agent-* ` attributes to established standards:
173173
174- | v2.x | v3.0 |
175- | --- | --- |
174+ | v2.x | v3.0 |
175+ | ------------------------------ | -------------------------------------- --- |
176176| ` data-agent-context="product" ` | ` itemscope itemtype="schema.org/Product" ` |
177- | ` data-agent-action="buy" ` | ` aria-label="Add to cart" ` |
178- | ` data-agent-field="price" ` | ` itemprop="price" ` |
177+ | ` data-agent-action="buy" ` | ` aria-label="Add to cart" ` |
178+ | ` data-agent-field="price" ` | ` itemprop="price" ` |
179179
180180### Agent Protocols
181181
@@ -195,13 +195,13 @@ AI-assisted discoverability.
195195
196196## Documentation
197197
198- | Document | Description |
199- | --- | --- |
200- | [ White Paper] ( docs/whitepaper.md ) | Framework specification v3.0 |
201- | [ Implementation Guide] ( docs/implementation-guide.md ) | Development & deployment practices |
202- | [ Compliance Checklist] ( docs/compliance-checklist.md ) | Layer-by-layer compliance criteria |
203- | [ API Reference] ( docs/api-reference.md ) | Tool and validator API documentation |
204- | [ Troubleshooting] ( docs/troubleshooting.md ) | Common errors and corrections |
198+ | Document | Description |
199+ | ---------------------------------------------------- | --------------------------------- --- |
200+ | [ White Paper] ( docs/whitepaper.md ) | Framework specification v3.0 |
201+ | [ Implementation Guide] ( docs/implementation-guide.md ) | Development & deployment practices |
202+ | [ Compliance Checklist] ( docs/compliance-checklist.md ) | Layer-by-layer compliance criteria |
203+ | [ API Reference] ( docs/api-reference.md ) | Tool and validator API documentation |
204+ | [ Troubleshooting] ( docs/troubleshooting.md ) | Common errors and corrections |
205205
206206---
207207
@@ -225,13 +225,13 @@ AI-assisted discoverability.
225225
226226## Maturity Levels
227227
228- | Level | Name | Layers | Agent Coverage | Success Rate |
229- | --- | --- | --- | --- | --- |
230- | 0 | Infrastructure Ready | Layer 1 | Level 0-1 | 40-65% |
231- | 1 | Semantically Accessible | Layers 1-2 | Level 0-2 | 55-75% |
232- | 2 | Data-Rich | Layers 1-3 | Level 0-3 | 65-85% |
233- | 3 | API-Enabled | Layers 1-4 | Level 0-4 | 80-92% |
234- | 4 | Agent-Native | Layers 1-5 | All levels | 90-98% |
228+ | Level | Name | Layers | Agent Coverage | Success Rate |
229+ | ----- | ----------------------- | ---------- | -------------- | --------- --- |
230+ | 0 | Infrastructure Ready | Layer 1 | Level 0-1 | 40-65% |
231+ | 1 | Semantically Accessible | Layers 1-2 | Level 0-2 | 55-75% |
232+ | 2 | Data-Rich | Layers 1-3 | Level 0-3 | 65-85% |
233+ | 3 | API-Enabled | Layers 1-4 | Level 0-4 | 80-92% |
234+ | 4 | Agent-Native | Layers 1-5 | All levels | 90-98% |
235235
236236---
237237
@@ -282,15 +282,13 @@ npm test
282282
283283## License
284284
285- Licensed under the Apache License 2.0.
286- See [ LICENSE] ( LICENSE ) for full details.
285+ Licensed under the Apache License 2.0. See [ LICENSE] ( LICENSE ) for full details.
287286
288287---
289288
290289## Author
291290
292- ** Joel Goldfoot**
293- Design Leader | AI + Human-Agent Interaction Researcher
291+ ** Joel Goldfoot** Design Leader | AI + Human-Agent Interaction Researcher
294292
295293[ joel@goldfoot.com ] ( mailto:joel@goldfoot.com )
296294[ linkedin.com/in/joelgoldfoot] ( https://linkedin.com/in/joelgoldfoot )
0 commit comments