@ai-ecoverse/slicc-kernel 1.77.2 → 1.78.0

package/dist/index.js

@@ -326,6 +326,9 @@ function clipboardAnswerer(port, hook) {
   };
 }
 
+// src/fs/types.ts
+var DEFAULT_USERS = "enforce";
+
 // src/fs/protect.ts
 function protectInit(protection) {
   const writers = [...writerTags(protection)];
@@ -546,6 +549,62 @@ function transferOf(reply) {
   return [reply.bytes.buffer];
 }
 
+// src/kernel/signals.ts
+var SIG = {
+  HUP: 1,
+  INT: 2,
+  QUIT: 3,
+  ILL: 4,
+  TRAP: 5,
+  ABRT: 6,
+  BUS: 7,
+  FPE: 8,
+  KILL: 9,
+  USR1: 10,
+  SEGV: 11,
+  USR2: 12,
+  PIPE: 13,
+  ALRM: 14,
+  TERM: 15,
+  STKFLT: 16,
+  CHLD: 17,
+  CONT: 18,
+  STOP: 19,
+  TSTP: 20,
+  TTIN: 21,
+  TTOU: 22,
+  URG: 23,
+  XCPU: 24,
+  XFSZ: 25,
+  VTALRM: 26,
+  PROF: 27,
+  WINCH: 28,
+  POLL: 29,
+  PWR: 30,
+  SYS: 31
+};
+var IGNORED_BY_DEFAULT = /* @__PURE__ */ new Set([SIG.CHLD, SIG.URG, SIG.WINCH]);
+var STOPPING = /* @__PURE__ */ new Set([SIG.STOP, SIG.TSTP, SIG.TTIN, SIG.TTOU]);
+function signalName(sig) {
+  const name = Object.entries(SIG).find(([, n]) => n === sig)?.[0];
+  return name === void 0 ? void 0 : `SIG${name}`;
+}
+function quiet(p) {
+  p.catch(() => void 0);
+  return p;
+}
+function signalField(sig) {
+  const name = signalName(sig);
+  return name ? { signal: name } : {};
+}
+var SIGNAL_BY_NAME = {
+  SIGINT: SIG.INT,
+  SIGTERM: SIG.TERM,
+  SIGKILL: SIG.KILL,
+  SIGSTOP: SIG.STOP,
+  SIGCONT: SIG.CONT
+};
+
 // src/sealed-relay.ts
 function sealedAnswerer(port, hook) {
   const asked = /* @__PURE__ */ new Map();
@@ -1328,6 +1387,7 @@ var Channel = class {
       return;
     }
     this.pending.delete(reply.id);
+    call.ended?.(reply.signal);
     if (reply.error !== void 0) call.reject(new KernelCallError(reply.error, reply.code));
     else call.resolve(reply.result);
   }
@@ -1376,12 +1436,14 @@ async function spawnOn(channel, argv, opts) {
   if (opts.user !== void 0) await since(channel, 8, "spawn as a user", async () => {
   });
   const started = Promise.withResolvers();
+  let endedBy;
   const options = { ...rest, ...stdin !== void 0 ? { stdin: bytesOf(stdin) } : {} };
   const { done } = channel.request(
     { op: "spawn", argv, options },
     {
       output: (fd, bytes) => (fd === 1 ? onStdout : onStderr)?.(bytes),
-      started: started.resolve
+      started: started.resolve,
+      ended: (signal) => endedBy = signal
     }
   );
   done.catch(started.reject);
@@ -1391,9 +1453,18 @@ async function spawnOn(channel, argv, opts) {
     pid,
     pgid,
     exited: done,
+    ended: endedOf(done, () => endedBy),
     signal: async (name = "SIGTERM") => void await channel.call({ op: "kill", pid: -pgid, signal: name })
   };
 }
+function endedOf(done, signal) {
+  return quiet(
+    done.then((status) => {
+      const by = signal();
+      return { status, ...by ? { signal: by } : {} };
+    })
+  );
+}
 async function runOn(channel, argv, opts) {
   const { onStdout, onStderr, ...rest } = opts;
   const chunks3 = { 1: [], 2: [] };
@@ -1407,9 +1478,15 @@ async function runOn(channel, argv, opts) {
     onStdout: tee(1, onStdout),
     onStderr: tee(2, onStderr)
   });
-  const status = await child.exited;
+  const { status, signal } = await child.ended;
   const text = (fd) => new TextDecoder().decode(concat(chunks3[fd]));
-  return { pid: child.pid, status, stdout: text(1), stderr: text(2) };
+  return {
+    pid: child.pid,
+    status,
+    ...signal ? { signal } : {},
+    stdout: text(1),
+    stderr: text(2)
+  };
 }
 async function terminalOn(channel, argv, opts) {
   const { onData, ...options } = opts;
@@ -1418,11 +1495,13 @@ async function terminalOn(channel, argv, opts) {
   let listener = onData ?? null;
   const backlog = [];
   const started = Promise.withResolvers();
+  let endedBy;
   const { id, done } = channel.request(
     { op: "open-terminal", argv, options },
     {
       output: (_fd, bytes) => listener ? listener(bytes) : backlog.push(bytes),
-      started: started.resolve
+      started: started.resolve,
+      ended: (signal) => endedBy = signal
     }
   );
   done.catch(started.reject);
@@ -1431,6 +1510,7 @@ async function terminalOn(channel, argv, opts) {
   return {
     pid,
     exited: done,
+    ended: endedOf(done, () => endedBy),
     get onData() {
       return listener;
     },
@@ -1890,7 +1970,7 @@ function initCall(options, transport) {
     ...options.hostfs ? { hostfs: true } : {},
     ...options.cdp ? { cdp: true } : {},
     ...options.hostname !== void 0 ? { hostname: options.hostname } : {},
-    ...options.users !== void 0 ? { users: options.users } : {},
+    users: options.users === void 0 ? DEFAULT_USERS : options.users,
     ...options.onDenial ? { denials: true } : {},
     ...options.sealed ? { sealed: true } : {},
     ...options.clipboard ? { clipboard: true } : {},
@@ -1933,7 +2013,7 @@ function kernelGroups(call) {
 function accounts(call, mode) {
   return { users: kernelUsers(call, mode), groups: kernelGroups(call) };
 }
-function kernelUsers(call, mode = "off") {
+function kernelUsers(call, mode = DEFAULT_USERS) {
   return {
     mode,
     add: async (user) => await call({ op: "users-add", user }),
@@ -2018,6 +2098,20 @@ function hookRelays(worker, options) {
     close: () => sealed.close()
   };
 }
+function decodedRun(result) {
+  const decoder2 = new TextDecoder();
+  return {
+    status: result.status,
+    ...signalField(result.signal),
+    stdout: decoder2.decode(result.stdout),
+    stderr: decoder2.decode(result.stderr)
+  };
+}
+function endedOf2(r) {
+  if (typeof r === "number") return { status: r };
+  const { status, signal } = r;
+  return { status, ...signalField(signal) };
+}
 async function createKernel(options = {}) {
   checkOptions(options);
   writerTags(options.protect);
@@ -2127,7 +2221,8 @@ async function createKernel(options = {}) {
     const send2 = (action) => void call({ op: "terminal", terminal: id, ...action }).catch(() => void 0);
     return {
       pid,
-      exited: done,
+      exited: quiet(done.then((r) => endedOf2(r).status)),
+      ended: quiet(done.then(endedOf2)),
       get onData() {
         return listener;
       },
@@ -2155,16 +2250,11 @@ async function createKernel(options = {}) {
         { op: "run", argv, options: { ...rest, ...input ? { stdin: input } : {} } },
         { output: (fd, bytes) => streams[fd](bytes) }
       );
-      const decoder2 = new TextDecoder();
-      return {
-        status: result.status,
-        stdout: decoder2.decode(result.stdout),
-        stderr: decoder2.decode(result.stderr)
-      };
+      return decodedRun(result);
     },
     openTerminal,
     connect: async (connectOptions = {}) => await call({ op: "connect", ...connectOptions }),
-    ...accounts(call, options.users),
+    ...accounts(call, options.users === void 0 ? DEFAULT_USERS : options.users),
     setRoutes: async (routes) => void await call({ op: "routes", routes }),
     dial,
     loopbackFetch: (input, fetchOptions) => loopbackFetch(dial, input, fetchOptions),