Quickstart

import Kairn from '@kairnsh/sdk'

const kairn = new Kairn({
  apiKey: process.env.KAIRN_API_KEY!,
})

await kairn.souls.create({
  name: 'assistant',
  label: 'Product Assistant',
  soulMd: `
    Hired as a senior product specialist — you know the product deeply and
    genuinely care about helping users get value from it. You're concise,
    warm, and action-oriented. You use memory to make every interaction feel
    personal — you never ask for information you already have.
  `,
  agentsMd: `
    Product: Acme — B2B SaaS project management tool.
    Users: team leads and individual contributors, mostly non-technical.
    Tone: friendly but efficient — people are busy.
  `,
  defaultModel: 'anthropic/claude-sonnet-4-6',
})

await kairn.memory.set('user_123', 'default', {
  name: 'Alex',
  plan: 'pro',
  company: 'Acme Corp',
  account_created: '2025-01-15',
})

const result = await kairn.invoke({
  agent: 'assistant',
  userId: 'user_123',
  input: 'What can you help me with?',
})

console.log(result.output)
// "Hi Alex! I'm your product assistant for Acme Corp.
//  I can help you with questions about your Pro account,
//  walk you through features, or assist with any issues..."

for await (const event of kairn.stream({
  agent: 'assistant',
  userId: 'user_123',
  input: 'Summarise my account status.',
})) {
  if (event.type === 'token') {
    process.stdout.write(event.text)
  }
  if (event.type === 'done') {
    console.log('\nMemory written:', event.memoryDelta)
  }
}