@nodetool-ai/deploy 0.7.0-rc.11

package/dist/huggingface.js

@@ -0,0 +1,346 @@
+/**
+ * HuggingFace Spaces deployment implementation for NodeTool.
+ *
+ * Handles deployment to HuggingFace Spaces (Docker type), including:
+ * - Dockerfile generation from image spec
+ * - HF Space repository creation and management
+ * - Git-based deployment (push Dockerfile to HF repo, Spaces builds it)
+ * - Space metadata via README.md frontmatter
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+import { loadImageSpec } from "./image-spec.js";
+import { generateDockerfile } from "./image-builder.js";
+import { StateManager } from "./state.js";
+import { DeploymentStatus } from "./deployment-config.js";
+const execFileAsync = promisify(execFile);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Run the `huggingface-cli` command and return stdout.
+ * Throws a descriptive error when the CLI is not installed.
+ */
+async function hfCli(args, opts) {
+    try {
+        const { stdout } = await execFileAsync("huggingface-cli", args, {
+            timeout: opts?.timeout ?? 60_000,
+            cwd: opts?.cwd
+        });
+        return stdout;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        if (msg.includes("ENOENT")) {
+            throw new Error("huggingface-cli not found. Install it with: pip install huggingface_hub[cli]\n" +
+                "See https://huggingface.co/docs/huggingface_hub/guides/cli for details.");
+        }
+        throw new Error(`huggingface-cli failed: ${msg}`);
+    }
+}
+/**
+ * Run a git command and return stdout.
+ */
+async function git(args, opts) {
+    try {
+        const { stdout } = await execFileAsync("git", args, {
+            timeout: opts?.timeout ?? 60_000,
+            cwd: opts?.cwd
+        });
+        return stdout;
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new Error(`git command failed: ${msg}`);
+    }
+}
+/**
+ * Generate the README.md content with HuggingFace Spaces YAML frontmatter.
+ */
+function generateSpaceReadme(deployment) {
+    const frontmatter = [
+        "---",
+        "title: NodeTool",
+        'emoji: "\\U0001F527"',
+        "colorFrom: blue",
+        "colorTo: purple",
+        "sdk: docker",
+        "app_port: 7777"
+    ];
+    if (deployment.hardware) {
+        frontmatter.push(`hardware: ${deployment.hardware}`);
+    }
+    frontmatter.push("pinned: false");
+    frontmatter.push("---");
+    frontmatter.push("");
+    return frontmatter.join("\n");
+}
+// ---------------------------------------------------------------------------
+// HuggingFaceDeployer class
+// ---------------------------------------------------------------------------
+/**
+ * Handles deployment to HuggingFace Spaces.
+ *
+ * HF Spaces with Docker type build from a Dockerfile pushed to a git repo.
+ * This deployer generates the Dockerfile from the image spec, pushes it to
+ * the HF Space repository, and lets HuggingFace handle the build and deploy.
+ */
+export class HuggingFaceDeployer {
+    deploymentName;
+    deployment;
+    stateManager;
+    constructor(deploymentName, deployment, stateManager) {
+        this.deploymentName = deploymentName;
+        this.deployment = deployment;
+        this.stateManager = stateManager ?? new StateManager();
+    }
+    // ---------- Public API ----------
+    /**
+     * Generate a deployment plan showing what changes will be made.
+     */
+    async plan() {
+        const planResult = {
+            deployment_name: this.deploymentName,
+            type: "huggingface",
+            repo: this.deployment.repo,
+            changes: [],
+            will_create: [],
+            will_update: [],
+            will_destroy: []
+        };
+        const changes = planResult["changes"];
+        const willCreate = planResult["will_create"];
+        const currentState = await this.stateManager.readState(this.deploymentName);
+        if (!currentState || !currentState["last_deployed"]) {
+            changes.push("Initial deployment - will create HF Space repository");
+            willCreate.push(`HuggingFace Space: ${this.deployment.repo}`);
+            willCreate.push("Dockerfile (generated from image spec)");
+            willCreate.push("README.md (Space metadata)");
+        }
+        else {
+            changes.push("Will update Dockerfile and push to HF Space");
+            planResult["will_update"].push(`HuggingFace Space: ${this.deployment.repo}`);
+        }
+        if (this.deployment.hardware) {
+            changes.push(`Hardware: ${this.deployment.hardware}`);
+        }
+        if (this.deployment.environment) {
+            const envKeys = Object.keys(this.deployment.environment);
+            if (envKeys.length > 0) {
+                changes.push(`Environment variables: ${envKeys.join(", ")}`);
+            }
+        }
+        return planResult;
+    }
+    /**
+     * Apply the deployment to HuggingFace Spaces.
+     *
+     * Steps:
+     * 1. Load image spec and generate Dockerfile (not built locally)
+     * 2. Create or clone the HF Space repository
+     * 3. Write Dockerfile and README.md with Space metadata
+     * 4. Git commit and push to HuggingFace
+     * 5. HF Spaces auto-builds and deploys from the Dockerfile
+     * 6. Update deployment state
+     *
+     * @param opts.dryRun If true, only show what would be done without executing.
+     */
+    async apply(opts) {
+        if (!/^[\w-]+\/[\w.-]+$/.test(this.deployment.repo)) {
+            throw new Error(`Invalid HuggingFace repo: "${this.deployment.repo}". Expected "owner/name"`);
+        }
+        if (opts?.dryRun) {
+            return (await this.plan());
+        }
+        const results = {
+            deployment_name: this.deploymentName,
+            status: "success",
+            steps: [],
+            errors: []
+        };
+        const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "nodetool-hf-"));
+        try {
+            await this.stateManager.updateDeploymentStatus(this.deploymentName, DeploymentStatus.DEPLOYING);
+            // 1. Generate Dockerfile from image spec
+            results.steps.push("Loading image spec...");
+            const spec = await loadImageSpec(this.deployment.image);
+            results.steps.push("Generating Dockerfile...");
+            const dockerfileContent = generateDockerfile(spec);
+            // 2. Create or clone the HF repo
+            results.steps.push(`Setting up HuggingFace Space: ${this.deployment.repo}...`);
+            const token = process.env.HF_TOKEN || process.env.HUGGING_FACE_HUB_TOKEN;
+            const authArgs = token
+                ? ["-c", `http.extraHeader=Authorization: Bearer ${token}`]
+                : [];
+            await this.ensureRepo(tmpDir, results, authArgs);
+            const repoDir = path.join(tmpDir, "repo");
+            // 3. Write Dockerfile
+            results.steps.push("Writing Dockerfile...");
+            await fs.writeFile(path.join(repoDir, "Dockerfile"), dockerfileContent, "utf-8");
+            // 4. Write README.md with Space metadata
+            results.steps.push("Writing Space metadata (README.md)...");
+            const readme = generateSpaceReadme(this.deployment);
+            await fs.writeFile(path.join(repoDir, "README.md"), readme, "utf-8");
+            // 5. Git commit and push
+            results.steps.push("Committing and pushing to HuggingFace...");
+            await git(["config", "user.email", "deploy@nodetool.ai"], {
+                cwd: repoDir
+            });
+            await git(["config", "user.name", "NodeTool Deploy"], { cwd: repoDir });
+            await git(["add", "-A"], { cwd: repoDir });
+            // Check if there are changes to commit
+            try {
+                await git(["diff", "--cached", "--quiet"], { cwd: repoDir });
+                results.steps.push("No changes detected, skipping commit");
+            }
+            catch {
+                // diff --quiet exits non-zero when there are changes
+                await git(["commit", "-m", "Deploy NodeTool via nodetool deploy"], {
+                    cwd: repoDir
+                });
+                await git([...authArgs, "push", "origin", "main"], {
+                    cwd: repoDir,
+                    timeout: 120_000
+                });
+                results.steps.push("Pushed to HuggingFace Space");
+            }
+            results.steps.push("HuggingFace Spaces will now build and deploy the Dockerfile");
+            // 6. Update state
+            await this.stateManager.writeState(this.deploymentName, {
+                status: DeploymentStatus.SERVING,
+                repo: this.deployment.repo,
+                space_url: `https://huggingface.co/spaces/${this.deployment.repo}`
+            });
+        }
+        catch (e) {
+            results.status = "error";
+            results.errors.push(e instanceof Error ? e.message : String(e));
+            await this.stateManager.updateDeploymentStatus(this.deploymentName, DeploymentStatus.ERROR);
+            throw e;
+        }
+        finally {
+            // Clean up temp directory
+            try {
+                await fs.rm(tmpDir, { recursive: true, force: true });
+            }
+            catch {
+                // ignore cleanup errors
+            }
+        }
+        return results;
+    }
+    /**
+     * Destroy the HuggingFace Space.
+     */
+    async destroy() {
+        const results = {
+            deployment_name: this.deploymentName,
+            status: "success",
+            steps: [],
+            errors: []
+        };
+        try {
+            results.steps.push(`Deleting HuggingFace Space: ${this.deployment.repo}...`);
+            await hfCli([
+                "repo",
+                "delete",
+                this.deployment.repo,
+                "--type",
+                "space",
+                "--yes"
+            ]);
+            results.steps.push("Space deleted successfully");
+            await this.stateManager.updateDeploymentStatus(this.deploymentName, DeploymentStatus.DESTROYED);
+        }
+        catch (e) {
+            results.status = "error";
+            results.errors.push(e instanceof Error ? e.message : String(e));
+            await this.stateManager.updateDeploymentStatus(this.deploymentName, DeploymentStatus.ERROR);
+            throw e;
+        }
+        return results;
+    }
+    /**
+     * Get current deployment status.
+     */
+    async status() {
+        const statusInfo = {
+            deployment_name: this.deploymentName,
+            type: "huggingface",
+            repo: this.deployment.repo,
+            space_url: `https://huggingface.co/spaces/${this.deployment.repo}`
+        };
+        // Get state from state manager
+        const state = await this.stateManager.readState(this.deploymentName);
+        if (state) {
+            statusInfo["status"] = state["status"] ?? "unknown";
+            statusInfo["last_deployed"] = state["last_deployed"];
+        }
+        // Try to get live status from HF
+        try {
+            const output = await hfCli([
+                "repo",
+                "info",
+                this.deployment.repo,
+                "--type",
+                "space"
+            ]);
+            statusInfo["live_status"] = output.trim();
+        }
+        catch (e) {
+            statusInfo["live_status_error"] =
+                e instanceof Error ? e.message : String(e);
+        }
+        return statusInfo;
+    }
+    /**
+     * Get logs from the HuggingFace Space.
+     *
+     * HuggingFace Spaces does not expose logs via the CLI. Logs are available
+     * through the web UI at the Space URL.
+     */
+    async logs(_opts) {
+        const spaceUrl = `https://huggingface.co/spaces/${this.deployment.repo}`;
+        return (`HuggingFace Spaces logs are not available via the CLI.\n` +
+            `View logs in the web UI: ${spaceUrl}\n` +
+            `Navigate to the "Logs" tab in your Space settings.`);
+    }
+    // ---------- Private helpers ----------
+    /**
+     * Ensure the HF Space repository exists and is cloned to the target directory.
+     * Creates the repo if it does not exist, then clones it.
+     */
+    async ensureRepo(targetDir, results, authArgs = []) {
+        // Try to create the repo (may already exist)
+        try {
+            await hfCli([
+                "repo",
+                "create",
+                this.deployment.repo,
+                "--type",
+                "space",
+                "--space_sdk",
+                "docker",
+                "--yes"
+            ]);
+            results.steps.push(`Created HuggingFace Space: ${this.deployment.repo}`);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            // Ignore "already exists" errors
+            if (!msg.includes("already exists") && !msg.includes("409")) {
+                throw e;
+            }
+            results.steps.push(`HuggingFace Space already exists: ${this.deployment.repo}`);
+        }
+        // Clone into a subdirectory to avoid TOCTOU race on the temp dir
+        const repoDir = path.join(targetDir, "repo");
+        const repoUrl = `https://huggingface.co/spaces/${this.deployment.repo}`;
+        await git([...authArgs, "clone", repoUrl, repoDir], { timeout: 120_000 });
+        results.steps.push(`Cloned Space repository: ${this.deployment.repo}`);
+    }
+}
+//# sourceMappingURL=huggingface.js.map

package/dist/huggingface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"huggingface.js","sourceRoot":"","sources":["../src/huggingface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK1D,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,KAAK,UAAU,KAAK,CAClB,IAAc,EACd,IAAyC;IAEzC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,iBAAiB,EAAE,IAAI,EAAE;YAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,MAAM;YAChC,GAAG,EAAE,IAAI,EAAE,GAAG;SACf,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,gFAAgF;gBAC9E,yEAAyE,CAC5E,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,GAAG,CAChB,IAAc,EACd,IAAyC;IAEzC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE;YAClD,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,MAAM;YAChC,GAAG,EAAE,IAAI,EAAE,GAAG;SACf,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,UAAiC;IAC5D,MAAM,WAAW,GAAa;QAC5B,KAAK;QACL,iBAAiB;QACjB,sBAAsB;QACtB,iBAAiB;QACjB,iBAAiB;QACjB,aAAa;QACb,gBAAgB;KACjB,CAAC;IAEF,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxB,WAAW,CAAC,IAAI,CAAC,aAAa,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAClC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAErB,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IACrB,cAAc,CAAS;IACvB,UAAU,CAAwB;IAClC,YAAY,CAAe;IAEpC,YACE,cAAsB,EACtB,UAAiC,EACjC,YAA2B;QAE3B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,YAAY,EAAE,CAAC;IACzD,CAAC;IAED,mCAAmC;IAEnC;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,UAAU,GAA4B;YAC1C,eAAe,EAAE,IAAI,CAAC,cAAc;YACpC,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;YAC1B,OAAO,EAAE,EAAc;YACvB,WAAW,EAAE,EAAc;YAC3B,WAAW,EAAE,EAAc;YAC3B,YAAY,EAAE,EAAc;SAC7B,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAa,CAAC;QAClD,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,CAAa,CAAC;QAEzD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAE5E,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;YACrE,UAAU,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9D,UAAU,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;YAC1D,UAAU,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC3D,UAAU,CAAC,aAAa,CAAc,CAAC,IAAI,CAC1C,sBAAsB,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAC7C,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YACzD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,KAAK,CAAC,IAA2B;QACrC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,8BAA8B,IAAI,CAAC,UAAU,CAAC,IAAI,0BAA0B,CAC7E,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAA4B,CAAC;QACxD,CAAC;QAED,MAAM,OAAO,GAAiB;YAC5B,eAAe,EAAE,IAAI,CAAC,cAAc;YACpC,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;SACX,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QAExE,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,sBAAsB,CAC5C,IAAI,CAAC,cAAc,EACnB,gBAAgB,CAAC,SAAS,CAC3B,CAAC;YAEF,yCAAyC;YACzC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAExD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YAC/C,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAEnD,iCAAiC;YACjC,OAAO,CAAC,KAAK,CAAC,IAAI,CAChB,iCAAiC,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAC3D,CAAC;YACF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;YACzE,MAAM,QAAQ,GAAG,KAAK;gBACpB,CAAC,CAAC,CAAC,IAAI,EAAE,0CAA0C,KAAK,EAAE,CAAC;gBAC3D,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAE1C,sBAAsB;YACtB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAC5C,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,EAChC,iBAAiB,EACjB,OAAO,CACR,CAAC;YAEF,yCAAyC;YACzC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACpD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAErE,yBAAyB;YACzB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YAC/D,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,oBAAoB,CAAC,EAAE;gBACxD,GAAG,EAAE,OAAO;aACb,CAAC,CAAC;YACH,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YACxE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YAE3C,uCAAuC;YACvC,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC7D,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACP,qDAAqD;gBACrD,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,qCAAqC,CAAC,EAAE;oBACjE,GAAG,EAAE,OAAO;iBACb,CAAC,CAAC;gBACH,MAAM,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACjD,GAAG,EAAE,OAAO;oBACZ,OAAO,EAAE,OAAO;iBACjB,CAAC,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YACpD,CAAC;YAED,OAAO,CAAC,KAAK,CAAC,IAAI,CAChB,6DAA6D,CAC9D,CAAC;YAEF,kBAAkB;YAClB,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,EAAE;gBACtD,MAAM,EAAE,gBAAgB,CAAC,OAAO;gBAChC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;gBAC1B,SAAS,EAAE,iCAAiC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;aACnE,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAEhE,MAAM,IAAI,CAAC,YAAY,CAAC,sBAAsB,CAC5C,IAAI,CAAC,cAAc,EACnB,gBAAgB,CAAC,KAAK,CACvB,CAAC;YAEF,MAAM,CAAC,CAAC;QACV,CAAC;gBAAS,CAAC;YACT,0BAA0B;YAC1B,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,OAAO,GAAiB;YAC5B,eAAe,EAAE,IAAI,CAAC,cAAc;YACpC,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;SACX,CAAC;QAEF,IAAI,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,IAAI,CAChB,+BAA+B,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CACzD,CAAC;YAEF,MAAM,KAAK,CAAC;gBACV,MAAM;gBACN,QAAQ;gBACR,IAAI,CAAC,UAAU,CAAC,IAAI;gBACpB,QAAQ;gBACR,OAAO;gBACP,OAAO;aACR,CAAC,CAAC;YAEH,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAEjD,MAAM,IAAI,CAAC,YAAY,CAAC,sBAAsB,CAC5C,IAAI,CAAC,cAAc,EACnB,gBAAgB,CAAC,SAAS,CAC3B,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAChE,MAAM,IAAI,CAAC,YAAY,CAAC,sBAAsB,CAC5C,IAAI,CAAC,cAAc,EACnB,gBAAgB,CAAC,KAAK,CACvB,CAAC;YACF,MAAM,CAAC,CAAC;QACV,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,UAAU,GAA4B;YAC1C,eAAe,EAAE,IAAI,CAAC,cAAc;YACpC,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;YAC1B,SAAS,EAAE,iCAAiC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;SACnE,CAAC;QAEF,+BAA+B;QAC/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrE,IAAI,KAAK,EAAE,CAAC;YACV,UAAU,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC;YACpD,UAAU,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;QACvD,CAAC;QAED,iCAAiC;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;gBACzB,MAAM;gBACN,MAAM;gBACN,IAAI,CAAC,UAAU,CAAC,IAAI;gBACpB,QAAQ;gBACR,OAAO;aACR,CAAC,CAAC;YACH,UAAU,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,UAAU,CAAC,mBAAmB,CAAC;gBAC7B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,KAA2C;QACpD,MAAM,QAAQ,GAAG,iCAAiC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACzE,OAAO,CACL,0DAA0D;YAC1D,4BAA4B,QAAQ,IAAI;YACxC,oDAAoD,CACrD,CAAC;IACJ,CAAC;IAED,wCAAwC;IAExC;;;OAGG;IACK,KAAK,CAAC,UAAU,CACtB,SAAiB,EACjB,OAAqB,EACrB,WAAqB,EAAE;QAEvB,6CAA6C;QAC7C,IAAI,CAAC;YACH,MAAM,KAAK,CAAC;gBACV,MAAM;gBACN,QAAQ;gBACR,IAAI,CAAC,UAAU,CAAC,IAAI;gBACpB,QAAQ;gBACR,OAAO;gBACP,aAAa;gBACb,QAAQ;gBACR,OAAO;aACR,CAAC,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,8BAA8B,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,iCAAiC;YACjC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,MAAM,CAAC,CAAC;YACV,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAChB,qCAAqC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAC5D,CAAC;QACJ,CAAC;QAED,iEAAiE;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,iCAAiC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACxE,MAAM,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1E,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/image-builder.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Docker image builder for NodeTool.
+ *
+ * Generates Dockerfiles from an ImageBuildSpec and runs `docker build`.
+ * Layer ordering is designed for optimal Docker cache utilization:
+ * base → apt → python install → pip → copy server → copy web UI → entrypoint.
+ */
+import type { ImageBuildSpec } from "./image-spec.js";
+/**
+ * Generate a complete Dockerfile from an image build spec.
+ *
+ * The generated Dockerfile follows a layered approach for cache efficiency:
+ * 1. Base image (node:20-slim or nvidia/cuda if CUDA is set)
+ * 2. System packages via apt-get (if any)
+ * 3. Python installation (if python section present)
+ * 4. pip packages (if any)
+ * 5. Copy Node.js server bundle
+ * 6. Copy web UI build (if mode is fullstack)
+ * 7. Entrypoint
+ */
+export declare function generateDockerfile(spec: ImageBuildSpec): string;
+/**
+ * Build a Docker image from an image build spec.
+ *
+ * Generates a Dockerfile in the context directory, runs `docker build`,
+ * and cleans up the generated Dockerfile afterwards.
+ *
+ * @param spec - The image build specification.
+ * @param tag - Docker image tag (e.g. "nodetool:latest").
+ * @param opts.contextDir - Build context directory. Defaults to current directory.
+ */
+export declare function buildImage(spec: ImageBuildSpec, tag: string, opts?: {
+    contextDir?: string;
+}): Promise<void>;
+//# sourceMappingURL=image-builder.d.ts.map

package/dist/image-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-builder.d.ts","sourceRoot":"","sources":["../src/image-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQtD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAyH/D;AAMD;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/image-builder.js

@@ -0,0 +1,157 @@
+/**
+ * Docker image builder for NodeTool.
+ *
+ * Generates Dockerfiles from an ImageBuildSpec and runs `docker build`.
+ * Layer ordering is designed for optimal Docker cache utilization:
+ * base → apt → python install → pip → copy server → copy web UI → entrypoint.
+ */
+import { execFile as execFileCb } from "child_process";
+import { promisify } from "util";
+import * as fs from "fs/promises";
+import * as path from "path";
+const execFile = promisify(execFileCb);
+// ============================================================================
+// Dockerfile Generation
+// ============================================================================
+/**
+ * Generate a complete Dockerfile from an image build spec.
+ *
+ * The generated Dockerfile follows a layered approach for cache efficiency:
+ * 1. Base image (node:20-slim or nvidia/cuda if CUDA is set)
+ * 2. System packages via apt-get (if any)
+ * 3. Python installation (if python section present)
+ * 4. pip packages (if any)
+ * 5. Copy Node.js server bundle
+ * 6. Copy web UI build (if mode is fullstack)
+ * 7. Entrypoint
+ */
+export function generateDockerfile(spec) {
+    // --- Validate package names against shell injection ---
+    const SAFE_APT_PKG = /^[a-z0-9.+-]+$/;
+    const SAFE_PIP_PKG = /^[a-zA-Z0-9._[\]~=<>!,+-]+$/;
+    for (const pkg of spec.apt_packages) {
+        if (!SAFE_APT_PKG.test(pkg))
+            throw new Error(`Invalid apt package name: ${pkg}`);
+    }
+    if (spec.python) {
+        for (const pkg of spec.python.packages) {
+            if (!SAFE_PIP_PKG.test(pkg))
+                throw new Error(`Invalid pip package name: ${pkg}`);
+        }
+        if (!/^https?:\/\//.test(spec.python.index_url)) {
+            throw new Error(`Invalid index URL (must start with http:// or https://): ${spec.python.index_url}`);
+        }
+        for (const url of spec.python.extra_index_urls) {
+            if (!/^https?:\/\//.test(url)) {
+                throw new Error(`Invalid extra index URL (must start with http:// or https://): ${url}`);
+            }
+        }
+    }
+    const lines = [];
+    // --- Base image ---
+    if (spec.cuda) {
+        // CUDA tags require 3-part versions (e.g. 12.1.0, not 12.1)
+        const cudaVersion = spec.cuda.split(".").length === 2 ? `${spec.cuda}.0` : spec.cuda;
+        lines.push(`FROM nvidia/cuda:${cudaVersion}-runtime-ubuntu22.04`);
+    }
+    else {
+        lines.push("FROM node:20-slim");
+    }
+    lines.push("");
+    // --- Add deadsnakes PPA for non-default Python versions ---
+    if (spec.python) {
+        lines.push("RUN apt-get update && apt-get install -y --no-install-recommends software-properties-common \\");
+        lines.push("    && add-apt-repository ppa:deadsnakes/ppa \\");
+        lines.push("    && apt-get update && rm -rf /var/lib/apt/lists/*");
+        lines.push("");
+    }
+    // --- Collect apt packages ---
+    const aptPackages = [...spec.apt_packages];
+    if (spec.python) {
+        aptPackages.push(`python${spec.python.version}`, `python${spec.python.version}-venv`);
+    }
+    if (spec.cuda) {
+        // Need curl for nodesource setup
+        if (!aptPackages.includes("curl")) {
+            aptPackages.push("curl");
+        }
+    }
+    // --- apt-get install ---
+    if (aptPackages.length > 0) {
+        lines.push("RUN apt-get update && apt-get install -y --no-install-recommends \\");
+        lines.push(`    ${aptPackages.join(" ")} \\`);
+        lines.push("    && rm -rf /var/lib/apt/lists/*");
+        lines.push("");
+    }
+    // --- Install Node.js on CUDA base (which lacks Node) ---
+    if (spec.cuda) {
+        lines.push("# Install Node.js");
+        lines.push("RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \\");
+        lines.push("    && apt-get install -y --no-install-recommends nodejs \\");
+        lines.push("    && rm -rf /var/lib/apt/lists/*");
+        lines.push("");
+    }
+    // --- Create Python venv (ensures pip targets the correct interpreter) ---
+    if (spec.python) {
+        lines.push(`RUN python${spec.python.version} -m venv /opt/venv`);
+        lines.push('ENV PATH="/opt/venv/bin:$PATH"');
+        lines.push("");
+    }
+    // --- pip install ---
+    if (spec.python && spec.python.packages.length > 0) {
+        const pipArgs = ["pip install --no-cache-dir"];
+        pipArgs.push(`--index-url "${spec.python.index_url}"`);
+        for (const url of spec.python.extra_index_urls) {
+            pipArgs.push(`--extra-index-url "${url}"`);
+        }
+        pipArgs.push(spec.python.packages.join(" "));
+        lines.push(`RUN ${pipArgs.join(" \\\n    ")}`);
+        lines.push("");
+    }
+    // --- Copy server bundle ---
+    lines.push("WORKDIR /app");
+    lines.push("COPY server/ .");
+    // --- Copy web UI (fullstack only) ---
+    if (spec.mode === "fullstack") {
+        lines.push("COPY web/build/ ./public/");
+    }
+    // --- Expose and entrypoint ---
+    lines.push("EXPOSE 7777");
+    lines.push('CMD ["node", "server.js"]');
+    lines.push("");
+    return lines.join("\n");
+}
+// ============================================================================
+// Image Building
+// ============================================================================
+/**
+ * Build a Docker image from an image build spec.
+ *
+ * Generates a Dockerfile in the context directory, runs `docker build`,
+ * and cleans up the generated Dockerfile afterwards.
+ *
+ * @param spec - The image build specification.
+ * @param tag - Docker image tag (e.g. "nodetool:latest").
+ * @param opts.contextDir - Build context directory. Defaults to current directory.
+ */
+export async function buildImage(spec, tag, opts) {
+    const contextDir = opts?.contextDir ?? process.cwd();
+    const dockerfile = generateDockerfile(spec);
+    const dockerfilePath = path.join(contextDir, "Dockerfile.nodetool");
+    try {
+        await fs.writeFile(dockerfilePath, dockerfile, "utf-8");
+        await execFile("docker", ["build", "-f", dockerfilePath, "-t", tag, "."], {
+            cwd: contextDir,
+            maxBuffer: 50 * 1024 * 1024 // 50 MB
+        });
+    }
+    finally {
+        try {
+            await fs.unlink(dockerfilePath);
+        }
+        catch {
+            // ignore cleanup errors
+        }
+    }
+}
+//# sourceMappingURL=image-builder.js.map

package/dist/image-builder.js.map

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

package/dist/image-spec.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Image build specification for NodeTool Docker images.
+ *
+ * This module provides a Zod schema and loader for `nodetool-image.yaml` files
+ * that declaratively describe what goes into a Docker image.
+ */
+import { z } from "zod";
+declare const PythonConfigSchema: z.ZodObject<{
+    version: z.ZodString;
+    packages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    index_url: z.ZodDefault<z.ZodString>;
+    extra_index_urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const ImageBuildSpecSchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        fullstack: "fullstack";
+        backend: "backend";
+    }>>;
+    apt_packages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    python: z.ZodOptional<z.ZodObject<{
+        version: z.ZodString;
+        packages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        index_url: z.ZodDefault<z.ZodString>;
+        extra_index_urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    cuda: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ImageBuildSpec = z.infer<typeof ImageBuildSpecSchema>;
+export type PythonConfig = z.infer<typeof PythonConfigSchema>;
+/** Parse and validate raw data into an ImageBuildSpec. */
+export declare function parseImageSpec(data: unknown): ImageBuildSpec;
+/**
+ * Load an image build spec from a YAML file.
+ *
+ * Reads the file at `specPath`, parses it as YAML, and validates it against
+ * the ImageBuildSpec schema. An empty or null YAML document produces a valid
+ * spec with all defaults applied.
+ */
+export declare function loadImageSpec(specPath: string): Promise<ImageBuildSpec>;
+export {};
+//# sourceMappingURL=image-spec.d.ts.map

package/dist/image-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-spec.d.ts","sourceRoot":"","sources":["../src/image-spec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,QAAA,MAAM,kBAAkB;;;;;iBAOtB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAQ/B,CAAC;AAMH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAE5D;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAI7E"}

package/dist/image-spec.js

@@ -0,0 +1,49 @@
+/**
+ * Image build specification for NodeTool Docker images.
+ *
+ * This module provides a Zod schema and loader for `nodetool-image.yaml` files
+ * that declaratively describe what goes into a Docker image.
+ */
+import { z } from "zod";
+import * as fs from "fs/promises";
+import * as yaml from "js-yaml";
+// ============================================================================
+// Schemas
+// ============================================================================
+const PythonConfigSchema = z.object({
+    version: z
+        .string()
+        .regex(/^\d+\.\d+$/, "Python version must be 'X.Y' format (e.g. '3.11')"),
+    packages: z.array(z.string()).default([]),
+    index_url: z.string().default("https://pypi.org/simple"),
+    extra_index_urls: z.array(z.string()).default([])
+});
+export const ImageBuildSpecSchema = z.object({
+    mode: z.enum(["fullstack", "backend"]).default("fullstack"),
+    apt_packages: z.array(z.string()).default([]),
+    python: PythonConfigSchema.optional(),
+    cuda: z
+        .string()
+        .regex(/^\d+\.\d+(\.\d+)?$/, "CUDA version must be 'X.Y' or 'X.Y.Z' format")
+        .optional()
+});
+// ============================================================================
+// Parsing and Loading
+// ============================================================================
+/** Parse and validate raw data into an ImageBuildSpec. */
+export function parseImageSpec(data) {
+    return ImageBuildSpecSchema.parse(data);
+}
+/**
+ * Load an image build spec from a YAML file.
+ *
+ * Reads the file at `specPath`, parses it as YAML, and validates it against
+ * the ImageBuildSpec schema. An empty or null YAML document produces a valid
+ * spec with all defaults applied.
+ */
+export async function loadImageSpec(specPath) {
+    const raw = await fs.readFile(specPath, "utf-8");
+    const data = yaml.load(raw, { schema: yaml.JSON_SCHEMA });
+    return parseImageSpec(data ?? {});
+}
+//# sourceMappingURL=image-spec.js.map