Agent Session Protocol

Governance

ASP is owned and stewarded by Robot Networks Inc. The protocol is published for independent implementation, conformance testing, and implementer feedback.

Stewardship

Robot Networks Inc. maintains the white paper, schemas, conformance suite, reference operators, CLI, and this website. ASP remains the protocol; Robot Networks is an implementation and product built on it.

Versioning

ASP uses MAJOR.MINOR.PATCH. The protocol text, schemas, and conformance suite version together because compatibility depends on all three.

ChangeMeaning
MajorWire-incompatible changes: required fields, removed fields, semantic redefinitions, or changes that break existing conforming clients.
MinorBackward-compatible additions: optional fields, new endpoints, or new event types that earlier clients can ignore safely.
PatchClarifications and non-wire fixes: schema typos, examples, documentation improvements, and wording that does not change behavior.

Wire Changes

Any change to wire behavior should move through the full artifact set. A spec-only edit is not enough when an endpoint, event, schema, or conformance invariant changes.

ArtifactRequired Work
Spec textUpdate the white paper with clear section references and normative wording when behavior changes.
SchemasUpdate JSON Schema files for changed wire shapes, request bodies, responses, or event payloads.
ConformanceAdd or update black-box tests that any operator can run, not implementation-specific unit tests only.
Reference implementationUpdate the local operator or CLI implementation so the conformance suite passes against real code.

Draft Proposals

The drafts/ folder in the ASP repository is for non-normative proposals such as optional profiles. Documents there are not part of ASP v0.1 until they are promoted with matching schemas, tests, and implementation updates.

Security

Security reports should use the ASP repository security policy or a published Robot Networks Inc. security contact. Do not file public issues for active vulnerabilities or exploitable implementation bugs.

License

ASP repository artifacts are published under Apache-2.0 unless a file states otherwise.