Agent SDK | JoyToken | Documentation

Agent SDK is for applications that run multi-step agents. JoyToken handles model calls and usage attribution; tool execution, state storage, approvals, and business logic stay in your application.

Supported Capabilities

Capability	Status
JoyToken model provider	Supported
Multi-step agent loop	Supported
Function tool calls	Supported
Stop conditions	Supports `stepCountIs`, `maxToolCalls`, `maxCost`
State persistence	Save `messages` in your app and pass them back to `agent.run()`

Required Values

Item	Value
Package	`@joytoken/agent-sdk-ts`
API key	`JOY_TOKEN_API_KEY`
Default model	`auto`
Node.js	`18+`

Minimal Agent

1 import { Agent, createJoyTokenProvider } from "@joytoken/agent-sdk-ts";
2 
3 const agent = new Agent({
4   model: createJoyTokenProvider({
5     apiKey: process.env.JOY_TOKEN_API_KEY,
6   }),
7   modelName: "auto",
8   system: "Keep answers short.",
9 });
10 
11 const result = await agent.run("Reply with exactly: pong");
12 console.log(result.finalText);

When to Use Agent SDK

Scenario	Recommendation
One model request	Use Client SDK
Tool calls	Use Agent SDK
Multi-step execution and stop conditions	Use Agent SDK
OpenClaw or Hermes Agent integration	Use Agent Integration

Next Steps

Page	Use it for
Quickstart	Run your first agent
Examples	Copy tool, state, and stop-condition examples
TypeScript SDK	Read TypeScript usage