{"_id":"@aevum-network/agentcard","name":"@aevum-network/agentcard","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aevum-network/agentcard","version":"0.1.0","description":"AgentCard v1.0 — framework-neutral agent identity for A2A communication. TypeScript implementation of the IETF AgentCard standard.","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","test":"node --test dist/test.js","prepublishOnly":"npm run build"},"keywords":["agentcard","a2a","agent-to-agent","ai-agent","identity","mcp","protocol","llm","pacr","landauer","causal"],"author":{"name":"Kwai Lap Tsoi","email":"kwailapt@gmail.com"},"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/kwailapt/AgentCard.git"},"homepage":"https://github.com/kwailapt/AgentCard","bugs":{"url":"https://github.com/kwailapt/AgentCard/issues"},"devDependencies":{"@types/node":"^25.6.0","typescript":"^5.4"},"engines":{"node":">=18"},"gitHead":"64556829e414ec17db7f20b2013cc0bf0caadc60","_id":"@aevum-network/agentcard@0.1.0","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-McMK+Q17aodnGNuPVcwvdAbsYnsP5QKMZuZF+UjIG+XUV7Z4JVUFCyxbd0ZMKZqIwuJu9G3oOEIUfisGUx0LYA==","shasum":"616587ef7a5d43ae8ee882c3478350a3487c47d9","tarball":"https://registry.npmjs.org/@aevum-network/agentcard/-/agentcard-0.1.0.tgz","fileCount":6,"unpackedSize":18094,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD3w0vwGC5+l8E45fev/VdKT8RV+kJJ4k6dB2VpBu/SBQIhAPQpNfqTyaI1NdIzHDUz2/p4AEEtbQ/uXd5DN0OhXmGL"}]},"_npmUser":{"name":"aevum-org","email":"kwailapt@gmail.com"},"directories":{},"maintainers":[{"name":"aevum-org","email":"kwailapt@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentcard_0.1.0_1777276224060_0.28028120724249916"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-27T07:50:23.961Z","0.1.0":"2026-04-27T07:50:24.206Z","modified":"2026-04-27T07:50:24.390Z"},"maintainers":[{"name":"aevum-org","email":"kwailapt@gmail.com"}],"description":"AgentCard v1.0 — framework-neutral agent identity for A2A communication. TypeScript implementation of the IETF AgentCard standard.","homepage":"https://github.com/kwailapt/AgentCard","keywords":["agentcard","a2a","agent-to-agent","ai-agent","identity","mcp","protocol","llm","pacr","landauer","causal"],"repository":{"type":"git","url":"git+https://github.com/kwailapt/AgentCard.git"},"author":{"name":"Kwai Lap Tsoi","email":"kwailapt@gmail.com"},"bugs":{"url":"https://github.com/kwailapt/AgentCard/issues"},"license":"Apache-2.0","readme":"# agentcard\n\n> **AgentCard v1.0 — framework-neutral agent identity for A2A communication.**\n\n[![npm](https://img.shields.io/npm/v/@aevum-network/agentcard.svg)](https://www.npmjs.com/package/@aevum-network/agentcard)\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/kwailapt/AgentCard/blob/main/LICENSE)\n[![AgentCard v1.0](https://img.shields.io/badge/AgentCard-v1.0-orange.svg)](https://github.com/kwailapt/AgentCard)\n\nTypeScript implementation of the [AgentCard](https://github.com/kwailapt/AgentCard) open standard ([IETF draft-aevum-agentcard-00](https://datatracker.ietf.org/doc/draft-aevum-agentcard/)).\n\n## Installation\n\n```bash\nnpm install @aevum-network/agentcard\n```\n\n## Quick Start\n\n```typescript\nimport { validate, assertValid, parse, stringify, LANDAUER_FLOOR_JOULES } from \"@aevum-network/agentcard\";\n\nconst card = {\n  agent_id: \"01HZQK3P8EMXR9V7T5N2W4J6C0\",\n  name: \"MyAgent\",\n  version: \"1.0.0\",\n  capabilities: [\n    { id: \"text.generate\", description: \"Generate text from a prompt.\" },\n  ],\n  endpoint: { protocol: \"https\", url: \"https://my-agent.example.com/api\" },\n};\n\n// Validate (returns error array — empty = valid)\nconst errors = validate(card);\n\n// Or throw on invalid\nassertValid(card);\n\n// Serialize / parse\nconst json = stringify(card, 2);\nconst parsed = parse(json);\n```\n\n## Validation Rules\n\n- **agent_id**: 26-character Crockford Base32 ULID\n- **name**: 1–128 characters\n- **version**: semver 2.0 (`MAJOR.MINOR.PATCH[-pre][+build]`)\n- **capabilities**: ≥1 entry, each `id` matches `^[a-z0-9][a-z0-9._-]*$`\n- **endpoint.url**: non-empty\n- **pricing.base_cost_joules**: if non-zero, must be ≥ Landauer floor (2.854×10⁻²¹ J)\n- **goal_subscriptions**: valid ULID target, `coupling_scale` ∈ (0, 1]\n\n## Types\n\nFull TypeScript types exported:\n\n```typescript\nAgentCardData, Capability, AuthConfig, Endpoint,\nPricingModel, EpiplexityCert, Metadata, GoalSubscription,\nValidationError\n```\n\n## IETF Standards\n\n- [draft-aevum-agentcard-00](https://datatracker.ietf.org/doc/draft-aevum-agentcard/) — Agent identity & capability\n- [draft-aevum-causal-intervention-record-00](https://datatracker.ietf.org/doc/draft-aevum-causal-intervention-record/) — PACR wire format\n\n## Related Packages\n\n| Package | Language | Description |\n|---------|----------|-------------|\n| [`agentcard-adapters`](https://pypi.org/project/agentcard-adapters/) | Python | LangChain/CrewAI/AutoGen adapters |\n| [`agentcard-mcp`](https://pypi.org/project/agentcard-mcp/) | Python | MCP server for Claude Desktop |\n\n## License\n\nApache-2.0\n","readmeFilename":"README.md","_rev":"1-5abb31b4a74f48047cc8793004780455"}