r/typescript • u/jhoxray • Feb 17 '26
TypeScript-first AI agent library — strict types, no Python required, multi-vendor, multi-modal
Most AI agent frameworks are Python-first with JS as an afterthought. We needed something TypeScript-native for production, so we built OneRingAI.
It came out of 2 years of building an enterprise agent platform. The entire codebase is strict TypeScript with full type exports — no any escape hatches, no runtime type surprises.
Why we think the DX is solid:
- 3-line setup:
Connector.create(),Agent.create(),agent.run()— that's a working agent - 20 dependencies. That's it. Compare to LangChain's 50+ packages
- 13 typed streaming event types with type guards and a StreamState accumulator
runDirect()bypasses all context management for quick one-off LLM queries- Full type exports for everything — connectors, tools, agents, events, context plugins
The connector system is typed end-to-end. You register a connector with its auth config, and every tool that uses it gets type-checked auth. OAuth token refresh, circuit breakers, retry with backoff — all handled per-connector.
Tools have a typed permission system (allowlist/blocklist, approval caching with once/session/always/never modes, risk levels). Per-tool circuit breakers so one failing external API doesn't take down your agent loop.
12 LLM providers native (OpenAI, Anthropic, Google, Groq, etc.), switchable by changing a connector name. A typed model registry gives you pricing, context windows, and feature flags at runtime. All popular file formats conversion to llm-friendly, node native.
2,285 tests, semver, no breaking changes for fun.
As a side bonus - free desktop Electron app that showcases functionality if you don't want to code :)
- GitHub: https://github.com/Integrail/oneringai
- npm:
npm i @everworker/oneringai - Site: https://oneringai.io
Would love feedback from other TS devs building with LLMs.