/* builtin.h — runtime services bytecode can't express (spec §3/§5):
 * now/print/print_int/words plus the container bridge to cont.c. One
 * dispatcher: takes the VM, the current frame's registers, and the
 * instruction; 0 = ok, else a WO_T_* trap code with *msg set. */
#ifndef WO_BUILTIN_H
#define WO_BUILTIN_H

#include "vm.h"

/* Not a trap code: the stop flag (SIGTERM/SIGINT, armed by `env.stopping`)
 * was set when a BLOCKING call was interrupted, so the call does not restart
 * the syscall — it hands this back and the VM ends the program with it. A
 * service parked in `accept` otherwise never observes the flag and only
 * `kill -9` ends it. Negative so it cannot collide with a WO_T_* code, and
 * deliberately NOT catchable: `try` must not be able to swallow a stop. */
#define WO_SYS_STOPPED (-2)

int wo_builtin(wo_vm *vm, uint64_t *R, uint32_t ins, const char **msg);

/* The systems stdlib's OS half (runtime/src/sysio.c): same contract as
 * wo_builtin above — 0 on success, a WO_T_* code with *msg set on failure.
 * wo_builtin dispatches every id at or above WO_B_SYS_FIRST here. */
int wo_builtin_sys(wo_vm *vm, uint64_t *R, uint32_t ins, const char **msg);

/* json.encode / json.decode (runtime/src/json.c), same contract again. */
int wo_builtin_json(wo_vm *vm, uint64_t *R, uint32_t ins, const char **msg);

#endif /* WO_BUILTIN_H */