npm install @nolma/node
# or
pnpm add @nolma/node

import { Nolma } from '@nolma/node'
import Anthropic from '@anthropic-ai/sdk'

const nolma = new Nolma({ apiKey: 'nm_live_abc123' })

const result = await nolma.session(
  { name: 'my-agent' },
  async () => {
    const client = new Anthropic({
      apiKey: process.env.ANTHROPIC_API_KEY,
      baseURL: 'https://gateway.nolma.ai/anthropic',
      defaultHeaders: nolma.getHeaders()
    })

    const response = await client.messages.create({
      model: 'claude-haiku-4-5-20251001',
      max_tokens: 100,
      messages: [{ role: 'user', content: 'Hello' }]
    })

    return response.content[0].text
  }
)

const result = await nolma.session(
  { name: 'support-bot', userId: 'user_123' },
  async () => {
    const sessionId = nolma.sessionId

    // All LLM calls here are grouped
    // under this session automatically

    const output = await myLLMCall()

    nolma.signal(sessionId!, { action: 'accepted' })

    return output
  }
)

// Fire and forget — never throws, never blocks
nolma.signal(sessionId, { action: 'accepted' })
nolma.signal(sessionId, { action: 'edited', editDistance: 42 })
nolma.signal(sessionId, { action: 'regenerated' })
nolma.signal(sessionId, { action: 'abandoned' })

class Nolma {
  constructor(options: {
    apiKey: string
    gatewayUrl?: string  // default: https://gateway.nolma.ai
  })

  session<T>(
    options: { name: string; userId?: string },
    fn: () => Promise<T>
  ): Promise<T>

  get sessionId(): string | undefined

  getHeaders(): Record<string, string>

  signal(
    sessionId: string,
    options: {
      action: string
      editDistance?: number
      customLabel?: string
    }
  ): void

  async signalAsync(
    sessionId: string,
    options: { action: string; editDistance?: number }
  ): Promise<void>

  async scanContext(
    content: string,
    options?: { source?: string; agent?: string }
  ): Promise<ScanResult>
}