fix(docker): improve container start and update handling (#1339)

Author: john-royal

alchemy/src/docker/api.ts

@@ -69,10 +69,44 @@ type VolumeInfo = {
   Scope: string;
 };
 
-type ContainerInfo = {
+export type ContainerInfo = {
   Id: string;
   State: { Status: "created" | "running" | "paused" | "stopped" | "exited" };
   Created: string;
+  Config: {
+    Image: string;
+    Cmd: string[] | null;
+    Env: string[] | null;
+    Healthcheck?: {
+      Test: string[] | null;
+      Interval?: number;
+      Timeout?: number;
+      Retries?: number;
+      StartPeriod?: number;
+      StartInterval?: number;
+    } | null;
+  };
+  HostConfig: {
+    PortBindings: Record<
+      string,
+      Array<{ HostIp: string; HostPort: string }> | null
+    > | null;
+    Binds: string[] | null;
+    RestartPolicy: {
+      Name: string;
+      MaximumRetryCount: number;
+    };
+    AutoRemove: boolean;
+  };
+  NetworkSettings: {
+    Networks: Record<
+      string,
+      {
+        NetworkID: string;
+        Aliases: string[] | null;
+      }
+    > | null;
+  };
 };
 
 /**
@@ -103,6 +137,7 @@ export class DockerApi {
   async exec(
     args: string[],
     remainingAttempts = 3,
+    quiet = false,
   ): Promise<{ stdout: string; stderr: string }> {
     // If a custom config directory is provided, ensure all commands use it by
     // setting the DOCKER_CONFIG env variable for the spawned process.
@@ -124,13 +159,17 @@ export class DockerApi {
 
     // Stream stdout in real-time
     subprocess.stdout?.on("data", (chunk: string) => {
-      process.stdout.write(chunk);
+      if (!quiet) {
+        process.stdout.write(chunk);
+      }
       stdout += chunk;
     });
 
     // Stream stderr in real-time
     subprocess.stderr?.on("data", (chunk: string) => {
-      process.stderr.write(chunk);
+      if (!quiet) {
+        process.stderr.write(chunk);
+      }
       stderr += chunk;
     });
 
@@ -364,7 +403,11 @@ export class DockerApi {
    * @returns Container details in JSON format
    */
   async inspectContainer(containerId: string): Promise<ContainerInfo[]> {
-    const { stdout } = await this.exec(["container", "inspect", containerId]);
+    const { stdout } = await this.exec(
+      ["container", "inspect", containerId],
+      undefined,
+      true,
+    );
     try {
       return JSON.parse(stdout.trim()) as ContainerInfo[];
     } catch (_error) {