@nimbus-sh/worker 0.7.0 → 0.9.0

package/dist/runtime/package-manager.d.ts

@@ -1,152 +1,65 @@
 /**
- * package-manager.ts — `nimbus install <runtime>` shell verb.
+ * package-manager.ts — the Worker's edge of runtime installation.
  *
- * Subcommands (all under `nimbus install`):
+ * The policy moved: installs, singleflight, bin registration and the `nimbus`
+ * verb itself live in `@nimbus-sh/core` (`runtime/runtime-manager.ts`,
+ * `runtime/nimbus-command.ts`) because a library workspace owns them too.
+ * What remains here is what only a Cloudflare host can answer:
  *
- *   nimbus install <name>                 install latest of <name>
- *   nimbus install <name>@<version>       install specific version
- *   nimbus install --list                 show installed runtimes
- *   nimbus install --available            show catalog of installables
- *   nimbus install --reinstall <name>     force refetch
- *   nimbus uninstall <name>               remove installed runtime
- *
- * Per-user VFS layout:
- *
- *   ~/.nimbus/runtimes/<name>/<version>/
- *     manifest.json
- *     bin/<entry>
- *     share/<name>/...
- *     LICENSE
- *
- * Survives DO eviction (SqliteFS-backed). Boot-time rehydration reads
- * every `~/.nimbus/runtimes/STAR/STAR/manifest.json` and re-registers
- * each `entrypoints[].binName` as a shell command pointing at the
- * named runner factory.
- *
- * Errors throw and bubble up to the user as a single diagnostic line.
+ *   - `runtimeCatalogSource(env)` — the R2-backed RuntimeSource (the digest
+ *     chain stays in runtime-catalog.ts beside this file's fetchers);
+ *   - the programmatic entry points the SDK surface calls;
+ *   - the command-not-found hint resolver init.ts wires into exec dispatch.
  */
-import { type RuntimeCatalogEnv } from './runtime-catalog.js';
-import { type RuntimeManifest } from '@nimbus-sh/core/runtime/runtime-manifest.js';
-import type { SqliteVFS } from '@nimbus-sh/core/vfs/sqlite-vfs.js';
-import { type RuntimePackageAbi } from '@nimbus-sh/core/runtime/os-contracts.js';
-import { type MinShellRegistry } from '@nimbus-sh/core/runtime/installed-runtimes.js';
-import type { CommandContext } from '@nimbus-sh/core/substrate/lifo/commands/types.js';
-/** Minimal shell ctx shape we depend on (matches existing handlers). */
-export interface ShellCtx extends Pick<CommandContext, 'pid' | 'cred' | 'setUmask' | 'runAs'> {
-    args: string[];
-    env: Record<string, string>;
-    cwd: string;
-    stdout: {
-        write(s: string): void;
-    };
-    stderr: {
-        write(s: string): void;
-    };
-}
-export interface RuntimeWarmTarget {
-    name: string;
-    version: string;
-    root: string;
-    manifest: RuntimeManifest;
-}
-export type RuntimeWarmHook = (target: RuntimeWarmTarget, ctx: ShellCtx) => Promise<void>;
+import { runtimeCatalogSource, type RuntimeCatalogEnv } from './runtime-catalog.js';
+import type { CredentialedVfs } from '@nimbus-sh/core/vfs/sqlite-vfs.js';
+import type { RuntimeManager } from '@nimbus-sh/core/runtime/runtime-manager.js';
+import type { RuntimeAvailability } from '@nimbus-sh/core/runtime/runtime-package.js';
+import { type RuntimeWarmHook } from '@nimbus-sh/core/runtime/nimbus-command.js';
+import type { MinShellRegistry } from '@nimbus-sh/core/runtime/installed-runtimes.js';
+export { runtimeCatalogSource };
+export type { RuntimeWarmHook };
 export interface RuntimeInstallSummary {
     spec: string;
     exitCode: number;
     stdout: string;
     stderr: string;
 }
-export interface RuntimeInstallTarget {
-    runtimeName: string;
-    versionOverride: string | null;
-    requestedName: string;
-}
 export interface RuntimeCommandHint {
     command: string;
     runtimeName: string;
     installSpec: string;
 }
-export declare function createRuntimeCommandHintResolver(env: RuntimeCatalogEnv): (command: string) => Promise<RuntimeCommandHint | null>;
-export declare function listAvailableRuntimes(env: RuntimeCatalogEnv): Promise<Array<{
-    name: string;
-    abi: RuntimePackageAbi;
-    defaultVersion: string;
-    versions: Array<{
-        version: string;
-        sizeBytes: number;
-        license: string;
-    }>;
-}>>;
+/**
+ * `nimbus install` without a shell: the same `runNimbusInstall` path the verb
+ * runs, with output captured instead of written to a terminal. Deps take the
+ * workspace's RuntimeManager — which already holds the source, the registry
+ * and the runner factories — rather than a catalog env.
+ */
 export declare function installRuntimeProgrammatic(deps: {
-    env: RuntimeCatalogEnv;
-    vfs: SqliteVFS;
+    runtimes: RuntimeManager;
     registry: MinShellRegistry;
+    vfs: CredentialedVfs;
     getHome(): string;
+    warmRuntime?: RuntimeWarmHook;
 }, spec: string, opts?: {
     force?: boolean;
 }): Promise<RuntimeInstallSummary>;
 export declare function ensureRuntimesProgrammatic(deps: {
-    env: RuntimeCatalogEnv;
-    vfs: SqliteVFS;
+    runtimes: RuntimeManager;
     registry: MinShellRegistry;
+    vfs: CredentialedVfs;
     getHome(): string;
+    warmRuntime?: RuntimeWarmHook;
 }, specs: string[], opts?: {
     force?: boolean;
 }): Promise<RuntimeInstallSummary[]>;
+export declare function listAvailableRuntimes(env: RuntimeCatalogEnv): Promise<RuntimeAvailability[]>;
 /**
- * The session's application verbs, as the shell reaches them — the SAME
- * session methods the SDK and the Agent call (session/programmatic.ts), so
- * there is one policy for what an exposure, a rotation or a removal is.
- */
-export interface NimbusAppVerbs {
-    expose(target: number | string, options: {
-        visibility?: 'scoped' | 'public';
-        name?: string;
-    }): Promise<{
-        owner: string;
-        name: string | null;
-        port: number;
-        capability: string | null;
-        visibility: 'scoped' | 'public';
-        url: string | null;
-    }>;
-    list(): Promise<Array<{
-        owner: string;
-        name: string | null;
-        port: number | null;
-        pid: number | null;
-        status: string;
-        visibility: string;
-        restart: string;
-        diagnostic: string | null;
-        url: string | null;
-    }>>;
-    rotateLink(target: number | string): Promise<{
-        name: string | null;
-        port: number;
-        url: string | null;
-        capability: string | null;
-    }>;
-    remove(target: number | string): Promise<{
-        owner: string;
-        removed: boolean;
-        port: number | null;
-    }>;
-}
-/**
- * Build the shell-command handler that implements `nimbus install …`,
- * `nimbus uninstall …`, `nimbus expose …`, `nimbus app …` and
- * `nimbus start …`. Registered under the name `nimbus`.
+ * Command-not-found hints, catalog-driven: a bare name the shell could not
+ * resolve is answered with the runtime that provides it, so `python3` hints
+ * at cpython and `wasm-ld` at clang. Loaded once and memoized; a fetch
+ * failure drops the memo so the next unknown command retries.
  */
-export declare function makeNimbusVerbHandler(deps: {
-    env: RuntimeCatalogEnv;
-    vfs: SqliteVFS;
-    registry: MinShellRegistry;
-    /** Returns `process.env.HOME` for the session. Computed by the
-     *  caller (init.ts) from the shell env. */
-    getHome(): string;
-    warmRuntime?: RuntimeWarmHook;
-    /** The application verbs; absent on a host with no session (tests). */
-    apps?: NimbusAppVerbs;
-}): (ctx: any) => Promise<number>;
+export declare function createRuntimeCommandHintResolver(env: RuntimeCatalogEnv): (command: string) => Promise<RuntimeCommandHint | null>;
 //# sourceMappingURL=package-manager.d.ts.map

package/dist/runtime/package-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../src/runtime/package-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../src/runtime/package-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAGL,oBAAoB,EACpB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AAEtF,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAChC,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,EAAE,eAAe,CAAC;IACrB,OAAO,IAAI,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA6B/E;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,EAAE,eAAe,CAAC;IACrB,OAAO,IAAI,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAMpF;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAElG;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,iBAAiB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAyChI"}