Your First Agent

import { Agent, Cogitator, tool } from '@cogitator-ai/core';
import { z } from 'zod';

const apiKey = process.env.GOOGLE_API_KEY;
if (!apiKey) throw new Error('Set GOOGLE_API_KEY');

const dictionary: Record<string, string> = {
  petrichor: 'The pleasant earthy smell after rain.',
  sonder: 'The realization that each passerby has a life as vivid and complex as your own.',
};

const lookupWord = tool({
  name: 'lookup_word',
  description: 'Look up the definition of a word in the dictionary',
  parameters: z.object({
    word: z.string().describe('The word to look up'),
  }),
  execute: async ({ word }) => {
    const definition = dictionary[word.toLowerCase().trim()];
    return definition ? { found: true, word, definition } : { found: false, word };
  },
});

const cog = new Cogitator({ llm: { providers: { google: { apiKey } } } });

const agent = new Agent({
  name: 'lexicon',
  model: 'google/gemini-3.5-flash-lite',
  instructions: 'You are a helpful language assistant. Use your tools to look up words. Be concise.',
  tools: [lookupWord],
  temperature: 0.3,
  maxIterations: 5,
});

const result = await cog.run(agent, { input: 'What does "petrichor" mean?' });
console.log(result.output);
console.log('Tool calls:', result.toolCalls.map((call) => call.name));

process.stdout.write('Streaming: ');
const streamed = await cog.run(agent, {
  input: 'What does "sonder" mean? Explain in one sentence.',
  stream: true,
  onToken: (token) => process.stdout.write(token),
});
console.log('\nTokens:', streamed.usage.inputTokens, 'in /', streamed.usage.outputTokens, 'out');

await cog.close();

pnpm add @cogitator-ai/core zod

GOOGLE_API_KEY=your-key npx tsx first-agent.ts

npx tsx examples/core/01-basic-agent.ts