@nimbus-sh/worker 0.1.3 → 0.1.5

package/dist/runtime/python-runner.js

@@ -41,6 +41,7 @@ export function makePythonRunnerFactory(deps) {
         const asmWasmVfs = findFile('share/pyodide/pyodide.asm.wasm');
         const asmJsVfs = findFile('share/pyodide/pyodide.asm.js');
         const stdlibVfs = findFile('share/pyodide/python_stdlib.zip');
+        let runtimePromise = null;
         return async function pythonBinHandler(ctx) {
             const argv = ctx.args || [];
             const cwd = ctx.cwd || '/home/user';
@@ -69,9 +70,6 @@ export function makePythonRunnerFactory(deps) {
                 ctx.stderr.write(`${binName}: python_stdlib.zip missing\n`);
                 return 127;
             }
-            const asmWasmBytes = vfs.readFile(asmWasmVfs);
-            const asmJsBytes = vfs.readFile(asmJsVfs);
-            const stdlibBytes = vfs.readFile(stdlibVfs);
             // ── Parse argv ───────────────────────────────────────────────
             // Supported in v1:
             //   python -c '<code>'           run inline code, args[i+1..] in sys.argv
@@ -133,10 +131,24 @@ export function makePythonRunnerFactory(deps) {
             if (!userEnv.PYTHONUNBUFFERED)
                 userEnv.PYTHONUNBUFFERED = '1';
             // ── Dispatch the facet ───────────────────────────────────────
-            const result = await dispatchPythonFacet(facetMgr, {
-                asmWasmBytes,
-                asmJsBytes,
-                stdlibBytes,
+            let runtime;
+            try {
+                if (!runtimePromise) {
+                    runtimePromise = createPythonFacetRuntime(facetMgr, {
+                        asmWasmVfs,
+                        asmJsVfs,
+                        stdlibVfs,
+                        vfs,
+                    });
+                }
+                runtime = await runtimePromise;
+            }
+            catch (e) {
+                runtimePromise = null;
+                ctx.stderr.write(`${binName}: python runtime warm-up failed: ${e?.message || e}\n`);
+                return 1;
+            }
+            const result = await dispatchPythonFacet(runtime, {
                 userCode,
                 pyArgv,
                 userEnv,
@@ -234,70 +246,7 @@ function uint8ToBase64(u8) {
     }
     return btoa(s);
 }
-async function dispatchPythonFacet(facetMgr, args) {
-    const toAB = (u8) => u8.buffer.slice(u8.byteOffset, u8.byteOffset + u8.byteLength);
-    // pyodide.asm.js is INLINED into the preamble (1 MiB text source).
-    // Workerd's CSP allows wasm code-gen AND JS top-level evaluation at
-    // module-load time, but BLOCKS `new Function(src)` at request time.
-    // The asm.js source declares `var _createPyodideModule = ...` at
-    // module-top; spliced into the preamble it becomes a module-scope
-    // binding we expose via `globalThis._createPyodideModule = ...`
-    // right after.
-    //
-    // stdlib.zip stays in the context (base64) — it's data not code,
-    // and the context blob is evaluated at module-load too.
-    let asmJsSrc = new TextDecoder('utf-8').decode(args.asmJsBytes);
-    // ── Source-patch the asm.js's "Cannot determine runtime environment" branch ──
-    //
-    // Even with our globalThis.process / WorkerGlobalScope / self / location
-    // shims in place, the asm.js's pyodide_js_init() IIFE's env-detect (via
-    // bn → vn) somehow lands d.IN_BROWSER_WEB_WORKER = false at request time
-    // on workerd. Our supervisor-side mirror of the same logic returns
-    // IN_BROWSER_WEB_WORKER = true with the same shims; the discrepancy
-    // remains unidentified after P8-P17 of diagnostic instrumentation.
-    //
-    // Pragmatic v1 fix: source-patch the if-chain to ALWAYS take the
-    // IN_BROWSER_WEB_WORKER branch (regardless of `d`). The branch's body
-    // assigns `Fe` to a globalThis.importScripts-based loadScript helper.
-    // We don't actually call Fe (Pyodide only invokes loadScript when
-    // dynamic-loading a wasm sibling; our instantiateWasm override pre-
-    // empts that). So the patch is functionally a no-op other than making
-    // the throw unreachable.
-    //
-    // The patch target string is a literal in the minified asm.js — stable
-    // across rebuilds because it's a unique identifier path.
-    const PATCH_NEEDLE = 'else throw new Error("Cannot determine runtime environment")';
-    const PATCH_REPLACE = '/* nimbus-patch: was: ' + PATCH_NEEDLE + ' */';
-    if (asmJsSrc.includes(PATCH_NEEDLE)) {
-        asmJsSrc = asmJsSrc.replace(PATCH_NEEDLE, PATCH_REPLACE);
-    }
-    // Also patch the if-chain head so we ALWAYS set Fe (force-take the
-    // first branch — IN_BROWSER_MAIN_THREAD's loadScript path uses
-    // `await import(t)` which works in workerd at module-load time).
-    // The previous patch alone is insufficient because if NO branch matches,
-    // Fe stays undefined → calling it would TypeError later.
-    const HEAD_NEEDLE = 'if(d.IN_BROWSER_MAIN_THREAD)';
-    const HEAD_REPLACE = 'if(true||d.IN_BROWSER_MAIN_THREAD)';
-    if (asmJsSrc.includes(HEAD_NEEDLE)) {
-        asmJsSrc = asmJsSrc.replace(HEAD_NEEDLE, HEAD_REPLACE);
-    }
-    const stdlibB64 = uint8ToBase64(args.stdlibBytes);
-    // Build the preamble with stdlib bytes spliced in. The preamble runs
-    // the entire Pyodide bootstrap at child-facet module-init time —
-    // where workerd's CSP permits `new WebAssembly.Module(rawBytes)` (the
-    // convertJsFunctionToWasm code path which is the v1 hang root).
-    // Per-call __pyodideRun just executes runPython on the cached
-    // Pyodide instance.
-    const preamble = buildPyodidePreamble(asmJsSrc, stdlibB64);
-    const { NimbusLoaderPool } = await import('../loaders/loader-pool.js');
-    const env = facetMgr.env;
-    const ctx = facetMgr.ctx;
-    const pool = new NimbusLoaderPool(env, ctx, {
-        tag: 'python-runner',
-        concurrency: 1,
-        omitSupervisor: true,
-        preamble,
-    });
+async function dispatchPythonFacet(runtime, args) {
     // v2 simplification: stdlibB64 and asmWasmMod are now embedded in the
     // preamble (stdlib via base64 splice; wasm via __NIMBUS_WASM table set
     // by the loader-pool). The facet fn only needs the per-call inputs.
@@ -315,15 +264,12 @@ async function dispatchPythonFacet(facetMgr, args) {
         });
     };
     try {
-        const result = await pool.submit(facetFn, {
+        const result = await runtime.pool.submit(facetFn, {
             userCode: args.userCode,
             pyArgv: args.pyArgv,
             userEnv: args.userEnv,
             progName: args.progName,
         }, {
-            wasmModules: {
-                'pyodide.asm.wasm': toAB(args.asmWasmBytes),
-            },
             timeoutMs: 300_000,
         });
         return {
@@ -342,6 +288,40 @@ async function dispatchPythonFacet(facetMgr, args) {
         };
     }
 }
+async function createPythonFacetRuntime(facetMgr, args) {
+    const toAB = (u8) => u8.buffer.slice(u8.byteOffset, u8.byteOffset + u8.byteLength);
+    if (!args.asmWasmVfs || !args.asmJsVfs || !args.stdlibVfs) {
+        throw new Error('installed Pyodide manifest is missing required files');
+    }
+    const asmWasmBytes = args.vfs.readFile(args.asmWasmVfs);
+    const asmJsBytes = args.vfs.readFile(args.asmJsVfs);
+    const stdlibBytes = args.vfs.readFile(args.stdlibVfs);
+    let asmJsSrc = new TextDecoder('utf-8').decode(asmJsBytes);
+    const PATCH_NEEDLE = 'else throw new Error("Cannot determine runtime environment")';
+    const PATCH_REPLACE = '/* nimbus-patch: was: ' + PATCH_NEEDLE + ' */';
+    if (asmJsSrc.includes(PATCH_NEEDLE)) {
+        asmJsSrc = asmJsSrc.replace(PATCH_NEEDLE, PATCH_REPLACE);
+    }
+    const HEAD_NEEDLE = 'if(d.IN_BROWSER_MAIN_THREAD)';
+    const HEAD_REPLACE = 'if(true||d.IN_BROWSER_MAIN_THREAD)';
+    if (asmJsSrc.includes(HEAD_NEEDLE)) {
+        asmJsSrc = asmJsSrc.replace(HEAD_NEEDLE, HEAD_REPLACE);
+    }
+    const preamble = buildPyodidePreamble(asmJsSrc, uint8ToBase64(stdlibBytes));
+    const { NimbusLoaderPool } = await import('../loaders/loader-pool.js');
+    const env = facetMgr.env;
+    const ctx = facetMgr.ctx;
+    const pool = new NimbusLoaderPool(env, ctx, {
+        tag: 'python-runner',
+        concurrency: 1,
+        omitSupervisor: true,
+        preamble,
+        wasmModules: {
+            'pyodide.asm.wasm': toAB(asmWasmBytes),
+        },
+    });
+    return { pool };
+}
 /**
  * Compose the per-call preamble by splicing the pyodide.asm.js source
  * verbatim ahead of the __pyodideRun helper. Workerd compiles this
@@ -805,15 +785,34 @@ globalThis.__pyodideRun = async function __pyodideRun(args) {
   // overwrite sys.argv at request time via a tiny runPython prelude.
   // pyArgv is the user-visible argv (script name first, then args);
   // progName is the executable that prefixes errors.
+  const argv = [args.progName].concat((args.pyArgv || []).slice(0));
+  // If pyArgv already includes the script as [0], use it directly.
+  // Convention from the python-runner caller: pyArgv = [progName,
+  // ...args]. We set sys.argv = pyArgv with [0] = progName.
+  const effectiveArgv = (args.pyArgv && args.pyArgv.length > 0) ? args.pyArgv : argv;
+
+  let userGlobals = null;
+  try {
+    const dictCtor = pyodide.globals?.get?.('dict');
+    userGlobals = typeof dictCtor === 'function' ? dictCtor() : null;
+    if (userGlobals && typeof userGlobals.set === 'function') {
+      userGlobals.set('__name__', '__main__');
+      userGlobals.set('__package__', null);
+      const argv0 = effectiveArgv[0];
+      if (argv0 && argv0 !== '-c' && argv0 !== '-') {
+        userGlobals.set('__file__', argv0);
+      }
+    }
+    try { dictCtor?.destroy?.(); } catch {}
+  } catch {
+    userGlobals = null;
+  }
+
   try {
-    const argv = [args.progName].concat((args.pyArgv || []).slice(0));
-    // If pyArgv already includes the script as [0], use it directly.
-    // Convention from the python-runner caller: pyArgv = [progName,
-    // ...args]. We set sys.argv = pyArgv with [0] = progName.
-    const effectiveArgv = (args.pyArgv && args.pyArgv.length > 0) ? args.pyArgv : argv;
     pyodide.runPython(
       'import sys\\nsys.argv = ' +
-      JSON.stringify(effectiveArgv)
+      JSON.stringify(effectiveArgv),
+      userGlobals ? { globals: userGlobals } : undefined
     );
   } catch { /* best-effort */ }
 
@@ -824,7 +823,10 @@ globalThis.__pyodideRun = async function __pyodideRun(args) {
   let exitCode = 0;
   if (args.userCode) {
     try {
-      pyodide.runPython(args.userCode);
+      pyodide.runPython(
+        args.userCode,
+        userGlobals ? { globals: userGlobals } : undefined
+      );
       // If runPython returned normally, exit code is 0 unless onExit
       // was invoked (which can happen if user called sys.exit but
       // Pyodide handled it via ExitStatus before throwing).
@@ -856,6 +858,8 @@ globalThis.__pyodideRun = async function __pyodideRun(args) {
     }
   }
 
+  try { userGlobals?.destroy?.(); } catch {}
+
   return {
     exitCode: exitCode,
     stdout: globalThis.__nimbusPyStdout.slice(stdoutStart).join(''),

package/dist/session/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/session/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA8DH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;GAQG;AACH,KAAK,QAAQ,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC;AAG3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CA+7G/D"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/session/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA+DH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;GAQG;AACH,KAAK,QAAQ,GAAG,eAAe,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC;AAG3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CAu+G/D"}

package/dist/session/init.js

@@ -42,7 +42,7 @@ import { filterWranglerFlags, detectBundlerBin, checkNodeModulesGuard, detectUns
 import { HeredocHandler, LineEditorExtender, FdRedirectNormalizer, SubshellNormalizer, BraceExpander, DollarVarShim, BacktickNormalizer } from '../shell/features.js';
 import { registerUnixCommands } from '../shell/unix-commands.js';
 import { registerGitCommands } from '../git/commands.js';
-import { makeNimbusVerbHandler, rehydrateInstalledRuntimes, registerRunnerFactory, } from '../runtime/package-manager.js';
+import { makeNimbusVerbHandler, createRuntimeCommandHintResolver, rehydrateInstalledRuntimes, registerRunnerFactory, } from '../runtime/package-manager.js';
 import { makeClangRunnerFactory } from '../runtime/clang-runner.js';
 import { makePythonRunnerFactory } from '../runtime/python-runner.js';
 import { makeRubyRunnerFactory } from '../runtime/ruby-runner.js';
@@ -531,6 +531,35 @@ export function initSession(self, ws) {
             vfs: sqliteFs,
             registry: pkgRegistry,
             getHome: nimbusGetHome,
+            warmRuntime: async (target, ctx) => {
+                if (target.name !== 'python')
+                    return;
+                ctx.stdout.write('[python] warming runtime...\n');
+                const stdout = { write(_s) { } };
+                const stderrText = [];
+                const stderr = { write: (s) => { stderrText.push(String(s)); } };
+                const py = await registry.resolve('python');
+                if (py) {
+                    const code = await py({
+                        ...ctx,
+                        args: ['-c', 'pass'],
+                        vfs: ctx.vfs ?? sqliteFs,
+                        signal: new AbortController().signal,
+                        stdout,
+                        stderr,
+                    });
+                    if (typeof code === 'number' && code !== 0) {
+                        throw new Error(stderrText.join('').trim() || `python warm-up exited ${code}`);
+                    }
+                }
+                const { warmPythonRepl } = await import('../runtime/python-repl.js');
+                await warmPythonRepl({
+                    facetMgr,
+                    vfs: sqliteFs,
+                    installRoot: target.root,
+                });
+                ctx.stdout.write('[python] ready\n');
+            },
         }));
         // Rehydration runs here even though the shell hasn't been built
         // yet — that's fine: it accesses VFS + registry which are both
@@ -2466,6 +2495,7 @@ export function initSession(self, ws) {
         return false;
     }
     const upstreamResolve = registry.resolve.bind(registry);
+    const runtimeCommandHint = createRuntimeCommandHintResolver(self.env);
     registry.resolve = async function nimbusBinFallbackResolve(name) {
         const upstream = await upstreamResolve(name);
         if (upstream)
@@ -2483,8 +2513,24 @@ export function initSession(self, ws) {
         // built yet (very early init), fall back to /home/user.
         const cwd = (self.shell?.cwd || '/home/user').replace(/^\/+/, '');
         const binShimPath = cwd + '/node_modules/.bin/' + name;
-        if (!sqliteFs.exists(binShimPath))
-            return undefined;
+        if (!sqliteFs.exists(binShimPath)) {
+            let hint = null;
+            try {
+                hint = await runtimeCommandHint(name);
+            }
+            catch {
+                hint = null;
+            }
+            if (!hint)
+                return undefined;
+            const hintHandler = async (ctx) => {
+                ctx.stderr.write(`${name}: command not found\n`);
+                ctx.stderr.write(`hint: install it with: nimbus install ${hint.installSpec}\n`);
+                return 127;
+            };
+            hintHandler.__nimbusRuntimeInstallHint = true;
+            return hintHandler;
+        }
         // Synthesised handler. Each resolve call recomputes (cwd can
         // change between invocations); we never cache under `name`.
         return async (ctx) => {

package/dist/session/nimbus-session.d.ts

@@ -41,6 +41,7 @@ export { detectCloudflareWorkersProject } from '../runtime/project-detect.js';
  * the right boundary. See user-debug-transcript.txt lines 1-5.
  */
 export declare function renderMotdBanner(version: string): string;
+export declare function renderWelcomeMarkdown(version: string): string;
 export declare class NimbusSession extends CloudflareDurableObject {
     sqliteFs: SqliteVFS | null;
     kernel: Kernel | null;

package/dist/session/nimbus-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nimbus-session.d.ts","sourceRoot":"","sources":["../../src/session/nimbus-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nimbus-session.d.ts","sourceRoot":"","sources":["../../src/session/nimbus-session.ts"],"names":[],"mappings":"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"}

package/dist/session/nimbus-session.js

@@ -119,6 +119,53 @@ export function renderMotdBanner(version) {
         bot +
         '\x1b[0m\r\n');
 }
+export function renderWelcomeMarkdown(version) {
+    return `# Welcome to Nimbus v${version}
+
+Cloud-native development environment on Cloudflare Workers.
+
+## Start Here
+
+| Task | Command |
+| --- | --- |
+| Run JavaScript | \`node hello.js\` |
+| Install npm packages | \`npm install <pkg>\` |
+| Start the starter app | \`cd app && npm install && npm run dev\` |
+| Run a Cloudflare Worker locally | \`nimbus-wrangler dev\` |
+
+## Install More Runtimes
+
+Nimbus installs language runtimes on demand:
+
+\`\`\`bash
+nimbus install clang       # then: clang hello.c -o hello && ./hello
+nimbus install python      # then: python -c 'print("hi")'
+nimbus install ruby        # then: ruby -e 'puts "hi"'
+\`\`\`
+
+\`python3\`, \`ruby3\`, and \`wasm-ld\` are command aliases. If an
+installable command is missing, Nimbus prints the matching install command.
+
+## Interactive REPLs
+
+| Runtime | REPL |
+| --- | --- |
+| Python | \`python\` or \`python3\` - Pyodide CPython 3.13 |
+| Ruby | \`ruby\` or \`ruby3\` - ruby.wasm 3.3 |
+| Node | \`node\` - workerd Node compatibility runtime |
+
+## System Commands
+
+\`\`\`bash
+nimbus install --list       # show installed runtimes
+nimbus install --available  # show catalog
+df                          # filesystem + cache stats
+\`\`\`
+
+The editor opens this file in Markdown preview mode by default. Use
+\`Ctrl+P\` to open files and \`Ctrl+S\` to save edits.
+`;
+}
 export class NimbusSession extends CloudflareDurableObject {
     // this.ctx and this.env are provided by the DurableObject base class
     sqliteFs = null;
@@ -1020,29 +1067,8 @@ export class NimbusSession extends CloudflareDurableObject {
                 '  return 0;\n' +
                 '}\n');
         }
-        if (!fs.exists('home/user/welcome.txt')) {
-            fs.writeFile('home/user/welcome.txt', `Welcome to Nimbus v${NIMBUS_VERSION}!\n\n` +
-                'Cloud-native dev environment on Cloudflare Workers.\n\n' +
-                'JavaScript / TypeScript:\n' +
-                '  node hello.js              — run in isolated dynamic worker\n' +
-                '  npm install <pkg>          — install npm packages\n' +
-                '  vite                       — start dev server with HMR\n' +
-                '  nimbus-wrangler dev        — run Cloudflare Worker locally\n' +
-                '\n' +
-                'More languages (install on demand):\n' +
-                "  nimbus install clang       — then: clang hello.c -o hello && ./hello\n" +
-                "  nimbus install python      — then: python -c 'print(\"hi\")'\n" +
-                "  nimbus install ruby        — then: ruby -e 'puts \"hi\"'\n" +
-                '\n' +
-                'Interactive REPLs (after install):\n' +
-                '  python                     — Pyodide CPython 3.13\n' +
-                '  ruby                       — ruby.wasm 3.3\n' +
-                '  node                       — bare REPL\n' +
-                '\n' +
-                'System:\n' +
-                '  nimbus install --list      — show installed runtimes\n' +
-                '  nimbus install --available — show catalog\n' +
-                '  df                         — filesystem + cache stats\n');
+        if (!fs.exists('home/user/welcome.md')) {
+            fs.writeFile('home/user/welcome.md', renderWelcomeMarkdown(NIMBUS_VERSION));
         }
         // ── Starter app (Vite + React + TS + Tailwind + Router) ──
         // Idempotent: guarded by shouldSeedProject() which checks both a

package/dist/shell/unix-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unix-commands.d.ts","sourceRoot":"","sources":["../../src/shell/unix-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AA88FtD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,GAAG,EACb,GAAG,EAAE,SAAS,GACb,IAAI,CAoLN"}
+{"version":3,"file":"unix-commands.d.ts","sourceRoot":"","sources":["../../src/shell/unix-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AA09FtD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,GAAG,EACb,GAAG,EAAE,SAAS,GACb,IAAI,CAoLN"}

package/dist/shell/unix-commands.js

@@ -24,6 +24,9 @@ function getSymlinkRegistry(vfs) {
     }
     return v.__nimbus_symlink_registry;
 }
+function isRuntimeInstallHintHandler(handler) {
+    return !!handler && !!handler.__nimbusRuntimeInstallHint;
+}
 // ── Helpers ─────────────────────────────────────────────────────────────
 function resolvePath(cwd, p) {
     if (p.startsWith('/'))
@@ -134,12 +137,7 @@ const _CANONICAL_BIN_PATHS = {
     // Self
     nimbus: '/usr/local/bin/nimbus',
 };
-/** Resolve a command name to a path via PATH-walk + canonical-bin
- *  fallback. Returns null if not findable. Skip-canonical when the
- *  caller knows the command is a shell builtin (no fallback). */
-function _whichLookup(vfs, name, envPath) {
-    // 1. Real on-disk binary in $PATH (npm-installed node_modules/.bin,
-    //    user-placed scripts, etc.).
+function _pathLookup(vfs, name, envPath) {
     const paths = (envPath || '/usr/local/bin:/usr/bin:/bin').split(':');
     for (const dir of paths) {
         if (!dir)
@@ -150,12 +148,33 @@ function _whichLookup(vfs, name, envPath) {
             return '/' + fp;
         }
     }
-    // 2. Canonical-bin fallback for our facet-direct runtimes.
-    if (_CANONICAL_BIN_PATHS[name]) {
-        return _CANONICAL_BIN_PATHS[name];
+    return null;
+}
+async function _registryResolved(registry, name) {
+    try {
+        const resolved = typeof registry.resolve === 'function'
+            ? await registry.resolve(name)
+            : null;
+        if (resolved && !isRuntimeInstallHintHandler(resolved))
+            return resolved;
+    }
+    catch {
+        // Registry misses are normal for unknown commands.
     }
     return null;
 }
+/** Resolve a command name to a path via PATH-walk + canonical-bin
+ *  fallback. Returns null if not findable. Skip-canonical when the
+ *  caller knows the command is a shell builtin (no fallback). */
+async function _whichLookup(vfs, registry, name, envPath) {
+    const diskPath = _pathLookup(vfs, name, envPath);
+    if (diskPath)
+        return diskPath;
+    const canonicalPath = _CANONICAL_BIN_PATHS[name];
+    if (!canonicalPath)
+        return null;
+    return await _registryResolved(registry, name) ? canonicalPath : null;
+}
 function mkWhich(vfs, registry) {
     return async (ctx) => {
         // Parse flags. Supports -a (show all matches), -s (silent — no
@@ -191,16 +210,10 @@ function mkWhich(vfs, registry) {
         let anyMissing = false;
         for (const name of names) {
             // Classify: is it a registry-resolvable command (shell builtin)?
-            let isBuiltin = false;
-            try {
-                const resolved = typeof registry.resolve === 'function'
-                    ? await registry.resolve(name)
-                    : null;
-                isBuiltin = !!resolved;
-            }
-            catch { /* registry unavailable; treat as not-builtin */ }
+            const resolved = await _registryResolved(registry, name);
+            const isBuiltin = !!resolved;
             // 1. PATH-walk + canonical-bin lookup.
-            const path = _whichLookup(vfs, name, ctx.env.PATH || '');
+            const path = await _whichLookup(vfs, registry, name, ctx.env.PATH || '');
             let found = false;
             if (path) {
                 if (!silent)
@@ -235,15 +248,15 @@ function mkWhich(vfs, registry) {
  * binaries on the virtual VFS; print just the binary path. With no
  * match, print just the name (matches `whereis` behavior on missing).
  */
-function mkWhereis(vfs) {
-    return (ctx) => {
+function mkWhereis(vfs, registry) {
+    return async (ctx) => {
         const names = ctx.args.filter(a => !a.startsWith('-'));
         if (names.length === 0) {
             ctx.stderr.write('Usage: whereis name [name ...]\n');
             return 1;
         }
         for (const name of names) {
-            const path = _whichLookup(vfs, name, ctx.env.PATH || '');
+            const path = await _whichLookup(vfs, registry, name, ctx.env.PATH || '');
             if (path) {
                 ctx.stdout.write(`${name}: ${path}\n`);
             }
@@ -290,36 +303,28 @@ function mkCommand(vfs, registry) {
         if (mode === '-v') {
             // Print path or builtin marker; exit 0 if found.
             const name = args[0];
-            const path = _whichLookup(vfs, name, ctx.env.PATH || '');
+            const path = await _whichLookup(vfs, registry, name, ctx.env.PATH || '');
             if (path) {
                 ctx.stdout.write(path + '\n');
                 return 0;
             }
-            try {
-                const resolved = await registry.resolve(name);
-                if (resolved) {
-                    ctx.stdout.write(name + '\n');
-                    return 0;
-                }
+            if (await _registryResolved(registry, name)) {
+                ctx.stdout.write(name + '\n');
+                return 0;
             }
-            catch { /* registry miss */ }
             return 1;
         }
         if (mode === '-V') {
             const name = args[0];
-            const path = _whichLookup(vfs, name, ctx.env.PATH || '');
+            const path = await _whichLookup(vfs, registry, name, ctx.env.PATH || '');
             if (path) {
                 ctx.stdout.write(`${name} is ${path}\n`);
                 return 0;
             }
-            try {
-                const resolved = await registry.resolve(name);
-                if (resolved) {
-                    ctx.stdout.write(`${name} is a shell builtin\n`);
-                    return 0;
-                }
+            if (await _registryResolved(registry, name)) {
+                ctx.stdout.write(`${name} is a shell builtin\n`);
+                return 0;
             }
-            catch { /* miss */ }
             ctx.stderr.write(`command: ${name}: not found\n`);
             return 1;
         }
@@ -368,7 +373,7 @@ function mkType(_vfs, registry) {
         for (const name of ctx.args) {
             try {
                 const resolved = typeof registry.resolve === 'function' ? await registry.resolve(name) : null;
-                if (resolved) {
+                if (resolved && !isRuntimeInstallHintHandler(resolved)) {
                     ctx.stdout.write(`${name} is a shell builtin\n`);
                 }
                 else {
@@ -3517,7 +3522,7 @@ function wrap(fn) {
 }
 export function registerUnixCommands(registry, vfs) {
     registry.register('which', wrap(mkWhich(vfs, registry)));
-    registry.register('whereis', wrap(mkWhereis(vfs)));
+    registry.register('whereis', wrap(mkWhereis(vfs, registry)));
     registry.register('command', wrap(mkCommand(vfs, registry)));
     registry.register('type', wrap(mkType(vfs, registry)));
     registry.register('env', wrap(mkEnv()));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbus-sh/worker",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Nimbus runtime package for Cloudflare Workers, re-exported publicly through @nimbus-sh/sdk/worker.",
   "keywords": [
     "cloudflare",