@agent-seal/sdk

Give your AI agent a signed, verifiable identity in one line.

@agent-seal/sdk registers your AI agent with the Agent Seal Registry — a court-grade, cryptographic identity system for autonomous agents. Keys are generated locally and never leave your machine.

Quick start

import { seal } from '@agent-seal/sdk'

const agent = await seal({
  name: 'my-agent',
  architect: '[email protected]',
  capabilities: ['code-review'],
})
console.log(agent.sijil, agent.sealUrl)

That's it. Your agent now has a public, cryptographically verifiable identity.

Install

npm install @agent-seal/sdk

CLI

# Register
npx @agent-seal/sdk register --name my-agent --architect [email protected] --capabilities code-review,pr-analysis

# Check status
npx @agent-seal/sdk status <agent-id>

# Verify seal and card
npx @agent-seal/sdk verify <agent-id>

API

seal(options)

Registers an agent and returns an AgentRegistration object.

import { seal } from '@agent-seal/sdk'

const agent = await seal({
  name: 'my-agent',
  architect: '[email protected]',
  capabilities: ['code-review', 'pr-analysis'],
  model: 'claude-sonnet-4-6',      // optional
  privateKey: process.env.AGENT_KEY, // optional — re-use an existing identity
})

| Property | Type | Description | |---|---|---| | agent.sijil | number \| null | Sijil number in the registry | | agent.sealUrl | string | URL to the agent's SVG seal | | agent.badgeUrl | string | URL to the embeddable badge | | agent.verifyUrl | string | URL to verify the seal | | agent.agentId | string | UUID in the registry | | agent.publicKey | string | Hex-encoded Ed25519 public key | | agent.manifestHash | string | SHA-256 hash of the covenant |

register(options) / status(agentId) / verify(agentId)

Lower-level named exports for direct control.

Error handling

import { seal, AgentSealError, RateLimitError } from '@agent-seal/sdk'

try {
  const agent = await seal({ name: 'my-agent', architect: '[email protected]' })
} catch (err) {
  if (err instanceof RateLimitError) {
    console.error(`Rate limited. Retry in ${err.retryAfter}s.`)
  } else if (err instanceof AgentSealError) {
    console.error(`Registration failed: ${err.message}`)
  }
}

Key management

On first use, @agent-seal/sdk generates an Ed25519 keypair and stores it at:

~/.agent-seal/keys/private.hex   (mode 0600)
~/.agent-seal/keys/public.hex    (mode 0600)

The private key never leaves your machine. To re-use an identity across environments (e.g., CI), pass privateKey as a hex string.

What is Agent Seal?

Agent Seal is a public registry that gives AI agents cryptographic, human-accountable identities. Every registered agent receives a Sijil number, a signed covenant, and a public seal — verifiable by anyone at agent-seal.xyz/verifier.

agent-seal.xyz · Verify an agent · Registry API