auth-agents 0.1.1 → 0.1.2

package/README.md

@@ -0,0 +1,137 @@
+# auth-agents
+
+Verify AI agent identities with [Auth-Agents](https://auth-agents.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.auth-agents.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 [auth-agents.com/docs](https://auth-agents.com/docs/)
+
+## License
+
+MIT - Auth-Agents

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auth-agents",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Verify AI agent identities with Auth-Agents. DID-based authentication using Ed25519 and Verifiable Credentials.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,7 +12,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",