@telorun/kernel 0.4.1 → 0.5.0

package/dist/controller-loader.d.ts

@@ -1,24 +1,23 @@
 import { ControllerInstance } from "@telorun/sdk";
+import { ControllerPolicy } from "./runtime-registry.js";
+export type { ControllerPolicy } from "./runtime-registry.js";
+/**
+ * Top-level controller-loader dispatcher. Picks a per-scheme sub-loader by
+ * PURL type and applies the resolved selection policy:
+ *
+ *   ControllerLoader.load(candidates, baseUri, policy)
+ *     └─ orderCandidates(candidates, policy)
+ *          ├─ pkg:npm   → NpmControllerLoader
+ *          └─ pkg:cargo → NapiControllerLoader
+ *
+ * Recovery: env-missing failures (`ControllerEnvMissingError`) advance to the
+ * next candidate. User-code failures (`RuntimeError("ERR_CONTROLLER_BUILD_FAILED" | "ERR_CONTROLLER_INVALID")`)
+ * fail hard regardless of remaining candidates.
+ */
 export declare class ControllerLoader {
-    /**
-     * Load controller instance from URI in format:
-     *
-     * <runtime>:<registry>:<path>@<version-spec>
-     */
-    load(purlCandidates: string[], baseUri: string): Promise<ControllerInstance>;
-    private ensureNpmPackageInstalled;
-    private getPackageName;
-    private getInstalledPackageRoot;
-    private getLocalPackageName;
-    private resolvePackageEntry;
-    private resolvePackageExportTarget;
-    private resolveExportTargetValue;
-    /**
-     * For Node.js, resolve .ts paths to their compiled .js equivalents in dist/.
-     * Bun can load .ts directly, so it returns the path unchanged.
-     */
-    private resolveForRuntime;
-    private findInNodeModules;
-    private pathExists;
+    private npmLoader;
+    private napiLoader;
+    load(purlCandidates: string[], baseUri: string, policy?: ControllerPolicy): Promise<ControllerInstance>;
+    private dispatchOne;
 }
 //# sourceMappingURL=controller-loader.d.ts.map

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;AAgBhE,qBAAa,gBAAgB;IAC3B;;;;OAIG;IACG,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAuDpE,yBAAyB;IAmCvC,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,uBAAuB;YAKjB,mBAAmB;YAanB,mBAAmB;IAuEjC,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,wBAAwB;IAgChC;;;OAGG;YACW,iBAAiB;YAqBjB,iBAAiB;YAejB,UAAU;CAQzB"}
+{"version":3,"file":"controller-loader.d.ts","sourceRoot":"","sources":["../src/controller-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAgB,MAAM,cAAc,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAmC,MAAM,uBAAuB,CAAC;AAE1F,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,UAAU,CAA8B;IAE1C,IAAI,CACR,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,CAAC;YA+BhB,WAAW;CAS1B"}

package/dist/controller-loader.js

@@ -1,270 +1,90 @@
 import { RuntimeError } from "@telorun/sdk";
-import { execFile } from "child_process";
-import { createHash } from "crypto";
-import * as fs from "fs/promises";
-import * as os from "os";
-import { PackageURL } from "packageurl-js";
-import * as path from "path";
-import { promisify } from "util";
-const homedir = os.homedir();
-const cacheRoot = process.env.TELO_CACHE_DIR
-    ? path.resolve(process.env.TELO_CACHE_DIR)
-    : path.join(homedir, ".cache", "telo");
-const npmCacheRoot = path.join(cacheRoot, "npm");
-const isBun = typeof globalThis.Bun !== "undefined";
+import { ControllerEnvMissingError, NapiControllerLoader } from "./controller-loaders/napi-loader.js";
+import { NpmControllerLoader } from "./controller-loaders/npm-loader.js";
+import { DEFAULT_POLICY, POLICY_WILDCARD } from "./runtime-registry.js";
+/**
+ * Top-level controller-loader dispatcher. Picks a per-scheme sub-loader by
+ * PURL type and applies the resolved selection policy:
+ *
+ *   ControllerLoader.load(candidates, baseUri, policy)
+ *     └─ orderCandidates(candidates, policy)
+ *          ├─ pkg:npm   → NpmControllerLoader
+ *          └─ pkg:cargo → NapiControllerLoader
+ *
+ * Recovery: env-missing failures (`ControllerEnvMissingError`) advance to the
+ * next candidate. User-code failures (`RuntimeError("ERR_CONTROLLER_BUILD_FAILED" | "ERR_CONTROLLER_INVALID")`)
+ * fail hard regardless of remaining candidates.
+ */
 export class ControllerLoader {
-    /**
-     * Load controller instance from URI in format:
-     *
-     * <runtime>:<registry>:<path>@<version-spec>
-     */
-    async load(purlCandidates, baseUri) {
+    constructor() {
+        this.npmLoader = new NpmControllerLoader();
+        this.napiLoader = new NapiControllerLoader();
+    }
+    async load(purlCandidates, baseUri, policy) {
         if (!purlCandidates || purlCandidates.length === 0) {
             throw new RuntimeError("ERR_CONTROLLER_NOT_FOUND", "Missing controller PURL candidates");
         }
-        const purl = purlCandidates.find((p) => p.startsWith("pkg:npm"));
-        if (!purl) {
-            throw new RuntimeError("ERR_CONTROLLER_NOT_FOUND", "Controller PURL candidates not applicable");
-        }
-        const [type, namespace, name, versionSpec, qualifiers, entry] = PackageURL.parseString(purl);
-        const localPath = qualifiers?.get("local_path");
-        const cacheKey = createHash("sha256").update(purlCandidates[0]).digest("hex").slice(0, 12);
-        const installDir = path.join(npmCacheRoot, cacheKey);
-        let packageRoot;
-        const isLocalManifest = baseUri && !baseUri.startsWith("http://") && !baseUri.startsWith("https://");
-        if (localPath && isLocalManifest) {
-            const baseUriPath = baseUri.startsWith("file://") ? baseUri.slice("file://".length) : baseUri;
-            const manifestDir = path.dirname(baseUriPath);
-            const resolvedLocalPath = path.resolve(manifestDir, localPath);
-            if (await this.pathExists(resolvedLocalPath)) {
-                packageRoot = resolvedLocalPath;
-            }
-            else {
-                const nodeModulesPath = await this.findInNodeModules(`${namespace}/${name}`);
-                if (nodeModulesPath) {
-                    packageRoot = nodeModulesPath;
-                }
-                else {
-                    await this.ensureNpmPackageInstalled(installDir, `${namespace}/${name}@${versionSpec}`);
-                    packageRoot = this.getInstalledPackageRoot(installDir, `${namespace}/${name}`);
-                }
-            }
-        }
-        else {
-            const nodeModulesPath = await this.findInNodeModules(`${namespace}/${name}`);
-            if (nodeModulesPath) {
-                packageRoot = nodeModulesPath;
-            }
-            else {
-                await this.ensureNpmPackageInstalled(installDir, `${namespace}/${name}@${versionSpec}`);
-                packageRoot = this.getInstalledPackageRoot(installDir, `${namespace}/${name}`);
-            }
-        }
-        const entryFile = await this.resolvePackageEntry(packageRoot, entry ? `./${entry}` : ".");
-        const instance = await import(entryFile);
-        if (!instance || (!instance.create && !instance.register)) {
-            throw new Error(`Invalid controller loaded from "${purlCandidates[0]}": missing create or register function`);
-        }
-        return instance;
-    }
-    async ensureNpmPackageInstalled(installDir, packageSpec) {
-        const packageName = this.getPackageName(packageSpec.startsWith(".") || path.isAbsolute(packageSpec)
-            ? await this.getLocalPackageName(packageSpec)
-            : packageSpec);
-        const packageRoot = this.getInstalledPackageRoot(installDir, packageName);
-        const packageJsonPath = path.join(packageRoot, "package.json");
-        if (await this.pathExists(packageJsonPath)) {
-            return;
-        }
-        await fs.mkdir(installDir, { recursive: true });
-        const rootPackageJson = path.join(installDir, "package.json");
-        if (!(await this.pathExists(rootPackageJson))) {
-            await fs.writeFile(rootPackageJson, JSON.stringify({ name: "telo-cache", private: true }, null, 2));
-        }
-        const execFileAsync = promisify(execFile);
-        const args = [
-            "install",
-            "--no-audit",
-            "--no-fund",
-            "--silent",
-            "--prefix",
-            installDir,
-            packageSpec,
-        ];
-        await execFileAsync("npm", args);
-    }
-    getPackageName(packageSpec) {
-        if (packageSpec.startsWith("@")) {
-            const lastAt = packageSpec.lastIndexOf("@");
-            return lastAt > 0 ? packageSpec.slice(0, lastAt) : packageSpec;
-        }
-        const [name] = packageSpec.split("@");
-        return name;
-    }
-    getInstalledPackageRoot(installDir, packageName) {
-        const nameParts = packageName.split("/");
-        return path.join(installDir, "node_modules", ...nameParts);
-    }
-    async getLocalPackageName(packagePath) {
-        const packageJsonPath = path.join(packagePath, "package.json");
-        if (!(await this.pathExists(packageJsonPath))) {
-            throw new Error(`Local package missing package.json: ${packagePath}`);
-        }
-        const content = await fs.readFile(packageJsonPath, "utf8");
-        const parsed = JSON.parse(content);
-        if (!parsed?.name) {
-            throw new Error(`Local package missing name in package.json: ${packagePath}`);
-        }
-        return parsed.name;
-    }
-    async resolvePackageEntry(packageRoot, entry, packageName) {
-        const packageJsonPath = path.join(packageRoot, "package.json");
-        let resolvedPackageName = packageName;
-        let packageJson = null;
-        if (!resolvedPackageName && (await this.pathExists(packageJsonPath))) {
-            const content = await fs.readFile(packageJsonPath, "utf8");
-            try {
-                packageJson = JSON.parse(content);
-                resolvedPackageName = packageJson?.name;
-            }
-            catch {
-                resolvedPackageName = packageName;
-            }
+        const effectivePolicy = policy ?? DEFAULT_POLICY;
+        const ordered = orderCandidates(purlCandidates, effectivePolicy);
+        if (ordered.length === 0) {
+            throw new RuntimeError("ERR_CONTROLLER_NOT_FOUND", `No controllers match runtime selection [${effectivePolicy.load.join(", ")}]; declared: ${purlCandidates.join(", ")}`);
         }
-        else if (await this.pathExists(packageJsonPath)) {
+        const errors = [];
+        for (const purl of ordered) {
             try {
-                packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+                return await this.dispatchOne(purl, baseUri);
             }
-            catch {
-                packageJson = null;
-            }
-        }
-        const entryValue = entry.trim();
-        const exportTarget = this.resolvePackageExportTarget(packageJson?.exports, entryValue);
-        if (exportTarget) {
-            const resolved = path.resolve(packageRoot, exportTarget);
-            if (await this.pathExists(resolved)) {
-                return this.resolveForRuntime(resolved, packageRoot);
-            }
-            if (!path.extname(resolved)) {
-                const withJs = `${resolved}.js`;
-                if (await this.pathExists(withJs)) {
-                    return withJs;
+            catch (err) {
+                if (err instanceof ControllerEnvMissingError) {
+                    errors.push(`${purl}: ${err.message}`);
+                    continue;
                 }
+                throw err;
             }
         }
-        if ((entryValue === "." || entryValue === "./") && packageJson) {
-            const mainFields = ["module", "main"];
-            for (const field of mainFields) {
-                const target = packageJson[field];
-                if (typeof target === "string") {
-                    const resolved = path.resolve(packageRoot, target);
-                    if (await this.pathExists(resolved)) {
-                        return this.resolveForRuntime(resolved, packageRoot);
-                    }
-                    if (!path.extname(resolved)) {
-                        const withJs = `${resolved}.js`;
-                        if (await this.pathExists(withJs)) {
-                            return withJs;
-                        }
-                    }
-                }
-            }
-        }
-        const directPath = path.resolve(packageRoot, entryValue);
-        if (await this.pathExists(directPath)) {
-            return this.resolveForRuntime(directPath, packageRoot);
-        }
-        if (!path.extname(directPath)) {
-            const withJs = `${directPath}.js`;
-            if (await this.pathExists(withJs)) {
-                return withJs;
-            }
-        }
-        throw new Error(`Controller entry "${entryValue}" could not be resolved in ${packageRoot}`);
-    }
-    resolvePackageExportTarget(exportsField, entry) {
-        if (!exportsField) {
-            return null;
-        }
-        const key = entry === "." || entry === "./" ? "." : entry;
-        const target = exportsField[key];
-        return this.resolveExportTargetValue(target);
+        throw new RuntimeError("ERR_CONTROLLER_NOT_FOUND", `No controller resolved. Tried ${ordered.length} candidate(s):\n${errors.join("\n")}`);
     }
-    resolveExportTargetValue(target) {
-        if (!target) {
-            return null;
+    async dispatchOne(purl, baseUri) {
+        if (purl.startsWith("pkg:npm")) {
+            return this.npmLoader.load(purl, baseUri);
         }
-        if (typeof target === "string") {
-            return target;
+        if (purl.startsWith("pkg:cargo")) {
+            return this.napiLoader.load(purl, baseUri);
         }
-        if (Array.isArray(target)) {
-            for (const item of target) {
-                const resolved = this.resolveExportTargetValue(item);
-                if (resolved) {
-                    return resolved;
+        throw new ControllerEnvMissingError(`Unsupported PURL scheme: ${purl}`);
+    }
+}
+function getPurlType(purl) {
+    const slashIdx = purl.indexOf("/", purl.indexOf(":") + 1);
+    return slashIdx === -1 ? purl : purl.slice(0, slashIdx);
+}
+function orderCandidates(candidates, policy) {
+    const result = [];
+    const seen = new Set();
+    const explicitTypes = new Set(policy.load.filter((t) => t !== POLICY_WILDCARD));
+    for (const entry of policy.load) {
+        if (entry === POLICY_WILDCARD) {
+            for (const candidate of candidates) {
+                if (seen.has(candidate))
+                    continue;
+                const type = getPurlType(candidate);
+                if (!explicitTypes.has(type)) {
+                    result.push(candidate);
+                    seen.add(candidate);
                 }
             }
-            return null;
         }
-        if (typeof target === "object") {
-            const preferredKeys = isBun
-                ? ["bun", "import", "default", "require"]
-                : ["import", "default", "require"];
-            for (const key of preferredKeys) {
-                if (target[key]) {
-                    const resolved = this.resolveExportTargetValue(target[key]);
-                    if (resolved) {
-                        return resolved;
-                    }
+        else {
+            for (const candidate of candidates) {
+                if (seen.has(candidate))
+                    continue;
+                if (getPurlType(candidate) === entry) {
+                    result.push(candidate);
+                    seen.add(candidate);
                 }
             }
         }
-        return null;
-    }
-    /**
-     * For Node.js, resolve .ts paths to their compiled .js equivalents in dist/.
-     * Bun can load .ts directly, so it returns the path unchanged.
-     */
-    async resolveForRuntime(resolvedPath, packageRoot) {
-        if (isBun || !resolvedPath.endsWith(".ts")) {
-            return resolvedPath;
-        }
-        // Try dist/ equivalent: src/foo.ts -> dist/foo.js
-        const relative = path.relative(packageRoot, resolvedPath);
-        const distEquivalent = path.resolve(packageRoot, relative.replace(/^src\//, "dist/").replace(/\.ts$/, ".js"));
-        if (await this.pathExists(distEquivalent)) {
-            return distEquivalent;
-        }
-        // Fallback: same location but .js
-        const jsPath = resolvedPath.replace(/\.ts$/, ".js");
-        if (await this.pathExists(jsPath)) {
-            return jsPath;
-        }
-        return resolvedPath;
-    }
-    async findInNodeModules(packageName) {
-        const nameParts = packageName.split("/");
-        const candidates = [
-            path.join(process.cwd(), "node_modules", ...nameParts),
-            path.join(process.cwd(), "node_modules", ".pnpm", "node_modules", ...nameParts),
-        ];
-        for (const candidate of candidates) {
-            const packageJsonPath = path.join(candidate, "package.json");
-            if (await this.pathExists(packageJsonPath)) {
-                return candidate;
-            }
-        }
-        return null;
-    }
-    async pathExists(filePath) {
-        try {
-            await fs.access(filePath);
-            return true;
-        }
-        catch {
-            return false;
-        }
     }
+    return result;
 }
 //# sourceMappingURL=controller-loader.js.map

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/napi-loader.d.ts

@@ -0,0 +1,27 @@
+import { ControllerInstance } from "@telorun/sdk";
+/**
+ * Recoverable resolution failure — the loader could not find the artifact in the
+ * environment (missing rustc, missing local_path, missing prebuilt dylib in dist
+ * mode). The dispatcher may try the next candidate when wildcard fallback is
+ * enabled. Distinguished from `RuntimeError("ERR_CONTROLLER_BUILD_FAILED" | …)`
+ * which is non-recoverable: those mean user code is broken and must surface.
+ */
+export declare class ControllerEnvMissingError extends Error {
+    readonly _envMissing: true;
+    constructor(message: string);
+}
+export declare class NapiControllerLoader {
+    /**
+     * Resolve a `pkg:cargo/...` PURL to a controller module instance by building
+     * the crate and loading the resulting native addon.
+     *
+     * Dev mode (local_path qualifier present): probe rustc, run `cargo build
+     * --release`, locate the dylib via `cargo metadata`, copy to
+     * `<libname>.node`, load via createRequire. Cached on success.
+     *
+     * Distribution mode (no local_path): out of scope for the PoC; the hook is
+     * left in place so the dispatcher reports env-missing and falls through.
+     */
+    load(purl: string, baseUri: string): Promise<ControllerInstance>;
+}
+//# sourceMappingURL=napi-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"napi-loader.d.ts","sourceRoot":"","sources":["../../src/controller-loaders/napi-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAgB,MAAM,cAAc,CAAC;AAWhE;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,WAAW,EAAG,IAAI,CAAU;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAmBD,qBAAa,oBAAoB;IAC/B;;;;;;;;;;OAUG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAwFvE"}

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

@@ -0,0 +1,158 @@
+import { RuntimeError } from "@telorun/sdk";
+import { execFile } from "child_process";
+import * as fs from "fs/promises";
+import { createRequire } from "module";
+import { PackageURL } from "packageurl-js";
+import * as path from "path";
+import { promisify } from "util";
+const execFileAsync = promisify(execFile);
+const requireFromHere = createRequire(import.meta.url);
+/**
+ * Recoverable resolution failure — the loader could not find the artifact in the
+ * environment (missing rustc, missing local_path, missing prebuilt dylib in dist
+ * mode). The dispatcher may try the next candidate when wildcard fallback is
+ * enabled. Distinguished from `RuntimeError("ERR_CONTROLLER_BUILD_FAILED" | …)`
+ * which is non-recoverable: those mean user code is broken and must surface.
+ */
+export class ControllerEnvMissingError extends Error {
+    constructor(message) {
+        super(message);
+        this._envMissing = true;
+        this.name = "ControllerEnvMissingError";
+    }
+}
+/**
+ * Process-lifetime cache of resolved native modules keyed by the realpath of
+ * the crate directory. The first call for a given crate does the cargo build,
+ * dylib rename, and `require()` work; subsequent calls (e.g. a second kernel
+ * registering the same controller, or two manifests reaching the crate via
+ * different — possibly symlinked — paths) skip straight to the cached module.
+ *
+ * Beyond the obvious cost saving, this is load-bearing for Node compatibility:
+ * `fs.copyFile` overwriting a `.node` file that Node has already mmapped, plus
+ * the secondary `cargo metadata` / build invocations, can leave Node's native
+ * addon machinery in a state where finalize callbacks for class instances
+ * created in a previous kernel race and segfault. Keying on the canonical
+ * crate path (not on the caller's baseUri) ensures two distinct paths that
+ * point at the same crate share one cache entry.
+ */
+const _napiModuleCache = new Map();
+export class NapiControllerLoader {
+    /**
+     * Resolve a `pkg:cargo/...` PURL to a controller module instance by building
+     * the crate and loading the resulting native addon.
+     *
+     * Dev mode (local_path qualifier present): probe rustc, run `cargo build
+     * --release`, locate the dylib via `cargo metadata`, copy to
+     * `<libname>.node`, load via createRequire. Cached on success.
+     *
+     * Distribution mode (no local_path): out of scope for the PoC; the hook is
+     * left in place so the dispatcher reports env-missing and falls through.
+     */
+    async load(purl, baseUri) {
+        const [, , name, , qualifiers] = PackageURL.parseString(purl);
+        const localPath = qualifiers?.get("local_path");
+        const isLocalManifest = baseUri && !baseUri.startsWith("http://") && !baseUri.startsWith("https://");
+        if (!localPath || !isLocalManifest) {
+            throw new ControllerEnvMissingError(`pkg:cargo distribution-mode resolution is not implemented for the PoC; supply ?local_path=...`);
+        }
+        const baseUriPath = baseUri.startsWith("file://") ? baseUri.slice("file://".length) : baseUri;
+        const manifestDir = path.dirname(baseUriPath);
+        const cratePath = path.resolve(manifestDir, localPath);
+        if (!(await pathExists(cratePath))) {
+            throw new ControllerEnvMissingError(`pkg:cargo local_path does not exist: ${cratePath}`);
+        }
+        // Key the cache on the canonical crate location (realpath) — two manifests
+        // that reach the same crate via different baseUris (e.g. through symlinked
+        // workspace paths) must share one cache entry. A miss here would re-run
+        // cargo build and `fs.copyFile` over an already-mmapped `.node`, which
+        // can leave napi finalize callbacks racing and crash Node.
+        const canonicalCratePath = await fs.realpath(cratePath);
+        const cacheKey = canonicalCratePath;
+        const cached = _napiModuleCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        try {
+            await execFileAsync("rustc", ["--version"]);
+        }
+        catch {
+            throw new ControllerEnvMissingError("rustc not found on PATH");
+        }
+        try {
+            // Plain `cargo build --release` — no `--features` flag. The SDK's
+            // `default = ["napi"]` selects the napi backend transitively, so the
+            // controller crate's Cargo.toml stays free of any `[features]` block
+            // or napi-rs deps. A future Rust kernel passes
+            // `--no-default-features --features native` here instead.
+            await execFileAsync("cargo", ["build", "--release"], {
+                cwd: cratePath,
+                maxBuffer: 32 * 1024 * 1024,
+            });
+        }
+        catch (err) {
+            const stderr = err?.stderr ? `\n${err.stderr}` : "";
+            throw new RuntimeError("ERR_CONTROLLER_BUILD_FAILED", `cargo build failed for ${cratePath}:${stderr}`);
+        }
+        const { targetDir, libName } = await resolveCrateMetadata(cratePath, name ?? "");
+        const dylibPath = await findDylib(targetDir, libName);
+        if (!dylibPath) {
+            throw new RuntimeError("ERR_CONTROLLER_BUILD_FAILED", `cargo build succeeded but no cdylib found for ${libName} under ${path.join(targetDir, "release")}/`);
+        }
+        const nodePath = path.join(path.dirname(dylibPath), `${libName}.node`);
+        await fs.copyFile(dylibPath, nodePath);
+        let module;
+        try {
+            module = requireFromHere(nodePath);
+        }
+        catch (err) {
+            throw new RuntimeError("ERR_CONTROLLER_INVALID", `Failed to load native addon ${nodePath}: ${err.message}`);
+        }
+        if (!module || (!module.create && !module.register)) {
+            throw new RuntimeError("ERR_CONTROLLER_INVALID", `pkg:cargo controller at ${nodePath} exports neither create nor register`);
+        }
+        _napiModuleCache.set(cacheKey, module);
+        return module;
+    }
+}
+async function resolveCrateMetadata(cratePath, fallbackName) {
+    const result = await execFileAsync("cargo", [
+        "metadata",
+        "--format-version",
+        "1",
+        "--manifest-path",
+        path.join(cratePath, "Cargo.toml"),
+        "--no-deps",
+    ], { maxBuffer: 32 * 1024 * 1024 });
+    const metadata = JSON.parse(result.stdout);
+    const cratePackage = metadata.packages?.find((p) => p.manifest_path === path.join(cratePath, "Cargo.toml"));
+    const packageName = cratePackage?.name ?? fallbackName;
+    return {
+        targetDir: metadata.target_directory,
+        libName: packageName.replace(/-/g, "_"),
+    };
+}
+async function findDylib(targetDir, libName) {
+    const releaseDir = path.join(targetDir, "release");
+    const candidates = [
+        path.join(releaseDir, `lib${libName}.so`),
+        path.join(releaseDir, `lib${libName}.dylib`),
+        path.join(releaseDir, `${libName}.dll`),
+    ];
+    for (const candidate of candidates) {
+        if (await pathExists(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+async function pathExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=napi-loader.js.map

package/dist/controller-loaders/napi-loader.js.map

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

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

@@ -0,0 +1,20 @@
+import { ControllerInstance } from "@telorun/sdk";
+export declare class NpmControllerLoader {
+    /**
+     * Resolve a `pkg:npm/...` PURL to a controller module instance. Tries, in order:
+     * a relative `local_path` qualifier, the workspace's `node_modules`, and finally
+     * an isolated install under `~/.cache/telo/npm/<hash>`.
+     */
+    load(purl: string, baseUri: string): Promise<ControllerInstance>;
+    private ensureNpmPackageInstalled;
+    private getPackageName;
+    private getInstalledPackageRoot;
+    private getLocalPackageName;
+    private resolvePackageEntry;
+    private resolvePackageExportTarget;
+    private resolveExportTargetValue;
+    private resolveForRuntime;
+    private findInNodeModules;
+    private pathExists;
+}
+//# sourceMappingURL=npm-loader.d.ts.map

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

@@ -0,0 +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;AAgBlD,qBAAa,mBAAmB;IAC9B;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;YA6CxD,yBAAyB;IAmCvC,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,uBAAuB;YAKjB,mBAAmB;YAanB,mBAAmB;IAuEjC,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,wBAAwB;YAgClB,iBAAiB;YAmBjB,iBAAiB;YAejB,UAAU;CAQzB"}