axme-spec

AXP protocol specifications, schemas, and compatibility notes.

Canonical concept:

• AXP is the Intent Protocol (durable execution layer).

Status

Track B extraction in progress.

Included in current extraction scope

• Protocol schemas:
  • schemas/protocol/intent.ask.v1.json
  • schemas/protocol/intent.envelope.v1.json
  • schemas/protocol/intent.error.v1.json
  • schemas/protocol/intent.reply.v1.json
  • schemas/protocol/intent.status.v1.json
  • schemas/protocol/message.delivery.v1.json
  • schemas/protocol/message.envelope.v2.json
  • schemas/protocol/message.envelope.v3.json
• Governance docs:
  • docs/public-api-schema-index.md
  • docs/schema-versioning-rules.md
  • docs/protocol-error-status-model.md
  • docs/idempotency-correlation-rules.md
• Public API schemas (core set):
  • schemas/public_api/api.intents.create.request.v1.json
  • schemas/public_api/api.intents.create.response.v1.json
  • schemas/public_api/api.intents.get.response.v1.json
  • schemas/public_api/api.intents.events.list.response.v1.json
  • schemas/public_api/api.intents.resolve.request.v1.json
  • schemas/public_api/api.intents.resolve.response.v1.json
  • schemas/public_api/api.approvals.decision.request.v1.json
  • schemas/public_api/api.approvals.decision.response.v1.json
  • schemas/public_api/api.capabilities.get.response.v1.json
• Public API schemas (inbox set):
  • schemas/public_api/api.inbox.list.response.v1.json
  • schemas/public_api/api.inbox.changes.response.v1.json
  • schemas/public_api/api.inbox.thread.response.v1.json
  • schemas/public_api/api.inbox.reply.request.v1.json
  • schemas/public_api/api.inbox.messages.delete.request.v1.json
  • schemas/public_api/api.inbox.messages.delete.response.v1.json
  • schemas/public_api/api.inbox.delegate.request.v1.json
  • schemas/public_api/api.inbox.decision.request.v1.json
• Public API schemas (webhooks set):
  • schemas/public_api/api.webhooks.events.request.v1.json
  • schemas/public_api/api.webhooks.events.response.v1.json
  • schemas/public_api/api.webhooks.events.replay.response.v1.json
  • schemas/public_api/api.webhooks.subscriptions.upsert.request.v1.json
  • schemas/public_api/api.webhooks.subscriptions.response.v1.json
  • schemas/public_api/api.webhooks.subscriptions.list.response.v1.json
  • schemas/public_api/api.webhooks.subscriptions.delete.response.v1.json
• Public API schemas (users/profile set):
  • schemas/public_api/api.users.register_nick.request.v1.json
  • schemas/public_api/api.users.register_nick.response.v1.json
  • schemas/public_api/api.users.check_nick.response.v1.json
  • schemas/public_api/api.users.rename_nick.request.v1.json
  • schemas/public_api/api.users.rename_nick.response.v1.json
  • schemas/public_api/api.users.profile.get.response.v1.json
  • schemas/public_api/api.users.profile.update.request.v1.json
  • schemas/public_api/api.users.profile.update.response.v1.json
• Public API schemas (invites set):
  • schemas/public_api/api.invites.create.request.v1.json
  • schemas/public_api/api.invites.create.response.v1.json
  • schemas/public_api/api.invites.get.response.v1.json
  • schemas/public_api/api.invites.accept.request.v1.json
  • schemas/public_api/api.invites.accept.response.v1.json
• Public API schemas (media set):
  • schemas/public_api/api.media.create_upload.request.v1.json
  • schemas/public_api/api.media.create_upload.response.v1.json
  • schemas/public_api/api.media.finalize_upload.request.v1.json
  • schemas/public_api/api.media.finalize_upload.response.v1.json
  • schemas/public_api/api.media.get.response.v1.json
• Public API schemas (schemas set):
  • schemas/public_api/api.schemas.upsert.request.v1.json
  • schemas/public_api/api.schemas.upsert.response.v1.json
  • schemas/public_api/api.schemas.get.response.v1.json
• Public API schemas (enterprise access set, Track F phase 1):
  • schemas/public_api/api.organizations.create.request.v1.json
  • schemas/public_api/api.organizations.create.response.v1.json
  • schemas/public_api/api.organizations.get.response.v1.json
  • schemas/public_api/api.organizations.update.request.v1.json
  • schemas/public_api/api.organizations.update.response.v1.json
  • schemas/public_api/api.organizations.workspaces.create.request.v1.json
  • schemas/public_api/api.organizations.workspaces.create.response.v1.json
  • schemas/public_api/api.organizations.workspaces.list.response.v1.json
  • schemas/public_api/api.organizations.workspaces.update.request.v1.json
  • schemas/public_api/api.organizations.workspaces.update.response.v1.json
  • schemas/public_api/api.organizations.members.list.response.v1.json
  • schemas/public_api/api.organizations.members.add.request.v1.json
  • schemas/public_api/api.organizations.members.add.response.v1.json
  • schemas/public_api/api.organizations.members.update.request.v1.json
  • schemas/public_api/api.organizations.members.update.response.v1.json
  • schemas/public_api/api.organizations.members.remove.response.v1.json
  • schemas/public_api/api.access_requests.create.request.v1.json
  • schemas/public_api/api.access_requests.create.response.v1.json
  • schemas/public_api/api.access_requests.list.response.v1.json
  • schemas/public_api/api.access_requests.get.response.v1.json
  • schemas/public_api/api.access_requests.review.request.v1.json
  • schemas/public_api/api.access_requests.review.response.v1.json
• Public API schemas (quota and usage set, Track F phase 1):
  • schemas/public_api/api.quotas.get.response.v1.json
  • schemas/public_api/api.quotas.update.request.v1.json
  • schemas/public_api/api.quotas.update.response.v1.json
  • schemas/public_api/api.usage.summary.get.response.v1.json
  • schemas/public_api/api.usage.timeseries.get.response.v1.json
• Schema validation script, tests, and CI gate

Development

python -m pip install -e ".[dev]"
python scripts/validate_schemas.py
pytest