@ai-ecoverse/slicc-kernel 1.172.1 → 1.173.0

package/dist/types/fs/meta-reads.d.ts

@@ -0,0 +1,41 @@
+import type { MetaEntry } from './meta.js';
+export interface Invalidated {
+    paths?: readonly string[];
+    trees?: readonly string[];
+}
+export declare class Invalidations {
+    private seq;
+    private readonly log;
+    private readonly open;
+    start(): number;
+    end(at: number): void;
+    note({ paths, trees }: Invalidated): void;
+    private since;
+    entryStale(at: number, path: string): boolean;
+    listingStale(at: number, dir: string): boolean;
+}
+export type MetaReadKind = 'entry' | 'links';
+export interface ReadBatch {
+    entries: readonly string[];
+    links: readonly string[];
+}
+export interface ReadResult {
+    entries: Map<string, MetaEntry | null>;
+    links: Map<string, MetaEntry[]>;
+}
+export declare const META_READS_IN_FLIGHT = 4;
+export declare class BatchedReads {
+    private readonly run;
+    private readonly invalidations;
+    private readonly keep;
+    private readonly queued;
+    private readonly reading;
+    private inFlight;
+    constructor(invalidations: Invalidations, run: (batch: ReadBatch) => Promise<ReadResult>, keep: (kind: MetaReadKind, key: string, value: unknown) => void);
+    entries(paths: readonly string[]): Promise<Map<string, MetaEntry | null>>;
+    links(dir: string): Promise<MetaEntry[]>;
+    private stale;
+    private want;
+    private pump;
+    private flush;
+}

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

@@ -51,6 +51,11 @@ export interface MetaStore {
     absent?(path: string): boolean;
     removeFile?(path: string): Promise<void>;
     forgetTrees?(trees: readonly string[]): void;
+    transactions?(): MetaTransactions;
+}
+export interface MetaTransactions {
+    reads: number;
+    writes: number;
 }
 export declare const META_DB = "slicc-kernel";
 export declare const META_VERSION = 1;
@@ -79,14 +84,20 @@ interface Invalidation {
 export declare class IndexedDbMeta implements MetaStore {
     private readonly db;
     private readonly cache;
+    private readonly listings;
     private readonly channel;
-    private generation;
+    private readonly invalidations;
+    private readonly reads;
     private readonly listeners;
     listen(listener: (change: Invalidation) => void): void;
     constructor(db: IDBDatabase);
     forgetTrees(trees: readonly string[]): void;
     private drop;
+    private keepListing;
+    private read;
     private changed;
+    private readonly counted;
+    transactions(): MetaTransactions;
     private transaction;
     get(paths: readonly string[]): Promise<Array<MetaEntry | undefined>>;
     fresh(paths: readonly string[]): Promise<Array<MetaEntry | undefined>>;

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

@@ -1,4 +1,4 @@
-import { type MetaStore } from './meta.js';
+import { type MetaStore, type MetaTransactions } from './meta.js';
 import { type KeepHandlers, type LockManagerLike, type RemoteListener } from './remote.js';
 import { type CopyOptions, type FsStat, type KernelFs, type NewOwner, type OwnerChange, type PeerKeeps, type Peers, type Perm, type PwriteOptions } from './types.js';
 export type OpfsOp = 'lookup' | 'read' | 'write' | 'commit' | 'sidecar';
@@ -101,6 +101,7 @@ export declare class OpfsFs implements KernelFs {
     private idWrites;
     fileIdWrites(): number;
     opfsOps(): number;
+    metaTransactions(): MetaTransactions | undefined;
     private io;
     private fresh;
     private exactly;

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

@@ -0,0 +1,11 @@
+export type Portable<T extends FileSystemHandle> = {
+    handle: T;
+} | {
+    path: string[];
+};
+type Top = () => Promise<FileSystemDirectoryHandle>;
+export declare function clonable(handle: FileSystemHandle): boolean;
+export declare function portable<T extends FileSystemHandle>(handle: T, top?: Top): Promise<Portable<T>>;
+export declare function directoryAt(top: FileSystemDirectoryHandle, path: readonly string[]): Promise<FileSystemDirectoryHandle>;
+export declare const samePath: (a: readonly string[], b: readonly string[]) => boolean;
+export {};

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

@@ -1,3 +1,3 @@
 export declare const nameOf: (id: string) => string;
-export declare function rootId(factory: IDBFactory, root: FileSystemDirectoryHandle, locks?: LockManager | undefined): Promise<string>;
+export declare function rootId(factory: IDBFactory, root: FileSystemDirectoryHandle, locks?: LockManager | undefined, top?: () => Promise<FileSystemDirectoryHandle>): Promise<string>;
 export declare function metadataName(top: FileSystemDirectoryHandle | undefined, root: FileSystemDirectoryHandle, id: (root: FileSystemDirectoryHandle) => Promise<string>): Promise<string>;

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

@@ -137,6 +137,10 @@ export interface KernelFs {
         ackMs: readonly number[];
     };
     opfsOps?(): number;
+    metaTransactions?(): {
+        reads: number;
+        writes: number;
+    } | undefined;
     fileIdWrites?(): number;
     announceHolds?(add: ReadonlyArray<[string, string | undefined]>, drop: readonly string[], wait: boolean): Promise<void>;
     holdCounts?(): {

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

@@ -35,6 +35,7 @@ interface Typed {
 export declare const WATCH_NOTES_LIMIT = 1000;
 export interface WatchOptions {
     recursive?: boolean;
+    peers?: boolean;
 }
 export declare const WATCH_BATCH_LIMIT = 1000;
 export declare class FsWatchers {
@@ -55,7 +56,9 @@ export declare class FsWatchers {
     private renamed;
     heard(type: WatchEventType, paths: readonly string[]): void;
     changed(...paths: string[]): void;
+    peerChanged(paths: readonly string[]): void;
     private report;
+    private notify;
     private flush;
     wrap(fs: KernelFs): KernelFs;
 }

package/dist/types/kernel/proc-info.d.ts

@@ -53,6 +53,10 @@ export interface ProcessListing {
     fsCalls?: number;
     opfsCalls?: number;
     opfsOps?: number;
+    meta?: {
+        reads: number;
+        writes: number;
+    } | undefined;
     cwdChecks?: number;
     staleFds?: number;
     fileIds?: number;

package/dist/types/mount/media.d.ts

@@ -5,4 +5,6 @@ export interface MediaStore {
 }
 export declare const MEDIA_STORE = "handles";
 export declare function memoryMedia(): MediaStore;
-export declare function openMedia(name: string, factory: IDBFactory): Promise<MediaStore>;
+type Top = () => Promise<FileSystemDirectoryHandle>;
+export declare function openMedia(name: string, factory: IDBFactory, top?: Top): Promise<MediaStore>;
+export {};

package/dist/types/serve.d.ts

@@ -1,6 +1,7 @@
 import { type LockManagerLike } from './client/protocol.js';
 import type { AttestOptions } from './fs/attest.js';
 import { type MetaStore } from './fs/meta.js';
+import { type Portable } from './fs/portable.js';
 import { type ProtectInit } from './fs/protect.js';
 import { type UsersMode } from './fs/types.js';
 import type { EmbedderKindPolicy } from './kernel/embedder.js';
@@ -8,7 +9,7 @@ import type { WasmWorkerLike } from './kernel/host.js';
 import type { RouteTable } from './kernel/net/routes.js';
 import type { RealmTransportTraits } from './kernel/net/transport.js';
 import { type UplinkTraits } from './kernel/net/uplink.js';
-import { type ModuleUrlMaker, type RunOptions, type TerminalOptions } from './launcher.js';
+import { type ModuleUrlMaker, type PendingMedium, type RunOptions, type TerminalOptions } from './launcher.js';
 import type { MediumHandle } from './mount/fsa.js';
 import type { HostfsGrant, HostfsPortGrant } from './mount/hostfs.js';
 import type { MediaStore } from './mount/media.js';
@@ -22,6 +23,7 @@ export interface InitRequest {
     id: number;
     op: 'init';
     root?: FileSystemDirectoryHandle;
+    rootPath?: string[];
     modules?: string;
     commands?: {
         append?: readonly string[];
@@ -133,13 +135,12 @@ export type MountRequest = {
 } | {
     id: number;
     op: 'mounts';
-} | {
+} | ({
     id: number;
     op: 'insert';
     target: string;
     source?: string;
-    handle: MediumHandle;
-};
+} & Portable<MediumHandle>);
 export interface DialRequest {
     id: number;
     op: 'dial';
@@ -183,6 +184,7 @@ export type KernelRequest = {
 type WithoutId<T> = T extends unknown ? Omit<T, 'id'> : never;
 export type KernelCall = WithoutId<KernelRequest>;
 export declare function inOpfs(deps: ServeDeps, root: FileSystemDirectoryHandle): Promise<boolean>;
+export declare function crossable(medium: PendingMedium): PendingMedium;
 export interface ServeDeps {
     rootId?: (root: FileSystemDirectoryHandle) => Promise<string>;
     storage: () => Promise<FileSystemDirectoryHandle>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-ecoverse/slicc-kernel",
-  "version": "1.172.1",
+  "version": "1.173.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,9 +70,9 @@
   },
   "devDependencies": {
     "@ai-ecoverse/py-numpy": "2.5.4-4",
-    "@ai-ecoverse/slicc-cdp": "1.43.1",
+    "@ai-ecoverse/slicc-cdp": "1.44.3",
     "@ai-ecoverse/slicc-scrub": "1.1.0",
-    "@ai-ecoverse/slicc-shared-web": "2.13.7",
+    "@ai-ecoverse/slicc-shared-web": "2.13.10",
     "@ai-ecoverse/wasi-cargo": "0.99.0-6",
     "@ai-ecoverse/wasi-pnpm": "12.9.1-21",
     "@ai-ecoverse/wasi-ripgrep": "15.2.0-5",
@@ -95,7 +95,7 @@
     "esbuild": "0.28.2",
     "fake-indexeddb": "6.2.6",
     "lefthook": "2.2.2",
-    "monocart-coverage-reports": "2.13.2",
+    "monocart-coverage-reports": "3.1.0",
     "pg-gateway": "0.3.0-beta.4",
     "semantic-release": "25.0.9",
     "typescript": "7.0.2",