<< lib/vm/SleelaVMSystemCallBridge.sleela SLeeLa Standard Library Definition. Definition: Defines SleelaVMSystemCallBridge — the VM-family face of the operating-system System Call API. Where SLVMNativeBinding is the lifecycle anchor for "the VM reaches native code," this class is the concrete bridge that exposes the host System API to a running VM through the os* built-ins (OP_OS_* opcodes), serviced by impl/core/sleela_os.c on Windows, Linux, and macOS. Every SLeeLa VM — the base SLVM and generations SLVM/1..11 — shares one ISA, so if the base VM can issue these system calls, every generation can too; this class is how a VM advertises and performs them. Capability: pairs with SleelaVMFeatureBits.PROCESS and .OS_SYSCALLS. A VM that sets those bits is declaring it supports this bridge. A spawned process is a VM-local bounded handle (the sockets/files discipline), never a raw PID. Family: vm. Native VM/OS work crosses the explicit os* SLVM bridge. >> #sleela 2.5 material; class SleelaVMSystemCallBridge { < ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- > << Eleven catalogued attributes with getter/setter pairs, so a GUI, loader, or catalog can read and (where appropriate) override this record. Values are faithful to the subject's real origin where publicly known. >> String metaVersion = "1.0.0"; int metaId = 10289; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-16"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | International | Galactic > String metaOrigin = "International"; String metaBirthDate = "2026-10-06"; < metaScienceRating: maturity/robustness on a 1..10 scale > int metaScienceRating = 9; < metaNationalSchedule: a real, citable instrument or "none" > String metaNationalSchedule = "none"; String getMetaVersion() { return metaVersion; } void setMetaVersion(String v) { metaVersion = v; } int getMetaId() { return metaId; } void setMetaId(int v) { metaId = v; } String getAuthor() { return metaAuthor; } void setAuthor(String v) { metaAuthor = v; } String getDate() { return metaDate; } void setDate(String v) { metaDate = v; } String getCopyright() { return metaCopyright; } void setCopyright(String v) { metaCopyright = v; } String getTrademark() { return metaTrademark; } void setTrademark(String v) { metaTrademark = v; } String getCorporation() { return metaCorporation; } void setCorporation(String v) { metaCorporation = v; } String getOrigin() { return metaOrigin; } void setOrigin(String v) { metaOrigin = v; } String getBirthDate() { return metaBirthDate; } void setBirthDate(String v) { metaBirthDate = v; } int getScienceRating() { return metaScienceRating; } void setScienceRating(int v) { metaScienceRating = v; } String getNationalSchedule() { return metaNationalSchedule; } void setNationalSchedule(String v) { metaNationalSchedule = v; } String name; int state; int calls; void configure(String n) { name = n; state = 0; calls = 0; } void start() { state = 1; } void stop() { state = 0; } boolean active() { return state == 1; } < ---- Host identity ------------------------------------------------------ > String platform() { calls = calls + 1; return osPlatform(); } String hostName() { calls = calls + 1; return osHostName(); } String userName() { calls = calls + 1; return osUserName(); } int processId() { calls = calls + 1; return osProcessId(); } boolean supports(int capability) { calls = calls + 1; return osCapability(capability) == 1; } < ---- Environment -------------------------------------------------------- > String getEnv(String key) { calls = calls + 1; return osGetEnv(key); } boolean setEnv(String key, String value) { calls = calls + 1; return osSetEnv(key, value) == 0; } < ---- Working directory -------------------------------------------------- > String currentDir() { calls = calls + 1; return osCurrentDir(); } boolean changeDir(String path) { calls = calls + 1; return osChangeDir(path) == 0; } String tempDir() { calls = calls + 1; return osTempDir(); } < ---- Filesystem metadata ------------------------------------------------ > boolean exists(String path) { calls = calls + 1; return osExists(path) == 1; } boolean isDir(String path) { calls = calls + 1; return osIsDir(path) == 1; } int fileSize(String path) { calls = calls + 1; return osFileSize(path); } boolean makeDir(String path) { calls = calls + 1; return osMakeDir(path) == 0; } boolean remove(String path) { calls = calls + 1; return osRemove(path) == 0; } boolean rename(String from, String to) { calls = calls + 1; return osRename(from, to) == 0; } < ---- Process execution (bounded VM-local handles) ----------------------- > < Synchronous run; returns the command's exit code. > int run(String command) { calls = calls + 1; return osRun(command); } < Background start; returns a VM-local process handle (-1 on failure). > int spawn(String command) { calls = calls + 1; return osSpawn(command); } < Wait for a spawned process; returns its exit code and frees the handle. > int waitFor(int processHandle) { calls = calls + 1; return osWait(processHandle); } < Terminate a spawned process. > boolean kill(int processHandle) { calls = calls + 1; return osKill(processHandle) == 0; } < Release a spawned process without waiting. > void closeProcess(int processHandle) { calls = calls + 1; osProcessClose(processHandle); } < ---- OS-level-support catalogue integration --------------------------- > < The existing OP_OS_* bridge is the VM execution path. This list records the OSLS taxonomy groups that have a corresponding current VM built-in. > SLList osSupportVMGroups() { SLList out = new SLList(); out.add("HostIdentity"); out.add("Environment"); out.add("PathManagement"); out.add("FileSystem"); out.add("ProcessInspection"); out.add("ProcessControl"); out.add("CapabilityDiscovery"); out.add("OSLSInspection"); out.add("CPUArchitecture"); out.add("TimeZoneCalendar"); out.add("NetworkInterfaces"); out.add("Scheduling"); return out; } < Canonical current OS service opcodes; codes are append-only in the VM ISA. > SLList osSupportVMOpcodes() { SLList out = new SLList(); out.add("OP_OS_PLATFORM=103"); out.add("OP_OS_CAPABILITY=104"); out.add("OP_OS_GETENV=105"); out.add("OP_OS_SETENV=106"); out.add("OP_OS_CWD=107"); out.add("OP_OS_CHDIR=108"); out.add("OP_OS_HOSTNAME=109"); out.add("OP_OS_USERNAME=110"); out.add("OP_OS_TEMPDIR=111"); out.add("OP_OS_PID=112"); out.add("OP_OS_EXISTS=113"); out.add("OP_OS_ISDIR=114"); out.add("OP_OS_FILESIZE=115"); out.add("OP_OS_MKDIR=116"); out.add("OP_OS_REMOVE=117"); out.add("OP_OS_RENAME=118"); out.add("OP_OS_RUN=119"); out.add("OP_OS_SPAWN=120"); out.add("OP_OS_WAIT=121"); out.add("OP_OS_KILL=122"); out.add("OP_OS_PCLOSE=123"); out.add("OP_OSLS_CALL=155"); return out; } < These methods identify which layer is present. The OP_OS_* host bridge is implemented in impl/core/sleela_os.c. The richer osls_* metadata ABI remains a separate C library and is not claimed as VM-registered until a host adapter registers and tests its symbols. > boolean coreOSOpcodeBridgeImplemented() { return true; } boolean oslsCAbiAdapterRegistered() { return false; } < OSLS read-only host inspection: the VM returns status-bearing JSON Strings, never raw native pointers or C record layouts. > String oslsSystemInfoJSON() { calls = calls + 1; return oslsSystemInfo(); } String oslsProcessInfoJSON(int pid) { calls = calls + 1; return oslsProcessInfo(pid); } String oslsEnumerateProcessesJSON() { calls = calls + 1; return oslsEnumerateProcesses(); } String oslsGetEnvironmentValueJSON(String name) { calls = calls + 1; return oslsGetEnvironmentValue(name); } String oslsEnumerateEnvironmentJSON() { calls = calls + 1; return oslsEnumerateEnvironment(); } String oslsGetFileInfoJSON(String path) { calls = calls + 1; return oslsGetFileInfo(path); } String oslsListDirectoryJSON(String path) { calls = calls + 1; return oslsListDirectory(path); } String oslsGetCPUInfoJSON() { calls = calls + 1; return oslsGetCPUInfo(); } String oslsGetTimezoneInfoJSON() { calls = calls + 1; return oslsGetTimezoneInfo(); } String oslsGetNetworkInterfacesJSON() { calls = calls + 1; return oslsGetNetworkInterfaces(); } String oslsCronValidateJSON(String expression) { calls = calls + 1; return oslsCronValidate(expression); } String oslsCronNextAfterJSON(String expression, int epochSeconds) { calls = calls + 1; return oslsCronNextAfter(expression, epochSeconds); } int callCount() { return calls; } }