Repository navigation
Node.js client wrapper for TokenOps #122
Description
Summary
We'd like an official Node.js/TypeScript wrapper for TokenOps, mirroring the ergonomics of the Python SDK (tokenops_run, wrap_complete, register_run, crossing hooks, control-plane integration via TOKENOPS_URL).
Motivation
TokenOps currently ships a Python integration. A Node.js wrapper would let JS/TS-based agent frameworks (LangChain.js, Vercel AI SDK, custom Node agents, etc.) get the same run-aware spend caps, halt/steer hooks, and per-agent cost attribution without reimplementing the protocol from scratch.
Rough scope
- Package under
@tokenops/node(or similar) publishable to npm - Equivalent of
tokenops_runcontext manager (likely an async-friendly wrapper/decorator) wrap_complete-style helper for wrapping LLM call sites (OpenAI/Anthropic SDKs, etc.)register_runand crossing-hook support talking to the same control-plane HTTP API used by the Python client- Respect
TOKENOPS_URLenv var / config for pointing at a control plane instance - Basic examples (single script, LangChain.js agent)
- Type definitions (TypeScript-first)
Notes
Happy to point contributors at the Python implementation and control-plane API as reference. This is a good "help wanted" item if anyone in the Node ecosystem wants to drive the wrapper design — open to discussion on API shape before implementation starts.
Activity
avanithumballi commentedon Oct 1, 2026
Hi! @tishachawla-jg , @susheem-k I'd be interested in taking this up for Hacktoberfest 2026. I have experience with Node.js/TypeScript and backend development, and I'd like to implement the Node.js/TypeScript wrapper. I'll first review the existing Python SDK and control-plane API to align the Node API with the existing behavior. Happy to discuss the API shape before starting.