Loa Hounfour

@0xhoneyjar/loa-hounfour

[](CHANGELOG.md) [](LICENSE.md) [](SCHEMA-CHANGELOG.md)

Documentation current as of v8.5.2

Constitutional protocol contracts for an AI agent economy. TypeBox schemas with dual JSON Schema 2020-12 output.

What This Is

loa-hounfour is a **constitutional protocol library** for an AI agent economy. It defines the wire format, governance rules, and economic constraints for services coordinating AI agents, gateways, and runtimes. Every TypeBox schema compiles to a standalone JSON Schema 2020-12 file, enabling cross-language validation in Python, Go, Rust, or any JSON Schema-compliant environment.

**What it does**: Typed schemas, runtime validation, cross-field invariant checks, constraint DSL with evaluator builtins, formal conservation properties, governance layer.

**What it does NOT do**: No runtime, no transport, no HTTP server, no model invocation. Schemas and validation only.

Reference consumers include [loa-finn](https://github.com/0xHoneyJar/loa-finn) (runtime) and [loa-freeside](https://github.com/0xHoneyJar/loa-freeside) (gateway). Any service needing typed AI coordination contracts can consume this package independently.

Why

• Schema drift: Without a shared contract, services diverge silently.
• Protocol divergence: Typed schemas catch incompatibilities at build time, not in production.
• Cross-language validation: JSON Schema 2020-12 output works in any language ecosystem.
• Constraint DSL: Formal rules (conservation laws, temporal ordering, state machine transitions) enforced by an evaluator with 36 builtins.

Inventory

Metric	Value	Source
Schema files	234	src/schemas/**/*.ts + src/governance/**/*.ts + others
Module barrels	9