cyberdesk 2.2.27 → 2.2.28

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

@@ -431,6 +431,9 @@ export declare const updateRunV1RunsRunIdPatch: <ThrowOnError extends boolean =
  * - Starts a new session unless session_id is provided (then runs on existing session).
  * - Accepts shared_inputs/sensitive/file_inputs and per-step file_inputs.
  * - machine_id > pool_id when starting a new session; both ignored if session_id provided.
+ * - Client contract: once runs are persisted, failures in downstream Temporal dispatch
+ * do not change the HTTP success envelope; response still contains run_ids and those
+ * runs are transitioned to ERROR with failure metadata for deterministic polling.
  */
 export declare const createRunChainV1RunsChainPost: <ThrowOnError extends boolean = false>(options: Options<CreateRunChainV1RunsChainPostData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").WorkflowChainResponse, import("./types.gen").HttpValidationError, ThrowOnError>;
 /**

package/dist/client/sdk.gen.js

@@ -914,6 +914,9 @@ exports.updateRunV1RunsRunIdPatch = updateRunV1RunsRunIdPatch;
  * - Starts a new session unless session_id is provided (then runs on existing session).
  * - Accepts shared_inputs/sensitive/file_inputs and per-step file_inputs.
  * - machine_id > pool_id when starting a new session; both ignored if session_id provided.
+ * - Client contract: once runs are persisted, failures in downstream Temporal dispatch
+ * do not change the HTTP success envelope; response still contains run_ids and those
+ * runs are transitioned to ERROR with failure metadata for deterministic polling.
  */
 const createRunChainV1RunsChainPost = (options) => {
     var _a;

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

@@ -828,6 +828,7 @@ export type RunCreate = {
  * (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' | 'usage_metadata' | 'session_id' | 'session_alias' | 'release_session_after' | 'started_at' | 'ended_at' | 'machine_id';
+export type RunListSortMode = 'activity' | 'created_at_desc';
 /**
  * Run response schema
  */
@@ -1115,6 +1116,10 @@ export type ValidationError = {
     loc: Array<string | number>;
     msg: string;
     type: string;
+    input?: unknown;
+    ctx?: {
+        [key: string]: unknown;
+    };
 };
 /**
  * Request to create and run a multi-step chain on a single reserved session/machine
@@ -2788,6 +2793,10 @@ export type ListRunsV1RunsGetData = {
          * Filter runs created at or before this ISO timestamp (UTC)
          */
         created_at_to?: string | null;
+        /**
+         * Run sort mode. 'activity' prioritizes running/scheduling and recent completions. 'created_at_desc' returns strict reverse-chronological order.
+         */
+        sort_mode?: RunListSortMode;
         /**
          * Search runs by id, input_values, output_data, error, session_alias (case-insensitive substring match)
          */
@@ -2953,7 +2962,7 @@ export type CreateRunChainV1RunsChainPostErrors = {
 export type CreateRunChainV1RunsChainPostError = CreateRunChainV1RunsChainPostErrors[keyof CreateRunChainV1RunsChainPostErrors];
 export type CreateRunChainV1RunsChainPostResponses = {
     /**
-     * Successful Response
+     * Returns persisted run_ids for the created chain session. If Temporal dispatch fails after run persistence, this endpoint still returns 201 with run_ids; those runs are marked ERROR and include failure details in subsequent run reads.
      */
     201: WorkflowChainResponse;
 };

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 PaginatedResponseWithIncludesMachineResponse, type PaginatedResponseWithIncludesPoolResponse, type PaginatedResponseWorkflowResponse, type PaginatedResponseWithIncludesRunResponse, type PaginatedResponseConnectionResponse, type PaginatedResponseWithIncludesTrajectoryResponse, 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 IncludedResource, type PaginatedResponseRunAttachmentResponse, type RunRetry, type RunField, type ModelConfigurationCreate, type ModelConfigurationUpdate, type ModelConfigurationResponse, type UsageAggregateResponse, type UsageMode, type WorkflowTagCreate, type WorkflowTagUpdate, type WorkflowTagResponse, type WorkflowTagGroupCreate, type WorkflowTagGroupUpdate, type WorkflowTagGroupResponse, type ReorderRequest, type AddTagsRequest, type BulkAddTagsRequest } 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 PaginatedResponseWithIncludesMachineResponse, type PaginatedResponseWithIncludesPoolResponse, type PaginatedResponseWorkflowResponse, type PaginatedResponseWithIncludesRunResponse, type PaginatedResponseConnectionResponse, type PaginatedResponseWithIncludesTrajectoryResponse, 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 IncludedResource, type PaginatedResponseRunAttachmentResponse, type RunRetry, type RunField, type RunListSortMode, type ModelConfigurationCreate, type ModelConfigurationUpdate, type ModelConfigurationResponse, type UsageAggregateResponse, type UsageMode, type WorkflowTagCreate, type WorkflowTagUpdate, type WorkflowTagResponse, type WorkflowTagGroupCreate, type WorkflowTagGroupUpdate, type WorkflowTagGroupResponse, type ReorderRequest, type AddTagsRequest, type BulkAddTagsRequest } from './client/types.gen';
 export * from './client/types.gen';
 export * from './client/sdk.gen';
 export * from './client/client.gen';
@@ -1005,8 +1005,8 @@ 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.
+         * Defaults to "activity" ordering (active/scheduled runs first, then recent completions).
+         * Set `sort_mode: 'created_at_desc'` for strict reverse-chronological ordering.
          *
          * @param params - Optional query parameters
          * @param params.skip - Number of items to skip (for pagination)
@@ -1017,6 +1017,7 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string,
          * @param params.session_id - Filter by session ID
          * @param params.search - Search runs by input_values, output_data, error, session_alias (case-insensitive)
          * @param params.deep_search - If true, also search run_message_history (slower but more comprehensive)
+         * @param params.sort_mode - Sort mode: "activity" (default) or "created_at_desc"
          * @param params.fields - Optional list of fields to include per run (projection). Available fields include:
          *                        started_at, ended_at, error, output_data, input_values, usage_metadata, and more.
          * @param params.include - Optional list of related resources to include. Available: ["workflow", "machine", "machine.pools"].
@@ -1036,6 +1037,7 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string,
             session_id?: string;
             search?: string;
             deep_search?: boolean;
+            sort_mode?: RunListSortMode;
             created_at_from?: string | Date;
             created_at_to?: string | Date;
             fields?: RunField[];

package/dist/index.js

@@ -1035,8 +1035,8 @@ function createCyberdeskClient(apiKey, baseUrl, options) {
             /**
              * 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.
+             * Defaults to "activity" ordering (active/scheduled runs first, then recent completions).
+             * Set `sort_mode: 'created_at_desc'` for strict reverse-chronological ordering.
              *
              * @param params - Optional query parameters
              * @param params.skip - Number of items to skip (for pagination)
@@ -1047,6 +1047,7 @@ function createCyberdeskClient(apiKey, baseUrl, options) {
              * @param params.session_id - Filter by session ID
              * @param params.search - Search runs by input_values, output_data, error, session_alias (case-insensitive)
              * @param params.deep_search - If true, also search run_message_history (slower but more comprehensive)
+             * @param params.sort_mode - Sort mode: "activity" (default) or "created_at_desc"
              * @param params.fields - Optional list of fields to include per run (projection). Available fields include:
              *                        started_at, ended_at, error, output_data, input_values, usage_metadata, and more.
              * @param params.include - Optional list of related resources to include. Available: ["workflow", "machine", "machine.pools"].
@@ -1068,6 +1069,7 @@ function createCyberdeskClient(apiKey, baseUrl, options) {
                     session_id: (_d = params === null || params === void 0 ? void 0 : params.session_id) !== null && _d !== void 0 ? _d : undefined,
                     search: params === null || params === void 0 ? void 0 : params.search,
                     deep_search: params === null || params === void 0 ? void 0 : params.deep_search,
+                    sort_mode: params === null || params === void 0 ? void 0 : params.sort_mode,
                     created_at_from: toIsoUtc(params === null || params === void 0 ? void 0 : params.created_at_from),
                     created_at_to: toIsoUtc(params === null || params === void 0 ? void 0 : params.created_at_to),
                     fields: params === null || params === void 0 ? void 0 : params.fields,

package/package.json

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