Errors and results

const report = await nika.check(file)
if (!report.clean) return { admitted: false, report }

const run = await nika.run(file)   // a dirty file throws here instead
const result = await run.result()

if (!isNikaRunSucceeded(result)) {
  // 'failed' · 'cancelled' · 'paused' · engine-reported 'interrupted'
  return { admitted: true, status: result.status, error: result.error }
}
// narrow outputs only inside the success branch
return { admitted: true, outputs: result.outputs }

NikaError
├── NikaConfigurationError      // invalid option or unencodable inputs value
├── NikaTransportError
│   ├── NikaProtocolError
│   └── NikaObservationInterrupted   // observation lost; the run may still be live
├── NikaCompatibilityError      // engine lacks the capability (e.g. inputsLiteral)
├── NikaOperationError          // engine refused an operation with typed findings
├── NikaEventBufferOverflowError
└── NikaRunOwnershipError