cloudcruise 1.2.0 → 1.2.1

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { RunsClient } from './runs/RunsClient.js';
 export { WebhookClient } from './webhook/WebhookClient.js';
 export type { VaultEntry, GetVaultEntriesFilters, ProxyConfig, VaultPostPutHeadersInBody, SecretProvider, SecretProviderItem, SecretProviderType } from './vault/types.js';
 export type { Workflow, WorkflowInputSchema, WorkflowMetadata } from './workflows/types.js';
-export type { DryRun, Metadata, RunSpecificWebhook, PayloadWebhook, StartRunRequest, StartRunResponse, UserInteractionData, VideoUrl, SignedFileUrl, SignedScreenshotUrl, RunError, WorkflowError, RunResult, GetRunResult, WebhookEvent, WebhookReplayResponse, RunHandle, RunStreamOptions, SseEventName, SseMessage, RunEventEnvelope, RunHandleEventMap } from './runs/types.js';
+export type { DryRun, Metadata, RunSpecificWebhook, PayloadWebhook, StartRunRequest, StartRunResponse, UserInteractionData, VideoUrl, SignedFileUrl, SignedScreenshotUrl, RunError, WorkflowError, RunResult, GetRunResult, WebhookEvent, WebhookReplayResponse, RunHandle, RunStreamOptions, SseEventName, SseMessage, RunEventEnvelope, RunHandleEventMap, LiveViewConnection } from './runs/types.js';
 export { EventType } from './events/types.js';
 export type { WebhookMessage, RunEventMessage, AvailableAction, PopupRetry, PopupContext, InputRequiredReason, ExecutionInputRequiredPayload, AgentErrorAnalysisPayload } from './events/types.js';
 export type { WebhookVerificationOptions } from './webhook/types.js';

package/dist/runs/RunsClient.d.ts

@@ -1,4 +1,4 @@
-import type { StartRunRequest, UserInteractionData, GetRunResult, WebhookReplayResponse, RunHandle, RunStreamOptions } from './types.js';
+import type { StartRunRequest, UserInteractionData, GetRunResult, WebhookReplayResponse, RunHandle, RunStreamOptions, LiveViewConnection } from './types.js';
 import type { PopupContext, ExecutionInputRequiredPayload } from '../events/types.js';
 import { ConnectionManager } from '../utils/connectionManager.js';
 export declare class RunsClient {
@@ -87,6 +87,18 @@ export declare class RunsClient {
      * @returns Promise resolving to complete run results
      */
     getResults(sessionId: string): Promise<GetRunResult>;
+    /**
+     * Fetches a fresh live-view connection (viewer URL + auth token) for
+     * watching an active session's browser stream. The auth token is
+     * single-use, so reopening a previously used viewer link will fail —
+     * call this again to mint a new one instead.
+     *
+     * Only works while the session is still active; throws once the session
+     * has ended.
+     *
+     * @param sessionId - The unique identifier for the workflow execution session
+     */
+    getLiveViewConnection(sessionId: string): Promise<LiveViewConnection>;
     /**
      * Interrupts a running browser agent run
      * @param sessionId - The unique identifier for the workflow execution session

package/dist/runs/RunsClient.js

@@ -380,6 +380,21 @@ export class RunsClient {
         const path = `/run/${sessionId}`;
         return await this.makeRequest('GET', path);
     }
+    /**
+     * Fetches a fresh live-view connection (viewer URL + auth token) for
+     * watching an active session's browser stream. The auth token is
+     * single-use, so reopening a previously used viewer link will fail —
+     * call this again to mint a new one instead.
+     *
+     * Only works while the session is still active; throws once the session
+     * has ended.
+     *
+     * @param sessionId - The unique identifier for the workflow execution session
+     */
+    async getLiveViewConnection(sessionId) {
+        const path = `/live/sessions/${sessionId}/connection`;
+        return await this.makeRequest('GET', path);
+    }
     /**
      * Interrupts a running browser agent run
      * @param sessionId - The unique identifier for the workflow execution session

package/dist/runs/types.d.ts

@@ -36,6 +36,11 @@ export interface VideoUrl {
     signed_screen_recording_url: string;
     signed_screen_recording_url_expires: string;
 }
+export interface LiveViewConnection {
+    url: string;
+    sessionId: string;
+    authToken: string;
+}
 export interface RunError {
     prompt?: string | null;
     message?: string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcruise",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "The official CloudCruise JS/TS client.",
   "homepage": "https://github.com/CloudCruise/cloudcruise-js#readme",
   "bugs": {