TypeScript

npm install @simular-ai/sai-sdk
export SAI_API_KEY="sapi_..."

import { Sai } from '@simular-ai/sai-sdk'

const sai = new Sai()
const [pc] = await sai.machines.list()

const session = await sai.sessions.create({ machine: pc })
const result = await session.run('Open Notepad, type hello, save it to the desktop as hello.txt')

console.log(result.status) // idle, needs_approval or error
console.log(result.text) // Sai's answer
console.log(result.usage) // tokens and cost of this task

const turn = await session.send("Find last month's invoices in Downloads and total them")
for await (const ev of turn.events()) {
  if (ev.kind === 'step') console.log('  ', ev.text)
  else if (ev.kind === 'approval') await turn.respond(ev.approval!, 'yes')
}
const result = await turn.wait()

const result = await session.run('Clean up the temp folder', {
  onApproval: (approval) => {
    if (approval.isLinkOnly) {
      console.log('Approve in a browser:', approval.url)
      return null // a person answers it; keep waiting
    }
    if (approval.type === 'choice') {
      return ['yes', approval.questions.map((q: any) => [q.options[0].value])]
    }
    return 'yes'
  },
})

await session.run("Export last month's invoices to CSV", { autonomous: true })

const report = await sai.files.upload('report.pdf') // or { data: bytes, name: 'report.pdf' }
await session.run('Summarise the attached report', { attachments: [report] })

const allowed = (await sai.models.list()).filter((m) => m.allowed).map((m) => m.id)
await session.run('...', { model: 'anthropic/claude-opus-5-5' }) // sticks to the session

const turn = await session.send('...')
await turn.abort()

const result = await session.run(
  'Open https://news.ycombinator.com and read the title of the top story.',
  {
    outputSchema: {
      type: 'object',
      properties: { title: { type: 'string' } },
      required: ['title'],
    },
  },
)
if (result.ok) console.log((result.record?.output as { title: string }).title)
else console.log(result.record?.reasonCode) // e.g. output_invalid

const turn = await session.send('...', { recordTrajectory: true })
const record = await sai.turns.wait(turn) // until succeeded, failed or needs_input
for (const step of await sai.turns.trajectory(turn)) {
  console.log(step.index, step.title)
}

const turn = await session.send('Open {{site}} and read the title of the top story', {
  inputs: { site: 'https://news.ycombinator.com' },
  recordTrajectory: true,
})
await sai.turns.wait(turn)

const learned = await sai.learn.create([turn]) // waits for the code; longer for a longer task
const lease = await sai.control.open({ machine: pc })
const r = await lease.run(learned, { site: 'https://lobste.rs' }) // inputs over the defaults
console.log(r.result)
await lease.close()

const fixed = await sai.learn.create([], {
  initialCode: learned.code,
  evaluations: [{ inputs: { site: 'https://lobste.rs' }, result: r, passed: false }],
})
const judgement = await sai.judge.create(
  [turn],
  [{ id: 'title', check: 'The agent reported a story title' }],
)

const job = await sai.learn.create([], {
  taskTemplate: 'Open {{site}} and read the title of the top story',
  inputs: { site: 'https://news.ycombinator.com' },
  machine: pc,
  criteria: 'The answer is the title of the top story on the page',
  maxIterations: 3, // up to 3 code versions; 0 (the default) only writes the code
  rollouts: 3, // each version must pass 3 runs in a row
  reset: { code: 'await machine.browser.newtab("https://news.ycombinator.com")' },
  continueWithAgent: true, // after a failed run, the agent finishes the task and the repair learns from it
})
const done = await sai.learn.wait(job) // can take an hour; timeoutMs to stop waiting
console.log(done.status, done.stopReason, done.testResult)
console.log(done.code) // the latest version
for (const it of done.iterations) console.log(it.index, it.changes, it.rollouts.map((r) => r.verdict))

const run = await sai.learn.rollout(job, 1, 1) // what one run returned and logged, and its judgement
await sai.learn.cancel(job) // stops at once and keeps the last complete results

import { writeFile } from 'node:fs/promises'

const lease = await sai.control.open({ machine: pc })
try {
  console.log((await lease.shell('hostname')).stdout)

  await lease.writeFile('C:\\data\\note.txt', 'hello')
  console.log(await lease.readFile('C:\\data\\note.txt'))

  const r = await lease.exec(`
    var page = await machine.browser.newtab('https://example.com')
    var snap = await page.snapshot()
    snap.title
  `)
  console.log(r.result) // Example Domain
  await writeFile(`page.${r.screenshotMimeType!.split('/')[1]}`, r.screenshot!) // jpeg or png
} finally {
  await lease.close()
}

await sai.account.get() // plan and spendable credit
await sai.models.list() // models, with `allowed` for this plan
await sai.machines.live(pc) // a view-only stream of the screen; see Live view

import { Sai } from '@simular-ai/sai-sdk'

const org = new Sai({ apiKey: process.env.SAI_ORG_KEY, orgId: 'org_3f9a1c0b7e2d4a6f8c10' })

const tenant = await org.tenants.create('Riverside Clinic', { externalId: 'clinic-4821' })
const enrollment = await org.tenants.createEnrollment(tenant) // hand enrollment.token to your installer
console.log(await org.tenantMachines.list(tenant))

const clinic = await org.tenants.client(tenant) // acts as the Tenant
const session = await clinic.sessions.create()
await session.run("Open the calendar and read today's appointments")

import { randomUUID } from 'node:crypto'
import { Sai } from '@simular-ai/sai-sdk'

const org = new Sai({ apiKey: process.env.SAI_ORG_KEY, orgId: 'org_3f9a1c0b7e2d4a6f8c10' })

const machine = await org.tenantMachines.create('Xk2p9QzR4tLm8vNa3bCd', {
  os: 'windows',
  name: 'Riverside intake',
  requestId: randomUUID(),
  wait: true,
})
const clinic = await org.tenants.client('Xk2p9QzR4tLm8vNa3bCd')
const session = await clinic.sessions.create({ machine: machine.id })
await session.run('Open Notepad and type hello')
await org.tenantMachines.delete('Xk2p9QzR4tLm8vNa3bCd', machine)