cyberdesk 2.2.6 → 2.2.8

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, DbPingInternalDebugDbPingGetData, 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, HealthLiveHealthLiveGetData, HealthReadyHealthReadyGetData, 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
@@ -529,13 +529,28 @@ export declare const dbPingInternalDebugDbPingGet: <ThrowOnError extends boolean
  * Root endpoint with service information
  */
 export declare const rootGet: <ThrowOnError extends boolean = false>(options?: Options<RootGetData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<unknown, unknown, ThrowOnError>;
+/**
+ * Health Live
+ * Liveness probe - Is the process alive?
+ * Always returns 200 if the server can respond.
+ * Use this for: Kubernetes liveness probes, basic "is it up" checks.
+ */
+export declare const healthLiveHealthLiveGet: <ThrowOnError extends boolean = false>(options?: Options<HealthLiveHealthLiveGetData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<unknown, unknown, ThrowOnError>;
+/**
+ * Health Ready
+ * Readiness probe - Can the service handle requests?
+ * Checks all critical dependencies with timeouts.
+ * Use this for: Load balancer health checks, Better Stack monitoring.
+ * Returns 503 if any critical dependency is down.
+ */
+export declare const healthReadyHealthReadyGet: <ThrowOnError extends boolean = false>(options?: Options<HealthReadyHealthReadyGetData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<unknown, unknown, ThrowOnError>;
 /**
  * Health
+ * Backward compatible health check - redirects to readiness check.
  */
-export declare const healthHealthGet: <ThrowOnError extends boolean = false>(options?: Options<HealthHealthGetData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<{
-    [key: string]: unknown;
-}, unknown, ThrowOnError>;
+export declare const healthHealthGet: <ThrowOnError extends boolean = false>(options?: Options<HealthHealthGetData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<unknown, unknown, ThrowOnError>;
 /**
  * Health Db
+ * Legacy endpoint - checks database only.
  */
 export declare const healthDbHealthDbGet: <ThrowOnError extends boolean = false>(options?: Options<HealthDbHealthDbGetData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<unknown, unknown, ThrowOnError>;

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.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;
+exports.healthDbHealthDbGet = exports.healthHealthGet = exports.healthReadyHealthReadyGet = exports.healthLiveHealthLiveGet = 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
@@ -1121,8 +1121,32 @@ const rootGet = (options) => {
     return ((_a = options === null || options === void 0 ? void 0 : options.client) !== null && _a !== void 0 ? _a : client_gen_1.client).get(Object.assign({ url: '/' }, options));
 };
 exports.rootGet = rootGet;
+/**
+ * Health Live
+ * Liveness probe - Is the process alive?
+ * Always returns 200 if the server can respond.
+ * Use this for: Kubernetes liveness probes, basic "is it up" checks.
+ */
+const healthLiveHealthLiveGet = (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: '/health/live' }, options));
+};
+exports.healthLiveHealthLiveGet = healthLiveHealthLiveGet;
+/**
+ * Health Ready
+ * Readiness probe - Can the service handle requests?
+ * Checks all critical dependencies with timeouts.
+ * Use this for: Load balancer health checks, Better Stack monitoring.
+ * Returns 503 if any critical dependency is down.
+ */
+const healthReadyHealthReadyGet = (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: '/health/ready' }, options));
+};
+exports.healthReadyHealthReadyGet = healthReadyHealthReadyGet;
 /**
  * Health
+ * Backward compatible health check - redirects to readiness check.
  */
 const healthHealthGet = (options) => {
     var _a;
@@ -1131,6 +1155,7 @@ const healthHealthGet = (options) => {
 exports.healthHealthGet = healthHealthGet;
 /**
  * Health Db
+ * Legacy endpoint - checks database only.
  */
 const healthDbHealthDbGet = (options) => {
     var _a;

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

@@ -9,10 +9,10 @@ export type ChainStep = {
      */
     session_alias?: string | null;
     /**
-     * Step-specific inputs; values must be string or {$ref: 'alias.outputs.path'}
+     * Step-specific inputs; values can be strings, objects, arrays, or {$ref: 'alias.outputs.path'} references
      */
     inputs?: {
-        [key: string]: string | RefValue;
+        [key: string]: unknown;
     } | null;
     /**
      * Step-specific sensitive inputs (supports nested objects) that override or extend shared_sensitive_inputs
@@ -187,7 +187,7 @@ export type MachineUpdate = {
     is_available?: boolean | null;
     last_seen?: string | null;
     /**
-     * Set to null to clear reservation; server will cancel queued/running session runs and clear
+     * Set to null to clear reservation; server will cancel any scheduling/running run on this machine, clear reservation, mark machine available, and trigger matching
      */
     reserved_session_id?: string | null;
     /**
@@ -371,13 +371,6 @@ export type PowerShellSessionRequest = {
      */
     session_id?: string | null;
 };
-/**
- * Reference to a prior step's output within the same session.
- * The wire shape is {"$ref": "alias.outputs.path"}.
- */
-export type RefValue = {
-    $ref: string;
-};
 /**
  * Schema for creating a request log
  */
@@ -941,6 +934,12 @@ export type ListMachinesV1MachinesGetResponses = {
 export type ListMachinesV1MachinesGetResponse = ListMachinesV1MachinesGetResponses[keyof ListMachinesV1MachinesGetResponses];
 export type CreateMachineV1MachinesPostData = {
     body: MachineCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/machines';
@@ -961,6 +960,12 @@ export type CreateMachineV1MachinesPostResponses = {
 export type CreateMachineV1MachinesPostResponse = CreateMachineV1MachinesPostResponses[keyof CreateMachineV1MachinesPostResponses];
 export type DeleteMachineV1MachinesMachineIdDeleteData = {
     body?: never;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -1005,6 +1010,12 @@ export type GetMachineV1MachinesMachineIdGetResponses = {
 export type GetMachineV1MachinesMachineIdGetResponse = GetMachineV1MachinesMachineIdGetResponses[keyof GetMachineV1MachinesMachineIdGetResponses];
 export type UpdateMachineV1MachinesMachineIdPatchData = {
     body: MachineUpdate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -1049,6 +1060,12 @@ export type GetMachinePoolsV1MachinesMachineIdPoolsGetResponses = {
 export type GetMachinePoolsV1MachinesMachineIdPoolsGetResponse = GetMachinePoolsV1MachinesMachineIdPoolsGetResponses[keyof GetMachinePoolsV1MachinesMachineIdPoolsGetResponses];
 export type UpdateMachinePoolsV1MachinesMachineIdPoolsPutData = {
     body: MachinePoolUpdate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -1094,6 +1111,12 @@ export type ListPoolsV1PoolsGetResponses = {
 export type ListPoolsV1PoolsGetResponse = ListPoolsV1PoolsGetResponses[keyof ListPoolsV1PoolsGetResponses];
 export type CreatePoolV1PoolsPostData = {
     body: PoolCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/pools';
@@ -1114,6 +1137,12 @@ export type CreatePoolV1PoolsPostResponses = {
 export type CreatePoolV1PoolsPostResponse = CreatePoolV1PoolsPostResponses[keyof CreatePoolV1PoolsPostResponses];
 export type DeletePoolV1PoolsPoolIdDeleteData = {
     body?: never;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         pool_id: string;
     };
@@ -1163,6 +1192,12 @@ export type GetPoolV1PoolsPoolIdGetResponses = {
 export type GetPoolV1PoolsPoolIdGetResponse = GetPoolV1PoolsPoolIdGetResponses[keyof GetPoolV1PoolsPoolIdGetResponses];
 export type UpdatePoolV1PoolsPoolIdPatchData = {
     body: PoolUpdate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         pool_id: string;
     };
@@ -1185,6 +1220,12 @@ export type UpdatePoolV1PoolsPoolIdPatchResponses = {
 export type UpdatePoolV1PoolsPoolIdPatchResponse = UpdatePoolV1PoolsPoolIdPatchResponses[keyof UpdatePoolV1PoolsPoolIdPatchResponses];
 export type RemoveMachinesFromPoolV1PoolsPoolIdMachinesDeleteData = {
     body: MachinePoolAssignment;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         pool_id: string;
     };
@@ -1207,6 +1248,12 @@ export type RemoveMachinesFromPoolV1PoolsPoolIdMachinesDeleteResponses = {
 export type RemoveMachinesFromPoolV1PoolsPoolIdMachinesDeleteResponse = RemoveMachinesFromPoolV1PoolsPoolIdMachinesDeleteResponses[keyof RemoveMachinesFromPoolV1PoolsPoolIdMachinesDeleteResponses];
 export type AddMachinesToPoolV1PoolsPoolIdMachinesPostData = {
     body: MachinePoolAssignment;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         pool_id: string;
     };
@@ -1268,6 +1315,12 @@ export type ListWorkflowsV1WorkflowsGetResponses = {
 export type ListWorkflowsV1WorkflowsGetResponse = ListWorkflowsV1WorkflowsGetResponses[keyof ListWorkflowsV1WorkflowsGetResponses];
 export type CreateWorkflowV1WorkflowsPostData = {
     body: WorkflowCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/workflows';
@@ -1288,6 +1341,12 @@ export type CreateWorkflowV1WorkflowsPostResponses = {
 export type CreateWorkflowV1WorkflowsPostResponse = CreateWorkflowV1WorkflowsPostResponses[keyof CreateWorkflowV1WorkflowsPostResponses];
 export type DeleteWorkflowV1WorkflowsWorkflowIdDeleteData = {
     body?: never;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         workflow_id: string;
     };
@@ -1332,6 +1391,12 @@ export type GetWorkflowV1WorkflowsWorkflowIdGetResponses = {
 export type GetWorkflowV1WorkflowsWorkflowIdGetResponse = GetWorkflowV1WorkflowsWorkflowIdGetResponses[keyof GetWorkflowV1WorkflowsWorkflowIdGetResponses];
 export type UpdateWorkflowV1WorkflowsWorkflowIdPatchData = {
     body: WorkflowUpdate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         workflow_id: string;
     };
@@ -1429,6 +1494,12 @@ export type ListRunsV1RunsGetResponses = {
 export type ListRunsV1RunsGetResponse = ListRunsV1RunsGetResponses[keyof ListRunsV1RunsGetResponses];
 export type CreateRunV1RunsPostData = {
     body: RunCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/runs';
@@ -1449,6 +1520,12 @@ export type CreateRunV1RunsPostResponses = {
 export type CreateRunV1RunsPostResponse = CreateRunV1RunsPostResponses[keyof CreateRunV1RunsPostResponses];
 export type DeleteRunV1RunsRunIdDeleteData = {
     body?: never;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         run_id: string;
     };
@@ -1493,6 +1570,12 @@ export type GetRunV1RunsRunIdGetResponses = {
 export type GetRunV1RunsRunIdGetResponse = GetRunV1RunsRunIdGetResponses[keyof GetRunV1RunsRunIdGetResponses];
 export type UpdateRunV1RunsRunIdPatchData = {
     body: RunUpdate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         run_id: string;
     };
@@ -1515,6 +1598,12 @@ export type UpdateRunV1RunsRunIdPatchResponses = {
 export type UpdateRunV1RunsRunIdPatchResponse = UpdateRunV1RunsRunIdPatchResponses[keyof UpdateRunV1RunsRunIdPatchResponses];
 export type CreateRunChainV1RunsChainPostData = {
     body: WorkflowChainCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/runs/chain';
@@ -1535,6 +1624,12 @@ export type CreateRunChainV1RunsChainPostResponses = {
 export type CreateRunChainV1RunsChainPostResponse = CreateRunChainV1RunsChainPostResponses[keyof CreateRunChainV1RunsChainPostResponses];
 export type BulkCreateRunsV1RunsBulkPostData = {
     body: RunBulkCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/runs/bulk';
@@ -1555,6 +1650,12 @@ export type BulkCreateRunsV1RunsBulkPostResponses = {
 export type BulkCreateRunsV1RunsBulkPostResponse = BulkCreateRunsV1RunsBulkPostResponses[keyof BulkCreateRunsV1RunsBulkPostResponses];
 export type RetryRunV1RunsRunIdRetryPostData = {
     body: RunRetry;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         run_id: string;
     };
@@ -1608,6 +1709,12 @@ export type ListRunAttachmentsV1RunAttachmentsGetResponses = {
 export type ListRunAttachmentsV1RunAttachmentsGetResponse = ListRunAttachmentsV1RunAttachmentsGetResponses[keyof ListRunAttachmentsV1RunAttachmentsGetResponses];
 export type CreateRunAttachmentV1RunAttachmentsPostData = {
     body: RunAttachmentCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/run-attachments';
@@ -1628,6 +1735,12 @@ export type CreateRunAttachmentV1RunAttachmentsPostResponses = {
 export type CreateRunAttachmentV1RunAttachmentsPostResponse = CreateRunAttachmentV1RunAttachmentsPostResponses[keyof CreateRunAttachmentV1RunAttachmentsPostResponses];
 export type DeleteRunAttachmentV1RunAttachmentsAttachmentIdDeleteData = {
     body?: never;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         attachment_id: string;
     };
@@ -1672,6 +1785,12 @@ export type GetRunAttachmentV1RunAttachmentsAttachmentIdGetResponses = {
 export type GetRunAttachmentV1RunAttachmentsAttachmentIdGetResponse = GetRunAttachmentV1RunAttachmentsAttachmentIdGetResponses[keyof GetRunAttachmentV1RunAttachmentsAttachmentIdGetResponses];
 export type UpdateRunAttachmentV1RunAttachmentsAttachmentIdPutData = {
     body: RunAttachmentUpdate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         attachment_id: string;
     };
@@ -1774,6 +1893,12 @@ export type ListConnectionsV1ConnectionsGetResponses = {
 export type ListConnectionsV1ConnectionsGetResponse = ListConnectionsV1ConnectionsGetResponses[keyof ListConnectionsV1ConnectionsGetResponses];
 export type CreateConnectionV1ConnectionsPostData = {
     body: ConnectionCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/connections';
@@ -1794,6 +1919,12 @@ export type CreateConnectionV1ConnectionsPostResponses = {
 export type CreateConnectionV1ConnectionsPostResponse = CreateConnectionV1ConnectionsPostResponses[keyof CreateConnectionV1ConnectionsPostResponses];
 export type DeleteConnectionV1ConnectionsConnectionIdDeleteData = {
     body?: never;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         connection_id: string;
     };
@@ -1838,6 +1969,12 @@ export type GetConnectionV1ConnectionsConnectionIdGetResponses = {
 export type GetConnectionV1ConnectionsConnectionIdGetResponse = GetConnectionV1ConnectionsConnectionIdGetResponses[keyof GetConnectionV1ConnectionsConnectionIdGetResponses];
 export type UpdateConnectionV1ConnectionsConnectionIdPatchData = {
     body: ConnectionCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         connection_id: string;
     };
@@ -1895,6 +2032,12 @@ export type ListRequestLogsV1RequestLogsGetResponses = {
 export type ListRequestLogsV1RequestLogsGetResponse = ListRequestLogsV1RequestLogsGetResponses[keyof ListRequestLogsV1RequestLogsGetResponses];
 export type CreateRequestLogV1RequestLogsPostData = {
     body: RequestLogCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/request-logs';
@@ -1915,6 +2058,12 @@ export type CreateRequestLogV1RequestLogsPostResponses = {
 export type CreateRequestLogV1RequestLogsPostResponse = CreateRequestLogV1RequestLogsPostResponses[keyof CreateRequestLogV1RequestLogsPostResponses];
 export type DeleteRequestLogV1RequestLogsLogIdDeleteData = {
     body?: never;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         log_id: string;
     };
@@ -1959,6 +2108,12 @@ export type GetRequestLogV1RequestLogsLogIdGetResponses = {
 export type GetRequestLogV1RequestLogsLogIdGetResponse = GetRequestLogV1RequestLogsLogIdGetResponses[keyof GetRequestLogV1RequestLogsLogIdGetResponses];
 export type UpdateRequestLogV1RequestLogsLogIdPatchData = {
     body: RequestLogUpdate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         log_id: string;
     };
@@ -2028,6 +2183,12 @@ export type ListTrajectoriesV1TrajectoriesGetResponses = {
 export type ListTrajectoriesV1TrajectoriesGetResponse = ListTrajectoriesV1TrajectoriesGetResponses[keyof ListTrajectoriesV1TrajectoriesGetResponses];
 export type CreateTrajectoryV1TrajectoriesPostData = {
     body: TrajectoryCreate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/trajectories';
@@ -2048,6 +2209,12 @@ export type CreateTrajectoryV1TrajectoriesPostResponses = {
 export type CreateTrajectoryV1TrajectoriesPostResponse = CreateTrajectoryV1TrajectoriesPostResponses[keyof CreateTrajectoryV1TrajectoriesPostResponses];
 export type DeleteTrajectoryV1TrajectoriesTrajectoryIdDeleteData = {
     body?: never;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         trajectory_id: string;
     };
@@ -2092,6 +2259,12 @@ export type GetTrajectoryV1TrajectoriesTrajectoryIdGetResponses = {
 export type GetTrajectoryV1TrajectoriesTrajectoryIdGetResponse = GetTrajectoryV1TrajectoriesTrajectoryIdGetResponses[keyof GetTrajectoryV1TrajectoriesTrajectoryIdGetResponses];
 export type UpdateTrajectoryV1TrajectoriesTrajectoryIdPatchData = {
     body: TrajectoryUpdate;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         trajectory_id: string;
     };
@@ -2179,6 +2352,12 @@ export type GetDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGetResponses
 export type GetDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGetResponse = GetDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGetResponses[keyof GetDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGetResponses];
 export type KeyboardTypeV1ComputerMachineIdInputKeyboardTypePostData = {
     body: KeyboardTypeRequest;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -2201,6 +2380,12 @@ export type KeyboardTypeV1ComputerMachineIdInputKeyboardTypePostResponses = {
 export type KeyboardTypeV1ComputerMachineIdInputKeyboardTypePostResponse = KeyboardTypeV1ComputerMachineIdInputKeyboardTypePostResponses[keyof KeyboardTypeV1ComputerMachineIdInputKeyboardTypePostResponses];
 export type KeyboardKeyV1ComputerMachineIdInputKeyboardKeyPostData = {
     body: KeyboardKeyRequest;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -2223,6 +2408,12 @@ export type KeyboardKeyV1ComputerMachineIdInputKeyboardKeyPostResponses = {
 export type KeyboardKeyV1ComputerMachineIdInputKeyboardKeyPostResponse = KeyboardKeyV1ComputerMachineIdInputKeyboardKeyPostResponses[keyof KeyboardKeyV1ComputerMachineIdInputKeyboardKeyPostResponses];
 export type CopyToClipboardV1ComputerMachineIdCopyToClipboardPostData = {
     body: CopyToClipboardRequest;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -2269,6 +2460,12 @@ export type GetMousePositionV1ComputerMachineIdInputMousePositionGetResponses =
 export type GetMousePositionV1ComputerMachineIdInputMousePositionGetResponse = GetMousePositionV1ComputerMachineIdInputMousePositionGetResponses[keyof GetMousePositionV1ComputerMachineIdInputMousePositionGetResponses];
 export type MouseMoveV1ComputerMachineIdInputMouseMovePostData = {
     body: MouseMoveRequest;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -2291,6 +2488,12 @@ export type MouseMoveV1ComputerMachineIdInputMouseMovePostResponses = {
 export type MouseMoveV1ComputerMachineIdInputMouseMovePostResponse = MouseMoveV1ComputerMachineIdInputMouseMovePostResponses[keyof MouseMoveV1ComputerMachineIdInputMouseMovePostResponses];
 export type MouseClickV1ComputerMachineIdInputMouseClickPostData = {
     body: MouseClickRequest;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -2313,6 +2516,12 @@ export type MouseClickV1ComputerMachineIdInputMouseClickPostResponses = {
 export type MouseClickV1ComputerMachineIdInputMouseClickPostResponse = MouseClickV1ComputerMachineIdInputMouseClickPostResponses[keyof MouseClickV1ComputerMachineIdInputMouseClickPostResponses];
 export type MouseScrollV1ComputerMachineIdInputMouseScrollPostData = {
     body: MouseScrollRequest;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -2335,6 +2544,12 @@ export type MouseScrollV1ComputerMachineIdInputMouseScrollPostResponses = {
 export type MouseScrollV1ComputerMachineIdInputMouseScrollPostResponse = MouseScrollV1ComputerMachineIdInputMouseScrollPostResponses[keyof MouseScrollV1ComputerMachineIdInputMouseScrollPostResponses];
 export type MouseDragV1ComputerMachineIdInputMouseDragPostData = {
     body: MouseDragRequest;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -2409,6 +2624,12 @@ export type FsReadV1ComputerMachineIdFsReadGetResponses = {
 export type FsReadV1ComputerMachineIdFsReadGetResponse = FsReadV1ComputerMachineIdFsReadGetResponses[keyof FsReadV1ComputerMachineIdFsReadGetResponses];
 export type FsWriteV1ComputerMachineIdFsWritePostData = {
     body: FileWriteRequest;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -2433,6 +2654,12 @@ export type FsWriteV1ComputerMachineIdFsWritePostResponses = {
 export type FsWriteV1ComputerMachineIdFsWritePostResponse = FsWriteV1ComputerMachineIdFsWritePostResponses[keyof FsWriteV1ComputerMachineIdFsWritePostResponses];
 export type PowershellExecV1ComputerMachineIdShellPowershellExecPostData = {
     body: PowerShellExecRequest;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -2457,6 +2684,12 @@ export type PowershellExecV1ComputerMachineIdShellPowershellExecPostResponses =
 export type PowershellExecV1ComputerMachineIdShellPowershellExecPostResponse = PowershellExecV1ComputerMachineIdShellPowershellExecPostResponses[keyof PowershellExecV1ComputerMachineIdShellPowershellExecPostResponses];
 export type PowershellSessionV1ComputerMachineIdShellPowershellSessionPostData = {
     body: PowerShellSessionRequest;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         machine_id: string;
     };
@@ -2481,6 +2714,12 @@ export type PowershellSessionV1ComputerMachineIdShellPowershellSessionPostRespon
 export type PowershellSessionV1ComputerMachineIdShellPowershellSessionPostResponse = PowershellSessionV1ComputerMachineIdShellPowershellSessionPostResponses[keyof PowershellSessionV1ComputerMachineIdShellPowershellSessionPostResponses];
 export type DummyTestEndpointV1TestPostData = {
     body?: never;
+    headers?: {
+        /**
+         * Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.
+         */
+        'Idempotency-Key'?: string;
+    };
     path?: never;
     query?: never;
     url: '/v1/test';
@@ -2518,6 +2757,30 @@ export type RootGetResponses = {
      */
     200: unknown;
 };
+export type HealthLiveHealthLiveGetData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/health/live';
+};
+export type HealthLiveHealthLiveGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: unknown;
+};
+export type HealthReadyHealthReadyGetData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/health/ready';
+};
+export type HealthReadyHealthReadyGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: unknown;
+};
 export type HealthHealthGetData = {
     body?: never;
     path?: never;
@@ -2528,11 +2791,8 @@ export type HealthHealthGetResponses = {
     /**
      * Successful Response
      */
-    200: {
-        [key: string]: unknown;
-    };
+    200: unknown;
 };
-export type HealthHealthGetResponse = HealthHealthGetResponses[keyof HealthHealthGetResponses];
 export type HealthDbHealthDbGetData = {
     body?: never;
     path?: never;

package/dist/index.d.ts

@@ -30,13 +30,72 @@ export * from './client/types.gen';
 export * from './client/sdk.gen';
 export * from './client/client.gen';
 /**
- * Client options for configuring retry behavior and other settings
+ * Client options for configuring the SDK
  */
 export interface CyberdeskClientOptions {
-    /** Maximum number of retry attempts (default: 2, meaning 3 total attempts) */
-    maxRetries?: number;
     /** Custom fetch implementation (for testing or advanced use cases) */
     fetch?: typeof fetch;
+    /** Retry configuration for transient failures (network errors, 5xx, 429, etc.). */
+    retry?: CyberdeskRetryOptions;
+    /** Idempotency configuration (auto-adds Idempotency-Key for write requests). */
+    idempotency?: CyberdeskIdempotencyOptions;
+}
+export interface CyberdeskRetryOptions {
+    /**
+     * Number of retries after the initial attempt.
+     * Total attempts = 1 + maxRetries.
+     *
+     * Default: 3
+     */
+    maxRetries?: number;
+    /**
+     * Per-attempt timeout in milliseconds.
+     *
+     * Default: 30000 (30s)
+     */
+    timeoutMs?: number;
+    /**
+     * Initial backoff delay in milliseconds (before exponential growth + jitter).
+     *
+     * Default: 250ms
+     */
+    minDelayMs?: number;
+    /**
+     * Maximum backoff delay in milliseconds.
+     *
+     * Default: 8000ms
+     */
+    maxDelayMs?: number;
+    /**
+     * Called before a retry is scheduled (useful for logging/metrics).
+     */
+    onRetry?: (info: {
+        attempt: number;
+        maxRetries: number;
+        delayMs: number;
+        reason: 'timeout' | 'network_error' | 'http_status';
+        status?: number;
+    }) => void;
+}
+export interface CyberdeskIdempotencyOptions {
+    /**
+     * Enable automatic idempotency keys for write requests (POST/PUT/PATCH/DELETE).
+     *
+     * Default: true
+     */
+    enabled?: boolean;
+    /**
+     * Header name to use.
+     *
+     * Default: 'Idempotency-Key'
+     */
+    headerName?: string;
+    /**
+     * Custom generator for idempotency keys.
+     *
+     * Default: crypto.randomUUID() (with fallback)
+     */
+    generateKey?: () => string;
 }
 /**
  * Create a Cyberdesk API client
@@ -44,7 +103,6 @@ export interface CyberdeskClientOptions {
  * @param apiKey - Your Cyberdesk API key
  * @param baseUrl - Optional API base URL (defaults to https://api.cyberdesk.io)
  * @param options - Optional client configuration
- * @param options.maxRetries - Maximum retry attempts for failed requests (default: 2)
  * @returns Configured client with all API endpoints
  *
  * @example
@@ -52,12 +110,6 @@ export interface CyberdeskClientOptions {
  * // Basic usage
  * const client = createCyberdeskClient('your-api-key');
  * const machines = await client.machines.list();
- *
- * // With custom retry configuration
- * const client = createCyberdeskClient('your-api-key', undefined, { maxRetries: 3 });
- *
- * // Disable retries
- * const client = createCyberdeskClient('your-api-key', undefined, { maxRetries: 0 });
  * ```
  */
 export declare function createCyberdeskClient(apiKey: string, baseUrl?: string, options?: CyberdeskClientOptions): {

package/dist/index.js

@@ -52,172 +52,196 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCyberdeskClient = createCyberdeskClient;
 const client_fetch_1 = require("@hey-api/client-fetch");
-// ============================================================================
-// Retry Configuration (Stripe SDK-style)
-// ============================================================================
-/** Default number of retry attempts (2 retries = 3 total attempts, like Stripe) */
-const DEFAULT_MAX_RETRIES = 2;
-/** Initial retry delay in milliseconds */
-const INITIAL_RETRY_DELAY_MS = 500;
-/** Maximum retry delay in milliseconds */
-const MAX_RETRY_DELAY_MS = 5000;
-/** HTTP status codes that should trigger a retry */
-const RETRYABLE_STATUS_CODES = new Set([
-    408, // Request Timeout
-    409, // Conflict (can be retried with idempotency)
-    429, // Too Many Requests
-    500, // Internal Server Error
-    502, // Bad Gateway
-    503, // Service Unavailable
-    504, // Gateway Timeout
-]);
-/**
- * Determines if an error is a retryable network error
- *
- * Note: AbortError (from AbortController.abort()) is NOT retried because:
- * - It indicates intentional cancellation by the caller
- * - The abort signal remains aborted, so retries would fail immediately
- * - Retrying would waste attempts and delay error propagation
- */
-function isNetworkError(error) {
-    // AbortError means intentional cancellation - don't retry
-    if (error instanceof DOMException && error.name === 'AbortError') {
-        return false;
-    }
-    if (error instanceof TypeError) {
-        const message = error.message.toLowerCase();
-        return (message.includes('fetch') ||
-            message.includes('network') ||
-            message.includes('failed') ||
-            message.includes('timeout'));
-    }
-    return false;
-}
-/**
- * Determines if a response status code should trigger a retry
- */
-function shouldRetryResponse(response) {
-    return RETRYABLE_STATUS_CODES.has(response.status);
+// Import SDK methods from sdk.gen
+const sdk_gen_1 = require("./client/sdk.gen");
+// Export all generated types and methods for direct use
+__exportStar(require("./client/types.gen"), exports);
+__exportStar(require("./client/sdk.gen"), exports);
+__exportStar(require("./client/client.gen"), exports);
+// Configuration
+/** Default API base URL for Cyberdesk Cloud API */
+const DEFAULT_API_BASE_URL = "https://api.cyberdesk.io";
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
 }
-/**
- * Calculate delay for exponential backoff with full jitter (Stripe-style)
- *
- * Formula: min(cap, random(0, base * 2^attempt))
- * This provides better distribution than adding jitter to exponential backoff
- */
-function calculateRetryDelay(attempt, retryAfterMs) {
-    if (retryAfterMs && retryAfterMs > 0) {
-        // Respect server's Retry-After header, but cap it
-        return Math.min(retryAfterMs, MAX_RETRY_DELAY_MS);
+function defaultGenerateIdempotencyKey() {
+    // Browser + modern Node runtimes
+    const anyCrypto = globalThis.crypto;
+    if (anyCrypto && typeof anyCrypto.randomUUID === 'function') {
+        return anyCrypto.randomUUID();
     }
-    // Full jitter exponential backoff
-    const exponentialDelay = INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt);
-    const maxDelay = Math.min(exponentialDelay, MAX_RETRY_DELAY_MS);
-    return Math.random() * maxDelay;
+    // Fallback: not a UUID but sufficiently unique for idempotency keys
+    return `${Date.now()}-${Math.random().toString(16).slice(2)}-${Math.random().toString(16).slice(2)}`;
 }
-/**
- * Parse Retry-After header value to milliseconds
- */
-function parseRetryAfter(response) {
-    const retryAfter = response.headers.get('Retry-After');
+function parseRetryAfterMs(retryAfter) {
     if (!retryAfter)
-        return undefined;
-    // Try parsing as seconds (integer)
-    const seconds = parseInt(retryAfter, 10);
-    if (!isNaN(seconds)) {
+        return null;
+    const trimmed = retryAfter.trim();
+    if (!trimmed)
+        return null;
+    // Seconds
+    if (/^\d+$/.test(trimmed)) {
+        const seconds = Number(trimmed);
+        if (!Number.isFinite(seconds) || seconds < 0)
+            return null;
         return seconds * 1000;
     }
-    // Try parsing as HTTP date
-    const date = Date.parse(retryAfter);
-    if (!isNaN(date)) {
-        return Math.max(0, date - Date.now());
-    }
-    return undefined;
+    // HTTP date
+    const dateMs = Date.parse(trimmed);
+    if (Number.isNaN(dateMs))
+        return null;
+    const delta = dateMs - Date.now();
+    return delta > 0 ? delta : 0;
 }
-/**
- * Sleep for a specified duration
- */
-function sleep(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
+function isWriteMethod(method) {
+    const m = method.toUpperCase();
+    return m === 'POST' || m === 'PUT' || m === 'PATCH' || m === 'DELETE';
 }
-/**
- * Creates a fetch wrapper with automatic retry logic
- *
- * Implements Stripe-style retry behavior:
- * - Retries on network errors (connection failures, timeouts)
- * - Retries on 5xx server errors and 429 (rate limit)
- * - Does NOT retry on 4xx client errors (except 408, 409, 429)
- * - Uses exponential backoff with full jitter
- * - Respects Retry-After headers
- */
-function createRetryFetch(maxRetries = DEFAULT_MAX_RETRIES) {
-    return function retryFetch(input, init) {
-        return __awaiter(this, void 0, void 0, function* () {
-            let lastError;
-            let lastResponse;
-            for (let attempt = 0; attempt <= maxRetries; attempt++) {
-                try {
-                    // Use globalThis.fetch directly bound to avoid "Illegal invocation"
-                    const response = yield globalThis.fetch(input, init);
-                    // Success - return immediately
-                    if (!shouldRetryResponse(response)) {
-                        return response;
-                    }
-                    // Store response for potential retry
-                    lastResponse = response;
-                    // Don't retry on last attempt
-                    if (attempt === maxRetries) {
-                        return response;
-                    }
-                    // Calculate delay with Retry-After header support
-                    const retryAfterMs = parseRetryAfter(response);
-                    const delay = calculateRetryDelay(attempt, retryAfterMs);
-                    yield sleep(delay);
+function isRetryableStatus(status, response) {
+    var _a;
+    // Standard transient statuses
+    if (status === 408 || status === 429 || status === 500 || status === 502 || status === 503 || status === 504) {
+        return true;
+    }
+    // Special-case: idempotency in progress (API returns 409 + Retry-After + Idempotency-Status)
+    if (status === 409 && response) {
+        const idemStatus = (_a = response.headers.get('Idempotency-Status')) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+        if (idemStatus === 'in_progress')
+            return true;
+    }
+    return false;
+}
+function createRetryingFetch(baseFetch, opts) {
+    return (input, init) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e;
+        const retry = opts.retry;
+        const idempotency = opts.idempotency;
+        const baseMethod = ((_a = init === null || init === void 0 ? void 0 : init.method) !== null && _a !== void 0 ? _a : (input instanceof Request ? input.method : 'GET')).toUpperCase();
+        const shouldAddIdempotency = idempotency.enabled && isWriteMethod(baseMethod);
+        // Build merged headers once, and reuse across attempts
+        const headers = new Headers();
+        if (input instanceof Request) {
+            input.headers.forEach((v, k) => headers.set(k, v));
+        }
+        if (init === null || init === void 0 ? void 0 : init.headers) {
+            new Headers(init.headers).forEach((v, k) => headers.set(k, v));
+        }
+        let idempotencyKey = null;
+        if (shouldAddIdempotency) {
+            const headerName = idempotency.headerName || 'Idempotency-Key';
+            if (!headers.has(headerName)) {
+                idempotencyKey = idempotency.generateKey();
+                headers.set(headerName, idempotencyKey);
+            }
+        }
+        // If we cannot ensure idempotency for a write request, do not retry by default (unsafe).
+        const writeRequestWithoutIdempotency = isWriteMethod(baseMethod) && !(idempotencyKey || headers.has(idempotency.headerName || 'Idempotency-Key'));
+        const maxRetries = Math.max(0, retry.maxRetries);
+        const totalAttempts = 1 + maxRetries;
+        let lastError;
+        for (let attempt = 0; attempt < totalAttempts; attempt++) {
+            // Per-attempt timeout
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), retry.timeoutMs);
+            // Respect caller-provided AbortSignal, if any
+            const parentSignal = (_b = init === null || init === void 0 ? void 0 : init.signal) !== null && _b !== void 0 ? _b : (input instanceof Request ? input.signal : undefined);
+            if (parentSignal) {
+                if (parentSignal.aborted) {
+                    clearTimeout(timeout);
+                    throw new DOMException('The operation was aborted.', 'AbortError');
                 }
-                catch (error) {
-                    lastError = error;
-                    // Only retry on network errors
-                    if (!isNetworkError(error)) {
-                        throw error;
-                    }
-                    // Don't retry on last attempt
-                    if (attempt === maxRetries) {
-                        throw error;
-                    }
-                    const delay = calculateRetryDelay(attempt);
-                    yield sleep(delay);
+                const onAbort = () => controller.abort();
+                parentSignal.addEventListener('abort', onAbort, { once: true });
+                // Best-effort cleanup handled below when fetch resolves/rejects
+            }
+            try {
+                // Use a fresh Request object each attempt when possible (avoids body reuse issues).
+                const attemptInput = input instanceof Request ? input.clone() : input;
+                const attemptInit = Object.assign(Object.assign({}, init), { method: baseMethod, headers, signal: controller.signal });
+                const response = yield baseFetch(attemptInput, attemptInit);
+                clearTimeout(timeout);
+                if (!isRetryableStatus(response.status, response) || attempt === maxRetries) {
+                    return response;
                 }
+                if (writeRequestWithoutIdempotency) {
+                    return response;
+                }
+                const retryAfterMs = parseRetryAfterMs(response.headers.get('Retry-After'));
+                const expBackoff = Math.min(retry.maxDelayMs, retry.minDelayMs * Math.pow(2, attempt));
+                const jittered = Math.floor(Math.random() * expBackoff);
+                const delayMs = Math.max(0, Math.min(retry.maxDelayMs, retryAfterMs !== null && retryAfterMs !== void 0 ? retryAfterMs : jittered));
+                (_c = retry.onRetry) === null || _c === void 0 ? void 0 : _c.call(retry, {
+                    attempt,
+                    maxRetries,
+                    delayMs,
+                    reason: 'http_status',
+                    status: response.status,
+                });
+                yield sleep(delayMs);
+                continue;
             }
-            // This should never be reached, but TypeScript needs it
-            if (lastResponse) {
-                return lastResponse;
+            catch (err) {
+                clearTimeout(timeout);
+                // If caller aborted, don't retry
+                const isAbort = (err instanceof DOMException && err.name === 'AbortError') ||
+                    (typeof err === 'object' && err !== null && err.name === 'AbortError');
+                if (isAbort) {
+                    // If our timeout triggered, we can retry; if caller aborted, we should not.
+                    const callerAborted = (parentSignal === null || parentSignal === void 0 ? void 0 : parentSignal.aborted) === true;
+                    if (callerAborted || attempt === maxRetries || writeRequestWithoutIdempotency) {
+                        throw err;
+                    }
+                    const expBackoff = Math.min(retry.maxDelayMs, retry.minDelayMs * Math.pow(2, attempt));
+                    const delayMs = Math.floor(Math.random() * expBackoff);
+                    (_d = retry.onRetry) === null || _d === void 0 ? void 0 : _d.call(retry, { attempt, maxRetries, delayMs, reason: 'timeout' });
+                    yield sleep(delayMs);
+                    lastError = err;
+                    continue;
+                }
+                if (attempt === maxRetries || writeRequestWithoutIdempotency) {
+                    throw err;
+                }
+                const expBackoff = Math.min(retry.maxDelayMs, retry.minDelayMs * Math.pow(2, attempt));
+                const delayMs = Math.floor(Math.random() * expBackoff);
+                (_e = retry.onRetry) === null || _e === void 0 ? void 0 : _e.call(retry, { attempt, maxRetries, delayMs, reason: 'network_error' });
+                yield sleep(delayMs);
+                lastError = err;
+                continue;
             }
-            throw lastError;
-        });
-    };
+        }
+        // Should be unreachable; keep TypeScript happy
+        throw lastError !== null && lastError !== void 0 ? lastError : new Error('Request failed');
+    });
 }
-// Import SDK methods from sdk.gen
-const sdk_gen_1 = require("./client/sdk.gen");
-// Export all generated types and methods for direct use
-__exportStar(require("./client/types.gen"), exports);
-__exportStar(require("./client/sdk.gen"), exports);
-__exportStar(require("./client/client.gen"), exports);
-// Configuration
-/** Default API base URL for Cyberdesk Cloud API */
-const DEFAULT_API_BASE_URL = "https://api.cyberdesk.io";
 /**
- * Create a configured HTTP client with authentication and automatic retries
+ * Create a configured HTTP client with authentication
  *
  * @internal
  * @param apiKey - Your Cyberdesk API key
  * @param baseUrl - API base URL
  * @param options - Client configuration options
- * @returns Configured HTTP client with retry logic
+ * @returns Configured HTTP client
  */
 function createApiClient(apiKey, baseUrl = DEFAULT_API_BASE_URL, options = {}) {
-    const { maxRetries = DEFAULT_MAX_RETRIES, fetch: customFetch } = options;
-    // Use custom fetch if provided, otherwise create retry-enabled fetch
-    const fetchWithRetry = customFetch !== null && customFetch !== void 0 ? customFetch : createRetryFetch(maxRetries);
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+    const { fetch: customFetch } = options;
+    const baseFetch = customFetch !== null && customFetch !== void 0 ? customFetch : fetch;
+    const retryOptions = {
+        maxRetries: (_b = (_a = options.retry) === null || _a === void 0 ? void 0 : _a.maxRetries) !== null && _b !== void 0 ? _b : 3,
+        timeoutMs: (_d = (_c = options.retry) === null || _c === void 0 ? void 0 : _c.timeoutMs) !== null && _d !== void 0 ? _d : 30000,
+        minDelayMs: (_f = (_e = options.retry) === null || _e === void 0 ? void 0 : _e.minDelayMs) !== null && _f !== void 0 ? _f : 250,
+        maxDelayMs: (_h = (_g = options.retry) === null || _g === void 0 ? void 0 : _g.maxDelayMs) !== null && _h !== void 0 ? _h : 8000,
+        onRetry: (_j = options.retry) === null || _j === void 0 ? void 0 : _j.onRetry,
+    };
+    const idempotencyOptions = {
+        enabled: (_l = (_k = options.idempotency) === null || _k === void 0 ? void 0 : _k.enabled) !== null && _l !== void 0 ? _l : true,
+        headerName: (_o = (_m = options.idempotency) === null || _m === void 0 ? void 0 : _m.headerName) !== null && _o !== void 0 ? _o : 'Idempotency-Key',
+        generateKey: (_q = (_p = options.idempotency) === null || _p === void 0 ? void 0 : _p.generateKey) !== null && _q !== void 0 ? _q : defaultGenerateIdempotencyKey,
+    };
+    const wrappedFetch = createRetryingFetch(baseFetch, {
+        retry: retryOptions,
+        idempotency: idempotencyOptions,
+    });
     return (0, client_fetch_1.createClient)({
         baseUrl,
         headers: {
@@ -225,7 +249,7 @@ function createApiClient(apiKey, baseUrl = DEFAULT_API_BASE_URL, options = {}) {
             'Authorization': `Bearer ${apiKey}`,
             'Connection': 'keep-alive',
         },
-        fetch: fetchWithRetry,
+        fetch: wrappedFetch,
     });
 }
 // Helpers
@@ -240,7 +264,6 @@ function toIsoUtc(value) {
  * @param apiKey - Your Cyberdesk API key
  * @param baseUrl - Optional API base URL (defaults to https://api.cyberdesk.io)
  * @param options - Optional client configuration
- * @param options.maxRetries - Maximum retry attempts for failed requests (default: 2)
  * @returns Configured client with all API endpoints
  *
  * @example
@@ -248,12 +271,6 @@ function toIsoUtc(value) {
  * // Basic usage
  * const client = createCyberdeskClient('your-api-key');
  * const machines = await client.machines.list();
- *
- * // With custom retry configuration
- * const client = createCyberdeskClient('your-api-key', undefined, { maxRetries: 3 });
- *
- * // Disable retries
- * const client = createCyberdeskClient('your-api-key', undefined, { maxRetries: 0 });
  * ```
  */
 function createCyberdeskClient(apiKey, baseUrl, options) {

package/package.json

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