TypeScript quickstart

npm install @supernovae-st/nika@0.120.2
npm ls @supernovae-st/nika

nika: hello-sdk
model: mock/echo
permits: {}
tasks:
  greet:
    infer:
      prompt: "Hello, Nika"
      max_tokens: 32
outputs:
  greeting: ${{ tasks.greet.output }}

import { Nika, isNikaRunSucceeded } from '@supernovae-st/nika'

const nika = new Nika({ cwd: process.cwd() })

// run() admits the file first — a workflow that fails admission throws
// here, before any run handle exists.
const run = await nika.run('hello.nika', { maxCostUsd: 0 })

// result() is the sole settlement. An admitted workflow that fails resolves
// with status 'failed' — it does not throw, so try/catch alone will miss it.
const result = await run.result()

if (result.status === 'paused') {
  // a human gate holds the run — not a success, not a failure
  console.error('run paused; resume with nika run --resume')
  process.exit(4)
}
if (!isNikaRunSucceeded(result)) {
  console.error(result.status, result.error)
  process.exit(1)
}
console.log(result.outputs.greeting) // mock(echo) · Hello, Nika

node demo.mjs

mock(echo) · Hello, Nika

// 1. Static admission on its own — authoring and CI. A red check never
//    becomes a run.
const report = await nika.check('hello.nika', { nativeStrict: true })
if (!report.clean) process.exit(2)

// 2. Live events while a fresh run executes.
const secondRun = await nika.run('hello.nika', { maxCostUsd: 0 })
for await (const event of secondRun.events()) {
  console.log(event.kind, event.task ?? '', event.status ?? '')
}
const secondResult = await secondRun.result()

// 3. Verify the receipt that run wrote.
if (secondResult.receipt) {
  console.log(await nika.traceVerify(secondResult.receipt))
}