Chat API

const result = await client.chat({
  bot_id: 'bot_abc123',
  chat_id: 'community-42',
  message: 'What did we decide about the venue?',
  purpose: 'service',
  workspace_uuid: 'ws_abc123',
  chat_mode: 'edit'
});

const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Hello! How can you help me?'
});

if (result.err) {
  console.error('Error:', result.err);
} else {
  console.log('Bot response:', result.response);
}

{
  err: null,
  response: 'I can help you with customer support, product information, and answering your questions!'
}

const chatId = 'chat_user_123';

// First message
const msg1 = await client.chat({
  bot_id: 'bot_abc123',
  message: 'My name is John',
  chat_id: chatId
});

// Second message (bot remembers context)
const msg2 = await client.chat({
  bot_id: 'bot_abc123',
  message: 'What is my name?',
  chat_id: chatId
});

console.log(msg2.response); // "Your name is John"

const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Complex question requiring deep thinking',
  model: 'gpt-5.4', // Use reasoning model for this request
  reasoning_mode: 'agent' // Autonomous multi-step with tools (up to 10x credit)
});

const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Hello',
  model: 'llama3.1',
  provider_host: 'http://localhost:11434'
});

const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Give me a brief summary',
  max_reply_tokens: 200 // Short response
});

const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Hello',
  model: 'gpt-5.6-luna',
  provider_key: 'sk-your-openai-key' // Use your OpenAI key
});

const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Tell me a joke',
  instruction: 'You are a comedian who tells funny jokes.'
});

const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'What is our refund policy?',
  source_ids: ['source_123', 'source_456'], // Only search these sources
  tags: ['policies']                        // ...and only these tags
});

const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Hello',
  memory: false // Don't search the agent's training data
});

const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Write a long story',
  stream: true
});

if (result.err) {
  console.error('Error:', result.err);
} else {
  // Handle streaming response
  for await (const chunk of result.response) {
    process.stdout.write(chunk);
  }
}

// Send an edit request — the agent finds and edits the relevant file
const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Add email validation to the login form',
  chat_id: chatId,
  chat_mode: 'edit'
});

console.log(result.response); // Agent's summary of changes made

// Step 1: Request a plan
const plan = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Find a professional studio background image and update the page',
  chat_id: chatId,
  chat_mode: 'plan'
});

console.log(plan.response); // AI proposes a step-by-step plan

// Step 2: Approve the plan to execute it
const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Looks good, go ahead',
  chat_id: chatId,
  chat_mode: 'plan'
});

console.log(result.response); // Executed result

// Or modify the plan instead
const revised = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Actually, search for a darker background instead',
  chat_id: chatId,
  chat_mode: 'plan'
});

console.log(revised.response); // Revised plan

await client.renameChat({
  bot_id: 'bot_abc123',
  chat_id: 'chat-id',
  name: 'Onboarding questions'
});

await client.setChatMode({ bot_id: 'bot_abc123', chat_id: 'chat-id', mode: 'plan' });

await client.cancelChat({ bot_id: 'bot_abc123', chat_id: 'chat-id' });

// Is this conversation generating right now?
await client.fetchStreamStatus({ bot_id: 'bot_abc123', chat_id: 'chat-id' });

// Every conversation on this agent with a reply in flight
await client.fetchActiveStreams({ bot_id: 'bot_abc123' });

const { err, response } = await client.subscribeChat({
  bot_id: 'bot_abc123',
  chat_id: 'chat-id'
});

if (!err) {
  for await (const chunk of response) {
    process.stdout.write(chunk.toString());
  }
}

// Notifications for the whole agent; chat_id is optional
await client.subscribeNotifications({ bot_id: 'bot_abc123' });

await client.fetchChatScheduledTasks({ bot_id: 'bot_abc123', chat_id: 'chat-id' });

// A toggle, not a setter: the endpoint flips the schedule's current state, so there is no
// target value to pass.
await client.toggleChatScheduledTask({
  bot_id: 'bot_abc123',
  chat_id: 'chat-id',
  task_id: 'task-id'
});

const result = await client.chat({
  bot_id: 'bot_abc123',
  message: 'Hello'
});

if (result.err) {
  if (result.err.includes('Rate limit')) {
    console.log('Rate limited, retry later');
  } else if (result.err.includes('Bot not found')) {
    console.log('Bot does not exist');
  } else {
    console.error('Unknown error:', result.err);
  }
} else {
  console.log('Success:', result.response);
}

import { BoostGPT } from 'boostgpt';

const client = new BoostGPT({
  project_id: process.env.BOOSTGPT_PROJECT_ID,
  key: process.env.BOOSTGPT_API_KEY
});

async function chat() {
  const chatId = `chat_${Date.now()}`;

  // Start conversation
  const response1 = await client.chat({
    bot_id: 'bot_abc123',
    message: 'What services do you offer?',
    chat_id: chatId
  });

  if (response1.err) {
    console.error('Error:', response1.err);
    return;
  }

  console.log('Bot:', response1.response);

  // Follow-up question (remembers context)
  const response2 = await client.chat({
    bot_id: 'bot_abc123',
    message: 'How much does it cost?',
    chat_id: chatId
  });

  console.log('Bot:', response2.response);
}

chat();