amduat-api/registry/README.md

amduat-api registry (draft)

This directory mirrors the core vendor/amduat/registry/ model for the amduatd HTTP API contract.

Goal

• Keep a stable, machine-readable API contract in-repo.
• Seed that contract into the daemon's single ASL store root at startup.
• Advertise the store-backed contract ref via GET /v1/meta.

The daemon remains thin: the contract bytes are data, and the store-backed ref acts as the version identifier.

Files

• api-contract.schema.md — JSONL manifest schema for API contracts.
• api-contract.jsonl — manifest of published contracts.
• amduatd-api-contract.v1.json — contract bytes (v1).
• amduatd-api-contract.v2.json — draft contract bytes (v2, PEL-only writes).

Receipt note:

• /v1/pel/run accepts optional receipt v1.1 fields (executor fingerprint, run id, limits, logs, determinism, rng seed, signature) and emits receipt_ref when provided.