cyberdesk 2.2.11 → 2.2.13

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, ListModelConfigurationsV1ModelConfigurationsGetData, CreateModelConfigurationV1ModelConfigurationsPostData, DeleteModelConfigurationV1ModelConfigurationsModelConfigurationIdDeleteData, GetModelConfigurationV1ModelConfigurationsModelConfigurationIdGetData, UpdateModelConfigurationV1ModelConfigurationsModelConfigurationIdPatchData, 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, DbPingInternalDebugDbPingGetData, RootGetData, HealthLiveHealthLiveGetData, HealthReadyHealthReadyGetData, 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, ListModelConfigurationsV1ModelConfigurationsGetData, CreateModelConfigurationV1ModelConfigurationsPostData, DeleteModelConfigurationV1ModelConfigurationsModelConfigurationIdDeleteData, GetModelConfigurationV1ModelConfigurationsModelConfigurationIdGetData, UpdateModelConfigurationV1ModelConfigurationsModelConfigurationIdPatchData, 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, GetUsageAggregateV1UsageAggregateGetData, 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
@@ -525,6 +525,18 @@ export declare const powershellExecV1ComputerMachineIdShellPowershellExecPost: <
 export declare const powershellSessionV1ComputerMachineIdShellPowershellSessionPost: <ThrowOnError extends boolean = false>(options: Options<PowershellSessionV1ComputerMachineIdShellPowershellSessionPostData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<{
     [key: string]: unknown;
 }, import("./types.gen").HttpValidationError, ThrowOnError>;
+/**
+ * Get Usage Aggregate
+ * Aggregate usage (agentic and cached steps) for a given date range.
+ *
+ * Two modes are supported:
+ * - **simulated** (default): Uses total_agentic_steps and total_cached_steps from usage_metadata,
+ * but excludes runs where billing_outcome is 'infra_failure' (these would have been free).
+ * Use this for customers not yet on Stripe billing.
+ * - **billed**: Uses total_agentic_steps_billed and total_cached_steps_billed.
+ * Use this for customers on active Stripe billing.
+ */
+export declare const getUsageAggregateV1UsageAggregateGet: <ThrowOnError extends boolean = false>(options: Options<GetUsageAggregateV1UsageAggregateGetData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").UsageAggregateResponse, import("./types.gen").HttpValidationError, ThrowOnError>;
 /**
  * Db Ping
  * Execute a lightweight `SELECT 1` to validate DB connectivity and expose pool stats.

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.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.updateModelConfigurationV1ModelConfigurationsModelConfigurationIdPatch = exports.getModelConfigurationV1ModelConfigurationsModelConfigurationIdGet = exports.deleteModelConfigurationV1ModelConfigurationsModelConfigurationIdDelete = exports.createModelConfigurationV1ModelConfigurationsPost = exports.listModelConfigurationsV1ModelConfigurationsGet = 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.healthReadyHealthReadyGet = exports.healthLiveHealthLiveGet = exports.rootGet = exports.dbPingInternalDebugDbPingGet = 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 = exports.deleteTrajectoryV1TrajectoriesTrajectoryIdDelete = exports.createTrajectoryV1TrajectoriesPost = exports.listTrajectoriesV1TrajectoriesGet = exports.updateRequestLogV1RequestLogsLogIdPatch = exports.getRequestLogV1RequestLogsLogIdGet = void 0;
+exports.healthDbHealthDbGet = exports.healthHealthGet = exports.healthReadyHealthReadyGet = exports.healthLiveHealthLiveGet = exports.rootGet = exports.dbPingInternalDebugDbPingGet = exports.getUsageAggregateV1UsageAggregateGet = 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 = exports.deleteTrajectoryV1TrajectoriesTrajectoryIdDelete = exports.createTrajectoryV1TrajectoriesPost = exports.listTrajectoriesV1TrajectoriesGet = exports.updateRequestLogV1RequestLogsLogIdPatch = exports.getRequestLogV1RequestLogsLogIdGet = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * Health Check
@@ -1147,6 +1147,27 @@ const powershellSessionV1ComputerMachineIdShellPowershellSessionPost = (options)
         ], url: '/v1/computer/{machine_id}/shell/powershell/session' }, options), { headers: Object.assign({ 'Content-Type': 'application/json' }, options === null || options === void 0 ? void 0 : options.headers) }));
 };
 exports.powershellSessionV1ComputerMachineIdShellPowershellSessionPost = powershellSessionV1ComputerMachineIdShellPowershellSessionPost;
+/**
+ * Get Usage Aggregate
+ * Aggregate usage (agentic and cached steps) for a given date range.
+ *
+ * Two modes are supported:
+ * - **simulated** (default): Uses total_agentic_steps and total_cached_steps from usage_metadata,
+ * but excludes runs where billing_outcome is 'infra_failure' (these would have been free).
+ * Use this for customers not yet on Stripe billing.
+ * - **billed**: Uses total_agentic_steps_billed and total_cached_steps_billed.
+ * Use this for customers on active Stripe billing.
+ */
+const getUsageAggregateV1UsageAggregateGet = (options) => {
+    var _a;
+    return ((_a = options.client) !== null && _a !== void 0 ? _a : client_gen_1.client).get(Object.assign({ security: [
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ], url: '/v1/usage/aggregate' }, options));
+};
+exports.getUsageAggregateV1UsageAggregateGet = getUsageAggregateV1UsageAggregateGet;
 /**
  * Db Ping
  * Execute a lightweight `SELECT 1` to validate DB connectivity and expose pool stats.

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

@@ -231,7 +231,7 @@ export type ModelConfigurationCreate = {
         [key: string]: unknown;
     } | null;
     /**
-     * True if this model has native computer use capabilities. If True, can be used for main agent, focused actions, and fallbacks for those agents).
+     * True if this model has native computer use capabilities. If True, can be used for main agent, focused actions, and fallbacks for those agents.
      */
     is_computer_use_model?: boolean;
     /**
@@ -264,7 +264,7 @@ export type ModelConfigurationResponse = {
         [key: string]: unknown;
     } | null;
     /**
-     * True if this model has native computer use capabilities. If True, can be used for main agent, focused actions, and fallbacks for those agents).
+     * True if this model has native computer use capabilities. If True, can be used for main agent, focused actions, and fallbacks for those agents.
      */
     is_computer_use_model?: boolean;
     id: string;
@@ -310,6 +310,10 @@ export type MouseClickRequest = {
      * None = full click, True = mouse down, False = mouse up
      */
     down?: boolean | null;
+    /**
+     * Number of clicks (1=single, 2=double, 3=triple)
+     */
+    clicks?: number;
 };
 export type MouseDragRequest = {
     to_x: number;
@@ -868,6 +872,21 @@ export type TrajectoryUpdate = {
      */
     is_approved?: boolean | null;
 };
+/**
+ * Response schema for usage aggregation.
+ */
+export type UsageAggregateResponse = {
+    total_agentic_steps: number;
+    total_cached_steps: number;
+    period_start: string;
+    period_end: string;
+    mode: UsageMode;
+    runs_counted: number;
+};
+/**
+ * Mode for counting usage steps.
+ */
+export type UsageMode = 'simulated' | 'billed';
 export type ValidationError = {
     loc: Array<string | number>;
     msg: string;
@@ -2960,6 +2979,39 @@ export type PowershellSessionV1ComputerMachineIdShellPowershellSessionPostRespon
     };
 };
 export type PowershellSessionV1ComputerMachineIdShellPowershellSessionPostResponse = PowershellSessionV1ComputerMachineIdShellPowershellSessionPostResponses[keyof PowershellSessionV1ComputerMachineIdShellPowershellSessionPostResponses];
+export type GetUsageAggregateV1UsageAggregateGetData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Start of period (inclusive, ISO format)
+         */
+        from_date: string;
+        /**
+         * End of period (inclusive, ISO format)
+         */
+        to_date: string;
+        /**
+         * Usage counting mode: 'simulated' or 'billed'
+         */
+        mode?: UsageMode;
+    };
+    url: '/v1/usage/aggregate';
+};
+export type GetUsageAggregateV1UsageAggregateGetErrors = {
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type GetUsageAggregateV1UsageAggregateGetError = GetUsageAggregateV1UsageAggregateGetErrors[keyof GetUsageAggregateV1UsageAggregateGetErrors];
+export type GetUsageAggregateV1UsageAggregateGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: UsageAggregateResponse;
+};
+export type GetUsageAggregateV1UsageAggregateGetResponse = GetUsageAggregateV1UsageAggregateGetResponses[keyof GetUsageAggregateV1UsageAggregateGetResponses];
 export type DbPingInternalDebugDbPingGetData = {
     body?: never;
     path?: never;

package/dist/index.d.ts

@@ -25,7 +25,7 @@
  * });
  * ```
  */
-import { type MachineResponse, type MachinePoolUpdate, type PoolResponse, type PoolCreate, type PoolUpdate, type PoolWithMachines, type MachinePoolAssignment, type WorkflowResponse, type RunResponse, type ConnectionResponse, type TrajectoryResponse, type PaginatedResponseMachineResponse, type PaginatedResponsePoolResponse, type PaginatedResponseWorkflowResponse, type PaginatedResponseRunResponse, type PaginatedResponseConnectionResponse, type PaginatedResponseTrajectoryResponse, type MachineStatus, type RunStatus, type ConnectionStatus, type MachineCreate, type WorkflowCreate, type RunCreate, type RunBulkCreate, type RunBulkCreateResponse, type WorkflowChainCreate, type WorkflowChainResponse, type FileInput, type ConnectionCreate, type TrajectoryCreate, type MachineUpdate, type WorkflowUpdate, type RunUpdate, type TrajectoryUpdate, type RunAttachmentCreate, type RunAttachmentUpdate, type RunAttachmentResponse, type RunAttachmentDownloadUrlResponse, type AttachmentType, type PaginatedResponseRunAttachmentResponse, type RunRetry, type RunField, type ModelConfigurationCreate, type ModelConfigurationUpdate, type ModelConfigurationResponse } from './client/types.gen';
+import { type MachineResponse, type MachinePoolUpdate, type PoolResponse, type PoolCreate, type PoolUpdate, type PoolWithMachines, type MachinePoolAssignment, type WorkflowResponse, type RunResponse, type ConnectionResponse, type TrajectoryResponse, type PaginatedResponseMachineResponse, type PaginatedResponsePoolResponse, type PaginatedResponseWorkflowResponse, type PaginatedResponseRunResponse, type PaginatedResponseConnectionResponse, type PaginatedResponseTrajectoryResponse, type MachineStatus, type RunStatus, type ConnectionStatus, type MachineCreate, type WorkflowCreate, type RunCreate, type RunBulkCreate, type RunBulkCreateResponse, type WorkflowChainCreate, type WorkflowChainResponse, type FileInput, type ConnectionCreate, type TrajectoryCreate, type MachineUpdate, type WorkflowUpdate, type RunUpdate, type TrajectoryUpdate, type RunAttachmentCreate, type RunAttachmentUpdate, type RunAttachmentResponse, type RunAttachmentDownloadUrlResponse, type AttachmentType, type PaginatedResponseRunAttachmentResponse, type RunRetry, type RunField, type ModelConfigurationCreate, type ModelConfigurationUpdate, type ModelConfigurationResponse, type UsageAggregateResponse, type UsageMode } from './client/types.gen';
 export * from './client/types.gen';
 export * from './client/sdk.gen';
 export * from './client/client.gen';
@@ -1190,5 +1190,58 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string,
             response: Response;
         }>;
     };
+    usage: {
+        /**
+         * Aggregate usage (agentic and cached steps) for a given date range.
+         *
+         * Two modes are supported:
+         * - **simulated** (default): Uses total_agentic_steps and total_cached_steps from usage_metadata,
+         *   but excludes runs where billing_outcome is 'infra_failure' (these would have been free).
+         *   Use this for customers not yet on Stripe billing.
+         * - **billed**: Uses total_agentic_steps_billed and total_cached_steps_billed.
+         *   Use this for customers on active Stripe billing.
+         *
+         * @param params - Query parameters
+         * @param params.from_date - Start of period (inclusive, ISO string or Date)
+         * @param params.to_date - End of period (inclusive, ISO string or Date)
+         * @param params.mode - Usage counting mode ('simulated' or 'billed'). Defaults to 'simulated'.
+         * @returns UsageAggregateResponse containing:
+         *          - total_agentic_steps: Total agentic steps in the period
+         *          - total_cached_steps: Total cached steps in the period
+         *          - period_start: Start of the queried period
+         *          - period_end: End of the queried period
+         *          - mode: The mode used for counting
+         *          - runs_counted: Number of runs included in the aggregation
+         *
+         * @example
+         * ```typescript
+         * const { data } = await client.usage.aggregate({
+         *   from_date: '2024-01-01T00:00:00Z',
+         *   to_date: '2024-01-31T23:59:59Z',
+         *   mode: 'simulated'
+         * });
+         *
+         * if (data) {
+         *   console.log(`Agentic steps: ${data.total_agentic_steps}`);
+         *   console.log(`Cached steps: ${data.total_cached_steps}`);
+         *   console.log(`Runs counted: ${data.runs_counted}`);
+         * }
+         * ```
+         */
+        aggregate: (params: {
+            from_date: string | Date;
+            to_date: string | Date;
+            mode?: UsageMode;
+        }) => Promise<({
+            data: undefined;
+            error: import("./client/types.gen").HttpValidationError;
+        } | {
+            data: UsageAggregateResponse;
+            error: undefined;
+        }) & {
+            request: Request;
+            response: Response;
+        }>;
+    };
 };
-export type { MachineResponse, MachinePoolUpdate, PoolResponse, PoolCreate, PoolUpdate, PoolWithMachines, MachinePoolAssignment, WorkflowResponse, RunResponse, RunBulkCreate, RunBulkCreateResponse, ConnectionResponse, TrajectoryResponse, RunAttachmentResponse, RunAttachmentDownloadUrlResponse, FileInput, AttachmentType, PaginatedResponseMachineResponse, PaginatedResponsePoolResponse, PaginatedResponseWorkflowResponse, PaginatedResponseRunResponse, PaginatedResponseConnectionResponse, PaginatedResponseTrajectoryResponse, PaginatedResponseRunAttachmentResponse, ModelConfigurationCreate, ModelConfigurationUpdate, ModelConfigurationResponse, };
+export type { MachineResponse, MachinePoolUpdate, PoolResponse, PoolCreate, PoolUpdate, PoolWithMachines, MachinePoolAssignment, WorkflowResponse, RunResponse, RunBulkCreate, RunBulkCreateResponse, ConnectionResponse, TrajectoryResponse, RunAttachmentResponse, RunAttachmentDownloadUrlResponse, FileInput, AttachmentType, PaginatedResponseMachineResponse, PaginatedResponsePoolResponse, PaginatedResponseWorkflowResponse, PaginatedResponseRunResponse, PaginatedResponseConnectionResponse, PaginatedResponseTrajectoryResponse, PaginatedResponseRunAttachmentResponse, ModelConfigurationCreate, ModelConfigurationUpdate, ModelConfigurationResponse, UsageAggregateResponse, UsageMode, };

package/dist/index.js

@@ -1168,5 +1168,55 @@ function createCyberdeskClient(apiKey, baseUrl, options) {
                 });
             }),
         },
+        // Usage endpoints
+        usage: {
+            /**
+             * Aggregate usage (agentic and cached steps) for a given date range.
+             *
+             * Two modes are supported:
+             * - **simulated** (default): Uses total_agentic_steps and total_cached_steps from usage_metadata,
+             *   but excludes runs where billing_outcome is 'infra_failure' (these would have been free).
+             *   Use this for customers not yet on Stripe billing.
+             * - **billed**: Uses total_agentic_steps_billed and total_cached_steps_billed.
+             *   Use this for customers on active Stripe billing.
+             *
+             * @param params - Query parameters
+             * @param params.from_date - Start of period (inclusive, ISO string or Date)
+             * @param params.to_date - End of period (inclusive, ISO string or Date)
+             * @param params.mode - Usage counting mode ('simulated' or 'billed'). Defaults to 'simulated'.
+             * @returns UsageAggregateResponse containing:
+             *          - total_agentic_steps: Total agentic steps in the period
+             *          - total_cached_steps: Total cached steps in the period
+             *          - period_start: Start of the queried period
+             *          - period_end: End of the queried period
+             *          - mode: The mode used for counting
+             *          - runs_counted: Number of runs included in the aggregation
+             *
+             * @example
+             * ```typescript
+             * const { data } = await client.usage.aggregate({
+             *   from_date: '2024-01-01T00:00:00Z',
+             *   to_date: '2024-01-31T23:59:59Z',
+             *   mode: 'simulated'
+             * });
+             *
+             * if (data) {
+             *   console.log(`Agentic steps: ${data.total_agentic_steps}`);
+             *   console.log(`Cached steps: ${data.total_cached_steps}`);
+             *   console.log(`Runs counted: ${data.runs_counted}`);
+             * }
+             * ```
+             */
+            aggregate: (params) => __awaiter(this, void 0, void 0, function* () {
+                return (0, sdk_gen_1.getUsageAggregateV1UsageAggregateGet)({
+                    client,
+                    query: {
+                        from_date: toIsoUtc(params.from_date),
+                        to_date: toIsoUtc(params.to_date),
+                        mode: params.mode,
+                    },
+                });
+            }),
+        },
     };
 }

package/package.json

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