JSPM

@a2a-compliance/cli

0.1.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 40
  • Score
    100M100P100Q84932F
  • License MIT

CLI for running A2A protocol compliance tests against agent endpoints

Package Exports

  • @a2a-compliance/cli
  • @a2a-compliance/cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@a2a-compliance/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@a2a-compliance/cli

Command-line driver for the A2A (Agent2Agent) protocol compliance test kit. Zero-config: point it at an agent URL, get a pass/fail report, CI-ready artifacts on demand.

One-shot (no install)

npx @a2a-compliance/cli run https://agent.example.com

Install globally

npm i -g @a2a-compliance/cli
a2a-compliance run https://agent.example.com

Commands

a2a-compliance run <url>   # full run (card + protocol + security)
a2a-compliance card <url>  # card-level assertions only — faster

Useful flags on run

Flag Description
--json emit the machine-readable report to stdout
--junit <path> also write a JUnit XML report
--badge <path> also write a Shields-style SVG badge
--snapshot-out <path> capture a regression baseline
--snapshot <path> compare against a baseline; exit 1 on regression
--fail-on <mode> exit-code policy: any / must (default) / never
--skip-protocol skip live JSON-RPC probing
--skip-security skip SSRF / TLS / CORS checks

CI example (GitHub Actions)

- uses: UltraSkye/a2a-compliance@v1
  with:
    url: https://agent.example.com
    junit: ./reports/a2a.junit.xml
    badge: ./badges/a2a.svg

Or call the CLI directly:

- run: |
    npx @a2a-compliance/cli run ${{ env.AGENT_URL }} \
      --junit ./reports/a2a.junit.xml \
      --fail-on must

Sample output

A2A compliance — https://agent.example.com

  ✓ [MUST]   Agent card reachable at /.well-known/agent-card.json
  ✓ [MUST]   Agent card conforms to A2A schema
  ✓ [SHOULD] Agent card declares a known protocolVersion (v1.0)
  ✓ [MUST]   Rejects invalid JSON with -32700 Parse error
  ✗ [MUST]   message/send returns a valid JSON-RPC response
      unexpected error code -32601: Method not found
  …

  11 passed, 1 warnings, 3 failed

License

MIT.