Build an ATH Agent

1. discover()      → Learn what providers are available
2. register()      → Register your agent, get approved for specific scopes
3. authorize()     → Get a URL for the user to approve OAuth access
4. exchangeToken() → After user approves, get an ATH token
5. proxy()         → Call the service API through the ATH gateway

import { ATHClient } from "ath-client-sdk";
import { generateKeyPair } from "jose";

const { privateKey } = await generateKeyPair("ES256");

const client = new ATHClient({
  gatewayUrl: "http://localhost:3000",
  agentId: "https://my-agent.example.com/.well-known/agent.json",
  privateKey,
});

// 1. Discover available providers
const discovery = await client.discover();
console.log("Available providers:", discovery.supported_providers);

// 2. Register your agent (one-time, Phase A)
const reg = await client.register({
  developer: { name: "My Company", id: "dev-001" },
  providers: [{ provider_id: "github", scopes: ["repo", "read:user"] }],
  purpose: "Code review assistant",
});
console.log("Registered:", reg.client_id);
console.log("Approved scopes:", reg.approved_providers);

// 3. Start authorization (per-user, Phase B)
const auth = await client.authorize("github", ["repo", "read:user"]);
console.log("User should visit:", auth.authorization_url);

// 4. After user approves, exchange for ATH token
const token = await client.exchangeToken(code, auth.ath_session_id);
console.log("Effective scopes:", token.effective_scopes);
console.log("Scope intersection:", token.scope_intersection);

// 5. Call APIs through the ATH proxy
const user = await client.proxy("github", "GET", "/user");
console.log("GitHub user:", user);

import { ATHClient, ATHClientError } from "ath-client-sdk";

try {
  const reg = await client.register({ /* ... */ });
} catch (err) {
  if (err instanceof ATHClientError) {
    console.error(`ATH Error [${err.code}]: ${err.message}`);
  }
}