@meshery/schemas 1.3.95 → 1.3.97

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/dist/cloudApi.d.mts +1575 -1809
  2. package/dist/cloudApi.d.ts +1575 -1809
  3. package/dist/cloudApi.js +1 -1
  4. package/dist/cloudApi.mjs +1 -1
  5. package/dist/constructs/v1beta1/registry/Registry.d.ts +3 -3
  6. package/dist/constructs/v1beta1/registry/RegistrySchema.js +3 -3
  7. package/dist/constructs/v1beta1/registry/RegistrySchema.mjs +3 -3
  8. package/dist/constructs/v1beta2/organization/Organization.d.ts +1 -1
  9. package/dist/constructs/v1beta2/organization/OrganizationSchema.js +1 -1
  10. package/dist/constructs/v1beta2/organization/OrganizationSchema.mjs +1 -1
  11. package/dist/constructs/v1beta3/claim/Claim.d.ts +492 -80
  12. package/dist/constructs/v1beta3/claim/ClaimSchema.js +25 -84
  13. package/dist/constructs/v1beta3/claim/ClaimSchema.mjs +25 -84
  14. package/dist/constructs/v1beta3/connection/Connection.d.ts +194 -21
  15. package/dist/constructs/v1beta3/connection/ConnectionSchema.js +5 -4
  16. package/dist/constructs/v1beta3/connection/ConnectionSchema.mjs +5 -4
  17. package/dist/constructs/v1beta3/content_item/ContentItem.d.ts +30 -0
  18. package/dist/constructs/v1beta3/content_item/ContentItemSchema.js +12 -6
  19. package/dist/constructs/v1beta3/content_item/ContentItemSchema.mjs +12 -6
  20. package/dist/constructs/v1beta3/design/Design.d.ts +2 -2
  21. package/dist/constructs/v1beta3/design/DesignSchema.js +2 -2
  22. package/dist/constructs/v1beta3/design/DesignSchema.mjs +2 -2
  23. package/dist/constructs/v1beta3/event/Event.d.ts +7 -7
  24. package/dist/constructs/v1beta3/event/EventSchema.js +5 -2
  25. package/dist/constructs/v1beta3/event/EventSchema.mjs +5 -2
  26. package/dist/constructs/v1beta3/provider_capability/ProviderCapability.d.ts +2 -2
  27. package/dist/constructs/v1beta3/provider_capability/ProviderCapabilitySchema.js +2 -2
  28. package/dist/constructs/v1beta3/provider_capability/ProviderCapabilitySchema.mjs +2 -2
  29. package/dist/constructs/v1beta3/schedule/Schedule.d.ts +1342 -1586
  30. package/dist/constructs/v1beta3/schedule/ScheduleSchema.js +10 -34
  31. package/dist/constructs/v1beta3/schedule/ScheduleSchema.mjs +10 -34
  32. package/dist/index.d.mts +1 -1
  33. package/dist/index.d.ts +1 -1
  34. package/dist/mesheryApi.d.mts +12 -10
  35. package/dist/mesheryApi.d.ts +12 -10
  36. package/dist/permissions.d.mts +141 -1
  37. package/dist/permissions.d.ts +141 -1
  38. package/dist/permissions.js +1 -1
  39. package/dist/permissions.mjs +1 -1
  40. package/package.json +1 -1
@@ -21,7 +21,7 @@ export interface paths {
21
21
  * Register a new connection
22
22
  * @description Register a new connection with credentials. Meshery Cloud reserves the GitHub App connection's identity (name `GitHub App`, sub_type `git`): only its GitHub authorization flow creates that connection, so a request naming it is refused with a `409` MeshKit error that names the reserved GitHub App connection identity.
23
23
  *
24
- * Desktop registration uses this shared operation, but kind `desktop` is implemented by Cloud: a server that does not support it rejects a `desktop` body with `400`. The heartbeat and deregistration routes are Cloud-only. A client desktop app install registers itself on every connect to Cloud, sign-in included, with kind `desktop`, type `platform`, sub_type `management`, status `connected`, and `metadata` matching `DesktopConnectionMetadata`. Servers implementing this contract must take the organization from the `X-Current-Orgid` header, refuse a `desktop` registration without it with `400`, and refuse a caller who is not a live member of that organization with `403`. They must deduplicate on (organization, owner, `metadata.machineId`): registering the same machine again updates that connection and returns `200`, while a new connection returns `201`. A `desktop` body whose metadata lacks `machineId` is refused with `400`. The kind names the connection type, never the product that runs on the machine.
24
+ * Desktop registration uses this shared operation, but kind `desktop` is implemented by Cloud: a server that does not support it rejects a `desktop` body with `400`. The heartbeat and deregistration routes are Cloud-only. A client desktop app install registers itself on every connect to Cloud, sign-in included, with kind `desktop`, type `platform`, sub_type `management`, status `connected`, and `metadata` matching `DesktopConnectionMetadata`. Servers implementing this contract must take the organization from the `X-Current-Orgid` header, refuse a `desktop` registration without it with `400`, and refuse a caller who is not a live member of that organization with `403`. They must deduplicate on (organization, owner, `metadata.installationId`): registering the same install again updates that connection and returns `200`, while a new connection returns `201`. A `desktop` body whose metadata lacks `installationId` is refused with `400`. Installs on one computer share `metadata.computerId`, so a server can group them by computer. The kind names the connection type, never the product that runs on the machine.
25
25
  *
26
26
  * A `desktop` registration whose `metadata.clientName` and `metadata.appVersion` fall below the server's minimum version for that client is refused with `426` and a `ClientUpgradeRequiredError` body; the connection, when it exists, is set to `maintenance`. Servers must link the API token that authenticated the registration to the connection (`metadata.tokenId`, server-written) and revoke that token when the connection is deregistered or deleted. When a later registration of the same connection authenticates with a different token, the server revokes the token previously linked to it. Registrations beyond the organization's device limit are accepted; the organization is flagged through the capabilities document's `session.deviceUsage` instead.
27
27
  */
@@ -140,7 +140,27 @@ export interface paths {
140
140
  patch?: never;
141
141
  trace?: never;
142
142
  };
143
- "/api/integrations/connections/desktop/{machineId}": {
143
+ "/api/integrations/connections/desktop": {
144
+ parameters: {
145
+ query?: never;
146
+ header?: never;
147
+ path?: never;
148
+ cookie?: never;
149
+ };
150
+ /**
151
+ * List the organization's desktop connections
152
+ * @description Returns every live `desktop` connection in the session organization, whoever registered it, as a summary: `id`, `name`, `kind`, `owner`, `status` and `lastSeenAt` only. Any live member of the organization may read it, so members can see which computers share its work; a guest session cannot. Servers must never include the connection's credential, metadata (beyond `lastSeenAt`), URL or description here: the full connection stays readable only by its owner through `getConnections`. `status` follows the heartbeat rule of `recordConnectionHeartbeat` (a desktop connection silent for 3 minutes reads `disconnected`). A caller who is not a live member of the session organization receives `404`.
153
+ */
154
+ get: operations["getDesktopConnectionsOfOrganization"];
155
+ put?: never;
156
+ post?: never;
157
+ delete?: never;
158
+ options?: never;
159
+ head?: never;
160
+ patch?: never;
161
+ trace?: never;
162
+ };
163
+ "/api/integrations/connections/desktop/{installationId}": {
144
164
  parameters: {
145
165
  query?: never;
146
166
  header?: never;
@@ -152,7 +172,7 @@ export interface paths {
152
172
  post?: never;
153
173
  /**
154
174
  * Deregister a desktop app install
155
- * @description Delete the caller's `desktop` connection whose `metadata.machineId` matches, as a desktop app install does on sign-out or uninstall. Servers implementing this contract must scope the deletion to the caller: a connection registered by another user is not found. Servers must revoke the API token linked to each deleted connection (`metadata.tokenId`).
175
+ * @description Delete the caller's `desktop` connection whose `metadata.installationId` matches, as a desktop app install does on sign-out or uninstall. Servers implementing this contract must scope the deletion to the caller: a connection registered by another user is not found. Servers must revoke the API token linked to each deleted connection (`metadata.tokenId`).
156
176
  */
157
177
  delete: operations["deregisterDesktopConnection"];
158
178
  options?: never;
@@ -555,7 +575,7 @@ export interface components {
555
575
  deletedAt?: string | null;
556
576
  /**
557
577
  * Format: uuid
558
- * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.machineId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
578
+ * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.installationId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
559
579
  */
560
580
  organizationId?: string;
561
581
  /** @description Associated environments for this connection */
@@ -922,6 +942,63 @@ export interface components {
922
942
  }[];
923
943
  };
924
944
  };
945
+ /** @description Member-visible summary of a connection. Carries no credential, URL, description or metadata other than `lastSeenAt`. */
946
+ ConnectionSummary: {
947
+ /**
948
+ * Format: uuid
949
+ * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
950
+ */
951
+ id: string;
952
+ /** @description Connection name. */
953
+ name: string;
954
+ /** @description Connection kind, for example `desktop`. */
955
+ kind: string;
956
+ /**
957
+ * Format: uuid
958
+ * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
959
+ */
960
+ owner?: string;
961
+ /** @description Connection status as read, for example `connected` or `disconnected`. */
962
+ status: string;
963
+ /**
964
+ * Format: date-time
965
+ * @description Time of the connection's last heartbeat (`metadata.lastSeenAt`). Null when it never sent one.
966
+ */
967
+ lastSeenAt?: string | null;
968
+ };
969
+ /** @description Page of connection summaries. */
970
+ ConnectionSummaryPage: {
971
+ /** @description Connection summaries on this page. */
972
+ connections: {
973
+ /**
974
+ * Format: uuid
975
+ * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
976
+ */
977
+ id: string;
978
+ /** @description Connection name. */
979
+ name: string;
980
+ /** @description Connection kind, for example `desktop`. */
981
+ kind: string;
982
+ /**
983
+ * Format: uuid
984
+ * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
985
+ */
986
+ owner?: string;
987
+ /** @description Connection status as read, for example `connected` or `disconnected`. */
988
+ status: string;
989
+ /**
990
+ * Format: date-time
991
+ * @description Time of the connection's last heartbeat (`metadata.lastSeenAt`). Null when it never sent one.
992
+ */
993
+ lastSeenAt?: string | null;
994
+ }[];
995
+ /** @description Total number of connections on all pages. */
996
+ totalCount: number;
997
+ /** @description Current page number. */
998
+ page: number;
999
+ /** @description Number of elements per page. */
1000
+ pageSize: number;
1001
+ };
925
1002
  /** @description Represents a page of connections with meta information about connections count */
926
1003
  ConnectionPage: {
927
1004
  /** @description List of connections on this page */
@@ -1199,7 +1276,7 @@ export interface components {
1199
1276
  deletedAt?: string | null;
1200
1277
  /**
1201
1278
  * Format: uuid
1202
- * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.machineId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
1279
+ * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.installationId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
1203
1280
  */
1204
1281
  organizationId?: string;
1205
1282
  /** @description Associated environments for this connection */
@@ -1292,12 +1369,14 @@ export interface components {
1292
1369
  [key: string]: number;
1293
1370
  };
1294
1371
  };
1295
- /** @description Stable identifier of a desktop app install, generated once per install. It is the machine part of the deduplication key and the `machineId` path parameter. */
1296
- DesktopMachineId: string;
1297
- /** @description Metadata of a `desktop` connection: a desktop app install that registered itself on every connect to Cloud. Servers implementing this contract must validate `metadata` against this schema when a registration has kind `desktop`. The deduplication key is (organization, owner, `machineId`). `lastSeenAt` is set by the server on registration and on each heartbeat. Servers must show this metadata in organization listings only to the connection's owner and to organization admins. */
1372
+ /** @description Stable identifier of a desktop app install, generated once per install. It is the install part of the deduplication key and the `installationId` path parameter. */
1373
+ DesktopInstallationId: string;
1374
+ /** @description Metadata of a `desktop` connection: a desktop app install that registered itself on every connect to Cloud. Servers implementing this contract must validate `metadata` against this schema when a registration has kind `desktop`. The deduplication key is (organization, owner, `installationId`). `lastSeenAt` is set by the server on registration and on each heartbeat. Servers must show this metadata in organization listings only to the connection's owner and to organization admins. */
1298
1375
  DesktopConnectionMetadata: {
1299
- /** @description Stable identifier of a desktop app install: generated once on the install's first launch (a UUID is recommended), kept with the app's local state, and never derived from the host name, a process id or a hardware serial. A reinstall that discards local state is a new install. It is the machine part of the deduplication key. */
1300
- machineId: string;
1376
+ /** @description Stable identifier of a desktop app install: generated once on the install's first launch (a UUID is recommended), kept with the app's local state, and never derived from the host name, a process id or a hardware identifier. A reinstall that discards local state is a new install. It is the install part of the deduplication key. */
1377
+ installationId: string;
1378
+ /** @description Stable identifier of the computer the install runs on, shared by every install on that computer whoever signs in: the lowercase hex SHA-256 digest of a fixed, client-defined salt followed by the operating system's hardware identifier (for example the platform UUID on macOS). Clients must send only this digest, never the raw hardware identifier or a serial number. Absent when the client cannot read a hardware identifier. */
1379
+ computerId?: string;
1301
1380
  /** @description Host name of the machine. */
1302
1381
  hostname?: string;
1303
1382
  /** @description Operating system, for example `macos`. */
@@ -1907,8 +1986,8 @@ export interface components {
1907
1986
  search: string;
1908
1987
  /** @description Sort order */
1909
1988
  order: string;
1910
- /** @description Stable per-install machine identifier from `metadata.machineId`. */
1911
- machineId: string;
1989
+ /** @description Installation identifier from `metadata.installationId`. */
1990
+ installationId: string;
1912
1991
  /** @description Organization ID to scope the request. */
1913
1992
  orgIdQuery: string;
1914
1993
  };
@@ -2230,7 +2309,7 @@ export interface operations {
2230
2309
  deletedAt?: string | null;
2231
2310
  /**
2232
2311
  * Format: uuid
2233
- * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.machineId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
2312
+ * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.installationId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
2234
2313
  */
2235
2314
  organizationId?: string;
2236
2315
  /** @description Associated environments for this connection */
@@ -2840,7 +2919,7 @@ export interface operations {
2840
2919
  deletedAt?: string | null;
2841
2920
  /**
2842
2921
  * Format: uuid
2843
- * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.machineId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
2922
+ * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.installationId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
2844
2923
  */
2845
2924
  organizationId?: string;
2846
2925
  /** @description Associated environments for this connection */
@@ -3204,7 +3283,7 @@ export interface operations {
3204
3283
  deletedAt?: string | null;
3205
3284
  /**
3206
3285
  * Format: uuid
3207
- * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.machineId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
3286
+ * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.installationId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
3208
3287
  */
3209
3288
  organizationId?: string;
3210
3289
  /** @description Associated environments for this connection */
@@ -3794,7 +3873,7 @@ export interface operations {
3794
3873
  deletedAt?: string | null;
3795
3874
  /**
3796
3875
  * Format: uuid
3797
- * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.machineId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
3876
+ * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.installationId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
3798
3877
  */
3799
3878
  organizationId?: string;
3800
3879
  /** @description Associated environments for this connection */
@@ -4402,7 +4481,7 @@ export interface operations {
4402
4481
  deletedAt?: string | null;
4403
4482
  /**
4404
4483
  * Format: uuid
4405
- * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.machineId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
4484
+ * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.installationId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
4406
4485
  */
4407
4486
  organizationId?: string;
4408
4487
  /** @description Associated environments for this connection */
@@ -4902,7 +4981,7 @@ export interface operations {
4902
4981
  deletedAt?: string | null;
4903
4982
  /**
4904
4983
  * Format: uuid
4905
- * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.machineId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
4984
+ * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.installationId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
4906
4985
  */
4907
4986
  organizationId?: string;
4908
4987
  /** @description Associated environments for this connection */
@@ -5072,13 +5151,107 @@ export interface operations {
5072
5151
  };
5073
5152
  };
5074
5153
  };
5154
+ getDesktopConnectionsOfOrganization: {
5155
+ parameters: {
5156
+ query?: {
5157
+ /** @description Page number */
5158
+ page?: number;
5159
+ /** @description Number of items per page */
5160
+ pageSize?: number;
5161
+ /** @description Only connections registered by this user. */
5162
+ owner?: string;
5163
+ };
5164
+ header?: never;
5165
+ path?: never;
5166
+ cookie?: never;
5167
+ };
5168
+ requestBody?: never;
5169
+ responses: {
5170
+ /** @description Desktop connections of the organization */
5171
+ 200: {
5172
+ headers: {
5173
+ [name: string]: unknown;
5174
+ };
5175
+ content: {
5176
+ "application/json": {
5177
+ /** @description Connection summaries on this page. */
5178
+ connections: {
5179
+ /**
5180
+ * Format: uuid
5181
+ * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
5182
+ */
5183
+ id: string;
5184
+ /** @description Connection name. */
5185
+ name: string;
5186
+ /** @description Connection kind, for example `desktop`. */
5187
+ kind: string;
5188
+ /**
5189
+ * Format: uuid
5190
+ * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
5191
+ */
5192
+ owner?: string;
5193
+ /** @description Connection status as read, for example `connected` or `disconnected`. */
5194
+ status: string;
5195
+ /**
5196
+ * Format: date-time
5197
+ * @description Time of the connection's last heartbeat (`metadata.lastSeenAt`). Null when it never sent one.
5198
+ */
5199
+ lastSeenAt?: string | null;
5200
+ }[];
5201
+ /** @description Total number of connections on all pages. */
5202
+ totalCount: number;
5203
+ /** @description Current page number. */
5204
+ page: number;
5205
+ /** @description Number of elements per page. */
5206
+ pageSize: number;
5207
+ };
5208
+ };
5209
+ };
5210
+ /** @description Expired JWT token used or insufficient privilege */
5211
+ 401: {
5212
+ headers: {
5213
+ [name: string]: unknown;
5214
+ };
5215
+ content: {
5216
+ "text/plain": string;
5217
+ };
5218
+ };
5219
+ /** @description Forbidden */
5220
+ 403: {
5221
+ headers: {
5222
+ [name: string]: unknown;
5223
+ };
5224
+ content: {
5225
+ "text/plain": string;
5226
+ };
5227
+ };
5228
+ /** @description Result not found */
5229
+ 404: {
5230
+ headers: {
5231
+ [name: string]: unknown;
5232
+ };
5233
+ content: {
5234
+ "text/plain": string;
5235
+ };
5236
+ };
5237
+ /** @description Internal server error */
5238
+ 500: {
5239
+ headers: {
5240
+ [name: string]: unknown;
5241
+ };
5242
+ content: {
5243
+ "text/plain": string;
5244
+ };
5245
+ };
5246
+ };
5247
+ };
5075
5248
  deregisterDesktopConnection: {
5076
5249
  parameters: {
5077
5250
  query?: never;
5078
5251
  header?: never;
5079
5252
  path: {
5080
- /** @description Stable per-install machine identifier from `metadata.machineId`. */
5081
- machineId: string;
5253
+ /** @description Installation identifier from `metadata.installationId`. */
5254
+ installationId: string;
5082
5255
  };
5083
5256
  cookie?: never;
5084
5257
  };
@@ -5412,7 +5585,7 @@ export interface operations {
5412
5585
  deletedAt?: string | null;
5413
5586
  /**
5414
5587
  * Format: uuid
5415
- * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.machineId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
5588
+ * @description Organization the connection is registered in, taken from the `X-Current-Orgid` header on registration. Servers implementing this contract use it, with the owner and `metadata.installationId`, as the deduplication key for `desktop` connections. Lets an organization list and count its connections (for example its registered desktop installs) without going through each owner. Absent on connections that predate it.
5416
5589
  */
5417
5590
  organizationId?: string;
5418
5591
  /** @description Associated environments for this connection */