@nodetool-ai/deploy 0.7.0-rc.11

package/dist/docker-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-run.d.ts","sourceRoot":"","sources":["../src/docker-run.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,YAAY,OAAO,CAAC;AAOjC,oDAAoD;AACpD,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,kCAAkC;AAClC,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sCAAsC;AACtC,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,kCAAkC;AAClC,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAKxD;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,SAAgB,UAAU,EAAE,mBAAmB,CAAC;IAChD,SAAgB,SAAS,EAAE,eAAe,CAAC;IAC3C,SAAgB,cAAc,EAAE,MAAM,CAAC;gBAGrC,UAAU,EAAE,mBAAmB,EAC/B,cAAc,GAAE,MAAiB;IAOnC,+CAA+C;IAC/C,eAAe,IAAI,MAAM;IAgDzB;;;OAGG;IACH,YAAY,IAAI,MAAM;IAgBtB,mCAAmC;IACnC,gBAAgB,IAAI,MAAM;IAQ1B,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,gBAAgB;IA4CxB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,YAAY;CAQrB;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,mBAAmB,GAC9B,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAGxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAGxE"}

package/dist/docker-run.js

@@ -0,0 +1,202 @@
+/**
+ * Docker run command generation for self-hosted deployments.
+ *
+ * This module generates docker run commands from deployment configuration,
+ * supporting GPU assignments, volume mounts, and environment variables.
+ */
+import * as crypto from "node:crypto";
+import { shellEscape } from "./docker.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const INTERNAL_API_PORT = 7777;
+export const APP_ENV_PORT = 8000;
+/** Compute the full image name (name:tag). */
+export function imageFullName(image) {
+    if (image.name.includes("@"))
+        return image.name;
+    const lastSegment = image.name.split("/").pop() ?? image.name;
+    if (lastSegment.includes(":"))
+        return image.name;
+    return `${image.name}:${image.tag}`;
+}
+// ---------------------------------------------------------------------------
+// Safe shlex quote (allows ~/...)
+// ---------------------------------------------------------------------------
+function safeShellQuote(s) {
+    if (s.startsWith("~/")) {
+        return "~/" + shellEscape(s.slice(2));
+    }
+    return shellEscape(s);
+}
+// ---------------------------------------------------------------------------
+// DockerRunGenerator
+// ---------------------------------------------------------------------------
+/**
+ * Generates docker run command from deployment settings.
+ *
+ * Handles conversion of NodeTool deployment configuration into a docker run
+ * command suitable for single container deployment.
+ */
+export class DockerRunGenerator {
+    deployment;
+    container;
+    runtimeCommand;
+    constructor(deployment, runtimeCommand = "docker") {
+        this.deployment = deployment;
+        this.container = deployment.container;
+        this.runtimeCommand = runtimeCommand;
+    }
+    /** Generate docker run command as a string. */
+    generateCommand() {
+        const parts = [`${shellEscape(this.runtimeCommand)} run`];
+        // Detached mode
+        parts.push("-d");
+        // Container name
+        const containerName = `nodetool-${this.container.name}`;
+        parts.push(`--name ${shellEscape(containerName)}`);
+        // Restart policy
+        parts.push("--restart unless-stopped");
+        // Port mapping
+        const hostPort = this.resolveHostPort();
+        parts.push(`-p ${hostPort}:${INTERNAL_API_PORT}`);
+        // Volume mounts
+        for (const volume of this.buildVolumes()) {
+            parts.push(`-v ${volume}`);
+        }
+        // Environment variables
+        for (const env of this.buildEnvironment()) {
+            parts.push(`-e ${env}`);
+        }
+        // GPU configuration
+        if (this.container.gpu) {
+            const gpuArgs = this.buildGpuArgs();
+            parts.push(...gpuArgs);
+        }
+        // Health check
+        const healthcheck = `--health-cmd="curl -f http://localhost:${INTERNAL_API_PORT}/health || exit 1" ` +
+            "--health-interval=30s " +
+            "--health-timeout=10s " +
+            "--health-retries=3 " +
+            "--health-start-period=40s";
+        parts.push(healthcheck);
+        // Image name
+        parts.push(shellEscape(imageFullName(this.deployment.image)));
+        return parts.join(" \\\n  ");
+    }
+    /**
+     * Generate a hash of the docker run configuration.
+     * Can be used to detect changes in the configuration.
+     */
+    generateHash() {
+        const configDict = {
+            image: imageFullName(this.deployment.image),
+            container_name: this.container.name,
+            port: this.resolveHostPort(),
+            volumes: this.buildVolumes(),
+            environment: this.buildEnvironment().sort(),
+            gpu: this.container.gpu ?? null
+        };
+        const configStr = JSON.stringify(configDict, Object.keys(configDict).sort());
+        return crypto.createHash("sha256").update(configStr).digest("hex");
+    }
+    /** Get the full container name. */
+    getContainerName() {
+        return `nodetool-${this.container.name}`;
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    buildVolumes() {
+        const volumes = [];
+        // Workspace volume (read-write)
+        const workspacePath = this.deployment.paths.workspace;
+        volumes.push(`${workspacePath}:/workspace`);
+        // HuggingFace cache volume
+        const persistentPaths = this.deployment.persistentPaths;
+        if (persistentPaths) {
+            volumes.push(`${this.deployment.paths.hfCache}:/hf-cache`);
+        }
+        else {
+            volumes.push(`${this.deployment.paths.hfCache}:/hf-cache:ro`);
+        }
+        return volumes.map(safeShellQuote);
+    }
+    buildEnvironment() {
+        // Start with container environment
+        const env = {
+            ...(this.container.environment ?? {})
+        };
+        // Add container-specific settings
+        env["PORT"] = String(APP_ENV_PORT);
+        env["NODETOOL_API_URL"] = `http://localhost:${this.container.port}`;
+        env["NODETOOL_SERVER_MODE"] = "private";
+        // Configure paths from persistentPaths if available
+        const persistentPaths = this.deployment.persistentPaths;
+        if (persistentPaths) {
+            env["USERS_FILE"] = persistentPaths.usersFile;
+            env["DB_PATH"] = persistentPaths.dbPath;
+            env["CHROMA_PATH"] = persistentPaths.chromaPath;
+            env["HF_HOME"] = persistentPaths.hfCache;
+            env["ASSET_BUCKET"] = persistentPaths.assetBucket;
+            env["AUTH_PROVIDER"] = "multi_user";
+        }
+        else {
+            env["DB_PATH"] = "/workspace/nodetool.db";
+            env["HF_HOME"] = "/hf-cache";
+            if (!env["AUTH_PROVIDER"]) {
+                env["AUTH_PROVIDER"] = "static";
+            }
+        }
+        // Add workflow IDs if specified
+        if (this.container.workflows && this.container.workflows.length > 0) {
+            env["NODETOOL_WORKFLOWS"] = this.container.workflows.join(",");
+        }
+        // Add authentication token for self-hosted deployments
+        if (this.deployment.serverAuthToken) {
+            env["SERVER_AUTH_TOKEN"] = this.deployment.serverAuthToken;
+        }
+        // Convert to KEY=value format and quote
+        return Object.entries(env).map(([key, value]) => safeShellQuote(`${key}=${value}`));
+    }
+    resolveHostPort() {
+        const hostPort = this.container.port || APP_ENV_PORT;
+        if (hostPort === INTERNAL_API_PORT) {
+            return APP_ENV_PORT;
+        }
+        return hostPort;
+    }
+    buildGpuArgs() {
+        if (!this.container.gpu)
+            return [];
+        const gpuIds = this.container.gpu.trim();
+        // Format: --gpus '"device=0,1"' for multiple GPUs
+        const quotedDevice = shellEscape(`"device=${gpuIds}"`);
+        return [`--gpus ${quotedDevice}`];
+    }
+}
+// ---------------------------------------------------------------------------
+// Convenience functions
+// ---------------------------------------------------------------------------
+/**
+ * Generate docker run command from deployment configuration.
+ */
+export function generateDockerRunCommand(deployment) {
+    const generator = new DockerRunGenerator(deployment);
+    return generator.generateCommand();
+}
+/**
+ * Get hash of the docker run configuration for change detection.
+ */
+export function getDockerRunHash(deployment) {
+    const generator = new DockerRunGenerator(deployment);
+    return generator.generateHash();
+}
+/**
+ * Get the container name for the deployment.
+ */
+export function getContainerName(deployment) {
+    const generator = new DockerRunGenerator(deployment);
+    return generator.getContainerName();
+}
+//# sourceMappingURL=docker-run.js.map

package/dist/docker-run.js.map

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

package/dist/docker.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Docker utilities for NodeTool deployment.
+ *
+ * This module contains all Docker-related functionality for building, pushing,
+ * and managing Docker images for NodeTool deployments.
+ */
+import { execFile } from "node:child_process";
+/**
+ * Promisified `child_process.execFile` — runs a command with an argument array
+ * and no shell, returning `{ stdout, stderr }`.
+ */
+export declare const execFileAsync: typeof execFile.__promisify__;
+/**
+ * Escape a string for safe shell inclusion (single-quote wrapping).
+ */
+export declare function shellEscape(value: string): string;
+/**
+ * Run a command safely without shell expansion.
+ *
+ * @param command Shell command string to run.
+ * @param captureOutput If true, capture and return output. If false, stream output.
+ * @returns Captured output if captureOutput=true, empty string otherwise.
+ */
+export declare function runCommand(command: string, captureOutput?: boolean): string;
+/**
+ * Run a command safely using execFileSync with an argument array (no shell).
+ *
+ * @param program The executable to run (e.g. "docker").
+ * @param args    Array of arguments passed directly to the program.
+ * @param options.captureOutput If true, capture and return stdout.
+ * @returns Captured output if captureOutput=true, empty string otherwise.
+ */
+export declare function runCommandArgs(program: string, args: string[], options?: {
+    captureOutput?: boolean;
+}): string;
+/**
+ * Check if user is authenticated with the Docker registry.
+ */
+export declare function checkDockerAuth(_registry?: string): boolean;
+/**
+ * Ensure user is authenticated with Docker registry.
+ * Note: interactive login prompt is not supported in this TS port;
+ * the function will throw if not authenticated.
+ */
+export declare function ensureDockerAuth(registry?: string): void;
+/**
+ * Format the image name with proper registry and username prefix.
+ *
+ * @example
+ * formatImageName("my-workflow", "myuser") // "myuser/my-workflow"
+ * formatImageName("my-workflow", "myuser", "ghcr.io") // "ghcr.io/myuser/my-workflow"
+ */
+export declare function formatImageName(baseName: string, dockerUsername: string, registry?: string): string;
+/**
+ * Generate a unique image tag based on current timestamp and random hash.
+ *
+ * @returns A unique tag in format 'YYYYMMDD-HHMMSS-abcdef'
+ */
+export declare function generateImageTag(): string;
+export interface BuildDockerImageOptions {
+    imageName: string;
+    tag: string;
+    platform?: string;
+    useCache?: boolean;
+    autoPush?: boolean;
+}
+/**
+ * Build a Docker image for deployment.
+ *
+ * @returns true if the image was pushed to registry, false if only built locally.
+ */
+export declare function buildDockerImage(options: BuildDockerImageOptions): boolean;
+/**
+ * Push Docker image to a registry with proper authentication checks.
+ */
+export declare function pushToRegistry(imageName: string, tag: string, registry?: string): void;
+/**
+ * Get Docker username from Docker's configuration file.
+ */
+export declare function getDockerUsernameFromConfig(registry?: string): string | null;
+export interface RunDockerImageOptions {
+    imageName: string;
+    tag: string;
+    hostPort: number;
+    containerPort?: number;
+    containerName?: string;
+    env?: Record<string, string>;
+    volumes?: Array<[string, string]>;
+    detach?: boolean;
+    gpus?: string | boolean;
+    remove?: boolean;
+    extraArgs?: string[];
+}
+/**
+ * Run a Docker image and map it to a given host port.
+ */
+export declare function runDockerImage(options: RunDockerImageOptions): void;
+//# sourceMappingURL=docker.d.ts.map

package/dist/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../src/docker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA0B,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAOtE;;;GAGG;AACH,eAAO,MAAM,aAAa,+BAAsB,CAAC;AAMjD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAMD;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,OAAe,GAC7B,MAAM,CAuBR;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpC,MAAM,CA0BR;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAAoB,GAAG,OAAO,CAkBxE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,MAAoB,GAAG,IAAI,CAMrE;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,QAAQ,GAAE,MAAoB,GAC7B,MAAM,CAKR;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAqBzC;AAMD,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAsH1E;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAoB,GAC7B,IAAI,CAkBN;AAMD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,GAAE,MAAoB,GAC7B,MAAM,GAAG,IAAI,CAkDf;AAMD,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAoDnE"}