Tools

API Reference

Route-by-route handbook for the live UAIX REST surface, including starter requests, OpenAPI export, and validator-facing machine entry points.

  • Record UAIX-TOOL-0058
  • Path /en-us/tools/api-reference/
  • Use Canonical public record

Document status

Public standards page Published on UAIX as part of the current public standards record
Code
UAIX-TOOL-0058
Surface
Tools
Access
Public and linkable

How to use this page

Use this page to inspect the live REST routes, OpenAPI document, copyable machine-facing starter requests, and the reference mock exchange.

Live routes

CatalogDiscoveryAdoption Kit JSONOpenAPI JSON

Machine Surface

Start from the catalog, then move into the adoption kit, OpenAPI, validation, and live mock exchange

This page exists to stop implementers from reverse-engineering the WordPress REST surface. Resolve the live routes here, then move into the onboarding bundle, validation, mock-response testing, or pack assembly without guessing.

Resolve first

Catalog and discovery

The catalog and discovery routes tell automation what the current public surface is before any route-specific call is made.

Describe contract

OpenAPI and starter requests

Use the live OpenAPI export and the starter request patterns here instead of relying on scraped page copy or stale notes.

Carry forward

Adoption, validation, and reusable evidence

The route inventory matters most when it feeds the adoption bundle, a validator run, a live mock response, or a conformance packet that can travel into release review.

Live routes

CatalogCurrent public standards inventory.DiscoveryMachine-facing route manifest.Adoption Kit JSONPublished onboarding bundle for first-proof runs.OpenAPI JSONLive OpenAPI 3.1 export.ValidateMachine POST target for conformance checks.Mock ExchangeMachine POST target for a live conforming response envelope.Conformance Pack JSONReusable launch packet in one response.
Starter callsResolve the live REST surface
curl -s http://uiax.org/wp-json/uaix/v1/catalog
curl -s http://uiax.org/wp-json/uaix/v1/discovery
curl -s http://uiax.org/wp-json/uaix/v1/adoption-kit
curl -s http://uiax.org/wp-json/uaix/v1/openapi.json
curl -s -X POST http://uiax.org/wp-json/uaix/v1/mock-exchange -H "Content-Type: application/json" -d @mock-exchange-request.json

Use the catalog and discovery routes first, then pull the adoption kit, inspect the OpenAPI document, or request one live mock response directly.

What this page is for

Use this page as the machine-facing handbook for the live UAIX REST surface. It translates the current catalog, discovery, roadmap, schema, registry, example, validator, adoption-kit, OpenAPI, mock-exchange, and conformance-pack routes into one human-readable launch reference.

When to use it

  • When an implementer wants the exact non-locale REST base path and route inventory.
  • When a tool builder needs starter requests, the adoption bundle, the forward-plan boundary, and an OpenAPI document instead of reverse-engineering the site.
  • When a launch reviewer wants to verify that the public documentation, machine-facing routes, roadmap boundaries, and validator evidence all point at the same release.

Fastest route through the live surface

  1. Resolve the current /wp-json/uaix/v1/catalog route first.
  2. Fetch one schema or example from Schemas, Registry, and Examples.
  3. Pull the published Adoption Kit when you need the shortest reusable onboarding packet.
  4. Submit a validator run through Validator or the machine-facing /wp-json/uaix/v1/validate route.
  5. Use the Conformance Pack when that run needs to travel as broader release evidence.
  6. Use /wp-json/uaix/v1/roadmap when automation also needs the current future-work boundary.

What this page publishes

  • A route-by-route machine-facing reference.
  • Starter request examples for discovery, profile lookup, validation, onboarding-bundle fetch, and roadmap resolution.
  • The current OpenAPI 3.1 export for the live REST surface.
  • Direct links back to the canonical public pages that explain the same record in prose.

Route-level starter calls

Use the public snippets below when you want the live catalog, example, and validator calls in curl, PowerShell, Python, or TypeScript without reverse-engineering the route surface.

Client examples

Route-level starter requests in curl, PowerShell, Python, and TypeScript

Use these snippets when you want the live catalog, example, validator, and mock-response calls without reverse-engineering the REST surface.

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

Live machine-facing reference

Use the reference below as the current public source for route layout, starter calls, and OpenAPI export.

API reference

Machine-facing launch surface

Use this reference when you want the live REST contract behind the public UAIX pages. The routes below are the canonical machine-facing entry points for discovery, published records, roadmap boundaries, adoption-kit fetches, validator runs, OpenAPI export, and conformance-pack assembly.

Base path

http://uiax.org/wp-json/uaix/v1

Use the canonical non-locale REST base for automation. Do not treat locale-prefixed page URLs as the machine API root.

Auth posture

Public read, posted validation, posted mock exchange

Discovery and record routes are public read surfaces. The validator and the mock exchange both accept JSON POST payloads for live conformance and response-shape testing.

Published formats

JSON + OpenAPI 3.1

The public surface is JSON-first and now publishes an OpenAPI document for route-level onboarding and tooling generation.

Fastest start

Catalog -> Roadmap -> Adoption kit -> Validate -> Mock

Resolve the catalog, check the future-work boundary, fetch the published onboarding bundle, run one validator check, then hit the live mock exchange before you make support or compatibility claims.

Discovery starter Resolve the current catalog
curl -sS http://uiax.org/wp-json/uaix/v1/catalog
Profile starter Resolve one schema and one example example-record.json
curl -sS http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.request.v1
curl -sS http://uiax.org/wp-json/uaix/v1/examples/uai.intent.request.v1
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
Roadmap Resolve the forward-plan boundary uai-1-roadmap.json
curl -sS http://uiax.org/wp-json/uaix/v1/roadmap -o uai-1-roadmap.json
Validation starter Submit a candidate message validate-request.json
curl -sS -X POST http://uiax.org/wp-json/uaix/v1/validate -H "Content-Type: application/json" -d @validate-request.json
Reference starter Request one live response envelope 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
Example request Validator POST body validate-request.json
{
    "message": {
        "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
            }
        ]
    },
    "normalization_mode": "keyed-json",
    "format": "result"
}
Example response Validator result uai-conformance-result.json
{
    "valid": true,
    "checked_at": "2026-04-26T15:33:15+00:00",
    "profile": "uai.intent.request.v1",
    "current_release": "UAI-1",
    "uai_version": "1.0",
    "schema_route_url": "http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
    "registry_route_url": "http://uiax.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
    "issue_count": 0,
    "error_count": 0,
    "warning_count": 0,
    "errors": [],
    "warnings": [],
    "status": "pass",
    "normalization": {
        "mode": "keyed-json",
        "status": "current",
        "supported": true,
        "input_shape": "json-object",
        "normalized": false,
        "registry_release": "UAI-1",
        "registry_release_date": "2026-04-22",
        "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
        "canonicalization": "jcs-compatible-sorted-json",
        "canonical_hash": "sha256:ea001827f8204b5282544b0306c596aca64923bd76cc7ed77f252c2b2084062b",
        "byte_count": 2112
    },
    "conformance_record": {
        "uai_version": "1.0",
        "profile": "uai.conformance.result.v1",
        "message_id": "msg-20260426T153315Z-e920c01b5858",
        "source": {
            "type": "service",
            "id": "uaix.validator",
            "label": "UAIX Validator",
            "uri": "http://uiax.org/en-us/tools/validator/",
            "did": "did:web:uaix.org",
            "role": "conformance-checker",
            "implementation": "uaix-core-0.9.11"
        },
        "target": {
            "type": "message",
            "id": "msg-2026-04-22-0001",
            "label": "uai.intent.request.v1",
            "uri": "http://uiax.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-001",
            "turn_id": "turn-validator-e920c01b5858",
            "parent_message_id": "msg-2026-04-22-0001",
            "sequence": 2,
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
        },
        "delivery": {
            "mode": "sync",
            "priority": "routine",
            "expires_at": "2026-05-03T15:33:15+00:00",
            "reply_requested": false,
            "ack_required": false
        },
        "trust": {
            "channel": "signed-envelope",
            "auth_scheme": "validator-record",
            "principal": "did:web:uaix.org",
            "credential_ref": "http://uiax.org/.well-known/uai.json",
            "signature_ref": "http://uiax.org/en-us/tools/validator/",
            "replay_window_id": "rw-conformance-20260426-e920c01b5858"
        },
        "body": {
            "status": "pass",
            "checked_profile": "uai.intent.request.v1",
            "issues": [],
            "summary": {
                "error_count": 0,
                "warning_count": 0,
                "checked_at": "2026-04-26T15:33:15+00:00"
            },
            "artifacts": {
                "catalog_url": "http://uiax.org/wp-json/uaix/v1/catalog",
                "schema_url": "http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
                "registry_url": "http://uiax.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
                "example_url": "http://uiax.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
                "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
                "transport_bindings_url": "http://uiax.org/wp-json/uaix/v1/transport-bindings",
                "trust_channels_url": "http://uiax.org/wp-json/uaix/v1/trust-channels",
                "conformance_levels_url": "http://uiax.org/wp-json/uaix/v1/conformance-levels",
                "error_registry_url": "http://uiax.org/wp-json/uaix/v1/error-registry",
                "validate_url": "http://uiax.org/wp-json/uaix/v1/validate"
            },
            "target_message_ref": "msg-2026-04-22-0001"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "issued_at": "2026-04-26T15:33:15+00:00",
            "log_ref": "urn:uaix:log:2026:0001",
            "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 validator-backed evidence record for the checked message using keyed-json normalization."
                }
            ],
            "parent_trace_id": "trace-7f3a2d"
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:fb31e0116d019906346c03551112ae98ff39c9dc874b4f199629296b3888d9e3"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:evidence",
                "purpose": "Links conformance output to the exact public artifacts used during validation.",
                "critical": false
            }
        ]
    },
    "download_filename": "msg-20260426T153315Z-e920c01b5858.json"
}
Adoption kit manifest Published onboarding bundle entry points uai-adoption-kit-manifest.json
{
    "adoption_kit_url": "http://uiax.org/wp-json/uaix/v1/adoption-kit",
    "download_url": "http://uiax.org/wp-json/uaix/v1/adoption-kit?download=1",
    "current_release": "UAI-1",
    "starter_files": 7,
    "language_starters": 4,
    "first_packet_profile": "uai.intent.request.v1",
    "use": "Fetch the adoption_kit_url for the complete starter files and proof artifacts."
}
模拟交换请求 Reference surface POST body mock-exchange-request.json
{
    "scenario": "accepted-task",
    "format": "exchange",
    "message": {
        "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
            }
        ]
    }
}
模拟交换响应 Reference surface exchange bundle uai-mock-exchange.json
{
    "kind": "uaix.mock.exchange.result.v1",
    "generated_at": "2026-04-26T15:33:15+00:00",
    "route_url": "http://uiax.org/wp-json/uaix/v1/mock-exchange",
    "scenario": "accepted-task",
    "http_status": 202,
    "summary": "The reference surface accepted the request and returned a conforming async handoff using `uai.intent.response.v1`.",
    "request": {
        "message": {
            "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
                }
            ]
        },
        "validation": {
            "valid": true,
            "checked_at": "2026-04-26T15:33:15+00:00",
            "profile": "uai.intent.request.v1",
            "current_release": "UAI-1",
            "uai_version": "1.0",
            "schema_route_url": "http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
            "registry_route_url": "http://uiax.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
            "issue_count": 0,
            "error_count": 0,
            "warning_count": 0,
            "errors": [],
            "warnings": [],
            "status": "pass",
            "normalization": {
                "mode": "keyed-json",
                "status": "current",
                "supported": true,
                "input_shape": "json-object",
                "normalized": false,
                "registry_release": "UAI-1",
                "registry_release_date": "2026-04-22",
                "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
                "canonicalization": "jcs-compatible-sorted-json",
                "canonical_hash": "sha256:ea001827f8204b5282544b0306c596aca64923bd76cc7ed77f252c2b2084062b",
                "byte_count": 2112
            },
            "conformance_record": {
                "uai_version": "1.0",
                "profile": "uai.conformance.result.v1",
                "message_id": "msg-20260426T153315Z-e920c01b5858",
                "source": {
                    "type": "service",
                    "id": "uaix.validator",
                    "label": "UAIX Validator",
                    "uri": "http://uiax.org/en-us/tools/validator/",
                    "did": "did:web:uaix.org",
                    "role": "conformance-checker",
                    "implementation": "uaix-core-0.9.11"
                },
                "target": {
                    "type": "message",
                    "id": "msg-2026-04-22-0001",
                    "label": "uai.intent.request.v1",
                    "uri": "http://uiax.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-001",
                    "turn_id": "turn-validator-e920c01b5858",
                    "parent_message_id": "msg-2026-04-22-0001",
                    "sequence": 2,
                    "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
                },
                "delivery": {
                    "mode": "sync",
                    "priority": "routine",
                    "expires_at": "2026-05-03T15:33:15+00:00",
                    "reply_requested": false,
                    "ack_required": false
                },
                "trust": {
                    "channel": "signed-envelope",
                    "auth_scheme": "validator-record",
                    "principal": "did:web:uaix.org",
                    "credential_ref": "http://uiax.org/.well-known/uai.json",
                    "signature_ref": "http://uiax.org/en-us/tools/validator/",
                    "replay_window_id": "rw-conformance-20260426-e920c01b5858"
                },
                "body": {
                    "status": "pass",
                    "checked_profile": "uai.intent.request.v1",
                    "issues": [],
                    "summary": {
                        "error_count": 0,
                        "warning_count": 0,
                        "checked_at": "2026-04-26T15:33:15+00:00"
                    },
                    "artifacts": {
                        "catalog_url": "http://uiax.org/wp-json/uaix/v1/catalog",
                        "schema_url": "http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
                        "registry_url": "http://uiax.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
                        "example_url": "http://uiax.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
                        "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
                        "transport_bindings_url": "http://uiax.org/wp-json/uaix/v1/transport-bindings",
                        "trust_channels_url": "http://uiax.org/wp-json/uaix/v1/trust-channels",
                        "conformance_levels_url": "http://uiax.org/wp-json/uaix/v1/conformance-levels",
                        "error_registry_url": "http://uiax.org/wp-json/uaix/v1/error-registry",
                        "validate_url": "http://uiax.org/wp-json/uaix/v1/validate"
                    },
                    "target_message_ref": "msg-2026-04-22-0001"
                },
                "provenance": {
                    "trace_id": "trace-7f3a2d",
                    "issued_at": "2026-04-26T15:33:15+00:00",
                    "log_ref": "urn:uaix:log:2026:0001",
                    "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 validator-backed evidence record for the checked message using keyed-json normalization."
                        }
                    ],
                    "parent_trace_id": "trace-7f3a2d"
                },
                "integrity": {
                    "version": 2,
                    "algorithm": "sha256",
                    "canonicalization": "jcs",
                    "checksum": "sha256:fb31e0116d019906346c03551112ae98ff39c9dc874b4f199629296b3888d9e3"
                },
                "extensions": [
                    {
                        "namespace": "urn:uaix:ext:evidence",
                        "purpose": "Links conformance output to the exact public artifacts used during validation.",
                        "critical": false
                    }
                ]
            },
            "download_filename": "msg-20260426T153315Z-e920c01b5858.json"
        }
    },
    "response_profile": "uai.intent.response.v1",
    "response_message": {
        "uai_version": "1.0",
        "profile": "uai.intent.response.v1",
        "message_id": "msg-mock-accepted-529a0c03c1bb",
        "source": {
            "type": "service",
            "id": "uaix.mock.exchange",
            "label": "UAIX Mock Exchange",
            "uri": "http://uiax.org/wp-json/uaix/v1/mock-exchange",
            "did": "did:web:uaix.org",
            "role": "reference-server",
            "implementation": "uaix-core-0.9.11"
        },
        "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-mock-529a0c03c1bb",
            "parent_message_id": "msg-2026-04-22-0001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-55e4155501e108df-01",
            "sequence": 2
        },
        "delivery": {
            "mode": "async",
            "priority": "interactive",
            "expires_at": "2026-04-22T16:05:00+00:00",
            "reply_requested": false,
            "ack_required": true,
            "task_ref": "task-mock-529a0c03c1bb"
        },
        "trust": {
            "channel": "signed-envelope",
            "auth_scheme": "jws",
            "principal": "did:web:uaix.org",
            "credential_ref": "http://uiax.org/.well-known/uai.json",
            "signature_ref": "http://uiax.org/wp-json/uaix/v1/mock-exchange#signature-529a0c03c1bb",
            "replay_window_id": "rw-mock-529a0c03c1bb"
        },
        "body": {
            "status": "accepted",
            "subject": "uai.task.status.v1",
            "request_message_id": "msg-2026-04-22-0001",
            "result": {
                "task_id": "task-mock-529a0c03c1bb",
                "status_profile": "uai.task.status.v1",
                "status_example_url": "http://uiax.org/wp-json/uaix/v1/examples/uai.task.status.v1",
                "response_profile": "uai.intent.response.v1",
                "follow_up_scenarios": [
                    "completed-response",
                    "typed-error"
                ],
                "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
                "mock_exchange_url": "http://uiax.org/wp-json/uaix/v1/mock-exchange"
            },
            "notices": [
                "accepted-task-started",
                "use-task-status-example-for-shape-checks",
                "reference-surface-response"
            ],
            "task_ref": "task-mock-529a0c03c1bb"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "issued_at": "2026-04-22T16:00:03+00:00",
            "log_ref": "urn:uaix:log:mock:20260426:529a0c03c1bb",
            "agent_id": "uaix.mock.exchange",
            "model_id": "model.uaix.mock.exchange-1",
            "confidence": 1,
            "lineage": [
                {
                    "stage": "mock-acceptance",
                    "actor_id": "uaix.mock.exchange",
                    "model_id": "model.uaix.mock.exchange-1",
                    "note": "Accepted the request and published a deterministic async handoff from the UAIX mock exchange surface."
                }
            ],
            "parent_trace_id": "trace-7f3a2d"
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:240f1ecaa3662482c7d9a62199db94ce09f206d80a1e657a3e039aad6328e066"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:mock-exchange",
                "purpose": "Marks this envelope as a deterministic response from the UAIX live reference surface for scenario `accepted-task`.",
                "critical": false
            }
        ]
    },
    "response_validation": {
        "valid": true,
        "checked_at": "2026-04-26T15:33:15+00:00",
        "profile": "uai.intent.response.v1",
        "current_release": "UAI-1",
        "uai_version": "1.0",
        "schema_route_url": "http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.response.v1",
        "registry_route_url": "http://uiax.org/wp-json/uaix/v1/registry/uai.intent.response.v1",
        "issue_count": 0,
        "error_count": 0,
        "warning_count": 0,
        "errors": [],
        "warnings": [],
        "status": "pass",
        "normalization": {
            "mode": "keyed-json",
            "status": "current",
            "supported": true,
            "input_shape": "json-object",
            "normalized": false,
            "registry_release": "UAI-1",
            "registry_release_date": "2026-04-22",
            "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
            "canonicalization": "jcs-compatible-sorted-json",
            "canonical_hash": "sha256:90acf6cfc9e1527bf23eddde96c80128d9153a8c79af30055eb19fdaf89c2b62",
            "byte_count": 2702
        },
        "conformance_record": {
            "uai_version": "1.0",
            "profile": "uai.conformance.result.v1",
            "message_id": "msg-20260426T153315Z-cbc1d90e6960",
            "source": {
                "type": "service",
                "id": "uaix.validator",
                "label": "UAIX Validator",
                "uri": "http://uiax.org/en-us/tools/validator/",
                "did": "did:web:uaix.org",
                "role": "conformance-checker",
                "implementation": "uaix-core-0.9.11"
            },
            "target": {
                "type": "message",
                "id": "msg-mock-accepted-529a0c03c1bb",
                "label": "uai.intent.response.v1",
                "uri": "http://uiax.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
                "did": "did:web:uaix.org",
                "role": "checked-record",
                "implementation": "uai.intent.response.v1"
            },
            "conversation": {
                "conversation_id": "conv-2026-04-22-uaix-001",
                "turn_id": "turn-validator-cbc1d90e6960",
                "parent_message_id": "msg-mock-accepted-529a0c03c1bb",
                "sequence": 3,
                "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-55e4155501e108df-01"
            },
            "delivery": {
                "mode": "sync",
                "priority": "routine",
                "expires_at": "2026-05-03T15:33:15+00:00",
                "reply_requested": false,
                "ack_required": false
            },
            "trust": {
                "channel": "signed-envelope",
                "auth_scheme": "validator-record",
                "principal": "did:web:uaix.org",
                "credential_ref": "http://uiax.org/.well-known/uai.json",
                "signature_ref": "http://uiax.org/en-us/tools/validator/",
                "replay_window_id": "rw-conformance-20260426-cbc1d90e6960"
            },
            "body": {
                "status": "pass",
                "checked_profile": "uai.intent.response.v1",
                "issues": [],
                "summary": {
                    "error_count": 0,
                    "warning_count": 0,
                    "checked_at": "2026-04-26T15:33:15+00:00"
                },
                "artifacts": {
                    "catalog_url": "http://uiax.org/wp-json/uaix/v1/catalog",
                    "schema_url": "http://uiax.org/wp-json/uaix/v1/schemas/uai.intent.response.v1",
                    "registry_url": "http://uiax.org/wp-json/uaix/v1/registry/uai.intent.response.v1",
                    "example_url": "http://uiax.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
                    "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
                    "transport_bindings_url": "http://uiax.org/wp-json/uaix/v1/transport-bindings",
                    "trust_channels_url": "http://uiax.org/wp-json/uaix/v1/trust-channels",
                    "conformance_levels_url": "http://uiax.org/wp-json/uaix/v1/conformance-levels",
                    "error_registry_url": "http://uiax.org/wp-json/uaix/v1/error-registry",
                    "validate_url": "http://uiax.org/wp-json/uaix/v1/validate"
                },
                "target_message_ref": "msg-mock-accepted-529a0c03c1bb"
            },
            "provenance": {
                "trace_id": "trace-7f3a2d",
                "issued_at": "2026-04-26T15:33:15+00:00",
                "log_ref": "urn:uaix:log:mock:20260426:529a0c03c1bb",
                "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 validator-backed evidence record for the checked message using keyed-json normalization."
                    }
                ],
                "parent_trace_id": "trace-7f3a2d"
            },
            "integrity": {
                "version": 2,
                "algorithm": "sha256",
                "canonicalization": "jcs",
                "checksum": "sha256:fdc11523fdef9866b9e3860282494f2b7c283c8b1bc651f99966f791a5c1c021"
            },
            "extensions": [
                {
                    "namespace": "urn:uaix:ext:evidence",
                    "purpose": "Links conformance output to the exact public artifacts used during validation.",
                    "critical": false
                }
            ]
        },
        "download_filename": "msg-20260426T153315Z-cbc1d90e6960.json"
    },
    "links": {
        "catalog_url": "http://uiax.org/wp-json/uaix/v1/catalog",
        "validate_url": "http://uiax.org/wp-json/uaix/v1/validate",
        "field_registry_url": "http://uiax.org/wp-json/uaix/v1/field-registry",
        "response_example_url": "http://uiax.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
        "task_status_example_url": "http://uiax.org/wp-json/uaix/v1/examples/uai.task.status.v1"
    }
}

Catalog

/wp-json/uaix/v1/catalog

GET

Resolve the full current route inventory, counts, and public page map before automation starts.

Discovery

/wp-json/uaix/v1/discovery

GET

Read the current release metadata and profile inventory without scraping page HTML.

Schemas

/wp-json/uaix/v1/schemas

GET

List published schema records for the current UAI-1 profile family.

Registry

/wp-json/uaix/v1/registry

GET

Resolve the stable profile identifiers, status, and linked artifact URLs.

Field registry

/wp-json/uaix/v1/field-registry

GET

Keep keyed JSON, keyless transport, and nested body order aligned.

Transport bindings

/wp-json/uaix/v1/transport-bindings

GET

Review binding IDs, media types, and protocol-fit notes before capability claims.

Trust channels

/wp-json/uaix/v1/trust-channels

GET

Review the published trust posture options and related identity controls.

Conformance levels

/wp-json/uaix/v1/conformance-levels

GET

Resolve the public support-claim ladder before using conformance language outwardly.

Error registry

/wp-json/uaix/v1/error-registry

GET

Use the published error codes and validator issue codes instead of inventing local failure vocabularies.

Examples

/wp-json/uaix/v1/examples

GET

Fetch the current fixtures that the validator and documentation both rely on.

Validate

/wp-json/uaix/v1/validate

POST

Validate a candidate message and optionally return the conformance record directly.

Adoption kit

/wp-json/uaix/v1/adoption-kit

GET

Fetch the published onboarding bundle with starter files, proof artifacts, and implementation handoff links.

Roadmap

/wp-json/uaix/v1/roadmap

GET

Resolve the current, next, planned, and research-track roadmap boundary before repeating future support claims.

Mock exchange

/wp-json/uaix/v1/mock-exchange

POST

Post a published or candidate request and receive a conforming mock response envelope from the live reference surface.

OpenAPI

/wp-json/uaix/v1/openapi.json

GET

Resolve the OpenAPI 3.1 document that describes the current public REST surface.

Conformance pack

/wp-json/uaix/v1/conformance-pack

GET

Fetch the reusable release packet with schemas, registry data, fixtures, and guidance in one JSON bundle.

Machine-route hardening

The machine-facing surface now carries a visible security-header layer

Use this section when checking that the API handbook, validator routes, and the published trust posture agree on the same launch-stage response hardening.

X-Content-Type-Options

nosniff

Prevents content-type sniffing on public standards pages and machine-readable routes.

Applied to: Public HTML, JSON, XML, and similar WordPress-rendered responses.

Referrer-Policy

strict-origin-when-cross-origin

Keeps cross-origin referrer leakage narrower while preserving same-origin debugging context.

Applied to: Public document and API responses that can generate outbound requests.

Permissions-Policy

accelerometer=(), browsing-topics=(), camera=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=(), usb=()

Declares that the launch surface does not rely on privileged browser capabilities or Topics-based advertising features.

Applied to: Public WordPress-rendered pages and machine-facing routes.

X-Frame-Options

SAMEORIGIN

Blocks third-party framing while preserving same-origin editorial and preview flows.

Applied to: Public WordPress-rendered pages and JSON responses.

Content-Security-Policy

frame-ancestors 'self'

Makes the framing boundary explicit in modern browsers without claiming a broader full-site CSP yet.

Applied to: Public WordPress-rendered pages and machine-facing routes.

Live now

Headers that travel with public machine routes now

  • 已从公开响应中移除回链响应头。
  • Host- or proxy-level version headers still need server-side suppression if the launch environment adds them after WordPress runs.
  • These headers now travel with public WordPress-rendered HTML and REST responses instead of remaining only in roadmap prose.

Deployment gap

Machine-surface tasks that still need deployment validation

  • HTTPS redirect and HSTS still belong at the launch host or CDN edge because the local Studio environment runs over plain HTTP.
  • Any directly served static root files should be checked at the server or edge layer so their headers stay aligned with the WordPress-rendered trust posture.
  • Host-level version disclosure such as proxy or PHP signature headers should be suppressed where the deployment stack adds them outside WordPress.
  • Broader CSP directives should be added only after production asset and embedding behavior are validated against the launch host.

Scope boundary: 当前响应头层应用于公开的 WordPress 前端渲染响应和 REST 响应,包括验证器与面向机器的评审路由。

Next step

Continue to Adoption Kit if you need the published first-proof bundle, Conformance Pack if you need the broader reusable JSON packet, open /wp-json/uaix/v1/roadmap if automation needs the future-work boundary, or return to Validator when the next task is running or exporting one concrete proof check.