watasu docs

Protocol surfaces

watasu exposes a small set of protocol surfaces. The same concepts appear in local demo, CLI, MCP, and hosted private-alpha runtime.

Request definition

A request definition describes:

  • request name
  • schema version
  • fields and purpose
  • consent text
  • destination policy
  • encryption metadata
  • metadata retention policy
  • trust profile

The sample lives at:

packages/fixtures/requests/event-attendee.yaml

CLI commands

CommandPurpose
validateValidate a request definition
schemaGenerate plaintext payload and encrypted envelope schemas
publish --confirmPublish a local request version
agent-card --confirmGenerate the Agent Card
ledger --confirmShow metadata-only delivery rows
inspect-delivery --confirmShow one delivery attempt
submit-fixture --payload ... --confirmRun a local sender fixture

Local HTTP demo

RoutePurpose
/.well-known/agent-card.jsonAgent Card for the local fixture
/schemas/plaintext.jsonPlaintext payload JSON Schema
/schemas/envelope.jsonEncrypted envelope JSON Schema
POST /submitA2A HTTP+JSON encrypted submission
/ledgerMetadata-only delivery ledger

Hosted private-alpha routes

RoutePurpose
/healthLow-information health check
/.well-known/oauth-protected-resourceMCP protected-resource metadata
/mcpHosted MCP transport, Bearer auth required
/requests/{request_id}/publishAuthenticated publish boundary
/requests/{request_id}/agent-card.jsonPublished request Agent Card
/requests/{request_id}/schemas/plaintext.jsonPublished plaintext payload schema
/requests/{request_id}/schemas/envelope.jsonPublished encrypted envelope schema
/requests/{request_id}/submitPublished encrypted submit route
/requests/{request_id}/ledgerAuthenticated metadata-only ledger read

Compatibility notes

  • MCP is used for service-side agent workflows.
  • A2A HTTP+JSON is used for encrypted submission.
  • Agent Card is the public machine-readable contract.
  • JSON Schema describes both the plaintext payload shape and the encrypted envelope shape.