Methods

const result = await client.auth.signup({
  org_name: 'Acme Corp',
  admin_name: 'Jane',
  admin_email: 'jane@acme.com',
  admin_password: 'securepassword',
  workspace_name: 'Support Bot',
  team_name: 'Customer Support',
  system_prompt: 'You are a helpful support assistant.' // optional
});
// { status: 'ok', org_id: '...', user_id: '...', workspace_id: 'ws-support-bot' }

const session = await client.auth.login({
  email: 'jane@acme.com',
  password: 'securepassword'
});
// { user: { id, email, name, role } }

const { user } = await client.auth.session();
if (user) {
  console.log(`Logged in as ${user.name} (${user.role})`);
}

const result = await client.workspaces.query('ws-support-bot', {
  query: 'What is the status of order ORD-2026-001?',
  session_id: 'session-123' // optional, for multi-turn conversations
});

console.log(result.answer);
console.log(`Cost: $${result.cost_usd}, Duration: ${result.duration_ms}ms`);
console.log(`Tools: ${result.tools_called.join(', ')}`);

const dashboard = await client.workspaces.dashboard('ws-support-bot');
console.log(`Queries today: ${dashboard.usage.queries_today}`);
console.log(`Cost MTD: $${dashboard.cost.this_month}`);
console.log(`Open tickets: ${dashboard.tickets.open}`);

const { conversations, total, filters } = await client.conversations.list(
  'ws-support-bot',
  { status: 'open', limit: 20, offset: 0 }
);

const { conversation, messages, stats } = await client.conversations.get(
  'ws-support-bot',
  'conv-abc123'
);

await client.conversations.close('ws-support-bot', 'conv-abc123');

const result = await client.connectors.testMcp({
  transport: 'http',
  url: 'http://localhost:3000/mcp'
});

if (result.ok) {
  console.log(`Found ${result.tools} tools: ${result.toolNames?.join(', ')}`);
}

await client.connectors.addMcp({
  workspace_id: 'ws-support-bot',
  name: 'order-service',
  transport: 'http',
  url: 'http://localhost:3000/mcp'
});