cyberdesk 2.1.20 → 2.1.21

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

@@ -592,7 +592,7 @@ export type RunCreate = {
  * These are optional fields beyond the essential identifiers that are always returned
  * (id, workflow_id, machine_id, status, created_at).
  */
-export type RunField = 'user_id' | 'organization_id' | 'error' | 'output_data' | 'input_attachment_ids' | 'output_attachment_ids' | 'run_message_history' | 'input_values' | 'pool_ids' | 'sensitive_input_aliases' | 'session_id' | 'session_alias' | 'release_session_after' | 'machine_id';
+export type RunField = 'user_id' | 'organization_id' | 'error' | 'output_data' | 'input_attachment_ids' | 'output_attachment_ids' | 'run_message_history' | 'input_values' | 'pool_ids' | 'sensitive_input_aliases' | 'session_id' | 'session_alias' | 'release_session_after' | 'started_at' | 'ended_at' | 'machine_id';
 /**
  * Run response schema
  */
@@ -623,6 +623,8 @@ export type RunResponse = {
     session_alias?: string | null;
     release_session_after?: boolean | null;
     created_at: string;
+    started_at?: string | null;
+    ended_at?: string | null;
 };
 /**
  * Options for retrying an existing run in-place (same run_id).
@@ -687,6 +689,8 @@ export type RunUpdate = {
     input_values?: {
         [key: string]: unknown;
     } | null;
+    started_at?: string | null;
+    ended_at?: string | null;
 };
 /**
  * Schema for creating a trajectory

package/dist/index.d.ts

@@ -479,6 +479,9 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
         /**
          * List runs with optional filtering
          *
+         * Runs are ordered by: RUNNING (by started_at DESC) first, then all others (by ended_at DESC).
+         * This surfaces active work and recent completions.
+         *
          * @param params - Optional query parameters
          * @param params.skip - Number of items to skip (for pagination)
          * @param params.limit - Maximum number of items to return
@@ -486,7 +489,12 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
          * @param params.workflow_id - Filter by workflow ID
          * @param params.machine_id - Filter by machine ID
          * @param params.session_id - Filter by session ID
-         * @returns Paginated list of runs
+         * @param params.fields - Optional list of fields to include per run (projection). Available fields include:
+         *                        started_at, ended_at, error, output_data, input_values, and more.
+         * @returns Paginated list of runs including timing fields:
+         *          - created_at: When run was created
+         *          - started_at: When run execution started (null for SCHEDULING runs)
+         *          - ended_at: When run completed (null for RUNNING/SCHEDULING runs)
          */
         list: (params?: {
             skip?: number;
@@ -622,7 +630,10 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
          * Get a specific run by ID
          *
          * @param runId - The ID of the run
-         * @returns Run details including status, output, and attachments
+         * @returns Run details including timing information:
+         *          - created_at: When run was created
+         *          - started_at: When run execution started (null if not started)
+         *          - ended_at: When run completed (null if not finished)
          */
         get: (runId: string) => Promise<({
             data: undefined;

package/dist/index.js

@@ -469,6 +469,9 @@ function createCyberdeskClient(apiKey, baseUrl) {
             /**
              * List runs with optional filtering
              *
+             * Runs are ordered by: RUNNING (by started_at DESC) first, then all others (by ended_at DESC).
+             * This surfaces active work and recent completions.
+             *
              * @param params - Optional query parameters
              * @param params.skip - Number of items to skip (for pagination)
              * @param params.limit - Maximum number of items to return
@@ -476,7 +479,12 @@ function createCyberdeskClient(apiKey, baseUrl) {
              * @param params.workflow_id - Filter by workflow ID
              * @param params.machine_id - Filter by machine ID
              * @param params.session_id - Filter by session ID
-             * @returns Paginated list of runs
+             * @param params.fields - Optional list of fields to include per run (projection). Available fields include:
+             *                        started_at, ended_at, error, output_data, input_values, and more.
+             * @returns Paginated list of runs including timing fields:
+             *          - created_at: When run was created
+             *          - started_at: When run execution started (null for SCHEDULING runs)
+             *          - ended_at: When run completed (null for RUNNING/SCHEDULING runs)
              */
             list: (params) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d;
@@ -595,7 +603,10 @@ function createCyberdeskClient(apiKey, baseUrl) {
              * Get a specific run by ID
              *
              * @param runId - The ID of the run
-             * @returns Run details including status, output, and attachments
+             * @returns Run details including timing information:
+             *          - created_at: When run was created
+             *          - started_at: When run execution started (null if not started)
+             *          - ended_at: When run completed (null if not finished)
              */
             get: (runId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.getRunV1RunsRunIdGet)({

package/package.json

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