mirror of
https://github.com/hanzoai/agents.git
synced 2026-10-30 18:48:36 +00:00
zeekayandHanzo Dev
d79419aa5c
typescript 7.0.2 is the native compiler and exports no JavaScript API, so tsup, ts-node and typescript-eslint cannot read it. It comes in aliased as tsgo and does the typechecking; typescript stays on the 6 line for the tools. The three typechecked packages report the same 3 diagnostics before and after. Co-authored-by: Hanzo Dev <[email protected]>
Hanzo Agents TypeScript SDK
The TypeScript SDK provides an idiomatic Node.js interface for building and running Hanzo Agents agents. It mirrors the Python SDK APIs, including AI, memory, discovery, and MCP tooling.
Installing
npm install @hanzo-agents/sdk
Rate limiting
AI calls are wrapped with a stateless rate limiter that matches the Python SDK: exponential backoff, container-scoped jitter, Retry-After support, and a circuit breaker.
Configure per-agent via aiConfig:
import { Agent } from '@hanzo-agents/sdk';
const agent = new Agent({
nodeId: 'demo',
aiConfig: {
model: 'gpt-4o',
enableRateLimitRetry: true, // default: true
rateLimitMaxRetries: 20, // max retry attempts
rateLimitBaseDelay: 1.0, // seconds
rateLimitMaxDelay: 300.0, // seconds cap
rateLimitJitterFactor: 0.25, // ±25% jitter
rateLimitCircuitBreakerThreshold: 10, // consecutive failures before opening
rateLimitCircuitBreakerTimeout: 300 // seconds before closing breaker
}
});
To disable retries, set enableRateLimitRetry: false.
You can also use the limiter directly:
import { StatelessRateLimiter } from '@hanzo-agents/sdk';
const limiter = new StatelessRateLimiter({ maxRetries: 3, baseDelay: 0.5 });
const result = await limiter.executeWithRetry(() => makeAiCall());
Execution Notes
Log execution progress with ctx.note(message: string, tags?: string[]) for fire-and-forget debugging in the Hanzo Agents UI.
agent.reasoner('process', async (ctx) => {
ctx.note('Starting processing', ['debug']);
const result = await processData(ctx.input);
ctx.note(`Completed: ${result.length} items`, ['info']);
return result;
});
Use note() for Hanzo Agents UI tracking, console.log() for local debugging.