@nodetool-ai/deploy 0.7.0-rc.23 → 0.8.2

package/dist/runpod-rest.d.ts

@@ -0,0 +1,114 @@
+/**
+ * RunPod Pod management over the REST API (https://rest.runpod.io/v1).
+ *
+ * The serverless helpers in `runpod-api.ts` create templates/endpoints (the
+ * job/queue model) and read the API key from `process.env`. This module manages
+ * **persistent Pods** — the right shape for a long-lived NodeTool WebSocket
+ * worker the server/CLI attaches to — and takes the API key **explicitly** so it
+ * can be sourced from the per-user secret store (`getSecret`), never the
+ * environment.
+ *
+ * REST surface used: POST /v1/pods, GET /v1/pods/{id}, POST /v1/pods/{id}/stop,
+ * DELETE /v1/pods/{id}, GET /v1/pods.
+ */
+/** Request body for POST /v1/pods (subset we use; see the REST reference). */
+export interface RunpodPodSpec {
+    name: string;
+    imageName: string;
+    computeType?: "CPU" | "GPU";
+    vcpuCount?: number;
+    cpuFlavorIds?: string[];
+    cpuFlavorPriority?: "availability" | "custom";
+    gpuTypeIds?: string[];
+    gpuCount?: number;
+    ports?: string[];
+    env?: Record<string, string>;
+    containerDiskInGb?: number;
+    volumeInGb?: number;
+    volumeMountPath?: string;
+    networkVolumeId?: string;
+    dockerEntrypoint?: string[];
+    dockerStartCmd?: string[];
+    supportPublicIp?: boolean;
+    globalNetworking?: boolean;
+    dataCenterIds?: string[];
+}
+/** Pod as returned by GET /v1/pods/{id} (fields we read). */
+export interface RunpodPod {
+    id: string;
+    name?: string;
+    desiredStatus?: "RUNNING" | "EXITED" | "TERMINATED" | string;
+    image?: string;
+    /** Public IPv4; empty/null while the Pod is initializing. */
+    publicIp?: string | null;
+    /** Internal→external port map, e.g. {"7777": 41021}. */
+    portMappings?: Record<string, number> | null;
+    ports?: string[];
+    [k: string]: unknown;
+}
+/** Create (and deploy) a Pod. POST /v1/pods. */
+export declare function createPod(apiKey: string, spec: RunpodPodSpec): Promise<RunpodPod>;
+/** Get a Pod by id. GET /v1/pods/{id}. */
+export declare function getPod(apiKey: string, id: string): Promise<RunpodPod>;
+/** List Pods. GET /v1/pods. */
+export declare function listPods(apiKey: string): Promise<RunpodPod[]>;
+/** Stop a Pod (releases compute, keeps the volume). POST /v1/pods/{id}/stop. */
+export declare function stopPod(apiKey: string, id: string): Promise<void>;
+/** Terminate a Pod (deletes it). DELETE /v1/pods/{id}. */
+export declare function deletePod(apiKey: string, id: string): Promise<void>;
+/**
+ * Direct TCP WebSocket URL for an exposed `/tcp` port, or null while the Pod
+ * lacks a public IP / port mapping. Preferred for large frames (no HTTP proxy).
+ */
+export declare function podDirectWsUrl(pod: RunpodPod, internalPort: number): string | null;
+/**
+ * RunPod HTTP-proxy WebSocket URL for an exposed `/http` port. TLS-terminated
+ * by RunPod; subject to the proxy's size/timeout limits (fine for small frames).
+ */
+export declare function podProxyWsUrl(podId: string, internalPort: number): string;
+export interface DeployWorkerPodOptions {
+    /** Pod name. */
+    name: string;
+    /** Registry image RunPod pulls (must be reachable by RunPod). */
+    image: string;
+    /** Shared-secret passed as NODETOOL_WORKER_TOKEN (gates the ws handshake). */
+    workerToken?: string;
+    /** Internal port the worker serves on. Default 7777. */
+    internalPort?: number;
+    /** Expose via RunPod HTTP proxy ("http" → wss proxy) or direct TCP. */
+    exposure?: "http" | "tcp";
+    computeType?: "CPU" | "GPU";
+    vcpuCount?: number;
+    gpuTypeIds?: string[];
+    containerDiskInGb?: number;
+    /** Extra env merged into the container. */
+    env?: Record<string, string>;
+    /** Poll budget for the Pod to reach RUNNING + expose its endpoint. */
+    timeoutMs?: number;
+}
+export interface DeployedWorkerPod {
+    podId: string;
+    /** ws/wss URL to set as NODETOOL_WORKER_URL. */
+    wsUrl: string;
+    pod: RunpodPod;
+}
+/**
+ * Deploy a NodeTool worker image as a persistent RunPod Pod and wait until it is
+ * RUNNING with a resolvable WebSocket endpoint. Does NOT read process.env — pass
+ * `apiKey` (from the secret store) and `workerToken` explicitly.
+ *
+ * Reaching RUNNING + having an endpoint does not guarantee the worker process
+ * has finished loading nodes; the caller should connect with retry.
+ */
+export declare function deployWorkerPod(apiKey: string, opts: DeployWorkerPodOptions): Promise<DeployedWorkerPod>;
+/** Poll GET /v1/pods/{id} until RUNNING with a resolvable endpoint. */
+export declare function waitForPodEndpoint(apiKey: string, id: string, opts: {
+    internalPort: number;
+    exposure: "http" | "tcp";
+    timeoutMs?: number;
+    intervalMs?: number;
+}): Promise<{
+    pod: RunpodPod;
+    wsUrl: string;
+}>;
+//# sourceMappingURL=runpod-rest.d.ts.map

package/dist/runpod-rest.d.ts.map

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

package/dist/runpod-rest.js

@@ -0,0 +1,150 @@
+/**
+ * RunPod Pod management over the REST API (https://rest.runpod.io/v1).
+ *
+ * The serverless helpers in `runpod-api.ts` create templates/endpoints (the
+ * job/queue model) and read the API key from `process.env`. This module manages
+ * **persistent Pods** — the right shape for a long-lived NodeTool WebSocket
+ * worker the server/CLI attaches to — and takes the API key **explicitly** so it
+ * can be sourced from the per-user secret store (`getSecret`), never the
+ * environment.
+ *
+ * REST surface used: POST /v1/pods, GET /v1/pods/{id}, POST /v1/pods/{id}/stop,
+ * DELETE /v1/pods/{id}, GET /v1/pods.
+ */
+const RUNPOD_REST_BASE_URL = "https://rest.runpod.io/v1";
+/**
+ * Call the RunPod REST API with an explicitly-supplied key.
+ *
+ * @param apiKey   RunPod API key (from the per-user secret store).
+ * @param endpoint Path under /v1, e.g. "pods" or "pods/<id>".
+ */
+async function runpodRest(apiKey, endpoint, method = "GET", data) {
+    if (!apiKey)
+        throw new Error("RunPod API key is required");
+    const init = {
+        method,
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            Accept: "application/json"
+        },
+        signal: AbortSignal.timeout(60_000)
+    };
+    if (data && method === "POST")
+        init.body = JSON.stringify(data);
+    const response = await fetch(`${RUNPOD_REST_BASE_URL}/${endpoint}`, init);
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new Error(`RunPod REST ${method} /${endpoint} failed (${response.status}): ${body}`);
+    }
+    if (method === "DELETE" && response.status === 204)
+        return {};
+    const text = await response.text();
+    return text ? JSON.parse(text) : {};
+}
+// ---------------------------------------------------------------------------
+// Pod operations
+// ---------------------------------------------------------------------------
+/** Create (and deploy) a Pod. POST /v1/pods. */
+export async function createPod(apiKey, spec) {
+    const pod = (await runpodRest(apiKey, "pods", "POST", spec));
+    if (!pod?.id)
+        throw new Error("RunPod createPod returned no pod id");
+    return pod;
+}
+/** Get a Pod by id. GET /v1/pods/{id}. */
+export async function getPod(apiKey, id) {
+    return (await runpodRest(apiKey, `pods/${id}`));
+}
+/** List Pods. GET /v1/pods. */
+export async function listPods(apiKey) {
+    const res = await runpodRest(apiKey, "pods");
+    if (Array.isArray(res))
+        return res;
+    const arr = res.pods;
+    return Array.isArray(arr) ? arr : [];
+}
+/** Stop a Pod (releases compute, keeps the volume). POST /v1/pods/{id}/stop. */
+export async function stopPod(apiKey, id) {
+    await runpodRest(apiKey, `pods/${id}/stop`, "POST");
+}
+/** Terminate a Pod (deletes it). DELETE /v1/pods/{id}. */
+export async function deletePod(apiKey, id) {
+    await runpodRest(apiKey, `pods/${id}`, "DELETE");
+}
+// ---------------------------------------------------------------------------
+// Endpoint helpers
+// ---------------------------------------------------------------------------
+/**
+ * Direct TCP WebSocket URL for an exposed `/tcp` port, or null while the Pod
+ * lacks a public IP / port mapping. Preferred for large frames (no HTTP proxy).
+ */
+export function podDirectWsUrl(pod, internalPort) {
+    const ext = pod.portMappings?.[String(internalPort)];
+    if (!pod.publicIp || !ext)
+        return null;
+    return `ws://${pod.publicIp}:${ext}`;
+}
+/**
+ * RunPod HTTP-proxy WebSocket URL for an exposed `/http` port. TLS-terminated
+ * by RunPod; subject to the proxy's size/timeout limits (fine for small frames).
+ */
+export function podProxyWsUrl(podId, internalPort) {
+    return `wss://${podId}-${internalPort}.proxy.runpod.net`;
+}
+/**
+ * Deploy a NodeTool worker image as a persistent RunPod Pod and wait until it is
+ * RUNNING with a resolvable WebSocket endpoint. Does NOT read process.env — pass
+ * `apiKey` (from the secret store) and `workerToken` explicitly.
+ *
+ * Reaching RUNNING + having an endpoint does not guarantee the worker process
+ * has finished loading nodes; the caller should connect with retry.
+ */
+export async function deployWorkerPod(apiKey, opts) {
+    const internalPort = opts.internalPort ?? 7777;
+    const exposure = opts.exposure ?? "http";
+    const env = { ...(opts.env ?? {}) };
+    if (opts.workerToken)
+        env.NODETOOL_WORKER_TOKEN = opts.workerToken;
+    const spec = {
+        name: opts.name,
+        imageName: opts.image,
+        computeType: opts.computeType ?? "CPU",
+        vcpuCount: opts.computeType === "GPU" ? undefined : (opts.vcpuCount ?? 4),
+        gpuTypeIds: opts.gpuTypeIds,
+        ports: [`${internalPort}/${exposure}`],
+        env,
+        containerDiskInGb: opts.containerDiskInGb ?? 20
+    };
+    const created = await createPod(apiKey, spec);
+    const { pod, wsUrl } = await waitForPodEndpoint(apiKey, created.id, {
+        internalPort,
+        exposure,
+        timeoutMs: opts.timeoutMs ?? 240_000
+    });
+    return { podId: created.id, wsUrl, pod };
+}
+/** Poll GET /v1/pods/{id} until RUNNING with a resolvable endpoint. */
+export async function waitForPodEndpoint(apiKey, id, opts) {
+    const deadline = Date.now() + (opts.timeoutMs ?? 240_000);
+    const intervalMs = opts.intervalMs ?? 5_000;
+    let last;
+    while (Date.now() < deadline) {
+        const pod = await getPod(apiKey, id);
+        last = pod;
+        if (pod.desiredStatus === "TERMINATED" || pod.desiredStatus === "EXITED") {
+            throw new Error(`Pod ${id} reached terminal status ${pod.desiredStatus}`);
+        }
+        if (pod.desiredStatus === "RUNNING") {
+            if (opts.exposure === "http") {
+                return { pod, wsUrl: podProxyWsUrl(id, opts.internalPort) };
+            }
+            const direct = podDirectWsUrl(pod, opts.internalPort);
+            if (direct)
+                return { pod, wsUrl: direct };
+        }
+        await new Promise((r) => setTimeout(r, intervalMs));
+    }
+    throw new Error(`Pod ${id} did not become reachable within the timeout (last status: ${last?.desiredStatus ?? "unknown"})`);
+}
+//# sourceMappingURL=runpod-rest.js.map

package/dist/runpod-rest.js.map

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

package/dist/self-hosted.d.ts

@@ -8,8 +8,7 @@
  * - Health monitoring
  * - Localhost detection (skips SSH for localhost deployments)
  */
-import { DockerRunGenerator } from "./docker-run.js";
-import { DockerDeployment, SelfHostedDeployment } from "./deployment-config.js";
+import { DockerDeployment } from "./deployment-config.js";
 import { StateManager } from "./state.js";
 /**
  * Common interface for executors used in deployer code.
@@ -75,11 +74,8 @@ export declare class LocalExecutor {
      */
     close(): void;
     /**
-     * Execute a command locally.
-     *
-     * Matches SSHConnection behavior by running in a shell.
-     * This allows shell features like pipes, redirects, &&/|| operators,
-     * and environment variable assignments.
+     * Execute a command locally in a shell, so pipes, redirects, &&/||, and
+     * environment-variable assignments work as they do over SSH.
      */
     execute(command: string, check?: boolean, timeout?: number): Promise<[exitCode: number, stdout: string, stderr: string]>;
     /**
@@ -88,55 +84,33 @@ export declare class LocalExecutor {
     mkdir(dirPath: string, _mode?: number, parents?: boolean): Promise<void>;
 }
 /**
- * Base class for SSH-based deployments.
- *
- * Type parameter `T` is the concrete deployment configuration type
- * (e.g. DockerDeployment).
+ * Deployer for Docker-based self-hosted deployments, over SSH or locally.
  */
-export declare abstract class BaseSSHDeployer<T extends SelfHostedDeployment> {
+export declare class DockerDeployer {
     readonly deploymentName: string;
-    readonly deployment: T;
+    readonly deployment: DockerDeployment;
     readonly stateManager: StateManager;
     readonly isLocalhost: boolean;
-    constructor(deploymentName: string, deployment: T, stateManager?: StateManager);
-    protected log(results: Record<string, unknown>, message: string): void;
-    protected getExecutor(): Executor;
+    constructor(deploymentName: string, deployment: DockerDeployment, stateManager?: StateManager);
+    private log;
+    private getExecutor;
     /**
      * Use an executor within a callback, ensuring proper open/close lifecycle.
      */
-    protected withExecutor<R>(fn: (executor: Executor) => Promise<R>): Promise<R>;
-    protected uploadContent(ssh: Executor, content: string, remotePath: string): Promise<void>;
-    protected createDirectories(ssh: Executor, results: Record<string, unknown>): Promise<void>;
-    protected resolveLocalRuntimeCommand(): string;
-    protected runtimeCommandForShell(): string;
-    protected containerGenerator(runtimeCommand?: string): DockerRunGenerator;
-    protected containerName(): string;
+    private withExecutor;
+    private createDirectories;
+    private resolveLocalRuntimeCommand;
+    private runtimeCommandForShell;
+    private containerGenerator;
+    private containerName;
     /**
      * Return host port for direct app mode (matches DockerRunGenerator).
      */
-    protected appHostPort(): number;
-    protected abstract createSpecificDirectories(ssh: Executor, workspacePath: string): Promise<void>;
-    abstract plan(): Promise<DeployPlan>;
-    abstract apply(opts?: {
-        dryRun?: boolean;
-    }): Promise<DeployResult>;
-    abstract destroy(): Promise<DeployResult>;
-    abstract status(): Promise<DeployStatus>;
-    abstract logs(opts?: {
-        service?: string;
-        follow?: boolean;
-        tail?: number;
-    }): Promise<string>;
-}
-/**
- * Deployer for Docker-based self-hosted deployments.
- */
-export declare class DockerDeployer extends BaseSSHDeployer<DockerDeployment> {
-    protected createSpecificDirectories(ssh: Executor, workspacePath: string): Promise<void>;
+    private appHostPort;
     plan(): Promise<DeployPlan>;
     apply(opts?: {
         dryRun?: boolean;
-    }): Promise<DeployResult>;
+    }): Promise<DeployResult | DeployPlan>;
     private stopExistingContainer;
     private stopExistingContainerWithShell;
     private stopLocalPortConflictsWithShell;

package/dist/self-hosted.d.ts.map

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

package/dist/self-hosted.js

@@ -9,7 +9,6 @@
  * - Localhost detection (skips SSH for localhost deployments)
  */
 import { execSync, execFileSync } from "child_process";
-import * as dns from "dns";
 import * as fs from "fs";
 import * as os from "os";
 import * as path from "path";
@@ -47,85 +46,53 @@ function expandUser(p) {
     }
     return p;
 }
-/**
- * Check if host resolves to the local machine.
- */
-export function isLocalhost(host) {
-    const localhostNames = new Set(["localhost", "127.0.0.1", "::1", "0.0.0.0"]);
-    const normalizedHost = host.trim().toLowerCase();
-    if (localhostNames.has(normalizedHost)) {
-        return true;
+const LOCALHOST_NAMES = new Set(["localhost", "127.0.0.1", "::1", "0.0.0.0"]);
+/** Every address a host resolves to; empty when neither tool answers. */
+function resolveIps(target) {
+    try {
+        // getent (Linux) prints "127.0.0.1  localhost" — the IP is the first field.
+        return execFileSync("getent", ["hosts", target], {
+            encoding: "utf-8",
+            timeout: 5000
+        })
+            .trim()
+            .split("\n")
+            .map((line) => line.trim().split(/\s+/)[0])
+            .filter((ip) => ip.length > 0);
     }
-    function resolveIps(target) {
-        const ips = new Set();
-        try {
-            // Synchronous DNS lookup via Node.js dns.resolve
-            const addresses = dns.resolve4.length
-                ? (() => {
-                    try {
-                        // Use execFileSync with getent (Linux) as primary method
-                        const result = execFileSync("getent", ["hosts", target], {
-                            encoding: "utf-8",
-                            timeout: 5000
-                        }).trim();
-                        const resolved = [];
-                        for (const line of result.split("\n")) {
-                            const ip = line.trim().split(/\s+/)[0];
-                            if (ip)
-                                resolved.push(ip);
-                        }
-                        return resolved;
-                    }
-                    catch {
-                        // getent not available (macOS) — fall back to dscacheutil or just skip
-                        try {
-                            const result = execFileSync("dscacheutil", ["-q", "host", "-a", "name", target], { encoding: "utf-8", timeout: 5000 }).trim();
-                            const resolved = [];
-                            for (const line of result.split("\n")) {
-                                const match = line.match(/^ip_address:\s+(.+)/);
-                                if (match)
-                                    resolved.push(match[1].trim());
-                            }
-                            return resolved;
-                        }
-                        catch {
-                            return [];
-                        }
-                    }
-                })()
-                : [];
-            for (const ip of addresses)
-                ips.add(ip);
-        }
-        catch {
-            // Unable to resolve
-        }
-        return ips;
+    catch {
+        // getent is Linux-only; macOS answers through dscacheutil instead.
     }
-    let hostIps;
     try {
-        hostIps = resolveIps(host);
+        return execFileSync("dscacheutil", ["-q", "host", "-a", "name", target], {
+            encoding: "utf-8",
+            timeout: 5000
+        })
+            .trim()
+            .split("\n")
+            .map((line) => line.match(/^ip_address:\s+(.+)/))
+            .filter((match) => match !== null)
+            .map((match) => match[1].trim());
     }
     catch {
-        return false;
+        return [];
     }
-    if (hostIps.size === 0)
-        return false;
-    const localIps = new Set();
-    for (const target of ["localhost", os.hostname()]) {
-        try {
-            for (const ip of resolveIps(target))
-                localIps.add(ip);
-        }
-        catch {
-            continue;
-        }
-    }
-    for (const ip of hostIps) {
-        if (localIps.has(ip))
-            return true;
+}
+/**
+ * Check if host resolves to the local machine.
+ */
+export function isLocalhost(host) {
+    if (LOCALHOST_NAMES.has(host.trim().toLowerCase())) {
+        return true;
     }
-    return false;
+    const hostIps = resolveIps(host);
+    if (hostIps.length === 0)
+        return false;
+    const localIps = new Set([
+        ...resolveIps("localhost"),
+        ...resolveIps(os.hostname())
+    ]);
+    return hostIps.some((ip) => localIps.has(ip));
 }
 // ---------------------------------------------------------------------------
 // LocalExecutor
@@ -148,11 +115,8 @@ export class LocalExecutor {
         // nothing to do
     }
     /**
-     * Execute a command locally.
-     *
-     * Matches SSHConnection behavior by running in a shell.
-     * This allows shell features like pipes, redirects, &&/|| operators,
-     * and environment variable assignments.
+     * Execute a command locally in a shell, so pipes, redirects, &&/||, and
+     * environment-variable assignments work as they do over SSH.
      */
     async execute(command, check = true, timeout) {
         try {
@@ -194,15 +158,12 @@ export class LocalExecutor {
     }
 }
 // ---------------------------------------------------------------------------
-// BaseSSHDeployer (abstract)
+// DockerDeployer
 // ---------------------------------------------------------------------------
 /**
- * Base class for SSH-based deployments.
- *
- * Type parameter `T` is the concrete deployment configuration type
- * (e.g. DockerDeployment).
+ * Deployer for Docker-based self-hosted deployments, over SSH or locally.
  */
-export class BaseSSHDeployer {
+export class DockerDeployer {
     deploymentName;
     deployment;
     stateManager;
@@ -274,24 +235,6 @@ export class BaseSSHDeployer {
             }
         }
     }
-    // ---- Content upload ----------------------------------------------------
-    async uploadContent(ssh, content, remotePath) {
-        if (this.isLocalhost) {
-            const expanded = remotePath.startsWith("~")
-                ? expandUser(remotePath)
-                : remotePath;
-            const dir = path.dirname(expanded);
-            fs.mkdirSync(dir, { recursive: true });
-            fs.writeFileSync(expanded, content, "utf-8");
-        }
-        else {
-            // Remote upload via base64 to avoid shell escaping issues
-            const b64Content = Buffer.from(content, "utf-8").toString("base64");
-            const dirName = path.posix.dirname(remotePath);
-            await ssh.execute(`mkdir -p ${safeShellQuote(dirName)}`, true);
-            await ssh.execute(`echo ${b64Content} | base64 -d > ${safeShellQuote(remotePath)}`, true);
-        }
-    }
     // ---- Directory creation ------------------------------------------------
     async createDirectories(ssh, results) {
         this.log(results, "Creating directories...");
@@ -301,8 +244,8 @@ export class BaseSSHDeployer {
         await ssh.mkdir(`${workspacePath}/data`, 0o755, true);
         await ssh.mkdir(`${workspacePath}/assets`, 0o755, true);
         await ssh.mkdir(`${workspacePath}/temp`, 0o755, true);
-        // Deployment-specific directories
-        await this.createSpecificDirectories(ssh, workspacePath);
+        await ssh.mkdir(`${workspacePath}/proxy`, 0o755, true);
+        await ssh.mkdir(`${workspacePath}/acme`, 0o755, true);
         const hfCachePath = expandUser(this.deployment.paths.hf_cache);
         await ssh.mkdir(hfCachePath, 0o755, true);
         this.log(results, `  Created: ${hfCachePath}`);
@@ -372,18 +315,7 @@ export class BaseSSHDeployer {
             return 8000;
         return container?.port ?? 8000;
     }
-}
-// ---------------------------------------------------------------------------
-// DockerDeployer
-// ---------------------------------------------------------------------------
-/**
- * Deployer for Docker-based self-hosted deployments.
- */
-export class DockerDeployer extends BaseSSHDeployer {
-    async createSpecificDirectories(ssh, workspacePath) {
-        await ssh.mkdir(`${workspacePath}/proxy`, 0o755, true);
-        await ssh.mkdir(`${workspacePath}/acme`, 0o755, true);
-    }
+    // ---- Deployment operations ---------------------------------------------
     async plan() {
         const plan = {
             deployment_name: this.deploymentName,
@@ -413,8 +345,9 @@ export class DockerDeployer extends BaseSSHDeployer {
         return plan;
     }
     async apply(opts) {
+        // A dry run reports the plan itself rather than a deployment result.
         if (opts?.dryRun) {
-            return (await this.plan());
+            return await this.plan();
         }
         const results = {
             deployment_name: this.deploymentName,
@@ -430,13 +363,9 @@ export class DockerDeployer extends BaseSSHDeployer {
             await this.withExecutor(async (executor) => {
                 await this.createDirectories(executor, results);
                 await this.ensureImage(executor, results);
-                // Stop existing container if present
                 await this.stopExistingContainer(executor, results);
-                // Start container
                 const containerRunHash = await this.startContainer(executor, results);
-                // Check health
                 await this.checkHealth(executor, results);
-                // Update state with success
                 const containerName = this.containerName();
                 await this.stateManager.writeState(this.deploymentName, {
                     status: DeploymentStatus.RUNNING,
@@ -650,7 +579,6 @@ export class DockerDeployer extends BaseSSHDeployer {
             await this.withExecutor(async (ssh) => {
                 const containerName = this.containerName();
                 const runtime = this.runtimeCommandForShell();
-                // Stop container
                 try {
                     await ssh.execute(`${runtime} stop ${safeShellQuote(containerName)}`, false, 30);
                     results.steps.push(`Container stopped: ${containerName}`);
@@ -660,7 +588,6 @@ export class DockerDeployer extends BaseSSHDeployer {
                         results.steps.push(`Warning: Failed to stop container: ${e.stderr}`);
                     }
                 }
-                // Remove container
                 try {
                     await ssh.execute(`${runtime} rm ${safeShellQuote(containerName)}`, false, 30);
                     results.steps.push(`Container removed: ${containerName}`);
@@ -671,7 +598,6 @@ export class DockerDeployer extends BaseSSHDeployer {
                     }
                     throw e;
                 }
-                // Update state
                 await this.stateManager.updateDeploymentStatus(this.deploymentName, DeploymentStatus.DESTROYED);
             });
         }