Quick Start

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

const cogitator = new Cogitator({
  llm: {
    defaultProvider: 'ollama',
    providers: {
      ollama: { type: 'ollama', host: 'http://localhost:11434', model: 'llama3.2' },
    },
  },
});

const assistant = new Agent({
  name: 'assistant',
  instructions: 'You are a helpful assistant. Be concise and friendly.',
});

const result = await cogitator.run(assistant, 'Hello! What can you help me with?');

console.log('Agent:', result.text);
console.log('Tokens:', result.usage?.totalTokens);

npx tsx src/agent.ts

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

const getWeather = tool({
  name: 'get_weather',
  description: 'Get the current weather for a city',
  parameters: z.object({
    city: z.string().describe('City name'),
    units: z.enum(['celsius', 'fahrenheit']).default('celsius'),
  }),
  execute: async ({ city, units }) => ({
    city,
    temperature: units === 'celsius' ? 22 : 72,
    condition: 'sunny',
  }),
});

const weatherBot = new Agent({
  name: 'weather-bot',
  instructions: 'You are a weather assistant. Use the get_weather tool to answer questions.',
  tools: [getWeather],
});

const cogitator = new Cogitator({
  llm: {
    defaultProvider: 'ollama',
    providers: {
      ollama: { type: 'ollama', host: 'http://localhost:11434', model: 'llama3.2' },
    },
  },
});

const result = await cogitator.run(weatherBot, 'What is the weather like in Tokyo?');
console.log(result.text);

const result = await cogitator.run(assistant, {
  input: 'Write a short poem about coding.',
  stream: true,
  onToken: (token) => {
    process.stdout.write(token);
  },
});

const cogitator = new Cogitator({
  llm: {
    defaultProvider: 'ollama',
    providers: {
      ollama: { type: 'ollama', host: 'http://localhost:11434', model: 'llama3.2' },
      openai: { type: 'openai', apiKey: process.env.OPENAI_API_KEY!, model: 'gpt-4o' },
      anthropic: {
        type: 'anthropic',
        apiKey: process.env.ANTHROPIC_API_KEY!,
        model: 'claude-sonnet-4-5-20250929',
      },
    },
  },
});

// uses default ollama provider
const localAgent = new Agent({ name: 'local', instructions: '...' });

// override per-agent
const smartAgent = new Agent({ name: 'smart', instructions: '...', model: 'openai/gpt-4o' });
const creativeAgent = new Agent({
  name: 'creative',
  instructions: '...',
  model: 'anthropic/claude-sonnet-4-5-20250929',
});