cyberdesk 2.1.21 → 2.2.0

package/dist/client/types.gen.d.ts

@@ -166,6 +166,10 @@ export type MachineResponse = {
     is_available: boolean;
     reserved_session_id?: string | null;
     linked_keepalive_machine_id?: string | null;
+    /**
+     * Fly machine ID hosting the WebSocket connection
+     */
+    physical_server_id?: string | null;
     created_at: string;
     last_seen: string;
     pools?: Array<PoolResponse> | null;

package/dist/index.d.ts

@@ -52,7 +52,8 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
          * @param params.limit - Maximum number of items to return
          * @param params.status - Filter by machine status
          * @returns Paginated list of machines. Each machine includes desktop parameters
-         *          (machine_parameters, machine_sensitive_parameters) if configured.
+         *          (machine_parameters, machine_sensitive_parameters) if configured,
+         *          plus the current physical_server_id when connected to WebSockets.
          */
         list: (params?: {
             skip?: number;
@@ -100,6 +101,7 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
          *          - Basic info: id, name, status, fingerprint, etc.
          *          - machine_parameters: Dict of desktop parameters (if configured)
          *          - machine_sensitive_parameters: Dict of sensitive parameter aliases (if configured)
+         *          - physical_server_id: Fly machine ID currently hosting the WebSocket connection
          *          - pools: List of pools this machine belongs to
          */
         get: (machineId: string) => Promise<({
@@ -148,6 +150,8 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
          * @remarks
          * - linked_keepalive_machine_id is not writable; it is managed by
          *   Cyberdriver link events and will be set/cleared automatically.
+         * - physical_server_id is read-only; it is set automatically when the machine
+         *   connects to a WebSocket server and cleared on disconnect.
          * - For machine_sensitive_parameters, provide actual secret values.
          *   They will be stored securely in Basis Theory and only aliases stored in DB.
          */

package/dist/index.js

@@ -111,7 +111,8 @@ function createCyberdeskClient(apiKey, baseUrl) {
              * @param params.limit - Maximum number of items to return
              * @param params.status - Filter by machine status
              * @returns Paginated list of machines. Each machine includes desktop parameters
-             *          (machine_parameters, machine_sensitive_parameters) if configured.
+             *          (machine_parameters, machine_sensitive_parameters) if configured,
+             *          plus the current physical_server_id when connected to WebSockets.
              */
             list: (params) => __awaiter(this, void 0, void 0, function* () {
                 const query = {
@@ -149,6 +150,7 @@ function createCyberdeskClient(apiKey, baseUrl) {
              *          - Basic info: id, name, status, fingerprint, etc.
              *          - machine_parameters: Dict of desktop parameters (if configured)
              *          - machine_sensitive_parameters: Dict of sensitive parameter aliases (if configured)
+             *          - physical_server_id: Fly machine ID currently hosting the WebSocket connection
              *          - pools: List of pools this machine belongs to
              */
             get: (machineId) => __awaiter(this, void 0, void 0, function* () {
@@ -193,6 +195,8 @@ function createCyberdeskClient(apiKey, baseUrl) {
              * @remarks
              * - linked_keepalive_machine_id is not writable; it is managed by
              *   Cyberdriver link events and will be set/cleared automatically.
+             * - physical_server_id is read-only; it is set automatically when the machine
+             *   connects to a WebSocket server and cleared on disconnect.
              * - For machine_sensitive_parameters, provide actual secret values.
              *   They will be stored securely in Basis Theory and only aliases stored in DB.
              */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cyberdesk",
-  "version": "2.1.21",
+  "version": "2.2.0",
   "description": "The official TypeScript SDK for Cyberdesk",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",