NoshAPI
The FFI surfaces the nOSh runtime exposes to cartridge KEC Lisp. The runtime has two active host contracts during the ADR-0027 spike window:
- Full runtime surface (
kn86emu) — the SDL desktop emulator and launch-cart compatibility path. This includes the ADR-0005 primitive set plus later additions for graphics, sound, CIPHER-LINE, nEmacs, snippets, saves, provenance, and panic recovery. - Constrained cell surface (
kn86-nosh-tb) — the termbox2 device spike. This intentionally exposes only a small draw surface plus semantic input callbacks. Cartridges cannot call termbox directly, clear runtime chrome, change terminal modes, or read raw key events.
Contents
Section titled “Contents”versioning.md— FFI versioning contract: how primitive signatures evolve, deprecation policy, ABI stability guarantees.primitives-by-category.md— full-runtime primitive index grouped by category.cell-api.md— constrainedkn86-nosh-tbcell API and semantic input callback contract.
Related
Section titled “Related”adr/ADR-0005— the canonical 54-primitive list.adr/ADR-0027— termbox2 spike and constrained cell API decision.adr/ADR-0007— mission-specific FFI.- KEC Lisp — the language these primitives are exposed to.
../../runtime/orchestration.md— the runtime that implements them.