Protocol Documentation

npm install @bluefly/duadp

curl https://discover.duadp.org/.well-known/duadp | jq .

curl https://discover.duadp.org/api/v1/agents | jq .agents[].name

curl "https://discover.duadp.org/api/v1/search?q=code+review" | jq .

curl -X POST https://discover.duadp.org/api/v1/publish \
  -H "Content-Type: application/json" \
  -d @my-agent-manifest.json

curl -X POST https://discover.duadp.org/api/v1/publish \
  -H "Content-Type: application/json" \
  -d '{
    "ossa_version": "0.4.6",
    "name": "my-agent",
    "version": "1.0.0",
    "description": "My custom agent",
    "capabilities": ["text-generation"],
    "llm": { "provider": "anthropic", "model": "claude-sonnet-4-20250514" }
  }'

curl -X POST https://discover.duadp.org/api/v1/validate \
  -H "Content-Type: application/json" \
  -d @my-agent-manifest.json

# Response:
# { "valid": true, "schema_version": "0.4.6", "errors": [], "warnings": [] }

npm install @bluefly/duadp

import { UadpClient, resolveGaid } from '@bluefly/duadp';

const client = new UadpClient('https://discover.duadp.org');

// Discover the node
const manifest = await client.discover();
console.log(manifest.node_name, manifest.protocol_version);

// List agents
const agents = await client.listAgents({ limit: 10 });
console.log(`Found ${agents.meta.total} agents`, agents.data);

// List skills and tools
const skills = await client.listSkills();
const tools = await client.listTools();

// Search across everything
const results = await client.search({
  q: 'document analysis',
  kind: 'agent',
  trust_tier: 'verified-signature',
  facets: true,
});

// Publish an agent (requires token)
const authed = new UadpClient('https://discover.duadp.org', {
  token: process.env.DUADP_TOKEN,
});
await authed.publishAgent({
  name: 'my-agent',
  version: '1.0.0',
  description: 'Custom document analyzer',
  capabilities: ['text-extraction'],
});

// Resolve a GAID URI directly
const { client: resolved, kind, name } = resolveGaid(
  'duadp://skills.sh/skills/web-search'
);
const skill = await resolved.getSkill(name);

// Federation
const federation = await client.getFederation();
await authed.registerAsPeer({
  url: 'https://my-node.example.com',
  did: 'did:web:my-node.example.com',
});

// Advanced: reputation, governance, health
const rep = await client.getAgentReputation('duadp://acme.com/agents/scanner');
const gov = await client.getGovernance();
const health = await client.getHealth();

pip install duadp

from duadp import DuadpClient

client = DuadpClient("https://discover.duadp.org")

# Discover the node
manifest = client.discover()
print(f"{manifest['protocol']} v{manifest['version']}")

# List agents
agents = client.list_agents(limit=10)
print(f"Found {agents['total']} agents")
for agent in agents["agents"]:
    print(f"  {agent['name']} — {agent['description']}")

# List skills and tools
skills = client.list_skills()
tools = client.list_tools()

# Search across everything
results = client.search(
    q="document analysis",
    capability="text-extraction",
    kind="agent",
)
for r in results["results"]:
    print(f"  {r['name']} (score: {r['relevance_score']})")

# Publish an agent
import os
authed = DuadpClient("https://discover.duadp.org", token=os.environ["DUADP_TOKEN"])
authed.publish_agent({
    "ossa_version": "0.4.6",
    "name": "my-agent",
    "version": "1.0.0",
    "description": "Custom document analyzer",
    "capabilities": ["text-extraction"],
})

# Federation
peers = client.federation_list()
authed.federation_register({
    "url": "https://my-node.example.com",
    "did": "did:web:my-node.example.com",
})

# Governance & health
governance = client.governance()
health = client.health()