Bookable Pattern

Identity

Verifiable existence. Who is this entity, where are they, and can we cryptographically prove they control this record?

{
  "identity": {
    "name": "The Griffin Inn",
    "location": {
      "address": "Beacon Vale, Beaconshire LD3 0UB",
      "coordinates": [51.9634, -3.3842]
    },
    "domain": "griffininn.co.uk",
    "did": "did:web:griffininn.co.uk"
  }
}

Evidence

Proof supporting claims. Every assertion links to sources with confidence scores and verification status. No more "trust me, it's dog-friendly".

{
  "evidence": {
    "dogFriendly": {
      "claim": "Dogs welcome in all areas including restaurant",
      "confidence": 0.95,
      "convergence": "strong",
      "sources": [
        { "type": "human_observation", "sourceRef": "DMO site visit Oct 2024" },
        { "type": "curator_certification", "sourceRef": "Visit Beaconshire credential" }
      ]
    }
  }
}

Fit

Explicit intent alignment. What the entity is good for—and critically, what it's not good for.

{
  "fit": {
    "strong": [
      { "intent": "romantic getaway", "confidence": 0.95 }
    ],
    "weak": [
      { "intent": "family with young children", "reason": "Adult-focused atmosphere" }
    ]
  }
}

Actions

What operations can an agent perform? Check availability, get rates, book, modify, cancel.

{
  "actions": {
    "capabilities": ["check-availability", "get-rates", "book", "modify", "cancel"],
    "endpoint": "https://example.com/api/agent",
    "protocol": "jsonrpc"
  }
}

Presentation

UI components for human confirmation. Agents choose, humans confirm.

{
  "presentation": {
    "components": {
      "summary": { "type": "card", "template": { ... } },
      "gallery": { "type": "image-grid", "template": { ... } }
    },
    "layouts": {
      "detail": ["gallery", "summary"]
    }
  }
}

Answers

Pre-computed responses to common questions, linked to evidence for citation.

{
  "answers": [
    {
      "question": "Is this place dog friendly?",
      "answer": "Yes, dogs welcome in all areas including the restaurant.",
      "confidence": 0.98,
      "basedOn": ["evidence.dogFriendly"]
    }
  ]
}