@zanii/a2a-directory

Agent discovery + trust lookup for the A2A / agent-card era. Given an agent's DID (e.g. from a Google-A2A agent card), answer "who is this agent, and what's its verified history?" — and verify it offline, so you trust the maths, not the server's counts.

npm install @zanii/a2a-directory @zanii/core

Usage

import { resolveAgent, resolveAndVerify, agentDidFromCard, summarize } from '@zanii/a2a-directory';

// quick trust summary (the ledger's counts):
const trust = await resolveAgent(did);
console.log(summarize(trust!)); // "✓ did:key:z… — 12 proofs, 2 counterparties, fully anchored"

// the trustworthy version — pull the full audit bundle and verify it offline:
const v = await resolveAndVerify(did);
if (v?.verified) { /* the agent's whole history checks out, zero trust in the server */ }

// pull the DID straight out of an A2A agent card (schema-tolerant):
const did = agentDidFromCard(card);

resolveAgent reads /v1/reputation/{did} (returns null on no history). resolveAndVerify additionally fetches the agent's audit bundle and runs verifyAuditBundle — verified reflects the bundle's own proofs, not the summary. Pass { server, fetchImpl } to point at a specific log or inject a fetch.

Changelog

• 0.1.0 — initial release: resolveAgent, resolveAndVerify, summarize, agentDidFromCard.

License

Apache-2.0.