cyberdesk 1.9.0 → 1.10.0

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, ListWorkflowsV1WorkflowsGetData, CreateWorkflowV1WorkflowsPostData, DeleteWorkflowV1WorkflowsWorkflowIdDeleteData, GetWorkflowV1WorkflowsWorkflowIdGetData, UpdateWorkflowV1WorkflowsWorkflowIdPatchData, GetWorkflowVersionsV1WorkflowsWorkflowIdVersionsGetData, ListRunsV1RunsGetData, CreateRunV1RunsPostData, DeleteRunV1RunsRunIdDeleteData, GetRunV1RunsRunIdGetData, UpdateRunV1RunsRunIdPatchData, ListRunAttachmentsV1RunAttachmentsGetData, CreateRunAttachmentV1RunAttachmentsPostData, DeleteRunAttachmentV1RunAttachmentsAttachmentIdDeleteData, GetRunAttachmentV1RunAttachmentsAttachmentIdGetData, UpdateRunAttachmentV1RunAttachmentsAttachmentIdPutData, DownloadRunAttachmentV1RunAttachmentsAttachmentIdDownloadGetData, ListConnectionsV1ConnectionsGetData, CreateConnectionV1ConnectionsPostData, DeleteConnectionV1ConnectionsConnectionIdDeleteData, GetConnectionV1ConnectionsConnectionIdGetData, UpdateConnectionV1ConnectionsConnectionIdPatchData, ListRequestLogsV1RequestLogsGetData, CreateRequestLogV1RequestLogsPostData, DeleteRequestLogV1RequestLogsLogIdDeleteData, GetRequestLogV1RequestLogsLogIdGetData, UpdateRequestLogV1RequestLogsLogIdPatchData, ListTrajectoriesV1TrajectoriesGetData, CreateTrajectoryV1TrajectoriesPostData, DeleteTrajectoryV1TrajectoriesTrajectoryIdDeleteData, GetTrajectoryV1TrajectoriesTrajectoryIdGetData, UpdateTrajectoryV1TrajectoriesTrajectoryIdPatchData, GetLatestTrajectoryForWorkflowV1WorkflowsWorkflowIdLatestTrajectoryGetData, GetScreenshotV1ComputerMachineIdDisplayScreenshotGetData, GetDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGetData, KeyboardTypeV1ComputerMachineIdInputKeyboardTypePostData, KeyboardKeyV1ComputerMachineIdInputKeyboardKeyPostData, GetMousePositionV1ComputerMachineIdInputMousePositionGetData, MouseMoveV1ComputerMachineIdInputMouseMovePostData, MouseClickV1ComputerMachineIdInputMouseClickPostData, FsListV1ComputerMachineIdFsListGetData, FsReadV1ComputerMachineIdFsReadGetData, FsWriteV1ComputerMachineIdFsWritePostData, PowershellExecV1ComputerMachineIdShellPowershellExecPostData, PowershellSessionV1ComputerMachineIdShellPowershellSessionPostData, DummyTestEndpointV1TestPostData, RootGetData } from './types.gen';
+import type { HealthCheckV1HealthGetData, DatabaseHealthCheckV1HealthDbGetData, ListMachinesV1MachinesGetData, CreateMachineV1MachinesPostData, DeleteMachineV1MachinesMachineIdDeleteData, GetMachineV1MachinesMachineIdGetData, UpdateMachineV1MachinesMachineIdPatchData, ListWorkflowsV1WorkflowsGetData, CreateWorkflowV1WorkflowsPostData, DeleteWorkflowV1WorkflowsWorkflowIdDeleteData, GetWorkflowV1WorkflowsWorkflowIdGetData, UpdateWorkflowV1WorkflowsWorkflowIdPatchData, GetWorkflowVersionsV1WorkflowsWorkflowIdVersionsGetData, ListRunsV1RunsGetData, CreateRunV1RunsPostData, DeleteRunV1RunsRunIdDeleteData, GetRunV1RunsRunIdGetData, UpdateRunV1RunsRunIdPatchData, 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, GetMousePositionV1ComputerMachineIdInputMousePositionGetData, MouseMoveV1ComputerMachineIdInputMouseMovePostData, MouseClickV1ComputerMachineIdInputMouseClickPostData, FsListV1ComputerMachineIdFsListGetData, FsReadV1ComputerMachineIdFsReadGetData, FsWriteV1ComputerMachineIdFsWritePostData, PowershellExecV1ComputerMachineIdShellPowershellExecPostData, PowershellSessionV1ComputerMachineIdShellPowershellSessionPostData, DummyTestEndpointV1TestPostData, RootGetData } 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
@@ -193,11 +193,22 @@ export declare const getRunAttachmentV1RunAttachmentsAttachmentIdGet: <ThrowOnEr
  * Currently only supports updating the expiration date.
  */
 export declare const updateRunAttachmentV1RunAttachmentsAttachmentIdPut: <ThrowOnError extends boolean = false>(options: Options<UpdateRunAttachmentV1RunAttachmentsAttachmentIdPutData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").RunAttachmentResponse, import("./types.gen").HttpValidationError, ThrowOnError>;
+/**
+ * Get Run Attachment Download Url
+ * Get a signed download URL for a run attachment file.
+ *
+ * Returns a signed URL that triggers automatic download when accessed.
+ *
+ * Args:
+ * attachment_id: The ID of the attachment to download
+ * expires_in: URL expiration time in seconds (10-3600). Default: 300 (5 minutes)
+ */
+export declare const getRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGet: <ThrowOnError extends boolean = false>(options: Options<GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").RunAttachmentDownloadUrlResponse, import("./types.gen").HttpValidationError, ThrowOnError>;
 /**
  * Download Run Attachment
  * Download a run attachment file.
  *
- * Returns the file content as a streaming response.
+ * Returns the raw file content as a streaming response.
  */
 export declare const downloadRunAttachmentV1RunAttachmentsAttachmentIdDownloadGet: <ThrowOnError extends boolean = false>(options: Options<DownloadRunAttachmentV1RunAttachmentsAttachmentIdDownloadGetData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<unknown, import("./types.gen").HttpValidationError, ThrowOnError>;
 /**

package/dist/client/sdk.gen.js

@@ -1,8 +1,8 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fsWriteV1ComputerMachineIdFsWritePost = exports.fsReadV1ComputerMachineIdFsReadGet = exports.fsListV1ComputerMachineIdFsListGet = exports.mouseClickV1ComputerMachineIdInputMouseClickPost = exports.mouseMoveV1ComputerMachineIdInputMouseMovePost = exports.getMousePositionV1ComputerMachineIdInputMousePositionGet = exports.keyboardKeyV1ComputerMachineIdInputKeyboardKeyPost = exports.keyboardTypeV1ComputerMachineIdInputKeyboardTypePost = exports.getDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGet = exports.getScreenshotV1ComputerMachineIdDisplayScreenshotGet = exports.getLatestTrajectoryForWorkflowV1WorkflowsWorkflowIdLatestTrajectoryGet = exports.updateTrajectoryV1TrajectoriesTrajectoryIdPatch = exports.getTrajectoryV1TrajectoriesTrajectoryIdGet = 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.updateRunAttachmentV1RunAttachmentsAttachmentIdPut = exports.getRunAttachmentV1RunAttachmentsAttachmentIdGet = exports.deleteRunAttachmentV1RunAttachmentsAttachmentIdDelete = exports.createRunAttachmentV1RunAttachmentsPost = exports.listRunAttachmentsV1RunAttachmentsGet = exports.updateRunV1RunsRunIdPatch = exports.getRunV1RunsRunIdGet = exports.deleteRunV1RunsRunIdDelete = exports.createRunV1RunsPost = exports.listRunsV1RunsGet = exports.getWorkflowVersionsV1WorkflowsWorkflowIdVersionsGet = exports.updateWorkflowV1WorkflowsWorkflowIdPatch = exports.getWorkflowV1WorkflowsWorkflowIdGet = exports.deleteWorkflowV1WorkflowsWorkflowIdDelete = exports.createWorkflowV1WorkflowsPost = exports.listWorkflowsV1WorkflowsGet = exports.updateMachineV1MachinesMachineIdPatch = exports.getMachineV1MachinesMachineIdGet = exports.deleteMachineV1MachinesMachineIdDelete = exports.createMachineV1MachinesPost = exports.listMachinesV1MachinesGet = exports.databaseHealthCheckV1HealthDbGet = exports.healthCheckV1HealthGet = void 0;
-exports.rootGet = exports.dummyTestEndpointV1TestPost = exports.powershellSessionV1ComputerMachineIdShellPowershellSessionPost = exports.powershellExecV1ComputerMachineIdShellPowershellExecPost = void 0;
+exports.fsReadV1ComputerMachineIdFsReadGet = exports.fsListV1ComputerMachineIdFsListGet = exports.mouseClickV1ComputerMachineIdInputMouseClickPost = exports.mouseMoveV1ComputerMachineIdInputMouseMovePost = exports.getMousePositionV1ComputerMachineIdInputMousePositionGet = exports.keyboardKeyV1ComputerMachineIdInputKeyboardKeyPost = exports.keyboardTypeV1ComputerMachineIdInputKeyboardTypePost = exports.getDisplayDimensionsV1ComputerMachineIdDisplayDimensionsGet = exports.getScreenshotV1ComputerMachineIdDisplayScreenshotGet = exports.getLatestTrajectoryForWorkflowV1WorkflowsWorkflowIdLatestTrajectoryGet = exports.updateTrajectoryV1TrajectoriesTrajectoryIdPatch = exports.getTrajectoryV1TrajectoriesTrajectoryIdGet = 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.updateRunV1RunsRunIdPatch = exports.getRunV1RunsRunIdGet = exports.deleteRunV1RunsRunIdDelete = exports.createRunV1RunsPost = exports.listRunsV1RunsGet = exports.getWorkflowVersionsV1WorkflowsWorkflowIdVersionsGet = exports.updateWorkflowV1WorkflowsWorkflowIdPatch = exports.getWorkflowV1WorkflowsWorkflowIdGet = exports.deleteWorkflowV1WorkflowsWorkflowIdDelete = exports.createWorkflowV1WorkflowsPost = exports.listWorkflowsV1WorkflowsGet = exports.updateMachineV1MachinesMachineIdPatch = exports.getMachineV1MachinesMachineIdGet = exports.deleteMachineV1MachinesMachineIdDelete = exports.createMachineV1MachinesPost = exports.listMachinesV1MachinesGet = exports.databaseHealthCheckV1HealthDbGet = exports.healthCheckV1HealthGet = void 0;
+exports.rootGet = exports.dummyTestEndpointV1TestPost = exports.powershellSessionV1ComputerMachineIdShellPowershellSessionPost = exports.powershellExecV1ComputerMachineIdShellPowershellExecPost = exports.fsWriteV1ComputerMachineIdFsWritePost = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * Health Check
@@ -375,11 +375,31 @@ const updateRunAttachmentV1RunAttachmentsAttachmentIdPut = (options) => {
         ], url: '/v1/run-attachments/{attachment_id}' }, options), { headers: Object.assign({ 'Content-Type': 'application/json' }, options === null || options === void 0 ? void 0 : options.headers) }));
 };
 exports.updateRunAttachmentV1RunAttachmentsAttachmentIdPut = updateRunAttachmentV1RunAttachmentsAttachmentIdPut;
+/**
+ * Get Run Attachment Download Url
+ * Get a signed download URL for a run attachment file.
+ *
+ * Returns a signed URL that triggers automatic download when accessed.
+ *
+ * Args:
+ * attachment_id: The ID of the attachment to download
+ * expires_in: URL expiration time in seconds (10-3600). Default: 300 (5 minutes)
+ */
+const getRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGet = (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/run-attachments/{attachment_id}/download-url' }, options));
+};
+exports.getRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGet = getRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGet;
 /**
  * Download Run Attachment
  * Download a run attachment file.
  *
- * Returns the file content as a streaming response.
+ * Returns the raw file content as a streaming response.
  */
 const downloadRunAttachmentV1RunAttachmentsAttachmentIdDownloadGet = (options) => {
     var _a;

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

@@ -256,6 +256,19 @@ export type RunAttachmentCreate = {
     cleanup_imports_after_run?: boolean;
     expires_at?: string | null;
 };
+/**
+ * Response schema for run attachment download URL
+ */
+export type RunAttachmentDownloadUrlResponse = {
+    /**
+     * Signed URL for downloading the attachment
+     */
+    url: string;
+    /**
+     * Seconds until the URL expires
+     */
+    expires_in: number;
+};
 /**
  * Run attachment response schema
  */
@@ -966,6 +979,33 @@ export type UpdateRunAttachmentV1RunAttachmentsAttachmentIdPutResponses = {
     200: RunAttachmentResponse;
 };
 export type UpdateRunAttachmentV1RunAttachmentsAttachmentIdPutResponse = UpdateRunAttachmentV1RunAttachmentsAttachmentIdPutResponses[keyof UpdateRunAttachmentV1RunAttachmentsAttachmentIdPutResponses];
+export type GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetData = {
+    body?: never;
+    path: {
+        attachment_id: string;
+    };
+    query?: {
+        /**
+         * URL expiration time in seconds (10-3600)
+         */
+        expires_in?: number;
+    };
+    url: '/v1/run-attachments/{attachment_id}/download-url';
+};
+export type GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetErrors = {
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetError = GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetErrors[keyof GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetErrors];
+export type GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: RunAttachmentDownloadUrlResponse;
+};
+export type GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetResponse = GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetResponses[keyof GetRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGetResponses];
 export type DownloadRunAttachmentV1RunAttachmentsAttachmentIdDownloadGetData = {
     body?: never;
     path: {

package/dist/index.d.ts

@@ -1,9 +1,58 @@
-import { type MachineResponse, type WorkflowResponse, type RunResponse, type ConnectionResponse, type TrajectoryResponse, type PaginatedResponseMachineResponse, type PaginatedResponseWorkflowResponse, type PaginatedResponseRunResponse, type PaginatedResponseConnectionResponse, type PaginatedResponseTrajectoryResponse, type MachineStatus, type RunStatus, type ConnectionStatus, type MachineCreate, type WorkflowCreate, type RunCreate, type FileInput, type ConnectionCreate, type TrajectoryCreate, type MachineUpdate, type WorkflowUpdate, type RunUpdate, type TrajectoryUpdate, type RunAttachmentCreate, type RunAttachmentUpdate, type RunAttachmentResponse, type AttachmentType, type PaginatedResponseRunAttachmentResponse } from './client/types.gen';
+/**
+ * @fileoverview Cyberdesk TypeScript SDK
+ *
+ * A comprehensive SDK for interacting with the Cyberdesk Cloud API.
+ * Provides typed methods for managing machines, workflows, runs, and more.
+ *
+ * @module cyberdesk
+ * @example
+ * ```typescript
+ * import { createCyberdeskClient } from 'cyberdesk';
+ *
+ * const client = createCyberdeskClient('your-api-key');
+ *
+ * // List machines
+ * const { data: machines } = await client.machines.list();
+ *
+ * // Create and run a workflow
+ * const { data: workflow } = await client.workflows.create({
+ *   name: 'My Workflow',
+ *   main_prompt: 'Perform this task...'
+ * });
+ *
+ * const { data: run } = await client.runs.create({
+ *   workflow_id: workflow.id
+ * });
+ * ```
+ */
+import { type MachineResponse, type WorkflowResponse, type RunResponse, type ConnectionResponse, type TrajectoryResponse, type PaginatedResponseMachineResponse, type PaginatedResponseWorkflowResponse, type PaginatedResponseRunResponse, type PaginatedResponseConnectionResponse, type PaginatedResponseTrajectoryResponse, type MachineStatus, type RunStatus, type ConnectionStatus, type MachineCreate, type WorkflowCreate, type RunCreate, 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 } from './client/types.gen';
 export * from './client/types.gen';
 export * from './client/sdk.gen';
 export * from './client/client.gen';
+/**
+ * Create a Cyberdesk API client
+ *
+ * @param apiKey - Your Cyberdesk API key
+ * @param baseUrl - Optional API base URL (defaults to https://api.cyberdesk.io)
+ * @returns Configured client with all API endpoints
+ *
+ * @example
+ * ```typescript
+ * const client = createCyberdeskClient('your-api-key');
+ * const machines = await client.machines.list();
+ * ```
+ */
 export declare function createCyberdeskClient(apiKey: string, baseUrl?: string): {
     machines: {
+        /**
+         * List machines with optional filtering
+         *
+         * @param params - Optional query parameters
+         * @param params.skip - Number of items to skip (for pagination)
+         * @param params.limit - Maximum number of items to return
+         * @param params.status - Filter by machine status
+         * @returns Paginated list of machines
+         */
         list: (params?: {
             skip?: number;
             limit?: number;
@@ -12,18 +61,42 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
             data?: PaginatedResponseMachineResponse;
             error?: any;
         }>;
+        /**
+         * Create a new machine
+         *
+         * @param data - Machine configuration
+         * @returns Created machine details
+         */
         create: (data: MachineCreate) => Promise<{
             data?: MachineResponse;
             error?: any;
         }>;
+        /**
+         * Get a specific machine by ID
+         *
+         * @param machineId - The ID of the machine
+         * @returns Machine details
+         */
         get: (machineId: string) => Promise<{
             data?: MachineResponse;
             error?: any;
         }>;
+        /**
+         * Update a machine
+         *
+         * @param machineId - The ID of the machine to update
+         * @param data - Update data (name, status, availability, etc.)
+         * @returns Updated machine details
+         */
         update: (machineId: string, data: MachineUpdate) => Promise<{
             data?: MachineResponse;
             error?: any;
         }>;
+        /**
+         * Delete a machine
+         *
+         * @param machineId - The ID of the machine to delete
+         */
         delete: (machineId: string) => Promise<({
             data: undefined;
             error: import("./client/types.gen").HttpValidationError;
@@ -36,6 +109,14 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
         }>;
     };
     workflows: {
+        /**
+         * List workflows
+         *
+         * @param params - Optional query parameters
+         * @param params.skip - Number of items to skip (for pagination)
+         * @param params.limit - Maximum number of items to return
+         * @returns Paginated list of workflows
+         */
         list: (params?: {
             skip?: number;
             limit?: number;
@@ -43,18 +124,51 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
             data?: PaginatedResponseWorkflowResponse;
             error?: any;
         }>;
+        /**
+         * Create a new workflow
+         *
+         * @param data - Workflow configuration including name and main prompt
+         * @returns Created workflow details
+         *
+         * @example
+         * ```typescript
+         * const workflow = await client.workflows.create({
+         *   name: 'My Workflow',
+         *   main_prompt: 'Perform this task...',
+         *   includes_file_exports: true
+         * });
+         * ```
+         */
         create: (data: WorkflowCreate) => Promise<{
             data?: WorkflowResponse;
             error?: any;
         }>;
+        /**
+         * Get a specific workflow by ID
+         *
+         * @param workflowId - The ID of the workflow
+         * @returns Workflow details
+         */
         get: (workflowId: string) => Promise<{
             data?: WorkflowResponse;
             error?: any;
         }>;
+        /**
+         * Update a workflow
+         *
+         * @param workflowId - The ID of the workflow to update
+         * @param data - Update data (name, main_prompt, output_schema, etc.)
+         * @returns Updated workflow details
+         */
         update: (workflowId: string, data: WorkflowUpdate) => Promise<{
             data?: WorkflowResponse;
             error?: any;
         }>;
+        /**
+         * Delete a workflow
+         *
+         * @param workflowId - The ID of the workflow to delete
+         */
         delete: (workflowId: string) => Promise<({
             data: undefined;
             error: import("./client/types.gen").HttpValidationError;
@@ -67,6 +181,17 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
         }>;
     };
     runs: {
+        /**
+         * List runs with optional filtering
+         *
+         * @param params - Optional query parameters
+         * @param params.skip - Number of items to skip (for pagination)
+         * @param params.limit - Maximum number of items to return
+         * @param params.status - Filter by run status (scheduling, running, success, cancelled, error)
+         * @param params.workflow_id - Filter by workflow ID
+         * @param params.machine_id - Filter by machine ID
+         * @returns Paginated list of runs
+         */
         list: (params?: {
             skip?: number;
             limit?: number;
@@ -77,18 +202,60 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
             data?: PaginatedResponseRunResponse;
             error?: any;
         }>;
+        /**
+         * Create a new run
+         *
+         * @param data - Run configuration
+         * @param data.workflow_id - The workflow to run
+         * @param data.machine_id - Optional machine ID (auto-selected if not provided)
+         * @param data.input_values - Optional input values for workflow variables
+         * @param data.file_inputs - Optional files to upload to the machine
+         * @returns Created run details
+         *
+         * @example
+         * ```typescript
+         * const run = await client.runs.create({
+         *   workflow_id: 'workflow-id',
+         *   input_values: { prompt: 'Hello' },
+         *   file_inputs: [{
+         *     filename: 'data.txt',
+         *     content: 'base64-encoded-content',
+         *     target_path: '~/CyberdeskTransfers/',
+         *     cleanup_imports_after_run: true
+         *   }]
+         * });
+         * ```
+         */
         create: (data: RunCreate) => Promise<{
             data?: RunResponse;
             error?: any;
         }>;
+        /**
+         * Get a specific run by ID
+         *
+         * @param runId - The ID of the run
+         * @returns Run details including status, output, and attachments
+         */
         get: (runId: string) => Promise<{
             data?: RunResponse;
             error?: any;
         }>;
+        /**
+         * Update a run
+         *
+         * @param runId - The ID of the run to update
+         * @param data - Update data (status, output_data, error messages, etc.)
+         * @returns Updated run details
+         */
         update: (runId: string, data: RunUpdate) => Promise<{
             data?: RunResponse;
             error?: any;
         }>;
+        /**
+         * Delete a run
+         *
+         * @param runId - The ID of the run to delete
+         */
         delete: (runId: string) => Promise<({
             data: undefined;
             error: import("./client/types.gen").HttpValidationError;
@@ -101,6 +268,16 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
         }>;
     };
     connections: {
+        /**
+         * List connections with optional filtering
+         *
+         * @param params - Optional query parameters
+         * @param params.skip - Number of items to skip (for pagination)
+         * @param params.limit - Maximum number of items to return
+         * @param params.machine_id - Filter by machine ID
+         * @param params.status - Filter by connection status
+         * @returns Paginated list of connections
+         */
         list: (params?: {
             skip?: number;
             limit?: number;
@@ -110,12 +287,27 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
             data?: PaginatedResponseConnectionResponse;
             error?: any;
         }>;
+        /**
+         * Create a new connection
+         *
+         * @param data - Connection data including machine ID and websocket info
+         * @returns Created connection details
+         */
         create: (data: ConnectionCreate) => Promise<{
             data?: ConnectionResponse;
             error?: any;
         }>;
     };
     trajectories: {
+        /**
+         * List trajectories with optional filtering
+         *
+         * @param params - Optional query parameters
+         * @param params.skip - Number of items to skip (for pagination)
+         * @param params.limit - Maximum number of items to return
+         * @param params.workflow_id - Filter by workflow ID
+         * @returns Paginated list of trajectories
+         */
         list: (params?: {
             skip?: number;
             limit?: number;
@@ -124,18 +316,48 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
             data?: PaginatedResponseTrajectoryResponse;
             error?: any;
         }>;
+        /**
+         * Create a new trajectory
+         *
+         * A trajectory represents a recorded sequence of actions for a workflow.
+         *
+         * @param data - Trajectory data
+         * @param data.workflow_id - The workflow this trajectory belongs to
+         * @param data.trajectory_data - Array of recorded actions
+         * @param data.dimensions - Display dimensions when trajectory was recorded
+         * @param data.original_input_values - Input values used during recording
+         * @returns Created trajectory details
+         */
         create: (data: TrajectoryCreate) => Promise<{
             data?: TrajectoryResponse;
             error?: any;
         }>;
+        /**
+         * Get a specific trajectory by ID
+         *
+         * @param trajectoryId - The ID of the trajectory
+         * @returns Trajectory details including recorded actions
+         */
         get: (trajectoryId: string) => Promise<{
             data?: TrajectoryResponse;
             error?: any;
         }>;
+        /**
+         * Update a trajectory
+         *
+         * @param trajectoryId - The ID of the trajectory to update
+         * @param data - Update data (trajectory_data)
+         * @returns Updated trajectory details
+         */
         update: (trajectoryId: string, data: TrajectoryUpdate) => Promise<{
             data?: TrajectoryResponse;
             error?: any;
         }>;
+        /**
+         * Delete a trajectory
+         *
+         * @param trajectoryId - The ID of the trajectory to delete
+         */
         delete: (trajectoryId: string) => Promise<({
             data: undefined;
             error: import("./client/types.gen").HttpValidationError;
@@ -146,12 +368,31 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
             request: Request;
             response: Response;
         }>;
+        /**
+         * Get the latest trajectory for a workflow
+         *
+         * Returns the most recently created trajectory for the specified workflow.
+         * Useful for replaying the latest recorded actions.
+         *
+         * @param workflowId - The ID of the workflow
+         * @returns Latest trajectory for the workflow, or null if none exists
+         */
         getLatestForWorkflow: (workflowId: string) => Promise<{
             data?: TrajectoryResponse;
             error?: any;
         }>;
     };
     run_attachments: {
+        /**
+         * List run attachments with optional filtering
+         *
+         * @param params - Optional query parameters
+         * @param params.skip - Number of items to skip (for pagination)
+         * @param params.limit - Maximum number of items to return
+         * @param params.run_id - Filter by run ID
+         * @param params.attachment_type - Filter by attachment type (input/output)
+         * @returns Paginated list of run attachments
+         */
         list: (params?: {
             skip?: number;
             limit?: number;
@@ -161,22 +402,86 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
             data?: PaginatedResponseRunAttachmentResponse;
             error?: any;
         }>;
+        /**
+         * Create a new run attachment
+         *
+         * @param data - Attachment data including file content as base64
+         * @returns Created attachment details
+         */
         create: (data: RunAttachmentCreate) => Promise<{
             data?: RunAttachmentResponse;
             error?: any;
         }>;
+        /**
+         * Get run attachment details
+         *
+         * @param attachmentId - The ID of the attachment
+         * @returns Attachment metadata
+         */
         get: (attachmentId: string) => Promise<{
             data?: RunAttachmentResponse;
             error?: any;
         }>;
+        /**
+         * Get a signed download URL for a run attachment
+         *
+         * The returned URL will trigger an automatic download when accessed in a browser.
+         *
+         * @param attachmentId - The ID of the attachment
+         * @param expiresIn - URL expiration time in seconds (10-3600). Default: 300 (5 minutes)
+         * @returns Object containing the signed URL and expiration time
+         *
+         * @example
+         * ```typescript
+         * const { data } = await client.run_attachments.getDownloadUrl('attachment-id', 600);
+         * if (data) {
+         *   console.log(`Download URL: ${data.url}`);
+         *   console.log(`Expires in: ${data.expires_in} seconds`);
+         * }
+         * ```
+         */
+        getDownloadUrl: (attachmentId: string, expiresIn?: number) => Promise<{
+            data?: RunAttachmentDownloadUrlResponse;
+            error?: any;
+        }>;
+        /**
+         * Download a run attachment file directly
+         *
+         * This method returns the raw file content. For a download URL instead,
+         * use `getDownloadUrl()`.
+         *
+         * @param attachmentId - The ID of the attachment to download
+         * @returns Raw file data
+         *
+         * @example
+         * ```typescript
+         * const { data } = await client.run_attachments.download('attachment-id');
+         * if (data) {
+         *   // Handle raw file bytes
+         *   const blob = new Blob([data]);
+         * }
+         * ```
+         */
         download: (attachmentId: string) => Promise<{
             data?: any;
             error?: any;
         }>;
+        /**
+         * Update a run attachment (e.g., set expiration)
+         *
+         * @param attachmentId - The ID of the attachment to update
+         * @param data - Update data
+         * @returns Updated attachment details
+         */
         update: (attachmentId: string, data: RunAttachmentUpdate) => Promise<{
             data?: RunAttachmentResponse;
             error?: any;
         }>;
+        /**
+         * Delete a run attachment
+         *
+         * @param attachmentId - The ID of the attachment to delete
+         */
         delete: (attachmentId: string) => Promise<({
             data: undefined;
             error: import("./client/types.gen").HttpValidationError;
@@ -189,4 +494,4 @@ export declare function createCyberdeskClient(apiKey: string, baseUrl?: string):
         }>;
     };
 };
-export type { MachineResponse, WorkflowResponse, RunResponse, ConnectionResponse, TrajectoryResponse, RunAttachmentResponse, FileInput, AttachmentType, PaginatedResponseMachineResponse, PaginatedResponseWorkflowResponse, PaginatedResponseRunResponse, PaginatedResponseConnectionResponse, PaginatedResponseTrajectoryResponse, PaginatedResponseRunAttachmentResponse, };
+export type { MachineResponse, WorkflowResponse, RunResponse, ConnectionResponse, TrajectoryResponse, RunAttachmentResponse, RunAttachmentDownloadUrlResponse, FileInput, AttachmentType, PaginatedResponseMachineResponse, PaginatedResponseWorkflowResponse, PaginatedResponseRunResponse, PaginatedResponseConnectionResponse, PaginatedResponseTrajectoryResponse, PaginatedResponseRunAttachmentResponse, };

package/dist/index.js

@@ -1,4 +1,31 @@
 "use strict";
+/**
+ * @fileoverview Cyberdesk TypeScript SDK
+ *
+ * A comprehensive SDK for interacting with the Cyberdesk Cloud API.
+ * Provides typed methods for managing machines, workflows, runs, and more.
+ *
+ * @module cyberdesk
+ * @example
+ * ```typescript
+ * import { createCyberdeskClient } from 'cyberdesk';
+ *
+ * const client = createCyberdeskClient('your-api-key');
+ *
+ * // List machines
+ * const { data: machines } = await client.machines.list();
+ *
+ * // Create and run a workflow
+ * const { data: workflow } = await client.workflows.create({
+ *   name: 'My Workflow',
+ *   main_prompt: 'Perform this task...'
+ * });
+ *
+ * const { data: run } = await client.runs.create({
+ *   workflow_id: workflow.id
+ * });
+ * ```
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -32,8 +59,16 @@ __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 configured client with API key and connection reuse
+/**
+ * Create a configured HTTP client with authentication
+ *
+ * @internal
+ * @param apiKey - Your Cyberdesk API key
+ * @param baseUrl - API base URL
+ * @returns Configured HTTP client
+ */
 function createApiClient(apiKey, baseUrl = DEFAULT_API_BASE_URL) {
     return (0, client_fetch_1.createClient)({
         baseUrl,
@@ -44,30 +79,70 @@ function createApiClient(apiKey, baseUrl = DEFAULT_API_BASE_URL) {
         },
     });
 }
-// Create API client with your API key
+/**
+ * Create a Cyberdesk API client
+ *
+ * @param apiKey - Your Cyberdesk API key
+ * @param baseUrl - Optional API base URL (defaults to https://api.cyberdesk.io)
+ * @returns Configured client with all API endpoints
+ *
+ * @example
+ * ```typescript
+ * const client = createCyberdeskClient('your-api-key');
+ * const machines = await client.machines.list();
+ * ```
+ */
 function createCyberdeskClient(apiKey, baseUrl) {
     const client = createApiClient(apiKey, baseUrl);
     return {
         // Machine endpoints
         machines: {
+            /**
+             * List machines with optional filtering
+             *
+             * @param params - Optional query parameters
+             * @param params.skip - Number of items to skip (for pagination)
+             * @param params.limit - Maximum number of items to return
+             * @param params.status - Filter by machine status
+             * @returns Paginated list of machines
+             */
             list: (params) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.listMachinesV1MachinesGet)({
                     client,
                     query: params,
                 });
             }),
+            /**
+             * Create a new machine
+             *
+             * @param data - Machine configuration
+             * @returns Created machine details
+             */
             create: (data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.createMachineV1MachinesPost)({
                     client,
                     body: data,
                 });
             }),
+            /**
+             * Get a specific machine by ID
+             *
+             * @param machineId - The ID of the machine
+             * @returns Machine details
+             */
             get: (machineId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.getMachineV1MachinesMachineIdGet)({
                     client,
                     path: { machine_id: machineId },
                 });
             }),
+            /**
+             * Update a machine
+             *
+             * @param machineId - The ID of the machine to update
+             * @param data - Update data (name, status, availability, etc.)
+             * @returns Updated machine details
+             */
             update: (machineId, data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.updateMachineV1MachinesMachineIdPatch)({
                     client,
@@ -75,6 +150,11 @@ function createCyberdeskClient(apiKey, baseUrl) {
                     body: data,
                 });
             }),
+            /**
+             * Delete a machine
+             *
+             * @param machineId - The ID of the machine to delete
+             */
             delete: (machineId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.deleteMachineV1MachinesMachineIdDelete)({
                     client,
@@ -84,24 +164,60 @@ function createCyberdeskClient(apiKey, baseUrl) {
         },
         // Workflow endpoints
         workflows: {
+            /**
+             * List workflows
+             *
+             * @param params - Optional query parameters
+             * @param params.skip - Number of items to skip (for pagination)
+             * @param params.limit - Maximum number of items to return
+             * @returns Paginated list of workflows
+             */
             list: (params) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.listWorkflowsV1WorkflowsGet)({
                     client,
                     query: params,
                 });
             }),
+            /**
+             * Create a new workflow
+             *
+             * @param data - Workflow configuration including name and main prompt
+             * @returns Created workflow details
+             *
+             * @example
+             * ```typescript
+             * const workflow = await client.workflows.create({
+             *   name: 'My Workflow',
+             *   main_prompt: 'Perform this task...',
+             *   includes_file_exports: true
+             * });
+             * ```
+             */
             create: (data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.createWorkflowV1WorkflowsPost)({
                     client,
                     body: data,
                 });
             }),
+            /**
+             * Get a specific workflow by ID
+             *
+             * @param workflowId - The ID of the workflow
+             * @returns Workflow details
+             */
             get: (workflowId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.getWorkflowV1WorkflowsWorkflowIdGet)({
                     client,
                     path: { workflow_id: workflowId },
                 });
             }),
+            /**
+             * Update a workflow
+             *
+             * @param workflowId - The ID of the workflow to update
+             * @param data - Update data (name, main_prompt, output_schema, etc.)
+             * @returns Updated workflow details
+             */
             update: (workflowId, data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.updateWorkflowV1WorkflowsWorkflowIdPatch)({
                     client,
@@ -109,6 +225,11 @@ function createCyberdeskClient(apiKey, baseUrl) {
                     body: data,
                 });
             }),
+            /**
+             * Delete a workflow
+             *
+             * @param workflowId - The ID of the workflow to delete
+             */
             delete: (workflowId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.deleteWorkflowV1WorkflowsWorkflowIdDelete)({
                     client,
@@ -118,24 +239,72 @@ function createCyberdeskClient(apiKey, baseUrl) {
         },
         // Run endpoints
         runs: {
+            /**
+             * List runs with optional filtering
+             *
+             * @param params - Optional query parameters
+             * @param params.skip - Number of items to skip (for pagination)
+             * @param params.limit - Maximum number of items to return
+             * @param params.status - Filter by run status (scheduling, running, success, cancelled, error)
+             * @param params.workflow_id - Filter by workflow ID
+             * @param params.machine_id - Filter by machine ID
+             * @returns Paginated list of runs
+             */
             list: (params) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.listRunsV1RunsGet)({
                     client,
                     query: params,
                 });
             }),
+            /**
+             * Create a new run
+             *
+             * @param data - Run configuration
+             * @param data.workflow_id - The workflow to run
+             * @param data.machine_id - Optional machine ID (auto-selected if not provided)
+             * @param data.input_values - Optional input values for workflow variables
+             * @param data.file_inputs - Optional files to upload to the machine
+             * @returns Created run details
+             *
+             * @example
+             * ```typescript
+             * const run = await client.runs.create({
+             *   workflow_id: 'workflow-id',
+             *   input_values: { prompt: 'Hello' },
+             *   file_inputs: [{
+             *     filename: 'data.txt',
+             *     content: 'base64-encoded-content',
+             *     target_path: '~/CyberdeskTransfers/',
+             *     cleanup_imports_after_run: true
+             *   }]
+             * });
+             * ```
+             */
             create: (data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.createRunV1RunsPost)({
                     client,
                     body: data,
                 });
             }),
+            /**
+             * Get a specific run by ID
+             *
+             * @param runId - The ID of the run
+             * @returns Run details including status, output, and attachments
+             */
             get: (runId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.getRunV1RunsRunIdGet)({
                     client,
                     path: { run_id: runId },
                 });
             }),
+            /**
+             * Update a run
+             *
+             * @param runId - The ID of the run to update
+             * @param data - Update data (status, output_data, error messages, etc.)
+             * @returns Updated run details
+             */
             update: (runId, data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.updateRunV1RunsRunIdPatch)({
                     client,
@@ -143,6 +312,11 @@ function createCyberdeskClient(apiKey, baseUrl) {
                     body: data,
                 });
             }),
+            /**
+             * Delete a run
+             *
+             * @param runId - The ID of the run to delete
+             */
             delete: (runId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.deleteRunV1RunsRunIdDelete)({
                     client,
@@ -152,12 +326,28 @@ function createCyberdeskClient(apiKey, baseUrl) {
         },
         // Connection endpoints
         connections: {
+            /**
+             * List connections with optional filtering
+             *
+             * @param params - Optional query parameters
+             * @param params.skip - Number of items to skip (for pagination)
+             * @param params.limit - Maximum number of items to return
+             * @param params.machine_id - Filter by machine ID
+             * @param params.status - Filter by connection status
+             * @returns Paginated list of connections
+             */
             list: (params) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.listConnectionsV1ConnectionsGet)({
                     client,
                     query: params,
                 });
             }),
+            /**
+             * Create a new connection
+             *
+             * @param data - Connection data including machine ID and websocket info
+             * @returns Created connection details
+             */
             create: (data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.createConnectionV1ConnectionsPost)({
                     client,
@@ -167,24 +357,58 @@ function createCyberdeskClient(apiKey, baseUrl) {
         },
         // Trajectory endpoints
         trajectories: {
+            /**
+             * List trajectories with optional filtering
+             *
+             * @param params - Optional query parameters
+             * @param params.skip - Number of items to skip (for pagination)
+             * @param params.limit - Maximum number of items to return
+             * @param params.workflow_id - Filter by workflow ID
+             * @returns Paginated list of trajectories
+             */
             list: (params) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.listTrajectoriesV1TrajectoriesGet)({
                     client,
                     query: params,
                 });
             }),
+            /**
+             * Create a new trajectory
+             *
+             * A trajectory represents a recorded sequence of actions for a workflow.
+             *
+             * @param data - Trajectory data
+             * @param data.workflow_id - The workflow this trajectory belongs to
+             * @param data.trajectory_data - Array of recorded actions
+             * @param data.dimensions - Display dimensions when trajectory was recorded
+             * @param data.original_input_values - Input values used during recording
+             * @returns Created trajectory details
+             */
             create: (data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.createTrajectoryV1TrajectoriesPost)({
                     client,
                     body: data,
                 });
             }),
+            /**
+             * Get a specific trajectory by ID
+             *
+             * @param trajectoryId - The ID of the trajectory
+             * @returns Trajectory details including recorded actions
+             */
             get: (trajectoryId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.getTrajectoryV1TrajectoriesTrajectoryIdGet)({
                     client,
                     path: { trajectory_id: trajectoryId },
                 });
             }),
+            /**
+             * Update a trajectory
+             *
+             * @param trajectoryId - The ID of the trajectory to update
+             * @param data - Update data (trajectory_data)
+             * @returns Updated trajectory details
+             */
             update: (trajectoryId, data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.updateTrajectoryV1TrajectoriesTrajectoryIdPatch)({
                     client,
@@ -192,12 +416,26 @@ function createCyberdeskClient(apiKey, baseUrl) {
                     body: data,
                 });
             }),
+            /**
+             * Delete a trajectory
+             *
+             * @param trajectoryId - The ID of the trajectory to delete
+             */
             delete: (trajectoryId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.deleteTrajectoryV1TrajectoriesTrajectoryIdDelete)({
                     client,
                     path: { trajectory_id: trajectoryId },
                 });
             }),
+            /**
+             * Get the latest trajectory for a workflow
+             *
+             * Returns the most recently created trajectory for the specified workflow.
+             * Useful for replaying the latest recorded actions.
+             *
+             * @param workflowId - The ID of the workflow
+             * @returns Latest trajectory for the workflow, or null if none exists
+             */
             getLatestForWorkflow: (workflowId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.getLatestTrajectoryForWorkflowV1WorkflowsWorkflowIdLatestTrajectoryGet)({
                     client,
@@ -207,31 +445,102 @@ function createCyberdeskClient(apiKey, baseUrl) {
         },
         // Run Attachment endpoints
         run_attachments: {
+            /**
+             * List run attachments with optional filtering
+             *
+             * @param params - Optional query parameters
+             * @param params.skip - Number of items to skip (for pagination)
+             * @param params.limit - Maximum number of items to return
+             * @param params.run_id - Filter by run ID
+             * @param params.attachment_type - Filter by attachment type (input/output)
+             * @returns Paginated list of run attachments
+             */
             list: (params) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.listRunAttachmentsV1RunAttachmentsGet)({
                     client,
                     query: params,
                 });
             }),
+            /**
+             * Create a new run attachment
+             *
+             * @param data - Attachment data including file content as base64
+             * @returns Created attachment details
+             */
             create: (data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.createRunAttachmentV1RunAttachmentsPost)({
                     client,
                     body: data,
                 });
             }),
+            /**
+             * Get run attachment details
+             *
+             * @param attachmentId - The ID of the attachment
+             * @returns Attachment metadata
+             */
             get: (attachmentId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.getRunAttachmentV1RunAttachmentsAttachmentIdGet)({
                     client,
                     path: { attachment_id: attachmentId },
                 });
             }),
+            /**
+             * Get a signed download URL for a run attachment
+             *
+             * The returned URL will trigger an automatic download when accessed in a browser.
+             *
+             * @param attachmentId - The ID of the attachment
+             * @param expiresIn - URL expiration time in seconds (10-3600). Default: 300 (5 minutes)
+             * @returns Object containing the signed URL and expiration time
+             *
+             * @example
+             * ```typescript
+             * const { data } = await client.run_attachments.getDownloadUrl('attachment-id', 600);
+             * if (data) {
+             *   console.log(`Download URL: ${data.url}`);
+             *   console.log(`Expires in: ${data.expires_in} seconds`);
+             * }
+             * ```
+             */
+            getDownloadUrl: (attachmentId, expiresIn) => __awaiter(this, void 0, void 0, function* () {
+                return (0, sdk_gen_1.getRunAttachmentDownloadUrlV1RunAttachmentsAttachmentIdDownloadUrlGet)({
+                    client,
+                    path: { attachment_id: attachmentId },
+                    query: expiresIn ? { expires_in: expiresIn } : undefined,
+                });
+            }),
+            /**
+             * Download a run attachment file directly
+             *
+             * This method returns the raw file content. For a download URL instead,
+             * use `getDownloadUrl()`.
+             *
+             * @param attachmentId - The ID of the attachment to download
+             * @returns Raw file data
+             *
+             * @example
+             * ```typescript
+             * const { data } = await client.run_attachments.download('attachment-id');
+             * if (data) {
+             *   // Handle raw file bytes
+             *   const blob = new Blob([data]);
+             * }
+             * ```
+             */
             download: (attachmentId) => __awaiter(this, void 0, void 0, function* () {
-                // Note: This endpoint returns a download URL redirect or file data
                 return (0, sdk_gen_1.downloadRunAttachmentV1RunAttachmentsAttachmentIdDownloadGet)({
                     client,
                     path: { attachment_id: attachmentId },
                 });
             }),
+            /**
+             * Update a run attachment (e.g., set expiration)
+             *
+             * @param attachmentId - The ID of the attachment to update
+             * @param data - Update data
+             * @returns Updated attachment details
+             */
             update: (attachmentId, data) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.updateRunAttachmentV1RunAttachmentsAttachmentIdPut)({
                     client,
@@ -239,6 +548,11 @@ function createCyberdeskClient(apiKey, baseUrl) {
                     body: data,
                 });
             }),
+            /**
+             * Delete a run attachment
+             *
+             * @param attachmentId - The ID of the attachment to delete
+             */
             delete: (attachmentId) => __awaiter(this, void 0, void 0, function* () {
                 return (0, sdk_gen_1.deleteRunAttachmentV1RunAttachmentsAttachmentIdDelete)({
                     client,

package/package.json

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