JavaScript / TypeScript SDK

npm install @pulselabs/sdk

import { PulseLabsSDK } from '@pulselabs/sdk'

const pulse = new PulseLabsSDK({
  apiKey: process.env.PULSELABS_API_KEY!,
  // baseUrl defaults to 'https://api.pulselabs.ai'
  // workspaceId is optional — omit to use your personal workspace
})

// Create and run a debate
const { conversation } = await pulse.conversations.create('EU expansion strategy')

const result = await pulse.conversations.sendMessage(
  conversation.id,
  'Should we expand into Germany before France?',
)

// List all conversations
const { conversations } = await pulse.conversations.list()

// Fetch one with full message history
const { conversation: full } = await pulse.conversations.get(conversation.id)

// Create an agent persona
const { agent } = await pulse.agents.create({
  name: 'Dr. Reyes',
  role: 'Risk Analyst',
  personality: 'Methodical, data-driven, conservative',
  mission: 'Identify and quantify downside risks',
  decisionStyle: 'evidence-based',
  systemPrompt: 'You are a risk analyst. For every proposal, enumerate...',
  isDevilsAdvocate: false,
})

// Add persistent memory to the agent
await pulse.agents.memory.create(agent.id, 'preferred_currency', 'EUR')

// List the agent's memories
const { memory } = await pulse.agents.memory.list(agent.id)

// Update the agent
await pulse.agents.update(agent.id, { personality: 'Methodical, data-driven, skeptical' })

// Create a simulation
const sim = await pulse.simulations.create({
  name: 'Series A runway model',
  description: '18-month projection under three hiring scenarios',
  turnUnit: 'month',
  companyBase: {
    revenue: 85000,
    headcount: 12,
    burnRate: 42000,
    marketShare: 0.02,
  },
})

// Add a scenario
await pulse.simulations.addScenario(sim.simulation.id, {
  name: 'Aggressive hiring',
  description: 'Hire 6 engineers in Q3',
})

// Advance one turn (triggers debate between agents)
const { states } = await pulse.simulations.advance(sim.simulation.id)

// Retrieve the final report (once simulation is complete)
const { report } = await pulse.simulations.getReport(sim.simulation.id)

// Basic completion
const { content, usage } = await pulse.ai.complete({
  systemPrompt: 'You are a strategic business advisor.',
  messages: [
    { role: 'user', content: 'What are the top risks of a Series A raise right now?' },
  ],
  temperature: 0.4,
})

// With supplementary data + extraction
const { content: advice, extracted } = await pulse.ai.complete({
  systemPrompt: 'You are a strategic advisor.',
  messages: [
    { role: 'user', content: 'Our burn is €38k. We have 11 months left. Should we raise?' },
  ],
  supplementary: [
    {
      category: 'company-financials',
      priority: 'high',
      data: { mrr: 92000, headcount: 14, runway_months: 11 },
    },
  ],
  extraction: {
    source: 'strategy-session',
    categories: ['financials', 'intent'],
    persist: true,
  },
})

// Retrieve persisted facts
const { data: facts } = await pulse.ai.listExtractedData({
  source: 'strategy-session',
  category: 'financials',
})

import { PulseLabsSDK, PulseLabsSDKError } from '@pulselabs/sdk'

const pulse = new PulseLabsSDK({ apiKey: process.env.PULSELABS_API_KEY! })

try {
  const { conversation } = await pulse.conversations.create('Test')
  await pulse.conversations.sendMessage(conversation.id, 'Hello')
} catch (err) {
  if (err instanceof PulseLabsSDKError) {
    console.error(`API error ${err.status}: ${err.message}`)
    // err.body — the raw JSON response body
    // err.status — HTTP status code (402 = out of tokens, 404 = not found, etc.)
  } else {
    throw err  // network error, re-throw
  }
}

const controller = new AbortController()

// Cancel after 10 seconds
setTimeout(() => controller.abort(), 10_000)

const result = await pulse.simulations.advance(simId, { signal: controller.signal })