Examples

Examples

Example UAI-1 request, response, capability, error, conformance, and task-status records that connect the specification, schemas, registry, and validator.

  • Record UAIX-EXAM-0052
  • Path /en-us/examples/
  • Use Canonical public record

Document status

Public standards page Published on UAIX as part of the current public standards record
Code
UAIX-EXAM-0052
Surface
Examples
Access
Public and linkable

How to use this page

Use this page for example messages you can compare against your own implementation and validator results.

Why examples matter

Examples turn UAI-1 from a written contract into something teams can compare against running code. The current fixture set shows how the shared envelope, typed bodies, field-order governance, and validator evidence work together in real records.

What the current fixture set covers

  • uai.intent.request.v1 for an explicit request entering the public contract.
  • uai.intent.response.v1 for a synchronous result or accepted async handoff.
  • uai.capability.statement.v1 for discovery-facing capability publication.
  • uai.error.v1 for typed failure handling.
  • uai.conformance.result.v1 for validator-backed evidence.
  • uai.task.status.v1 for async progress, blocking reasons, and completion signals.

How fixtures connect to the rest of the record

  • Each example should map back to a concrete UAI-1 behavior.
  • Each fixture should satisfy the matching schema and published registry entry.
  • Each keyless transport view should remain aligned with the keyed source record through the field registry.
  • The same fixture should be usable as a regression baseline in the Validator.

How implementers should use examples

  1. Start from the closest current fixture before inventing your own envelope variant.
  2. Keep readable keyed JSON as the reviewable source record, then derive compact transport from the published field order.
  3. Use request, response, error, and task-status fixtures together when your workflow can cross sync and async boundaries.
  4. Keep the validator result with the fixture whenever the example becomes release evidence.

Published example catalog

The examples below are version-controlled public fixtures used by the validator and linked from the registry.

Examples and fixtures

Published UAI-1 message examples

These examples are version-controlled fixtures for onboarding, interoperability checks, and validator regression tests. Each keyed JSON record is paired with the profile it exercises.

UAI-REGI-0001

UAI Intent Request v1

Request an explicit outcome or async task against a declared subject using the full UAI-1 envelope, trust metadata, and reviewable delivery controls.

Profile
uai.intent.request.v1
Outcome
PASS
REST route
/wp-json/uaix/v1/examples/uai.intent.request.v1
Readable fixture Keyed JSON uai.intent.request.v1-keyed.json
{
    "uai_version": "1.0",
    "profile": "uai.intent.request.v1",
    "message_id": "msg-2026-04-22-0001",
    "source": {
        "type": "agent",
        "id": "agent.alpha",
        "label": "Agent Alpha",
        "uri": "https://agents.alpha.example/runtime",
        "did": "did:web:agents.alpha.example",
        "role": "requesting-agent",
        "implementation": "alpha-runtime-2.4.1"
    },
    "target": {
        "type": "service",
        "id": "uaix.gateway",
        "label": "UAIX Gateway",
        "uri": "https://uaix.org/wp-json/uaix/v1/discovery",
        "did": "did:web:uaix.org",
        "role": "public-record-gateway",
        "implementation": "uaix-core-0.4.0"
    },
    "conversation": {
        "conversation_id": "conv-2026-04-22-uaix-001",
        "turn_id": "turn-001",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
        "sequence": 1
    },
    "delivery": {
        "mode": "async",
        "priority": "interactive",
        "expires_at": "2026-04-22T16:05:00Z",
        "reply_requested": true,
        "ack_required": true
    },
    "trust": {
        "channel": "credentialed",
        "auth_scheme": "did+vc",
        "principal": "did:web:agents.alpha.example",
        "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json",
        "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
        "replay_window_id": "rw-2026-04-22-0001"
    },
    "body": {
        "intent": "resolve-profile",
        "subject": "uai.task.status.v1",
        "requested_profile": "uai.task.status.v1",
        "parameters": {
            "include_schema": true,
            "include_example": true,
            "include_field_registry": true
        },
        "constraints": [
            "public-record-only",
            "trace-linked",
            "validator-ready"
        ],
        "response_profile": "uai.intent.response.v1"
    },
    "provenance": {
        "trace_id": "trace-7f3a2d",
        "parent_trace_id": "trace-root-uaix-2026",
        "issued_at": "2026-04-22T16:00:00Z",
        "log_ref": "urn:uaix:log:2026:0001",
        "agent_id": "agent.alpha",
        "model_id": "model.alpha.reasoner-2",
        "confidence": 0.98,
        "lineage": [
            {
                "stage": "request-composition",
                "actor_id": "agent.alpha",
                "model_id": "model.alpha.reasoner-2",
                "note": "Requested the async task-status profile and matching field registry."
            }
        ]
    },
    "integrity": {
        "version": 2,
        "algorithm": "sha256",
        "canonicalization": "jcs",
        "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
    },
    "extensions": [
        {
            "namespace": "urn:uaix:ext:delivery",
            "purpose": "Explicit async request handling and expiry semantics.",
            "critical": false
        }
    ]
}
Transfer format Optimized (Keyless) JSON uai.intent.request.v1-keyless.json
[
    "1.0",
    "uai.intent.request.v1",
    "msg-2026-04-22-0001",
    [
        "agent",
        "agent.alpha",
        "Agent Alpha",
        "https://agents.alpha.example/runtime",
        "did:web:agents.alpha.example",
        "requesting-agent",
        "alpha-runtime-2.4.1"
    ],
    [
        "service",
        "uaix.gateway",
        "UAIX Gateway",
        "https://uaix.org/wp-json/uaix/v1/discovery",
        "did:web:uaix.org",
        "public-record-gateway",
        "uaix-core-0.4.0"
    ],
    [
        "conv-2026-04-22-uaix-001",
        "turn-001",
        null,
        "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
        1
    ],
    [
        "async",
        "interactive",
        "2026-04-22T16:05:00Z",
        true,
        true
    ],
    [
        "credentialed",
        "did+vc",
        "did:web:agents.alpha.example",
        "https://agents.alpha.example/credentials/uai-interop.json",
        "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
        "rw-2026-04-22-0001"
    ],
    [
        "resolve-profile",
        "uai.task.status.v1",
        "uai.task.status.v1",
        {
            "include_schema": true,
            "include_example": true,
            "include_field_registry": true
        },
        [
            "public-record-only",
            "trace-linked",
            "validator-ready"
        ],
        "uai.intent.response.v1"
    ],
    [
        "trace-7f3a2d",
        "trace-root-uaix-2026",
        "2026-04-22T16:00:00Z",
        "urn:uaix:log:2026:0001",
        "agent.alpha",
        "model.alpha.reasoner-2",
        0.98,
        [
            [
                "request-composition",
                "agent.alpha",
                "model.alpha.reasoner-2",
                "Requested the async task-status profile and matching field registry."
            ]
        ]
    ],
    [
        2,
        "sha256",
        "jcs",
        "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
    ],
    [
        [
            "urn:uaix:ext:delivery",
            "Explicit async request handling and expiry semantics.",
            false
        ]
    ]
]

Field order follows the keyed JSON example, the published schema order, and the public field registry.

UAI-REGI-0002

UAI Intent Response v1

Return a direct result or accepted-task handoff for a declared request while preserving conversation continuity, trust metadata, and release-ready evidence.

Profile
uai.intent.response.v1
Outcome
PASS
REST route
/wp-json/uaix/v1/examples/uai.intent.response.v1
Readable fixture Keyed JSON uai.intent.response.v1-keyed.json
{
    "uai_version": "1.0",
    "profile": "uai.intent.response.v1",
    "message_id": "msg-2026-04-22-0002",
    "source": {
        "type": "service",
        "id": "uaix.gateway",
        "label": "UAIX Gateway",
        "uri": "https://uaix.org/wp-json/uaix/v1/discovery",
        "did": "did:web:uaix.org",
        "role": "public-record-gateway",
        "implementation": "uaix-core-0.4.0"
    },
    "target": {
        "type": "agent",
        "id": "agent.alpha",
        "label": "Agent Alpha",
        "uri": "https://agents.alpha.example/runtime",
        "did": "did:web:agents.alpha.example",
        "role": "requesting-agent",
        "implementation": "alpha-runtime-2.4.1"
    },
    "conversation": {
        "conversation_id": "conv-2026-04-22-uaix-001",
        "turn_id": "turn-002",
        "parent_message_id": "msg-2026-04-22-0001",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-3e5f4f6f98c36d91-01",
        "sequence": 2
    },
    "delivery": {
        "mode": "async",
        "priority": "interactive",
        "expires_at": "2026-04-22T16:05:00Z",
        "reply_requested": false,
        "ack_required": true,
        "task_ref": "task-2026-04-22-0001"
    },
    "trust": {
        "channel": "signed-envelope",
        "auth_scheme": "jws",
        "principal": "did:web:uaix.org",
        "credential_ref": "https://uaix.org/.well-known/uai.json",
        "signature_ref": "https://uaix.org/signatures/msg-2026-04-22-0002.jws",
        "replay_window_id": "rw-2026-04-22-0002"
    },
    "body": {
        "status": "accepted",
        "subject": "uai.task.status.v1",
        "request_message_id": "msg-2026-04-22-0001",
        "result": {
            "task_id": "task-2026-04-22-0001",
            "status_profile": "uai.task.status.v1",
            "status_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.task.status.v1",
            "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry"
        },
        "notices": [
            "async-task-started",
            "follow-status-profile"
        ],
        "task_ref": "task-2026-04-22-0001"
    },
    "provenance": {
        "trace_id": "trace-7f3a2d",
        "parent_trace_id": "trace-root-uaix-2026",
        "issued_at": "2026-04-22T16:00:03Z",
        "log_ref": "urn:uaix:log:2026:0002",
        "agent_id": "uaix.gateway",
        "model_id": "model.uaix.dispatch-1",
        "confidence": 0.99,
        "lineage": [
            {
                "stage": "request-routing",
                "actor_id": "uaix.gateway",
                "model_id": "model.uaix.dispatch-1",
                "note": "Accepted the request and created an async status record."
            }
        ]
    },
    "integrity": {
        "version": 2,
        "algorithm": "sha256",
        "canonicalization": "jcs",
        "checksum": "sha256:45eaaf9d6225e9ba3ac7d45d742ac1f6f7cf6dfc"
    },
    "extensions": [
        {
            "namespace": "urn:uaix:ext:delivery",
            "purpose": "Async handoff and task reference support.",
            "critical": false
        }
    ]
}
Transfer format Optimized (Keyless) JSON uai.intent.response.v1-keyless.json
[
    "1.0",
    "uai.intent.response.v1",
    "msg-2026-04-22-0002",
    [
        "service",
        "uaix.gateway",
        "UAIX Gateway",
        "https://uaix.org/wp-json/uaix/v1/discovery",
        "did:web:uaix.org",
        "public-record-gateway",
        "uaix-core-0.4.0"
    ],
    [
        "agent",
        "agent.alpha",
        "Agent Alpha",
        "https://agents.alpha.example/runtime",
        "did:web:agents.alpha.example",
        "requesting-agent",
        "alpha-runtime-2.4.1"
    ],
    [
        "conv-2026-04-22-uaix-001",
        "turn-002",
        "msg-2026-04-22-0001",
        "00-4bf92f3577b34da6a3ce929d0e0e4736-3e5f4f6f98c36d91-01",
        2
    ],
    [
        "async",
        "interactive",
        "2026-04-22T16:05:00Z",
        false,
        true,
        "task-2026-04-22-0001"
    ],
    [
        "signed-envelope",
        "jws",
        "did:web:uaix.org",
        "https://uaix.org/.well-known/uai.json",
        "https://uaix.org/signatures/msg-2026-04-22-0002.jws",
        "rw-2026-04-22-0002"
    ],
    [
        "accepted",
        "uai.task.status.v1",
        "msg-2026-04-22-0001",
        {
            "task_id": "task-2026-04-22-0001",
            "status_profile": "uai.task.status.v1",
            "status_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.task.status.v1",
            "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry"
        },
        [
            "async-task-started",
            "follow-status-profile"
        ],
        "task-2026-04-22-0001"
    ],
    [
        "trace-7f3a2d",
        "trace-root-uaix-2026",
        "2026-04-22T16:00:03Z",
        "urn:uaix:log:2026:0002",
        "uaix.gateway",
        "model.uaix.dispatch-1",
        0.99,
        [
            [
                "request-routing",
                "uaix.gateway",
                "model.uaix.dispatch-1",
                "Accepted the request and created an async status record."
            ]
        ]
    ],
    [
        2,
        "sha256",
        "jcs",
        "sha256:45eaaf9d6225e9ba3ac7d45d742ac1f6f7cf6dfc"
    ],
    [
        [
            "urn:uaix:ext:delivery",
            "Async handoff and task reference support.",
            false
        ]
    ]
]

Field order follows the keyed JSON example, the published schema order, and the public field registry.

UAI-REGI-0003

UAI Capability Statement v1

Publish capability, endpoint, security, async workflow, and extension-support metadata so adjacent systems can resolve what an implementation actually supports.

Profile
uai.capability.statement.v1
Outcome
PASS
REST route
/wp-json/uaix/v1/examples/uai.capability.statement.v1
Readable fixture Keyed JSON uai.capability.statement.v1-keyed.json
{
    "uai_version": "1.0",
    "profile": "uai.capability.statement.v1",
    "message_id": "msg-2026-04-22-0003",
    "source": {
        "type": "service",
        "id": "uaix.gateway",
        "label": "UAIX Gateway",
        "uri": "https://uaix.org/wp-json/uaix/v1/discovery",
        "did": "did:web:uaix.org",
        "role": "capability-publisher",
        "implementation": "uaix-core-0.4.0"
    },
    "target": {
        "type": "public-record",
        "id": "uaix.registry",
        "label": "UAIX Registry",
        "uri": "https://uaix.org/en-us/registry/",
        "did": "did:web:uaix.org",
        "role": "public-standards-record",
        "implementation": "uaix-authority-theme-2.1.0"
    },
    "conversation": {
        "conversation_id": "conv-2026-04-22-uaix-capability-001",
        "turn_id": "turn-001",
        "sequence": 1
    },
    "delivery": {
        "mode": "event",
        "priority": "routine",
        "expires_at": "2026-05-22T00:00:00Z",
        "reply_requested": false,
        "ack_required": false
    },
    "trust": {
        "channel": "signed-envelope",
        "auth_scheme": "jws",
        "principal": "did:web:uaix.org",
        "credential_ref": "https://uaix.org/.well-known/uai.json",
        "signature_ref": "https://uaix.org/signatures/msg-2026-04-22-0003.jws",
        "replay_window_id": "rw-2026-04-22-0003"
    },
    "body": {
        "capability_id": "uaix.gateway.discovery",
        "version": "1.1.0",
        "operations": [
            "resolve-profile",
            "publish-capability",
            "validate-message"
        ],
        "input_profiles": [
            "uai.intent.request.v1",
            "uai.capability.statement.v1"
        ],
        "output_profiles": [
            "uai.intent.response.v1",
            "uai.error.v1",
            "uai.conformance.result.v1"
        ],
        "async_profiles": [
            "uai.task.status.v1"
        ],
        "security_schemes": [
            {
                "id": "did-vc",
                "type": "credentialed",
                "binding": "did+vc over HTTPS"
            },
            {
                "id": "jws-envelope",
                "type": "signed-envelope",
                "binding": "detached JWS reference"
            }
        ],
        "transport_bindings": [
            "https-json-envelope.v1",
            "https-json-keyless.v1"
        ],
        "conformance_levels": [
            "L1-core-envelope",
            "L2-exchange-participant",
            "L3-async-workflow",
            "L4-public-record-publisher"
        ],
        "error_codes": [
            "invalid_message",
            "unknown_profile",
            "auth_required",
            "task_not_found",
            "conformance_failed"
        ],
        "endpoints": [
            {
                "kind": "discovery",
                "url": "https://uaix.org/wp-json/uaix/v1/discovery",
                "method": "GET"
            },
            {
                "kind": "validate",
                "url": "https://uaix.org/wp-json/uaix/v1/validate",
                "method": "POST"
            },
            {
                "kind": "field-registry",
                "url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                "method": "GET"
            },
            {
                "kind": "transport-bindings",
                "url": "https://uaix.org/wp-json/uaix/v1/transport-bindings",
                "method": "GET"
            },
            {
                "kind": "trust-channels",
                "url": "https://uaix.org/wp-json/uaix/v1/trust-channels",
                "method": "GET"
            },
            {
                "kind": "conformance-levels",
                "url": "https://uaix.org/wp-json/uaix/v1/conformance-levels",
                "method": "GET"
            },
            {
                "kind": "error-registry",
                "url": "https://uaix.org/wp-json/uaix/v1/error-registry",
                "method": "GET"
            }
        ],
        "extension_namespaces": [
            "urn:uaix:ext:delivery",
            "urn:uaix:ext:evidence"
        ],
        "implementation_tracks": [
            "WordPress Publication Track",
            ".NET Bridge Track"
        ]
    },
    "provenance": {
        "trace_id": "trace-7f3a2d",
        "issued_at": "2026-04-22T16:00:07Z",
        "log_ref": "urn:uaix:log:2026:0003",
        "agent_id": "uaix.gateway",
        "model_id": "model.uaix.discovery-1",
        "confidence": 1,
        "lineage": [
            {
                "stage": "capability-publication",
                "actor_id": "uaix.gateway",
                "model_id": "model.uaix.discovery-1",
                "note": "Published current discovery, validation, transport, trust, conformance, and field-registry surfaces."
            }
        ]
    },
    "integrity": {
        "version": 2,
        "algorithm": "sha256",
        "canonicalization": "jcs",
        "checksum": "sha256:72bb178efc2221fb5c9d50bcb1fdab37d4ca2f4d"
    },
    "extensions": [
        {
            "namespace": "urn:uaix:ext:evidence",
            "purpose": "Links machine-readable capability claims to public implementation evidence.",
            "critical": false
        }
    ]
}
Transfer format Optimized (Keyless) JSON uai.capability.statement.v1-keyless.json
[
    "1.0",
    "uai.capability.statement.v1",
    "msg-2026-04-22-0003",
    [
        "service",
        "uaix.gateway",
        "UAIX Gateway",
        "https://uaix.org/wp-json/uaix/v1/discovery",
        "did:web:uaix.org",
        "capability-publisher",
        "uaix-core-0.4.0"
    ],
    [
        "public-record",
        "uaix.registry",
        "UAIX Registry",
        "https://uaix.org/en-us/registry/",
        "did:web:uaix.org",
        "public-standards-record",
        "uaix-authority-theme-2.1.0"
    ],
    [
        "conv-2026-04-22-uaix-capability-001",
        "turn-001",
        null,
        null,
        1
    ],
    [
        "event",
        "routine",
        "2026-05-22T00:00:00Z",
        false,
        false
    ],
    [
        "signed-envelope",
        "jws",
        "did:web:uaix.org",
        "https://uaix.org/.well-known/uai.json",
        "https://uaix.org/signatures/msg-2026-04-22-0003.jws",
        "rw-2026-04-22-0003"
    ],
    [
        "uaix.gateway.discovery",
        "1.1.0",
        [
            "resolve-profile",
            "publish-capability",
            "validate-message"
        ],
        [
            "uai.intent.request.v1",
            "uai.capability.statement.v1"
        ],
        [
            "uai.intent.response.v1",
            "uai.error.v1",
            "uai.conformance.result.v1"
        ],
        [
            "uai.task.status.v1"
        ],
        [
            {
                "id": "did-vc",
                "type": "credentialed",
                "binding": "did+vc over HTTPS"
            },
            {
                "id": "jws-envelope",
                "type": "signed-envelope",
                "binding": "detached JWS reference"
            }
        ],
        [
            "https-json-envelope.v1",
            "https-json-keyless.v1"
        ],
        [
            "L1-core-envelope",
            "L2-exchange-participant",
            "L3-async-workflow",
            "L4-public-record-publisher"
        ],
        [
            "invalid_message",
            "unknown_profile",
            "auth_required",
            "task_not_found",
            "conformance_failed"
        ],
        [
            {
                "kind": "discovery",
                "url": "https://uaix.org/wp-json/uaix/v1/discovery",
                "method": "GET"
            },
            {
                "kind": "validate",
                "url": "https://uaix.org/wp-json/uaix/v1/validate",
                "method": "POST"
            },
            {
                "kind": "field-registry",
                "url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                "method": "GET"
            },
            {
                "kind": "transport-bindings",
                "url": "https://uaix.org/wp-json/uaix/v1/transport-bindings",
                "method": "GET"
            },
            {
                "kind": "trust-channels",
                "url": "https://uaix.org/wp-json/uaix/v1/trust-channels",
                "method": "GET"
            },
            {
                "kind": "conformance-levels",
                "url": "https://uaix.org/wp-json/uaix/v1/conformance-levels",
                "method": "GET"
            },
            {
                "kind": "error-registry",
                "url": "https://uaix.org/wp-json/uaix/v1/error-registry",
                "method": "GET"
            }
        ],
        [
            "urn:uaix:ext:delivery",
            "urn:uaix:ext:evidence"
        ],
        [
            "WordPress Publication Track",
            ".NET Bridge Track"
        ]
    ],
    [
        "trace-7f3a2d",
        null,
        "2026-04-22T16:00:07Z",
        "urn:uaix:log:2026:0003",
        "uaix.gateway",
        "model.uaix.discovery-1",
        1,
        [
            [
                "capability-publication",
                "uaix.gateway",
                "model.uaix.discovery-1",
                "Published current discovery, validation, transport, trust, conformance, and field-registry surfaces."
            ]
        ]
    ],
    [
        2,
        "sha256",
        "jcs",
        "sha256:72bb178efc2221fb5c9d50bcb1fdab37d4ca2f4d"
    ],
    [
        [
            "urn:uaix:ext:evidence",
            "Links machine-readable capability claims to public implementation evidence.",
            false
        ]
    ]
]

Field order follows the keyed JSON example, the published schema order, and the public field registry.

UAI-REGI-0004

UAI Error v1

Report validation, transport, authorization, or execution failures using a typed problem-details-style envelope with retry and path-level detail.

Profile
uai.error.v1
Outcome
PASS
REST route
/wp-json/uaix/v1/examples/uai.error.v1
Readable fixture Keyed JSON uai.error_.v1-keyed.json
{
    "uai_version": "1.0",
    "profile": "uai.error.v1",
    "message_id": "msg-2026-04-22-0004",
    "source": {
        "type": "service",
        "id": "uaix.validator",
        "label": "UAIX Validator",
        "uri": "https://uaix.org/en-us/tools/validator/",
        "did": "did:web:uaix.org",
        "role": "conformance-checker",
        "implementation": "uaix-core-0.4.0"
    },
    "target": {
        "type": "agent",
        "id": "agent.alpha",
        "label": "Agent Alpha",
        "uri": "https://agents.alpha.example/runtime",
        "did": "did:web:agents.alpha.example",
        "role": "requesting-agent",
        "implementation": "alpha-runtime-2.4.1"
    },
    "conversation": {
        "conversation_id": "conv-2026-04-22-uaix-001",
        "turn_id": "turn-003",
        "parent_message_id": "msg-2026-04-22-0001",
        "sequence": 3
    },
    "delivery": {
        "mode": "sync",
        "priority": "interactive",
        "expires_at": "2026-04-22T16:05:00Z",
        "reply_requested": false,
        "ack_required": false
    },
    "trust": {
        "channel": "signed-envelope",
        "auth_scheme": "jws",
        "principal": "did:web:uaix.org",
        "credential_ref": "https://uaix.org/.well-known/uai.json",
        "signature_ref": "https://uaix.org/signatures/msg-2026-04-22-0004.jws",
        "replay_window_id": "rw-2026-04-22-0004"
    },
    "body": {
        "type": "https://uaix.org/problems/unknown-profile",
        "title": "Unknown public profile",
        "detail": "The declared profile is not present in the published UAI-1 registry.",
        "status": 404,
        "code": "unknown_profile",
        "retryable": false,
        "instance": "https://uaix.org/errors/msg-2026-04-22-0004",
        "errors": [
            {
                "path": "$.profile",
                "code": "unknown_profile",
                "message": "Use a published UAI-1 profile from the registry."
            }
        ],
        "next_step": "Resolve the current registry entry before retrying validation."
    },
    "provenance": {
        "trace_id": "trace-7f3a2d",
        "parent_trace_id": "trace-root-uaix-2026",
        "issued_at": "2026-04-22T16:00:11Z",
        "log_ref": "urn:uaix:log:2026:0004",
        "agent_id": "uaix.validator",
        "model_id": "model.uaix.validator-1",
        "confidence": 1,
        "lineage": [
            {
                "stage": "validation-failure",
                "actor_id": "uaix.validator",
                "model_id": "model.uaix.validator-1",
                "note": "Rejected an unpublished profile identifier."
            }
        ]
    },
    "integrity": {
        "version": 2,
        "algorithm": "sha256",
        "canonicalization": "jcs",
        "checksum": "sha256:3f9a1f0c7a23a4921af647e7dbf52aeed8f2f11f"
    },
    "extensions": []
}
Transfer format Optimized (Keyless) JSON uai.error_.v1-keyless.json
[
    "1.0",
    "uai.error.v1",
    "msg-2026-04-22-0004",
    [
        "service",
        "uaix.validator",
        "UAIX Validator",
        "https://uaix.org/en-us/tools/validator/",
        "did:web:uaix.org",
        "conformance-checker",
        "uaix-core-0.4.0"
    ],
    [
        "agent",
        "agent.alpha",
        "Agent Alpha",
        "https://agents.alpha.example/runtime",
        "did:web:agents.alpha.example",
        "requesting-agent",
        "alpha-runtime-2.4.1"
    ],
    [
        "conv-2026-04-22-uaix-001",
        "turn-003",
        "msg-2026-04-22-0001",
        null,
        3
    ],
    [
        "sync",
        "interactive",
        "2026-04-22T16:05:00Z",
        false,
        false
    ],
    [
        "signed-envelope",
        "jws",
        "did:web:uaix.org",
        "https://uaix.org/.well-known/uai.json",
        "https://uaix.org/signatures/msg-2026-04-22-0004.jws",
        "rw-2026-04-22-0004"
    ],
    [
        "https://uaix.org/problems/unknown-profile",
        "Unknown public profile",
        "The declared profile is not present in the published UAI-1 registry.",
        404,
        "unknown_profile",
        false,
        "https://uaix.org/errors/msg-2026-04-22-0004",
        [
            [
                "$.profile",
                "unknown_profile",
                "Use a published UAI-1 profile from the registry."
            ]
        ],
        "Resolve the current registry entry before retrying validation."
    ],
    [
        "trace-7f3a2d",
        "trace-root-uaix-2026",
        "2026-04-22T16:00:11Z",
        "urn:uaix:log:2026:0004",
        "uaix.validator",
        "model.uaix.validator-1",
        1,
        [
            [
                "validation-failure",
                "uaix.validator",
                "model.uaix.validator-1",
                "Rejected an unpublished profile identifier."
            ]
        ]
    ],
    [
        2,
        "sha256",
        "jcs",
        "sha256:3f9a1f0c7a23a4921af647e7dbf52aeed8f2f11f"
    ],
    []
]

Field order follows the keyed JSON example, the published schema order, and the public field registry.

UAI-REGI-0005

UAI Conformance Result v1

Capture validator output, artifact references, and issue summaries in the same public message family so proof can travel with the release record.

Profile
uai.conformance.result.v1
Outcome
PASS
REST route
/wp-json/uaix/v1/examples/uai.conformance.result.v1
Readable fixture Keyed JSON uai.conformance.result.v1-keyed.json
{
    "uai_version": "1.0",
    "profile": "uai.conformance.result.v1",
    "message_id": "msg-2026-04-22-0005",
    "source": {
        "type": "service",
        "id": "uaix.validator",
        "label": "UAIX Validator",
        "uri": "https://uaix.org/en-us/tools/validator/",
        "did": "did:web:uaix.org",
        "role": "conformance-checker",
        "implementation": "uaix-core-0.4.0"
    },
    "target": {
        "type": "message",
        "id": "msg-2026-04-22-0001",
        "label": "UAI Intent Request v1",
        "uri": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
        "did": "did:web:uaix.org",
        "role": "checked-record",
        "implementation": "uai.intent.request.v1"
    },
    "conversation": {
        "conversation_id": "conv-2026-04-22-uaix-validator-001",
        "turn_id": "turn-001",
        "parent_message_id": "msg-2026-04-22-0001",
        "sequence": 1
    },
    "delivery": {
        "mode": "sync",
        "priority": "routine",
        "expires_at": "2026-04-29T16:00:15Z",
        "reply_requested": false,
        "ack_required": false
    },
    "trust": {
        "channel": "signed-envelope",
        "auth_scheme": "jws",
        "principal": "did:web:uaix.org",
        "credential_ref": "https://uaix.org/.well-known/uai.json",
        "signature_ref": "https://uaix.org/signatures/msg-2026-04-22-0005.jws",
        "replay_window_id": "rw-2026-04-22-0005"
    },
    "body": {
        "status": "pass",
        "checked_profile": "uai.intent.request.v1",
        "issues": [],
        "summary": {
            "error_count": 0,
            "warning_count": 0,
            "checked_at": "2026-04-22T16:00:15Z"
        },
        "artifacts": {
            "catalog_url": "https://uaix.org/wp-json/uaix/v1/catalog",
            "schema_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
            "registry_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
            "example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
            "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
            "transport_bindings_url": "https://uaix.org/wp-json/uaix/v1/transport-bindings",
            "trust_channels_url": "https://uaix.org/wp-json/uaix/v1/trust-channels",
            "conformance_levels_url": "https://uaix.org/wp-json/uaix/v1/conformance-levels",
            "error_registry_url": "https://uaix.org/wp-json/uaix/v1/error-registry",
            "validate_url": "https://uaix.org/wp-json/uaix/v1/validate"
        },
        "target_message_ref": "msg-2026-04-22-0001"
    },
    "provenance": {
        "trace_id": "trace-7f3a2d",
        "parent_trace_id": "trace-root-uaix-2026",
        "issued_at": "2026-04-22T16:00:15Z",
        "log_ref": "urn:uaix:log:2026:0005",
        "agent_id": "uaix.validator",
        "model_id": "model.uaix.validator-1",
        "confidence": 1,
        "lineage": [
            {
                "stage": "conformance-export",
                "actor_id": "uaix.validator",
                "model_id": "model.uaix.validator-1",
                "note": "Generated a portable conformance record with the exact transport, trust, error, and conformance references used during the check."
            }
        ]
    },
    "integrity": {
        "version": 2,
        "algorithm": "sha256",
        "canonicalization": "jcs",
        "checksum": "sha256:8e0a46018d6f1cfaef0b7ab9de52e8503b119a91"
    },
    "extensions": [
        {
            "namespace": "urn:uaix:ext:evidence",
            "purpose": "Links the conformance record to exact catalog artifacts.",
            "critical": false
        }
    ]
}
Transfer format Optimized (Keyless) JSON uai.conformance.result.v1-keyless.json
[
    "1.0",
    "uai.conformance.result.v1",
    "msg-2026-04-22-0005",
    [
        "service",
        "uaix.validator",
        "UAIX Validator",
        "https://uaix.org/en-us/tools/validator/",
        "did:web:uaix.org",
        "conformance-checker",
        "uaix-core-0.4.0"
    ],
    [
        "message",
        "msg-2026-04-22-0001",
        "UAI Intent Request v1",
        "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
        "did:web:uaix.org",
        "checked-record",
        "uai.intent.request.v1"
    ],
    [
        "conv-2026-04-22-uaix-validator-001",
        "turn-001",
        "msg-2026-04-22-0001",
        null,
        1
    ],
    [
        "sync",
        "routine",
        "2026-04-29T16:00:15Z",
        false,
        false
    ],
    [
        "signed-envelope",
        "jws",
        "did:web:uaix.org",
        "https://uaix.org/.well-known/uai.json",
        "https://uaix.org/signatures/msg-2026-04-22-0005.jws",
        "rw-2026-04-22-0005"
    ],
    [
        "pass",
        "uai.intent.request.v1",
        [],
        {
            "error_count": 0,
            "warning_count": 0,
            "checked_at": "2026-04-22T16:00:15Z"
        },
        {
            "catalog_url": "https://uaix.org/wp-json/uaix/v1/catalog",
            "schema_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
            "registry_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
            "example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
            "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
            "transport_bindings_url": "https://uaix.org/wp-json/uaix/v1/transport-bindings",
            "trust_channels_url": "https://uaix.org/wp-json/uaix/v1/trust-channels",
            "conformance_levels_url": "https://uaix.org/wp-json/uaix/v1/conformance-levels",
            "error_registry_url": "https://uaix.org/wp-json/uaix/v1/error-registry",
            "validate_url": "https://uaix.org/wp-json/uaix/v1/validate"
        },
        "msg-2026-04-22-0001"
    ],
    [
        "trace-7f3a2d",
        "trace-root-uaix-2026",
        "2026-04-22T16:00:15Z",
        "urn:uaix:log:2026:0005",
        "uaix.validator",
        "model.uaix.validator-1",
        1,
        [
            [
                "conformance-export",
                "uaix.validator",
                "model.uaix.validator-1",
                "Generated a portable conformance record with the exact transport, trust, error, and conformance references used during the check."
            ]
        ]
    ],
    [
        2,
        "sha256",
        "jcs",
        "sha256:8e0a46018d6f1cfaef0b7ab9de52e8503b119a91"
    ],
    [
        [
            "urn:uaix:ext:evidence",
            "Links the conformance record to exact catalog artifacts.",
            false
        ]
    ]
]

Field order follows the keyed JSON example, the published schema order, and the public field registry.

UAI-REGI-0006

UAI Task Status v1

Publish long-running task state, progress, blockers, and result references so async agent work stays auditable instead of disappearing into private workflow state.

Profile
uai.task.status.v1
Outcome
PASS
REST route
/wp-json/uaix/v1/examples/uai.task.status.v1
Readable fixture Keyed JSON uai.task_.status.v1-keyed.json
{
    "uai_version": "1.0",
    "profile": "uai.task.status.v1",
    "message_id": "msg-2026-04-22-0006",
    "source": {
        "type": "service",
        "id": "uaix.gateway",
        "label": "UAIX Gateway",
        "uri": "https://uaix.org/wp-json/uaix/v1/discovery",
        "did": "did:web:uaix.org",
        "role": "task-publisher",
        "implementation": "uaix-core-0.4.0"
    },
    "target": {
        "type": "agent",
        "id": "agent.alpha",
        "label": "Agent Alpha",
        "uri": "https://agents.alpha.example/runtime",
        "did": "did:web:agents.alpha.example",
        "role": "requesting-agent",
        "implementation": "alpha-runtime-2.4.1"
    },
    "conversation": {
        "conversation_id": "conv-2026-04-22-uaix-001",
        "turn_id": "turn-004",
        "parent_message_id": "msg-2026-04-22-0002",
        "sequence": 4
    },
    "delivery": {
        "mode": "event",
        "priority": "interactive",
        "expires_at": "2026-04-22T16:20:00Z",
        "reply_requested": false,
        "ack_required": false,
        "task_ref": "task-2026-04-22-0001"
    },
    "trust": {
        "channel": "signed-envelope",
        "auth_scheme": "jws",
        "principal": "did:web:uaix.org",
        "credential_ref": "https://uaix.org/.well-known/uai.json",
        "signature_ref": "https://uaix.org/signatures/msg-2026-04-22-0006.jws",
        "replay_window_id": "rw-2026-04-22-0006"
    },
    "body": {
        "task_id": "task-2026-04-22-0001",
        "state": "working",
        "subject": "uai.task.status.v1",
        "progress": 60,
        "status_message": "Field registry resolved and schema packet assembled; release evidence is being prepared.",
        "result_profile": "uai.intent.response.v1",
        "result_ref": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
        "blocking_reasons": [],
        "updated_fields": [
            "body.progress",
            "body.status_message",
            "body.result_ref"
        ]
    },
    "provenance": {
        "trace_id": "trace-7f3a2d",
        "parent_trace_id": "trace-root-uaix-2026",
        "issued_at": "2026-04-22T16:00:20Z",
        "log_ref": "urn:uaix:log:2026:0006",
        "agent_id": "uaix.gateway",
        "model_id": "model.uaix.dispatch-1",
        "confidence": 0.97,
        "lineage": [
            {
                "stage": "task-status-update",
                "actor_id": "uaix.gateway",
                "model_id": "model.uaix.dispatch-1",
                "note": "Published a mid-run status update for the async request."
            }
        ]
    },
    "integrity": {
        "version": 2,
        "algorithm": "sha256",
        "canonicalization": "jcs",
        "checksum": "sha256:14a53b2b665690ad9ac1b85793a6335cb55bb67e"
    },
    "extensions": [
        {
            "namespace": "urn:uaix:ext:delivery",
            "purpose": "Explicit async task update routing.",
            "critical": false
        }
    ]
}
Transfer format Optimized (Keyless) JSON uai.task_.status.v1-keyless.json
[
    "1.0",
    "uai.task.status.v1",
    "msg-2026-04-22-0006",
    [
        "service",
        "uaix.gateway",
        "UAIX Gateway",
        "https://uaix.org/wp-json/uaix/v1/discovery",
        "did:web:uaix.org",
        "task-publisher",
        "uaix-core-0.4.0"
    ],
    [
        "agent",
        "agent.alpha",
        "Agent Alpha",
        "https://agents.alpha.example/runtime",
        "did:web:agents.alpha.example",
        "requesting-agent",
        "alpha-runtime-2.4.1"
    ],
    [
        "conv-2026-04-22-uaix-001",
        "turn-004",
        "msg-2026-04-22-0002",
        null,
        4
    ],
    [
        "event",
        "interactive",
        "2026-04-22T16:20:00Z",
        false,
        false,
        "task-2026-04-22-0001"
    ],
    [
        "signed-envelope",
        "jws",
        "did:web:uaix.org",
        "https://uaix.org/.well-known/uai.json",
        "https://uaix.org/signatures/msg-2026-04-22-0006.jws",
        "rw-2026-04-22-0006"
    ],
    [
        "task-2026-04-22-0001",
        "working",
        "uai.task.status.v1",
        60,
        "Field registry resolved and schema packet assembled; release evidence is being prepared.",
        "uai.intent.response.v1",
        "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
        [],
        [
            "body.progress",
            "body.status_message",
            "body.result_ref"
        ]
    ],
    [
        "trace-7f3a2d",
        "trace-root-uaix-2026",
        "2026-04-22T16:00:20Z",
        "urn:uaix:log:2026:0006",
        "uaix.gateway",
        "model.uaix.dispatch-1",
        0.97,
        [
            [
                "task-status-update",
                "uaix.gateway",
                "model.uaix.dispatch-1",
                "Published a mid-run status update for the async request."
            ]
        ]
    ],
    [
        2,
        "sha256",
        "jcs",
        "sha256:14a53b2b665690ad9ac1b85793a6335cb55bb67e"
    ],
    [
        [
            "urn:uaix:ext:delivery",
            "Explicit async task update routing.",
            false
        ]
    ]
]

Field order follows the keyed JSON example, the published schema order, and the public field registry.

Copyable starter requests

Use the live snippets below when you want to pull one published fixture, keep the packet readable in local review, and submit the same message to validation without inventing a private helper layer.

Client examples

Copyable starter requests in curl, PowerShell, Python, and TypeScript

Use these plain HTTP snippets to reach the live public surface quickly, including the reference-response route, while official runtime tracks remain intentionally narrow.

Starter snippets use the live public routes, not a private SDK or unpublished helper layer.

curl

Plain shell

Fastest raw HTTP path for docs, smoke checks, CI probes, and quick manual review.

Adoption kit Fetch the published onboarding bundle uai-adoption-kit.json
curl -sS "http://uiax.org/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.json
Catalog Resolve the live route catalog
curl -sS "http://uiax.org/wp-json/uaix/v1/catalog"
Example Fetch one published starter packet example-record.json
curl -sS "http://uiax.org/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.json
Validate Submit the packet for a result record validate-request.json
curl -sS -X POST "http://uiax.org/wp-json/uaix/v1/validate" \
  -H "Content-Type: application/json" \
  -d @validate-request.json
Mock exchange Request one live conforming response mock-exchange-request.json
curl -sS -X POST "http://uiax.org/wp-json/uaix/v1/mock-exchange" \
  -H "Content-Type: application/json" \
  -d @mock-exchange-request.json

What to do after a passing fixture

Next step

Continue to the Validator to turn these fixtures into repeatable conformance evidence, then attach that evidence to the current implementation and release trail.