@gitpod/gitpod-protocol 0.1.5-main.648 → 0.1.5-main.6480

package/lib/protocol.js

@@ -2,118 +2,221 @@
 /**
  * Copyright (c) 2020 Gitpod GmbH. All rights reserved.
  * Licensed under the GNU Affero General Public License (AGPL).
- * See License-AGPL.txt in the project root for license information.
+ * See License.AGPL.txt in the project root for license information.
  */
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __values = (this && this.__values) || function(o) {
-    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-    if (m) return m.call(o);
-    if (o && typeof o.length === "number") return {
-        next: function () {
-            if (o && i >= o.length) o = void 0;
-            return { value: o && o[i++], done: !o };
-        }
-    };
-    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
-};
-var __read = (this && this.__read) || function (o, n) {
-    var m = typeof Symbol === "function" && o[Symbol.iterator];
-    if (!m) return o;
-    var i = m.call(o), r, ar = [], e;
-    try {
-        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-    }
-    catch (error) { e = { error: error }; }
-    finally {
-        try {
-            if (r && !r.done && (m = i["return"])) m.call(i);
-        }
-        finally { if (e) throw e.error; }
-    }
-    return ar;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TheiaPlugin = exports.AuthProviderEntry = exports.WorkspaceCreationResult = exports.CreateWorkspaceMode = exports.WorkspaceInfo = exports.WorkspaceInstancePortsChangedEvent = exports.Repository = exports.NavigatorContext = exports.IssueContext = exports.PullRequestContext = exports.CommitContext = exports.RefType = exports.WorkspaceProbeContext = exports.WithEnvvarsContext = exports.PrebuiltWorkspaceContext = exports.StartPrebuildContext = exports.SnapshotContext = exports.WithPrebuild = exports.WithSnapshot = exports.WorkspaceContext = exports.ExternalImageConfigFile = exports.ImageConfigFile = exports.ImageConfigString = exports.WorkspaceImageBuild = exports.TaskConfig = exports.PortRangeConfig = exports.PortConfig = exports.PrebuiltWorkspace = exports.WorkspaceImageSourceReference = exports.WorkspaceImageSourceDocker = exports.GithubAppPrebuildConfig = exports.Workspace = exports.Identity = exports.GitpodTokenType = exports.UserEnvVar = exports.WorkspaceFeatureFlags = exports.User = void 0;
+exports.TheiaPlugin = exports.AuthProviderEntry = exports.WorkspaceCreationResult = exports.WorkspaceInfo = exports.WorkspaceInstancePortsChangedEvent = exports.Repository = exports.NavigatorContext = exports.IssueContext = exports.PullRequestContext = exports.CommitContext = exports.OpenPrebuildContext = exports.AdditionalContentContext = exports.RefType = exports.WithEnvvarsContext = exports.WithReferrerContext = exports.PrebuiltWorkspaceContext = exports.StartPrebuildContext = exports.SnapshotContext = exports.WithDefaultConfig = exports.WithPrebuild = exports.WithSnapshot = exports.WorkspaceContext = exports.ExternalImageConfigFile = exports.ImageConfigFile = exports.ImageConfigString = exports.WorkspaceImageBuild = exports.TaskConfig = exports.PortRangeConfig = exports.PortConfig = exports.PrebuiltWorkspace = exports.WorkspaceImageSourceReference = exports.WorkspaceImageSourceDocker = exports.GithubAppPrebuildConfig = exports.Workspace = exports.Identity = exports.GitpodTokenType = exports.SSHPublicKeyValue = exports.UserEnvVar = exports.NamedWorkspaceFeatureFlag = exports.WorkspaceFeatureFlags = exports.AdditionalUserData = exports.User = void 0;
+const crypto_1 = require("crypto");
 var User;
 (function (User) {
     function is(data) {
-        return data
-            && data.hasOwnProperty('id')
-            && data.hasOwnProperty('identities');
+        return data && data.hasOwnProperty("id") && data.hasOwnProperty("identities");
     }
     User.is = is;
     function getIdentity(user, authProviderId) {
-        return user.identities.find(function (id) { return id.authProviderId === authProviderId; });
+        return user.identities.find((id) => id.authProviderId === authProviderId);
     }
     User.getIdentity = getIdentity;
     function censor(user) {
-        var res = __assign({}, user);
-        delete (res.additionalData);
-        res.identities = res.identities.map(function (i) {
-            delete (i.tokens);
+        const res = Object.assign({}, user);
+        delete res.additionalData;
+        res.identities = res.identities.map((i) => {
+            delete i.tokens;
             // The user field is not in the Identity shape, but actually exists on DBIdentity.
             // Trying to push this object out via JSON RPC will fail because of the cyclic nature
             // of this field.
-            delete (i.user);
+            delete i.user;
             return i;
         });
         return res;
     }
     User.censor = censor;
+    /**
+     * Returns the stored email or if it doesn't exist returns the primaryEmail of the first identity this user signed up with.
+     * @param user
+     * @returns A primaryEmail, or undefined if there is none.
+     */
     function getPrimaryEmail(user) {
-        var identities = user.identities.filter(function (i) { return !!i.primaryEmail; });
+        var _a, _b, _c, _d;
+        if ((_b = (_a = user.additionalData) === null || _a === void 0 ? void 0 : _a.profile) === null || _b === void 0 ? void 0 : _b.emailAddress) {
+            return (_d = (_c = user.additionalData) === null || _c === void 0 ? void 0 : _c.profile) === null || _d === void 0 ? void 0 : _d.emailAddress;
+        }
+        const identities = user.identities.filter((i) => !!i.primaryEmail);
         if (identities.length <= 0) {
-            throw new Error("No identity with primary email for user: " + user.id + "!");
+            return undefined;
         }
-        return identities[0].primaryEmail;
+        return identities[0].primaryEmail || undefined;
     }
     User.getPrimaryEmail = getPrimaryEmail;
     function getName(user) {
-        var e_1, _a;
-        var name = user.fullName || user.name;
+        const name = user.fullName || user.name;
         if (name) {
             return name;
         }
-        try {
-            for (var _b = __values(user.identities), _c = _b.next(); !_c.done; _c = _b.next()) {
-                var id = _c.value;
-                if (id.authName !== "") {
-                    return id.authName;
-                }
+        for (const id of user.identities) {
+            if (id.authName !== "") {
+                return id.authName;
             }
         }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
-        finally {
-            try {
-                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
-            }
-            finally { if (e_1) throw e_1.error; }
-        }
         return undefined;
     }
     User.getName = getName;
+    function hasPreferredIde(user) {
+        var _a, _b, _c, _d;
+        return (typeof ((_b = (_a = user === null || user === void 0 ? void 0 : user.additionalData) === null || _a === void 0 ? void 0 : _a.ideSettings) === null || _b === void 0 ? void 0 : _b.defaultIde) !== "undefined" ||
+            typeof ((_d = (_c = user === null || user === void 0 ? void 0 : user.additionalData) === null || _c === void 0 ? void 0 : _c.ideSettings) === null || _d === void 0 ? void 0 : _d.useLatestVersion) !== "undefined");
+    }
+    User.hasPreferredIde = hasPreferredIde;
+    function isOnboardingUser(user) {
+        return !hasPreferredIde(user);
+    }
+    User.isOnboardingUser = isOnboardingUser;
+    function migrationIDESettings(user) {
+        var _a;
+        if (!((_a = user === null || user === void 0 ? void 0 : user.additionalData) === null || _a === void 0 ? void 0 : _a.ideSettings) ||
+            Object.keys(user.additionalData.ideSettings).length === 0 ||
+            user.additionalData.ideSettings.settingVersion === "2.0") {
+            return;
+        }
+        const newIDESettings = {
+            settingVersion: "2.0",
+        };
+        const ideSettings = user.additionalData.ideSettings;
+        if (ideSettings.useDesktopIde) {
+            if (ideSettings.defaultDesktopIde === "code-desktop") {
+                newIDESettings.defaultIde = "code-desktop";
+            }
+            else if (ideSettings.defaultDesktopIde === "code-desktop-insiders") {
+                newIDESettings.defaultIde = "code-desktop";
+                newIDESettings.useLatestVersion = true;
+            }
+            else {
+                newIDESettings.defaultIde = ideSettings.defaultDesktopIde;
+                newIDESettings.useLatestVersion = ideSettings.useLatestVersion;
+            }
+        }
+        else {
+            const useLatest = ideSettings.defaultIde === "code-latest";
+            newIDESettings.defaultIde = "code";
+            newIDESettings.useLatestVersion = useLatest;
+        }
+        user.additionalData.ideSettings = newIDESettings;
+    }
+    User.migrationIDESettings = migrationIDESettings;
+    function getProfile(user) {
+        var _a, _b;
+        return {
+            name: User.getName(user) || "",
+            email: User.getPrimaryEmail(user) || "",
+            company: (_b = (_a = user === null || user === void 0 ? void 0 : user.additionalData) === null || _a === void 0 ? void 0 : _a.profile) === null || _b === void 0 ? void 0 : _b.companyName,
+            avatarURL: user === null || user === void 0 ? void 0 : user.avatarUrl,
+        };
+    }
+    User.getProfile = getProfile;
+    function setProfile(user, profile) {
+        user.fullName = profile.name;
+        user.avatarUrl = profile.avatarURL;
+        if (!user.additionalData) {
+            user.additionalData = {};
+        }
+        if (!user.additionalData.profile) {
+            user.additionalData.profile = {};
+        }
+        user.additionalData.profile.emailAddress = profile.email;
+        user.additionalData.profile.companyName = profile.company;
+        user.additionalData.profile.lastUpdatedDetailsNudge = new Date().toISOString();
+        return user;
+    }
+    User.setProfile = setProfile;
+    let Profile;
+    (function (Profile) {
+        function hasChanges(before, after) {
+            return (before.name !== after.name ||
+                before.email !== after.email ||
+                before.company !== after.company ||
+                before.avatarURL !== after.avatarURL);
+        }
+        Profile.hasChanges = hasChanges;
+    })(Profile = User.Profile || (User.Profile = {}));
 })(User = exports.User || (exports.User = {}));
+var AdditionalUserData;
+(function (AdditionalUserData) {
+    function set(user, partialData) {
+        if (!user.additionalData) {
+            user.additionalData = Object.assign({}, partialData);
+        }
+        else {
+            user.additionalData = Object.assign(Object.assign({}, user.additionalData), partialData);
+        }
+        return user;
+    }
+    AdditionalUserData.set = set;
+})(AdditionalUserData = exports.AdditionalUserData || (exports.AdditionalUserData = {}));
 /**
  * The values of this type MUST MATCH enum values in WorkspaceFeatureFlag from ws-manager/client/core_pb.d.ts
  * If they don't we'll break things during workspace startup.
  */
-exports.WorkspaceFeatureFlags = { "full_workspace_backup": undefined, "fixed_resources": undefined };
+exports.WorkspaceFeatureFlags = {
+    full_workspace_backup: undefined,
+    workspace_class_limiting: undefined,
+    workspace_connection_limiting: undefined,
+    workspace_psi: undefined,
+};
+var NamedWorkspaceFeatureFlag;
+(function (NamedWorkspaceFeatureFlag) {
+    NamedWorkspaceFeatureFlag.WORKSPACE_PERSISTED_FEATTURE_FLAGS = ["full_workspace_backup"];
+    function isWorkspacePersisted(ff) {
+        return NamedWorkspaceFeatureFlag.WORKSPACE_PERSISTED_FEATTURE_FLAGS.includes(ff);
+    }
+    NamedWorkspaceFeatureFlag.isWorkspacePersisted = isWorkspacePersisted;
+})(NamedWorkspaceFeatureFlag = exports.NamedWorkspaceFeatureFlag || (exports.NamedWorkspaceFeatureFlag = {}));
 var UserEnvVar;
 (function (UserEnvVar) {
+    /**
+     * @param variable
+     * @returns Either a string containing an error message or undefined.
+     */
+    function validate(variable) {
+        const name = variable.name;
+        const pattern = variable.repositoryPattern;
+        if (name.trim() === "") {
+            return "Name must not be empty.";
+        }
+        if (name.length > 255) {
+            return "Name too long. Maximum name length is 255 characters.";
+        }
+        if (!/^[a-zA-Z_]+[a-zA-Z0-9_]*$/.test(name)) {
+            return "Name must match /^[a-zA-Z_]+[a-zA-Z0-9_]*$/.";
+        }
+        if (variable.value.trim() === "") {
+            return "Value must not be empty.";
+        }
+        if (variable.value.length > 32767) {
+            return "Value too long. Maximum value length is 32767 characters.";
+        }
+        if (pattern.trim() === "") {
+            return "Scope must not be empty.";
+        }
+        const split = pattern.split("/");
+        if (split.length < 2) {
+            return "A scope must use the form 'organization/repo'.";
+        }
+        for (const name of split) {
+            if (name !== "*") {
+                if (!/^[a-zA-Z0-9_\-.\*]+$/.test(name)) {
+                    return "Invalid scope segment. Only ASCII characters, numbers, -, _, . or * are allowed.";
+                }
+            }
+        }
+        return undefined;
+    }
+    UserEnvVar.validate = validate;
+    // DEPRECATED: Use ProjectEnvVar instead of repositoryPattern - https://github.com/gitpod-com/gitpod/issues/5322
     function normalizeRepoPattern(pattern) {
         return pattern.toLocaleLowerCase();
     }
     UserEnvVar.normalizeRepoPattern = normalizeRepoPattern;
+    // DEPRECATED: Use ProjectEnvVar instead of repositoryPattern - https://github.com/gitpod-com/gitpod/issues/5322
     function score(value) {
         // We use a score to enforce precedence:
         //      value/value = 0
@@ -122,12 +225,12 @@ var UserEnvVar;
         //      */*         = 3
         //      #/#         = 4 (used for env vars passed through the URL)
         // the lower the score, the higher the precedence.
-        var _a = __read(splitRepositoryPattern(value.repositoryPattern), 2), ownerPattern = _a[0], repoPattern = _a[1];
-        var score = 0;
+        const [ownerPattern, repoPattern] = splitRepositoryPattern(value.repositoryPattern);
+        let score = 0;
         if (repoPattern == "*") {
             score += 1;
         }
-        if (ownerPattern == '*') {
+        if (ownerPattern == "*") {
             score += 2;
         }
         if (ownerPattern == "#" || repoPattern == "#") {
@@ -136,77 +239,106 @@ var UserEnvVar;
         return score;
     }
     UserEnvVar.score = score;
+    // DEPRECATED: Use ProjectEnvVar instead of repositoryPattern - https://github.com/gitpod-com/gitpod/issues/5322
     function filter(vars, owner, repo) {
-        var e_2, _a, e_3, _b;
-        var result = vars.filter(function (e) {
-            var _a = __read(splitRepositoryPattern(e.repositoryPattern), 2), ownerPattern = _a[0], repoPattern = _a[1];
-            if (ownerPattern !== '*' && ownerPattern !== '#' && (!!owner && ownerPattern !== owner.toLocaleLowerCase())) {
+        let result = vars.filter((e) => {
+            const [ownerPattern, repoPattern] = splitRepositoryPattern(e.repositoryPattern);
+            if (ownerPattern !== "*" && ownerPattern !== "#" && !!owner && ownerPattern !== owner.toLocaleLowerCase()) {
                 return false;
             }
-            if (repoPattern !== '*' && repoPattern !== '#' && (!!repo && repoPattern !== repo.toLocaleLowerCase())) {
+            if (repoPattern !== "*" && repoPattern !== "#" && !!repo && repoPattern !== repo.toLocaleLowerCase()) {
                 return false;
             }
             return true;
         });
-        var resmap = new Map();
-        result.forEach(function (e) {
-            var l = (resmap.get(e.name) || []);
+        const resmap = new Map();
+        result.forEach((e) => {
+            const l = resmap.get(e.name) || [];
             l.push(e);
             resmap.set(e.name, l);
         });
         result = [];
-        try {
-            for (var _c = __values(resmap.keys()), _d = _c.next(); !_d.done; _d = _c.next()) {
-                var name_1 = _d.value;
-                var candidates = resmap.get(name_1);
-                if (!candidates) {
-                    // not sure how this can happen, but so be it
-                    continue;
-                }
-                if (candidates.length == 1) {
-                    result.push(candidates[0]);
-                    continue;
-                }
-                var minscore = 10;
-                var bestCandidate = void 0;
-                try {
-                    for (var candidates_1 = (e_3 = void 0, __values(candidates)), candidates_1_1 = candidates_1.next(); !candidates_1_1.done; candidates_1_1 = candidates_1.next()) {
-                        var e = candidates_1_1.value;
-                        var score_1 = UserEnvVar.score(e);
-                        if (!bestCandidate || score_1 < minscore) {
-                            minscore = score_1;
-                            bestCandidate = e;
-                        }
-                    }
-                }
-                catch (e_3_1) { e_3 = { error: e_3_1 }; }
-                finally {
-                    try {
-                        if (candidates_1_1 && !candidates_1_1.done && (_b = candidates_1.return)) _b.call(candidates_1);
-                    }
-                    finally { if (e_3) throw e_3.error; }
-                }
-                result.push(bestCandidate);
+        for (const name of resmap.keys()) {
+            const candidates = resmap.get(name);
+            if (!candidates) {
+                // not sure how this can happen, but so be it
+                continue;
             }
-        }
-        catch (e_2_1) { e_2 = { error: e_2_1 }; }
-        finally {
-            try {
-                if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+            if (candidates.length == 1) {
+                result.push(candidates[0]);
+                continue;
+            }
+            let minscore = 10;
+            let bestCandidate;
+            for (const e of candidates) {
+                const score = UserEnvVar.score(e);
+                if (!bestCandidate || score < minscore) {
+                    minscore = score;
+                    bestCandidate = e;
+                }
             }
-            finally { if (e_2) throw e_2.error; }
+            result.push(bestCandidate);
         }
         return result;
     }
     UserEnvVar.filter = filter;
+    // DEPRECATED: Use ProjectEnvVar instead of repositoryPattern - https://github.com/gitpod-com/gitpod/issues/5322
     function splitRepositoryPattern(repositoryPattern) {
-        var patterns = repositoryPattern.split('/');
-        var repoPattern = patterns.pop() || "";
-        var ownerPattern = patterns.join('/');
+        const patterns = repositoryPattern.split("/");
+        const repoPattern = patterns.slice(1).join("/");
+        const ownerPattern = patterns[0];
         return [ownerPattern, repoPattern];
     }
     UserEnvVar.splitRepositoryPattern = splitRepositoryPattern;
 })(UserEnvVar = exports.UserEnvVar || (exports.UserEnvVar = {}));
+var SSHPublicKeyValue;
+(function (SSHPublicKeyValue) {
+    function validate(value) {
+        if (value.name.length === 0) {
+            return "Title must not be empty.";
+        }
+        if (value.name.length > 255) {
+            return "Title too long. Maximum value length is 255 characters.";
+        }
+        if (value.key.length === 0) {
+            return "Key must not be empty.";
+        }
+        try {
+            getData(value);
+        }
+        catch (e) {
+            return "Key is invalid. You must supply a key in OpenSSH public key format.";
+        }
+        return;
+    }
+    SSHPublicKeyValue.validate = validate;
+    function getData(value) {
+        var _a, _b, _c;
+        // Begins with 'ssh-rsa', 'ecdsa-sha2-nistp256', 'ecdsa-sha2-nistp384', 'ecdsa-sha2-nistp521', 'ssh-ed25519', 'sk-ecdsa-sha2-nistp256@openssh.com', or 'sk-ssh-ed25519@openssh.com'.
+        const regex = /^(?<type>ssh-rsa|ecdsa-sha2-nistp256|ecdsa-sha2-nistp384|ecdsa-sha2-nistp521|ssh-ed25519|sk-ecdsa-sha2-nistp256@openssh\.com|sk-ssh-ed25519@openssh\.com) (?<key>.*?)( (?<email>.*?))?$/;
+        const resultGroup = regex.exec(value.key.trim());
+        if (!resultGroup) {
+            throw new Error("Key is invalid.");
+        }
+        return {
+            type: (_a = resultGroup.groups) === null || _a === void 0 ? void 0 : _a["type"],
+            key: (_b = resultGroup.groups) === null || _b === void 0 ? void 0 : _b["key"],
+            email: ((_c = resultGroup.groups) === null || _c === void 0 ? void 0 : _c["email"]) || undefined,
+        };
+    }
+    SSHPublicKeyValue.getData = getData;
+    function getFingerprint(value) {
+        const data = getData(value);
+        let buf = Buffer.from(data.key, "base64");
+        // gitlab style
+        // const hash = createHash("md5").update(buf).digest("hex");
+        // github style
+        const hash = (0, crypto_1.createHash)("sha256").update(buf).digest("base64");
+        return hash;
+    }
+    SSHPublicKeyValue.getFingerprint = getFingerprint;
+    SSHPublicKeyValue.MAXIMUM_KEY_LENGTH = 5;
+})(SSHPublicKeyValue = exports.SSHPublicKeyValue || (exports.SSHPublicKeyValue = {}));
 var GitpodTokenType;
 (function (GitpodTokenType) {
     GitpodTokenType[GitpodTokenType["API_AUTH_TOKEN"] = 0] = "API_AUTH_TOKEN";
@@ -215,14 +347,11 @@ var GitpodTokenType;
 var Identity;
 (function (Identity) {
     function is(data) {
-        return data.hasOwnProperty('authProviderId')
-            && data.hasOwnProperty('authId')
-            && data.hasOwnProperty('authName');
+        return (data.hasOwnProperty("authProviderId") && data.hasOwnProperty("authId") && data.hasOwnProperty("authName"));
     }
     Identity.is = is;
     function equals(id1, id2) {
-        return id1.authProviderId === id2.authProviderId
-            && id1.authId === id2.authId;
+        return id1.authProviderId === id2.authProviderId && id1.authId === id2.authId;
     }
     Identity.equals = equals;
 })(Identity = exports.Identity || (exports.Identity = {}));
@@ -230,14 +359,14 @@ var Workspace;
 (function (Workspace) {
     function getFullRepositoryName(ws) {
         if (CommitContext.is(ws.context)) {
-            return ws.context.repository.owner + '/' + ws.context.repository.name;
+            return ws.context.repository.owner + "/" + ws.context.repository.name;
         }
         return undefined;
     }
     Workspace.getFullRepositoryName = getFullRepositoryName;
     function getFullRepositoryUrl(ws) {
         if (CommitContext.is(ws.context)) {
-            return "https://" + ws.context.repository.host + "/" + getFullRepositoryName(ws);
+            return `https://${ws.context.repository.host}/${getFullRepositoryName(ws)}`;
         }
         return undefined;
     }
@@ -274,30 +403,28 @@ var Workspace;
 var GithubAppPrebuildConfig;
 (function (GithubAppPrebuildConfig) {
     function is(obj) {
-        return !(typeof obj === 'boolean');
+        return !(typeof obj === "boolean");
     }
     GithubAppPrebuildConfig.is = is;
 })(GithubAppPrebuildConfig = exports.GithubAppPrebuildConfig || (exports.GithubAppPrebuildConfig = {}));
 var WorkspaceImageSourceDocker;
 (function (WorkspaceImageSourceDocker) {
     function is(obj) {
-        return 'dockerFileHash' in obj
-            && 'dockerFileSource' in obj
-            && 'dockerFilePath' in obj;
+        return "dockerFileHash" in obj && "dockerFilePath" in obj;
     }
     WorkspaceImageSourceDocker.is = is;
 })(WorkspaceImageSourceDocker = exports.WorkspaceImageSourceDocker || (exports.WorkspaceImageSourceDocker = {}));
 var WorkspaceImageSourceReference;
 (function (WorkspaceImageSourceReference) {
     function is(obj) {
-        return 'baseImageResolved' in obj;
+        return "baseImageResolved" in obj;
     }
     WorkspaceImageSourceReference.is = is;
 })(WorkspaceImageSourceReference = exports.WorkspaceImageSourceReference || (exports.WorkspaceImageSourceReference = {}));
 var PrebuiltWorkspace;
 (function (PrebuiltWorkspace) {
     function isDone(pws) {
-        return pws.state === "available" || pws.state === "timeout" || pws.state === 'aborted';
+        return (pws.state === "available" || pws.state === "timeout" || pws.state === "aborted" || pws.state === "failed");
     }
     PrebuiltWorkspace.isDone = isDone;
     function isAvailable(pws) {
@@ -312,129 +439,123 @@ var PrebuiltWorkspace;
 var PortConfig;
 (function (PortConfig) {
     function is(config) {
-        return config && ('port' in config) && (typeof config.port === 'number');
+        return config && "port" in config && typeof config.port === "number";
     }
     PortConfig.is = is;
 })(PortConfig = exports.PortConfig || (exports.PortConfig = {}));
 var PortRangeConfig;
 (function (PortRangeConfig) {
     function is(config) {
-        return config && ('port' in config) && (typeof config.port === 'string' || config.port instanceof String);
+        return config && "port" in config && (typeof config.port === "string" || config.port instanceof String);
     }
     PortRangeConfig.is = is;
 })(PortRangeConfig = exports.PortRangeConfig || (exports.PortRangeConfig = {}));
 var TaskConfig;
 (function (TaskConfig) {
     function is(config) {
-        return config
-            && ('command' in config || 'init' in config || 'before' in config);
+        return config && ("command" in config || "init" in config || "before" in config);
     }
     TaskConfig.is = is;
 })(TaskConfig = exports.TaskConfig || (exports.TaskConfig = {}));
 var WorkspaceImageBuild;
 (function (WorkspaceImageBuild) {
-    var LogLine;
+    let LogLine;
     (function (LogLine) {
-        LogLine.DELIMITER = '\r\n';
+        LogLine.DELIMITER = "\r\n";
         LogLine.DELIMITER_REGEX = /\r?\n/;
     })(LogLine = WorkspaceImageBuild.LogLine || (WorkspaceImageBuild.LogLine = {}));
 })(WorkspaceImageBuild = exports.WorkspaceImageBuild || (exports.WorkspaceImageBuild = {}));
 var ImageConfigString;
 (function (ImageConfigString) {
     function is(config) {
-        return typeof config === 'string';
+        return typeof config === "string";
     }
     ImageConfigString.is = is;
 })(ImageConfigString = exports.ImageConfigString || (exports.ImageConfigString = {}));
 var ImageConfigFile;
 (function (ImageConfigFile) {
     function is(config) {
-        return typeof config === 'object'
-            && 'file' in config;
+        return typeof config === "object" && "file" in config;
     }
     ImageConfigFile.is = is;
 })(ImageConfigFile = exports.ImageConfigFile || (exports.ImageConfigFile = {}));
 var ExternalImageConfigFile;
 (function (ExternalImageConfigFile) {
     function is(config) {
-        return typeof config === 'object'
-            && 'file' in config
-            && 'externalSource' in config;
+        return typeof config === "object" && "file" in config && "externalSource" in config;
     }
     ExternalImageConfigFile.is = is;
 })(ExternalImageConfigFile = exports.ExternalImageConfigFile || (exports.ExternalImageConfigFile = {}));
 var WorkspaceContext;
 (function (WorkspaceContext) {
     function is(context) {
-        return context
-            && 'title' in context;
+        return context && "title" in context;
     }
     WorkspaceContext.is = is;
 })(WorkspaceContext = exports.WorkspaceContext || (exports.WorkspaceContext = {}));
 var WithSnapshot;
 (function (WithSnapshot) {
     function is(context) {
-        return context
-            && 'snapshotBucketId' in context;
+        return context && "snapshotBucketId" in context;
     }
     WithSnapshot.is = is;
 })(WithSnapshot = exports.WithSnapshot || (exports.WithSnapshot = {}));
 var WithPrebuild;
 (function (WithPrebuild) {
     function is(context) {
-        return context
-            && 'snapshotBucketId' in context
-            && 'prebuildWorkspaceId' in context
-            && 'wasPrebuilt' in context;
+        return context && WithSnapshot.is(context) && "prebuildWorkspaceId" in context && "wasPrebuilt" in context;
     }
     WithPrebuild.is = is;
 })(WithPrebuild = exports.WithPrebuild || (exports.WithPrebuild = {}));
+var WithDefaultConfig;
+(function (WithDefaultConfig) {
+    function is(context) {
+        return context && "withDefaultConfig" in context && context.withDefaultConfig;
+    }
+    WithDefaultConfig.is = is;
+    function mark(ctx) {
+        return Object.assign(Object.assign({}, ctx), { withDefaultConfig: true });
+    }
+    WithDefaultConfig.mark = mark;
+})(WithDefaultConfig = exports.WithDefaultConfig || (exports.WithDefaultConfig = {}));
 var SnapshotContext;
 (function (SnapshotContext) {
     function is(context) {
-        return context
-            && WithSnapshot.is(context)
-            && 'snapshotId' in context;
+        return context && WithSnapshot.is(context) && "snapshotId" in context;
     }
     SnapshotContext.is = is;
 })(SnapshotContext = exports.SnapshotContext || (exports.SnapshotContext = {}));
 var StartPrebuildContext;
 (function (StartPrebuildContext) {
     function is(context) {
-        return context
-            && 'actual' in context;
+        return context && "actual" in context;
     }
     StartPrebuildContext.is = is;
 })(StartPrebuildContext = exports.StartPrebuildContext || (exports.StartPrebuildContext = {}));
 var PrebuiltWorkspaceContext;
 (function (PrebuiltWorkspaceContext) {
     function is(context) {
-        return context
-            && 'originalContext' in context
-            && 'prebuiltWorkspace' in context;
+        return context && "originalContext" in context && "prebuiltWorkspace" in context;
     }
     PrebuiltWorkspaceContext.is = is;
 })(PrebuiltWorkspaceContext = exports.PrebuiltWorkspaceContext || (exports.PrebuiltWorkspaceContext = {}));
+var WithReferrerContext;
+(function (WithReferrerContext) {
+    function is(context) {
+        return context && "referrer" in context;
+    }
+    WithReferrerContext.is = is;
+})(WithReferrerContext = exports.WithReferrerContext || (exports.WithReferrerContext = {}));
 var WithEnvvarsContext;
 (function (WithEnvvarsContext) {
     function is(context) {
-        return context
-            && 'envvars' in context;
+        return context && "envvars" in context;
     }
     WithEnvvarsContext.is = is;
 })(WithEnvvarsContext = exports.WithEnvvarsContext || (exports.WithEnvvarsContext = {}));
-var WorkspaceProbeContext;
-(function (WorkspaceProbeContext) {
-    function is(context) {
-        return context
-            && 'responseURL' in context
-            && 'responseToken' in context;
-    }
-    WorkspaceProbeContext.is = is;
-})(WorkspaceProbeContext = exports.WorkspaceProbeContext || (exports.WorkspaceProbeContext = {}));
 var RefType;
 (function (RefType) {
-    RefType.getRefType = function (commit) {
+    RefType.getRefType = (commit) => {
         if (!commit.ref) {
             return "revision";
         }
@@ -442,48 +563,78 @@ var RefType;
         return commit.refType || "branch";
     };
 })(RefType = exports.RefType || (exports.RefType = {}));
+var AdditionalContentContext;
+(function (AdditionalContentContext) {
+    function is(ctx) {
+        return "additionalFiles" in ctx;
+    }
+    AdditionalContentContext.is = is;
+    function hasDockerConfig(ctx, config) {
+        return is(ctx) && ImageConfigFile.is(config.image) && !!ctx.additionalFiles[config.image.file];
+    }
+    AdditionalContentContext.hasDockerConfig = hasDockerConfig;
+})(AdditionalContentContext = exports.AdditionalContentContext || (exports.AdditionalContentContext = {}));
+var OpenPrebuildContext;
+(function (OpenPrebuildContext) {
+    function is(ctx) {
+        return "openPrebuildID" in ctx;
+    }
+    OpenPrebuildContext.is = is;
+})(OpenPrebuildContext = exports.OpenPrebuildContext || (exports.OpenPrebuildContext = {}));
 var CommitContext;
+(function (CommitContext) {
+    /**
+     * Creates a hash for all the commits of the CommitContext and all sub-repo commit infos.
+     * The hash is max 255 chars long.
+     * @param commitContext
+     * @returns hash for commitcontext
+     */
+    function computeHash(commitContext) {
+        // for single commits we use the revision to be backward compatible.
+        if (!commitContext.additionalRepositoryCheckoutInfo ||
+            commitContext.additionalRepositoryCheckoutInfo.length === 0) {
+            return commitContext.revision;
+        }
+        const hasher = (0, crypto_1.createHash)("sha256");
+        hasher.update(commitContext.revision);
+        for (const info of commitContext.additionalRepositoryCheckoutInfo) {
+            hasher.update(info.revision);
+        }
+        return hasher.digest("hex");
+    }
+    CommitContext.computeHash = computeHash;
+})(CommitContext = exports.CommitContext || (exports.CommitContext = {}));
 (function (CommitContext) {
     function is(commit) {
-        return WorkspaceContext.is(commit)
-            && 'repository' in commit
-            && 'revision' in commit;
+        return WorkspaceContext.is(commit) && "repository" in commit && "revision" in commit;
     }
     CommitContext.is = is;
 })(CommitContext = exports.CommitContext || (exports.CommitContext = {}));
 var PullRequestContext;
 (function (PullRequestContext) {
     function is(ctx) {
-        return CommitContext.is(ctx)
-            && 'nr' in ctx
-            && 'ref' in ctx
-            && 'base' in ctx;
+        return CommitContext.is(ctx) && "nr" in ctx && "ref" in ctx && "base" in ctx;
     }
     PullRequestContext.is = is;
 })(PullRequestContext = exports.PullRequestContext || (exports.PullRequestContext = {}));
 var IssueContext;
 (function (IssueContext) {
     function is(ctx) {
-        return CommitContext.is(ctx)
-            && 'nr' in ctx
-            && 'ref' in ctx
-            && 'localBranch' in ctx;
+        return CommitContext.is(ctx) && "nr" in ctx && "ref" in ctx && "localBranch" in ctx;
     }
     IssueContext.is = is;
 })(IssueContext = exports.IssueContext || (exports.IssueContext = {}));
 var NavigatorContext;
 (function (NavigatorContext) {
     function is(ctx) {
-        return CommitContext.is(ctx)
-            && 'path' in ctx
-            && 'isFile' in ctx;
+        return CommitContext.is(ctx) && "path" in ctx && "isFile" in ctx;
     }
     NavigatorContext.is = is;
 })(NavigatorContext = exports.NavigatorContext || (exports.NavigatorContext = {}));
 var Repository;
 (function (Repository) {
     function fullRepoName(repo) {
-        return repo.host + "/" + repo.owner + "/" + repo.name;
+        return `${repo.host}/${repo.owner}/${repo.name}`;
     }
     Repository.fullRepoName = fullRepoName;
 })(Repository = exports.Repository || (exports.Repository = {}));
@@ -502,37 +653,27 @@ var WorkspaceInfo;
     }
     WorkspaceInfo.lastActiveISODate = lastActiveISODate;
 })(WorkspaceInfo = exports.WorkspaceInfo || (exports.WorkspaceInfo = {}));
-var CreateWorkspaceMode;
-(function (CreateWorkspaceMode) {
-    // Default returns a running prebuild if there is any, otherwise creates a new workspace (using a prebuild if one is available)
-    CreateWorkspaceMode["Default"] = "default";
-    // ForceNew creates a new workspace irrespective of any running prebuilds. This mode is guaranteed to actually create a workspace - but may degrade user experience as currently runnig prebuilds are ignored.
-    CreateWorkspaceMode["ForceNew"] = "force-new";
-    // UsePrebuild polls the database waiting for a currently running prebuild to become available. This mode exists to handle the db-sync delay.
-    CreateWorkspaceMode["UsePrebuild"] = "use-prebuild";
-    // SelectIfRunning returns a list of currently running workspaces for the context URL if there are any, otherwise falls back to Default mode
-    CreateWorkspaceMode["SelectIfRunning"] = "select-if-running";
-})(CreateWorkspaceMode = exports.CreateWorkspaceMode || (exports.CreateWorkspaceMode = {}));
 var WorkspaceCreationResult;
 (function (WorkspaceCreationResult) {
     function is(data) {
-        return data && ('createdWorkspaceId' in data
-            || 'existingWorkspaces' in data
-            || 'runningWorkspacePrebuild' in data
-            || 'runningPrebuildWorkspaceID' in data);
+        return (data &&
+            ("createdWorkspaceId" in data ||
+                "existingWorkspaces" in data ||
+                "runningWorkspacePrebuild" in data ||
+                "runningPrebuildWorkspaceID" in data));
     }
     WorkspaceCreationResult.is = is;
 })(WorkspaceCreationResult = exports.WorkspaceCreationResult || (exports.WorkspaceCreationResult = {}));
 var AuthProviderEntry;
 (function (AuthProviderEntry) {
     function redact(entry) {
-        return __assign(__assign({}, entry), { oauth: __assign(__assign({}, entry.oauth), { clientSecret: "redacted" }) });
+        return Object.assign(Object.assign({}, entry), { oauth: Object.assign(Object.assign({}, entry.oauth), { clientSecret: "redacted" }) });
     }
     AuthProviderEntry.redact = redact;
 })(AuthProviderEntry = exports.AuthProviderEntry || (exports.AuthProviderEntry = {}));
 var TheiaPlugin;
 (function (TheiaPlugin) {
-    var State;
+    let State;
     (function (State) {
         State["Uploading"] = "uploading";
         State["Uploaded"] = "uploaded";