agentcard

AgentCard v1.0 — framework-neutral agent identity for A2A communication.

TypeScript implementation of the AgentCard open standard (IETF draft-aevum-agentcard-00).

Installation

npm install @aevum-network/agentcard

Quick Start

import { validate, assertValid, parse, stringify, LANDAUER_FLOOR_JOULES } from "@aevum-network/agentcard";

const card = {
  agent_id: "01HZQK3P8EMXR9V7T5N2W4J6C0",
  name: "MyAgent",
  version: "1.0.0",
  capabilities: [
    { id: "text.generate", description: "Generate text from a prompt." },
  ],
  endpoint: { protocol: "https", url: "https://my-agent.example.com/api" },
};

// Validate (returns error array — empty = valid)
const errors = validate(card);

// Or throw on invalid
assertValid(card);

// Serialize / parse
const json = stringify(card, 2);
const parsed = parse(json);

Validation Rules

• agent_id: 26-character Crockford Base32 ULID
• name: 1–128 characters
• version: semver 2.0 (MAJOR.MINOR.PATCH[-pre][+build])
• capabilities: ≥1 entry, each id matches ^[a-z0-9][a-z0-9._-]*$
• endpoint.url: non-empty
• pricing.base_cost_joules: if non-zero, must be ≥ Landauer floor (2.854×10⁻²¹ J)
• goal_subscriptions: valid ULID target, coupling_scale ∈ (0, 1]

Types

Full TypeScript types exported:

AgentCardData, Capability, AuthConfig, Endpoint,
PricingModel, EpiplexityCert, Metadata, GoalSubscription,
ValidationError

IETF Standards

• draft-aevum-agentcard-00 — Agent identity & capability
• draft-aevum-causal-intervention-record-00 — PACR wire format

Related Packages

| Package | Language | Description | |---------|----------|-------------| | agentcard-adapters | Python | LangChain/CrewAI/AutoGen adapters | | agentcard-mcp | Python | MCP server for Claude Desktop |

License

Apache-2.0