Node.js client wrapper for TokenOps

[susheem-k]

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_run context manager (likely an async-friendly wrapper/decorator)
• wrap_complete-style helper for wrapping LLM call sites (OpenAI/Anthropic SDKs, etc.)
• register_run and crossing-hook support talking to the same control-plane HTTP API used by the Python client
• Respect TOKENOPS_URL env 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.

[avanithumballi]

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.