@ai-ecoverse/slicc-kernel 1.124.13 → 1.125.0

package/dist/types/fs/watch.d.ts

@@ -4,12 +4,27 @@ export type WatchChange = {
 } | {
     overflow: true;
 };
+export type WatchEventType = 'rename' | 'change';
+export type WatchNote = {
+    type: WatchEventType;
+    filename: string;
+} | {
+    overflow: true;
+} | {
+    ended: true;
+};
+export interface TypedWatch {
+    next(signal: AbortSignal): Promise<WatchNote[]>;
+    close(): void;
+}
+export declare const WATCH_NOTES_LIMIT = 1000;
 export interface WatchOptions {
     recursive?: boolean;
 }
 export declare const WATCH_BATCH_LIMIT = 1000;
 export declare class FsWatchers {
     private readonly watchers;
+    private readonly typed;
     private readonly taps;
     private readonly reals;
     private readonly reshapes;
@@ -17,7 +32,11 @@ export declare class FsWatchers {
     reshaped(): void;
     tap(listener: (paths: string[]) => void): void;
     watch(paths: string[], options: WatchOptions, notify: (change: WatchChange) => void): () => void;
+    typedWatch(root: string, recursive: boolean, alias?: string): TypedWatch;
+    private covers;
+    private emit;
     changed(...paths: string[]): void;
+    private report;
     private flush;
     wrap(fs: KernelFs): KernelFs;
 }

package/dist/types/kernel/fd-table.d.ts

@@ -12,6 +12,7 @@ export interface PollState {
     readable: boolean;
     writable: boolean;
     hangup: boolean;
+    nread?: number;
     rdhup?: boolean;
     error?: boolean;
 }

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

@@ -90,6 +90,7 @@ export interface SpawnWasmOptions {
     locks?: KernelLocks;
     fifos?: FifoTable;
     sems?: SemTable;
+    watches?: WasmProcessOptions['watches'];
     onReap?: (pid: number) => void;
     resolver?: Resolver;
 }

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

@@ -29,6 +29,7 @@ import { LoopbackNet } from './socket.js';
 import { type SocketSyscall } from './socket-syscalls.js';
 import type { Termios } from './tty.js';
 import { type VersionPin, type VfsFileFs, VfsNodes } from './vfs-file.js';
+import { type WatchSource, type WatchSyscall } from './watch-ops.js';
 export type WasmSyscall = {
     op: 'fd-read';
     fd: number;
@@ -334,7 +335,7 @@ export type WasmSyscall = {
     tid?: number;
 } | {
     op: 'sig-pause';
-} | SocketSyscall | EpollSyscall | SemSyscall | HttpSyscall | PtySyscall | HostSyscall;
+} | SocketSyscall | EpollSyscall | SemSyscall | HttpSyscall | PtySyscall | HostSyscall | WatchSyscall;
 export interface FdInfo {
     tty: boolean;
     kind: KernelFdKind;
@@ -397,6 +398,7 @@ export interface WasmProcessOptions {
     dl?: DlState;
     raise?: (sig: number, info?: SigInfo) => void;
     exitNow?: (status: number) => void;
+    watches?: WatchSource | undefined;
     exitSignal?: (sig: number) => void;
     onReap?: (pid: number) => void;
     jobs?: JobTable;
@@ -412,6 +414,7 @@ export type StateListener = (state: 'stopped' | 'continued', sig: number) => voi
 export type SignalOutcome = DefaultAction | 'deliver' | 'forward';
 export declare class WasmProcess {
     private exited;
+    private readonly watches;
     private readonly children;
     private readonly deathSignals;
     private caught;

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

@@ -3,5 +3,6 @@ export interface SelectResult {
     read: number[];
     write: number[];
     hangup?: number[];
+    nread?: Record<number, number>;
 }
 export declare function selectFds(fds: FdTable, read: readonly number[], write: readonly number[], timeoutMs: number, interrupt: AbortSignal): Promise<SelectResult>;

package/dist/types/kernel/watch-ops.d.ts

@@ -0,0 +1,30 @@
+import type { TypedWatch } from '../fs/watch.js';
+import type { SyncFsResult } from '../realm/sync-fs-wire.js';
+export type WatchSyscall = {
+    op: 'watch-open';
+    path: string;
+    recursive?: boolean;
+} | {
+    op: 'watch-next';
+    id: number;
+} | {
+    op: 'watch-close';
+    id: number;
+};
+export declare const WATCH_OPS: readonly ['watch-open', 'watch-next', 'watch-close'];
+export declare function isWatchSyscall(req: {
+    op: string;
+}): req is WatchSyscall;
+export declare const WATCHES_MAX = 8192;
+export declare function visibleTo(watch: TypedWatch, root: string, visible: (dir: string) => Promise<boolean>): TypedWatch;
+export interface WatchSource {
+    open(path: string, recursive: boolean): Promise<TypedWatch>;
+}
+export declare class ProcessWatches {
+    private readonly open;
+    private nextId;
+    private readonly source;
+    constructor(source: WatchSource | undefined);
+    syscall(req: WatchSyscall, cancelled: AbortSignal): Promise<SyncFsResult>;
+    closeAll(): void;
+}

package/dist/types/launcher.d.ts

@@ -360,6 +360,7 @@ export declare class Launcher {
     private fsaDriver;
     revokeIntegrity(path?: string): Promise<void>;
     attest(path: string): Promise<Attestation>;
+    private watchSource;
     watchFiles(paths: readonly string[], notify: (path: string) => void): Promise<() => void>;
     mount(spec: MountSpec): Promise<MountEntry>;
     private mountShm;

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

@@ -5,6 +5,7 @@ import { type JsKernel } from './js-kernel.js';
 import { type JsNet } from './js-net.js';
 import { type JsSyncContext, type SyncCall } from './js-sync.js';
 import { type JsTty } from './js-tty.js';
+import { type JsWatcher, type JsWatchListener, type JsWatchOptions } from './js-watch.js';
 import { type JsWebSocket, type JsWebSocketOptions } from './js-websocket.js';
 export type { JsFdType, JsOpenOptions } from './js-io.js';
 export interface JsFile {
@@ -65,6 +66,7 @@ export interface JsProgramContext {
         writeFile(path: string, data: Uint8Array | string, options?: {
             mode?: number;
         }): Promise<void>;
+        watch(path: string, options: JsWatchOptions | JsWatchListener, listener?: JsWatchListener): Promise<JsWatcher>;
     };
     signals: {
         on(signal: JsSignal, handler: (signal: number) => void): Promise<void>;

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

@@ -5,6 +5,7 @@ import type { JsChild, JsSpawnOptions } from './js-children.js';
 import { type FdInfo, type JsOpenOptions, type JsStatFs } from './js-io.js';
 import { type JsKernel } from './js-kernel.js';
 import type { JsRunOptions, JsRunResult } from './js-run.js';
+import type { JsWatcher, JsWatchListener, JsWatchOptions } from './js-watch.js';
 export type SyncCall = (req: SyncSabRequestBody) => SyncFsResult;
 export interface JsSyncFile {
     readonly fd: number;
@@ -61,6 +62,7 @@ export interface JsSyncContext {
         writeFile(path: string, data: Uint8Array | string, options?: {
             mode?: number;
         }): void;
+        watch(path: string, options: JsWatchOptions | JsWatchListener, listener?: JsWatchListener): JsWatcher;
     };
 }
 export interface SyncShared {
@@ -83,4 +85,6 @@ export declare class JsSyncKernel {
     bytes(req: SyncSabRequestBody): Uint8Array;
     blocking(req: SyncSabRequestBody): SyncFsResult;
 }
-export declare function syncOps(kernel: JsSyncKernel, shared: SyncShared): Omit<JsSyncContext, 'run' | 'spawn' | 'exit' | 'kill' | 'cred' | 'setcred' | 'kernel' | 'umask'>;
+export declare function syncOps(kernel: JsSyncKernel, shared: SyncShared): Omit<JsSyncContext, 'run' | 'spawn' | 'exit' | 'kill' | 'cred' | 'setcred' | 'kernel' | 'umask' | 'fs'> & {
+    fs: Omit<JsSyncContext['fs'], 'watch'>;
+};

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

@@ -0,0 +1,17 @@
+import type { WatchNote } from '../../fs/watch.js';
+import type { JsKernel } from './js-kernel.js';
+export type JsWatchNote = WatchNote;
+export interface JsWatchOptions {
+    recursive?: boolean;
+}
+export interface JsWatcher {
+    close(): void;
+}
+export type JsWatchListener = (note: JsWatchNote) => void;
+export declare function watchRequest(path: string, options: JsWatchOptions | undefined): {
+    op: 'watch-open';
+    path: string;
+    recursive?: boolean | undefined;
+};
+export declare function watchArgs(options: JsWatchOptions | JsWatchListener | undefined, listener: JsWatchListener | undefined): [JsWatchOptions, JsWatchListener];
+export declare function follow(kernel: Pick<JsKernel, 'blocking' | 'call'>, id: number, onNote: JsWatchListener): JsWatcher;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-kernel",
-  "version": "1.124.13",
+  "version": "1.125.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",
@@ -66,7 +66,7 @@
     "@ai-ecoverse/py-numpy": "2.3.2-11",
     "@ai-ecoverse/slicc-node": "2.5.1",
     "@ai-ecoverse/slicc-scrub": "1.0.0",
-    "@ai-ecoverse/slicc-shared-web": "1.23.3",
+    "@ai-ecoverse/slicc-shared-web": "1.24.0",
     "@ai-ecoverse/wasi-cargo": "0.99.0-3",
     "@ai-ecoverse/wasi-pnpm": "12.9.1-10",
     "@ai-ecoverse/wasi-ripgrep": "15.2.0-5",
@@ -81,7 +81,7 @@
     "@ai-ecoverse/wasm-procps": "4.0.7-3",
     "@ai-ecoverse/wasm-sqlite3": "3.54.0-5",
     "@ai-ecoverse/wasm-tar": "1.35.0-7",
-    "@ai-ecoverse/wasm-tls-engine": "4.2.0-3",
+    "@ai-ecoverse/wasm-tls-engine": "4.2.0-4",
     "@ai-ecoverse/wasm-tree": "2.3.2-4",
     "@ai-ecoverse/wasm-util-linux": "2.42.4-3",
     "@biomejs/biome": "2.5.15",