@nimbus-sh/core 0.3.0 → 0.4.0

package/dist/runtime/facet-host.d.ts

@@ -75,6 +75,18 @@ export interface FacetSpec {
     syscalls?: FacetSyscalls;
     /** Facets the host may keep warm for this spec. Default 1. */
     concurrency?: number;
+    /**
+     * Who a warm facet may be reused FOR. Default `session`.
+     *
+     * A scope keeps whatever the last call left in it, so by default it may only
+     * ever answer for the session that opened it. `global` is a claim the
+     * RUNTIME makes about itself and one only a pure function can make: no
+     * syscalls binding, nothing retained between calls, output decided entirely
+     * by the arguments. The clang toolchain is that — a compile is the same
+     * compile for every tenant — and one warm isolate holding its 31 MiB of
+     * compiled compiler serves all of them.
+     */
+    reuse?: 'session' | 'global';
 }
 /** The session a facet's syscalls reach, and who they reach it as. */
 export interface FacetSyscalls {

package/dist/runtime/facet-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facet-host.d.ts","sourceRoot":"","sources":["../../src/runtime/facet-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEjF,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,iEAAiE;IACjE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B;;;;;;OAMG;IACH,cAAc,CACZ,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,sBAAsB,GAC/B,mBAAmB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC;CAC9B"}
+{"version":3,"file":"facet-host.d.ts","sourceRoot":"","sources":["../../src/runtime/facet-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEjF,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;OAUG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,iEAAiE;IACjE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B;;;;;;OAMG;IACH,cAAc,CACZ,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,sBAAsB,GAC/B,mBAAmB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC;CAC9B"}

package/dist/runtime/local-facet-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-facet-host.d.ts","sourceRoot":"","sources":["../../src/runtime/local-facet-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAMV,SAAS,EAGV,MAAM,iBAAiB,CAAC;AAuDzB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,IAAI,SAAS,CAwB1C"}
+{"version":3,"file":"local-facet-host.d.ts","sourceRoot":"","sources":["../../src/runtime/local-facet-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAMV,SAAS,EAGV,MAAM,iBAAiB,CAAC;AAuDzB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,IAAI,SAAS,CAiC1C"}

package/dist/runtime/local-facet-host.js

@@ -85,12 +85,22 @@ export function localFacetHost() {
          * thousands of startup probes for absent paths from each trying to suspend.
          */
         seedFilesystem(vfs, root, options) {
-            return snapshotVfs(vfs, root, {
+            const seeded = snapshotVfs(vfs, root, {
                 extraRoots: options?.extraRoots,
                 skipSubdirs: [],
                 maxBytes: LOCAL_SEED_MAX_BYTES,
                 maxFiles: LOCAL_SEED_MAX_FILES,
             });
+            if ('error' in seeded)
+                return seeded;
+            // The seed is also the WHOLE of what this guest has, which is a stronger
+            // claim than the walk's: `snapshotVfs` reports the roots it listed
+            // exhaustively, and this says every path outside them is absent too. It
+            // is — a miss out there could only be answered by suspending the guest
+            // mid-syscall, which this host cannot do, so the alternative to "absent"
+            // is not "fetched" but a read the guest can never receive. Ruby's VM
+            // startup stats dozens of prefixes it was never given.
+            return { ...seeded, snapshot: { ...seeded.snapshot, enumeratedRoots: [''] } };
         },
         open: (spec) => new LocalFacet(spec),
     };
@@ -122,8 +132,7 @@ class LocalFacet {
     async call(fn, args, options) {
         if (this.disposed)
             throw new Error(`Nimbus: facet '${this.spec.tag}' is disposed`);
-        const scope = await this.scope();
-        await this.addModules(options?.wasmModules);
+        const scope = await this.scope(options?.wasmModules);
         let scoped = this.scoped.get(fn);
         if (!scoped) {
             const value = scope(`(${fn.toString()})`);
@@ -141,15 +150,26 @@ class LocalFacet {
      * The returned closure's `eval` is a DIRECT eval inside the body the preamble
      * was evaluated in, which is what puts the preamble's top-level declarations
      * in scope for every function submitted afterwards.
+     *
+     * Both wasm tables are filled BEFORE that body runs, per-call images merged
+     * over the spec's. A preamble may boot its runtime as it is evaluated — Ruby
+     * instantiates the interpreter right there — so it reads the table at that
+     * moment and an image added afterwards would arrive to a facet that had
+     * already given up on it. workerd has the same ordering for the same reason:
+     * per-call images ride in the module map the inner worker is built from.
      */
-    async scope() {
-        if (this.evaluate)
-            return this.evaluate;
-        await this.addModules(this.spec.wasmModules);
+    async scope(callModules) {
+        const built = this.evaluate;
+        if (!built)
+            await this.addModules(this.spec.wasmModules);
+        await this.addModules(callModules);
+        if (built)
+            return built;
         const globals = { __NIMBUS_WASM: this.wasmTable };
         const build = new AsyncFunction('globalThis', `${this.spec.preamble ?? ''}\nreturn (source) => eval(source);`);
-        this.evaluate = await build.call(globals, globals);
-        return this.evaluate;
+        const evaluate = await build.call(globals, globals);
+        this.evaluate = evaluate;
+        return evaluate;
     }
     async addModules(modules) {
         for (const [name, bytes] of Object.entries(modules ?? {})) {

package/dist/runtime/ruby-gems.d.ts

@@ -0,0 +1,30 @@
+import type { CredentialedVfs } from '../vfs/sqlite-vfs.js';
+export interface RubyGemRequest {
+    name: string;
+    requirements: string[];
+}
+export interface RubyGemInstallReport {
+    installed: string[];
+    alreadyInstalled: string[];
+}
+export interface InstalledRubyGemBin {
+    name: string;
+    path: string;
+}
+export declare function defaultGemHome(): string;
+export declare function installedGemLibRoots(vfs: CredentialedVfs, gemHome?: string): string[];
+export declare function installedGemBins(vfs: CredentialedVfs, gemHome?: string): InstalledRubyGemBin[];
+export declare function installRubyGems(vfs: CredentialedVfs, requests: RubyGemRequest[], opts?: {
+    gemHome?: string;
+    includeDependencies?: boolean;
+}): Promise<RubyGemInstallReport>;
+export declare function installRubyBundle(vfs: CredentialedVfs, cwd: string, opts?: {
+    gemHome?: string;
+}): Promise<{
+    requests: RubyGemRequest[];
+    report: RubyGemInstallReport;
+    lockfilePath: string;
+}>;
+export declare function parseGemfile(text: string): RubyGemRequest[];
+export declare function parseRubyGemRequirements(input: string | undefined): string[];
+//# sourceMappingURL=ruby-gems.d.ts.map

package/dist/runtime/ruby-gems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruby-gems.d.ts","sourceRoot":"","sources":["../../src/runtime/ruby-gems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAO5D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AA4BD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,SAAmB,GAAG,MAAM,EAAE,CAU/F;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,SAAmB,GAAG,mBAAmB,EAAE,CAOxG;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,cAAc,EAAE,EAC1B,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7D,OAAO,CAAC,oBAAoB,CAAC,CAqB/B;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9B,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAkC7F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAS3D;AAmZD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAM5E"}