@nimbus-sh/worker 0.1.4 → 0.1.6

package/dist/shell/unix-commands.js

@@ -10,19 +10,10 @@
  * du, man/help, basename, dirname, printf, true, false, seq, sleep,
  * touch, stat, file, xxd, base64, sha256sum, id, hostname, realpath
  */
-import { SymlinkRegistry } from '../vfs/symlink-registry.js';
+import { getSymlinkRegistry } from '../vfs/symlink-registry.js';
 import { enc } from '../_shared/bytes.js';
-/**
- * SHELL-FOLLOWUPS-4 (2026-05-11): per-vfs symlink registry singleton.
- * Cached on the VFS instance via a side property so `ln -s` + `readlink`
- * + `ls -la` share the same registry within a session.
- */
-function getSymlinkRegistry(vfs) {
-    const v = vfs;
-    if (!v.__nimbus_symlink_registry) {
-        v.__nimbus_symlink_registry = new SymlinkRegistry(vfs);
-    }
-    return v.__nimbus_symlink_registry;
+function isRuntimeInstallHintHandler(handler) {
+    return !!handler && !!handler.__nimbusRuntimeInstallHint;
 }
 // ── Helpers ─────────────────────────────────────────────────────────────
 function resolvePath(cwd, p) {
@@ -115,8 +106,13 @@ const _CANONICAL_BIN_PATHS = {
     git: '/usr/bin/git',
     python: '/usr/bin/python3',
     python3: '/usr/bin/python3',
+    pip: '/usr/bin/pip',
+    pip3: '/usr/bin/pip3',
     ruby: '/usr/bin/ruby',
     ruby3: '/usr/bin/ruby',
+    gem: '/usr/bin/gem',
+    bundle: '/usr/bin/bundle',
+    bundler: '/usr/bin/bundler',
     sh: '/usr/bin/sh',
     bash: '/usr/bin/bash',
     // Framework CLIs
@@ -134,12 +130,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 +141,36 @@ 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, options = {}) {
+    try {
+        const resolved = typeof registry.resolve === 'function'
+            ? await registry.resolve(name)
+            : null;
+        if (resolved && (options.includeInstallHints || !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, { includeInstallHints: true })
+        ? canonicalPath
+        : null;
+}
 function mkWhich(vfs, registry) {
     return async (ctx) => {
         // Parse flags. Supports -a (show all matches), -s (silent — no
@@ -191,16 +206,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 +244,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 +299,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 +369,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 +3518,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/dist/vfs/path.d.ts

@@ -7,10 +7,10 @@
  * before pop) that the others lacked — that safer behavior is the one
  * preserved here.
  *
- * Facet-isolate code-string copies (e.g. inside
- * generateGitNetworkFacetCode in git-network-facet.ts, and inside
- * node-shims.ts) cannot import this module and must keep their inline
- * implementations; those copies are documented as justified.
+ * Facet-isolate code-string copies (for example git-network-facet,
+ * pre-bundle-facet, and node-shims generated/runtime strings) cannot import
+ * this module and must keep their inline implementations; those copies are
+ * documented as justified.
  *
  * Semantics:
  *   - Strip empty segments (collapses `//` runs)
@@ -25,6 +25,10 @@
  *   normalizeVfsPath('../escape')          -> 'escape'  (bounded; doesn't go negative)
  */
 export declare function normalizeVfsPath(p: string): string;
+/** Resolve a user path against a VFS cwd and return a canonical VFS key. */
+export declare function resolveVfsPath(path: string, cwd: string): string;
+/** Return the canonical VFS parent key, or an empty string for root-level paths. */
+export declare function parentVfsPath(path: string): string;
 /** Strip leading slashes only — does not touch internal segments. */
 export declare function stripLeadingSlashes(p: string): string;
 //# sourceMappingURL=path.d.ts.map

package/dist/vfs/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/vfs/path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/vfs/path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/vfs/path.js

@@ -7,10 +7,10 @@
  * before pop) that the others lacked — that safer behavior is the one
  * preserved here.
  *
- * Facet-isolate code-string copies (e.g. inside
- * generateGitNetworkFacetCode in git-network-facet.ts, and inside
- * node-shims.ts) cannot import this module and must keep their inline
- * implementations; those copies are documented as justified.
+ * Facet-isolate code-string copies (for example git-network-facet,
+ * pre-bundle-facet, and node-shims generated/runtime strings) cannot import
+ * this module and must keep their inline implementations; those copies are
+ * documented as justified.
  *
  * Semantics:
  *   - Strip empty segments (collapses `//` runs)
@@ -35,6 +35,18 @@ export function normalizeVfsPath(p) {
     }
     return out.join('/');
 }
+/** Resolve a user path against a VFS cwd and return a canonical VFS key. */
+export function resolveVfsPath(path, cwd) {
+    return path.startsWith('/')
+        ? normalizeVfsPath(path)
+        : normalizeVfsPath(`${cwd}/${path}`);
+}
+/** Return the canonical VFS parent key, or an empty string for root-level paths. */
+export function parentVfsPath(path) {
+    const clean = normalizeVfsPath(path);
+    const idx = clean.lastIndexOf('/');
+    return idx > 0 ? clean.slice(0, idx) : '';
+}
 /** Strip leading slashes only — does not touch internal segments. */
 export function stripLeadingSlashes(p) {
     return p.replace(/^\/+/, '');

package/dist/vfs/sqlite-vfs.d.ts

@@ -82,6 +82,7 @@ export declare class SqliteVFS {
     private _totalFiles;
     private _totalDirs;
     private _usedBytes;
+    private _revision;
     private pendingWrites;
     /**
      * Sum of `data.length` across pendingWrites entries. Maintained
@@ -238,6 +239,7 @@ export declare class SqliteVFS {
     exists(path: string): boolean;
     isDirectory(path: string): boolean;
     isFile(path: string): boolean;
+    revision(): number;
     mkdir(path: string, options?: {
         recursive?: boolean;
     }): void;

package/dist/vfs/sqlite-vfs.d.ts.map

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

package/dist/vfs/sqlite-vfs.js

@@ -88,6 +88,7 @@ export class SqliteVFS {
     _totalFiles = 0;
     _totalDirs = 0;
     _usedBytes = 0;
+    _revision = 0;
     // ── Deferred write queue (do86 pattern) ───────────────────────────────
     pendingWrites = new Map();
     /**
@@ -783,6 +784,9 @@ export class SqliteVFS {
         const inode = this.inodes.get(path);
         return inode !== undefined && !inode.isDir;
     }
+    revision() {
+        return this._revision;
+    }
     mkdir(path, options) {
         if (this.exists(path))
             return;
@@ -808,6 +812,7 @@ export class SqliteVFS {
         this.inodes.set(path, inode);
         this._addToChildrenIndex(pp, path);
         this._totalDirs++; // B3
+        this._revision++;
         this.events.emit('addDir', path);
     }
     writeFile(path, content) {
@@ -890,6 +895,7 @@ export class SqliteVFS {
                 this.deferWrite(path, i, chunk);
             }
         }
+        this._revision++;
         this.events.emit(isNew ? 'add' : 'change', path);
     }
     readFile(path) {
@@ -1013,6 +1019,7 @@ export class SqliteVFS {
             }
         }
         this.inodes.delete(path);
+        this._revision++;
         this.events.emit('unlink', path);
     }
     rmdir(path) {
@@ -1037,6 +1044,7 @@ export class SqliteVFS {
         }
         this.inodes.delete(np);
         this.children.delete(np); // Remove empty children set
+        this._revision++;
         this.events.emit('unlinkDir', np);
     }
     rename(oldPath, newPath) {
@@ -1117,6 +1125,7 @@ export class SqliteVFS {
                 this._addToChildrenIndex(ncpp, ncp);
             }
         }
+        this._revision++;
         this.events.emit('rename', newPath, oldPath);
     }
     copyFile(src, dest) {
@@ -1509,6 +1518,8 @@ export class SqliteVFS {
         this._sqlWrites += inodeCount + chunkCount;
         this._batchWrites++;
         this._batchWriteRows += inodeCount + chunkCount;
+        if (inodeCount > 0 || chunkCount > 0 || payload.deletePaths?.length)
+            this._revision++;
         return { inodes: inodeCount, chunks: chunkCount };
     }
     /**

package/dist/vfs/symlink-registry.d.ts

@@ -33,7 +33,7 @@ export declare class SymlinkRegistry {
     private load;
     /** Write the cache back to the registry file. */
     private flush;
-    /** Normalize a path: strip leading slashes (VFS internal convention). */
+    /** Normalize a path to the VFS internal key convention. */
     private norm;
     /** Create or replace a symlink. Target is stored verbatim (can be
      *  absolute or relative — interpretation happens at resolve time). */
@@ -61,4 +61,10 @@ export declare class SymlinkRegistry {
         target: string;
     }[];
 }
+/**
+ * Return the session-wide registry for a VFS instance. The registry has an
+ * in-memory cache, so all runtime surfaces that share one SqliteVFS must also
+ * share the registry instance to avoid stale symlink reads.
+ */
+export declare function getSymlinkRegistry(vfs: SqliteVFS): SymlinkRegistry;
 //# sourceMappingURL=symlink-registry.d.ts.map

package/dist/vfs/symlink-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symlink-registry.d.ts","sourceRoot":"","sources":["../../src/vfs/symlink-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,KAAK,CAAoC;gBAErC,GAAG,EAAE,SAAS;IAI1B,wCAAwC;IACxC,OAAO,CAAC,IAAI;IAgBZ,iDAAiD;IACjD,OAAO,CAAC,KAAK;IASb,yEAAyE;IACzE,OAAO,CAAC,IAAI;IAIZ;0EACsE;IACtE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAM3C,oDAAoD;IACpD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOjC,wEAAwE;IACxE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKrC;;;;;;;;;OASG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAuB9C,2EAA2E;IAC3E,IAAI,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE;CAO3C"}
+{"version":3,"file":"symlink-registry.d.ts","sourceRoot":"","sources":["../../src/vfs/symlink-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAKjD,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,KAAK,CAAoC;gBAErC,GAAG,EAAE,SAAS;IAI1B,wCAAwC;IACxC,OAAO,CAAC,IAAI;IAgBZ,iDAAiD;IACjD,OAAO,CAAC,KAAK;IASb,2DAA2D;IAC3D,OAAO,CAAC,IAAI;IAIZ;0EACsE;IACtE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAM3C,oDAAoD;IACpD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOjC,wEAAwE;IACxE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKrC;;;;;;;;;OASG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAiB9C,2EAA2E;IAC3E,IAAI,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE;CAO3C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,eAAe,CAMlE"}

package/dist/vfs/symlink-registry.js

@@ -24,6 +24,7 @@
  * Loop guard: `resolveSymlinkChain` follows at most 40 hops (matches
  * POSIX SYMLOOP_MAX).
  */
+import { normalizeVfsPath } from './path.js';
 const REGISTRY_PATH = '.nimbus-symlinks.json';
 export class SymlinkRegistry {
     vfs;
@@ -62,9 +63,9 @@ export class SymlinkRegistry {
         }
         catch { /* fail-soft */ }
     }
-    /** Normalize a path: strip leading slashes (VFS internal convention). */
+    /** Normalize a path to the VFS internal key convention. */
     norm(p) {
-        return p.replace(/^\/+/, '').replace(/\/+$/, '');
+        return normalizeVfsPath(p);
     }
     /** Create or replace a symlink. Target is stored verbatim (can be
      *  absolute or relative — interpretation happens at resolve time). */
@@ -112,15 +113,7 @@ export class SymlinkRegistry {
             else {
                 // Relative target: resolve from symlink's parent dir.
                 const parent = cur.includes('/') ? cur.substring(0, cur.lastIndexOf('/')) : '';
-                const parts = (parent + '/' + target).split('/');
-                const out = [];
-                for (const s of parts) {
-                    if (s === '..')
-                        out.pop();
-                    else if (s !== '.' && s !== '')
-                        out.push(s);
-                }
-                cur = out.join('/');
+                cur = normalizeVfsPath(`${parent}/${target}`);
             }
         }
         // ELOOP
@@ -135,3 +128,15 @@ export class SymlinkRegistry {
         return out;
     }
 }
+/**
+ * Return the session-wide registry for a VFS instance. The registry has an
+ * in-memory cache, so all runtime surfaces that share one SqliteVFS must also
+ * share the registry instance to avoid stale symlink reads.
+ */
+export function getSymlinkRegistry(vfs) {
+    const owner = vfs;
+    if (!owner.__nimbus_symlink_registry) {
+        owner.__nimbus_symlink_registry = new SymlinkRegistry(vfs);
+    }
+    return owner.__nimbus_symlink_registry;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimbus-sh/worker",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Nimbus runtime package for Cloudflare Workers, re-exported publicly through @nimbus-sh/sdk/worker.",
   "keywords": [
     "cloudflare",
@@ -46,6 +46,7 @@
     "dist",
     "public",
     "scripts",
+    "runtime-contracts",
     "README.md",
     "LICENSE",
     "NOTICE.md"
@@ -61,7 +62,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
+    "@ai-sdk/openai-compatible": "^2.0.41",
     "@lifo-sh/core": "^0.5.5",
+    "ai": "^6.0.182",
     "clean-git-ref": "^2.0.1",
     "crc-32": "^1.2.2",
     "diff": "^9.0.0",