Repository navigation
v1.0.0 — Initial Public Release
🎉 First official release of the Human eXperience Protocol (HXP)
A lightweight, model-agnostic metadata protocol that standardizes how AI systems communicate with humans.
✨ Features
Core Protocol
- JSON Schema v1.0 — Complete schema for validating HXP messages (draft 2020-12)
- Full Specification — RFC-style normative document with MUST/SHOULD/MAY language
- Three Compliance Levels — HXP-Core, HXP-Standard, HXP-Full
💻 CLI Tools
npm install -g human-experience-protocol
hxp validate message.json📐 TypeScript Bindings
npm install @hxp/protocol- Full type definitions for all HXP envelope fields
isHxpMessage()runtime type guard for HXP-Core compliance
📄 Example Envelopes
explain.standard.json— HXP-Standard explanationdebug.standard.json— HXP-Standard debugging with negotiationrefusal.standard.json— HXP-Full refusal with safety metadatabrainstorm.core.json— HXP-Core minimal brainstorm
📦 Installation
From npm
npm install -g human-experience-protocolFrom GitHub Packages
npm config set @caglarorhan:registry https://npm.pkg.github.com
npm install -g @caglarorhan/human-experience-protocol🔗 Links
- GitHub: https://github.com/caglarorhan/Human-eXperience-Protocol
- Specification: SPEC.md
- Schema: schema/hxp.schema.json
📝 License
MIT