@toshicloud/sdk 0.5.0 → 0.6.0

package/dist/gen/toshi/workspace/v1/discovery_pb.d.ts

@@ -64,7 +64,8 @@ export type DiscoverResponse = Message<"toshi.workspace.v1.DiscoverResponse"> &
     /**
      * permissions are the caller's, sorted: what its roles in the workspace
      * give it at the request's project and environment. Each is
-     * "<area>.<level>", as docs/api/permissions.md lists them, or a
+     * "<area>.<level>", as this API's methods name them in their
+     * toshi.permission option, or a
      * product's own, "<product id>.<level>".
      *
      * @generated from field: repeated string permissions = 2;
@@ -74,6 +75,28 @@ export type DiscoverResponse = Message<"toshi.workspace.v1.DiscoverResponse"> &
      * @generated from field: toshi.workspace.v1.APIVersions versions = 3;
      */
     versions?: APIVersions | undefined;
+    /**
+     * registry_address is the deployment's container registry as a client
+     * writes it in an image reference and logs in to it, such as
+     * "registry.example.com": a host name, with a port when it is not 443.
+     * Empty when the deployment runs no container registry.
+     *
+     * @generated from field: string registry_address = 4;
+     */
+    registryAddress: string;
+    /**
+     * calls are the Workspace API procedures the caller may make at the
+     * request's project and environment, sorted, such as
+     * "/toshi.workspace.v1.WorkloadService/CreateJob": those its credential
+     * takes whose permission its roles give it where the call acts, by the
+     * rule that admits a call. A call in a project or an environment is
+     * listed when the caller may make it at the request's project and
+     * environment, or with none named, anywhere. The workspace's state is
+     * not looked at: a suspended workspace lists writes it refuses.
+     *
+     * @generated from field: repeated string calls = 5;
+     */
+    calls: string[];
 };
 /**
  * @generated from message toshi.workspace.v1.DiscoverResponse
@@ -88,7 +111,8 @@ export type DiscoverResponseJson = {
     /**
      * permissions are the caller's, sorted: what its roles in the workspace
      * give it at the request's project and environment. Each is
-     * "<area>.<level>", as docs/api/permissions.md lists them, or a
+     * "<area>.<level>", as this API's methods name them in their
+     * toshi.permission option, or a
      * product's own, "<product id>.<level>".
      *
      * @generated from field: repeated string permissions = 2;
@@ -98,6 +122,28 @@ export type DiscoverResponseJson = {
      * @generated from field: toshi.workspace.v1.APIVersions versions = 3;
      */
     versions?: APIVersionsJson;
+    /**
+     * registry_address is the deployment's container registry as a client
+     * writes it in an image reference and logs in to it, such as
+     * "registry.example.com": a host name, with a port when it is not 443.
+     * Empty when the deployment runs no container registry.
+     *
+     * @generated from field: string registry_address = 4;
+     */
+    registryAddress?: string;
+    /**
+     * calls are the Workspace API procedures the caller may make at the
+     * request's project and environment, sorted, such as
+     * "/toshi.workspace.v1.WorkloadService/CreateJob": those its credential
+     * takes whose permission its roles give it where the call acts, by the
+     * rule that admits a call. A call in a project or an environment is
+     * listed when the caller may make it at the request's project and
+     * environment, or with none named, anywhere. The workspace's state is
+     * not looked at: a suspended workspace lists writes it refuses.
+     *
+     * @generated from field: repeated string calls = 5;
+     */
+    calls?: string[];
 };
 /**
  * Describes the message toshi.workspace.v1.DiscoverResponse.
@@ -150,13 +196,36 @@ export type DiscoveredProduct = Message<"toshi.workspace.v1.DiscoveredProduct">
      */
     state: ProductState;
     /**
-     * switch says whether the product is on for the workspace and, when it is
-     * off, which switch turned it off: the switch a refused call to the
-     * product names in its ErrorInfo detail.
+     * surfaces are what the product adds to Toshi: the path its API is
+     * served at.
+     *
+     * @generated from field: toshi.workspace.v1.DiscoveredSurfaces surfaces = 8;
+     */
+    surfaces?: DiscoveredSurfaces | undefined;
+    /**
+     * available reports whether the product is on for the workspace: the
+     * build includes it, the deployment's config, the workspace's plan and
+     * its settings all turn it on. A call to a product that is not available
+     * is refused with FAILED_PRECONDITION and the reason PRODUCT_UNAVAILABLE,
+     * whose metadata names the input that turned it off; the workspace's
+     * product settings show its plan's entitlement and its own setting.
      *
-     * @generated from field: toshi.workspace.v1.ProductSwitch switch = 7;
+     * @generated from field: bool available = 10;
      */
-    switch: ProductSwitch;
+    available: boolean;
+    /**
+     * stability is how mature the product is in this build.
+     *
+     * @generated from field: toshi.workspace.v1.ProductStability stability = 11;
+     */
+    stability: ProductStability;
+    /**
+     * removal_version is the version a deprecated product is removed in;
+     * empty for the other stabilities.
+     *
+     * @generated from field: string removal_version = 12;
+     */
+    removalVersion: string;
 };
 /**
  * DiscoveredProduct is one product the build includes.
@@ -202,13 +271,36 @@ export type DiscoveredProductJson = {
      */
     state?: ProductStateJson;
     /**
-     * switch says whether the product is on for the workspace and, when it is
-     * off, which switch turned it off: the switch a refused call to the
-     * product names in its ErrorInfo detail.
+     * surfaces are what the product adds to Toshi: the path its API is
+     * served at.
+     *
+     * @generated from field: toshi.workspace.v1.DiscoveredSurfaces surfaces = 8;
+     */
+    surfaces?: DiscoveredSurfacesJson;
+    /**
+     * available reports whether the product is on for the workspace: the
+     * build includes it, the deployment's config, the workspace's plan and
+     * its settings all turn it on. A call to a product that is not available
+     * is refused with FAILED_PRECONDITION and the reason PRODUCT_UNAVAILABLE,
+     * whose metadata names the input that turned it off; the workspace's
+     * product settings show its plan's entitlement and its own setting.
      *
-     * @generated from field: toshi.workspace.v1.ProductSwitch switch = 7;
+     * @generated from field: bool available = 10;
      */
-    switch?: ProductSwitchJson;
+    available?: boolean;
+    /**
+     * stability is how mature the product is in this build.
+     *
+     * @generated from field: toshi.workspace.v1.ProductStability stability = 11;
+     */
+    stability?: ProductStabilityJson;
+    /**
+     * removal_version is the version a deprecated product is removed in;
+     * empty for the other stabilities.
+     *
+     * @generated from field: string removal_version = 12;
+     */
+    removalVersion?: string;
 };
 /**
  * Describes the message toshi.workspace.v1.DiscoveredProduct.
@@ -217,6 +309,45 @@ export type DiscoveredProductJson = {
 export declare const DiscoveredProductSchema: GenMessage<DiscoveredProduct, {
     jsonType: DiscoveredProductJson;
 }>;
+/**
+ * DiscoveredSurfaces are what a product adds to Toshi, empty when it adds
+ * none. It mirrors products.proto's ProductSurfaces, field for field,
+ * because discovery.proto cannot import products.proto, which imports it.
+ *
+ * @generated from message toshi.workspace.v1.DiscoveredSurfaces
+ */
+export type DiscoveredSurfaces = Message<"toshi.workspace.v1.DiscoveredSurfaces"> & {
+    /**
+     * api is the path the control plane serves the product's API at, such
+     * as "/runners/".
+     *
+     * @generated from field: string api = 1;
+     */
+    api: string;
+};
+/**
+ * DiscoveredSurfaces are what a product adds to Toshi, empty when it adds
+ * none. It mirrors products.proto's ProductSurfaces, field for field,
+ * because discovery.proto cannot import products.proto, which imports it.
+ *
+ * @generated from message toshi.workspace.v1.DiscoveredSurfaces
+ */
+export type DiscoveredSurfacesJson = {
+    /**
+     * api is the path the control plane serves the product's API at, such
+     * as "/runners/".
+     *
+     * @generated from field: string api = 1;
+     */
+    api?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.DiscoveredSurfaces.
+ * Use `create(DiscoveredSurfacesSchema)` to create a new message.
+ */
+export declare const DiscoveredSurfacesSchema: GenMessage<DiscoveredSurfaces, {
+    jsonType: DiscoveredSurfacesJson;
+}>;
 /**
  * ProductFeature is a typed key a product declares.
  *
@@ -249,7 +380,9 @@ export type ProductFeature = Message<"toshi.workspace.v1.ProductFeature"> & {
     /**
      * entitlement is the most the workspace may have of the feature: the
      * operator's override for the workspace, else its plan's value, else the
-     * feature's default. Unset when the config turns the product off.
+     * value of the plan key it falls back to, else the feature's default
+     * (source). Unset when the config turns the product off or the build
+     * does not include it.
      *
      * @generated from field: toshi.workspace.v1.FeatureValue entitlement = 5;
      */
@@ -266,11 +399,42 @@ export type ProductFeature = Message<"toshi.workspace.v1.ProductFeature"> & {
     /**
      * effective is the value that applies: the setting when the feature is
      * narrowable and the entitlement contains it, else the entitlement.
-     * Unset when the config turns the product off.
+     * Unset when the config turns the product off or the build does not
+     * include it.
      *
      * @generated from field: toshi.workspace.v1.FeatureValue effective = 7;
      */
     effective?: FeatureValue | undefined;
+    /**
+     * default_value is the feature's default in its product's manifest: the
+     * entitlement when no override, plan value or plan key gives one.
+     *
+     * @generated from field: toshi.workspace.v1.FeatureValue default_value = 8;
+     */
+    defaultValue?: FeatureValue | undefined;
+    /**
+     * max bounds a count, or both ends of a range: no value of the feature
+     * is higher. 0 bounds nothing.
+     *
+     * @generated from field: int64 max = 9;
+     */
+    max: bigint;
+    /**
+     * plan_key names the plan key a count falls back to, such as
+     * "preview_max_connections": a plan that sets the key and gives the
+     * feature no value of its own entitles the workspace to the key's value.
+     * Empty for a feature that falls back to none.
+     *
+     * @generated from field: string plan_key = 10;
+     */
+    planKey: string;
+    /**
+     * source says where the entitlement comes from. Unspecified when the
+     * config turns the product off.
+     *
+     * @generated from field: toshi.workspace.v1.FeatureSource source = 11;
+     */
+    source: FeatureSource;
 };
 /**
  * ProductFeature is a typed key a product declares.
@@ -304,7 +468,9 @@ export type ProductFeatureJson = {
     /**
      * entitlement is the most the workspace may have of the feature: the
      * operator's override for the workspace, else its plan's value, else the
-     * feature's default. Unset when the config turns the product off.
+     * value of the plan key it falls back to, else the feature's default
+     * (source). Unset when the config turns the product off or the build
+     * does not include it.
      *
      * @generated from field: toshi.workspace.v1.FeatureValue entitlement = 5;
      */
@@ -321,11 +487,42 @@ export type ProductFeatureJson = {
     /**
      * effective is the value that applies: the setting when the feature is
      * narrowable and the entitlement contains it, else the entitlement.
-     * Unset when the config turns the product off.
+     * Unset when the config turns the product off or the build does not
+     * include it.
      *
      * @generated from field: toshi.workspace.v1.FeatureValue effective = 7;
      */
     effective?: FeatureValueJson;
+    /**
+     * default_value is the feature's default in its product's manifest: the
+     * entitlement when no override, plan value or plan key gives one.
+     *
+     * @generated from field: toshi.workspace.v1.FeatureValue default_value = 8;
+     */
+    defaultValue?: FeatureValueJson;
+    /**
+     * max bounds a count, or both ends of a range: no value of the feature
+     * is higher. 0 bounds nothing.
+     *
+     * @generated from field: int64 max = 9;
+     */
+    max?: string;
+    /**
+     * plan_key names the plan key a count falls back to, such as
+     * "preview_max_connections": a plan that sets the key and gives the
+     * feature no value of its own entitles the workspace to the key's value.
+     * Empty for a feature that falls back to none.
+     *
+     * @generated from field: string plan_key = 10;
+     */
+    planKey?: string;
+    /**
+     * source says where the entitlement comes from. Unspecified when the
+     * config turns the product off.
+     *
+     * @generated from field: toshi.workspace.v1.FeatureSource source = 11;
+     */
+    source?: FeatureSourceJson;
 };
 /**
  * Describes the message toshi.workspace.v1.ProductFeature.
@@ -556,56 +753,107 @@ export type ProductStateJson = "PRODUCT_STATE_UNSPECIFIED" | "PRODUCT_STATE_ENAB
  */
 export declare const ProductStateSchema: GenEnum<ProductState, ProductStateJson>;
 /**
- * ProductSwitch is the switch that decides whether a product is on for a
- * workspace. The deployment's config decides first, then the workspace's
- * entitlements, then its settings; the first that turns the product off is
- * the one named.
+ * ProductStability is how mature a product is. A deployment's
+ * products.min_stability turns off a product below it, as the operator's
+ * switch does.
+ *
+ * @generated from enum toshi.workspace.v1.ProductStability
+ */
+export declare enum ProductStability {
+    /**
+     * @generated from enum value: PRODUCT_STABILITY_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * May change or go away in any release.
+     *
+     * @generated from enum value: PRODUCT_STABILITY_ALPHA = 1;
+     */
+    ALPHA = 1,
+    /**
+     * Complete; its configuration and API may still change between minor
+     * releases, with notice.
+     *
+     * @generated from enum value: PRODUCT_STABILITY_BETA = 2;
+     */
+    BETA = 2,
+    /**
+     * Changes only compatibly within a major version.
+     *
+     * @generated from enum value: PRODUCT_STABILITY_STABLE = 3;
+     */
+    STABLE = 3,
+    /**
+     * Works as it did until its removal version.
+     *
+     * @generated from enum value: PRODUCT_STABILITY_DEPRECATED = 4;
+     */
+    DEPRECATED = 4
+}
+/**
+ * ProductStability is how mature a product is. A deployment's
+ * products.min_stability turns off a product below it, as the operator's
+ * switch does.
+ *
+ * @generated from enum toshi.workspace.v1.ProductStability
+ */
+export type ProductStabilityJson = "PRODUCT_STABILITY_UNSPECIFIED" | "PRODUCT_STABILITY_ALPHA" | "PRODUCT_STABILITY_BETA" | "PRODUCT_STABILITY_STABLE" | "PRODUCT_STABILITY_DEPRECATED";
+/**
+ * Describes the enum toshi.workspace.v1.ProductStability.
+ */
+export declare const ProductStabilitySchema: GenEnum<ProductStability, ProductStabilityJson>;
+/**
+ * FeatureSource is where a workspace's entitlement to a feature comes from,
+ * the first that applies in this order: the operator's override, the
+ * value its plan gives the feature, the plan key the feature falls back
+ * to, and the feature's default.
  *
- * @generated from enum toshi.workspace.v1.ProductSwitch
+ * @generated from enum toshi.workspace.v1.FeatureSource
  */
-export declare enum ProductSwitch {
+export declare enum FeatureSource {
     /**
-     * @generated from enum value: PRODUCT_SWITCH_UNSPECIFIED = 0;
+     * @generated from enum value: FEATURE_SOURCE_UNSPECIFIED = 0;
      */
     UNSPECIFIED = 0,
     /**
-     * No switch turns the product off: it is on for the workspace.
+     * The operator's override for the workspace.
      *
-     * @generated from enum value: PRODUCT_SWITCH_ON = 1;
+     * @generated from enum value: FEATURE_SOURCE_OVERRIDE = 1;
      */
-    ON = 1,
+    OVERRIDE = 1,
     /**
-     * The deployment's config turns the product off ("disabled").
+     * The value the workspace's plan gives the feature.
      *
-     * @generated from enum value: PRODUCT_SWITCH_DISABLED = 2;
+     * @generated from enum value: FEATURE_SOURCE_PLAN = 2;
      */
-    DISABLED = 2,
+    PLAN = 2,
     /**
-     * The workspace's entitlements leave the product out ("not_entitled").
+     * The value of the plan key the feature falls back to, which the
+     * workspace's plan sets.
      *
-     * @generated from enum value: PRODUCT_SWITCH_NOT_ENTITLED = 3;
+     * @generated from enum value: FEATURE_SOURCE_PLAN_KEY = 3;
      */
-    NOT_ENTITLED = 3,
+    PLAN_KEY = 3,
     /**
-     * The workspace's settings turn the product off ("turned_off").
+     * The feature's default in its product's manifest.
      *
-     * @generated from enum value: PRODUCT_SWITCH_TURNED_OFF = 4;
+     * @generated from enum value: FEATURE_SOURCE_DEFAULT = 4;
      */
-    TURNED_OFF = 4
+    DEFAULT = 4
 }
 /**
- * ProductSwitch is the switch that decides whether a product is on for a
- * workspace. The deployment's config decides first, then the workspace's
- * entitlements, then its settings; the first that turns the product off is
- * the one named.
+ * FeatureSource is where a workspace's entitlement to a feature comes from,
+ * the first that applies in this order: the operator's override, the
+ * value its plan gives the feature, the plan key the feature falls back
+ * to, and the feature's default.
  *
- * @generated from enum toshi.workspace.v1.ProductSwitch
+ * @generated from enum toshi.workspace.v1.FeatureSource
  */
-export type ProductSwitchJson = "PRODUCT_SWITCH_UNSPECIFIED" | "PRODUCT_SWITCH_ON" | "PRODUCT_SWITCH_DISABLED" | "PRODUCT_SWITCH_NOT_ENTITLED" | "PRODUCT_SWITCH_TURNED_OFF";
+export type FeatureSourceJson = "FEATURE_SOURCE_UNSPECIFIED" | "FEATURE_SOURCE_OVERRIDE" | "FEATURE_SOURCE_PLAN" | "FEATURE_SOURCE_PLAN_KEY" | "FEATURE_SOURCE_DEFAULT";
 /**
- * Describes the enum toshi.workspace.v1.ProductSwitch.
+ * Describes the enum toshi.workspace.v1.FeatureSource.
  */
-export declare const ProductSwitchSchema: GenEnum<ProductSwitch, ProductSwitchJson>;
+export declare const FeatureSourceSchema: GenEnum<FeatureSource, FeatureSourceJson>;
 /**
  * ProductFeatureType is the type of a feature's value.
  *

package/dist/gen/toshi/workspace/v1/discovery_pb.js

@@ -6,7 +6,7 @@ import { file_toshi_permission } from "../../permission_pb.js";
 /**
  * Describes the file toshi/workspace/v1/discovery.proto.
  */
-export const file_toshi_workspace_v1_discovery = /*@__PURE__*/ fileDesc("CiJ0b3NoaS93b3Jrc3BhY2UvdjEvZGlzY292ZXJ5LnByb3RvEhJ0b3NoaS53b3Jrc3BhY2UudjEiNwoPRGlzY292ZXJSZXF1ZXN0Eg8KB3Byb2plY3QYASABKAkSEwoLZW52aXJvbm1lbnQYAiABKAkikwEKEERpc2NvdmVyUmVzcG9uc2USNwoIcHJvZHVjdHMYASADKAsyJS50b3NoaS53b3Jrc3BhY2UudjEuRGlzY292ZXJlZFByb2R1Y3QSEwoLcGVybWlzc2lvbnMYAiADKAkSMQoIdmVyc2lvbnMYAyABKAsyHy50b3NoaS53b3Jrc3BhY2UudjEuQVBJVmVyc2lvbnMi6QEKEURpc2NvdmVyZWRQcm9kdWN0EgoKAmlkGAEgASgJEg8KB3ZlcnNpb24YAiABKAkSDAoEZG9jcxgDIAEoCRIPCgdlbmFibGVkGAQgASgIEjQKCGZlYXR1cmVzGAUgAygLMiIudG9zaGkud29ya3NwYWNlLnYxLlByb2R1Y3RGZWF0dXJlEi8KBXN0YXRlGAYgASgOMiAudG9zaGkud29ya3NwYWNlLnYxLlByb2R1Y3RTdGF0ZRIxCgZzd2l0Y2gYByABKA4yIS50b3NoaS53b3Jrc3BhY2UudjEuUHJvZHVjdFN3aXRjaCKWAgoOUHJvZHVjdEZlYXR1cmUSCwoDa2V5GAEgASgJEjQKBHR5cGUYAiABKA4yJi50b3NoaS53b3Jrc3BhY2UudjEuUHJvZHVjdEZlYXR1cmVUeXBlEg4KBnZhbHVlcxgDIAMoCRISCgpuYXJyb3dhYmxlGAQgASgIEjUKC2VudGl0bGVtZW50GAUgASgLMiAudG9zaGkud29ya3NwYWNlLnYxLkZlYXR1cmVWYWx1ZRIxCgdzZXR0aW5nGAYgASgLMiAudG9zaGkud29ya3NwYWNlLnYxLkZlYXR1cmVWYWx1ZRIzCgllZmZlY3RpdmUYByABKAsyIC50b3NoaS53b3Jrc3BhY2UudjEuRmVhdHVyZVZhbHVlInsKDEZlYXR1cmVWYWx1ZRIOCgRib29sGAEgASgISAASDwoFY291bnQYAiABKANIABIxCgVyYW5nZRgDIAEoCzIgLnRvc2hpLndvcmtzcGFjZS52MS5GZWF0dXJlUmFuZ2VIABIOCgR0ZXh0GAQgASgJSABCBwoFdmFsdWUiKAoMRmVhdHVyZVJhbmdlEgsKA21pbhgBIAEoAxILCgNtYXgYAiABKAMiMQoLQVBJVmVyc2lvbnMSCwoDYXBpGAEgASgJEhUKDWNvbnRyb2xfcGxhbmUYAiABKAkqngEKDFByb2R1Y3RTdGF0ZRIdChlQUk9EVUNUX1NUQVRFX1VOU1BFQ0lGSUVEEAASGQoVUFJPRFVDVF9TVEFURV9FTkFCTEVEEAESHQoZUFJPRFVDVF9TVEFURV9OT19ORVdfV09SSxACEhoKFlBST0RVQ1RfU1RBVEVfRFJBSU5JTkcQAxIZChVQUk9EVUNUX1NUQVRFX1NUT1BQRUQQBCqjAQoNUHJvZHVjdFN3aXRjaBIeChpQUk9EVUNUX1NXSVRDSF9VTlNQRUNJRklFRBAAEhUKEVBST0RVQ1RfU1dJVENIX09OEAESGwoXUFJPRFVDVF9TV0lUQ0hfRElTQUJMRUQQAhIfChtQUk9EVUNUX1NXSVRDSF9OT1RfRU5USVRMRUQQAxIdChlQUk9EVUNUX1NXSVRDSF9UVVJORURfT0ZGEAQq2QEKElByb2R1Y3RGZWF0dXJlVHlwZRIkCiBQUk9EVUNUX0ZFQVRVUkVfVFlQRV9VTlNQRUNJRklFRBAAEh0KGVBST0RVQ1RfRkVBVFVSRV9UWVBFX0JPT0wQARIeChpQUk9EVUNUX0ZFQVRVUkVfVFlQRV9DT1VOVBACEh4KGlBST0RVQ1RfRkVBVFVSRV9UWVBFX1JBTkdFEAMSHQoZUFJPRFVDVF9GRUFUVVJFX1RZUEVfRU5VTRAEEh8KG1BST0RVQ1RfRkVBVFVSRV9UWVBFX1NUUklORxAFMowBChBEaXNjb3ZlcnlTZXJ2aWNlEngKCERpc2NvdmVyEiMudG9zaGkud29ya3NwYWNlLnYxLkRpc2NvdmVyUmVxdWVzdBokLnRvc2hpLndvcmtzcGFjZS52MS5EaXNjb3ZlclJlc3BvbnNlIiHC8xgOd29ya3NwYWNlLnJlYWTK8xgLZW52aXJvbm1lbnRCIlogZ28udG9zaGljbG91ZC5pby9hcGkvd29ya3NwYWNldjFiBnByb3RvMw", [file_toshi_permission]);
+export const file_toshi_workspace_v1_discovery = /*@__PURE__*/ fileDesc("CiJ0b3NoaS93b3Jrc3BhY2UvdjEvZGlzY292ZXJ5LnByb3RvEhJ0b3NoaS53b3Jrc3BhY2UudjEiNwoPRGlzY292ZXJSZXF1ZXN0Eg8KB3Byb2plY3QYASABKAkSEwoLZW52aXJvbm1lbnQYAiABKAkivAEKEERpc2NvdmVyUmVzcG9uc2USNwoIcHJvZHVjdHMYASADKAsyJS50b3NoaS53b3Jrc3BhY2UudjEuRGlzY292ZXJlZFByb2R1Y3QSEwoLcGVybWlzc2lvbnMYAiADKAkSMQoIdmVyc2lvbnMYAyABKAsyHy50b3NoaS53b3Jrc3BhY2UudjEuQVBJVmVyc2lvbnMSGAoQcmVnaXN0cnlfYWRkcmVzcxgEIAEoCRINCgVjYWxscxgFIAMoCSL9AgoRRGlzY292ZXJlZFByb2R1Y3QSCgoCaWQYASABKAkSDwoHdmVyc2lvbhgCIAEoCRIMCgRkb2NzGAMgASgJEg8KB2VuYWJsZWQYBCABKAgSNAoIZmVhdHVyZXMYBSADKAsyIi50b3NoaS53b3Jrc3BhY2UudjEuUHJvZHVjdEZlYXR1cmUSLwoFc3RhdGUYBiABKA4yIC50b3NoaS53b3Jrc3BhY2UudjEuUHJvZHVjdFN0YXRlEjgKCHN1cmZhY2VzGAggASgLMiYudG9zaGkud29ya3NwYWNlLnYxLkRpc2NvdmVyZWRTdXJmYWNlcxIRCglhdmFpbGFibGUYCiABKAgSNwoJc3RhYmlsaXR5GAsgASgOMiQudG9zaGkud29ya3NwYWNlLnYxLlByb2R1Y3RTdGFiaWxpdHkSFwoPcmVtb3ZhbF92ZXJzaW9uGAwgASgJSgQIBxAISgQICRAKUgZzd2l0Y2hSEmluc3RhbGxhdGlvbl9zdGF0ZSJIChJEaXNjb3ZlcmVkU3VyZmFjZXMSCwoDYXBpGAEgASgJSgQIAhADSgQIAxAESgQIBBAFUgNjbGlSCWRhc2hib2FyZFIDc2RrIqEDCg5Qcm9kdWN0RmVhdHVyZRILCgNrZXkYASABKAkSNAoEdHlwZRgCIAEoDjImLnRvc2hpLndvcmtzcGFjZS52MS5Qcm9kdWN0RmVhdHVyZVR5cGUSDgoGdmFsdWVzGAMgAygJEhIKCm5hcnJvd2FibGUYBCABKAgSNQoLZW50aXRsZW1lbnQYBSABKAsyIC50b3NoaS53b3Jrc3BhY2UudjEuRmVhdHVyZVZhbHVlEjEKB3NldHRpbmcYBiABKAsyIC50b3NoaS53b3Jrc3BhY2UudjEuRmVhdHVyZVZhbHVlEjMKCWVmZmVjdGl2ZRgHIAEoCzIgLnRvc2hpLndvcmtzcGFjZS52MS5GZWF0dXJlVmFsdWUSNwoNZGVmYXVsdF92YWx1ZRgIIAEoCzIgLnRvc2hpLndvcmtzcGFjZS52MS5GZWF0dXJlVmFsdWUSCwoDbWF4GAkgASgDEhAKCHBsYW5fa2V5GAogASgJEjEKBnNvdXJjZRgLIAEoDjIhLnRvc2hpLndvcmtzcGFjZS52MS5GZWF0dXJlU291cmNlInsKDEZlYXR1cmVWYWx1ZRIOCgRib29sGAEgASgISAASDwoFY291bnQYAiABKANIABIxCgVyYW5nZRgDIAEoCzIgLnRvc2hpLndvcmtzcGFjZS52MS5GZWF0dXJlUmFuZ2VIABIOCgR0ZXh0GAQgASgJSABCBwoFdmFsdWUiKAoMRmVhdHVyZVJhbmdlEgsKA21pbhgBIAEoAxILCgNtYXgYAiABKAMiMQoLQVBJVmVyc2lvbnMSCwoDYXBpGAEgASgJEhUKDWNvbnRyb2xfcGxhbmUYAiABKAkqngEKDFByb2R1Y3RTdGF0ZRIdChlQUk9EVUNUX1NUQVRFX1VOU1BFQ0lGSUVEEAASGQoVUFJPRFVDVF9TVEFURV9FTkFCTEVEEAESHQoZUFJPRFVDVF9TVEFURV9OT19ORVdfV09SSxACEhoKFlBST0RVQ1RfU1RBVEVfRFJBSU5JTkcQAxIZChVQUk9EVUNUX1NUQVRFX1NUT1BQRUQQBCquAQoQUHJvZHVjdFN0YWJpbGl0eRIhCh1QUk9EVUNUX1NUQUJJTElUWV9VTlNQRUNJRklFRBAAEhsKF1BST0RVQ1RfU1RBQklMSVRZX0FMUEhBEAESGgoWUFJPRFVDVF9TVEFCSUxJVFlfQkVUQRACEhwKGFBST0RVQ1RfU1RBQklMSVRZX1NUQUJMRRADEiAKHFBST0RVQ1RfU1RBQklMSVRZX0RFUFJFQ0FURUQQBCqeAQoNRmVhdHVyZVNvdXJjZRIeChpGRUFUVVJFX1NPVVJDRV9VTlNQRUNJRklFRBAAEhsKF0ZFQVRVUkVfU09VUkNFX09WRVJSSURFEAESFwoTRkVBVFVSRV9TT1VSQ0VfUExBThACEhsKF0ZFQVRVUkVfU09VUkNFX1BMQU5fS0VZEAMSGgoWRkVBVFVSRV9TT1VSQ0VfREVGQVVMVBAEKtkBChJQcm9kdWN0RmVhdHVyZVR5cGUSJAogUFJPRFVDVF9GRUFUVVJFX1RZUEVfVU5TUEVDSUZJRUQQABIdChlQUk9EVUNUX0ZFQVRVUkVfVFlQRV9CT09MEAESHgoaUFJPRFVDVF9GRUFUVVJFX1RZUEVfQ09VTlQQAhIeChpQUk9EVUNUX0ZFQVRVUkVfVFlQRV9SQU5HRRADEh0KGVBST0RVQ1RfRkVBVFVSRV9UWVBFX0VOVU0QBBIfChtQUk9EVUNUX0ZFQVRVUkVfVFlQRV9TVFJJTkcQBTKMAQoQRGlzY292ZXJ5U2VydmljZRJ4CghEaXNjb3ZlchIjLnRvc2hpLndvcmtzcGFjZS52MS5EaXNjb3ZlclJlcXVlc3QaJC50b3NoaS53b3Jrc3BhY2UudjEuRGlzY292ZXJSZXNwb25zZSIhwvMYDndvcmtzcGFjZS5yZWFkyvMYC2Vudmlyb25tZW50QiJaIGdvLnRvc2hpY2xvdWQuaW8vYXBpL3dvcmtzcGFjZXYxYgZwcm90bzM", [file_toshi_permission]);
 /**
  * Describes the message toshi.workspace.v1.DiscoverRequest.
  * Use `create(DiscoverRequestSchema)` to create a new message.
@@ -22,26 +22,31 @@ export const DiscoverResponseSchema = /*@__PURE__*/ messageDesc(file_toshi_works
  * Use `create(DiscoveredProductSchema)` to create a new message.
  */
 export const DiscoveredProductSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 2);
+/**
+ * Describes the message toshi.workspace.v1.DiscoveredSurfaces.
+ * Use `create(DiscoveredSurfacesSchema)` to create a new message.
+ */
+export const DiscoveredSurfacesSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 3);
 /**
  * Describes the message toshi.workspace.v1.ProductFeature.
  * Use `create(ProductFeatureSchema)` to create a new message.
  */
-export const ProductFeatureSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 3);
+export const ProductFeatureSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 4);
 /**
  * Describes the message toshi.workspace.v1.FeatureValue.
  * Use `create(FeatureValueSchema)` to create a new message.
  */
-export const FeatureValueSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 4);
+export const FeatureValueSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 5);
 /**
  * Describes the message toshi.workspace.v1.FeatureRange.
  * Use `create(FeatureRangeSchema)` to create a new message.
  */
-export const FeatureRangeSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 5);
+export const FeatureRangeSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 6);
 /**
  * Describes the message toshi.workspace.v1.APIVersions.
  * Use `create(APIVersionsSchema)` to create a new message.
  */
-export const APIVersionsSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 6);
+export const APIVersionsSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 7);
 /**
  * ProductState is where a product is in the deployment's lifecycle. A
  * product the config turns off goes from no new work through draining to
@@ -88,48 +93,92 @@ export var ProductState;
  */
 export const ProductStateSchema = /*@__PURE__*/ enumDesc(file_toshi_workspace_v1_discovery, 0);
 /**
- * ProductSwitch is the switch that decides whether a product is on for a
- * workspace. The deployment's config decides first, then the workspace's
- * entitlements, then its settings; the first that turns the product off is
- * the one named.
+ * ProductStability is how mature a product is. A deployment's
+ * products.min_stability turns off a product below it, as the operator's
+ * switch does.
+ *
+ * @generated from enum toshi.workspace.v1.ProductStability
+ */
+export var ProductStability;
+(function (ProductStability) {
+    /**
+     * @generated from enum value: PRODUCT_STABILITY_UNSPECIFIED = 0;
+     */
+    ProductStability[ProductStability["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * May change or go away in any release.
+     *
+     * @generated from enum value: PRODUCT_STABILITY_ALPHA = 1;
+     */
+    ProductStability[ProductStability["ALPHA"] = 1] = "ALPHA";
+    /**
+     * Complete; its configuration and API may still change between minor
+     * releases, with notice.
+     *
+     * @generated from enum value: PRODUCT_STABILITY_BETA = 2;
+     */
+    ProductStability[ProductStability["BETA"] = 2] = "BETA";
+    /**
+     * Changes only compatibly within a major version.
+     *
+     * @generated from enum value: PRODUCT_STABILITY_STABLE = 3;
+     */
+    ProductStability[ProductStability["STABLE"] = 3] = "STABLE";
+    /**
+     * Works as it did until its removal version.
+     *
+     * @generated from enum value: PRODUCT_STABILITY_DEPRECATED = 4;
+     */
+    ProductStability[ProductStability["DEPRECATED"] = 4] = "DEPRECATED";
+})(ProductStability || (ProductStability = {}));
+/**
+ * Describes the enum toshi.workspace.v1.ProductStability.
+ */
+export const ProductStabilitySchema = /*@__PURE__*/ enumDesc(file_toshi_workspace_v1_discovery, 1);
+/**
+ * FeatureSource is where a workspace's entitlement to a feature comes from,
+ * the first that applies in this order: the operator's override, the
+ * value its plan gives the feature, the plan key the feature falls back
+ * to, and the feature's default.
  *
- * @generated from enum toshi.workspace.v1.ProductSwitch
+ * @generated from enum toshi.workspace.v1.FeatureSource
  */
-export var ProductSwitch;
-(function (ProductSwitch) {
+export var FeatureSource;
+(function (FeatureSource) {
     /**
-     * @generated from enum value: PRODUCT_SWITCH_UNSPECIFIED = 0;
+     * @generated from enum value: FEATURE_SOURCE_UNSPECIFIED = 0;
      */
-    ProductSwitch[ProductSwitch["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    FeatureSource[FeatureSource["UNSPECIFIED"] = 0] = "UNSPECIFIED";
     /**
-     * No switch turns the product off: it is on for the workspace.
+     * The operator's override for the workspace.
      *
-     * @generated from enum value: PRODUCT_SWITCH_ON = 1;
+     * @generated from enum value: FEATURE_SOURCE_OVERRIDE = 1;
      */
-    ProductSwitch[ProductSwitch["ON"] = 1] = "ON";
+    FeatureSource[FeatureSource["OVERRIDE"] = 1] = "OVERRIDE";
     /**
-     * The deployment's config turns the product off ("disabled").
+     * The value the workspace's plan gives the feature.
      *
-     * @generated from enum value: PRODUCT_SWITCH_DISABLED = 2;
+     * @generated from enum value: FEATURE_SOURCE_PLAN = 2;
      */
-    ProductSwitch[ProductSwitch["DISABLED"] = 2] = "DISABLED";
+    FeatureSource[FeatureSource["PLAN"] = 2] = "PLAN";
     /**
-     * The workspace's entitlements leave the product out ("not_entitled").
+     * The value of the plan key the feature falls back to, which the
+     * workspace's plan sets.
      *
-     * @generated from enum value: PRODUCT_SWITCH_NOT_ENTITLED = 3;
+     * @generated from enum value: FEATURE_SOURCE_PLAN_KEY = 3;
      */
-    ProductSwitch[ProductSwitch["NOT_ENTITLED"] = 3] = "NOT_ENTITLED";
+    FeatureSource[FeatureSource["PLAN_KEY"] = 3] = "PLAN_KEY";
     /**
-     * The workspace's settings turn the product off ("turned_off").
+     * The feature's default in its product's manifest.
      *
-     * @generated from enum value: PRODUCT_SWITCH_TURNED_OFF = 4;
+     * @generated from enum value: FEATURE_SOURCE_DEFAULT = 4;
      */
-    ProductSwitch[ProductSwitch["TURNED_OFF"] = 4] = "TURNED_OFF";
-})(ProductSwitch || (ProductSwitch = {}));
+    FeatureSource[FeatureSource["DEFAULT"] = 4] = "DEFAULT";
+})(FeatureSource || (FeatureSource = {}));
 /**
- * Describes the enum toshi.workspace.v1.ProductSwitch.
+ * Describes the enum toshi.workspace.v1.FeatureSource.
  */
-export const ProductSwitchSchema = /*@__PURE__*/ enumDesc(file_toshi_workspace_v1_discovery, 1);
+export const FeatureSourceSchema = /*@__PURE__*/ enumDesc(file_toshi_workspace_v1_discovery, 2);
 /**
  * ProductFeatureType is the type of a feature's value.
  *
@@ -165,7 +214,7 @@ export var ProductFeatureType;
 /**
  * Describes the enum toshi.workspace.v1.ProductFeatureType.
  */
-export const ProductFeatureTypeSchema = /*@__PURE__*/ enumDesc(file_toshi_workspace_v1_discovery, 2);
+export const ProductFeatureTypeSchema = /*@__PURE__*/ enumDesc(file_toshi_workspace_v1_discovery, 3);
 /**
  * DiscoveryService tells a client what this deployment serves and what the
  * caller may do in the workspace, in one call: the products the build