Adoption Kit

What this page is for

Use this page as the shortest published onboarding bundle for a first proof run against the live UAI-1 surface. It keeps the starter files, validator-ready payloads, mock-exchange examples, an implementation-evidence checklist, conformance fixture pack, and implementation next steps in one public packet.

What ships in the kit

Copyable starter files for the first message, validator request, and release-review handoff.
Multi-language starter calls for curl, PowerShell, Python, and TypeScript.
One implementation-evidence checklist covering identity, supported profiles, validator output, fixtures, release trail, and support boundary.
One conformance fixture pack with current positive keyed/minified/keyless cases, canonical-hash equivalence metadata, and negative missing-profile, missing-required-field, undeclared-field, invalid-traceparent, DID/VC trust-evidence, keyless-shape, keyless-overflow, and unsupported-alias cases.
One reference mock-exchange packet plus direct links back to schemas, registry, examples, and implementation tracks.

When to use it

Start here when a team needs the shortest route from reading UAI-1 to producing one reusable validator-backed packet.
Complete the checklist and run the fixture pack before turning a first proof into public release or support language.
Move to API Reference when you need the full route inventory and OpenAPI contract.
Move to Conformance Pack when the packet needs the broader release-evidence bundle for launch review or regression work.

Published onboarding bundle

Use the adoption kit below to fetch the current first-proof packet and keep the exact starter files, checklist, and fixture pack together.

Current release

UAI-1

Generated: 2026-04-26T15:33:08+00:00
Download file: uai-1-adoption-kit-2026-04-22.json
Starter profile: uai.intent.request.v1
Starter files: 7
Languages: 4

Open Adoption Kit JSON Download Adoption Kit JSON

What ships together

Minimal public proof packet

Starter message, validation request, conformance record, and mock-exchange request.
Schema, registry, example, and machine-route links for the first starter profile.
Implementation-track entry points for the WordPress and .NET release lanes.
Downloadable JSON that another reviewer can reuse without private setup notes.

Best use

Move a team from reading to proof

Use the adoption kit for first-day onboarding, launch QA, evaluator handoff, or internal pairing when a teammate needs the shortest public route from the spec to one reviewable packet.

Related surfaces

Keep the next steps named

Open Get Started page Open validator page Open API reference page Open conformance pack page

Catalog /wp-json/uaix/v1/catalog Adoption kit /wp-json/uaix/v1/adoption-kit Validate /wp-json/uaix/v1/validate Mock exchange /wp-json/uaix/v1/mock-exchange Conformance pack /wp-json/uaix/v1/conformance-pack

Starter sequence

How to use the kit on a real first pass

Open the published adoption kit page or JSON route first so onboarding starts from the current public packet instead of private notes.
Resolve one starter profile, then keep its schema, registry entry, and example fixture together as the first proof packet.
Run the validator and keep the resulting conformance record attached to the exact starter packet used during review.
Post the same packet to the mock exchange when you want one live conforming response bundle before a runtime track ships its own implementation.
Fill the implementation evidence checklist before moving from a first proof into public release or support language.
Use the conformance fixture pack to check current positive and negative validator behavior before widening the release packet.
Use the bridge evidence pack when a candidate implementation needs to show how A2A, MCP, OpenAPI, DID/VC, or Trace Context evidence maps into UAI-1 records.
Carry the proof packet into the named implementation track, conformance pack, and release trail before making outward support claims.

Starter file manifest Fetch starter files from the adoption kit JSON 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",
    "starter_files": [
        {
            "label": "Starter message",
            "filename": "starter-message.json",
            "top_level_keys": [
                "uai_version",
                "profile",
                "message_id",
                "source",
                "target",
                "conversation",
                "delivery",
                "trust",
                "body",
                "provenance",
                "integrity",
                "extensions"
            ]
        },
        {
            "label": "Validation request",
            "filename": "validate-request.json",
            "top_level_keys": [
                "message",
                "normalization_mode",
                "format"
            ]
        },
        {
            "label": "Mock exchange request",
            "filename": "mock-exchange-request.json",
            "top_level_keys": [
                "scenario",
                "format",
                "message"
            ]
        },
        {
            "label": "Conformance record",
            "filename": "uai-conformance-record.json",
            "top_level_keys": [
                "uai_version",
                "profile",
                "message_id",
                "source",
                "target",
                "conversation",
                "delivery",
                "trust",
                "body",
                "provenance",
                "integrity",
                "extensions"
            ]
        },
        {
            "label": "Implementation evidence checklist",
            "filename": "implementation-evidence-checklist.json",
            "top_level_keys": [
                0,
                1,
                2,
                3,
                4,
                5
            ]
        },
        {
            "label": "Conformance fixture pack",
            "filename": "conformance-fixture-pack.json",
            "top_level_keys": [
                "kind",
                "generated_at",
                "current_release",
                "uai_version",
                "profile_id",
                "purpose",
                "fixture_count",
                "positive_count",
                "negative_count",
                "coverage",
                "canonical_hash_equivalence",
                "route_contract",
                "cases"
            ]
        },
        {
            "label": "Bridge evidence pack",
            "filename": "bridge-evidence-pack.json",
            "top_level_keys": [
                "kind",
                "generated_at",
                "standard_family",
                "current_release",
                "uai_version",
                "release_date",
                "description",
                "support_boundary",
                "case_count",
                "validated_case_count",
                "adjacent_standard_count",
                "adjacent_standards",
                "uai_profiles",
                "available_in",
                "verification",
                "cases"
            ]
        }
    ],
    "use": "Fetch the adoption kit JSON for the full starter file contents."
}

模拟交换响应 已接收任务参考包 uai-mock-exchange.json

{
    "kind": "uaix.mock.exchange.result.v1",
    "generated_at": "2026-04-26T15:33:08+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:08+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-20260426T153308Z-026c2d90a89f",
                "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-026c2d90a89f",
                    "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:08+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-026c2d90a89f"
                },
                "body": {
                    "status": "pass",
                    "checked_profile": "uai.intent.request.v1",
                    "issues": [],
                    "summary": {
                        "error_count": 0,
                        "warning_count": 0,
                        "checked_at": "2026-04-26T15:33:08+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:08+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-20260426T153308Z-026c2d90a89f.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:08+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-20260426T153308Z-290d67b5d3d8",
            "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-290d67b5d3d8",
                "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:08+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-290d67b5d3d8"
            },
            "body": {
                "status": "pass",
                "checked_profile": "uai.intent.response.v1",
                "issues": [],
                "summary": {
                    "error_count": 0,
                    "warning_count": 0,
                    "checked_at": "2026-04-26T15:33:08+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:08+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-20260426T153308Z-290d67b5d3d8.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"
    }
}

Keep the starter packet, validator record, mock response, and named implementation lane together. That bundle is the public adoption handoff the site now publishes directly.

Route-level starter calls

Use the route and language examples below when you want the same packet in curl, PowerShell, Python, or TypeScript.

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

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

Adoption kit Fetch the published onboarding bundle uai-adoption-kit.json

Invoke-RestMethod -Uri "http://uiax.org/wp-json/uaix/v1/adoption-kit" | ConvertTo-Json -Depth 20 | Set-Content .\uai-adoption-kit.json

Catalog Resolve the live route catalog

Invoke-RestMethod -Uri "http://uiax.org/wp-json/uaix/v1/catalog"

Example Fetch one published starter packet example-record.json

Invoke-RestMethod -Uri "http://uiax.org/wp-json/uaix/v1/examples/uai.intent.request.v1" | ConvertTo-Json -Depth 20 | Set-Content .\example-record.json

Validate Submit the packet for a result record validate-request.json

$message = (Get-Content -Raw .\example-record.json | ConvertFrom-Json).message
$body = @{ message = $message; format = "result" } | ConvertTo-Json -Depth 20
Invoke-RestMethod -Method Post -Uri "http://uiax.org/wp-json/uaix/v1/validate" -ContentType "application/json" -Body $body

Mock exchange Request one live conforming response mock-exchange-request.json

$message = (Get-Content -Raw .\example-record.json | ConvertFrom-Json).message
$body = @{ scenario = "accepted-task"; format = "exchange"; message = $message } | ConvertTo-Json -Depth 20
Invoke-RestMethod -Method Post -Uri "http://uiax.org/wp-json/uaix/v1/mock-exchange" -ContentType "application/json" -Body $body

Adoption kit Fetch the published onboarding bundle uai-adoption-kit.json

import json, urllib.request
kit = json.load(urllib.request.urlopen("http://uiax.org/wp-json/uaix/v1/adoption-kit"))

Catalog Resolve the live route catalog

import json, urllib.request
catalog = json.load(urllib.request.urlopen("http://uiax.org/wp-json/uaix/v1/catalog"))

Example Fetch one published starter packet example-record.json

example_record = json.load(urllib.request.urlopen("http://uiax.org/wp-json/uaix/v1/examples/uai.intent.request.v1"))
message = example_record.get("message", example_record)

Validate Submit the packet for a result record validate-request.json

payload = json.dumps({"message": message, "format": "result"}).encode("utf-8")
request = urllib.request.Request("http://uiax.org/wp-json/uaix/v1/validate", data=payload, headers={"Content-Type": "application/json"}, method="POST")
result = json.load(urllib.request.urlopen(request))

Mock exchange Request one live conforming response mock-exchange-request.json

payload = json.dumps({"scenario": "accepted-task", "format": "exchange", "message": message}).encode("utf-8")
request = urllib.request.Request("http://uiax.org/wp-json/uaix/v1/mock-exchange", data=payload, headers={"Content-Type": "application/json"}, method="POST")
exchange = json.load(urllib.request.urlopen(request))

Adoption kit Fetch the published onboarding bundle uai-adoption-kit.json

const kit = await fetch("http://uiax.org/wp-json/uaix/v1/adoption-kit").then((response) => response.json());

Catalog Resolve the live route catalog

const catalog = await fetch("http://uiax.org/wp-json/uaix/v1/catalog").then((response) => response.json());

Example Fetch one published starter packet example-record.json

const exampleRecord = await fetch("http://uiax.org/wp-json/uaix/v1/examples/uai.intent.request.v1").then((response) => response.json());
const message = exampleRecord.message ?? exampleRecord;

Validate Submit the packet for a result record validate-request.json

const result = await fetch("http://uiax.org/wp-json/uaix/v1/validate", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ message, format: "result" }),
}).then((response) => response.json());

Mock exchange Request one live conforming response mock-exchange-request.json

const exchange = await fetch("http://uiax.org/wp-json/uaix/v1/mock-exchange", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ scenario: "accepted-task", format: "exchange", message }),
}).then((response) => response.json());

Read UAI-1 Examples Open adoption kit page Open validator page Open conformance pack page

Next step

Continue to Implementations when the proof run needs a named release lane, return to Validator when you want the workbench workflow, or use API Reference when you need the broader machine contract behind the kit.

Start here when one validator-backed packet needs to travel cleanly

Starter files and multi-language calls

Validator and mock exchange together

Evidence checklist and fixture pack

What this page is for

What ships in the kit

When to use it

Published onboarding bundle

Published first-proof bundle

UAI-1

Minimal public proof packet

Move a team from reading to proof

Keep the next steps named

How to use the kit on a real first pass

Route-level starter calls

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

Plain shell

Windows-native call path

Python standard library

Typed fetch workflow

Next step

Start here when one validator-backed packet needs to travel cleanly

Starter files and multi-language calls

Validator and mock exchange together

Evidence checklist and fixture pack

What this page is for#

What ships in the kit#

When to use it#

Published onboarding bundle#

Published first-proof bundle#

UAI-1#

Minimal public proof packet#

Move a team from reading to proof#

Keep the next steps named#

How to use the kit on a real first pass#

Route-level starter calls#

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

Plain shell#

Windows-native call path#

Python standard library#

Typed fetch workflow#

Next step#

What this page is for

What ships in the kit

When to use it

Published onboarding bundle

Published first-proof bundle

UAI-1

Minimal public proof packet

Move a team from reading to proof

Keep the next steps named

How to use the kit on a real first pass

Route-level starter calls

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

Plain shell

Windows-native call path

Python standard library

Typed fetch workflow

Next step