Function parseRuntimeString

src/browser/utils/chatCommands.ts:1327–1384

(runtime: string | undefined)

 * - undefined -> Worktree runtime (default)
 */
export function parseRuntimeString(runtime: string | undefined): RuntimeConfig | undefined {
  // Use shared parser from common/types/runtime
  const parsed = parseRuntimeModeAndHost(runtime);

  // null means invalid input (e.g., "ssh" without host, "docker" without image)
  if (parsed === null) {
    // Determine which error to throw based on input
    const trimmed = runtime?.trim().toLowerCase() ?? "";
    if (trimmed === RUNTIME_MODE.SSH || trimmed.startsWith("ssh ")) {
      throw new Error("SSH runtime requires host (e.g., 'ssh hostname' or 'ssh user@host')");
    }
    if (trimmed === RUNTIME_MODE.DOCKER || trimmed.startsWith("docker ")) {
      throw new Error("Docker runtime requires image (e.g., 'docker ubuntu:22.04')");
    }
    if (trimmed === RUNTIME_MODE.DEVCONTAINER || trimmed.startsWith("devcontainer")) {
      throw new Error(
        "Dev container runtime requires a config path (e.g., 'devcontainer .devcontainer/devcontainer.json')"
      );
    }
    throw new Error(
      `Unknown runtime type: '${runtime ?? ""}'. Use 'ssh <host>', 'docker <image>', 'devcontainer <config>', 'worktree', or 'local'`
    );
  }

  // Convert ParsedRuntime to RuntimeConfig
  switch (parsed.mode) {
    case RUNTIME_MODE.WORKTREE:
      return undefined; // Let backend use default worktree config

    case RUNTIME_MODE.LOCAL:
      return { type: RUNTIME_MODE.LOCAL };

    case RUNTIME_MODE.SSH:
      return {
        type: RUNTIME_MODE.SSH,
        host: parsed.host,
        srcBaseDir: "~/mux", // Default remote base directory (tilde resolved by backend)
      };

    case RUNTIME_MODE.DEVCONTAINER: {
      const configPath = parsed.configPath.trim();
      if (!configPath) {
        throw new Error(
          "Dev container runtime requires a config path (e.g., 'devcontainer .devcontainer/devcontainer.json')"
        );
      }
      return {
        type: RUNTIME_MODE.DEVCONTAINER,
        configPath,
      };
    }
    case RUNTIME_MODE.DOCKER:
      return {
        type: RUNTIME_MODE.DOCKER,
        image: parsed.image,
      };
  }
}