NANDA Node SDK

@nexartis/nexartis-nanda-node-sdk

The official TypeScript SDK for the Nexartis NANDA Node — agent registration, A2A discovery, DAG-based workflow orchestration, and NANDA index lookups. Zero framework dependencies.

Installation

# GitHub Packages (scoped)

npm install @nexartis/nexartis-nanda-node-sdk

Quick Start

// Import the client import { NnnClient } from '@nexartis/nexartis-nanda-node-sdk/core'; // Initialize const nnn = new NnnClient({\n baseUrl: 'https://nanda.nexartis.com', apiKey: 'your-api-key', }); // Register an agent await nnn.registerAgent({\n agent_id: 'my-agent', agent_url: 'https://my-agent.example.com', capabilities: ['code-generation', 'analysis'], tags: ['llm', 'typescript'], }); // Discover agents const agents = await nnn.searchAgents({\n q: 'code generation', capabilities: ['code-generation'], }); // Create a workflow with a DAG await nnn.createWorkflow({\n name: 'Analysis Pipeline', owner_id: 'my-org', dag: {\n nodes: [{ id: 'a', type: 'agent' }, { id: 'b', type: 'agent' }], edges: [{ source: 'a', target: 'b' }], }, });

Configuration

PropertyTypeDescription
baseUrlstringNNN base URL (required)
apiKeystring?Bearer token for authenticated endpoints
verboseboolean?Enable debug logging
retryConfigNnnRetryConfig?Custom retry settings (maxRetries, baseDelayMs, maxDelayMs, timeoutMs)

API Reference

Agent Registry

registerAgent(req)

Register an agent on the NANDA network. Provide agent_id, agent_url, and optional capabilities/tags.

Returns: RegisterAgentResponse

lookupAgent(agentId)

Look up a single agent by its ID. Returns full agent record with URLs and capabilities.

Returns: NnnAgent

searchAgents(params?)

Search agents by query, capabilities, tags, trust score, jurisdiction, or protocol.

Returns: NnnAgent[]

listAgents()

List all registered agents on the node.

Returns: NnnAgent[]

Agent Facts & Card

getAgentFacts(agentId)

Get agent facts (AgentFacts v1/v2) — rich metadata including trust, capabilities, compliance.

Returns: AgentFacts

getAgentCard()

Get the node's own A2A agent card from /.well-known/agent-card.json.

Returns: AgentCard

getNandaIndex()

Get the NANDA index descriptor from /.well-known/nanda-index. Includes supported protocols, quilt types, and agent count.

Returns: NandaIndex

DAG Orchestration

createWorkflow(req)

Create a multi-agent workflow defined by a DAG (nodes + edges). Supports templates and metadata.

Returns: { status: string; workflow: WorkflowRecord }

listWorkflows(params?)

List workflows. Filter by ownerId and status.

Returns: { workflows: WorkflowRecord[] }

Health & Stats

health()

Full health check with DB, R2, and KV subsystem status.

Returns: NnnHealthStatus

isHealthy()

Quick boolean health check. Never throws.

Returns: boolean

stats()

Get registry statistics — total agents, capabilities, and recent registrations.

Returns: NnnStats

GitHub Repository

View the source, report issues, and contribute.

View on GitHub →
Related reading NestJS Quickstart — integrate NANDA into a NestJS application step by step · Developer API Keys — authentication, key management, and tier rate limits

Coming Soon

By Invitation Only