Agent skill

iii-node-sdk

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

View SKILL.md on GitHub Repository
Stars 15,297
Forks 1,022

Install this agent skill to your Project

npx add-skill https://github.com/iii-hq/iii/tree/main/skills/iii-node-sdk

SKILL.md

Node.js SDK

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

Documentation

Full API reference: https://iii.dev/docs/api-reference/sdk-node

Install

npm install iii-sdk

Key APIs

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

RBAC Auth Result Fields

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

Browser SDK

For browser environments, use iii-browser-sdk (same API, adapted for browser WebSocket constraints). See iii-browser-sdk skill for details.

Pattern Boundaries

  • For usage patterns and working examples, see iii-functions-and-triggers
  • For HTTP endpoint patterns, see iii-http-endpoints
  • For HTTP middleware patterns, see iii-http-middleware
  • For browser-side usage, see iii-browser-sdk
  • For Python SDK, see iii-python-sdk
  • For Rust SDK, see iii-rust-sdk

When to Use

  • 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.

Boundaries

  • 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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

iii-hq/iii

iii-dead-letter-queues

Inspects and redrives jobs that exhausted all retries. Use when handling failed queue jobs, debugging processing errors, or implementing retry strategies.

15,297 1,022
Explore
iii-hq/iii

iii-cron-scheduling

Registers cron triggers with 7-field expressions to run functions on recurring schedules. Use when scheduling periodic jobs, timed automation, crontab replacements, cleanup routines, report generation, health checks, batch processing, or any task that should run every N seconds, minutes, hours, or on a weekly/monthly calendar.

15,297 1,022
Explore
iii-hq/iii

iii-http-invoked-functions

Registers external HTTP endpoints as iii functions using registerFunction(id, HttpInvocationConfig). Use when adapting legacy APIs, third-party webhooks, or immutable services into triggerable iii functions, especially when prompts ask for endpoint maps like { path, id } iterated into registerFunction calls.

15,297 1,022
Explore
iii-hq/iii

iii-channels

Binary streaming between workers via channels. Use when building data pipelines, file transfers, streaming responses, or any pattern requiring binary data transfer between functions.

15,297 1,022
Explore
iii-hq/iii

iii-event-driven-cqrs

Implements CQRS with event sourcing on the iii engine. Use when building command/query separation, event-sourced systems, or fan-out architectures where commands publish domain events and multiple read model projections subscribe independently.

15,297 1,022
Explore
iii-hq/iii

iii-agentic-backend

Creates and orchestrates multi-agent pipelines on the iii engine. Use when building AI agent collaboration, agent orchestration, research/review/synthesis chains, or any system where specialized agents hand off work through queues and shared state.

15,297 1,022
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results