webmux 0.27.0 → 0.27.1

package/README.md

@@ -130,6 +130,8 @@ profiles:
       You are running inside a sandboxed container.
       Backend port: ${PORT}. Frontend port: ${FRONTEND_PORT}.
 
+Custom sandbox images should make `claude` or `codex` available on the container's normal `PATH` (for example with `ENV PATH=/your/tool/bin:$PATH`). webmux does not rely on login-shell dotfiles like `.bashrc` to discover agent binaries inside the container.
+
 integrations:
   github:
     autoRemoveOnMerge: true

package/backend/dist/server.js

@@ -8687,12 +8687,16 @@ function allocateServicePorts(existingMetas, services) {
 }
 
 // backend/src/services/agent-service.ts
+var DOCKER_PATH_FALLBACK = "/root/.local/bin:/usr/local/bin:/root/.bun/bin:/root/.cargo/bin";
 function quoteShell(value) {
   return `'${value.replaceAll("'", "'\\''")}'`;
 }
 function buildRuntimeBootstrap(runtimeEnvPath) {
   return `set -a; . ${quoteShell(runtimeEnvPath)}; set +a`;
 }
+function buildDockerRuntimeBootstrap(runtimeEnvPath) {
+  return `${buildRuntimeBootstrap(runtimeEnvPath)}; export PATH="$PATH:${DOCKER_PATH_FALLBACK}"`;
+}
 function buildAgentInvocation(input) {
   if (input.agent === "codex") {
     const yoloFlag2 = input.yolo ? " --yolo" : "";
@@ -8715,11 +8719,11 @@ function buildAgentInvocation(input) {
   }
   return `claude${yoloFlag}${promptSuffix}`;
 }
-function buildAgentCommand(input) {
-  return `${buildRuntimeBootstrap(input.runtimeEnvPath)}; ${buildAgentInvocation(input)}`;
+function buildAgentCommand(input, bootstrap = buildRuntimeBootstrap) {
+  return `${bootstrap(input.runtimeEnvPath)}; ${buildAgentInvocation(input)}`;
 }
 function buildDockerExecCommand(containerName, worktreePath, command) {
-  return `docker exec -it -w ${quoteShell(worktreePath)} ${quoteShell(containerName)} bash -lc ${quoteShell(command)}`;
+  return `docker exec -it -w ${quoteShell(worktreePath)} ${quoteShell(containerName)} /bin/sh -c ${quoteShell(command)}`;
 }
 function buildManagedShellCommand(runtimeEnvPath, shellPath = Bun.env.SHELL || "/bin/bash") {
   return `bash -lc ${quoteShell(`${buildRuntimeBootstrap(runtimeEnvPath)}; exec ${quoteShell(shellPath)} -i`)}`;
@@ -8727,11 +8731,11 @@ function buildManagedShellCommand(runtimeEnvPath, shellPath = Bun.env.SHELL || "
 function buildAgentPaneCommand(input) {
   return buildAgentCommand(input);
 }
-function buildDockerShellCommand(containerName, worktreePath, runtimeEnvPath, shellPath = Bun.env.SHELL || "/bin/bash") {
-  return buildDockerExecCommand(containerName, worktreePath, `${buildRuntimeBootstrap(runtimeEnvPath)}; exec ${quoteShell(shellPath)} -i`);
+function buildDockerShellCommand(containerName, worktreePath, runtimeEnvPath, shellPath = "/bin/bash") {
+  return buildDockerExecCommand(containerName, worktreePath, `${buildDockerRuntimeBootstrap(runtimeEnvPath)}; if [ -x ${quoteShell(shellPath)} ]; then exec ${quoteShell(shellPath)} -i; elif [ -x /bin/sh ]; then exec /bin/sh -i; else echo 'webmux: no shell found in container' >&2; exit 127; fi`);
 }
 function buildDockerAgentPaneCommand(input) {
-  return buildDockerExecCommand(input.containerName, input.worktreePath, buildAgentCommand(input));
+  return buildAgentCommand(input, buildDockerRuntimeBootstrap);
 }
 
 // backend/src/services/session-service.ts
@@ -9277,12 +9281,33 @@ function generateFallbackBranchName() {
 }
 
 // backend/src/services/lifecycle-service.ts
+var DOCKER_CONTROL_HOST = "host.docker.internal";
 function toErrorMessage2(error) {
   return error instanceof Error ? error.message : String(error);
 }
 function stringifyStartupEnvValue(value) {
   return typeof value === "boolean" ? String(value) : value;
 }
+function trimTrailingSlashes(value) {
+  return value.replace(/\/+$/, "");
+}
+function isLoopbackHostname(hostname) {
+  return hostname === "127.0.0.1" || hostname === "localhost" || hostname === "::1" || hostname === "[::1]";
+}
+function buildRuntimeControlBaseUrl(controlBaseUrl, runtime) {
+  const trimmed = trimTrailingSlashes(controlBaseUrl);
+  if (runtime !== "docker")
+    return trimmed;
+  try {
+    const url = new URL(trimmed);
+    if (isLoopbackHostname(url.hostname)) {
+      url.hostname = DOCKER_CONTROL_HOST;
+    }
+    return trimTrailingSlashes(url.toString());
+  } catch {
+    return trimmed;
+  }
+}
 function prefixAgentBranch(agent, branch) {
   return `${agent}-${branch}`;
 }
@@ -9573,7 +9598,7 @@ class LifecycleService {
       allocatedPorts: await this.allocatePorts(),
       runtimeEnvExtras: { WEBMUX_WORKTREE_PATH: resolved.entry.path },
       dotenvValues,
-      controlUrl: this.controlUrl(),
+      controlUrl: this.controlUrl(profile.runtime),
       controlToken: await this.deps.getControlToken()
     });
   }
@@ -9594,7 +9619,7 @@ class LifecycleService {
     }, dotenvValues);
     await writeRuntimeEnv(input.gitDir, runtimeEnv);
     const controlEnv = buildControlEnvMap({
-      controlUrl: this.controlUrl(),
+      controlUrl: this.controlUrl(input.meta.runtime),
       controlToken: await this.deps.getControlToken(),
       worktreeId: input.meta.worktreeId,
       branch: input.meta.branch
@@ -9656,8 +9681,6 @@ class LifecycleService {
       paneCommands: containerName ? {
         agent: buildDockerAgentPaneCommand({
           agent: input.agent,
-          containerName,
-          worktreePath: input.worktreePath,
           runtimeEnvPath: input.initialized.paths.runtimeEnvPath,
           yolo: input.profile.yolo === true,
           systemPrompt,
@@ -9718,8 +9741,8 @@ class LifecycleService {
       throw new LifecycleError(`Worktree has uncommitted changes: ${entry.branch ?? entry.path}`, 409);
     }
   }
-  controlUrl() {
-    return `${this.deps.controlBaseUrl.replace(/\/+$/, "")}/api/runtime/events`;
+  controlUrl(runtime) {
+    return `${buildRuntimeControlBaseUrl(this.deps.controlBaseUrl, runtime)}/api/runtime/events`;
   }
   async removeResolvedWorktree(resolved) {
     await this.runLifecycleHook({
@@ -9822,7 +9845,7 @@ class LifecycleService {
         startupEnvValues: await this.buildStartupEnvValues(input.envOverrides),
         allocatedPorts: await this.allocatePorts(),
         runtimeEnvExtras: { WEBMUX_WORKTREE_PATH: worktreePath },
-        controlUrl: this.controlUrl(),
+        controlUrl: this.controlUrl(profile.runtime),
         controlToken: await this.deps.getControlToken(),
         deleteBranchOnRollback
       }, {

package/bin/webmux.js

@@ -11562,6 +11562,9 @@ function quoteShell(value) {
 function buildRuntimeBootstrap(runtimeEnvPath) {
   return `set -a; . ${quoteShell(runtimeEnvPath)}; set +a`;
 }
+function buildDockerRuntimeBootstrap(runtimeEnvPath) {
+  return `${buildRuntimeBootstrap(runtimeEnvPath)}; export PATH="$PATH:${DOCKER_PATH_FALLBACK}"`;
+}
 function buildAgentInvocation(input) {
   if (input.agent === "codex") {
     const yoloFlag2 = input.yolo ? " --yolo" : "";
@@ -11584,11 +11587,11 @@ function buildAgentInvocation(input) {
   }
   return `claude${yoloFlag}${promptSuffix}`;
 }
-function buildAgentCommand(input) {
-  return `${buildRuntimeBootstrap(input.runtimeEnvPath)}; ${buildAgentInvocation(input)}`;
+function buildAgentCommand(input, bootstrap = buildRuntimeBootstrap) {
+  return `${bootstrap(input.runtimeEnvPath)}; ${buildAgentInvocation(input)}`;
 }
 function buildDockerExecCommand(containerName2, worktreePath, command) {
-  return `docker exec -it -w ${quoteShell(worktreePath)} ${quoteShell(containerName2)} bash -lc ${quoteShell(command)}`;
+  return `docker exec -it -w ${quoteShell(worktreePath)} ${quoteShell(containerName2)} /bin/sh -c ${quoteShell(command)}`;
 }
 function buildManagedShellCommand(runtimeEnvPath, shellPath = Bun.env.SHELL || "/bin/bash") {
   return `bash -lc ${quoteShell(`${buildRuntimeBootstrap(runtimeEnvPath)}; exec ${quoteShell(shellPath)} -i`)}`;
@@ -11596,12 +11599,13 @@ function buildManagedShellCommand(runtimeEnvPath, shellPath = Bun.env.SHELL || "
 function buildAgentPaneCommand(input) {
   return buildAgentCommand(input);
 }
-function buildDockerShellCommand(containerName2, worktreePath, runtimeEnvPath, shellPath = Bun.env.SHELL || "/bin/bash") {
-  return buildDockerExecCommand(containerName2, worktreePath, `${buildRuntimeBootstrap(runtimeEnvPath)}; exec ${quoteShell(shellPath)} -i`);
+function buildDockerShellCommand(containerName2, worktreePath, runtimeEnvPath, shellPath = "/bin/bash") {
+  return buildDockerExecCommand(containerName2, worktreePath, `${buildDockerRuntimeBootstrap(runtimeEnvPath)}; if [ -x ${quoteShell(shellPath)} ]; then exec ${quoteShell(shellPath)} -i; elif [ -x /bin/sh ]; then exec /bin/sh -i; else echo 'webmux: no shell found in container' >&2; exit 127; fi`);
 }
 function buildDockerAgentPaneCommand(input) {
-  return buildDockerExecCommand(input.containerName, input.worktreePath, buildAgentCommand(input));
+  return buildAgentCommand(input, buildDockerRuntimeBootstrap);
 }
+var DOCKER_PATH_FALLBACK = "/root/.local/bin:/usr/local/bin:/root/.bun/bin:/root/.cargo/bin";
 
 // backend/src/services/session-service.ts
 import { resolve as resolve6 } from "path";
@@ -11855,6 +11859,26 @@ function toErrorMessage2(error) {
 function stringifyStartupEnvValue(value) {
   return typeof value === "boolean" ? String(value) : value;
 }
+function trimTrailingSlashes(value) {
+  return value.replace(/\/+$/, "");
+}
+function isLoopbackHostname(hostname) {
+  return hostname === "127.0.0.1" || hostname === "localhost" || hostname === "::1" || hostname === "[::1]";
+}
+function buildRuntimeControlBaseUrl(controlBaseUrl, runtime) {
+  const trimmed = trimTrailingSlashes(controlBaseUrl);
+  if (runtime !== "docker")
+    return trimmed;
+  try {
+    const url = new URL(trimmed);
+    if (isLoopbackHostname(url.hostname)) {
+      url.hostname = DOCKER_CONTROL_HOST;
+    }
+    return trimTrailingSlashes(url.toString());
+  } catch {
+    return trimmed;
+  }
+}
 function prefixAgentBranch(agent, branch) {
   return `${agent}-${branch}`;
 }
@@ -12137,7 +12161,7 @@ class LifecycleService {
       allocatedPorts: await this.allocatePorts(),
       runtimeEnvExtras: { WEBMUX_WORKTREE_PATH: resolved.entry.path },
       dotenvValues,
-      controlUrl: this.controlUrl(),
+      controlUrl: this.controlUrl(profile.runtime),
       controlToken: await this.deps.getControlToken()
     });
   }
@@ -12158,7 +12182,7 @@ class LifecycleService {
     }, dotenvValues);
     await writeRuntimeEnv(input.gitDir, runtimeEnv);
     const controlEnv = buildControlEnvMap({
-      controlUrl: this.controlUrl(),
+      controlUrl: this.controlUrl(input.meta.runtime),
       controlToken: await this.deps.getControlToken(),
       worktreeId: input.meta.worktreeId,
       branch: input.meta.branch
@@ -12220,8 +12244,6 @@ class LifecycleService {
       paneCommands: containerName2 ? {
         agent: buildDockerAgentPaneCommand({
           agent: input.agent,
-          containerName: containerName2,
-          worktreePath: input.worktreePath,
           runtimeEnvPath: input.initialized.paths.runtimeEnvPath,
           yolo: input.profile.yolo === true,
           systemPrompt,
@@ -12282,8 +12304,8 @@ class LifecycleService {
       throw new LifecycleError(`Worktree has uncommitted changes: ${entry.branch ?? entry.path}`, 409);
     }
   }
-  controlUrl() {
-    return `${this.deps.controlBaseUrl.replace(/\/+$/, "")}/api/runtime/events`;
+  controlUrl(runtime) {
+    return `${buildRuntimeControlBaseUrl(this.deps.controlBaseUrl, runtime)}/api/runtime/events`;
   }
   async removeResolvedWorktree(resolved) {
     await this.runLifecycleHook({
@@ -12386,7 +12408,7 @@ class LifecycleService {
         startupEnvValues: await this.buildStartupEnvValues(input.envOverrides),
         allocatedPorts: await this.allocatePorts(),
         runtimeEnvExtras: { WEBMUX_WORKTREE_PATH: worktreePath },
-        controlUrl: this.controlUrl(),
+        controlUrl: this.controlUrl(profile.runtime),
         controlToken: await this.deps.getControlToken(),
         deleteBranchOnRollback
       }, {
@@ -12456,7 +12478,7 @@ class LifecycleService {
     return new LifecycleError(toErrorMessage2(error), 422);
   }
 }
-var LifecycleError;
+var DOCKER_CONTROL_HOST = "host.docker.internal", LifecycleError;
 var init_lifecycle_service = __esm(() => {
   init_agent_runtime();
   init_fs();
@@ -13590,7 +13612,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "webmux",
-  version: "0.27.0",
+  version: "0.27.1",
   description: "Web dashboard for workmux \u2014 browser UI with embedded terminals, PR monitoring, and CI integration",
   type: "module",
   repository: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webmux",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Web dashboard for workmux — browser UI with embedded terminals, PR monitoring, and CI integration",
   "type": "module",
   "repository": {