v1.2.2 - Implementation Ready

☯ HyperContext Standard

Protocol for AI-Compatible Web Pages with Runner Interface

🚀 Build HC Page

Create an HC-compliant page with AI assistance.

✅ Validate Page

Check if your page is HC v1.2.2 compliant.

📚 Learn HC

Understand core concepts and implementation.

🔧 Build Runner

Implement HC-compliant runner or tool.

🆕 What's New in v1.2.2?

Implementation Ready

v1.2.2 is production-ready with complete implementation contracts.

Critical Additions

Runner Interface Contract: Defines exact methods runners must implement
External Module Fetch Rules: Deterministic extraction from external content
Security & Trust Model: Protects against malicious content and credential leakage
Embedded Fallback Template: Works even if external templates unavailable

Clarifications

Lazy Loading: Now optional (pages MAY be single-file or modular)
Token Savings: Expected 60-80% (not guaranteed)
Compliance Levels: Protocol (MUST) / Content (SHOULD) / Discovery (MAY)

What is HyperContext?

HyperContext (HC) is a protocol for creating web pages that AI systems can automatically read, understand, and execute. v1.2.2 adds complete implementation contracts so you can build compliant runners and tools.

Key Benefits

Self-Executing: Runners automatically know what to do
Implementable: Clear interface contract for building tools
Secure: Trust model prevents malicious content
Portable Context: Your context follows you across platforms
Token-Efficient: Expected 60-80% savings with lazy loading

Three Compliance Levels

✅ Protocol Compliance (REQUIRED)

hc-metadata block (JSON, valid)
hc-instructions block (contains HC_BOOTSTRAP)

That's it for protocol compliance.

⭐ Content Compliance (RECOMMENDED)

#hc-human-docs div (human-readable documentation)

💎 Discovery Enhanced (OPTIONAL)

Additional UX features: badge, usage guide, launch buttons, identity widget, welcome banner, footer

🔧 Implementing HC Runners

NEW in v1.2.2: Complete Runner Interface Contract

Required Methods

Method	Purpose	Returns
`resolveIdentity()`	Get user identity via cascade	string \| null
`loadRegistries()`	Load and merge registry stack	Registry[]
`selectArtifacts()`	Choose relevant artifacts	Artifact[]
`executeBootstrap()`	Start without "run this"	void
`fetchModule()`	Safely fetch external content	ModuleContent

Full interface specification embedded in hc-instructions above.

External Module Fetch Rules

When fetching external content, extract in this order:

hc-metadata (if present)
hc-instructions (if present)
#hc-human-docs (if present)
Fallback: <body> text

Security Rules

MUST check trusted_origins before fetching
MUST NOT send credentials to untrusted origins
SHOULD warn user when fetching untrusted content

How to Use HC Pages

Three Execution Paths

Method	How It Works	Reliability
1. Direct URL Share	Paste HC page URL into any AI chat	Medium (depends on agent)
2. Launch Buttons	Click "Launch in Claude/ChatGPT"	High (prefilled prompt)
3. HC Runner	`hc run <url>` or extension	Guaranteed (enforced)

Minimal HC Page Example

This is the smallest possible HC v1.2.2 compliant page:

<!DOCTYPE html>
<html>
<head>
    <script type="application/json" id="hc-metadata">
    {
      "hc_version": "1.2.2",
      "hc_type": "skill",
      "artifact_id": "minimal",
      "version": "1.0.0",
      "title": "Minimal HC",
      "description": "Smallest possible",
      "author": "Example",
      "created": "2026-02-10T00:00:00Z",
      "updated": "2026-02-10T00:00:00Z",
      "tags": ["example"]
    }
    </script>
    
    <script type="text/plain" id="hc-instructions">
## HC_BOOTSTRAP
You are reading an HC page. Say "Hello from minimal HC."
    </script>
</head>
<body>
    <div id="hc-human-docs">
        <h1>Minimal Example</h1>
    </div>
</body>
</html>

☯ HyperContext Standard

🚀 Build HC Page

✅ Validate Page

📚 Learn HC

🔧 Build Runner

🆕 What's New in v1.2.2?

Implementation Ready

Critical Additions

Clarifications

What is HyperContext?

Key Benefits

Three Compliance Levels

✅ Protocol Compliance (REQUIRED)

⭐ Content Compliance (RECOMMENDED)

💎 Discovery Enhanced (OPTIONAL)

🔧 Implementing HC Runners

Required Methods

External Module Fetch Rules

Security Rules

How to Use HC Pages

Three Execution Paths

Minimal HC Page Example

Resources

Documentation

Templates

Tools