@toshicloud/sdk 0.4.0 → 0.5.1

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

@@ -0,0 +1,231 @@
+// @generated by protoc-gen-es v2.16.0 with parameter "target=ts,json_types=true,import_extension=js"
+// @generated from file toshi/workspace/v1/discovery.proto (package toshi.workspace.v1, syntax proto3)
+/* eslint-disable */
+import { enumDesc, fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+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("CiJ0b3NoaS93b3Jrc3BhY2UvdjEvZGlzY292ZXJ5LnByb3RvEhJ0b3NoaS53b3Jrc3BhY2UudjEiNwoPRGlzY292ZXJSZXF1ZXN0Eg8KB3Byb2plY3QYASABKAkSEwoLZW52aXJvbm1lbnQYAiABKAkivAEKEERpc2NvdmVyUmVzcG9uc2USNwoIcHJvZHVjdHMYASADKAsyJS50b3NoaS53b3Jrc3BhY2UudjEuRGlzY292ZXJlZFByb2R1Y3QSEwoLcGVybWlzc2lvbnMYAiADKAkSMQoIdmVyc2lvbnMYAyABKAsyHy50b3NoaS53b3Jrc3BhY2UudjEuQVBJVmVyc2lvbnMSGAoQcmVnaXN0cnlfYWRkcmVzcxgEIAEoCRINCgVjYWxscxgFIAMoCSL9AgoRRGlzY292ZXJlZFByb2R1Y3QSCgoCaWQYASABKAkSDwoHdmVyc2lvbhgCIAEoCRIMCgRkb2NzGAMgASgJEg8KB2VuYWJsZWQYBCABKAgSNAoIZmVhdHVyZXMYBSADKAsyIi50b3NoaS53b3Jrc3BhY2UudjEuUHJvZHVjdEZlYXR1cmUSLwoFc3RhdGUYBiABKA4yIC50b3NoaS53b3Jrc3BhY2UudjEuUHJvZHVjdFN0YXRlEjgKCHN1cmZhY2VzGAggASgLMiYudG9zaGkud29ya3NwYWNlLnYxLkRpc2NvdmVyZWRTdXJmYWNlcxIRCglhdmFpbGFibGUYCiABKAgSNwoJc3RhYmlsaXR5GAsgASgOMiQudG9zaGkud29ya3NwYWNlLnYxLlByb2R1Y3RTdGFiaWxpdHkSFwoPcmVtb3ZhbF92ZXJzaW9uGAwgASgJSgQIBxAISgQICRAKUgZzd2l0Y2hSEmluc3RhbGxhdGlvbl9zdGF0ZSJIChJEaXNjb3ZlcmVkU3VyZmFjZXMSCwoDYXBpGAEgASgJSgQIAhADSgQIAxAESgQIBBAFUgNjbGlSCWRhc2hib2FyZFIDc2RrIqEDCg5Qcm9kdWN0RmVhdHVyZRILCgNrZXkYASABKAkSNAoEdHlwZRgCIAEoDjImLnRvc2hpLndvcmtzcGFjZS52MS5Qcm9kdWN0RmVhdHVyZVR5cGUSDgoGdmFsdWVzGAMgAygJEhIKCm5hcnJvd2FibGUYBCABKAgSNQoLZW50aXRsZW1lbnQYBSABKAsyIC50b3NoaS53b3Jrc3BhY2UudjEuRmVhdHVyZVZhbHVlEjEKB3NldHRpbmcYBiABKAsyIC50b3NoaS53b3Jrc3BhY2UudjEuRmVhdHVyZVZhbHVlEjMKCWVmZmVjdGl2ZRgHIAEoCzIgLnRvc2hpLndvcmtzcGFjZS52MS5GZWF0dXJlVmFsdWUSNwoNZGVmYXVsdF92YWx1ZRgIIAEoCzIgLnRvc2hpLndvcmtzcGFjZS52MS5GZWF0dXJlVmFsdWUSCwoDbWF4GAkgASgDEhAKCHBsYW5fa2V5GAogASgJEjEKBnNvdXJjZRgLIAEoDjIhLnRvc2hpLndvcmtzcGFjZS52MS5GZWF0dXJlU291cmNlInsKDEZlYXR1cmVWYWx1ZRIOCgRib29sGAEgASgISAASDwoFY291bnQYAiABKANIABIxCgVyYW5nZRgDIAEoCzIgLnRvc2hpLndvcmtzcGFjZS52MS5GZWF0dXJlUmFuZ2VIABIOCgR0ZXh0GAQgASgJSABCBwoFdmFsdWUiKAoMRmVhdHVyZVJhbmdlEgsKA21pbhgBIAEoAxILCgNtYXgYAiABKAMiMQoLQVBJVmVyc2lvbnMSCwoDYXBpGAEgASgJEhUKDWNvbnRyb2xfcGxhbmUYAiABKAkqngEKDFByb2R1Y3RTdGF0ZRIdChlQUk9EVUNUX1NUQVRFX1VOU1BFQ0lGSUVEEAASGQoVUFJPRFVDVF9TVEFURV9FTkFCTEVEEAESHQoZUFJPRFVDVF9TVEFURV9OT19ORVdfV09SSxACEhoKFlBST0RVQ1RfU1RBVEVfRFJBSU5JTkcQAxIZChVQUk9EVUNUX1NUQVRFX1NUT1BQRUQQBCquAQoQUHJvZHVjdFN0YWJpbGl0eRIhCh1QUk9EVUNUX1NUQUJJTElUWV9VTlNQRUNJRklFRBAAEhsKF1BST0RVQ1RfU1RBQklMSVRZX0FMUEhBEAESGgoWUFJPRFVDVF9TVEFCSUxJVFlfQkVUQRACEhwKGFBST0RVQ1RfU1RBQklMSVRZX1NUQUJMRRADEiAKHFBST0RVQ1RfU1RBQklMSVRZX0RFUFJFQ0FURUQQBCqeAQoNRmVhdHVyZVNvdXJjZRIeChpGRUFUVVJFX1NPVVJDRV9VTlNQRUNJRklFRBAAEhsKF0ZFQVRVUkVfU09VUkNFX09WRVJSSURFEAESFwoTRkVBVFVSRV9TT1VSQ0VfUExBThACEhsKF0ZFQVRVUkVfU09VUkNFX1BMQU5fS0VZEAMSGgoWRkVBVFVSRV9TT1VSQ0VfREVGQVVMVBAEKtkBChJQcm9kdWN0RmVhdHVyZVR5cGUSJAogUFJPRFVDVF9GRUFUVVJFX1RZUEVfVU5TUEVDSUZJRUQQABIdChlQUk9EVUNUX0ZFQVRVUkVfVFlQRV9CT09MEAESHgoaUFJPRFVDVF9GRUFUVVJFX1RZUEVfQ09VTlQQAhIeChpQUk9EVUNUX0ZFQVRVUkVfVFlQRV9SQU5HRRADEh0KGVBST0RVQ1RfRkVBVFVSRV9UWVBFX0VOVU0QBBIfChtQUk9EVUNUX0ZFQVRVUkVfVFlQRV9TVFJJTkcQBTKMAQoQRGlzY292ZXJ5U2VydmljZRJ4CghEaXNjb3ZlchIjLnRvc2hpLndvcmtzcGFjZS52MS5EaXNjb3ZlclJlcXVlc3QaJC50b3NoaS53b3Jrc3BhY2UudjEuRGlzY292ZXJSZXNwb25zZSIhwvMYDndvcmtzcGFjZS5yZWFkyvMYC2Vudmlyb25tZW50QiJaIGdvLnRvc2hpY2xvdWQuaW8vYXBpL3dvcmtzcGFjZXYxYgZwcm90bzM", [file_toshi_permission]);
+/**
+ * Describes the message toshi.workspace.v1.DiscoverRequest.
+ * Use `create(DiscoverRequestSchema)` to create a new message.
+ */
+export const DiscoverRequestSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 0);
+/**
+ * Describes the message toshi.workspace.v1.DiscoverResponse.
+ * Use `create(DiscoverResponseSchema)` to create a new message.
+ */
+export const DiscoverResponseSchema = /*@__PURE__*/ messageDesc(file_toshi_workspace_v1_discovery, 1);
+/**
+ * Describes the message toshi.workspace.v1.DiscoveredProduct.
+ * 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, 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, 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, 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, 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
+ * stopped as its work ends, and back to enabled when the config turns it on
+ * again. None of the states deletes the product's data.
+ *
+ * @generated from enum toshi.workspace.v1.ProductState
+ */
+export var ProductState;
+(function (ProductState) {
+    /**
+     * @generated from enum value: PRODUCT_STATE_UNSPECIFIED = 0;
+     */
+    ProductState[ProductState["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * The config turns the product on: it takes new work.
+     *
+     * @generated from enum value: PRODUCT_STATE_ENABLED = 1;
+     */
+    ProductState[ProductState["ENABLED"] = 1] = "ENABLED";
+    /**
+     * Turned off, with work it accepted that has not started: it takes no new
+     * work, and that work still runs.
+     *
+     * @generated from enum value: PRODUCT_STATE_NO_NEW_WORK = 2;
+     */
+    ProductState[ProductState["NO_NEW_WORK"] = 2] = "NO_NEW_WORK";
+    /**
+     * Turned off, with its last work running: that work ends as it would
+     * have.
+     *
+     * @generated from enum value: PRODUCT_STATE_DRAINING = 3;
+     */
+    ProductState[ProductState["DRAINING"] = 3] = "DRAINING";
+    /**
+     * Turned off, with nothing left to finish.
+     *
+     * @generated from enum value: PRODUCT_STATE_STOPPED = 4;
+     */
+    ProductState[ProductState["STOPPED"] = 4] = "STOPPED";
+})(ProductState || (ProductState = {}));
+/**
+ * Describes the enum toshi.workspace.v1.ProductState.
+ */
+export const ProductStateSchema = /*@__PURE__*/ enumDesc(file_toshi_workspace_v1_discovery, 0);
+/**
+ * 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.FeatureSource
+ */
+export var FeatureSource;
+(function (FeatureSource) {
+    /**
+     * @generated from enum value: FEATURE_SOURCE_UNSPECIFIED = 0;
+     */
+    FeatureSource[FeatureSource["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * The operator's override for the workspace.
+     *
+     * @generated from enum value: FEATURE_SOURCE_OVERRIDE = 1;
+     */
+    FeatureSource[FeatureSource["OVERRIDE"] = 1] = "OVERRIDE";
+    /**
+     * The value the workspace's plan gives the feature.
+     *
+     * @generated from enum value: FEATURE_SOURCE_PLAN = 2;
+     */
+    FeatureSource[FeatureSource["PLAN"] = 2] = "PLAN";
+    /**
+     * The value of the plan key the feature falls back to, which the
+     * workspace's plan sets.
+     *
+     * @generated from enum value: FEATURE_SOURCE_PLAN_KEY = 3;
+     */
+    FeatureSource[FeatureSource["PLAN_KEY"] = 3] = "PLAN_KEY";
+    /**
+     * The feature's default in its product's manifest.
+     *
+     * @generated from enum value: FEATURE_SOURCE_DEFAULT = 4;
+     */
+    FeatureSource[FeatureSource["DEFAULT"] = 4] = "DEFAULT";
+})(FeatureSource || (FeatureSource = {}));
+/**
+ * Describes the enum toshi.workspace.v1.FeatureSource.
+ */
+export const FeatureSourceSchema = /*@__PURE__*/ enumDesc(file_toshi_workspace_v1_discovery, 2);
+/**
+ * ProductFeatureType is the type of a feature's value.
+ *
+ * @generated from enum toshi.workspace.v1.ProductFeatureType
+ */
+export var ProductFeatureType;
+(function (ProductFeatureType) {
+    /**
+     * @generated from enum value: PRODUCT_FEATURE_TYPE_UNSPECIFIED = 0;
+     */
+    ProductFeatureType[ProductFeatureType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * @generated from enum value: PRODUCT_FEATURE_TYPE_BOOL = 1;
+     */
+    ProductFeatureType[ProductFeatureType["BOOL"] = 1] = "BOOL";
+    /**
+     * @generated from enum value: PRODUCT_FEATURE_TYPE_COUNT = 2;
+     */
+    ProductFeatureType[ProductFeatureType["COUNT"] = 2] = "COUNT";
+    /**
+     * @generated from enum value: PRODUCT_FEATURE_TYPE_RANGE = 3;
+     */
+    ProductFeatureType[ProductFeatureType["RANGE"] = 3] = "RANGE";
+    /**
+     * @generated from enum value: PRODUCT_FEATURE_TYPE_ENUM = 4;
+     */
+    ProductFeatureType[ProductFeatureType["ENUM"] = 4] = "ENUM";
+    /**
+     * @generated from enum value: PRODUCT_FEATURE_TYPE_STRING = 5;
+     */
+    ProductFeatureType[ProductFeatureType["STRING"] = 5] = "STRING";
+})(ProductFeatureType || (ProductFeatureType = {}));
+/**
+ * Describes the enum toshi.workspace.v1.ProductFeatureType.
+ */
+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
+ * includes, where each is in the deployment's lifecycle and whether the
+ * workspace has it on, each feature's entitlement, setting and effective
+ * value, the caller's permissions and the versions of the API and the
+ * control plane. A client
+ * reads it to decide what to show and what to call.
+ *
+ * The caller's credential names the workspace, as for WorkloadService.
+ *
+ * @generated from service toshi.workspace.v1.DiscoveryService
+ */
+export const DiscoveryService = /*@__PURE__*/ serviceDesc(file_toshi_workspace_v1_discovery, 0);

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

@@ -28,7 +28,9 @@ export type DisplaySession = Message<"toshi.workspace.v1.DisplaySession"> & {
     mode: DisplayMode;
     /**
      * For an agent's run: whether a person may take the input from the
-     * agent. Recorded; takeover itself is not served yet.
+     * agent. A person's DISPLAY_MODE_WITH_INPUT open on the job closes this
+     * session with close_reason taken_over when it is a program's session
+     * with input that allows it, and is refused when it does not.
      *
      * @generated from field: bool allow_takeover = 4;
      */
@@ -74,15 +76,17 @@ export type DisplaySession = Message<"toshi.workspace.v1.DisplaySession"> & {
      * Why it closed: closed, idle, expired, suspended, ended (its job
      * stopped running where the session was opened), protocol_error (the
      * viewer sent what the relay does not accept), unavailable (the job's
-     * host did not open the screen) or shutdown (the control plane
-     * stopped). Empty while it is open.
+     * host did not open the screen), shutdown (the control plane stopped),
+     * grant_revoked (it was opened through a grant that ended) or
+     * taken_over (a person's session with input took its input). Empty while
+     * it is open.
      *
      * @generated from field: string close_reason = 12;
      */
     closeReason: string;
     /**
-     * Who opened it, as the audit log names the caller: the GitHub login of
-     * the signed-in person for DISPLAY_OPENER_PERSON, the API token's id for
+     * Who opened it, as the audit log names the caller: the user ID of the
+     * signed-in person for DISPLAY_OPENER_PERSON, the API token's id for
      * DISPLAY_OPENER_PROGRAM.
      *
      * @generated from field: string opener_id = 13;
@@ -102,6 +106,28 @@ export type DisplaySession = Message<"toshi.workspace.v1.DisplaySession"> & {
      * @generated from field: string attach_token_id = 15;
      */
     attachTokenId: string;
+    /**
+     * The grant through which another workspace opened the session, or
+     * empty for one the job's own workspace opened.
+     *
+     * @generated from field: string grant_id = 16;
+     */
+    grantId: string;
+    /**
+     * Whether the screen is being recorded now, for the session's viewer to
+     * show beside it.
+     *
+     * @generated from field: toshi.workspace.v1.DisplayRecordingState recording_state = 17;
+     */
+    recordingState: DisplayRecordingState;
+    /**
+     * While recording_state is DISPLAY_RECORDING_STATE_QUOTA_REACHED, the
+     * cap that holds the recording back, as the sandbox's
+     * recording_stopped_reason says it; empty in every other state.
+     *
+     * @generated from field: string recording_stopped_reason = 18;
+     */
+    recordingStoppedReason: string;
 };
 /**
  * @generated from message toshi.workspace.v1.DisplaySession
@@ -126,7 +152,9 @@ export type DisplaySessionJson = {
     mode?: DisplayModeJson;
     /**
      * For an agent's run: whether a person may take the input from the
-     * agent. Recorded; takeover itself is not served yet.
+     * agent. A person's DISPLAY_MODE_WITH_INPUT open on the job closes this
+     * session with close_reason taken_over when it is a program's session
+     * with input that allows it, and is refused when it does not.
      *
      * @generated from field: bool allow_takeover = 4;
      */
@@ -172,15 +200,17 @@ export type DisplaySessionJson = {
      * Why it closed: closed, idle, expired, suspended, ended (its job
      * stopped running where the session was opened), protocol_error (the
      * viewer sent what the relay does not accept), unavailable (the job's
-     * host did not open the screen) or shutdown (the control plane
-     * stopped). Empty while it is open.
+     * host did not open the screen), shutdown (the control plane stopped),
+     * grant_revoked (it was opened through a grant that ended) or
+     * taken_over (a person's session with input took its input). Empty while
+     * it is open.
      *
      * @generated from field: string close_reason = 12;
      */
     closeReason?: string;
     /**
-     * Who opened it, as the audit log names the caller: the GitHub login of
-     * the signed-in person for DISPLAY_OPENER_PERSON, the API token's id for
+     * Who opened it, as the audit log names the caller: the user ID of the
+     * signed-in person for DISPLAY_OPENER_PERSON, the API token's id for
      * DISPLAY_OPENER_PROGRAM.
      *
      * @generated from field: string opener_id = 13;
@@ -200,6 +230,28 @@ export type DisplaySessionJson = {
      * @generated from field: string attach_token_id = 15;
      */
     attachTokenId?: string;
+    /**
+     * The grant through which another workspace opened the session, or
+     * empty for one the job's own workspace opened.
+     *
+     * @generated from field: string grant_id = 16;
+     */
+    grantId?: string;
+    /**
+     * Whether the screen is being recorded now, for the session's viewer to
+     * show beside it.
+     *
+     * @generated from field: toshi.workspace.v1.DisplayRecordingState recording_state = 17;
+     */
+    recordingState?: DisplayRecordingStateJson;
+    /**
+     * While recording_state is DISPLAY_RECORDING_STATE_QUOTA_REACHED, the
+     * cap that holds the recording back, as the sandbox's
+     * recording_stopped_reason says it; empty in every other state.
+     *
+     * @generated from field: string recording_stopped_reason = 18;
+     */
+    recordingStoppedReason?: string;
 };
 /**
  * Describes the message toshi.workspace.v1.DisplaySession.
@@ -239,7 +291,8 @@ export type OpenDisplaySessionRequest = Message<"toshi.workspace.v1.OpenDisplayS
      */
     mode: DisplayMode;
     /**
-     * The idle close, at most the plan's; unset is the plan's.
+     * The idle close, at least 1 second and at most the plan's; unset is the
+     * plan's.
      *
      * @generated from field: google.protobuf.Duration idle_close = 4;
      */
@@ -252,6 +305,13 @@ export type OpenDisplaySessionRequest = Message<"toshi.workspace.v1.OpenDisplayS
      * @generated from field: string request_key = 6;
      */
     requestKey: string;
+    /**
+     * A grant the caller's workspace received, to act on the owner's
+     * sandbox's job through it (docs/grants.md).
+     *
+     * @generated from field: string grant = 7;
+     */
+    grant: string;
 };
 /**
  * @generated from message toshi.workspace.v1.OpenDisplaySessionRequest
@@ -270,7 +330,8 @@ export type OpenDisplaySessionRequestJson = {
      */
     mode?: DisplayModeJson;
     /**
-     * The idle close, at most the plan's; unset is the plan's.
+     * The idle close, at least 1 second and at most the plan's; unset is the
+     * plan's.
      *
      * @generated from field: google.protobuf.Duration idle_close = 4;
      */
@@ -283,6 +344,13 @@ export type OpenDisplaySessionRequestJson = {
      * @generated from field: string request_key = 6;
      */
     requestKey?: string;
+    /**
+     * A grant the caller's workspace received, to act on the owner's
+     * sandbox's job through it (docs/grants.md).
+     *
+     * @generated from field: string grant = 7;
+     */
+    grant?: string;
 };
 /**
  * Describes the message toshi.workspace.v1.OpenDisplaySessionRequest.
@@ -370,6 +438,13 @@ export type GetDisplaySessionRequest = Message<"toshi.workspace.v1.GetDisplaySes
      * @generated from field: string session_id = 1;
      */
     sessionId: string;
+    /**
+     * A grant the caller's workspace received: the call then reaches the
+     * sessions opened through that grant (docs/grants.md).
+     *
+     * @generated from field: string grant = 2;
+     */
+    grant: string;
 };
 /**
  * @generated from message toshi.workspace.v1.GetDisplaySessionRequest
@@ -379,6 +454,13 @@ export type GetDisplaySessionRequestJson = {
      * @generated from field: string session_id = 1;
      */
     sessionId?: string;
+    /**
+     * A grant the caller's workspace received: the call then reaches the
+     * sessions opened through that grant (docs/grants.md).
+     *
+     * @generated from field: string grant = 2;
+     */
+    grant?: string;
 };
 /**
  * Describes the message toshi.workspace.v1.GetDisplaySessionRequest.
@@ -440,6 +522,13 @@ export type ListDisplaySessionsRequest = Message<"toshi.workspace.v1.ListDisplay
      * @generated from field: string page_token = 4;
      */
     pageToken: string;
+    /**
+     * A grant the caller's workspace received: the call then reaches the
+     * sessions opened through that grant (docs/grants.md).
+     *
+     * @generated from field: string grant = 5;
+     */
+    grant: string;
 };
 /**
  * @generated from message toshi.workspace.v1.ListDisplaySessionsRequest
@@ -469,6 +558,13 @@ export type ListDisplaySessionsRequestJson = {
      * @generated from field: string page_token = 4;
      */
     pageToken?: string;
+    /**
+     * A grant the caller's workspace received: the call then reaches the
+     * sessions opened through that grant (docs/grants.md).
+     *
+     * @generated from field: string grant = 5;
+     */
+    grant?: string;
 };
 /**
  * Describes the message toshi.workspace.v1.ListDisplaySessionsRequest.
@@ -522,6 +618,13 @@ export type CloseDisplaySessionRequest = Message<"toshi.workspace.v1.CloseDispla
      * @generated from field: string session_id = 1;
      */
     sessionId: string;
+    /**
+     * A grant the caller's workspace received: the call then reaches the
+     * sessions opened through that grant (docs/grants.md).
+     *
+     * @generated from field: string grant = 2;
+     */
+    grant: string;
 };
 /**
  * @generated from message toshi.workspace.v1.CloseDisplaySessionRequest
@@ -531,6 +634,13 @@ export type CloseDisplaySessionRequestJson = {
      * @generated from field: string session_id = 1;
      */
     sessionId?: string;
+    /**
+     * A grant the caller's workspace received: the call then reaches the
+     * sessions opened through that grant (docs/grants.md).
+     *
+     * @generated from field: string grant = 2;
+     */
+    grant?: string;
 };
 /**
  * Describes the message toshi.workspace.v1.CloseDisplaySessionRequest.
@@ -1005,6 +1115,64 @@ export type DisplaySessionStateJson = "DISPLAY_SESSION_STATE_UNSPECIFIED" | "DIS
  * Describes the enum toshi.workspace.v1.DisplaySessionState.
  */
 export declare const DisplaySessionStateSchema: GenEnum<DisplaySessionState, DisplaySessionStateJson>;
+/**
+ * DisplayRecordingState says whether the screen a session views is being
+ * recorded now. It describes the job or sandbox, not the viewer: every
+ * session of the same screen has the same state. The first that holds is
+ * the state, in this order.
+ *
+ * @generated from enum toshi.workspace.v1.DisplayRecordingState
+ */
+export declare enum DisplayRecordingState {
+    /**
+     * Never sent.
+     *
+     * @generated from enum value: DISPLAY_RECORDING_STATE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * Nothing is recorded: the recording policy is off, the workspace
+     * switched recording off, or the host boots no desktop for it.
+     *
+     * @generated from enum value: DISPLAY_RECORDING_STATE_OFF = 1;
+     */
+    OFF = 1,
+    /**
+     * A recording cap holds the recording back; recording_stopped_reason
+     * says which.
+     *
+     * @generated from enum value: DISPLAY_RECORDING_STATE_QUOTA_REACHED = 2;
+     */
+    QUOTA_REACHED = 2,
+    /**
+     * A person controls the screen and is not recorded: the workspace
+     * keeps no screenshots of a person's control, the person paused it, or
+     * the pause reached its limit and the control has not ended yet.
+     *
+     * @generated from enum value: DISPLAY_RECORDING_STATE_PRIVATE = 3;
+     */
+    PRIVATE = 3,
+    /**
+     * Any other time: a strip is capturing, or the next one is still to
+     * start.
+     *
+     * @generated from enum value: DISPLAY_RECORDING_STATE_RECORDING = 4;
+     */
+    RECORDING = 4
+}
+/**
+ * DisplayRecordingState says whether the screen a session views is being
+ * recorded now. It describes the job or sandbox, not the viewer: every
+ * session of the same screen has the same state. The first that holds is
+ * the state, in this order.
+ *
+ * @generated from enum toshi.workspace.v1.DisplayRecordingState
+ */
+export type DisplayRecordingStateJson = "DISPLAY_RECORDING_STATE_UNSPECIFIED" | "DISPLAY_RECORDING_STATE_OFF" | "DISPLAY_RECORDING_STATE_QUOTA_REACHED" | "DISPLAY_RECORDING_STATE_PRIVATE" | "DISPLAY_RECORDING_STATE_RECORDING";
+/**
+ * Describes the enum toshi.workspace.v1.DisplayRecordingState.
+ */
+export declare const DisplayRecordingStateSchema: GenEnum<DisplayRecordingState, DisplayRecordingStateJson>;
 /**
  * DisplayOpener is how a session was opened.
  *
@@ -1062,7 +1230,19 @@ export declare const DisplayService: GenService<{
      * OpenDisplaySession opens a session on a running job and returns its
      * URL and token. A job that is not running, or one beyond the plan's
      * viewers, or a second session with input on a job, fails with
-     * FAILED_PRECONDITION. A session ends when it is closed, when no bytes
+     * FAILED_PRECONDITION. A session with input on a Windows VM whose host's
+     * pool does not set display_input fails with FAILED_PRECONDITION and the
+     * reason DISPLAY_INPUT_NOT_ENABLED. A job on a cloud pool's Windows opens
+     * no session of either mode: FAILED_PRECONDITION with the reason
+     * TOSHI_LICENSED_WINDOWS. On a host whose pool has licence = "toshi" only
+     * a person who holds a live desktop seat in the workspace opens one (a
+     * sign-in, or that person's own access token); anyone else fails with
+     * FAILED_PRECONDITION and the reason DESKTOP_SEAT_PERSON_REQUIRED for a
+     * caller that is not a person (a workspace token, a product token, a
+     * workload) or DESKTOP_SEAT_REQUIRED for a person without a seat. An
+     * input or screenshot call there by anyone but the session's opener is
+     * checked the same way.
+     * A session ends when it is closed, when no bytes
      * of the screen's protocol go either way for its idle close, when its
      * token expires before it attaches, when its job stops running on the
      * VM it was opened on, or when the workspace is suspended.
@@ -1116,7 +1296,8 @@ export declare const DisplayService: GenService<{
     };
     /**
      * SendDisplayKeys presses and releases keys on the screen. A view-only
-     * session refuses it with FAILED_PRECONDITION.
+     * session refuses it with FAILED_PRECONDITION, with the reason
+     * DISPLAY_INPUT_NOT_ENABLED on a Windows VM that takes no input.
      *
      * @generated from rpc toshi.workspace.v1.DisplayService.SendDisplayKeys
      */
@@ -1127,7 +1308,9 @@ export declare const DisplayService: GenService<{
     };
     /**
      * SendDisplayPointer moves the pointer and presses or releases its
-     * buttons. A view-only session refuses it with FAILED_PRECONDITION.
+     * buttons. A view-only session refuses it with FAILED_PRECONDITION, with
+     * the reason DISPLAY_INPUT_NOT_ENABLED on a Windows VM that takes no
+     * input.
      *
      * @generated from rpc toshi.workspace.v1.DisplayService.SendDisplayPointer
      */