@nimbus-sh/worker 0.9.0 → 0.11.0

package/dist/shell/npm-bin-entrypoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"npm-bin-entrypoints.d.ts","sourceRoot":"","sources":["../../src/shell/npm-bin-entrypoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AACtG,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,sBAAsB,CAAC;AAWnF,KAAK,MAAM,GAAG;IAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAiB5C,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACnD,CAAC;AAEF,KAAK,kBAAkB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAezD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE;IACJ,GAAG,EAAE,eAAe,CAAC;IACrB,MAAM,IAAI,MAAM,CAAC;IACjB,SAAS,EAAE,wBAAwB,CAAC;IACpC,eAAe,IAAI,YAAY,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxJ,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9D,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7F,GACA,IAAI,CAqHN;AAqFD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,GACb,yBAAyB,CAS3B;AA+FD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAS/E"}
+{"version":3,"file":"npm-bin-entrypoints.d.ts","sourceRoot":"","sources":["../../src/shell/npm-bin-entrypoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AACtG,OAAO,KAAK,EAAE,YAAY,EAA4B,MAAM,sBAAsB,CAAC;AAYnF,KAAK,MAAM,GAAG;IAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAiB5C,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACnD,CAAC;AAEF,KAAK,kBAAkB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAezD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE;IACJ,GAAG,EAAE,eAAe,CAAC;IACrB,MAAM,IAAI,MAAM,CAAC;IACjB,SAAS,EAAE,wBAAwB,CAAC;IACpC,eAAe,IAAI,YAAY,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mBAAmB,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxJ,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9D,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7F,GACA,IAAI,CAgJN;AAqFD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EAAE,GACb,yBAAyB,CAS3B;AAiGD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAS/E"}

package/dist/shell/npm-bin-entrypoints.js

@@ -1,4 +1,4 @@
-import { resolveNpmBin, resolveNpmBinFromPath, isStagedArtifactTarget, stagedArtifactId, } from '../npm/bin-links.js';
+import { resolveNpmBin, resolveNpmBinFromPath, resolveNpmBinPath, isStagedArtifactTarget, stagedArtifactId, } from '../npm/bin-links.js';
 import { bundleProfileForNpmBin } from '@nimbus-sh/core/runtime/bundle-profile.js';
 import { OPENCODE_TREE_SITTER_DIAG_ARG } from '../runtime/opencode-facet-runner.js';
 import { normalizeVfsPath } from '@nimbus-sh/core/vfs/path.js';
@@ -18,6 +18,15 @@ export function installNpmBinFallbackResolver(registry, deps) {
     const vfs = deps.vfs;
     const upstreamResolve = registry.resolve.bind(registry);
     registry.resolve = async function resolveWithNpmBins(name) {
+        // `<dir>/node_modules/.bin/<bin>` by path (a launcher's `exec`) is the
+        // same program as the bare name: same runtime choice, TTY and lifecycle.
+        if (name.startsWith('/') || name.startsWith('./') || name.startsWith('../')) {
+            const cwd = deps.getCwd() || '/home/user';
+            const bin = resolveNpmBinPath(vfs, cwd, name);
+            if (!bin)
+                return await upstreamResolve(name);
+            return binHandler(bin.name, (ctx) => resolveNpmBinPath(vfs, ctx.cwd || '/home/user', name));
+        }
         const upstream = await upstreamResolve(name);
         if (upstream)
             return upstream;
@@ -40,9 +49,12 @@ export function installNpmBinFallbackResolver(registry, deps) {
             hintHandler.__nimbusRuntimeInstallHint = true;
             return hintHandler;
         }
+        return binHandler(name, (ctx) => resolveNpmBinForInvocation(vfs, ctx.cwd || '/home/user', ctx.env?.PATH || DEFAULT_PATH, name));
+    };
+    function binHandler(name, lookup) {
         return async (ctx) => {
             const invocationCwd = ctx.cwd || '/home/user';
-            const bin = resolveNpmBinForInvocation(vfs, invocationCwd, ctx.env?.PATH || DEFAULT_PATH, name);
+            const bin = lookup(ctx);
             if (!bin) {
                 ctx.stderr.write(`${name}: command not found\n`);
                 return 127;
@@ -56,11 +68,21 @@ export function installNpmBinFallbackResolver(registry, deps) {
                 const disposition = classifyStagedArtifact(artifact, argv);
                 return await runStagedArtifact(deps, name, artifact, argv, invocationCwd, ctx, disposition);
             }
+            // A PATH script for another interpreter (`#!/bin/sh`) is not a node
+            // program: run it the way a path-shaped invocation of it runs.
+            const runtimeName = npmBinRuntimeForTarget(vfs, bin.targetPath);
+            if (runtimeName === null) {
+                const execCmd = await upstreamResolve('/' + bin.shimPath);
+                if (typeof execCmd !== 'function') {
+                    ctx.stderr.write(`${name}: command not found\n`);
+                    return 127;
+                }
+                return await execCmd(ctx);
+            }
             const bundleProfile = bundleProfileForNpmBin(bin);
             const metadata = readNpmBinPackageMetadata(vfs, bin.packagePath);
             const attachedTty = looksAttachedTtyNpmBin(metadata, argv, ctx.env);
             const longRunning = attachedTty || looksLongRunningNpmBin(name, argv);
-            const runtimeName = npmBinRuntimeForTarget(vfs, bin.targetPath);
             const runtimeCmd = await upstreamResolve(runtimeName);
             if (typeof runtimeCmd !== 'function') {
                 ctx.stderr.write(`${name}: ${runtimeName} command unavailable\n`);
@@ -131,7 +153,7 @@ export function installNpmBinFallbackResolver(registry, deps) {
             }
             return exitCode;
         };
-    };
+    }
 }
 function resolveNpmBinForInvocation(vfs, cwd, envPath, name) {
     return resolveNpmBinFromPath(vfs, cwd, envPath, name)
@@ -216,9 +238,12 @@ function formatError(error) {
         return error.stack || error.message;
     return String(error);
 }
+/** null when the target's `#!` names an interpreter other than node or bun; no `#!` runs as node. */
 function npmBinRuntimeForTarget(vfs, targetPath) {
     const firstLine = readFirstLine(vfs, targetPath);
-    return shebangRuntime(firstLine) ?? 'node';
+    if (!firstLine?.startsWith('#!'))
+        return 'node';
+    return shebangRuntime(firstLine);
 }
 function readFirstLine(vfs, path) {
     try {

package/dist/vfs/facet-resident-limits.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Bounds of the in-facet resident store (vfs/facet-resident-store.ts) that the
+ * supervisor also needs.
+ *
+ * They live apart from the store because that module exports the store's
+ * source text, FACET_RESIDENT_STORE_SOURCE (~105 KB). The facet receives that
+ * text as a staged asset (scripts/bundle-node-shims.mjs), and importing a
+ * constant from the store module would bundle the text into the Worker too:
+ * esbuild keeps a template literal with substitutions even when nothing reads
+ * it. The Worker bundle has a size gate
+ * (tests/behavioral/assets-fetch/new/worker-bundle-size.mjs).
+ */
+/**
+ * Bytes of file content in one row.
+ *
+ * The measured ceiling is 2,199,981 bytes in a single value (bisected, with a
+ * 12-char key; the limit is on the row, so a longer path buys less). 1 MiB
+ * leaves better than 2x of headroom against a limit whose exact form is not
+ * contractual, and keeps the per-read allocation of a large file bounded.
+ * Files at or under it — effectively all of them — are one row and one query.
+ */
+export declare const RESIDENT_CHUNK_BYTES = 1048576;
+/**
+ * What a one-shot's store may hold in its heap: the closure bound a one-shot
+ * is already held to (VFS_BUNDLE_MAX_BYTES, the module map it adopts) plus
+ * 16 MiB for the namespace image and the data plan. A one-shot runs in a
+ * 128 MiB isolate, and today holds the same module map in its heap as a
+ * table; past this budget the store degrades as the durable one does near
+ * the session's limit: a fill is refused (the read is an honest miss), and an
+ * own write is held within its own bound or named ENOSPC.
+ */
+export declare const ONE_SHOT_STORE_MEMORY_BYTES: number;
+//# sourceMappingURL=facet-resident-limits.d.ts.map

package/dist/vfs/facet-resident-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facet-resident-limits.d.ts","sourceRoot":"","sources":["../../src/vfs/facet-resident-limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,UAAY,CAAC;AAE9C;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,QAA0C,CAAC"}

package/dist/vfs/facet-resident-limits.js

@@ -0,0 +1,33 @@
+/**
+ * Bounds of the in-facet resident store (vfs/facet-resident-store.ts) that the
+ * supervisor also needs.
+ *
+ * They live apart from the store because that module exports the store's
+ * source text, FACET_RESIDENT_STORE_SOURCE (~105 KB). The facet receives that
+ * text as a staged asset (scripts/bundle-node-shims.mjs), and importing a
+ * constant from the store module would bundle the text into the Worker too:
+ * esbuild keeps a template literal with substitutions even when nothing reads
+ * it. The Worker bundle has a size gate
+ * (tests/behavioral/assets-fetch/new/worker-bundle-size.mjs).
+ */
+import { VFS_BUNDLE_MAX_BYTES } from '@nimbus-sh/core/constants.js';
+/**
+ * Bytes of file content in one row.
+ *
+ * The measured ceiling is 2,199,981 bytes in a single value (bisected, with a
+ * 12-char key; the limit is on the row, so a longer path buys less). 1 MiB
+ * leaves better than 2x of headroom against a limit whose exact form is not
+ * contractual, and keeps the per-read allocation of a large file bounded.
+ * Files at or under it — effectively all of them — are one row and one query.
+ */
+export const RESIDENT_CHUNK_BYTES = 1_048_576;
+/**
+ * What a one-shot's store may hold in its heap: the closure bound a one-shot
+ * is already held to (VFS_BUNDLE_MAX_BYTES, the module map it adopts) plus
+ * 16 MiB for the namespace image and the data plan. A one-shot runs in a
+ * 128 MiB isolate, and today holds the same module map in its heap as a
+ * table; past this budget the store degrades as the durable one does near
+ * the session's limit: a fill is refused (the read is an honest miss), and an
+ * own write is held within its own bound or named ENOSPC.
+ */
+export const ONE_SHOT_STORE_MEMORY_BYTES = VFS_BUNDLE_MAX_BYTES + 16 * 1024 * 1024;

package/dist/vfs/facet-resident-store.d.ts

@@ -180,16 +180,6 @@
  * over — measured past the DO CPU limit at pi scale. See
  * \`__residentSynchronizeFromSupervisor\`.
  */
-/**
- * Bytes of file content in one row.
- *
- * The measured ceiling is 2,199,981 bytes in a single value (bisected, with a
- * 12-char key; the limit is on the row, so a longer path buys less). 1 MiB
- * leaves better than 2x of headroom against a limit whose exact form is not
- * contractual, and keeps the per-read allocation of a large file bounded.
- * Files at or under it — effectively all of them — are one row and one query.
- */
-export declare const RESIDENT_CHUNK_BYTES = 1048576;
 /**
  * Rows written before the materialiser yields.
  *
@@ -216,6 +206,8 @@ export declare const RESIDENT_FILL_BATCH_BYTES: number;
  * The in-facet store. Spliced into the generated module ahead of the shims, in
  * the same way `VFS_WRITE_LEDGER_SOURCE` is (`facets/manager.ts`), because it
  * has to close over the same module scope the shims read `__vfsBundle` from.
+ * Like the ledger and the shims it reaches the facet as a staged asset
+ * (scripts/bundle-node-shims.mjs), not through the Worker bundle.
  *
  * It presents a Proxy rather than a new API on purpose. `_bundleLookup`,
  * `_writtenCell`, `__readFileOr`, `__fileExists` and the directory scans all

package/dist/vfs/facet-resident-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"facet-resident-store.d.ts","sourceRoot":"","sources":["../../src/vfs/facet-resident-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqLG;AAQH;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,UAAY,CAAC;AAE9C;;;;;;;;;GASG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,OAA2B,CAAC;AAClE,eAAO,MAAM,yBAAyB,QAA8B,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,QAo3BhC,CAAC;AAET,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE"}
+{"version":3,"file":"facet-resident-store.d.ts","sourceRoot":"","sources":["../../src/vfs/facet-resident-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqLG;AAUH;;;;;;;;;GASG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,OAA2B,CAAC;AAClE,eAAO,MAAM,yBAAyB,QAA8B,CAAC;AAErE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,2BAA2B,QAytEhC,CAAC;AAET,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE"}