AI agents
in TypeScript.
Connect APIs, add memory, and run agents in Node.js or the browser. Choose OneRingAI, Codex, or Claude.
BROWSER AGENTS · SINCE BETA.2 One Agent API. Node.js, browsers, and Workers. Browser setup and plugin examplesconst agent = runtime.createAgent({
id: 'researcher', instructions: 'Cite sources.',
});
const options = {
...hostSessionOptions,
execution: {
driver: 'oneringai.agent',
connector: 'openai-main',
model: 'gpt-5.6-terra',
},
};
await agent.inspect(options);
const session = await agent.openSession(options);
Example only; no model calls. Requires a configured runtime host, connectors, and permissions.
THE DOCUMENTATION
Build with OneRingAI.
User Guide
From your first agent to tools, memory, and production.
→ 02 / BUILDExamples
Runnable recipes with setup, expected results, and cleanup.
→ 03 / EXPLOREAPI Reference
Public classes, methods, and types. Find the exact signature.
→ 04 / RUNAMOS cookbook
Configure a host, inspect runs, and recover saved sessions.
→VERSION 2
Execution and task controls
Choose a harness, retain source results, and limit model calls.
Swappable harnesses
Bind sessions to OneRingAI, local Codex or Claude SDKs, or managed vendor APIs. External drivers are preview.
Runtime guide ↗ 02 / EVIDENCERetained tool results
Store scoped observations and send bounded projections to the model. Configure durable storage for restart recovery.
Evidence guide ↗ 03 / TASK STATEProtected task state
Keep host-confirmed constraints, corrections, and action receipts through compaction.
Task state guide ↗ 04 / MODEL CONTROLHelpers and budgets
Assign helper models and share process-local call, token, deadline, and estimated cost limits.
Model budget guide ↗CORE LIBRARY
Connectors, memory and media
V2 retains the connectors, memory system, tools, and media APIs from v1.
Named connectors
Manage provider keys, service OAuth, and multiple accounts in a shared registry. Opt in to host-managed ChatGPT plan access.
50 authentication templates; specialized tool packs for selected services.
Connector catalog ↗Entity/fact memory
Store entities, relationships, provenance, and temporal facts. Retrieve by graph or semantic search.
Use standalone or with six read and six write agent tools.
Memory guide ↗Multimodal APIs
Generate images, video, speech, and embeddings. Read documents and build realtime voice sessions.
New entries include Gemini 4 Hydrogen and Grok Video 1.5 Lite. Availability depends on the provider, model, and endpoint.
Model refresh and support limits ↗AMOS & HOSEA
Open-source applications
Terminal agent
Configure connectors, inspect runs, and save sessions. The cookbook covers all five runtime drivers.
Desktop workspace
Chat, configure agents and tools, and generate media. First-run setup offers ChatGPT sign-in for eligible accounts; media uses API keys.
hosea setup ↗COMPARISON
Frameworks and vendor SDKs
LangGraph, Mastra, Vercel AI SDK, OpenAI, Claude, CrewAI, and OpenClaw.