@ai-ecoverse/slicc-kernel 1.129.0 → 1.130.0

package/dist/types/index.d.ts

@@ -39,6 +39,7 @@ export type { JsStatFs } from './process/js/js-io.js';
 export type { JsAddress, JsConnection, JsConnectOptions, JsListener, JsListenOptions, JsNet, JsResolveOptions, JsTlsCipher, JsTlsOptions, JsTlsSession, } from './process/js/js-net.js';
 export type { JsRunOptions, JsRunResult, JsRunStdio } from './process/js/js-run.js';
 export type { JsCred, JsSyncContext, JsSyncFile } from './process/js/js-sync.js';
+export type { JsThread, JsThreadContext, JsThreadSpawnOptions } from './process/js/js-thread.js';
 export type { JsTermios, JsTty, JsTtySize } from './process/js/js-tty.js';
 export type { JsWebSocket, JsWebSocketClose, JsWebSocketMessage, JsWebSocketOptions, } from './process/js/js-websocket.js';
 export type { ApproveHook, SudoAnswer, SudoRequest } from './sudo.js';

package/dist/types/kernel/js-threads.d.ts

@@ -0,0 +1,38 @@
+import type { SyncFsResult } from '../realm/sync-fs-wire.js';
+import type { SyncSabDispatchRequest } from '../realm/sync-sab-responder.js';
+import type { ProcessClocks } from './cpu-clock.js';
+import type { WasmWorkerLike } from './host.js';
+import { type JsLane, type JsProcessInitMsg, type JsThreadSpawnMsg } from './protocol.js';
+export declare const JS_OOM: RegExp;
+export declare function jsThreadCap(env: Readonly<Record<string, string>>): number;
+type Dispatch = (req: SyncSabDispatchRequest, block?: () => void) => Promise<SyncFsResult>;
+export interface JsThreadDeps {
+    cap: number;
+    wakes: Set<Int32Array>;
+    createWorker: () => WasmWorkerLike;
+    init: (sab: SharedArrayBuffer, lane: JsLane) => JsProcessInitMsg;
+    openLane: (dispatch: Dispatch) => {
+        lane: JsLane;
+        dispose(): void;
+    };
+    attach: (worker: WasmWorkerLike, sab: SharedArrayBuffer, dispatch: Dispatch) => {
+        dispose(): void;
+    };
+    dispatch: Dispatch;
+    clocks: Pick<ProcessClocks, 'thread' | 'threadEnded' | 'timed'>;
+}
+export declare class JsThreads {
+    private readonly deps;
+    private readonly live;
+    private readonly headers;
+    private frozen;
+    private last;
+    private closed;
+    constructor(deps: JsThreadDeps);
+    get size(): number;
+    spawn(msg: JsThreadSpawnMsg): void;
+    private crashed;
+    stopped(stopped: boolean): void;
+    close(): void;
+}
+export {};

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

@@ -13,6 +13,13 @@ export declare const WASM_THREAD_INIT = "wasm-thread-init";
 export declare const WASM_THREAD_EXIT = "wasm-thread-exit";
 export declare const WASM_MAX_THREADS = 256;
 export declare const WASM_DEFAULT_THREADS = 64;
+export declare const JS_THREAD_SPAWN = "js-thread-spawn";
+export declare const JS_THREAD_INIT = "js-thread-init";
+export declare const JS_THREAD_EXIT = "js-thread-exit";
+export declare const JS_MAX_THREADS = 256;
+export declare const JS_DEFAULT_THREADS = 16;
+export declare const JS_THREAD_NO_MEMORY = 256;
+export declare const JS_THREAD_CRASHED = 257;
 export interface WasmProgram {
     abi?: 'emscripten' | 'wasi';
     glue: string;
@@ -99,6 +106,34 @@ export type JsProcessInitMsg = Omit<WasmProcessInitMsg, 'program' | 'fork'> & {
     lane?: JsLane;
 };
 export type ProcessInitMsg = WasmProcessInitMsg | JsProcessInitMsg;
+export interface JsThreadSpawnMsg {
+    type: typeof JS_THREAD_SPAWN;
+    data: unknown;
+    port: MessagePort;
+    control: MessagePort;
+    transfer: Transferable[];
+}
+export interface JsThreadStart {
+    tid: number;
+    port: MessagePort;
+    data: unknown;
+}
+export type JsThreadInitMsg = Omit<JsProcessInitMsg, 'type'> & {
+    type: typeof JS_THREAD_INIT;
+    thread: JsThreadStart;
+};
+export interface JsThreadExitMsg {
+    type: typeof JS_THREAD_EXIT;
+    code: number;
+}
+export type JsThreadControl = {
+    tid: number;
+} | {
+    errno: 'EAGAIN' | 'ESRCH';
+    message: string;
+} | {
+    exited: number;
+};
 export interface WasmProcessExitMsg {
     type: typeof WASM_PROCESS_EXIT;
     code: number;

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

@@ -4,6 +4,7 @@ import { type JsFdType, type JsOpenOptions, type JsStatFs, type JsWriteOptions }
 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 { JsThreadContext } from './js-thread.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';
@@ -90,6 +91,7 @@ export interface JsProgramContext {
     tty: JsTty;
     fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
     exit(code?: number): never;
+    readonly thread: JsThreadContext;
     onUncaught(listener: JsStrayListener): () => void;
     onUnhandledRejection(listener: JsStrayListener): () => void;
 }
@@ -144,6 +146,7 @@ export interface ContextOptions {
     random?: (bytes: Uint8Array) => void;
     lane?: SyncCall;
     strays?: JsStrays;
+    thread: JsThreadContext;
 }
 export interface Identity {
     pid: number;

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

@@ -0,0 +1,22 @@
+import { type JsThreadStart } from '../../kernel/protocol.js';
+import type { SabPostLike } from '../../realm/sync-sab-bridge.js';
+export interface JsThread {
+    readonly tid: number;
+    readonly port: MessagePort;
+    readonly exited: Promise<number>;
+    terminate(): Promise<void>;
+}
+export interface JsThreadSpawnOptions {
+    data?: unknown;
+    transfer?: readonly Transferable[];
+}
+export interface JsThreadContext {
+    readonly tid: number;
+    readonly port: MessagePort | undefined;
+    readonly data: unknown;
+    readonly NO_MEMORY: number;
+    readonly CRASHED: number;
+    spawn(options?: JsThreadSpawnOptions): Promise<JsThread>;
+}
+export declare function outOfMemory(err: unknown): boolean;
+export declare function threadContext(post: SabPostLike, start?: JsThreadStart): JsThreadContext;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-kernel",
-  "version": "1.129.0",
+  "version": "1.130.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",
@@ -68,7 +68,7 @@
     "@ai-ecoverse/slicc-scrub": "1.0.0",
     "@ai-ecoverse/slicc-shared-web": "1.24.2",
     "@ai-ecoverse/wasi-cargo": "0.99.0-3",
-    "@ai-ecoverse/wasi-pnpm": "12.9.1-13",
+    "@ai-ecoverse/wasi-pnpm": "12.9.1-15",
     "@ai-ecoverse/wasi-ripgrep": "15.2.0-5",
     "@ai-ecoverse/wasi-rustc": "1.98.1-6",
     "@ai-ecoverse/wasi-zig": "0.16.0-17",