@telorun/kernel 0.24.2 → 0.26.0

package/dist/application-env.d.ts

@@ -38,4 +38,22 @@ export declare function resolveApplicationEnv(manifest: Record<string, any>, env
  * schema surfaces through the normal analysis/runtime path, not here.
  */
 export declare function precompileApplicationEnvSchemas(manifest: Record<string, any>, validator: SchemaValidator): void;
+/**
+ * Build-time cache warm for resource-config validators. The runtime
+ * `_createInstance` compiles `controller.schema` — which falls back to the
+ * declaring `Telo.Definition`'s own `schema` — to validate every resource's
+ * config, then validates inputs/outputs against `inputType` / `outputType`.
+ * The analyze-only warm pass stops before instantiation, so without this those
+ * validators are absent from the `__validators` cache and the runtime
+ * recompiles (and, on a read-only image, fails to persist) them on every boot.
+ *
+ * Compiling each definition's `schema` (plus any inline `inputType` /
+ * `outputType` object schemas) here writes them into the same content-addressed
+ * cache the runtime reads, keyed identically because the same schema object is
+ * fed to the same `validator.compile`. Definitions whose controller exports its
+ * own `schema` (rare) still recompile at runtime — that needs the controller
+ * loaded, which the warm pass does not do. Compile failures are swallowed; a
+ * genuinely broken schema surfaces through analysis / runtime, not here.
+ */
+export declare function precompileDefinitionSchemas(manifests: Array<Record<string, any>>, validator: SchemaValidator): void;
 //# sourceMappingURL=application-env.d.ts.map

package/dist/application-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application-env.d.ts","sourceRoot":"","sources":["../src/application-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAiBxD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,SAAS,EAAE,eAAe,GACzB,mBAAmB,CAyBrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,SAAS,EAAE,eAAe,GACzB,IAAI,CAwBN"}
+{"version":3,"file":"application-env.d.ts","sourceRoot":"","sources":["../src/application-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAiBxD,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,SAAS,EAAE,eAAe,GACzB,mBAAmB,CAyBrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,SAAS,EAAE,eAAe,GACzB,IAAI,CAwBN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EACrC,SAAS,EAAE,eAAe,GACzB,IAAI,CAeN"}

package/dist/application-env.js

@@ -77,6 +77,42 @@ export function precompileApplicationEnvSchemas(manifest, validator) {
         compile(PORT_RESIDUAL_SCHEMA);
     }
 }
+/**
+ * Build-time cache warm for resource-config validators. The runtime
+ * `_createInstance` compiles `controller.schema` — which falls back to the
+ * declaring `Telo.Definition`'s own `schema` — to validate every resource's
+ * config, then validates inputs/outputs against `inputType` / `outputType`.
+ * The analyze-only warm pass stops before instantiation, so without this those
+ * validators are absent from the `__validators` cache and the runtime
+ * recompiles (and, on a read-only image, fails to persist) them on every boot.
+ *
+ * Compiling each definition's `schema` (plus any inline `inputType` /
+ * `outputType` object schemas) here writes them into the same content-addressed
+ * cache the runtime reads, keyed identically because the same schema object is
+ * fed to the same `validator.compile`. Definitions whose controller exports its
+ * own `schema` (rare) still recompile at runtime — that needs the controller
+ * loaded, which the warm pass does not do. Compile failures are swallowed; a
+ * genuinely broken schema surfaces through analysis / runtime, not here.
+ */
+export function precompileDefinitionSchemas(manifests, validator) {
+    const compile = (schema) => {
+        if (!schema || typeof schema !== "object")
+            return;
+        try {
+            validator.compile(schema);
+        }
+        catch {
+            // Broken schemas are reported by analysis / runtime, not the warm pass.
+        }
+    };
+    for (const m of manifests) {
+        if (m?.kind !== "Telo.Definition")
+            continue;
+        compile(m.schema);
+        compile(m.inputType);
+        compile(m.outputType);
+    }
+}
 /**
  * Populate the root Application's `ports` namespace from host environment
  * variables. Mirrors `resolveBlock` but fixes the value type to a port integer

package/dist/application-env.js.map

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

package/dist/controller-loader.d.ts

@@ -59,6 +59,10 @@ export interface ControllerLoaderOptions {
      * (cargo loader has its own per-crate cache and does not need this).
      */
     entryUrl?: string;
+    /** Explicit npm install root (`<cache-root>/npm`), threaded from the kernel's
+     *  single `resolveCacheRoot`. Overrides the entry-anchored default so a
+     *  relocated `TELO_CACHE_DIR` is honoured. */
+    installRoot?: string;
 }
 /**
  * Top-level controller-loader dispatcher. Picks a per-scheme sub-loader by

package/dist/controller-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller-loader.d.ts","sourceRoot":"","sources":["../src/controller-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAgB,MAAM,cAAc,CAAC;AAIhE,OAAO,EAAE,gBAAgB,EAAmC,MAAM,uBAAuB,CAAC;AAE1F,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP,cAAc,GACd,OAAO,GACP,aAAa,GACb,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,uBAAuB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAChF,GACD;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE;AAC5E;;;;;;GAMG;GACD;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAE1C,OAAO,GAAE,uBAA4B;IAO3C,IAAI,CACR,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,CAAC;YAqDhB,WAAW;CAe1B"}
+{"version":3,"file":"controller-loader.d.ts","sourceRoot":"","sources":["../src/controller-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAgB,MAAM,cAAc,CAAC;AAIhE,OAAO,EAAE,gBAAgB,EAAmC,MAAM,uBAAuB,CAAC;AAE1F,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP,cAAc,GACd,OAAO,GACP,aAAa,GACb,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,uBAAuB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAChF,GACD;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE;AAC5E;;;;;;GAMG;GACD;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;kDAE8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmC;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAE1C,OAAO,GAAE,uBAA4B;IAU3C,IAAI,CACR,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,CAAC;YAqDhB,WAAW;CAe1B"}

package/dist/controller-loader.js

@@ -23,7 +23,10 @@ import { DEFAULT_POLICY, POLICY_WILDCARD } from "./runtime-registry.js";
 export class ControllerLoader {
     constructor(options = {}) {
         this.emit = options.emit;
-        this.npmLoader = new NpmControllerLoader({ entryUrl: options.entryUrl });
+        this.npmLoader = new NpmControllerLoader({
+            entryUrl: options.entryUrl,
+            installRoot: options.installRoot,
+        });
         this.napiLoader = new NapiControllerLoader();
         this.bundleLoader = new BundleControllerLoader();
     }

package/dist/controller-loader.js.map

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

package/dist/controller-loaders/npm-loader.d.ts

@@ -18,20 +18,31 @@ export interface NpmControllerLoaderOptions {
      * `pkg-name` cli command resolves it from its argument.
      */
     entryUrl?: string;
+    /**
+     * Explicit install root, threaded from the kernel's single `resolveCacheRoot`
+     * (`<cache-root>/npm`). When set it overrides the entry-anchored
+     * `computeInstallRoot`, so a relocated `TELO_CACHE_DIR` (e.g. a prebuilt
+     * image baking deps at `/telo-cache`) is honoured without this loader reading
+     * the env itself.
+     */
+    installRoot?: string;
 }
 /**
  * The npm-loader maintains a single install root per kernel process. For a
  * local entry manifest (`file://` URL or bare path) the root lives at
  * `<entry-manifest-dir>/.telo/npm/`; for an HTTP(S) entry URL it lives in a
  * user-level cache keyed by `sha256(entryUrl)` (see `computeInstallRoot`).
- * Every controller — registry tag or `local_path` — is installed via
- * `npm install <spec>` into this root, then imported from
- * `<root>/node_modules/<pkg>`. This collapses two parallel
- * module realms (kernel-side @telorun/sdk vs. controller-side @telorun/sdk)
- * into one: the kernel's own SDK is wired in as a `file:` dep, npm/pnpm
- * symlink it, and Node's ESM resolver follows the symlink to the same
- * realpath as the kernel — so `Stream` (and any other class-identity-sensitive
- * type) has a single constructor across the process.
+ * Every controller — registry tag or `local_path` — is installed under a
+ * version-scoped npm alias (`npm install <alias>@<spec>`, see `installAlias`)
+ * into this root, then imported from `<root>/node_modules/<alias>`. The alias
+ * encodes `name@version`, so a graph that references one package at two
+ * versions keeps both in the single flat `node_modules` instead of the last
+ * `--save` clobbering the first. This still collapses two parallel module
+ * realms (kernel-side @telorun/sdk vs. controller-side @telorun/sdk) into one:
+ * `@telorun/sdk` is exempt from aliasing and wired in as a `file:` dep under
+ * its real name, npm/pnpm hoist a single copy, and Node's ESM resolver follows
+ * it to the same realpath as the kernel — so `Stream` (and any other
+ * class-identity-sensitive type) has a single constructor across the process.
  *
  * Per-kernel state lives on each `NpmControllerLoader` instance (one is
  * constructed per `ControllerLoader`, which is itself constructed per
@@ -44,6 +55,8 @@ export interface NpmControllerLoaderOptions {
  */
 export declare class NpmControllerLoader {
     private readonly entryUrl?;
+    /** Threaded install root (`<cache-root>/npm`); overrides `computeInstallRoot`. */
+    private readonly installRootOverride?;
     /**
      * Per-process cache of "this controller's package + version is already
      * installed in the root and matches our spec" so concurrent loads of the
@@ -94,11 +107,14 @@ export declare class NpmControllerLoader {
      */
     private seedDepCaches;
     /**
-     * Install one controller spec into the existing root. Single-flight per
-     * spec within the process; cross-process safety is the fs-lock around the
-     * `npm install` call. If the spec is already present in the manifest's
-     * package.json (under `dependencies`), skip — reusing the previous install.
+     * Install one controller into the existing root under its version-scoped
+     * `alias` folder. Single-flight per alias within the process; cross-process
+     * safety is the fs-lock around the `npm install` call. If the alias is
+     * already installed (right version on disk, or a matching `file:` record),
+     * skip — reusing the previous install.
      *
+     * `spec` is the source half of the install (`npm:<name>@<version>` or
+     * `file:<abs>`); the package manager is invoked with `<alias>@<spec>`.
      * `kind` distinguishes a `local_path` source (loader synthesized `file:`
      * spec) from a registry tag. The CLI silences progress for both `cache`
      * and `local`; `npm-install` is the only event surfaced. Folding this
@@ -132,6 +148,28 @@ export declare class NpmControllerLoader {
  * advance to a non-npm candidate.
  */
 declare function computeInstallRoot(entryUrl: string): string;
+/**
+ * Version-qualified install alias for a controller package. The kernel's single
+ * flat install root can hold only one folder per package name, but a manifest
+ * graph may legitimately reference the same package at multiple versions (e.g.
+ * a library pins `@telorun/mcp-client@0.3.1` while the app uses `0.4.0`).
+ * Installing each `name@version` under a distinct npm alias
+ * (`npm install <alias>@npm:<name>@<version>`) lets every version coexist in
+ * one `node_modules`, mirroring the per-(name, version) identity of a Telo
+ * module singleton. `@telorun/sdk` is intentionally NOT routed through here —
+ * it stays under its real name so realm-collapse hoists a single copy across
+ * the kernel/controller boundary (see REALM_COLLAPSE_NAMES).
+ *
+ * The result is a valid unscoped npm package name: the scope `@` is dropped,
+ * `/` becomes `__`, and any character outside npm's name grammar is replaced
+ * with `-`. Because that sanitization is lossy (e.g. build metadata `1.0.0+x`
+ * and prerelease `1.0.0-x` both fold to `1.0.0-x`, and a `__` already in a
+ * package name overlaps the scope separator), the alias ends with a short hash
+ * of the *exact* `name@version` — so two distinct pairs can never collide onto
+ * one folder regardless of how their readable prefixes sanitize. The readable
+ * prefix is kept purely so the install tree is greppable.
+ */
+declare function installAlias(packageName: string, version: string | null): string;
 /**
  * Normalize a `file:` spec to an absolute path so two specs that point at the
  * same source — one absolute (what the loader synthesizes from `local_path`)
@@ -157,6 +195,7 @@ declare function resolveExportTargetValue(target: any, conditions: ReadonlyArray
  * Not part of the kernel's public API — consumers should not import these.
  */
 export declare const __testing__: {
+    installAlias: typeof installAlias;
     normalizeFileSpec: typeof normalizeFileSpec;
     resolvePackageExportTarget: typeof resolvePackageExportTarget;
     resolveExportTargetValue: typeof resolveExportTargetValue;

package/dist/controller-loaders/npm-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"npm-loader.d.ts","sourceRoot":"","sources":["../../src/controller-loaders/npm-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AA4DlD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC;AAoBlF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IAEnC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IAEpD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAE7D;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAC,CAAkB;IAEpC;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAA8B;gBAElC,OAAO,GAAE,0BAA+B;IAI9C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBjE;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;YAUX,sBAAsB;IAqFpC;;;;;;;OAOG;YACW,aAAa;IAU3B;;;;;;;;;;;OAWG;YACW,cAAc;CAuG7B;AA+ND;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2BpD;AAED;;;;;;GAMG;AACH,iBAAS,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAKpE;AA6KD;;;;GAIG;AACH,iBAAe,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOrE;AAED,iBAAS,0BAA0B,CACjC,YAAY,EAAE,GAAG,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAChC,MAAM,GAAG,IAAI,CAIf;AAED,iBAAS,wBAAwB,CAC/B,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,EACjC,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAoBf;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;;;CASvB,CAAC"}
+{"version":3,"file":"npm-loader.d.ts","sourceRoot":"","sources":["../../src/controller-loaders/npm-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AA4DlD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC;AAoBlF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;IAE9C;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IAEpD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAE7D;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAAC,CAAkB;IAEpC;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,CAA8B;gBAElC,OAAO,GAAE,0BAA+B;IAK9C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwBjE;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;YAUX,sBAAsB;IAqFpC;;;;;;;OAOG;YACW,aAAa;IAe3B;;;;;;;;;;;;;;OAcG;YACW,cAAc;CAuH7B;AA+ND;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2BpD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAS,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAMzE;AAED;;;;;;GAMG;AACH,iBAAS,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAKpE;AAkLD;;;;GAIG;AACH,iBAAe,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOrE;AAED,iBAAS,0BAA0B,CACjC,YAAY,EAAE,GAAG,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAChC,MAAM,GAAG,IAAI,CAIf;AAED,iBAAS,wBAAwB,CAC/B,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,EACjC,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAoBf;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;CAUvB,CAAC"}

package/dist/controller-loaders/npm-loader.js

@@ -55,14 +55,17 @@ const LOCK_RETRY_MS = 500;
  * local entry manifest (`file://` URL or bare path) the root lives at
  * `<entry-manifest-dir>/.telo/npm/`; for an HTTP(S) entry URL it lives in a
  * user-level cache keyed by `sha256(entryUrl)` (see `computeInstallRoot`).
- * Every controller — registry tag or `local_path` — is installed via
- * `npm install <spec>` into this root, then imported from
- * `<root>/node_modules/<pkg>`. This collapses two parallel
- * module realms (kernel-side @telorun/sdk vs. controller-side @telorun/sdk)
- * into one: the kernel's own SDK is wired in as a `file:` dep, npm/pnpm
- * symlink it, and Node's ESM resolver follows the symlink to the same
- * realpath as the kernel — so `Stream` (and any other class-identity-sensitive
- * type) has a single constructor across the process.
+ * Every controller — registry tag or `local_path` — is installed under a
+ * version-scoped npm alias (`npm install <alias>@<spec>`, see `installAlias`)
+ * into this root, then imported from `<root>/node_modules/<alias>`. The alias
+ * encodes `name@version`, so a graph that references one package at two
+ * versions keeps both in the single flat `node_modules` instead of the last
+ * `--save` clobbering the first. This still collapses two parallel module
+ * realms (kernel-side @telorun/sdk vs. controller-side @telorun/sdk) into one:
+ * `@telorun/sdk` is exempt from aliasing and wired in as a `file:` dep under
+ * its real name, npm/pnpm hoist a single copy, and Node's ESM resolver follows
+ * it to the same realpath as the kernel — so `Stream` (and any other
+ * class-identity-sensitive type) has a single constructor across the process.
  *
  * Per-kernel state lives on each `NpmControllerLoader` instance (one is
  * constructed per `ControllerLoader`, which is itself constructed per
@@ -100,6 +103,7 @@ export class NpmControllerLoader {
          */
         this.rootDeps = {};
         this.entryUrl = options.entryUrl;
+        this.installRootOverride = options.installRoot;
     }
     async load(purl, baseUri) {
         const parsed = PackageURL.fromString(purl);
@@ -107,10 +111,14 @@ export class NpmControllerLoader {
             throw new Error(`Invalid PURL '${purl}': missing package name`);
         }
         const packageName = parsed.namespace ? `${parsed.namespace}/${parsed.name}` : parsed.name;
+        const version = parsed.version ?? null;
+        // Version-scope the install under an alias so the same package at two
+        // versions can coexist in one flat node_modules (see installAlias).
+        const alias = installAlias(packageName, version);
         const installRoot = await this.ensureInstallRoot();
         const resolved = await resolveInstallSpec(parsed, packageName, baseUri);
-        const source = await this.installPackage(installRoot, packageName, resolved.spec, resolved.kind, parsed.version ?? null);
-        const instance = await loadFromInstall(installRoot, packageName, parsed.subpath ?? null, purl);
+        const source = await this.installPackage(installRoot, alias, resolved.spec, resolved.kind, version);
+        const instance = await loadFromInstall(installRoot, alias, parsed.subpath ?? null, purl);
         return { instance, source };
     }
     /**
@@ -140,7 +148,7 @@ export class NpmControllerLoader {
                 "Kernel.load() records this; CLI: pass the manifest path).");
         }
         const entryUrlStr = this.entryUrl;
-        const installRoot = computeInstallRoot(entryUrlStr);
+        const installRoot = this.installRootOverride ?? computeInstallRoot(entryUrlStr);
         // Build the install-root package.json: kernel-runtime deps as `file:` refs
         // pointing at the kernel-side realpath. Modules declare these names as
         // `peerDependencies`, so npm/pnpm resolve each controller's `import` to the
@@ -211,25 +219,33 @@ export class NpmControllerLoader {
      * reload where the writer is still racing).
      */
     async seedDepCaches(installRoot, dependencies) {
+        // `dependencies` is only the realm-collapse deps (`@telorun/sdk`), keyed by
+        // real `name@spec`. Controllers, by contrast, key `installedSpecs` by their
+        // version-scoped alias in `installPackage`. The two key spaces are
+        // intentionally disjoint — realm-collapse names are wired in here and never
+        // flow through `installPackage`, so an alias and a `name@spec` never clash.
         for (const [name, spec] of Object.entries(dependencies)) {
             this.installedSpecs.add(`${name}@${spec}`);
         }
         this.rootDeps = (await readPackageDeps(installRoot)) ?? { ...dependencies };
     }
     /**
-     * Install one controller spec into the existing root. Single-flight per
-     * spec within the process; cross-process safety is the fs-lock around the
-     * `npm install` call. If the spec is already present in the manifest's
-     * package.json (under `dependencies`), skip — reusing the previous install.
+     * Install one controller into the existing root under its version-scoped
+     * `alias` folder. Single-flight per alias within the process; cross-process
+     * safety is the fs-lock around the `npm install` call. If the alias is
+     * already installed (right version on disk, or a matching `file:` record),
+     * skip — reusing the previous install.
      *
+     * `spec` is the source half of the install (`npm:<name>@<version>` or
+     * `file:<abs>`); the package manager is invoked with `<alias>@<spec>`.
      * `kind` distinguishes a `local_path` source (loader synthesized `file:`
      * spec) from a registry tag. The CLI silences progress for both `cache`
      * and `local`; `npm-install` is the only event surfaced. Folding this
      * decision in here means the caller no longer needs to override the
      * returned source after the fact.
      */
-    async installPackage(installRoot, packageName, spec, kind, requestedVersion) {
-        const cacheKey = `${packageName}@${spec}`;
+    async installPackage(installRoot, alias, spec, kind, requestedVersion) {
+        const cacheKey = alias;
         if (this.installedSpecs.has(cacheKey))
             return "cache";
         const inFlight = this.inFlight.get(cacheKey);
@@ -237,16 +253,19 @@ export class NpmControllerLoader {
             await inFlight;
             return "cache";
         }
-        const targetPath = path.join(installRoot, "node_modules", ...packageName.split("/"));
+        // The package is installed under its version-scoped alias, so its folder
+        // name in node_modules is the alias, not the bare package name.
+        const targetPath = path.join(installRoot, "node_modules", alias);
         // Registry fast path: compare against the installed package's own
-        // `package.json` version field. `rootDeps[packageName]` can't be used
-        // here because npm rewrites registry specs on `--save` — we pass
-        // `@scope/pkg@0.3.4`, npm writes `^0.3.4` — so a string comparison
-        // never matches and every fresh `NpmControllerLoader` (one per
-        // `Telo.Definition.init`) would fall through to a no-op but ~200ms
+        // `package.json` version field. The recorded dep spec can't be used here
+        // because npm rewrites registry specs on `--save` — we pass
+        // `<alias>@npm:@scope/pkg@0.3.4`, npm writes `npm:@scope/pkg@^0.3.4` — so a
+        // string comparison never matches and every fresh `NpmControllerLoader`
+        // (one per `Telo.Definition.init`) would fall through to a no-op but ~200ms
         // `npm install`. Reading the installed package.json sidesteps that
-        // entirely: if the requested PURL version equals what's on disk, we
-        // already have the right thing.
+        // entirely: if the requested PURL version equals what's on disk under this
+        // alias, we already have the right thing. Because the alias encodes the
+        // version, a present alias folder is always the requested version.
         //
         // Ranges (`^1.0.0`, `~2.3.0`) fall through to a real `npm install` —
         // they're rare in PURLs (which typically pin) and a proper range check
@@ -259,30 +278,41 @@ export class NpmControllerLoader {
                 return "cache";
             }
         }
-        // Local (`file:`) spec fast path: consult the in-process snapshot of the
-        // install root's `dependencies` map (seeded by `materializeInstallRoot`).
-        // Normalize because npm rewrites absolute `file:` deps to relative paths
-        // inside the install root's `package.json` — the loader passes the
-        // absolute path, the on-disk record is `file:../../foo`.
-        const cachedSpec = this.rootDeps[packageName];
-        if (cachedSpec !== undefined &&
-            normalizeFileSpec(cachedSpec, installRoot) === normalizeFileSpec(spec, installRoot) &&
-            (await pathExists(targetPath))) {
-            this.installedSpecs.add(cacheKey);
-            return "cache";
+        else {
+            // Local (`file:`) spec fast path: consult the in-process snapshot of the
+            // install root's `dependencies` map (seeded by `materializeInstallRoot`).
+            // Normalize because npm rewrites absolute `file:` deps to relative paths
+            // inside the install root's `package.json` — the loader passes the
+            // absolute path, the on-disk record is `file:../../foo`.
+            const cachedSpec = this.rootDeps[alias];
+            if (cachedSpec !== undefined &&
+                normalizeFileSpec(cachedSpec, installRoot) === normalizeFileSpec(spec, installRoot) &&
+                (await pathExists(targetPath))) {
+                this.installedSpecs.add(cacheKey);
+                return "cache";
+            }
         }
         const work = (async () => {
             await withInstallLock(installRoot, async () => {
                 // Re-check inside the lock: a peer process may have installed the
-                // spec between the fast-path miss and our acquisition. Normalize
-                // the on-disk record to absolute form before comparing — npm
-                // rewrites `file:` deps to be relative to the install root.
-                const lockedSpec = await readDepSpec(installRoot, packageName);
-                if (lockedSpec !== undefined &&
-                    normalizeFileSpec(lockedSpec, installRoot) === normalizeFileSpec(spec, installRoot) &&
-                    (await pathExists(targetPath))) {
-                    this.rootDeps[packageName] = lockedSpec;
-                    return;
+                // spec between the fast-path miss and our acquisition.
+                if (kind === "registry") {
+                    const installedVersion = await readInstalledVersion(targetPath);
+                    if (installedVersion !== null &&
+                        (requestedVersion === null || requestedVersion === installedVersion)) {
+                        return;
+                    }
+                }
+                else {
+                    // Normalize the on-disk record to absolute form before comparing —
+                    // npm rewrites `file:` deps to be relative to the install root.
+                    const lockedSpec = await readDepSpec(installRoot, alias);
+                    if (lockedSpec !== undefined &&
+                        normalizeFileSpec(lockedSpec, installRoot) === normalizeFileSpec(spec, installRoot) &&
+                        (await pathExists(targetPath))) {
+                        this.rootDeps[alias] = lockedSpec;
+                        return;
+                    }
                 }
                 await runPackageManager(installRoot, [
                     "install",
@@ -291,16 +321,19 @@ export class NpmControllerLoader {
                     "--silent",
                     ...PEER_INSTALL_FLAGS,
                     "--save",
-                    spec,
+                    // `<alias>@<source-spec>` installs the package under the alias folder
+                    // (`npm:` for registry, `file:` for local) so multiple versions of
+                    // one package name coexist in the single install root.
+                    `${alias}@${spec}`,
                 ]);
                 // Re-read what npm actually wrote (it normalizes `file:` paths to
                 // be relative to the install root). Caching the spec in its on-disk
                 // form keeps subsequent fast-path comparisons stable.
-                const written = await readDepSpec(installRoot, packageName);
+                const written = await readDepSpec(installRoot, alias);
                 if (written !== undefined)
-                    this.rootDeps[packageName] = written;
+                    this.rootDeps[alias] = written;
                 else
-                    this.rootDeps[packageName] = spec;
+                    this.rootDeps[alias] = spec;
             });
         })();
         this.inFlight.set(cacheKey, work);
@@ -589,6 +622,34 @@ function computeInstallRoot(entryUrl) {
         `loader. Supported schemes: file://, http://, https://, or a bare filesystem path. ` +
         `(entryUrl: ${entryUrl})`);
 }
+/**
+ * Version-qualified install alias for a controller package. The kernel's single
+ * flat install root can hold only one folder per package name, but a manifest
+ * graph may legitimately reference the same package at multiple versions (e.g.
+ * a library pins `@telorun/mcp-client@0.3.1` while the app uses `0.4.0`).
+ * Installing each `name@version` under a distinct npm alias
+ * (`npm install <alias>@npm:<name>@<version>`) lets every version coexist in
+ * one `node_modules`, mirroring the per-(name, version) identity of a Telo
+ * module singleton. `@telorun/sdk` is intentionally NOT routed through here —
+ * it stays under its real name so realm-collapse hoists a single copy across
+ * the kernel/controller boundary (see REALM_COLLAPSE_NAMES).
+ *
+ * The result is a valid unscoped npm package name: the scope `@` is dropped,
+ * `/` becomes `__`, and any character outside npm's name grammar is replaced
+ * with `-`. Because that sanitization is lossy (e.g. build metadata `1.0.0+x`
+ * and prerelease `1.0.0-x` both fold to `1.0.0-x`, and a `__` already in a
+ * package name overlaps the scope separator), the alias ends with a short hash
+ * of the *exact* `name@version` — so two distinct pairs can never collide onto
+ * one folder regardless of how their readable prefixes sanitize. The readable
+ * prefix is kept purely so the install tree is greppable.
+ */
+function installAlias(packageName, version) {
+    const prefix = `${packageName.replace(/^@/, "").replace(/\//g, "__")}__${version ?? "latest"}`
+        .replace(/[^a-zA-Z0-9._-]/g, "-")
+        .toLowerCase();
+    const digest = sha256(`${packageName}@${version ?? ""}`).slice(0, 8);
+    return `${prefix}__${digest}`;
+}
 /**
  * Normalize a `file:` spec to an absolute path so two specs that point at the
  * same source — one absolute (what the loader synthesizes from `local_path`)
@@ -662,7 +723,10 @@ async function resolveInstallSpec(parsed, packageName, baseUri) {
             return { kind: "local", spec: `file:${absolutePath}`, absolutePath };
         }
     }
-    const spec = parsed.version ? `${packageName}@${parsed.version}` : packageName;
+    // `npm:` source spec so the caller can install it under a version-scoped
+    // alias (`<alias>@npm:<name>@<version>`); both versions of one package name
+    // then coexist in the single flat install root.
+    const spec = parsed.version ? `npm:${packageName}@${parsed.version}` : `npm:${packageName}`;
     return { kind: "registry", spec };
 }
 /**
@@ -671,8 +735,10 @@ async function resolveInstallSpec(parsed, packageName, baseUri) {
  * `installPackage` decides whether work is needed, this function is pure
  * resolve-and-import once the tree is in place.
  */
-async function loadFromInstall(installRoot, packageName, subpath, purl) {
-    const packageRoot = path.join(installRoot, "node_modules", ...packageName.split("/"));
+async function loadFromInstall(installRoot, alias, subpath, purl) {
+    // The package lives under its version-scoped alias folder (see installAlias),
+    // not its bare scoped name.
+    const packageRoot = path.join(installRoot, "node_modules", alias);
     const entry = subpath ? `./${subpath}` : ".";
     const entryFile = await resolvePackageEntry(packageRoot, entry);
     // ESM dynamic `import()` accepts either a relative specifier or a `file://`
@@ -810,6 +876,7 @@ function resolveExportTargetValue(target, conditions, depth) {
  * Not part of the kernel's public API — consumers should not import these.
  */
 export const __testing__ = {
+    installAlias,
     normalizeFileSpec,
     resolvePackageExportTarget,
     resolveExportTargetValue,