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

package/dist/commands/node.js

@@ -1,4 +1,5 @@
-import { printCommandError } from "../command-errors.js";
+import { printCommandError, commandMissingRuntime, commandMissingPack } from "../command-errors.js";
+import { installMissingPacksAndReexec } from "./install-missing-packs.js";
 export function registerNodeCommands(program) {
     const node = program
         .command("node")
@@ -9,6 +10,7 @@ export function registerNodeCommands(program) {
         .option("--props <json>", "JSON object of property values keyed by @prop name", "{}")
         .option("--no-secrets", "Don't resolve secrets/assets (hermetic run)")
         .option("--json", "Print the full run result as JSON")
+        .option("--install-missing", "Authorize missing node pack installation, then re-execute once")
         .action(async (nodeType, opts) => {
         try {
             const { runSingleNode } = await import("../node/run-node.js");
@@ -42,6 +44,13 @@ export function registerNodeCommands(program) {
                 runOptions.secretResolver = secretResolver;
             }
             const result = await runSingleNode(nodeType, runOptions);
+            if (!result.ok && (commandMissingRuntime(result) || commandMissingPack(result))) {
+                const exit = await installMissingPacksAndReexec(result, { command: "node-run", installMissing: opts.installMissing });
+                if (exit !== null) {
+                    process.exit(exit);
+                }
+                process.exit(printCommandError(result, opts.json));
+            }
             const { printRunJson, previewJson } = await import("../run-json.js");
             if (opts.json) {
                 await printRunJson(result);
@@ -64,8 +73,11 @@ export function registerNodeCommands(program) {
             process.exit(result.ok ? 0 : 1);
         }
         catch (e) {
-            printCommandError(e, opts.json);
-            process.exit(1);
+            const exit = await installMissingPacksAndReexec(e, { command: "node-run", installMissing: opts.installMissing });
+            if (exit !== null) {
+                process.exit(exit);
+            }
+            process.exit(printCommandError(e, opts.json));
         }
     });
 }

package/dist/commands/node.js.map

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

package/dist/commands/pack-install-authorization.d.ts

@@ -0,0 +1,40 @@
+import { type InstallSelection, type InstallPacksRequest } from "../packs/install-selection.js";
+declare const AUTHORIZATION: unique symbol;
+export interface InstallAuthorization {
+    readonly [AUTHORIZATION]: true;
+}
+export type InstallCommandContext = "packs-add" | "packs-restore" | "packs-remove" | "packs-repair" | "run" | "debug" | "node-run" | "workflows-run" | "serve" | "mcp-serve" | "headless-job" | "chat" | "agent-tool";
+export type InstallAuthorizationSource = "explicit" | "flag" | "environment" | "prompt";
+interface AuthorizedScope {
+    readonly requestedPacks: ReadonlySet<string>;
+    readonly requestedLibraries: ReadonlySet<string>;
+    readonly operation: "install" | "remove" | "repair";
+    readonly source: InstallAuthorizationSource;
+    readonly root: string;
+    readonly coreVersion: string;
+    readonly mode: InstallSelection["mode"];
+    readonly packs: ReadonlySet<string>;
+    readonly libraries: ReadonlySet<string>;
+    readonly scripts: ReadonlySet<string>;
+    readonly bootstrap: ReadonlySet<string>;
+    readonly mutationPaths: ReadonlySet<string>;
+}
+export declare function installPromptMessage(selection: InstallSelection): string;
+/** Only this CLI command module constructs live authorizations. JSON cannot reproduce one. */
+export declare function authorizePackInstallCommand(options: {
+    readonly request: InstallPacksRequest;
+    readonly command: InstallCommandContext;
+    readonly installMissing?: boolean;
+    readonly confirm?: boolean;
+    readonly prompt?: (options: {
+        message: string;
+        default: false;
+    }) => Promise<boolean>;
+}): Promise<InstallAuthorization | null>;
+export declare function assertLiveInstallAuthorization(value: InstallAuthorization): void;
+export declare class StaleInstallAuthorizationError extends Error {
+    constructor();
+}
+export declare function assertInstallAuthorizationScope(value: InstallAuthorization, selection: InstallSelection, operation?: AuthorizedScope["operation"], request?: InstallPacksRequest): void;
+export {};
+//# sourceMappingURL=pack-install-authorization.d.ts.map

package/dist/commands/pack-install-authorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-install-authorization.d.ts","sourceRoot":"","sources":["../../src/commands/pack-install-authorization.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIzH,QAAA,MAAM,aAAa,eAAsC,CAAC;AAC1D,MAAM,WAAW,oBAAoB;IAAG,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;CAAE;AACxE,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,cAAc,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,eAAe,GAClJ,OAAO,GAAG,WAAW,GAAG,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;AACjE,MAAM,MAAM,0BAA0B,GAAG,UAAU,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC;AACxF,UAAU,eAAe;IACvB,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7C;AAID,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAmBxE;AAED,8FAA8F;AAC9F,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACtF,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA0BvC;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAGhF;AACD,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,cAAmK;CACpK;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,GAAE,eAAe,CAAC,WAAW,CAAa,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAmClM"}

package/dist/commands/pack-install-authorization.js

@@ -0,0 +1,131 @@
+import { RUNTIME_NPM_PACKAGES, isRuntimeNpmPackageId } from "@nodetool-ai/protocol/runtime-npm-packages";
+import { prepareInstallSelection } from "../packs/install-selection.js";
+import { assertPackInstallProcessAllowed } from "../packs/install-process.js";
+import { preparePackRemoval } from "../packs/removal-selection.js";
+const AUTHORIZATION = Symbol("CLI install authorization");
+const issued = new WeakMap();
+const runCommands = new Set(["run", "debug", "node-run", "workflows-run"]);
+export function installPromptMessage(selection) {
+    const lines = ["Install these NodeTool packages?"];
+    for (const pack of selection.packs) {
+        lines.push(`Pack ${pack.id}: ${pack.npm.name}@${pack.npm.version}, estimated ${pack.installBytes.toLocaleString("en-US")} bytes`);
+    }
+    for (const id of selection.runtimeLibraries) {
+        const versions = isRuntimeNpmPackageId(id) ? RUNTIME_NPM_PACKAGES[id].npmPackages.join(", ") : "unknown version";
+        const pins = isRuntimeNpmPackageId(id) ? RUNTIME_NPM_PACKAGES[id].packageNames.map((name) => selection.catalog.installPins?.find((pin) => (pin.installName ?? pin.name) === name)) : [];
+        const bytes = pins.length && pins.every((pin) => pin?.installBytes !== undefined)
+            ? pins.reduce((sum, pin) => sum + pin.installBytes, 0) : undefined;
+        lines.push(`Runtime ${id}: ${versions}, ${bytes === undefined ? "separate size estimate unavailable" : `estimated ${bytes.toLocaleString("en-US")} bytes`}`);
+    }
+    if (selection.bootstrap?.length) {
+        lines.push("This initial global install has no integrity record. These exact release packages will be reinstalled with scripts disabled to verify integrity:");
+        for (const pin of selection.bootstrap) {
+            lines.push(`${pin.name}@${pin.version} (${pin.installPath})`);
+        }
+    }
+    lines.push("Estimates can overlap through shared dependencies and exclude files generated by rebuilds. They are not final disk usage.");
+    lines.push(selection.scripts.length ? `Install scripts: ${selection.scripts.map((pin) => `${pin.name}@${pin.version}`).join(", ")}` : "Install scripts: none");
+    if (selection.mode === "local") {
+        lines.push("Updates local package.json and package-lock.json.");
+    }
+    return lines.join("\n");
+}
+/** Only this CLI command module constructs live authorizations. JSON cannot reproduce one. */
+export async function authorizePackInstallCommand(options) {
+    assertPackInstallProcessAllowed();
+    let source;
+    if (options.command === "packs-add" || options.command === "packs-restore" || options.command === "packs-remove" || options.command === "packs-repair") {
+        source = "explicit";
+    }
+    else if (!runCommands.has(options.command)) {
+        return null;
+    }
+    else if (options.installMissing) {
+        source = "flag";
+    }
+    else if (process.env["NODETOOL_AUTO_INSTALL"] === "1") {
+        source = "environment";
+    }
+    else {
+        if (!process.stdin.isTTY || !process.stderr.isTTY || process.env["CI"] !== undefined) {
+            return null;
+        }
+        source = "prompt";
+    }
+    const operation = options.command === "packs-remove" ? "remove" : options.command === "packs-repair" ? "repair" : "install";
+    const selection = operation === "remove" ? (await preparePackRemoval(options.request)).authorization :
+        await prepareInstallSelection(options.request, operation === "repair" ? { allowDirty: true, restoreDesired: true } : {});
+    if (source === "prompt" || options.confirm) {
+        if (!process.stdin.isTTY || !process.stderr.isTTY || process.env["CI"] !== undefined) {
+            throw new Error("Use --yes to confirm a node pack install in a non-interactive terminal");
+        }
+        const prompt = options.prompt ?? (await import("@inquirer/prompts")).confirm;
+        if (!await prompt({ message: installPromptMessage(selection), default: false })) {
+            return null;
+        }
+    }
+    const value = Object.freeze({ [AUTHORIZATION]: true });
+    issued.set(value, { requestedPacks: new Set(options.request.packs), requestedLibraries: new Set(options.request.runtimeLibraries ?? []), operation, source, root: selection.root, coreVersion: selection.coreVersion, mode: selection.mode,
+        packs: new Set(selection.packs.map((pack) => pack.id)), libraries: new Set(selection.runtimeLibraries),
+        scripts: new Set(selection.scripts.map((pin) => JSON.stringify({ name: pin.name, version: pin.version, integrity: pin.integrity }))),
+        bootstrap: new Set((selection.bootstrap ?? []).map(pin => JSON.stringify(pin))),
+        mutationPaths: new Set(selection.mutationPaths ?? []) });
+    return value;
+}
+export function assertLiveInstallAuthorization(value) {
+    assertPackInstallProcessAllowed();
+    if (!issued.has(value)) {
+        throw new Error("Installing node packs requires a live CLI command authorization");
+    }
+}
+export class StaleInstallAuthorizationError extends Error {
+    constructor() { super("Installed packs changed while this command waited. A fresh CLI authorization is required."); this.name = "StaleInstallAuthorizationError"; }
+}
+export function assertInstallAuthorizationScope(value, selection, operation = "install", request) {
+    assertLiveInstallAuthorization(value);
+    const scope = issued.get(value);
+    if (scope.operation !== operation) {
+        throw new Error(`Install authorization cannot authorize ${operation}`);
+    }
+    if (scope.root !== selection.root || scope.coreVersion !== selection.coreVersion || scope.mode !== selection.mode) {
+        throw new Error("Install authorization does not match the install root, mode, or core version");
+    }
+    if ((selection.bootstrap ?? []).some(pin => !scope.bootstrap.has(JSON.stringify(pin)))) {
+        throw new Error("Global integrity bootstrap is outside the install authorization");
+    }
+    // A concurrent command can expand npm replay. The old token stays invalid.
+    // Only unchanged direct requests may ask the command layer for a new grant.
+    const extraPacks = selection.packs.filter(pack => !scope.packs.has(pack.id));
+    const extraLibraries = selection.runtimeLibraries.filter(id => !scope.libraries.has(id));
+    const extraScripts = selection.scripts.filter(pin => !scope.scripts.has(JSON.stringify({ name: pin.name, version: pin.version, integrity: pin.integrity })));
+    if (operation === "install" && request &&
+        new Set(request.packs).size === scope.requestedPacks.size && request.packs.every(id => scope.requestedPacks.has(id)) &&
+        new Set(request.runtimeLibraries ?? []).size === scope.requestedLibraries.size && (request.runtimeLibraries ?? []).every(id => scope.requestedLibraries.has(id)) &&
+        (extraPacks.length > 0 || extraLibraries.length > 0) &&
+        extraPacks.every(pack => selection.installedIds.includes(pack.id)) &&
+        extraLibraries.every(id => selection.replayLibraries.includes(id)) &&
+        extraScripts.every(pin => extraPacks.some(pack => pack.scriptAllowlist.some(script => script.name === pin.name && script.version === pin.version && script.integrity === pin.integrity)))) {
+        throw new StaleInstallAuthorizationError();
+    }
+    for (const pack of selection.packs) {
+        if (!scope.packs.has(pack.id)) {
+            throw new Error(`Pack ${pack.id} is outside the install authorization`);
+        }
+    }
+    for (const id of selection.runtimeLibraries) {
+        if (!scope.libraries.has(id)) {
+            throw new Error(`Runtime library ${id} is outside the install authorization`);
+        }
+    }
+    for (const pin of selection.scripts) {
+        if (!scope.scripts.has(JSON.stringify({ name: pin.name, version: pin.version, integrity: pin.integrity }))) {
+            throw new Error(`Install script ${pin.name}@${pin.version} is outside the install authorization`);
+        }
+    }
+    for (const path of selection.mutationPaths ?? []) {
+        if (!scope.mutationPaths.has(path)) {
+            throw new Error(`Removal path ${path} is outside the install authorization`);
+        }
+    }
+}
+//# sourceMappingURL=pack-install-authorization.js.map

package/dist/commands/pack-install-authorization.js.map

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

package/dist/commands/pack-management.d.ts

@@ -0,0 +1,26 @@
+import type { Command } from "commander";
+import type { PackListRow } from "../packs/management.js";
+export interface PackAddOptions {
+    readonly yes?: boolean;
+    readonly restore?: boolean;
+    readonly for?: string;
+}
+export interface PackDoctorOptions {
+    readonly installed?: boolean;
+    readonly json?: boolean;
+    readonly repair?: boolean;
+    readonly pack?: string[];
+}
+export interface PackCommandServices {
+    list(): Promise<readonly PackListRow[]>;
+    add(ids: readonly string[], options: PackAddOptions): Promise<void>;
+    remove(ids: readonly string[]): Promise<void>;
+    doctor(options: PackDoctorOptions): Promise<{
+        readonly healthy: boolean;
+        readonly [key: string]: unknown;
+    }>;
+    why(target: string): Promise<Record<string, unknown>>;
+}
+/** Register the command shape without reading the installed tree or constructing an installer. */
+export declare function registerPackManagementCommands(packs: Command, loadServices: () => Promise<PackCommandServices>): void;
+//# sourceMappingURL=pack-management.d.ts.map

package/dist/commands/pack-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-management.d.ts","sourceRoot":"","sources":["../../src/commands/pack-management.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,WAAW,cAAc;IAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;AAC7G,MAAM,WAAW,iBAAiB;IAAG,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;AACjJ,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACxC,GAAG,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5G,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,kGAAkG;AAClG,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,CA4CrH"}

package/dist/commands/pack-management.js

@@ -0,0 +1,74 @@
+import { printCommandError } from "../command-errors.js";
+import { printTable } from "./output.js";
+/** Register the command shape without reading the installed tree or constructing an installer. */
+export function registerPackManagementCommands(packs, loadServices) {
+    packs.command("list").description("List available and installed node packs and runtime libraries")
+        .option("--json", "Print the installed catalog report as JSON")
+        .action(async (options) => {
+        try {
+            const rows = await (await loadServices()).list();
+            if (options.json) {
+                console.log(JSON.stringify(rows, null, 2));
+            }
+            else {
+                printTable(rows.map(row => ({ id: row.id, kind: row.kind, installed: row.installed, version: row.version,
+                    bytes: row.installBytes, nodes: row.nodeCount, required_by: row.requiredBy.join(", ") })));
+            }
+        }
+        catch (error) {
+            process.exitCode = printCommandError(error, options.json);
+        }
+    });
+    packs.command("add [ids...]").description("Install node packs or runtime libraries and their requirements")
+        .option("--yes", "Confirm the install without prompting")
+        .option("--restore", "Restore the desired set recorded for this install root")
+        .option("--for <workflow|file>", "Install every pack needed by a saved workflow or an explicitly named local workflow file")
+        .action(async (ids, options) => {
+        try {
+            const selections = Number(ids.length > 0) + Number(Boolean(options.restore)) + Number(Boolean(options.for));
+            if (selections !== 1) {
+                throw new Error("Choose pack ids, --restore, or --for <workflow|file>");
+            }
+            await (await loadServices()).add(ids, options);
+        }
+        catch (error) {
+            process.exitCode = printCommandError(error);
+        }
+    });
+    packs.command("remove <ids...>").description("Remove node packs while retaining requirements of installed packs")
+        .action(async (ids) => {
+        try {
+            await (await loadServices()).remove(ids);
+        }
+        catch (error) {
+            process.exitCode = printCommandError(error);
+        }
+    });
+    packs.command("doctor").description("Check the install mode, versions, integrity, shared copies and registration")
+        .option("--json", "Print the diagnostic report as JSON")
+        .option("--installed", "Register installed packs in a fresh child process")
+        .option("--pack <ids...>", "Limit registration checks to these pack ids")
+        .option("--repair", "Verify and repair a dirty pack installation")
+        .action(async (options) => {
+        try {
+            const report = await (await loadServices()).doctor(options);
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.healthy) {
+                process.exitCode = 1;
+            }
+        }
+        catch (error) {
+            process.exitCode = printCommandError(error, options.json);
+        }
+    });
+    packs.command("why <node_type|id>").description("Explain a node owner, pack requirements or runtime library")
+        .action(async (target) => {
+        try {
+            console.log(JSON.stringify(await (await loadServices()).why(target), null, 2));
+        }
+        catch (error) {
+            process.exitCode = printCommandError(error);
+        }
+    });
+}
+//# sourceMappingURL=pack-management.js.map

package/dist/commands/pack-management.js.map

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

package/dist/commands/packs.d.ts

@@ -9,5 +9,6 @@
  * cache answered.
  */
 import type { Command } from "commander";
-export declare function registerPackCommands(program: Command): void;
+import { type PackCommandServices } from "./pack-management.js";
+export declare function registerPackCommands(program: Command, loadServices?: () => Promise<PackCommandServices>): void;
 //# sourceMappingURL=packs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"packs.d.ts","sourceRoot":"","sources":["../../src/commands/packs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6E3D"}
+{"version":3,"file":"packs.d.ts","sourceRoot":"","sources":["../../src/commands/packs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAkC,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAQhG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,GAAE,MAAM,OAAO,CAAC,mBAAmB,CAGrG,GAAG,IAAI,CA8EP"}

package/dist/commands/packs.js

@@ -8,8 +8,12 @@
  * cache — and it prints one line per module with the outcome and whether the
  * cache answered.
  */
-export function registerPackCommands(program) {
-    const packs = program.command("packs").description("Sandbox pack tooling");
+import { registerPackManagementCommands } from "./pack-management.js";
+export function registerPackCommands(program, loadServices = async () => {
+    const { createPackCommandServices } = await import("../packs/command-service.js");
+    return createPackCommandServices();
+}) {
+    const packs = program.command("packs").description("Manage node packs, runtime libraries and sandbox compilation");
     packs
         .command("compile")
         .description("Compile every npm-backed sandbox module of every installed pack")
@@ -56,5 +60,6 @@ export function registerPackCommands(program) {
         if (skipped > 0)
             process.exitCode = 1;
     });
+    registerPackManagementCommands(packs, loadServices);
 }
 //# sourceMappingURL=packs.js.map

package/dist/commands/packs.js.map

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

package/dist/commands/projects.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `nodetool projects` — list projects and move whole projects between
+ * installs as `.nodetool-project` files.
+ *
+ * Runs in-process against the local database, asset store, and workspaces, the
+ * same ones the local server uses. `export` writes what the server's
+ * `GET /api/projects/:id/export` streams, and `import` reads what it accepts.
+ */
+import type { Command } from "commander";
+export declare function registerProjectCommands(program: Command): void;
+//# sourceMappingURL=projects.d.ts.map

package/dist/commands/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/commands/projects.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuJ9D"}

package/dist/commands/projects.js

@@ -0,0 +1,145 @@
+/**
+ * `nodetool projects` — list projects and move whole projects between
+ * installs as `.nodetool-project` files.
+ *
+ * Runs in-process against the local database, asset store, and workspaces, the
+ * same ones the local server uses. `export` writes what the server's
+ * `GET /api/projects/:id/export` streams, and `import` reads what it accepts.
+ */
+import { createWriteStream } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { once } from "node:events";
+import { Project } from "@nodetool-ai/models";
+import { asJson, printTable } from "./output.js";
+import { setupLocalDb, LOCAL_USER_ID } from "./local-db.js";
+function fail(e) {
+    console.error(String(e instanceof Error ? e.message : e));
+    process.exit(1);
+}
+function fileBase(name) {
+    return (name || "project").replace(/[^A-Za-z0-9._-]+/g, "_") || "project";
+}
+export function registerProjectCommands(program) {
+    const projects = program
+        .command("projects")
+        .description("List, export, and import projects");
+    projects
+        .command("list")
+        .description("List projects, newest first")
+        .option("--archived", "List archived projects instead")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        try {
+            await setupLocalDb();
+            const rows = await Project.listByUser(LOCAL_USER_ID, 1000, opts.archived ?? false);
+            if (opts.json) {
+                asJson(rows.map((row) => row.toResponse()));
+                return;
+            }
+            printTable(rows.map((row) => ({
+                id: row.id,
+                name: row.name,
+                kind: row.kind,
+                updated: row.updated_at
+            })));
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    projects
+        .command("export <project_id>")
+        .description("Write a project with all of its documents, workflows, chats, assets, " +
+        "and workspace files to a .nodetool-project file")
+        .option("-o, --output <file>", "Output path (default: <name>.nodetool-project)")
+        .option("--json", "Print the manifest as JSON")
+        .action(async (projectId, opts) => {
+        try {
+            await setupLocalDb();
+            const { projectArchiveHost, streamZip, writeProjectArchive, PROJECT_ARCHIVE_EXTENSION } = await import("@nodetool-ai/websocket");
+            const project = await Project.findOwned(LOCAL_USER_ID, projectId);
+            if (!project)
+                throw new Error(`Project not found: ${projectId}`);
+            const outPath = opts.output ?? `${fileBase(project.name)}${PROJECT_ARCHIVE_EXTENSION}`;
+            const host = projectArchiveHost();
+            let manifest = null;
+            const zip = streamZip(async (writer) => {
+                manifest = await writeProjectArchive({
+                    userId: LOCAL_USER_ID,
+                    projectId: project.id,
+                    storage: host.storage,
+                    openWorkspace: host.openWorkspace
+                }, writer);
+            });
+            const out = createWriteStream(outPath);
+            zip.pipe(out);
+            await Promise.race([
+                once(out, "finish"),
+                once(zip, "error").then(([error]) => {
+                    throw error;
+                })
+            ]);
+            const written = manifest;
+            if (!written)
+                throw new Error("Export wrote no manifest");
+            for (const skip of written.skipped) {
+                console.error(`  warning: skipped ${skip.kind} ${skip.id}: ${skip.reason}`);
+            }
+            if (opts.json) {
+                asJson({ file: outPath, manifest: written });
+                return;
+            }
+            const counts = Object.entries(written.counts)
+                .filter(([, n]) => n > 0)
+                .map(([table, n]) => `${n} ${table}`)
+                .join(", ");
+            console.error(`  exported ${counts || "an empty project"}; ` +
+                `${written.assets.length} asset file(s), ` +
+                `${written.workspace_files.length} workspace file(s)`);
+            console.log(outPath);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+    projects
+        .command("import <file>")
+        .description("Import a .nodetool-project file as a new project")
+        .option("--name <name>", "Name for the new project (default: the exported name)")
+        .option("--json", "Output the result as JSON")
+        .action(async (file, opts) => {
+        try {
+            await setupLocalDb();
+            const { importProjectArchive, projectArchiveHost } = await import("@nodetool-ai/websocket");
+            const result = await importProjectArchive(new Uint8Array(await readFile(file)), {
+                userId: LOCAL_USER_ID,
+                name: opts.name,
+                ...projectArchiveHost()
+            });
+            for (const m of result.missing) {
+                console.error(`  warning: ${m} is listed but missing from the file`);
+            }
+            for (const m of result.checksumMismatches) {
+                console.error(`  warning: ${m} does not match its checksum`);
+            }
+            for (const skip of result.skipped) {
+                console.error(`  note: the export skipped ${skip.kind} ${skip.id}: ${skip.reason}`);
+            }
+            if (opts.json) {
+                asJson({
+                    project: result.project.toResponse(),
+                    counts: result.counts,
+                    missing: result.missing,
+                    checksum_mismatches: result.checksumMismatches,
+                    skipped: result.skipped
+                });
+                return;
+            }
+            console.log(result.project.id);
+        }
+        catch (e) {
+            fail(e);
+        }
+    });
+}
+//# sourceMappingURL=projects.js.map

package/dist/commands/projects.js.map

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

package/dist/commands/resource-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-read.d.ts","sourceRoot":"","sources":["../../src/commands/resource-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;CACrB;AA6GD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAC/D,IAAI,EAAE,gBAAgB,GACrB,IAAI,CAuPN"}
+{"version":3,"file":"resource-read.d.ts","sourceRoot":"","sources":["../../src/commands/resource-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;CACrB;AA6GD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAC/D,IAAI,EAAE,gBAAgB,GACrB,IAAI,CAiPN"}