AuraOne Open / A2A contract testing

Validate A2A agent cards and task lifecycles.

Check agent cards, capabilities, structured payloads, errors, cancellation, and task lifecycle transcripts against a practical contract profile.

Input

  • An agent-card.json file
  • Recorded task lifecycle transcripts

Install and run

pip install a2a-contract-test

The example inputs live in the repository. Get them first:

git clone --depth 1 https://github.com/auraoneai/a2a-contract-test.git && cd a2a-contract-test

Then run the example from the repository root:

a2a-contract-test run --agent-card examples/passing_agent/agent-card.json --format json
- uses: auraoneai/[email protected]
  with:
    agent-card: agent-card.json
Real outputPassing report for the bundled review agent, with a redacted lifecycle transcript. a2a-contract-test 0.1.5, captured 2026-11-20, trimmed.
{
  "agent": "passing-review-agent",
  "disclaimer": "Practical contract profile only; not an official A2A compliance claim.",
  "finding_count": 0,
  "findings": [],
  "passed": true,
  "tool": "a2a-contract-test",
  "transcript": [
    {
      "operation": "create_task",
      "request": {
        "headers": {
          "authorization": "[REDACTED]"
        },
        "payload": {
          "capability": "review_task",
          "input": "score this"
        }
      },
      "response": {
        "state": "submitted",
        "task_id": "task_123"
      }
    },
    {
      "operation": "poll_task",
      "request": {
        "payload": {
          "task_id": "task_123"
        }
      },
      "response": {
        "state": "working",
        "task_id": "task_123"
      }
    },
    {
      "operation": "poll_task",
      "request": {
…

Limitations

  • A practical contract profile, not an official A2A compliance certification.
  • The default suite reads files; it does not contact a live agent endpoint.

What you can do

Follow the work from input to a usable result.

Agent card checks

Required fields, capability declarations, and auth schemes.

Lifecycle checks

Create, update, cancel, and error transitions in recorded transcripts.

Redaction

Authorization headers are redacted in every report.

a2a-contract-test workflow

See how the product moves from setup through a useful output.

  1. 01

    Install

    Install a2a-contract-test 0.1.5 from the package registry.

    Package version

  2. 02

    Run on the bundled example

    Run the quick start on the synthetic fixture and compare it with the output above.

    Captured output

  3. 03

    Run on your data

    Point the same command at your own files, locally or in CI.

    Local report

Release specifications

What is included in this release

Review the current source, release, runtime, and support information.

Package
a2a-contract-test 0.1.5Discovery snapshot registry readback
Source tag
v0.1.5 (5b52b9445695)Public GitHub release tag
Sample
examples/passing_agent/, captured 2026-11-20public/open/samples.json
Data handling
The default suite runs locally against files; no agent endpoint is contacted unless a future adapter is explicitly configured.Project README

Availability

Current release and install details.

Review the current version, source, packages, downloads, supported platforms, and install options.

Verified

a2a-contract-test availability

PyPI 0.1.5 is available with a linked source tag v0.1.5.

When the work grows

See related agent evaluation and reliability workflows.

Talk to AuraOne