cyberdesk 2.1.21 → 2.2.1

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

@@ -1,5 +1,5 @@
 import type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';
-import type { HealthCheckV1HealthGetData, DatabaseHealthCheckV1HealthDbGetData, ListMachinesV1MachinesGetData, CreateMachineV1MachinesPostData, DeleteMachineV1MachinesMachineIdDeleteData, GetMachineV1MachinesMachineIdGetData, UpdateMachineV1MachinesMachineIdPatchData, GetMachinePoolsV1MachinesMachineIdPoolsGetData, UpdateMachinePoolsV1MachinesMachineIdPoolsPutData, ListPoolsV1PoolsGetData, CreatePoolV1PoolsPostData, DeletePoolV1PoolsPoolIdDeleteData, GetPoolV1PoolsPoolIdGetData, UpdatePoolV1PoolsPoolIdPatchData, RemoveMachinesFromPoolV1PoolsPoolIdMachinesDeleteData, AddMachinesToPoolV1PoolsPoolIdMachinesPostData, ListWorkflowsV1WorkflowsGetData, CreateWorkflowV1WorkflowsPostData, DeleteWorkflowV1WorkflowsWorkflowIdDeleteData, GetWorkflowV1WorkflowsWorkflowIdGetData, UpdateWorkflowV1WorkflowsWorkflowIdPatchData, GetWorkflowVersionsV1WorkflowsWorkflowIdVersionsGetData, ListRunsV1RunsGetData, CreateRunV1RunsPostData, DeleteRunV1RunsRunIdDeleteData, GetRunV1RunsRunIdGetData, UpdateRunV1RunsRunIdPatchData, CreateRunChainV1RunsChainPostData, BulkCreateRunsV1RunsBulkPostData, RetryRunV1RunsRunIdRetryPostData, ListRunAttachmentsV1RunAttachmentsGetData, CreateRunAttachmentV1RunAttachmentsPostData, DeleteRunAttachmentV1RunAttachmentsAttachmentIdDeleteData, GetRunAttachmentV1RunAttachmentsAttachmentIdGetData, UpdateRunAttachmentV1RunAttachmentsAttachmentIdPutData, GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetData, DownloadRunAttachmentV1RunAttachmentsAttachmentIdDownloadGetData, ListConnectionsV1ConnectionsGetData, CreateConnectionV1ConnectionsPostData, DeleteConnectionV1ConnectionsConnectionIdDeleteData, GetConnectionV1ConnectionsConnectionIdGetData, UpdateConnectionV1ConnectionsConnectionIdPatchData, ListRequestLogsV1RequestLogsGetData, CreateRequestLogV1RequestLogsPostData, DeleteRequestLogV1RequestLogsLogIdDeleteData, GetRequestLogV1RequestLogsLogIdGetData, UpdateRequestLogV1RequestLogsLogIdPatchData, ListTrajectoriesV1TrajectoriesGetData, CreateTrajectoryV1TrajectoriesPostData, DeleteTrajectoryV1TrajectoriesTrajectoryIdDeleteData, GetTrajectoryV1TrajectoriesTrajectoryIdGetData, UpdateTrajectoryV1TrajectoriesTrajectoryIdPatchData, GetLatestTrajectoryForWorkflowV1WorkflowsWorkflowIdLatestTrajectoryGetData, GetScreenshotV1ComputerMachineIdDisplayScreenshotGetData, GetDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGetData, KeyboardTypeV1ComputerMachineIdInputKeyboardTypePostData, KeyboardKeyV1ComputerMachineIdInputKeyboardKeyPostData, CopyToClipboardV1ComputerMachineIdCopyToClipboardPostData, GetMousePositionV1ComputerMachineIdInputMousePositionGetData, MouseMoveV1ComputerMachineIdInputMouseMovePostData, MouseClickV1ComputerMachineIdInputMouseClickPostData, MouseScrollV1ComputerMachineIdInputMouseScrollPostData, MouseDragV1ComputerMachineIdInputMouseDragPostData, FsListV1ComputerMachineIdFsListGetData, FsReadV1ComputerMachineIdFsReadGetData, FsWriteV1ComputerMachineIdFsWritePostData, PowershellExecV1ComputerMachineIdShellPowershellExecPostData, PowershellSessionV1ComputerMachineIdShellPowershellSessionPostData, DummyTestEndpointV1TestPostData, RootGetData, HealthHealthGetData, HealthDbHealthDbGetData } from './types.gen';
+import type { HealthCheckV1HealthGetData, DatabaseHealthCheckV1HealthDbGetData, ListMachinesV1MachinesGetData, CreateMachineV1MachinesPostData, DeleteMachineV1MachinesMachineIdDeleteData, GetMachineV1MachinesMachineIdGetData, UpdateMachineV1MachinesMachineIdPatchData, GetMachinePoolsV1MachinesMachineIdPoolsGetData, UpdateMachinePoolsV1MachinesMachineIdPoolsPutData, ListPoolsV1PoolsGetData, CreatePoolV1PoolsPostData, DeletePoolV1PoolsPoolIdDeleteData, GetPoolV1PoolsPoolIdGetData, UpdatePoolV1PoolsPoolIdPatchData, RemoveMachinesFromPoolV1PoolsPoolIdMachinesDeleteData, AddMachinesToPoolV1PoolsPoolIdMachinesPostData, ListWorkflowsV1WorkflowsGetData, CreateWorkflowV1WorkflowsPostData, DeleteWorkflowV1WorkflowsWorkflowIdDeleteData, GetWorkflowV1WorkflowsWorkflowIdGetData, UpdateWorkflowV1WorkflowsWorkflowIdPatchData, GetWorkflowVersionsV1WorkflowsWorkflowIdVersionsGetData, ListRunsV1RunsGetData, CreateRunV1RunsPostData, DeleteRunV1RunsRunIdDeleteData, GetRunV1RunsRunIdGetData, UpdateRunV1RunsRunIdPatchData, CreateRunChainV1RunsChainPostData, BulkCreateRunsV1RunsBulkPostData, RetryRunV1RunsRunIdRetryPostData, ListRunAttachmentsV1RunAttachmentsGetData, CreateRunAttachmentV1RunAttachmentsPostData, DeleteRunAttachmentV1RunAttachmentsAttachmentIdDeleteData, GetRunAttachmentV1RunAttachmentsAttachmentIdGetData, UpdateRunAttachmentV1RunAttachmentsAttachmentIdPutData, GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetData, DownloadRunAttachmentV1RunAttachmentsAttachmentIdDownloadGetData, ListConnectionsV1ConnectionsGetData, CreateConnectionV1ConnectionsPostData, DeleteConnectionV1ConnectionsConnectionIdDeleteData, GetConnectionV1ConnectionsConnectionIdGetData, UpdateConnectionV1ConnectionsConnectionIdPatchData, ListRequestLogsV1RequestLogsGetData, CreateRequestLogV1RequestLogsPostData, DeleteRequestLogV1RequestLogsLogIdDeleteData, GetRequestLogV1RequestLogsLogIdGetData, UpdateRequestLogV1RequestLogsLogIdPatchData, ListTrajectoriesV1TrajectoriesGetData, CreateTrajectoryV1TrajectoriesPostData, DeleteTrajectoryV1TrajectoriesTrajectoryIdDeleteData, GetTrajectoryV1TrajectoriesTrajectoryIdGetData, UpdateTrajectoryV1TrajectoriesTrajectoryIdPatchData, GetLatestTrajectoryForWorkflowV1WorkflowsWorkflowIdLatestTrajectoryGetData, GetScreenshotV1ComputerMachineIdDisplayScreenshotGetData, GetDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGetData, KeyboardTypeV1ComputerMachineIdInputKeyboardTypePostData, KeyboardKeyV1ComputerMachineIdInputKeyboardKeyPostData, CopyToClipboardV1ComputerMachineIdCopyToClipboardPostData, GetMousePositionV1ComputerMachineIdInputMousePositionGetData, MouseMoveV1ComputerMachineIdInputMouseMovePostData, MouseClickV1ComputerMachineIdInputMouseClickPostData, MouseScrollV1ComputerMachineIdInputMouseScrollPostData, MouseDragV1ComputerMachineIdInputMouseDragPostData, FsListV1ComputerMachineIdFsListGetData, FsReadV1ComputerMachineIdFsReadGetData, FsWriteV1ComputerMachineIdFsWritePostData, PowershellExecV1ComputerMachineIdShellPowershellExecPostData, PowershellSessionV1ComputerMachineIdShellPowershellSessionPostData, DummyTestEndpointV1TestPostData, DbPingInternalDebugDbPingGetData, RootGetData, HealthHealthGetData, HealthDbHealthDbGetData } from './types.gen';
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -433,7 +433,7 @@ export declare const getDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGet
 export declare const keyboardTypeV1ComputerMachineIdInputKeyboardTypePost: <ThrowOnError extends boolean = false>(options: Options<KeyboardTypeV1ComputerMachineIdInputKeyboardTypePostData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<void, import("./types.gen").HttpValidationError, ThrowOnError>;
 /**
  * Send key combination
- * Send a key combination (e.g., 'ctrl+a', 'alt+tab'). Uses 'keys' field to match Piglet expectations.
+ * Send a key combination (e.g., 'ctrl+a', 'alt+tab').
  */
 export declare const keyboardKeyV1ComputerMachineIdInputKeyboardKeyPost: <ThrowOnError extends boolean = false>(options: Options<KeyboardKeyV1ComputerMachineIdInputKeyboardKeyPostData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<void, import("./types.gen").HttpValidationError, ThrowOnError>;
 /**
@@ -517,6 +517,13 @@ export declare const powershellSessionV1ComputerMachineIdShellPowershellSessionP
 export declare const dummyTestEndpointV1TestPost: <ThrowOnError extends boolean = false>(options?: Options<DummyTestEndpointV1TestPostData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<{
     [key: string]: unknown;
 }, unknown, ThrowOnError>;
+/**
+ * Db Ping
+ * Execute a lightweight `SELECT 1` to validate DB connectivity and expose pool stats.
+ *
+ * Returns JSON payload with `ok` boolean, pool metrics, and optional error metadata.
+ */
+export declare const dbPingInternalDebugDbPingGet: <ThrowOnError extends boolean = false>(options?: Options<DbPingInternalDebugDbPingGetData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<unknown, unknown, ThrowOnError>;
 /**
  * Root
  * Root endpoint with service information

package/dist/client/sdk.gen.js

@@ -2,7 +2,7 @@
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deleteTrajectoryV1TrajectoriesTrajectoryIdDelete = exports.createTrajectoryV1TrajectoriesPost = exports.listTrajectoriesV1TrajectoriesGet = exports.updateRequestLogV1RequestLogsLogIdPatch = exports.getRequestLogV1RequestLogsLogIdGet = exports.deleteRequestLogV1RequestLogsLogIdDelete = exports.createRequestLogV1RequestLogsPost = exports.listRequestLogsV1RequestLogsGet = exports.updateConnectionV1ConnectionsConnectionIdPatch = exports.getConnectionV1ConnectionsConnectionIdGet = exports.deleteConnectionV1ConnectionsConnectionIdDelete = exports.createConnectionV1ConnectionsPost = exports.listConnectionsV1ConnectionsGet = exports.downloadRunAttachmentV1RunAttachmentsAttachmentIdDownloadGet = exports.getRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGet = exports.updateRunAttachmentV1RunAttachmentsAttachmentIdPut = exports.getRunAttachmentV1RunAttachmentsAttachmentIdGet = exports.deleteRunAttachmentV1RunAttachmentsAttachmentIdDelete = exports.createRunAttachmentV1RunAttachmentsPost = exports.listRunAttachmentsV1RunAttachmentsGet = exports.retryRunV1RunsRunIdRetryPost = exports.bulkCreateRunsV1RunsBulkPost = exports.createRunChainV1RunsChainPost = exports.updateRunV1RunsRunIdPatch = exports.getRunV1RunsRunIdGet = exports.deleteRunV1RunsRunIdDelete = exports.createRunV1RunsPost = exports.listRunsV1RunsGet = exports.getWorkflowVersionsV1WorkflowsWorkflowIdVersionsGet = exports.updateWorkflowV1WorkflowsWorkflowIdPatch = exports.getWorkflowV1WorkflowsWorkflowIdGet = exports.deleteWorkflowV1WorkflowsWorkflowIdDelete = exports.createWorkflowV1WorkflowsPost = exports.listWorkflowsV1WorkflowsGet = exports.addMachinesToPoolV1PoolsPoolIdMachinesPost = exports.removeMachinesFromPoolV1PoolsPoolIdMachinesDelete = exports.updatePoolV1PoolsPoolIdPatch = exports.getPoolV1PoolsPoolIdGet = exports.deletePoolV1PoolsPoolIdDelete = exports.createPoolV1PoolsPost = exports.listPoolsV1PoolsGet = exports.updateMachinePoolsV1MachinesMachineIdPoolsPut = exports.getMachinePoolsV1MachinesMachineIdPoolsGet = exports.updateMachineV1MachinesMachineIdPatch = exports.getMachineV1MachinesMachineIdGet = exports.deleteMachineV1MachinesMachineIdDelete = exports.createMachineV1MachinesPost = exports.listMachinesV1MachinesGet = exports.databaseHealthCheckV1HealthDbGet = exports.healthCheckV1HealthGet = void 0;
-exports.healthDbHealthDbGet = exports.healthHealthGet = exports.rootGet = exports.dummyTestEndpointV1TestPost = exports.powershellSessionV1ComputerMachineIdShellPowershellSessionPost = exports.powershellExecV1ComputerMachineIdShellPowershellExecPost = exports.fsWriteV1ComputerMachineIdFsWritePost = exports.fsReadV1ComputerMachineIdFsReadGet = exports.fsListV1ComputerMachineIdFsListGet = exports.mouseDragV1ComputerMachineIdInputMouseDragPost = exports.mouseScrollV1ComputerMachineIdInputMouseScrollPost = exports.mouseClickV1ComputerMachineIdInputMouseClickPost = exports.mouseMoveV1ComputerMachineIdInputMouseMovePost = exports.getMousePositionV1ComputerMachineIdInputMousePositionGet = exports.copyToClipboardV1ComputerMachineIdCopyToClipboardPost = exports.keyboardKeyV1ComputerMachineIdInputKeyboardKeyPost = exports.keyboardTypeV1ComputerMachineIdInputKeyboardTypePost = exports.getDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGet = exports.getScreenshotV1ComputerMachineIdDisplayScreenshotGet = exports.getLatestTrajectoryForWorkflowV1WorkflowsWorkflowIdLatestTrajectoryGet = exports.updateTrajectoryV1TrajectoriesTrajectoryIdPatch = exports.getTrajectoryV1TrajectoriesTrajectoryIdGet = void 0;
+exports.healthDbHealthDbGet = exports.healthHealthGet = exports.rootGet = exports.dbPingInternalDebugDbPingGet = exports.dummyTestEndpointV1TestPost = exports.powershellSessionV1ComputerMachineIdShellPowershellSessionPost = exports.powershellExecV1ComputerMachineIdShellPowershellExecPost = exports.fsWriteV1ComputerMachineIdFsWritePost = exports.fsReadV1ComputerMachineIdFsReadGet = exports.fsListV1ComputerMachineIdFsListGet = exports.mouseDragV1ComputerMachineIdInputMouseDragPost = exports.mouseScrollV1ComputerMachineIdInputMouseScrollPost = exports.mouseClickV1ComputerMachineIdInputMouseClickPost = exports.mouseMoveV1ComputerMachineIdInputMouseMovePost = exports.getMousePositionV1ComputerMachineIdInputMousePositionGet = exports.copyToClipboardV1ComputerMachineIdCopyToClipboardPost = exports.keyboardKeyV1ComputerMachineIdInputKeyboardKeyPost = exports.keyboardTypeV1ComputerMachineIdInputKeyboardTypePost = exports.getDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGet = exports.getScreenshotV1ComputerMachineIdDisplayScreenshotGet = exports.getLatestTrajectoryForWorkflowV1WorkflowsWorkflowIdLatestTrajectoryGet = exports.updateTrajectoryV1TrajectoriesTrajectoryIdPatch = exports.getTrajectoryV1TrajectoriesTrajectoryIdGet = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * Health Check
@@ -914,7 +914,7 @@ const keyboardTypeV1ComputerMachineIdInputKeyboardTypePost = (options) => {
 exports.keyboardTypeV1ComputerMachineIdInputKeyboardTypePost = keyboardTypeV1ComputerMachineIdInputKeyboardTypePost;
 /**
  * Send key combination
- * Send a key combination (e.g., 'ctrl+a', 'alt+tab'). Uses 'keys' field to match Piglet expectations.
+ * Send a key combination (e.g., 'ctrl+a', 'alt+tab').
  */
 const keyboardKeyV1ComputerMachineIdInputKeyboardKeyPost = (options) => {
     var _a;
@@ -1101,6 +1101,17 @@ const dummyTestEndpointV1TestPost = (options) => {
         ], url: '/v1/test' }, options));
 };
 exports.dummyTestEndpointV1TestPost = dummyTestEndpointV1TestPost;
+/**
+ * Db Ping
+ * Execute a lightweight `SELECT 1` to validate DB connectivity and expose pool stats.
+ *
+ * Returns JSON payload with `ok` boolean, pool metrics, and optional error metadata.
+ */
+const dbPingInternalDebugDbPingGet = (options) => {
+    var _a;
+    return ((_a = options === null || options === void 0 ? void 0 : options.client) !== null && _a !== void 0 ? _a : client_gen_1.client).get(Object.assign({ url: '/internal/debug/db-ping' }, options));
+};
+exports.dbPingInternalDebugDbPingGet = dbPingInternalDebugDbPingGet;
 /**
  * Root
  * Root endpoint with service information

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;
@@ -592,7 +596,7 @@ export type RunCreate = {
  * These are optional fields beyond the essential identifiers that are always returned
  * (id, workflow_id, machine_id, status, created_at).
  */
-export type RunField = 'user_id' | 'organization_id' | 'error' | 'output_data' | 'input_attachment_ids' | 'output_attachment_ids' | 'run_message_history' | 'input_values' | 'pool_ids' | 'sensitive_input_aliases' | 'session_id' | 'session_alias' | 'release_session_after' | 'started_at' | 'ended_at' | 'machine_id';
+export type RunField = 'user_id' | 'organization_id' | 'error' | 'output_data' | 'input_attachment_ids' | 'output_attachment_ids' | 'run_message_history' | 'input_values' | 'pool_ids' | 'sensitive_input_aliases' | 'usage_metadata' | 'session_id' | 'session_alias' | 'release_session_after' | 'started_at' | 'ended_at' | 'machine_id';
 /**
  * Run response schema
  */
@@ -619,6 +623,12 @@ export type RunResponse = {
     sensitive_input_aliases?: {
         [key: string]: string;
     } | null;
+    /**
+     * Arbitrary usage/billing metadata captured during a run (schema is flexible)
+     */
+    usage_metadata?: {
+        [key: string]: unknown;
+    } | null;
     session_id?: string | null;
     session_alias?: string | null;
     release_session_after?: boolean | null;
@@ -689,8 +699,18 @@ export type RunUpdate = {
     input_values?: {
         [key: string]: unknown;
     } | null;
+    /**
+     * Arbitrary usage/billing metadata captured during a run (schema is flexible)
+     */
+    usage_metadata?: {
+        [key: string]: unknown;
+    } | null;
     started_at?: string | null;
     ended_at?: string | null;
+    /**
+     * Set to True to indicate this run released the session
+     */
+    release_session_after?: boolean | null;
 };
 /**
  * Schema for creating a trajectory
@@ -2477,6 +2497,18 @@ export type DummyTestEndpointV1TestPostResponses = {
     };
 };
 export type DummyTestEndpointV1TestPostResponse = DummyTestEndpointV1TestPostResponses[keyof DummyTestEndpointV1TestPostResponses];
+export type DbPingInternalDebugDbPingGetData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/internal/debug/db-ping';
+};
+export type DbPingInternalDebugDbPingGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: unknown;
+};
 export type RootGetData = {
     body?: never;
     path?: never;

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.
          */
@@ -490,7 +494,7 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
          * @param params.machine_id - Filter by machine ID
          * @param params.session_id - Filter by session ID
          * @param params.fields - Optional list of fields to include per run (projection). Available fields include:
-         *                        started_at, ended_at, error, output_data, input_values, and more.
+         *                        started_at, ended_at, error, output_data, input_values, usage_metadata, and more.
          * @returns Paginated list of runs including timing fields:
          *          - created_at: When run was created
          *          - started_at: When run execution started (null for SCHEDULING runs)
@@ -649,7 +653,7 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
          * Update a run
          *
          * @param runId - The ID of the run to update
-         * @param data - Update data (status, output_data, error messages, etc.)
+         * @param data - Update data (status, output_data, error messages, usage_metadata, etc.)
          * @returns Updated run details
          */
         update: (runId: string, data: RunUpdate) => Promise<({

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.
              */
@@ -480,7 +484,7 @@ function createCyberdeskClient(apiKey, baseUrl) {
              * @param params.machine_id - Filter by machine ID
              * @param params.session_id - Filter by session ID
              * @param params.fields - Optional list of fields to include per run (projection). Available fields include:
-             *                        started_at, ended_at, error, output_data, input_values, and more.
+             *                        started_at, ended_at, error, output_data, input_values, usage_metadata, and more.
              * @returns Paginated list of runs including timing fields:
              *          - created_at: When run was created
              *          - started_at: When run execution started (null for SCHEDULING runs)
@@ -618,7 +622,7 @@ function createCyberdeskClient(apiKey, baseUrl) {
              * Update a run
              *
              * @param runId - The ID of the run to update
-             * @param data - Update data (status, output_data, error messages, etc.)
+             * @param data - Update data (status, output_data, error messages, usage_metadata, etc.)
              * @returns Updated run details
              */
             update: (runId, data) => __awaiter(this, void 0, void 0, function* () {

package/package.json

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