Skip to content

Class: NekteServer

nekte-protocol


nekte-protocol / server/src / NekteServer

Class: NekteServer

Defined in: nekte-source/packages/server/src/server.ts:87

@nekte/server — NEKTE Protocol Server

Server library for building NEKTE agents. Register typed capabilities with Zod schemas, auto-generate version hashes, and serve via HTTP with multi-level result compression.

Example

const server = new NekteServer({ agent: 'nlp-worker', version: '1.0.0' });
server.capability('sentiment', {
inputSchema: z.object({ text: z.string() }),
outputSchema: z.object({ score: z.number() }),
category: 'nlp',
description: 'Analyze text sentiment',
handler: async (input) => ({ score: 0.9 }),
});
server.listen(4001);

Constructors

Constructor

new NekteServer(config): NekteServer

Defined in: nekte-source/packages/server/src/server.ts:106

Parameters

config

NekteServerConfig

Returns

NekteServer

Properties

config

readonly config: NekteServerConfig

Defined in: nekte-source/packages/server/src/server.ts:88


delegateHandler?

optional delegateHandler?: DelegateHandler

Defined in: nekte-source/packages/server/src/server.ts:95

Internal

Used by HTTP/gRPC transport for streaming delegation


log

readonly log: Logger

Defined in: nekte-source/packages/server/src/server.ts:92


registry

readonly registry: CapabilityRegistry

Defined in: nekte-source/packages/server/src/server.ts:89


tasks

readonly tasks: TaskRegistry

Defined in: nekte-source/packages/server/src/server.ts:91

Task lifecycle registry — tracks active tasks, enables cancel/resume

Methods

agentCard()

agentCard(endpoint): AgentCard

Defined in: nekte-source/packages/server/src/server.ts:156

Generate the Agent Card for this server.

Parameters

endpoint

string

Returns

AgentCard


capability()

capability<TIn, TOut>(id, config): this

Defined in: nekte-source/packages/server/src/server.ts:139

Register a capability with typed schemas.

Type Parameters

TIn

TIn

TOut

TOut

Parameters

id

string

config

CapabilityConfig<TIn, TOut>

Returns

this


handleRequest()

handleRequest(request): Promise<NekteResponse>

Defined in: nekte-source/packages/server/src/server.ts:170

Handle a NEKTE JSON-RPC request.

Parameters

request

NekteRequest

Returns

Promise<NekteResponse>


listen()

listen(port, hostname?): Promise<void>

Defined in: nekte-source/packages/server/src/server.ts:554

Start an HTTP server for this NEKTE agent. Convenience wrapper around createHttpTransport().

Parameters

port

number

hostname?

string = '0.0.0.0'

Returns

Promise<void>


onDelegate()

onDelegate(handler): this

Defined in: nekte-source/packages/server/src/server.ts:148

Register a streaming delegate handler. When set, nekte.delegate uses SSE to stream progress/results.

Parameters

handler

DelegateHandler

Returns

this