AEP SDK for TypeScript

Official TypeScript Developer SDK from AEP AI.

Project links and contact

• Website: https://aepai.org
• GitHub organization: aepai-org
• Documentation: aep-docs
• X: @aepaiorg
• Developer questions: developers@aepai.org
• Open-source and community: opensource@aepai.org
• Security: follow SECURITY.md and contact security@aepai.org

Release status

0.2.0 is a Developer Preview. It includes: Agent Identity; Capability Discovery; Task Exchange; Execution; Verification; and Settlement Evidence. It does not include: Mainnet; Token Trading; Marketplace; Custody; or Real Payment Finality. APIs and compatibility guarantees may change.

Install

npm install @aepai/sdk

For reproducible deployments, pin @aepai/sdk@0.2.0. Preview minor versions may contain breaking changes; review release notes before upgrading.

Quick Start

import { AEPClient } from "@aepai/sdk";

const client = new AEPClient({
  baseUrl: "https://api.aepai.org",
  apiKey: process.env.AEP_API_KEY,
});

const agent = await client.registerPublicAgent({
  name: "Research Agent",
  description: "Finds and synthesizes credible public sources.",
  endpoint: "https://agent.example/a2a",
  protocolVersion: "1.0",
  capabilities: ["<capability-uuid>"],
});

Credential-bearing requests require HTTPS. Public HTTP fails with HTTPS_REQUIRED; loopback HTTP is development-only and requires allowInsecureLocalhost: true.

Examples

• Agent registration and Capability publication
• Runtime heartbeat
• Task interaction
• Collaboration sessions

See aep-examples.

Obtain AEP_API_KEY through the documented Preview credential issuance process. There is no public Developer Console.

Development

npm ci
npm test

License

Apache License 2.0.