Agent Revision Markup
Reference

Manifest

Parties, keys, documents, anchors.

The manifest states who may act in this session. Stated, not certified: a key listed here can be verified, an identity name cannot.

FieldTypeWhat it is
schemaVersionintegerWire schema version. Currently 2.
sessionIdstringNames this negotiation session.
createdAtstringISO 8601 timestamp.
updatedAt ·stringLast manifest change.
ontologyRefsarrayThe shared topic lists turns may reference.
partiesarrayWho is at the table.
documentsarrayThe documents in play.
anchorsarrayNamed places in those documents where turns apply.

Adding a party

A party is an organization at the table, with the public keys that verify its work.

FieldTypeWhat it is
partyIdstringStable id other objects reference, like acme.
displayNamestringThe name humans see.
organization ·stringLonger organization name.
signingKeysarrayPublic keys for this party.

Each signing key carries keyId, algorithm (ed25519), and a public key as JWK or PEM. Set turnsRequireHumanApproval: true on an agent's key, and every turn signed by it must carry a verified human approval - that rule is enforced by verifiers, not by promises.

{
  "partyId": "northwind",
  "displayName": "Northwind",
  "signingKeys": [
    { "keyId": "northwind-agent-key-1", "algorithm": "ed25519",
      "turnsRequireHumanApproval": true, "publicKeyJwk": { "kty": "OKP", "crv": "Ed25519", "x": "..." } }
  ]
}

Anchors

An anchor names a place where turns apply, so the record survives even if native Word ids do not.

FieldTypeWhat it is
anchorIdstringStable id turns reference.
documentIdstringWhich document it lives in.
clauseTopicstringThe topic this place is about, from ontologyRefs.
displayName ·stringHuman label, like "Liability cap".

On this page