@ai-ecoverse/slicc-kernel 1.178.4 → 1.180.0

package/dist/process-worker.js

@@ -3180,7 +3180,7 @@ var init_version = __esm({
   "src/version.ts"() {
     "use strict";
     init_captured_globals();
-    KERNEL_VERSION = true ? "1.178.4" : "0.0.0-dev";
+    KERNEL_VERSION = true ? "1.180.0" : "0.0.0-dev";
     OS_RELEASE = "6.0.0-slicc";
   }
 });

package/dist/types/client/attach.d.ts

@@ -4,11 +4,13 @@ import type { FsStat, UsersMode } from '../fs/types.js';
 import type { WatchChange } from '../fs/watch.js';
 import { type EmbedderHook } from '../kernel/embedder.js';
 import type { RealmTransport, RealmTransportRequest, RealmTransportResponse, RealmTransportTraits } from '../kernel/net/transport.js';
+import type { TraceEvent } from '../kernel/trace.js';
 import type { MountEntry, MountSpec } from '../mount/mount-fs.js';
 import { type DialledSocket, type DialOptions } from './dial-stream.js';
 import { type LoopbackFetchOptions } from './loopback-fetch.js';
 import { type LockManagerLike, type MessagePortLike, type ProcessEntry } from './protocol.js';
 export type { WatchChange } from '../fs/watch.js';
+export type { TraceEvent, TraceExec, TraceExit, TraceFork } from '../kernel/trace.js';
 export type { ProcessEntry } from './protocol.js';
 export declare class KernelGoneError extends Error {
     constructor(message?: string);
@@ -24,12 +26,13 @@ export interface AttachOptions {
 }
 export interface SpawnOptions {
     cwd?: string;
+    cwdMissing?: 'create' | 'error';
     user?: string | number;
     env?: Record<string, string>;
     stdin?: string | Uint8Array;
     group?: 'new';
     pgid?: number;
-    tag?: string;
+    tag?: string | readonly string[];
     onStdout?: (bytes: Uint8Array) => void;
     onStderr?: (bytes: Uint8Array) => void;
 }
@@ -46,10 +49,11 @@ export interface SpawnedProcess {
 }
 export interface ClientRunOptions {
     cwd?: string;
+    cwdMissing?: 'create' | 'error';
     user?: string | number;
     env?: Record<string, string>;
     stdin?: string | Uint8Array;
-    tag?: string;
+    tag?: string | readonly string[];
     onStdout?: (text: string) => void;
     onStderr?: (text: string) => void;
 }
@@ -62,11 +66,12 @@ export interface ClientRunResult {
 }
 export interface ClientTerminalOptions {
     cwd?: string;
+    cwdMissing?: 'create' | 'error';
     user?: string | number;
     env?: Record<string, string>;
     cols?: number;
     rows?: number;
-    tag?: string;
+    tag?: string | readonly string[];
     onData?: (bytes: Uint8Array) => void;
 }
 export interface ClientTerminal {
@@ -101,6 +106,13 @@ export interface ClientFs {
         close(): void;
     }>;
 }
+export interface TraceBatch {
+    events: TraceEvent[];
+    dropped: number;
+}
+export interface TraceOptions {
+    limit?: number;
+}
 export type ClientFetchRequest = Omit<RealmTransportRequest, 'signal'> & {
     signal?: AbortSignal;
 };
@@ -130,6 +142,9 @@ export interface KernelClient {
         close(): void;
     }>;
     onTraits(listener: (traits: RealmTransportTraits) => void): () => void;
+    trace(tag: string, onEvents: (batch: TraceBatch) => void | Promise<unknown>, options?: TraceOptions): Promise<{
+        close(): void;
+    }>;
     close(options?: {
         kill?: boolean;
     }): Promise<void>;

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

@@ -2,6 +2,7 @@ import type { UsersMode } from '../fs/types.js';
 import type { WatchChange } from '../fs/watch.js';
 import type { TransportCall, TransportReply } from '../kernel/net/remote-transport.js';
 import type { RealmTransportTraits } from '../kernel/net/transport.js';
+import type { TraceEvent } from '../kernel/trace.js';
 import type { MountSpec } from '../mount/mount-fs.js';
 export declare const PROTOCOL: readonly [number, number];
 export interface ClientHello {
@@ -21,19 +22,21 @@ export interface KernelHello {
 }
 export interface SpawnRequestOptions {
     cwd?: string;
+    cwdMissing?: 'create' | 'error';
     user?: string | number;
     env?: Record<string, string>;
     stdin?: Uint8Array;
     pgid?: number;
-    tag?: string;
+    tag?: string | readonly string[];
 }
 export interface TerminalRequestOptions {
     cwd?: string;
+    cwdMissing?: 'create' | 'error';
     user?: string | number;
     env?: Record<string, string>;
     cols?: number;
     rows?: number;
-    tag?: string;
+    tag?: string | readonly string[];
 }
 export type TerminalAction = {
     action: 'write';
@@ -102,6 +105,13 @@ export type ClientCall = {
 } | {
     op: 'unserve-facade';
     registration: number;
+} | {
+    op: 'trace';
+    tag: string;
+    limit?: number;
+} | {
+    op: 'untrace';
+    trace: number;
 } | {
     op: 'detach';
     kill?: boolean;
@@ -119,16 +129,24 @@ export interface ClientReply {
     started?: number;
     signal?: string;
 }
+export interface TraceAck {
+    traceAck: number;
+}
 export type ClientMessage = {
     hello: ClientHello;
-} | ClientRequest | TransportCall;
+} | ClientRequest | TransportCall | TraceAck;
 export interface WatchEvent {
     watch: number;
     change: WatchChange;
 }
+export interface TraceMessage {
+    trace: number;
+    events: TraceEvent[];
+    dropped?: number;
+}
 export type KernelMessage = {
     hello: KernelHello;
-} | ClientReply | WatchEvent | TransportReply;
+} | ClientReply | WatchEvent | TraceMessage | TransportReply;
 export interface ProcessEntry {
     pid: number;
     ppid: number;

package/dist/types/index.d.ts

@@ -18,7 +18,7 @@ import type { ApproveHook } from './sudo.js';
 import { type NetworkTransport } from './transport.js';
 import type { Account, AddGroup, AddUser, Group, RemoveUser } from './users.js';
 export type { CdpConnection, CdpHook, CdpRequest } from './cdp/types.js';
-export { type AttachOptions, attachKernel, type ClientEnded, type ClientFetchRequest, type ClientFs, type ClientRunOptions, type ClientRunResult, type ClientTerminal, type ClientTerminalOptions, KernelCallError, type KernelClient, KernelGoneError, type ProcessEntry, type SpawnedProcess, type SpawnOptions, type WatchChange, } from './client/attach.js';
+export { type AttachOptions, attachKernel, type ClientEnded, type ClientFetchRequest, type ClientFs, type ClientRunOptions, type ClientRunResult, type ClientTerminal, type ClientTerminalOptions, KernelCallError, type KernelClient, KernelGoneError, type ProcessEntry, type SpawnedProcess, type SpawnOptions, type TraceBatch, type TraceEvent, type TraceExec, type TraceExit, type TraceFork, type TraceOptions, type WatchChange, } from './client/attach.js';
 export type { DialledSocket, DialOptions } from './client/dial-stream.js';
 export type { LoopbackFetchOptions } from './client/loopback-fetch.js';
 export type { FacadeConnection, FacadeHook, FacadeInfo, FacadeSpec, FacadeSpecs, } from './facade/types.js';
@@ -86,8 +86,10 @@ export interface MountPending {
     source: string;
     insert(): Promise<void>;
 }
+export type CwdMissing = 'create' | 'error';
 export interface RunOptions {
     cwd?: string;
+    cwdMissing?: CwdMissing;
     user?: string | number;
     tag?: string;
     env?: Record<string, string>;
@@ -150,6 +152,7 @@ export interface Kernel {
 }
 export interface TerminalOptions {
     cwd?: string;
+    cwdMissing?: CwdMissing;
     user?: string | number;
     tag?: string;
     env?: Record<string, string>;

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

@@ -29,7 +29,8 @@ export declare class JobTable {
     pgidOf(pid: number): number | undefined;
     sidOf(pid: number): number | undefined;
     private member;
-    private idOf;
+    idOf(pid: number): number;
+    execParentOf(pid: number): number | undefined;
     private byId;
     setpgid(caller: number, pid: number, pgid: number): void;
     get handoffCount(): number;

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

@@ -0,0 +1,59 @@
+import { type Cred } from './cred.js';
+export interface TraceExec {
+    type: 'exec';
+    seq: number;
+    pid: number;
+    ppid: number;
+    pgid: number;
+    argv: string[];
+    exe?: string;
+    uid: number;
+    at: number;
+    replaced?: true;
+}
+export interface TraceFork {
+    type: 'fork';
+    seq: number;
+    pid: number;
+    ppid: number;
+    pgid: number;
+    argv: string[];
+    exe?: string;
+    uid: number;
+    at: number;
+}
+export interface TraceExit {
+    type: 'exit';
+    seq: number;
+    pid: number;
+    status: number;
+    signal?: string;
+    utime?: number;
+    stime?: number;
+    at: number;
+}
+export type TraceEvent = TraceExec | TraceFork | TraceExit;
+type Unsequenced<T> = T extends unknown ? Omit<T, 'seq'> : never;
+export type TraceDraft = Unsequenced<TraceEvent>;
+export interface TraceBatch {
+    events: TraceEvent[];
+    dropped: number;
+}
+export declare const TRACE_LIMIT = 4096;
+export declare const TRACE_LIMIT_MAX = 65536;
+export declare function traceLimit(value: unknown): number;
+export interface TraceSubscription {
+    ack(): void;
+    close(): void;
+}
+export declare class TraceHub {
+    private readonly subs;
+    private seq;
+    get idle(): boolean;
+    subscribe(tag: string, viewer: Readonly<Cred>, deliver: (batch: TraceBatch) => void, limit?: number): TraceSubscription;
+    wants(tags: readonly string[] | undefined, cred: Readonly<Cred>): boolean;
+    publish(tags: readonly string[] | undefined, cred: Readonly<Cred>, draft: TraceDraft): void;
+    private matches;
+    private schedule;
+}
+export {};

package/dist/types/launcher.d.ts

@@ -31,6 +31,7 @@ import { type ProcessInfo } from './kernel/proc-info.js';
 import { type SealedCaller, type SealedHook } from './kernel/sealed.js';
 import { type SigInfo } from './kernel/signals.js';
 import { LoopbackNet } from './kernel/socket.js';
+import { TraceHub } from './kernel/trace.js';
 import { type MediumHandle } from './mount/fsa.js';
 import { type FstabResult } from './mount/fstab.js';
 import { type FetchLike, type HostfsGrantHook, type HostfsTiming } from './mount/hostfs.js';
@@ -116,9 +117,11 @@ export interface RunOptions {
     tagBase?: number;
     login?: boolean;
     session?: number;
+    cwdMissing?: CwdMissing;
 }
 export interface TerminalOptions {
     cwd?: string;
+    cwdMissing?: CwdMissing;
     env?: Record<string, string>;
     cols?: number;
     rows?: number;
@@ -162,6 +165,8 @@ interface Target {
     shim?: string;
 }
 export declare function tagOption(tag: unknown): void;
+export type CwdMissing = 'create' | 'error';
+export declare function cwdMissingOption(value: unknown): CwdMissing;
 export declare function withTag(tags: readonly string[] | undefined, tag: string | undefined): readonly string[] | undefined;
 export declare function cronPath(path: string): boolean;
 export declare function expandDefaults(defaults: Readonly<Record<string, string>> | undefined, env: Readonly<Record<string, string>>): Record<string, string>;
@@ -393,6 +398,14 @@ export declare class Launcher {
     private readonly imageTimes;
     private readonly childTimes;
     private readonly stopped;
+    readonly traces: TraceHub;
+    private readonly traceHeld;
+    private readonly replacedImages;
+    private traceStarted;
+    private traceEnded;
+    private traceEmit;
+    private traceAdmitted;
+    private chainTimes;
     private stateOf;
     private childrenOf;
     private timesAt;

package/dist/types/node.d.ts

@@ -20,11 +20,11 @@ import { memoryRoot } from './node/memory-root.js';
 import type { ApproveHook } from './sudo.js';
 import { type NetworkTransport } from './transport.js';
 export type { CdpConnection, CdpHook, CdpRequest } from './cdp/types.js';
-export { type AttachOptions, attachKernel, type ClientEnded, type ClientFetchRequest, type ClientFs, type ClientRunOptions, type ClientRunResult, type ClientTerminal, type ClientTerminalOptions, KernelCallError, type KernelClient, KernelGoneError, type ProcessEntry, type SpawnedProcess, type SpawnOptions, type WatchChange, } from './client/attach.js';
+export { type AttachOptions, attachKernel, type ClientEnded, type ClientFetchRequest, type ClientFs, type ClientRunOptions, type ClientRunResult, type ClientTerminal, type ClientTerminalOptions, KernelCallError, type KernelClient, KernelGoneError, type ProcessEntry, type SpawnedProcess, type SpawnOptions, type TraceBatch, type TraceEvent, type TraceExec, type TraceExit, type TraceFork, type TraceOptions, type WatchChange, } from './client/attach.js';
 export type { FacadeConnection, FacadeHook, FacadeInfo, FacadeSpec, FacadeSpecs, } from './facade/types.js';
 export type { Attestation, AttestedDir, AttestOptions, AttestTombstone } from './fs/attest.js';
 export type { Denial, DenialHook } from './fs/dac.js';
-export type { ConnectOptions, Ended, KernelGroups, KernelIntegrity, KernelSealed, KernelUsers, NetworkUplink, ResolveAnswer, ResolveFamily, RouteTable, RunOptions, RunResult, Terminal, TerminalOptions, TerminalSignal, } from './index.js';
+export type { ConnectOptions, CwdMissing, Ended, KernelGroups, KernelIntegrity, KernelSealed, KernelUsers, NetworkUplink, ResolveAnswer, ResolveFamily, RouteTable, RunOptions, RunResult, Terminal, TerminalOptions, TerminalSignal, } from './index.js';
 export type { ClipboardHook, ClipboardStamp } from './kernel/clipboard.js';
 export type { EmbedderHook, EmbedderKindPolicy, EmbedderReply, EmbedderRequest, EmbedderStamp, } from './kernel/embedder.js';
 export { SEALED_FETCH_VERSION, type SealedFetchHook, type SealedFetchRequest, type SealedOption, } from './kernel/net/sealed-fetch.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-kernel",
-  "version": "1.178.4",
+  "version": "1.180.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",
@@ -70,7 +70,7 @@
   },
   "devDependencies": {
     "@ai-ecoverse/py-numpy": "2.5.4-4",
-    "@ai-ecoverse/slicc-cdp": "1.47.5",
+    "@ai-ecoverse/slicc-cdp": "1.48.10",
     "@ai-ecoverse/slicc-scrub": "1.1.0",
     "@ai-ecoverse/slicc-shared-web": "2.14.2",
     "@ai-ecoverse/wasi-cargo": "0.99.0-6",