Quickstart

import { Ponte, type Message } from '@ponte/sdk';

const ponte = new Ponte({
  apiKey: process.env.PONTE_API_KEY!
});

async function exemploArray() {
  // Array tradicional (compatível com OpenAI/Anthropic)
  const messages: Message[] = [
    { 
      role: 'system', 
      content: 'Você é um assistente técnico especializado em JavaScript.'
    },
    { 
      role: 'user', 
      content: 'O que é uma Promise?' 
    }
  ];

  let resultado = await ponte.execute({
    messages, // ✅ Passa array direto
    model: 'claude-3-5-haiku-latest'
  });

  // Adiciona resposta ao histórico
  messages.push({
    role: 'assistant',
    content: resultado.text
  });

  // Segunda pergunta
  messages.push({
    role: 'user',
    content: 'E async/await?'
  });

  resultado = await ponte.execute({
    messages,
    model: 'claude-3-5-haiku-latest'
  });

  console.log('🤖 Explicação:', resultado.text);
}

exemploArray();

import { Ponte, Conversation, type Message } from '@ponte/sdk';

const ponte = new Ponte({
  apiKey: process.env.PONTE_API_KEY!
});

async function exemploHibrido() {
  // 1. Carrega conversa do banco (array)
  const messagesFromDB: Message[] = await loadFromDatabase('conv-123');

  // 2. Converte para Conversation (usar métodos úteis)
  const conversation = Conversation.fromMessages(messagesFromDB);

  // 3. Adiciona nova mensagem
  conversation.addUserMessage('Continue a conversa...');

  // 4. Executa
  const resultado = await ponte.execute({
    conversation,
    model: 'gpt-4o-mini'
  });

  conversation.addAssistantMessage(resultado.text);

  // 5. Converte de volta e salva
  const updatedMessages = conversation.toObject();
  await saveToDatabase('conv-123', updatedMessages);

  // Ou salva como JSON
  const json = conversation.toJSON();
  await saveToDatabase('conv-123', json);
}

// Helper functions
async function loadFromDatabase(id: string): Promise<Message[]> {
  const data = await db.conversations.findById(id);
  return JSON.parse(data.messages);
}

async function saveToDatabase(id: string, messages: Message[] | string) {
  const data = typeof messages === 'string' 
    ? messages 
    : JSON.stringify(messages);
  
  await db.conversations.update(id, { messages: data });
}