@ai-ecoverse/slicc-kernel 1.108.5 → 1.109.0

package/dist/types/cron/command.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from '../commands.js';
+export declare const CRONTAB_PATH = "/usr/bin/crontab";
+export declare const CRONTAB_COMMAND: Command;
+export declare const CRONTAB_SOURCE = "export default async function crontab(ctx) {\n  const say = (fd, text) => ctx.write(fd, text).catch(() => undefined);\n  const usage = async () => {\n    await say(2, \"usage: crontab [-u user] { -l | -r | -e | file | - }\\n\");\n    return 1;\n  };\n  const args = ctx.argv.slice(1);\n  let user;\n  let action;\n  let file;\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    if (arg === \"-u\") {\n      user = args[++i];\n      if (user === undefined) return usage();\n    } else if (arg === \"-l\" || arg === \"-r\" || arg === \"-e\") {\n      if (action !== undefined) return usage();\n      action = arg.slice(1);\n    } else if (arg === \"-\" || !arg.startsWith(\"-\")) {\n      if (file !== undefined) return usage();\n      file = arg;\n    } else return usage();\n  }\n  if ((action === undefined) === (file === undefined)) return usage();\n  const call = (c) => ctx.crontab(user === undefined ? c : { ...c, user });\n  const failed = async (answer) => {\n    await say(2, answer.error + \"\\n\");\n    return 1;\n  };\n  const decode = (bytes) => new TextDecoder().decode(bytes);\n  if (action === \"l\") {\n    const answer = await call({ action: \"list\" });\n    if (answer.error !== undefined) return failed(answer);\n    await say(1, answer.text);\n    return 0;\n  }\n  if (action === \"r\") {\n    const answer = await call({ action: \"remove\" });\n    return answer.error !== undefined ? failed(answer) : 0;\n  }\n  if (action === \"e\") return edit();\n  let text;\n  try {\n    if (file === \"-\") {\n      const parts = [];\n      for (;;) {\n        const chunk = await ctx.read(0);\n        if (chunk.length === 0) break;\n        parts.push(decode(chunk));\n      }\n      text = parts.join(\"\");\n    } else text = decode(await ctx.fs.readFile(ctx.resolve(file)));\n  } catch (err) {\n    await say(2, \"crontab: \" + file + \": \" + (err && err.code ? err.code : String(err)) + \"\\n\");\n    return 1;\n  }\n  const answer = await call({ action: \"install\", text });\n  return answer.error !== undefined ? failed(answer) : 0;\n\n  async function edit() {\n    const editor = ctx.env.VISUAL || ctx.env.EDITOR;\n    if (!editor) {\n      await say(2, \"crontab: set VISUAL or EDITOR to edit, or install a file with crontab <file>\\n\");\n      return 1;\n    }\n    const current = await call({ action: \"list\" });\n    const before = current.error === undefined ? current.text : \"\";\n    if (current.error !== undefined && !current.error.startsWith(\"no crontab for \")) return failed(current);\n    const tmp = \"/tmp/crontab.\" + ctx.pid + \".\" + crypto.randomUUID();\n    try {\n      const file = await ctx.open(tmp, { write: true, create: true, exclusive: true, mode: 0o600 });\n      await file.write(0, new TextEncoder().encode(before));\n      await file.close();\n    } catch (err) {\n      await say(2, \"crontab: \" + tmp + \": \" + (err && err.code ? err.code : String(err)) + \"\\n\");\n      return 1;\n    }\n    const child = await ctx.spawn({ argv: [\"/bin/bash\", \"-c\", editor + ' \"$1\"', \"crontab\", tmp] });\n    const ended = await ctx.wait(child.pid);\n    if (ended.status !== 0) {\n      await say(2, \"crontab: the editor exited with status \" + ended.status + \", crontab not changed\\n\");\n      await ctx.fs.rm(tmp).catch(() => undefined);\n      return 1;\n    }\n    const after = decode(await ctx.fs.readFile(tmp));\n    if (after === before) {\n      await say(2, \"crontab: no changes made to crontab\\n\");\n      await ctx.fs.rm(tmp).catch(() => undefined);\n      return 0;\n    }\n    const answer = await call({ action: \"install\", text: after });\n    if (answer.error !== undefined) {\n      await say(2, answer.error + \"\\ncrontab: your edit is kept in \" + tmp + \"\\n\");\n      return 1;\n    }\n    await ctx.fs.rm(tmp).catch(() => undefined);\n    return 0;\n  }\n}\n";

package/dist/types/cron/crontab.d.ts

@@ -0,0 +1,27 @@
+import type { KernelFs } from '../fs/types.js';
+import type { Cred } from '../kernel/cred.js';
+import type { Account } from '../users.js';
+export declare const CRONTAB_MAX: number;
+export interface CrontabCall {
+    op: 'proc-crontab';
+    action: 'list' | 'remove' | 'install';
+    user?: string;
+    text?: string;
+}
+export type CrontabResult = {
+    text: string;
+} | {
+    error: string;
+};
+export interface CrontabsOptions {
+    fs: KernelFs;
+    owners: boolean;
+    lookup(user: string | number): Promise<Account | undefined>;
+}
+export declare function crontabCall(req: Partial<CrontabCall>): CrontabCall | undefined;
+export declare class Crontabs {
+    private readonly o;
+    constructor(options: CrontabsOptions);
+    request(cred: Readonly<Cred>, call: CrontabCall): Promise<CrontabResult>;
+    private install;
+}

package/dist/types/index.d.ts

@@ -34,7 +34,7 @@ export { serveHostfsPort } from './mount/hostfs.js';
 export type { MountEntry, MountSpec } from './mount/mount-fs.js';
 export type { ProcessMountPolicy, ProcessMountRequest } from './mount/syscall.js';
 export type { JsChild, JsExited, JsSpawnOptions, JsStdio } from './process/js/js-children.js';
-export type { JsFdStatus, JsFdType, JsFile, JsOpenOptions, JsProgramContext, JsSignal, JsSudoAnswer, } from './process/js/js-context.js';
+export type { JsCrontabAnswer, JsCrontabCall, JsFdStatus, JsFdType, JsFile, JsOpenOptions, JsProgramContext, JsSignal, JsSudoAnswer, } from './process/js/js-context.js';
 export type { JsStatFs } from './process/js/js-io.js';
 export type { JsAddress, JsConnection, JsConnectOptions, JsListener, JsListenOptions, JsNet, } from './process/js/js-net.js';
 export type { JsRunOptions, JsRunResult, JsRunStdio } from './process/js/js-run.js';

package/dist/types/kernel/host.d.ts

@@ -67,6 +67,7 @@ export interface SpawnWasmOptions {
     writesBack?: (pid: number) => boolean;
     processes?: () => ProcessListing;
     sudo?: WasmProcessOptions['sudo'];
+    crontab?: WasmProcessOptions['crontab'];
     openFiles?: Set<VfsNodes>;
     nodes?: VfsNodes;
     statfs?: (path: string) => Promise<{

package/dist/types/kernel/process.d.ts

@@ -1,3 +1,4 @@
+import { type CrontabCall, type CrontabResult } from '../cron/crontab.js';
 import { type Created, type Dac } from '../fs/dac.js';
 import type { KernelFs } from '../fs/types.js';
 import type { MountCall } from '../mount/syscall.js';
@@ -255,7 +256,7 @@ export type WasmSyscall = {
     op: 'proc-captured';
     pid: number;
     slot: number;
-} | SudoCall | RunRequest | {
+} | SudoCall | CrontabCall | RunRequest | {
     op: 'proc-exit';
     status: number;
 } | {
@@ -368,6 +369,7 @@ export interface WasmProcessOptions {
     writesBack?: (pid: number) => boolean;
     processes?: () => ProcessListing;
     sudo?: (call: SudoCall, signal: AbortSignal) => Promise<SudoResult>;
+    crontab?: (call: CrontabCall) => Promise<CrontabResult>;
     openFiles?: Set<VfsNodes>;
     nodes?: VfsNodes;
     mounts?: () => MountLine[];
@@ -517,6 +519,7 @@ export declare class WasmProcess {
     private socketSyscall;
     private tty;
     private procSyscall;
+    private crontab;
     private signalSyscall;
     private reapsChildren;
     private sudo;

package/dist/types/launcher.d.ts

@@ -226,6 +226,7 @@ export declare class Launcher {
     readonly boot: number;
     readonly bootId: `${string}-${string}-${string}-${string}-${string}`;
     readonly cron: CronService;
+    private crontabs;
     private terminals;
     constructor(options: LauncherOptions);
     private cronService;
@@ -318,6 +319,7 @@ export declare class Launcher {
     private timesOf;
     list(viewer?: Readonly<Cred>): ProcessInfo[];
     private threadsOf;
+    private crontab;
     private sudo;
     private spawner;
     private childGroup;

package/dist/types/process/js/js-context.d.ts

@@ -76,6 +76,7 @@ export interface JsProgramContext {
     wait(pid: number, options?: JsWaitOptions): Promise<JsExited>;
     kill(pid: number, signal?: JsSignal): Promise<void>;
     sudo(args: readonly string[]): Promise<JsSudoAnswer>;
+    crontab(call: JsCrontabCall): Promise<JsCrontabAnswer>;
     umask(mask?: number): Promise<number>;
     net: JsNet;
     websocket(url: string | URL, options?: JsWebSocketOptions): Promise<JsWebSocket>;
@@ -85,6 +86,18 @@ export interface JsProgramContext {
     onUncaught(listener: JsStrayListener): () => void;
     onUnhandledRejection(listener: JsStrayListener): () => void;
 }
+export interface JsCrontabCall {
+    action: 'list' | 'remove' | 'install';
+    user?: string;
+    text?: string;
+}
+export type JsCrontabAnswer = {
+    text: string;
+    error?: undefined;
+} | {
+    error: string;
+    text?: undefined;
+};
 export type JsSudoAnswer = {
     error: string;
     errno: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-kernel",
-  "version": "1.108.5",
+  "version": "1.109.0",
   "description": "SLICC's wasm-realm kernel: run Emscripten programs in the browser against OPFS, with fork, spawn, pipes and waitpid",
   "type": "module",
   "license": "Apache-2.0",