iii-node-sdk

Original：🇺🇸 English

Translated

Node.js/TypeScript SDK for the iii engine. Use when building workers, registering functions, or invoking triggers in TypeScript or JavaScript.

7installs

Added on2026-05-13

NPX Install

npx skill4agent add iii-hq/iii iii-node-sdk

The TypeScript/JavaScript SDK for connecting workers to the iii engine.

npm install iii-sdk

API	Purpose
`registerWorker(url, { workerName })`	Connect to the engine and return the `iii` client
`iii.registerFunction(id, handler, options?)`	Register a local async function handler
`iii.registerFunction(id, httpConfig, options?)`	Register an HTTP-invoked external function
`iii.registerTrigger({ type, function_id, config, metadata? })`	Bind a trigger to a function (with optional metadata)
`iii.trigger({ function_id, payload, action? })`	Invoke a function
`TriggerAction.Void()`	Fire-and-forget invocation mode
`TriggerAction.Enqueue({ queue })`	Durable async invocation mode
`Logger`	Structured logging
`withSpan` , `getTracer` , `getMeter`	OpenTelemetry instrumentation
`iii.createChannel()`	Binary streaming between workers
`iii.createStream(name, adapter)`	Custom stream implementation
`iii.registerTriggerType(id, handler)`	Custom trigger type registration

When implementing an auth function for RBAC workers, the

AuthResult

supports:

Field	Purpose
`allowed_functions: string[]`	Additional function IDs to allow
`forbidden_functions: string[]`	Function IDs to deny (overrides expose_functions)
`allowed_trigger_types?: string[]`	Trigger types the worker may register
`allow_trigger_type_registration`	Whether the worker can register new trigger types
`function_registration_prefix?`	Prefix applied to functions registered by worker
`context: Record<string, unknown>`	Arbitrary context forwarded to middleware/handlers

For browser environments, use

iii-browser-sdk

(same API, adapted for browser WebSocket constraints). See

iii-browser-sdk

skill for details.

Use this skill when the task is primarily about
```
iii-node-sdk
```
in the iii engine.
Triggers when the request directly asks for this pattern or an equivalent implementation.

Never use this skill as a generic fallback for unrelated tasks.
You must not apply this skill when a more specific iii skill is a better fit.
Always verify environment and safety constraints before applying examples from this skill.