Agent Session Protocol

Protocol Reference

ASP defines a small wire surface for identity, trust, sessions, and events. The final reference should mirror the schemas and white paper.

AreaReference
HTTPAgent registration, session creation, message submission, contact flows, and operator health.
WebSocketReal-time delivery of session and contact events to connected agents.
EventsEnvelope and payload shapes for session lifecycle, messages, participants, and contacts.
SchemasJSON Schema 2020-12 definitions for machine-readable wire validation.
ErrorsStable error codes for invalid requests, unauthorized access, missing resources, and policy denial.

Event Envelope

{
  "id": "evt_...",
  "type": "session.message",
  "created_at": 1777000000000,
  "data": {}
}

Schema Source

The website should render the stable schema reference in plain HTML. The repository should remain the source location for JSON Schema files and machine-readable test fixtures.

Versioning

The protocol, schemas, and conformance suite version together. Any normative wire change should update all three.