@nodetool-ai/cli 0.8.3 → 0.8.4-a24.1

package/dist/packs/installed.d.ts

@@ -0,0 +1,36 @@
+import { type MissingPackError, type NodeCatalogIndex } from "@nodetool-ai/node-catalog";
+import { type InstallMode } from "./mode.js";
+export interface InstalledPackage {
+    readonly npm: string;
+    readonly version: string;
+    readonly packageRoot: string;
+    readonly realPackageRoot: string;
+}
+export interface InstalledPack extends InstalledPackage {
+    readonly id: string;
+    readonly providedPackages: readonly InstalledPackage[];
+}
+export interface WrongVersionPack {
+    readonly id: string;
+    readonly npm: string;
+    readonly version: string;
+    readonly expectedVersion: string;
+    readonly packageRoot: string;
+}
+export interface InvalidInstalledPackage {
+    readonly id: string;
+    readonly npm: string;
+    readonly packageRoot: string;
+    readonly reason: string;
+}
+export interface InstalledPackSnapshot {
+    readonly mode: InstallMode;
+    readonly packs: readonly InstalledPack[];
+    readonly wrongVersions: readonly WrongVersionPack[];
+    readonly invalidPackages: readonly InvalidInstalledPackage[];
+}
+/** Read the scoped tree once. Hosts retain this snapshot until an explicit reload. */
+export declare function readInstalledPacks(mode: InstallMode, catalog?: NodeCatalogIndex): InstalledPackSnapshot;
+/** Apply CLI layout guidance without changing library or server defaults. */
+export declare function createMissingPackErrorForMode(mode: InstallMode, packId: string, nodeTypes?: readonly string[]): MissingPackError;
+//# sourceMappingURL=installed.d.ts.map

package/dist/packs/installed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed.d.ts","sourceRoot":"","sources":["../../src/packs/installed.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,gBAAgB,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpD,QAAQ,CAAC,eAAe,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC9D;AAID,sFAAsF;AACtF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,gBAAqC,GAC7C,qBAAqB,CAwEvB;AAED,6EAA6E;AAC7E,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,gBAAgB,CAElB"}

package/dist/packs/installed.js

@@ -0,0 +1,87 @@
+import { readFileSync, readdirSync, realpathSync } from "node:fs";
+import { posix, win32 } from "node:path";
+import { z } from "zod";
+import { createMissingPackError, readCatalogIndex } from "@nodetool-ai/node-catalog";
+import { installDetailsForMode } from "./mode.js";
+const installedManifestSchema = z.object({ name: z.string(), version: z.string().min(1) });
+/** Read the scoped tree once. Hosts retain this snapshot until an explicit reload. */
+export function readInstalledPacks(mode, catalog = readCatalogIndex()) {
+    if (mode.coreVersion !== catalog.coreVersion) {
+        throw new Error(`Node catalog core version ${catalog.coreVersion} differs from CLI core version ${mode.coreVersion}`);
+    }
+    const packs = [];
+    const wrongVersions = [];
+    const invalidPackages = [];
+    if (!mode.nodeModulesRoot) {
+        return { mode, packs, wrongVersions, invalidPackages };
+    }
+    const paths = mode.pathStyle === "win32" ? win32 : posix;
+    const scope = paths.join(mode.nodeModulesRoot, "@nodetool-ai");
+    let names;
+    try {
+        names = readdirSync(scope).sort();
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return { mode, packs, wrongVersions, invalidPackages };
+        }
+        throw error;
+    }
+    const byNpm = new Map();
+    for (const pack of catalog.packs) {
+        for (const npm of [pack.npm.name, ...pack.provides]) {
+            byNpm.set(npm, pack);
+        }
+    }
+    const installed = new Map();
+    const rejected = new Set();
+    for (const name of names) {
+        const npm = `@nodetool-ai/${name}`;
+        const pack = byNpm.get(npm);
+        if (!pack) {
+            continue;
+        }
+        const packageRoot = paths.join(scope, name);
+        try {
+            const manifest = installedManifestSchema.parse(JSON.parse(readFileSync(paths.join(packageRoot, "package.json"), "utf8")));
+            if (manifest.name !== npm) {
+                throw new Error(`Expected package name ${npm}, found ${manifest.name}`);
+            }
+            if (manifest.version !== mode.coreVersion) {
+                wrongVersions.push({ id: pack.id, npm, version: manifest.version, expectedVersion: mode.coreVersion, packageRoot });
+                rejected.add(pack.id);
+                continue;
+            }
+            installed.set(npm, { npm, version: manifest.version, packageRoot, realPackageRoot: realpathSync(packageRoot) });
+        }
+        catch (error) {
+            invalidPackages.push({ id: pack.id, npm, packageRoot, reason: error instanceof Error ? error.message : String(error) });
+            rejected.add(pack.id);
+        }
+    }
+    for (const pack of catalog.packs) {
+        const primary = installed.get(pack.npm.name);
+        if (!primary || rejected.has(pack.id)) {
+            continue;
+        }
+        const missingCompanions = pack.provides.filter((npm) => !installed.has(npm));
+        if (missingCompanions.length > 0) {
+            for (const npm of missingCompanions) {
+                invalidPackages.push({ id: pack.id, npm, packageRoot: paths.join(mode.nodeModulesRoot, npm), reason: `Missing companion package for node pack ${pack.id}` });
+            }
+            continue;
+        }
+        const providedPackages = pack.provides.flatMap((npm) => {
+            const companion = installed.get(npm);
+            return companion ? [companion] : [];
+        });
+        packs.push({ id: pack.id, ...primary, providedPackages });
+    }
+    packs.sort((a, b) => a.id.localeCompare(b.id));
+    return { mode, packs, wrongVersions, invalidPackages };
+}
+/** Apply CLI layout guidance without changing library or server defaults. */
+export function createMissingPackErrorForMode(mode, packId, nodeTypes = []) {
+    return createMissingPackError(packId, nodeTypes, installDetailsForMode(mode));
+}
+//# sourceMappingURL=installed.js.map

package/dist/packs/installed.js.map

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

package/dist/packs/installer-load-check.d.ts

@@ -0,0 +1,4 @@
+import { type NodeCatalogIndex, type CatalogNode } from "@nodetool-ai/node-catalog";
+import { type InstalledPackSnapshot } from "./installed.js";
+export declare function verifyPackLoads(snapshot: InstalledPackSnapshot, catalog: NodeCatalogIndex, nodes: readonly CatalogNode[], ids: readonly string[]): Promise<void>;
+//# sourceMappingURL=installer-load-check.d.ts.map

package/dist/packs/installer-load-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer-load-check.d.ts","sourceRoot":"","sources":["../../src/packs/installer-load-check.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE1J,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGhF,wBAAsB,eAAe,CAAC,QAAQ,EAAE,qBAAqB,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBtK"}

package/dist/packs/installer-load-check.js

@@ -0,0 +1,52 @@
+import { createRequire } from "node:module";
+import { realpath } from "node:fs/promises";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+import { readCatalogIndex, importPack, readCatalogNodes, setPackLoaderContext } from "@nodetool-ai/node-catalog";
+import { NodeRegistry, isCallable } from "@nodetool-ai/node-sdk";
+import { readInstalledPacks } from "./installed.js";
+import { loaderContextForSnapshot } from "./host.js";
+export async function verifyPackLoads(snapshot, catalog, nodes, ids) {
+    setPackLoaderContext(loaderContextForSnapshot(snapshot));
+    const coreSdk = await realpath(createRequire(join(snapshot.mode.cliRoot, "package.json")).resolve("@nodetool-ai/node-sdk"));
+    for (const id of ids) {
+        const pack = catalog.packs.find((entry) => entry.id === id);
+        const installed = snapshot.packs.find((entry) => entry.id === id);
+        if (!pack || !installed) {
+            throw new Error(`Load check pack unavailable: ${id}`);
+        }
+        for (const entry of [installed, ...installed.providedPackages]) {
+            const sdk = await realpath(createRequire(join(entry.realPackageRoot, "package.json")).resolve("@nodetool-ai/node-sdk"));
+            if (sdk !== coreSdk) {
+                throw new Error(`Pack resolves another node-sdk: ${entry.npm}`);
+            }
+        }
+        const module = await importPack(id);
+        const registrar = z.object({
+            [pack.registrar]: z.custom(isCallable)
+        }).parse(module)[pack.registrar];
+        const registry = new NodeRegistry();
+        registry.registerPackage(id, registrar);
+        const actual = [...registry.list()].sort();
+        const expected = nodes.filter((node) => node.pack === id).map((node) => node.node_type).sort();
+        if (JSON.stringify(actual) !== JSON.stringify(expected)) {
+            throw new Error(`Pack owned node types differ from catalog: ${id}`);
+        }
+    }
+}
+/** Fresh child entry. Parent integrity verification must succeed before spawning this process. */
+async function main() {
+    const [cliRoot, installRoot, ...ids] = process.argv.slice(2);
+    if (!cliRoot || !installRoot) {
+        throw new Error("Pack load check requires CLI and install roots");
+    }
+    const catalog = readCatalogIndex();
+    const mode = { kind: "local", cliRoot, installRoot, nodeModulesRoot: join(installRoot, "node_modules"),
+        coreVersion: catalog.coreVersion, pathStyle: process.platform === "win32" ? "win32" : "posix" };
+    await verifyPackLoads(readInstalledPacks(mode, catalog), catalog, readCatalogNodes(), ids);
+}
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+    main().catch((error) => { console.error(error); process.exitCode = 1; });
+}
+//# sourceMappingURL=installer-load-check.js.map

package/dist/packs/installer-load-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer-load-check.js","sourceRoot":"","sources":["../../src/packs/installer-load-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAA2C,MAAM,2BAA2B,CAAC;AAC1J,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAA8B,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAA+B,EAAE,OAAyB,EAAE,KAA6B,EAAE,GAAsB;IACrJ,oBAAoB,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC5H,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAC;QAAC,CAAC;QACnF,KAAK,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC/D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC;YACxH,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;gBAAC,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YAAC,CAAC;QAC3F,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;YACzB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,CAAmC,UAAU,CAAC;SACzE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/F,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,8CAA8C,EAAE,EAAE,CAAC,CAAC;QAAC,CAAC;IACnI,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAAC,CAAC;IACpG,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,OAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC;QAC7G,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAgB,CAAC,CAAC,CAAC,OAAgB,EAAE,CAAC;IACpH,MAAM,eAAe,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,GAAG,CAAC,CAAC;AAC7F,CAAC;AACD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACvD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/dist/packs/installer.d.ts

@@ -0,0 +1,16 @@
+import { installerNpmVersion, runInstallerNpm } from "../npm-runner.js";
+import { type InstallPacksRequest, type DesiredPackState } from "./install-selection.js";
+import { type InstallAuthorization } from "../commands/pack-install-authorization.js";
+import type { InstallMode } from "./mode.js";
+export type { DesiredPackState, InstallPacksRequest } from "./install-selection.js";
+export interface InstallerOperations {
+    readonly npmVersion: typeof installerNpmVersion;
+    readonly npm: typeof runInstallerNpm;
+    readonly loadCheck: (mode: InstallMode, packs: readonly string[], signal?: AbortSignal) => Promise<void>;
+}
+export declare const DEFAULT_INSTALLER_OPERATIONS: InstallerOperations;
+/** Additive install transaction. Requires a live command authorization. */
+export declare function installPacks(request: InstallPacksRequest, authorization: InstallAuthorization, operations?: InstallerOperations): Promise<DesiredPackState>;
+/** Repair verifies the current pinned cohort and explicitly restores missing desired entries. */
+export declare function repairPackInstallation(request: InstallPacksRequest, authorization: InstallAuthorization, operations?: InstallerOperations): Promise<DesiredPackState>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/packs/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/packs/installer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAA+C,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACtI,OAAO,EAAmE,KAAK,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAMvJ,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7C,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACpF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,OAAO,mBAAmB,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,OAAO,eAAe,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1G;AAiBD,eAAO,MAAM,4BAA4B,EAAE,mBAE1C,CAAC;AAEF,2EAA2E;AAC3E,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,oBAAoB,EAAE,UAAU,GAAE,mBAAkD,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE/L;AAED,iGAAiG;AACjG,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,oBAAoB,EAAE,UAAU,GAAE,mBAAkD,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEzM"}

package/dist/packs/installer.js

@@ -0,0 +1,142 @@
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { acquireInstallLock } from "../install-lock.js";
+import { installerNpmVersion, runInstallerNpm } from "../npm-runner.js";
+import { prepareInstallSelection, expandCatalogPacks } from "./install-selection.js";
+import { assertLiveInstallAuthorization, assertInstallAuthorizationScope } from "../commands/pack-install-authorization.js";
+import { prepareTreeVerification } from "./install-verification.js";
+import { captureInstallManifests } from "./install-manifests.js";
+import { normalizeGlobalBootstrap } from "./global-bootstrap.js";
+import { normalizeOwnedPackReplay } from "./owned-replay-plan.js";
+import { writeDesiredState } from "./install-state.js";
+import { snapshotInstallTree, installTreeRestored, parseInstallPlan, assertAdditivePlan, assertTreePins, assertSharedIdentities, removeSnapshotAdditions } from "./install-tree.js";
+function childLoadCheck(mode, packs, signal) {
+    if (mode.kind !== "global" && mode.kind !== "local") {
+        throw new Error(mode.reason);
+    }
+    const entry = fileURLToPath(new URL("./installer-load-check.js", import.meta.url));
+    return new Promise((resolve, reject) => {
+        const child = spawn(process.execPath, [entry, mode.cliRoot, mode.installRoot, ...packs], {
+            shell: false, stdio: ["ignore", "pipe", "pipe"], signal
+        });
+        let output = "";
+        child.stdout.on("data", (chunk) => { output += chunk.toString(); });
+        child.stderr.on("data", (chunk) => { output += chunk.toString(); });
+        child.on("error", reject);
+        child.on("close", (code) => { if (code === 0) {
+            resolve();
+        }
+        else {
+            reject(new Error(`Pack load check failed (${String(code)}): ${output.trim()}`));
+        } });
+    });
+}
+export const DEFAULT_INSTALLER_OPERATIONS = {
+    npmVersion: installerNpmVersion, npm: runInstallerNpm, loadCheck: childLoadCheck
+};
+/** Additive install transaction. Requires a live command authorization. */
+export async function installPacks(request, authorization, operations = DEFAULT_INSTALLER_OPERATIONS) {
+    return installPacksTransaction(request, authorization, operations, "install");
+}
+/** Repair verifies the current pinned cohort and explicitly restores missing desired entries. */
+export async function repairPackInstallation(request, authorization, operations = DEFAULT_INSTALLER_OPERATIONS) {
+    return installPacksTransaction(request, authorization, operations, "repair");
+}
+async function installPacksTransaction(request, authorization, operations, operation) {
+    const { mode } = request;
+    if (mode.kind !== "global" && mode.kind !== "local") {
+        throw new Error(mode.reason);
+    }
+    assertLiveInstallAuthorization(authorization);
+    const selectionOptions = operation === "repair" ? { allowDirty: true, restoreDesired: true } : {};
+    const initial = await prepareInstallSelection(request, selectionOptions);
+    assertInstallAuthorizationScope(authorization, initial, operation, request);
+    const root = initial.root;
+    const release = await acquireInstallLock(mode.nodeModulesRoot, ".nodetool-packs.lock", { signal: request.signal });
+    try {
+        const selection = await prepareInstallSelection(request, selectionOptions);
+        assertInstallAuthorizationScope(authorization, selection, operation, request);
+        const { previous, before, installedIds, packs, catalog, replayLibraries, initialGlobalLockMissing } = selection;
+        const libraries = selection.runtimeLibraries;
+        const version = await operations.npmVersion(root, request.signal, request.onWarning);
+        const { pins: selectedPins, provided, runtimePins, shared, coreNames, libraryPins, pinByFolder } = await prepareTreeVerification(selection, mode.cliRoot);
+        const bootstrap = selection.bootstrap ?? [];
+        const pins = [...selectedPins, ...bootstrap];
+        const spec = (pin) => pin.installName && pin.installName !== pin.name
+            ? `${pin.installName}@npm:${pin.name}@${pin.version}` : `${pin.name}@${pin.version}`;
+        const specs = [...new Set([...packs.map((pack) => spec(pack.npm)), ...provided.map(spec), ...runtimePins.map(spec), ...bootstrap.map(spec)])];
+        const alreadyComplete = operation === "repair" && !initialGlobalLockMissing && pins.every((pin) => before.some((entry) => entry.name === pin.name && entry.version === pin.version && entry.integrity === pin.integrity));
+        const plan = alreadyComplete ? { add: [], change: [], remove: [] } :
+            parseInstallPlan(await operations.npm(root, ["install", ...specs, ...(Number(version.split(".")[0]) >= 11 ? ["--json"] : [])], { mode: mode.kind, dryRun: true, signal: request.signal, onWarning: request.onWarning }), version);
+        assertAdditivePlan(normalizeGlobalBootstrap(normalizeOwnedPackReplay(plan, before, catalog, coreNames), bootstrap), before, coreNames, shared, mode.coreVersion);
+        let desired = { root, coreVersion: mode.coreVersion, packs: [...new Set([...previous.packs, ...packs.filter((pack) => pack.kind === "node-pack").map((pack) => pack.id)])].sort(), runtimeLibraries: [...new Set([...previous.runtimeLibraries, ...libraries])].sort() };
+        if (operation === "repair") {
+            desired = { ...desired, dirty: false };
+        }
+        const restoreSavedFiles = await captureInstallManifests(root);
+        try {
+            if (!alreadyComplete) {
+                await operations.npm(root, ["install", ...specs], { mode: mode.kind, signal: request.signal, onWarning: request.onWarning });
+            }
+            const after = await snapshotInstallTree(root);
+            const installedShared = shared.filter((pin) => after.some((entry) => entry.name === pin.name));
+            assertTreePins(before, after, [...pins, ...installedShared], coreNames, mode.coreVersion, initialGlobalLockMissing);
+            if (mode.kind === "global" && after.some((entry) => entry.name === "@nodetool-ai/cli")) {
+                throw new Error("Install added another CLI core package");
+            }
+            await assertSharedIdentities(after, installedShared);
+            for (const pin of new Map(packs.flatMap((pack) => pack.scriptAllowlist).map((pin) => [pin.name, pin])).values()) {
+                if (operation === "repair" || !before.some((entry) => entry.name === pin.name && entry.version === pin.version && entry.integrity === pin.integrity)) {
+                    await operations.npm(root, ["rebuild", pin.name], { mode: mode.kind, rebuild: true, signal: request.signal, onWarning: request.onWarning });
+                }
+            }
+            await operations.loadCheck(mode, packs.filter((pack) => pack.kind === "node-pack").map((pack) => pack.id), request.signal);
+            await writeDesiredState(request.stateFile, desired);
+            return desired;
+        }
+        catch (cause) {
+            let restored = false;
+            try {
+                const oldPacks = expandCatalogPacks(catalog, installedIds);
+                const oldSpecs = [...bootstrap.map(spec), ...oldPacks.map((pack) => spec(pack.npm)), ...oldPacks.flatMap((pack) => pack.provides.map((name) => {
+                        const pin = pinByFolder.get(name);
+                        if (!pin) {
+                            throw new Error(`Provided package ${name} has no rollback integrity pin`);
+                        }
+                        return spec(pin);
+                    })), ...replayLibraries.flatMap((id) => libraryPins(id).map(spec))];
+                const oldNames = new Set(before.map((entry) => entry.name));
+                const additions = [...new Set(plan.add.filter((entry) => !oldNames.has(entry.name)).map((entry) => entry.name))];
+                // npm uninstall --no-save retains extraneous no-save additions. The
+                // saving removal is confined to rollback and manifests are restored below.
+                if (additions.length) {
+                    await operations.npm(root, ["uninstall", ...additions], { mode: "local", onWarning: request.onWarning });
+                }
+                if (mode.kind === "global") {
+                    await removeSnapshotAdditions(root, mode.nodeModulesRoot, before);
+                    await restoreSavedFiles();
+                    await operations.npm(root, ["install", ...oldSpecs], { mode: mode.kind });
+                }
+                restored = installTreeRestored(before, await snapshotInstallTree(root), initialGlobalLockMissing);
+                if (restored) {
+                    await restoreSavedFiles();
+                }
+            }
+            catch {
+                restored = false;
+            }
+            if (!restored) {
+                await writeDesiredState(request.stateFile, { ...previous, dirty: true });
+                throw new Error("Pack install failed and rollback did not restore the tree. Run nodetool packs doctor --repair.", { cause });
+            }
+            if (operation === "repair") {
+                await writeDesiredState(request.stateFile, { ...previous, dirty: true });
+            }
+            throw cause;
+        }
+    }
+    finally {
+        await release();
+    }
+}
+//# sourceMappingURL=installer.js.map

package/dist/packs/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/packs/installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAmD,MAAM,wBAAwB,CAAC;AACtI,OAAO,EAAE,8BAA8B,EAAE,+BAA+B,EAA6B,MAAM,2CAA2C,CAAC;AACvJ,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc,EAAE,sBAAsB,EAAE,uBAAuB,EAAwB,MAAM,mBAAmB,CAAC;AAS1M,SAAS,cAAc,CAAC,IAAiB,EAAE,KAAwB,EAAE,MAAoB;IACvF,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAAC,CAAC;IACtF,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,2BAA2B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,EAAE;YACvF,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;SACxD,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;aAAM,CAAC;YAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5J,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAwB;IAC/D,UAAU,EAAE,mBAAmB,EAAE,GAAG,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc;CACjF,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B,EAAE,aAAmC,EAAE,UAAU,GAAwB,4BAA4B;IAClK,OAAO,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;AAChF,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAA4B,EAAE,aAAmC,EAAE,UAAU,GAAwB,4BAA4B;IAC5K,OAAO,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAC/E,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,OAA4B,EAAE,aAAmC,EAAE,UAA+B,EAAE,SAA+B;IACxK,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACzB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAAC,CAAC;IACtF,8BAA8B,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,gBAAgB,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClG,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACzE,+BAA+B,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,eAAe,EAAE,sBAAsB,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnH,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAC3E,+BAA+B,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9E,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,GAAG,SAAS,CAAC;QAChH,MAAM,SAAS,GAAG,SAAS,CAAC,gBAAgB,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACrF,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1J,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,SAAS,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,CAAC,GAAoB,EAAU,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,KAAK,GAAG,CAAC,IAAI;YAC5F,CAAC,CAAC,GAAG,GAAG,CAAC,WAAW,QAAQ,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACvF,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9I,MAAM,eAAe,GAAG,SAAS,KAAK,QAAQ,IAAI,CAAC,wBAAwB,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QAC1N,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAClE,gBAAgB,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QACpO,kBAAkB,CAAC,wBAAwB,CAAC,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACjK,IAAI,OAAO,GAAqB,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,gBAAgB,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,gBAAgB,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3R,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAAC,CAAC;QACvE,MAAM,iBAAiB,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC;YACH,IAAI,CAAC,eAAe,EAAE,CAAC;gBAAC,MAAM,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;YAAC,CAAC;YACvJ,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/F,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,eAAe,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAC;YACpH,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB,CAAC,EAAE,CAAC;gBAAC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAAC,CAAC;YACtJ,MAAM,sBAAsB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;YACrD,KAAK,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChH,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBACrJ,MAAM,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC9I,CAAC;YACH,CAAC;YACD,MAAM,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC3H,MAAM,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;gBAC3D,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;wBAC5I,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;wBAClC,IAAI,CAAC,GAAG,EAAE,CAAC;4BAAC,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,gCAAgC,CAAC,CAAC;wBAAC,CAAC;wBACxF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;oBACnB,CAAC,CAAC,CAAC,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACpE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC5D,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjH,oEAAoE;gBACpE,2EAA2E;gBAC3E,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;oBAAC,MAAM,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;gBAAC,CAAC;gBACnI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC3B,MAAM,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;oBAClE,MAAM,iBAAiB,EAAE,CAAC;oBAC1B,MAAM,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC5E,CAAC;gBACD,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,MAAM,mBAAmB,CAAC,IAAI,CAAC,EAAE,wBAAwB,CAAC,CAAC;gBAClG,IAAI,QAAQ,EAAE,CAAC;oBAAC,MAAM,iBAAiB,EAAE,CAAC;gBAAC,CAAC;YAC9C,CAAC;YAAC,MAAM,CAAC;gBAAC,QAAQ,GAAG,KAAK,CAAC;YAAC,CAAC;YAC7B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzE,MAAM,IAAI,KAAK,CAAC,gGAAgG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/H,CAAC;YACD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,CAAC;YACzG,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;YAAS,CAAC;QAAC,MAAM,OAAO,EAAE,CAAC;IAAC,CAAC;AAChC,CAAC"}

package/dist/packs/management.d.ts

@@ -0,0 +1,51 @@
+import type { NodeCatalogIndex } from "@nodetool-ai/node-catalog";
+import type { DesiredPackState } from "./install-selection.js";
+import type { InstalledPackSnapshot } from "./installed.js";
+export interface PackListRow {
+    readonly id: string;
+    readonly kind: "core" | "node-pack" | "runtime-library";
+    readonly installed: boolean;
+    readonly version: string | null;
+    readonly installBytes: number | null;
+    readonly nodeCount: number | null;
+    readonly requiredBy: readonly string[];
+}
+export declare function requestedInstallIds(catalog: NodeCatalogIndex, ids: readonly string[]): {
+    packs: string[];
+    runtimeLibraries: string[];
+};
+/** The installed tree decides availability. Desired intent never makes a package installed. */
+export declare function listPackRows(catalog: NodeCatalogIndex, snapshot: InstalledPackSnapshot, installedRuntimeIds?: ReadonlySet<string>): PackListRow[];
+export declare function explainPack(catalog: NodeCatalogIndex, snapshot: InstalledPackSnapshot, target: string, installedRuntimeIds?: ReadonlySet<string>): {
+    target: string;
+    id: "email-imap" | "esbuild" | "fabric" | "imaging" | "node-llama-cpp" | "office-documents" | "pdf-js" | "playwright" | "rapier" | "tensorflow-js" | "tesseract-ocr" | "tokenizer" | "tracing" | "transformers-js" | "typescript" | "whisper-cpp";
+    kind: string;
+    installed: boolean;
+    packages: readonly ["@dimforge/rapier3d-compat@0.19.3"] | readonly ["@fugood/whisper.node@1.1.3"] | readonly ["esbuild@0.28.1"] | readonly ["fabric@7.4.0"] | readonly ["js-tiktoken@1.0.21"] | readonly ["node-llama-cpp@3.19.1"] | readonly ["playwright@1.60.0"] | readonly ["tesseract.js@7.0.0"] | readonly ["typescript@npm:@typescript/typescript6@6.0.2"] | readonly ["@huggingface/transformers@3.8.1", "kokoro-js@1.2.1"] | readonly ["imapflow@1.7.1", "mailparser@3.9.15"] | readonly ["sharp@0.35.5", "@napi-rs/canvas@0.1.100"] | readonly ["@llamaindex/liteparse@1.5.3", "pdf-parse@2.4.5", "pdf-lib@1.17.1"] | readonly ["@opentelemetry/core@2.12.0", "@opentelemetry/resources@2.12.0", "@opentelemetry/sdk-trace-base@2.12.0"] | readonly ["@tensorflow/tfjs@4.22.0", "@tensorflow-models/mobilenet@2.1.1", "@tensorflow-models/coco-ssd@2.2.3", "@tensorflow-models/qna@1.0.2"] | readonly ["exceljs@4.4.0", "docx@9.7.1", "mammoth@1.12.1", "pptxgenjs@4.0.1", "office-text-extractor@4.0.0", "epub2@3.0.2"];
+    requiredBy: string[];
+    npm?: undefined;
+    version?: undefined;
+    requires?: undefined;
+    runtimeLibraries?: undefined;
+} | {
+    packages?: undefined;
+    target: string;
+    id: string;
+    kind: "core" | "node-pack";
+    npm: string;
+    version: string;
+    installed: boolean;
+    requires: string[];
+    runtimeLibraries: readonly string[];
+    requiredBy: string[];
+};
+export declare function restoreWarning(snapshot: InstalledPackSnapshot, desired: DesiredPackState | undefined): string | null;
+/** Removal retains any requested pack still required by another installed pack. */
+export declare function planPackRemoval(catalog: NodeCatalogIndex, installedIds: readonly string[], requestedIds: readonly string[]): {
+    remove: string[];
+    kept: string[];
+    remaining: string[];
+    runtimeLibraries: string[];
+};
+export declare function restartNotice(ids: readonly string[]): string;
+//# sourceMappingURL=management.d.ts.map

package/dist/packs/management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management.d.ts","sourceRoot":"","sources":["../../src/packs/management.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBtI;AAED,+FAA+F;AAC/F,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,qBAAqB,EAAE,mBAAmB,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,WAAW,EAAE,CAc5J;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAE,WAAW,CAAC,MAAM,CAAa;;;;;;;;;;;;;;;;;;;;;;EAc3J;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,qBAAqB,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAUpH;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE;;;;;EAW1H;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE5D"}

package/dist/packs/management.js

@@ -0,0 +1,81 @@
+import { RUNTIME_NPM_PACKAGES, isRuntimeNpmPackageId } from "@nodetool-ai/protocol/runtime-npm-packages";
+import { expandCatalogPacks } from "./install-selection.js";
+export function requestedInstallIds(catalog, ids) {
+    const packs = [];
+    const runtimeLibraries = [];
+    for (const id of new Set(ids)) {
+        const pack = catalog.packs.find(entry => entry.id === id);
+        if (pack) {
+            if (pack.kind === "core") {
+                throw new Error(`Pack ${id} ships with the CLI and cannot be installed separately`);
+            }
+            packs.push(id);
+        }
+        else if (isRuntimeNpmPackageId(id)) {
+            runtimeLibraries.push(id);
+        }
+        else {
+            throw new Error(`Unknown node pack or runtime library: ${id}`);
+        }
+    }
+    return { packs: packs.sort(), runtimeLibraries: runtimeLibraries.sort() };
+}
+/** The installed tree decides availability. Desired intent never makes a package installed. */
+export function listPackRows(catalog, snapshot, installedRuntimeIds = new Set()) {
+    const installed = new Map(snapshot.packs.map(pack => [pack.id, pack.version]));
+    const rows = catalog.packs.map(pack => ({
+        id: pack.id, kind: pack.kind, installed: installed.has(pack.id), version: installed.get(pack.id) ?? null,
+        installBytes: pack.installBytes, nodeCount: pack.nodeCount,
+        requiredBy: catalog.packs.filter(candidate => installed.has(candidate.id) && candidate.requires.includes(pack.id)).map(candidate => candidate.id).sort()
+    }));
+    for (const [id, runtime] of Object.entries(RUNTIME_NPM_PACKAGES)) {
+        rows.push({ id, kind: "runtime-library", installed: installedRuntimeIds.has(id),
+            version: installedRuntimeIds.has(id) ? runtime.npmPackages.join(", ") : null,
+            installBytes: null, nodeCount: null,
+            requiredBy: catalog.packs.filter(pack => installed.has(pack.id) && pack.runtimeLibraries.includes(id)).map(pack => pack.id).sort() });
+    }
+    return rows.sort((a, b) => a.id.localeCompare(b.id) || a.kind.localeCompare(b.kind));
+}
+export function explainPack(catalog, snapshot, target, installedRuntimeIds = new Set()) {
+    const id = catalog.owners[target] ?? target;
+    const pack = catalog.packs.find(entry => entry.id === id);
+    if (!pack) {
+        if (!isRuntimeNpmPackageId(id)) {
+            throw new Error(`Unknown node type, pack or runtime library: ${target}`);
+        }
+        return { target, id, kind: "runtime-library", installed: installedRuntimeIds.has(id), packages: RUNTIME_NPM_PACKAGES[id].npmPackages,
+            requiredBy: catalog.packs.filter(entry => entry.runtimeLibraries.includes(id)).map(entry => entry.id).sort() };
+    }
+    return { target, id, kind: pack.kind, npm: pack.npm.name, version: pack.npm.version,
+        installed: snapshot.packs.some(entry => entry.id === id),
+        requires: expandCatalogPacks(catalog, pack.requires).map(entry => entry.id), runtimeLibraries: pack.runtimeLibraries,
+        requiredBy: catalog.packs.filter(entry => entry.requires.includes(id)).map(entry => entry.id).sort() };
+}
+export function restoreWarning(snapshot, desired) {
+    if (!desired || desired.coreVersion === snapshot.mode.coreVersion) {
+        return null;
+    }
+    const installed = new Set(snapshot.packs.map(pack => pack.id));
+    const missing = [...new Set(desired.packs)].filter(id => !installed.has(id)).sort();
+    if (missing.length === 0) {
+        return null;
+    }
+    return `${missing.length} pack${missing.length === 1 ? "" : "s"} from ${desired.coreVersion} ${missing.length === 1 ? "is" : "are"} not installed for ${snapshot.mode.coreVersion}: ${missing.join(", ")}. Run "nodetool packs add --restore".`;
+}
+/** Removal retains any requested pack still required by another installed pack. */
+export function planPackRemoval(catalog, installedIds, requestedIds) {
+    const requested = requestedInstallIds(catalog, requestedIds);
+    const installed = new Set(installedIds);
+    const wanted = new Set(requested.packs);
+    const other = installedIds.filter(id => !wanted.has(id));
+    const needed = new Set(expandCatalogPacks(catalog, other).map(pack => pack.id));
+    const remove = requested.packs.filter(id => installed.has(id) && !needed.has(id));
+    const kept = requested.packs.filter(id => needed.has(id));
+    const removed = new Set(remove);
+    const remaining = installedIds.filter(id => !removed.has(id));
+    return { remove, kept, remaining, runtimeLibraries: requested.runtimeLibraries };
+}
+export function restartNotice(ids) {
+    return `Restart running "nodetool serve" and "nodetool mcp serve" processes to load ${[...new Set(ids)].sort().join(", ")}.`;
+}
+//# sourceMappingURL=management.js.map

package/dist/packs/management.js.map

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

package/dist/packs/mode.d.ts

@@ -0,0 +1,42 @@
+import type { MissingPackInstall } from "@nodetool-ai/node-catalog";
+export type InstallPathStyle = "posix" | "win32";
+interface InstallIdentity {
+    readonly cliRoot: string;
+    readonly coreVersion: string;
+    readonly pathStyle: InstallPathStyle;
+}
+export type InstallMode = InstallIdentity & ({
+    readonly kind: "global";
+    readonly installRoot: string;
+    readonly nodeModulesRoot: string;
+} | {
+    readonly kind: "local";
+    readonly installRoot: string;
+    readonly nodeModulesRoot: string;
+} | {
+    readonly kind: "npx" | "dev" | "unsupported";
+    readonly reason: string;
+    readonly nodeModulesRoot: string | null;
+});
+export interface InstallLayout {
+    readonly cliRoot: string;
+    readonly coreVersion: string;
+    readonly pathStyle?: InstallPathStyle;
+    readonly globalNodeModulesRoots?: readonly string[];
+    readonly projectHasCli?: boolean;
+    readonly yarnPnp?: boolean;
+    readonly bunGlobalRoots?: readonly string[];
+    readonly workspaceRoot?: string;
+}
+export interface InstallModeOptions {
+    readonly globalNodeModulesRoots?: readonly string[];
+    readonly bunGlobalRoots?: readonly string[];
+}
+/** Classify a known package root without filesystem reads or npm subprocesses. */
+export declare function classifyInstallLayout(layout: InstallLayout): InstallMode;
+/** Resolve the real CLI entry and inspect its layout only when the host requests it. */
+export declare function detectInstallMode(entryPath: string, options?: InstallModeOptions): InstallMode;
+/** The catalog factory supplies the concrete closure when no ids are available yet. */
+export declare function installDetailsForMode(mode: InstallMode, ids?: readonly string[]): MissingPackInstall;
+export {};
+//# sourceMappingURL=mode.d.ts.map

package/dist/packs/mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode.d.ts","sourceRoot":"","sources":["../../src/packs/mode.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjD,UAAU,eAAe;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,CACxC;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAC3F;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAC1F;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CACrH,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAqBD,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAmCxE;AAiHD,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAkClG;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,GAAE,SAAS,MAAM,EAAO,GAAG,kBAAkB,CAKxG"}