@maestro-js/agent-container 1.0.0-alpha.2 → 1.0.0-alpha.21

package/dist/index.d.ts

@@ -47,6 +47,10 @@ declare namespace AgentContainer {
         cpus?: number;
         /** Docker volume name for persisting `/home/node` (Claude CLI config, zsh history). Defaults to a per-repo name based on `repoPath`. */
         volume?: string;
+        /** Docker network to attach the container to (e.g. `'my-network'`). Omit to use the default bridge network. */
+        network?: string;
+        /** Shell command(s) to run after files are copied into the container. @default 'pnpm install' */
+        setup?: string;
     }
     /** Result of running a command inside the container via {@link Container.exec}. */
     interface ExecResult {

package/dist/index.js

@@ -61,6 +61,9 @@ USER node
 
 # Install Claude
 RUN npm install -g @anthropic-ai/claude-code@latest
+
+# Install Playwright CLI
+RUN npm install -g @playwright/cli@latest
 `;
 
 // src/helpers.ts
@@ -111,15 +114,19 @@ async function create(config) {
     env = {},
     memory = "8gb",
     cpus = 2,
-    volume
+    volume,
+    network,
+    setup = "pnpm install"
   } = config;
   const dockerfileContent = dockerfile ?? DEFAULT_DOCKERFILE;
   const userImageTag = await ensureImage(dockerfileContent);
   const existing = await list();
   const name = resolveContainerName(customName, existing, CONTAINER_PREFIX);
   const envFlags = Object.entries(env).flatMap(([k, v]) => ["-e", `${k}=${v}`]);
+  const tzFlags = ["-e", "TZ=America/Chicago"];
   const memoryFlags = memory ? ["--memory", memory] : [];
   const cpuFlags = cpus !== void 0 ? ["--cpus", String(cpus)] : [];
+  const networkFlags = network ? ["--network", network] : [];
   const runResult = await runDocker([
     "run",
     "-d",
@@ -128,8 +135,10 @@ async function create(config) {
     "-v",
     `${getVolumeName(volume, repoPath)}:/home/node`,
     ...envFlags,
+    ...tzFlags,
     ...memoryFlags,
     ...cpuFlags,
+    ...networkFlags,
     userImageTag,
     "tail",
     "-f",
@@ -145,9 +154,10 @@ async function create(config) {
     throw new Error(cpResult.stderr || `docker cp failed with exit code ${cpResult.exitCode}`);
   }
   await runDocker(["exec", "-u", "root", name, "chown", "-R", "node:node", workDir]);
-  const installResult = await exec(name, workDir, "pnpm install");
-  if (installResult.exitCode !== 0) {
-    throw new Error(installResult.stderr || `pnpm install failed with exit code ${installResult.exitCode}`);
+  const setupResult = await exec(name, workDir, setup);
+  if (setupResult.exitCode !== 0) {
+    const detail = [setupResult.stderr, setupResult.stdout].filter(Boolean).join("\n");
+    throw new Error(detail || `setup command failed with exit code ${setupResult.exitCode}`);
   }
   const headResult = await runGit(["-C", repoPath, "rev-parse", "HEAD"]);
   const hostBase = headResult.stdout.trim();
@@ -237,7 +247,16 @@ async function buildBaseImage() {
   const tmpDir = await mkdtemp(join(tmpdir(), "maestro-agent-base-"));
   try {
     await writeFile(join(tmpDir, "Dockerfile"), BASE_DOCKERFILE);
-    const result = await runDocker(["build", "-t", BASE_IMAGE_TAG, "--build-arg", `PNPM_VERSION=${pnpmVersion}`, tmpDir]);
+    const result = await runDocker([
+      "build",
+      "-t",
+      BASE_IMAGE_TAG,
+      "--build-arg",
+      `PNPM_VERSION=${pnpmVersion}`,
+      "--build-arg",
+      "TZ=America/Chicago",
+      tmpDir
+    ]);
     if (result.exitCode !== 0) {
       throw new Error(result.stderr || `docker build failed with exit code ${result.exitCode}`);
     }
@@ -270,7 +289,9 @@ async function buildUserImage(dockerfileContent, userImageTag) {
 function copyExcludingNodeModules(repoPath, containerName, workDir) {
   return new Promise((resolve) => {
     const gitLsFiles = spawn("git", ["-C", repoPath, "ls-files", "--cached", "--others", "--exclude-standard"]);
-    const tar = spawn("tar", ["-cf", "-", "-C", repoPath, "--files-from", "-"]);
+    const tar = spawn("tar", ["-cf", "-", "-C", repoPath, "--files-from", "-"], {
+      env: { ...process.env, COPYFILE_DISABLE: "1" }
+    });
     const dockerCp = spawn("docker", ["cp", "-", `${containerName}:${workDir}`]);
     const stderrChunks = [];
     gitLsFiles.stdout.pipe(tar.stdin);

package/package.json

@@ -11,7 +11,7 @@
     "@types/node": "^22.19.11"
   },
   "description": "Docker-based isolated agent execution environment with patch-based sync. Use when you need to create sandboxed containers for AI agents, run code in isolated Docker environments, pull container changes back to the host working tree as patches, or manage container lifecycles. Provides create, list, kill, shell, open (VS Code), and pull operations. Containers include Node.js 22, pnpm, Claude CLI, Playwright, git, and zsh.",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.21",
   "publishConfig": {
     "access": "restricted"
   },