Event Schema · v1
The published spec for AI agent interaction records.
Every event NuWyre records — every prompt, response, tool call, and system event — conforms to the canonical event-v1 schema. The schema is public, versioned, and open. Adapters that produce events, evaluators that consume them, and the verification CLI that audits them all reference the same JSON Schema artifact.
The spec covers identity (organization, agent, session, model pinning), content (role, content text, content hash, tool calls), forensic chain (sequence number, prev event hash, event hash, Ed25519 ingestion signature), compliance metadata (jurisdiction, retention class, legal hold, consent state, redaction state, PII / PHI detection), and provenance (source adapter, source version, ingestion timestamp).
Document revision 1.1 (additive over v1.0) extends the content sub-schema with audio_ref — a SHA-256-bound reference to any audio attached to a transcript event. Verifiers re-hash the audio file and check it against content.audio_ref.hash to confirm the audio in the bundle is the audio that was on the wire.
Content-Type: application/schema+json.Representative event (audio-binding example)
"schema_version": 1,
"event_id": "01HFA9X7QK5T3W8N2J0R4VZME6",
"identity": {
"organization_id": "00000000-0000-4000-8000-000000000001",
"agent_id": "00000000-0000-4000-8000-000000000010",
"session_id": "00000000-0000-4000-8000-0000000000a1",
"model_id": "gpt-4o-realtime-preview",
"model_version": "2026-04",
"deployment_id": null
},
"content": {
"role": "assistant",
"content": "(audio response — see audio_ref)",
"content_hash": "6f34baca…b032c335c",
"tool_calls": [],
"audio_ref": {
"hash": "6f34baca370c0e69bb146220c7677b9614800887dd8a4cb52218dbbb032c335c",
"storage_path": "audio/6f34baca…b032c335c.wav",
"mime_type": "audio/wav",
"duration_ms": 7613,
"sample_rate": 16000,
"channels": 1
}
},
"forensic": {
"timestamp_iso": "2026-04-22T14:31:07.214Z",
"sequence_number": 42,
"prev_event_hash": "4f2c…e91a",
"event_hash": "8d1b…b03e",
"ingestion_signature": "<Ed25519 base64>"
}
/* compliance + provenance groups omitted for brevity — see canonical artifact for full shape */
}
A human-readable rendering of the schema with worked examples is a future polish item. Until then, the canonical JSON Schema artifact above and the methodology document are the load-bearing references.
Private Beta
Records you can defend.
NuWyre is in private beta with methodology reviewers from healthcare and financial services. If your AI agents are talking to your customers, we'd like to talk to you.