Introduction

​

Your first result

npm install @supernovae-st/nika@0.120.2

nika: hello
model: mock/echo        # rehearsal model: echoes the prompt, calls no network LLM
permits: {}             # explicit: this workflow touches nothing
tasks:
  greet:
    infer:
      prompt: "Hello, Nika"
      max_tokens: 32    # caps the answer's length
outputs:
  greeting: ${{ tasks.greet.output }}

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

const nika = new Nika({ cwd: process.cwd() })
const run = await nika.run('hello.nika', { maxCostUsd: 0 })
const result = await run.result()

if (!isNikaRunSucceeded(result)) process.exit(1)
console.log(result.outputs.greeting)

node demo.mjs

mock(echo) · Hello, Nika

​

A real job, when you are ready

​

What just happened, one concept at a time

1. The file is the contract. The verbs infer, exec, invoke and agent — nothing else: fetching a URL or writing a file is a tool under invoke, declared and auditable.
2. Admission before execution. run() audits the file before anything executes; a broken file throws before a run exists. nika check is the same audit on its own, for CI.
3. Permits are the blast radius. permits: {} declares zero authority. A workflow that touches a file, a host or a shell must say so, or admission refuses it (NIKA-AUTH-006).
4. Runs leave evidence. Each run writes a hash-chained trace under .nika/traces/; when a receipt is present, traceVerify reads it back. Verification proves the record was not tampered with — not that a model was right.

​

Ask the file three questions

​

Where next

​

The Nika ecosystem