Nira API

Nira
  └── Conversation
        ├── Message (user)
        ├── Message (assistant)
        ├── Message (user)
        └── Message (assistant)

const conversation = await nb.nira.conversations.create('Optional title');

console.log(`Conversation ID: ${conversation.id}`);

const conversation = await nb.nira.conversations.get(conversationId);

console.log(`Title: ${conversation.title}`);
console.log(`Messages: ${conversation.messageCount}`);
console.log(`Status: ${conversation.status}`);

interface Conversation {
  id: string;
  title?: string;
  context?: string;
  status?: string;
  messageCount?: number;
  lastMessageAt?: string;
  createdAt?: string;
}

const conversations = await nb.nira.conversations.list();

for (const conv of conversations) {
  console.log(`${conv.title} (${conv.id})`);
}

const response = await nb.nira.messages.send(
  conversationId,
  'What is the weather like today?'
);

console.log('Nira response:', response.content);

interface SendMessageResponse {
  messageId?: string;
  content?: string;
  role?: string;
  executionId?: string;
  tokensUsed?: number;
}

for await (const event of nb.nira.messages.stream(conversationId, 'Tell me a story')) {
  switch (event.type) {
    case 'message.start':
      console.log('Nira started responding...');
      break;
    case 'content':
      // Display text as it arrives
      process.stdout.write(event.data.text as string);
      break;
    case 'tool.start':
      console.log(`\n[Using tool: ${event.data.display}]`);
      break;
    case 'tool.complete':
      console.log('[Tool finished]');
      break;
    case 'done':
      console.log('\n--- Response complete ---');
      break;
    case 'error':
      console.error('Error:', event.data.error);
      break;
  }
}

const messages = await nb.nira.messages.list(conversationId);

for (const message of messages) {
  console.log(`[${message.role}]: ${message.content}`);
}

interface Message {
  id: string;
  role: 'user' | 'assistant' | 'system';
  content: string;
  createdAt?: string;
}

import { NimbleBrain } from '@nimblebrain/sdk';
import * as readline from 'readline';

async function chat() {
  const nb = new NimbleBrain({ apiKey: process.env.NIMBLEBRAIN_API_KEY! });

  // Create a conversation
  const conversation = await nb.nira.conversations.create('CLI Chat');
  console.log(`Started conversation: ${conversation.id}\n`);

  // Set up readline for user input
  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
  });

  const askQuestion = () => {
    rl.question('You: ', async (input) => {
      if (input.toLowerCase() === 'quit') {
        rl.close();
        return;
      }

      // Stream the response
      process.stdout.write('Nira: ');
      for await (const event of nb.nira.messages.stream(conversation.id, input)) {
        if (event.type === 'content') {
          process.stdout.write(event.data.text as string);
        }
      }
      console.log('\n');

      askQuestion(); // Continue the loop
    });
  };

  console.log('Type "quit" to exit\n');
  askQuestion();
}

chat();

const conversation = await nb.nira.conversations.create('Weather Check');

for await (const event of nb.nira.messages.stream(
  conversation.id,
  'What is the weather in San Francisco?'
)) {
  switch (event.type) {
    case 'tool.start':
      console.log(`[Nira is checking ${event.data.display}...]`);
      break;
    case 'content':
      process.stdout.write(event.data.text as string);
      break;
  }
}

[Nira is checking weather...]
The current weather in San Francisco is 65°F with partly cloudy skies.
The forecast shows a high of 68°F today with no chance of rain.

const conversation = await nb.nira.conversations.create('Build Automation');

const response = await nb.nira.messages.send(
  conversation.id,
  'Create a playbook that checks our GitHub repo for new issues every hour and posts a summary to #dev-alerts on Slack'
);

console.log(response.content);
// Nira will confirm the playbook creation and provide details

try {
  const conversation = await nb.nira.conversations.create();
} catch (error) {
  if (error instanceof Error) {
    if (error.message.includes('404')) {
      console.error('Conversation not found');
    } else if (error.message.includes('401')) {
      console.error('Invalid API key');
    } else if (error.message.includes('429')) {
      console.error('Rate limit exceeded');
    } else {
      console.error('Error:', error.message);
    }
  }
}

const conversation = await nb.nira.conversations.create('Project Planning');

// First message
await nb.nira.messages.send(conversation.id,
  'I need to set up daily sales reports from Salesforce to Slack'
);

// Follow-up - Nira remembers the context
await nb.nira.messages.send(conversation.id,
  'Actually, make it weekly instead of daily'
);

// Another follow-up
await nb.nira.messages.send(conversation.id,
  'And add a summary of support tickets from Zendesk too'
);