Class AgentsNamespace

Index

Methods

createVersion delete deprecate getCard getFacts getNandaIndex list listAll listVersions lookup refresh register search searchAll tombstone update updateStatus

Methods

createVersion

createVersion(
agentId: string,
req: CreateAgentVersionRequest,
): Promise<{ status: string; version: AgentVersion }>
POST /api/agents/:agentId/versions — Create a new agent version.
Parameters
- agentId: string
- req: CreateAgentVersionRequest
Returns Promise<{ status: string; version: AgentVersion }>
- Defined in src/core/namespaces/agents.ts:181

delete

delete(agentId: string): Promise<{ status: string }>
DELETE /agents/:id — Delete an agent from the registry.
Parameters
- agentId: string
Returns Promise<{ status: string }>
- Defined in src/core/namespaces/agents.ts:152

deprecate

deprecate(
agentId: string,
req: DeprecateAgentRequest,
): Promise<DeprecateAgentResponse>
POST /api/agents/:agentId/deprecate — Deprecate an agent with a grace period.
Parameters
- agentId: string
- req: DeprecateAgentRequest
Returns Promise<DeprecateAgentResponse>
- Defined in src/core/namespaces/agents.ts:164

getCard

getCard(): Promise<AgentCard>
GET /.well-known/agent-card.json — Get the node's own A2A agent card.

Returns Promise<AgentCard>
- Defined in src/core/namespaces/agents.ts:128

getFacts

getFacts(agentId: string): Promise<AgentFacts>
GET /agentfacts/:id — Get agent facts.
Parameters
- agentId: string
Returns Promise<AgentFacts>
- Defined in src/core/namespaces/agents.ts:123

getNandaIndex

getNandaIndex(): Promise<NandaIndex>
GET /.well-known/nanda-index — Get the NANDA index descriptor.

Returns Promise<NandaIndex>
- Defined in src/core/namespaces/agents.ts:133

list

list(): Promise<NnnAgent[]>
GET /list — List all registered agents.

Returns Promise<NnnAgent[]>
- Defined in src/core/namespaces/agents.ts:63

listAll

listAll(params?: { cursor?: string; limit?: number }): AsyncGenerator<NnnAgent>
Auto-paginating list — yields all registered agents across pages.
Parameters
- params: { cursor?: string; limit?: number } = {}
Returns AsyncGenerator<NnnAgent>
- Defined in src/core/namespaces/agents.ts:101

listVersions

listVersions(
agentId: string,
): Promise<{ agent_id: string; count: number; versions: AgentVersion[] }>
GET /api/agents/:agentId/versions — List all versions for an agent.
Parameters
- agentId: string
Returns Promise<{ agent_id: string; count: number; versions: AgentVersion[] }>
- Defined in src/core/namespaces/agents.ts:176

lookup

lookup(agentId: string): Promise<NnnAgent>
GET /lookup/:id — Lookup a single agent by ID.
Parameters
- agentId: string
Returns Promise<NnnAgent>
- Defined in src/core/namespaces/agents.ts:43

refresh

refresh(agentId: string): Promise<AgentRefreshResult>
POST /agents/:id/refresh — Re-crawl an agent's card and update facts.
Parameters
- agentId: string
Returns Promise<AgentRefreshResult>
- Defined in src/core/namespaces/agents.ts:158

register

register(req: RegisterAgentRequest): Promise<RegisterAgentResponse>
POST /register — Register an agent on the NANDA network.
Parameters
- req: RegisterAgentRequest
Returns Promise<RegisterAgentResponse>
- Defined in src/core/namespaces/agents.ts:37

search

search(params?: SearchAgentsParams): Promise<NnnAgent[]>
GET /search?q=&capabilities=&tags= — Search agents.
Parameters
- params: SearchAgentsParams = {}
Returns Promise<NnnAgent[]>
- Defined in src/core/namespaces/agents.ts:48

searchAll

searchAll(params?: SearchAgentsParams): AsyncGenerator<NnnAgent>
Auto-paginating search — yields agents one at a time across all pages.
Parameters
- params: SearchAgentsParams = {}
Returns AsyncGenerator<NnnAgent>
- Defined in src/core/namespaces/agents.ts:75

tombstone

tombstone(agentId: string): Promise<TombstoneAgentResponse>
POST /api/agents/:agentId/tombstone — Permanently tombstone an agent.
Parameters
- agentId: string
Returns Promise<TombstoneAgentResponse>
- Defined in src/core/namespaces/agents.ts:170

update

update(agentId: string, updates: UpdateAgentRequest): Promise<NnnAgent>
PUT /agents/:id — Update an existing agent.
Parameters
- agentId: string
- updates: UpdateAgentRequest
Returns Promise<NnnAgent>
- Defined in src/core/namespaces/agents.ts:140

updateStatus

updateStatus(
    agentId: string,
    status: string,
    capabilities?: string[],
): Promise<{ status: string }>
PUT /agents/:id/status — Update an agent's status and capabilities.
Parameters
- agentId: string
- status: string
- Optionalcapabilities: string[]
Returns Promise<{ status: string }>
- Defined in src/core/namespaces/agents.ts:146