Overview

import { agent, tool, run, createAdapter } from '@vertz/agents';
import { s } from '@vertz/schema';

const greetTool = tool({
  description: 'Greet a user by name',
  input: s.object({ name: s.string() }),
  output: s.object({ greeting: s.string() }),
  handler(input) {
    return { greeting: `Hello, ${input.name}!` };
  },
});

const greeter = agent('greeter', {
  state: s.object({ greetCount: s.number() }),
  initialState: { greetCount: 0 },
  tools: { greet: greetTool },
  model: { provider: 'openai', model: 'gpt-4o' },
});

const llm = createAdapter({ provider: 'openai' });
const result = await run(greeter, { message: 'Say hi to Alice', llm });

console.log(result.response); // Agent's final response
console.log(result.status); // 'complete' | 'stuck' | 'max-iterations' | 'error'