@nexartis/nexartis-nanda-node-sdk

The official TypeScript SDK for the Nexartis NANDA Node — agent registration, A2A discovery, trust scoring, DAG workflow orchestration, and NANDA Index resolution.

What is NANDA Node?

Project NANDA — Networked AI Agents in Decentralized Architecture — is an open agent discovery protocol that originated at MIT Media Lab. Think of it as DNS for AI agents: a decentralized layer for naming, trust, discovery, and orchestration on the agentic web.

The Nexartis NANDA Node (NNN) is Nexartis' open-source implementation of the NANDA protocol, running on Cloudflare Workers. A single NNN instance provides the NANDA Index, .well-known/agent-card.json A2A discovery endpoints, agent certification and reputation scoring, compliance auditing, webhook delivery, federation (CRDT gossip) with peer nodes, and a DAG orchestration engine for multi-agent workflows.

This SDK is the official TypeScript client for that API. It is published under Apache-2.0, has zero runtime dependencies (uses the platform fetch), runs on Node, Bun, Deno, Cloudflare Workers, and modern browsers, and exposes a namespaced, fully-typed surface with built-in retry, circuit breaking, response caching, request deduplication, OpenTelemetry trace propagation, and typed errors.

Install

pnpm add @nexartis/nexartis-nanda-node-sdk
Copy

npm install @nexartis/nexartis-nanda-node-sdk
yarn  add @nexartis/nexartis-nanda-node-sdk
bun   add @nexartis/nexartis-nanda-node-sdk

# Deno
import { NnnClient } from 'npm:@nexartis/nexartis-nanda-node-sdk';
Copy

The package is a public, scoped, provenance-signed publish on npmjs.com. No .npmrc or auth token is required to install it.

30-second quickstart

import { NnnClient } from '@nexartis/nexartis-nanda-node-sdk';

const nnn = new NnnClient({
  baseUrl: 'https://nanda.nexartis.com',
  apiKey: process.env.NNN_API_KEY,
});

// Register an agent
await nnn.agents.register({
  agent_id: 'my-agent',
  agent_url: 'https://my-agent.example.com',
  capabilities: ['text-generation', 'code-review'],
  tags: ['production', 'v2'],
});

// Search for agents
const agents = await nnn.agents.search({
  capabilities: ['text-generation'],
  min_trust: 0.8,
});

// Create and run a DAG workflow
await nnn.orchestration.createWorkflow({
  name: 'review-pipeline',
  owner_id: 'orchestrator-1',
  dag: {
    nodes: [
      { id: 'analyze', type: 'agent', data: { agent_id: 'analyzer' } },
      { id: 'review',  type: 'agent', data: { agent_id: 'reviewer' } },
    ],
    edges: [{ source: 'analyze', target: 'review' }],
  },
});
const result = await nnn.orchestration.runWorkflow('workflow-123', { prompt: 'Analyze this PR' });

// Auto-paginate
for await (const agent of nnn.agents.searchAll({ capabilities: ['code-review'] })) {
  console.log(agent.agent_id);
}

// Health check (never throws)
const healthy = await nnn.isHealthy();
Copy

Features

API overview

All methods live on namespaces under the client. The only direct methods on NnnClient are health(), isHealthy(), and deepHealth().

Full generated reference (every type, every method, every example) is hosted at https://nnn-sdk.nexartis.com.

Examples

Runnable examples live in the examples/ directory:

• register-and-discover.ts — registry lifecycle + pagination.
• orchestrate-workflow.ts — DAG create + run + status.
• a2a-routing.ts — A2A JSON-RPC with trace propagation.
• health-monitoring.ts — hooks, circuit breaker, deep health.
• workers-agent/ — Cloudflare Workers consumer.

See the examples README for prerequisites and how to run each one.

Compatibility

This SDK targets the platform fetch API and has no Node-only dependencies.

ES2022 module output, "type": "module", ships .d.ts + sourcemaps.

Contributing

We welcome contributions from the community. Read CONTRIBUTING.md for the development workflow, coding conventions, testing requirements, and review process.

All commits must be signed off under the Developer Certificate of Origin — run git commit -s to add the required Signed-off-by: trailer. A DCO status check is enforced on every pull request.

Please also review our Code of Conduct.

Governance

Project direction, maintainer responsibilities, and the decision-making process are documented in GOVERNANCE.md.

Security

To report a vulnerability, please follow the disclosure process in SECURITY.md. Do not file public GitHub issues for security reports.

License

Released under the Apache License, Version 2.0. See LICENSE for the full text and NOTICE for attribution requirements.

Copyright (c) 2025-2026 Nexartis, LLC and contributors.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0
Copy