Identity-Based Authentication for Multi-Agent Systems

# Install both packages
npm install @private.me/autogen-xlink autogen-js

import { AutoGenXLinkAgent } from '@private.me/autogen-xlink';

// Create agents (identity generated automatically)
const researcher = new AutoGenXLinkAgent({ name: 'researcher' });
const writer = new AutoGenXLinkAgent({ name: 'writer' });

// Agent-to-agent call (no credentials needed!)
const result = await researcher.call(writer.getDID(), {
  task: 'write-summary',
  topic: 'AI trends'
});

if (result.ok) {
  console.log('Result:', result.value);
}

// OAuth token expires
let accessToken = await getAccessToken();

// All agents retry simultaneously when token expires
if (isExpired(accessToken)) {
  try {
    accessToken = await refreshAccessToken(); // 54,853ms latency
  } catch (error) {
    throw new Error('Re-authentication required');
  }
}

// System-wide slowdown as all agents hit refresh endpoint

// Create agent with cryptographic identity
const agent = new AutoGenXLinkAgent();

// Make request (identity-based, can't be stolen)
const result = await agent.call(serviceName, payload);

// 0.36ms auth overhead, no refresh logic, no cascades

// POST to purchase endpoint with product ID
const response = await fetch('https://private.me/aci/checkout', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    product: 'autogen-xlink',
    tier: 'basic' // or 'middle', 'enterprise'
  })
});

// Returns Stripe Checkout URL
const { url } = await response.json();
window.location = url; // Redirect to Stripe

npm install @private.me/autogen-xlink autogen-js

yarn add @private.me/autogen-xlink autogen-js

pnpm add @private.me/autogen-xlink autogen-js

import { AutoGenXLinkAgent } from '@private.me/autogen-xlink';

const researcher = new AutoGenXLinkAgent({
  name: 'researcher',
  verbose: true
});

const writer = new AutoGenXLinkAgent({
  name: 'writer',
  verbose: true
});

console.log(`Researcher DID: ${researcher.getDID()}`);
// Output: Researcher DID: did:key:z6Mkh...

console.log(`Writer DID: ${writer.getDID()}`);
// Output: Writer DID: did:key:z6Mke...

// Call another agent using its DID
const result = await researcher.call(writer.getDID(), {
  task: 'write-summary',
  topic: 'AI trends',
  data: {
    finding1: 'Large models improving efficiency',
    finding2: 'Reduced hallucination rates'
  }
});

if (result.ok) {
  console.log('Result:', result.value);
} else {
  console.error('Error:', result.error);
}

// Send message to another agent
await researcher.send(writer.getDID(), {
  type: 'notification',
  message: 'Research complete, ready for writing'
});

// Receive messages
const messages = await writer.receive();
if (messages.ok) {
  for (const msg of messages.value) {
    console.log('Received:', msg);
  }
}

// Export identity for storage
const exportResult = await researcher.exportIdentity();
if (exportResult.ok) {
  await fs.writeFile('researcher.key', exportResult.value);
}

// Import identity on restart
const identityBytes = await fs.readFile('researcher.key');
const importResult = await AutoGenXLinkAgent.fromIdentity(identityBytes);

if (importResult.ok) {
  const restoredResearcher = importResult.value;
  console.log(`Restored: ${restoredResearcher.getDID()}`);
}

// Configure credentials
const apiKey = process.env.AUTOGEN_API_KEY;
if (!apiKey) throw new Error('API key not configured');

// Every agent needs credentials
const agent1ApiKey = process.env.AGENT1_API_KEY;
const agent2ApiKey = process.env.AGENT2_API_KEY;

// Make request with credentials
const response = await fetch(agentUrl, {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

if (response.status === 401) {
  throw new Error('Authentication failed');
}

// Create agents (identity generated automatically)
const agent1 = new AutoGenXLinkAgent({ name: 'agent1' });
const agent2 = new AutoGenXLinkAgent({ name: 'agent2' });

// Make request (identity-based, can't be stolen)
const result = await agent1.call(agent2.getDID(), payload);

if (!result.ok) {
  // Handle error (but never "key expired")
  console.error(result.error);
}

// Store identity in file (for testing only)
const identity = await agent.exportIdentity();
if (identity.ok) {
  await fs.writeFile('agent.key', identity.value);
}

// Store in secure key management system
const identity = await agent.exportIdentity();
if (identity.ok) {
  await kms.storeSecret('agent-identity', identity.value);
}

Traditional: Generate → Use → Refresh → Expire → Repeat
xLink:       Generate → Use → (forever, no expiry)

did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK
│   │   └─────────────────────────────┬─────────────────────────┘
│   │                                  │
│   │                          Public key (base58)
│   │
│   method (key or privateme)
│
scheme (did)

// Wrap in try/catch
try {
  const agent = new AutoGenXLinkAgent();
  console.log(`Created: ${agent.getDID()}`);
} catch (error) {
  console.error('Agent creation failed:', error);
}

// Always check result.ok
const result = await agent.call('service', data);
if (result.ok) {
  console.log('Success:', result.value);
} else {
  console.error('Failed:', result.error);
}

// First run: export identity
const agent = new AutoGenXLinkAgent();
const identity = await agent.exportIdentity();
await fs.writeFile('agent.key', identity.value);

// Subsequent runs: import identity
const identityBytes = await fs.readFile('agent.key');
const result = await AutoGenXLinkAgent.fromIdentity(identityBytes);
const agent = result.value;

Token check:     10ms
Token expired:   yes
Refresh token:   54,853ms ← BOTTLENECK
Retry request:   50ms
────────────────────────
Total:           54,913ms

Sign request:    0.36ms
Send request:    50ms
────────────────────────
Total:           50.36ms (1091× faster)