auth-agents 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,137 @@
+# auth-agents
+
+Verify AI agent identities with [Agent Auth](https://getagentauth.com). DID-based authentication using Ed25519 and Verifiable Credentials.
+
+## Install
+
+```bash
+npm install auth-agents
+```
+
+## Quick Start — Verify a Credential
+
+```typescript
+import { AuthAgents } from "auth-agents"
+
+const client = new AuthAgents()
+
+const result = await client.verify("eyJhbGciOiJFZERTQSJ9...")
+
+if (result.valid) {
+  console.log(result.did)            // "did:key:z6Mk..."
+  console.log(result.agent_name)     // "Claude"
+  console.log(result.agent_model)    // "claude-opus-4-6"
+  console.log(result.agent_provider) // "Anthropic"
+  console.log(result.agent_purpose)  // "Research assistant"
+  console.log(result.expires_at)     // "2026-02-27T01:58:15.000Z"
+}
+```
+
+## Website Integration (Next.js)
+
+```typescript
+// app/api/auth/agent/route.ts
+import { AuthAgents } from "auth-agents"
+
+const authAgents = new AuthAgents()
+
+export async function POST(request: Request) {
+  const { credential } = await request.json()
+
+  const result = await authAgents.verify(credential)
+
+  if (!result.valid) {
+    return Response.json({ error: result.message }, { status: 401 })
+  }
+
+  // Create a session with the verified agent identity
+  const sessionId = crypto.randomUUID()
+  await db.insert("sessions", {
+    session_id: sessionId,
+    did: result.did,
+    agent_name: result.agent_name,
+    agent_model: result.agent_model,
+    expires_at: result.expires_at,
+  })
+
+  return Response.json({ authenticated: true, session_id: sessionId })
+}
+```
+
+## Website Integration (Express.js)
+
+```typescript
+import express from "express"
+import { AuthAgents } from "auth-agents"
+
+const app = express()
+const authAgents = new AuthAgents()
+
+app.post("/auth/agent", express.json(), async (req, res) => {
+  const { credential } = req.body
+  const result = await authAgents.verify(credential)
+
+  if (!result.valid) {
+    return res.status(401).json({ error: result.message })
+  }
+
+  // Agent verified — create session
+  req.session.agent = {
+    did: result.did,
+    name: result.agent_name,
+    model: result.agent_model,
+  }
+
+  res.json({ authenticated: true, agent_name: result.agent_name })
+})
+```
+
+## Full Agent Auth Flow
+
+```typescript
+import { AuthAgents } from "auth-agents"
+
+const client = new AuthAgents()
+
+// 1. Register
+const identity = await client.register({
+  agent_name: "Claude",
+  agent_model: "claude-opus-4-6",
+  agent_provider: "Anthropic",
+  agent_purpose: "Research assistant",
+})
+
+// 2. Request challenge
+const challenge = await client.challenge(identity.did)
+
+// 3. Sign nonce and authenticate
+const auth = await client.authenticate({
+  challenge_id: challenge.challenge_id,
+  did: identity.did,
+  signature: signedNonce, // base64url Ed25519 signature of challenge.nonce
+})
+// auth.credential — fresh VC-JWT
+// auth.session_token — session ID
+```
+
+## API
+
+### `new AuthAgents(config?)`
+
+- `config.baseUrl` — API base URL (default: `https://auth.getagentauth.com`)
+
+### `client.verify(credential)` — Verify a VC-JWT credential
+
+### `client.register(input)` — Register a new agent identity
+
+### `client.challenge(did)` — Request an auth challenge
+
+### `client.authenticate(input)` — Submit signed challenge
+
+## Documentation
+
+Full API reference at [getagentauth.com/docs](https://getagentauth.com/docs/)
+
+## License
+
+MIT - Agent Auth

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 interface AuthAgentsConfig {
-    /** Base URL of the Auth-Agents API. Defaults to https://auth.auth-agents.com */
+    /** Base URL of the Agent Auth API. Defaults to https://auth.getagentauth.com */
     baseUrl?: string;
 }
 interface VerifyResult {
@@ -76,7 +76,7 @@ declare class AuthAgents {
     private baseUrl;
     constructor(config?: AuthAgentsConfig);
     /**
-     * Verify a VC-JWT credential issued by Auth-Agents.
+     * Verify a VC-JWT credential issued by Agent Auth.
      *
      * @param credential - The VC-JWT string from the agent
      * @returns Verified agent identity or error details

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 interface AuthAgentsConfig {
-    /** Base URL of the Auth-Agents API. Defaults to https://auth.auth-agents.com */
+    /** Base URL of the Agent Auth API. Defaults to https://auth.getagentauth.com */
     baseUrl?: string;
 }
 interface VerifyResult {
@@ -76,7 +76,7 @@ declare class AuthAgents {
     private baseUrl;
     constructor(config?: AuthAgentsConfig);
     /**
-     * Verify a VC-JWT credential issued by Auth-Agents.
+     * Verify a VC-JWT credential issued by Agent Auth.
      *
      * @param credential - The VC-JWT string from the agent
      * @returns Verified agent identity or error details

package/dist/index.js

@@ -24,14 +24,14 @@ __export(index_exports, {
   verify: () => verify
 });
 module.exports = __toCommonJS(index_exports);
-var DEFAULT_BASE_URL = "https://auth.auth-agents.com";
+var DEFAULT_BASE_URL = "https://auth.getagentauth.com";
 var AuthAgents = class {
   constructor(config) {
     this.baseUrl = (config?.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
   }
   // ---- Credential Verification (for websites) ----------------------------
   /**
-   * Verify a VC-JWT credential issued by Auth-Agents.
+   * Verify a VC-JWT credential issued by Agent Auth.
    *
    * @param credential - The VC-JWT string from the agent
    * @returns Verified agent identity or error details

package/dist/index.mjs

@@ -1,12 +1,12 @@
 // src/index.ts
-var DEFAULT_BASE_URL = "https://auth.auth-agents.com";
+var DEFAULT_BASE_URL = "https://auth.getagentauth.com";
 var AuthAgents = class {
   constructor(config) {
     this.baseUrl = (config?.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
   }
   // ---- Credential Verification (for websites) ----------------------------
   /**
-   * Verify a VC-JWT credential issued by Auth-Agents.
+   * Verify a VC-JWT credential issued by Agent Auth.
    *
    * @param credential - The VC-JWT string from the agent
    * @returns Verified agent identity or error details

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "auth-agents",
-  "version": "0.1.1",
-  "description": "Verify AI agent identities with Auth-Agents. DID-based authentication using Ed25519 and Verifiable Credentials.",
+  "version": "0.1.3",
+  "description": "Verify AI agent identities with Agent Auth. DID-based authentication using Ed25519 and Verifiable Credentials.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -12,13 +12,17 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
+    "agent-auth",
+    "getagentauth",
     "auth-agents",
     "ai-agent",
     "did",
@@ -34,7 +38,7 @@
     "type": "git",
     "url": "https://github.com/AgenthAgent/auth-agents-sdk-node"
   },
-  "homepage": "https://auth-agents.com",
+  "homepage": "https://getagentauth.com",
   "devDependencies": {
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"