SDK

TypeScript SDK

Create, sign, and verify APS passports in Node.js, Deno, and TypeScript agent frameworks.

typescript

import { AgentPassport, generateKeyPair } from 'agent-passport-standard';

const { publicKey, privateKey } = generateKeyPair();

const passport = await AgentPassport.create({
  id: 'did:key:z6MkExample',
  publicKey: Buffer.from(publicKey).toString('hex'),
  ownerDID: 'did:key:z6MkOwner',
  skills: [{
    name: 'typescript',
    version: '1.0.0',
    description: 'TypeScript agent',
    capabilities: ['code_write'],
    hash: '0x' + 'ab'.repeat(32),
  }],
  soul: {
    personality: 'focused',
    work_style: 'test-first',
    constraints: [],
    hash: '0x' + 'cd'.repeat(32),
    frozen: false,
  },
  policies: {
    policy_set_hash: '0x' + 'ef'.repeat(32),
    summary: ['read-only'],
  },
  lineage: { kind: 'original', parents: [], generation: 0 },
});

await passport.sign(privateKey);
console.log(await passport.verify(publicKey));

Install

bash

npm install agent-passport-standard

Use cases

  • Issue a passport for a TypeScript agent or service worker.
  • Verify passport signatures before accepting tool calls.
  • Bind work receipts to a passport snapshot hash.

Runtime notes

The package is published as agent-passport-standard. Do not use the deprecated agent-passport-sdk package name for new integrations.