opensteer 0.6.7 → 0.6.9

package/dist/browser-profile-client-CGXc0-P9.d.cts

@@ -0,0 +1,228 @@
+import { O as OpensteerAuthScheme } from './types-Cr10igF3.cjs';
+
+type ActionFailureCode = 'TARGET_NOT_FOUND' | 'TARGET_UNAVAILABLE' | 'TARGET_STALE' | 'TARGET_AMBIGUOUS' | 'BLOCKED_BY_INTERCEPTOR' | 'NOT_VISIBLE' | 'NOT_ENABLED' | 'NOT_EDITABLE' | 'INVALID_TARGET' | 'INVALID_OPTIONS' | 'ACTION_TIMEOUT' | 'UNKNOWN';
+type ActionFailureClassificationSource = 'typed_error' | 'playwright_call_log' | 'dom_probe' | 'message_heuristic' | 'unknown';
+interface ActionFailureBlocker {
+    tag: string;
+    id: string | null;
+    classes: string[];
+    role: string | null;
+    text: string | null;
+}
+interface ActionFailureDetails {
+    blocker?: ActionFailureBlocker;
+    observation?: string;
+}
+interface ActionFailure {
+    code: ActionFailureCode;
+    message: string;
+    retryable: boolean;
+    classificationSource: ActionFailureClassificationSource;
+    details?: ActionFailureDetails;
+}
+
+declare const cloudActionMethods: readonly ["goto", "snapshot", "screenshot", "state", "click", "dblclick", "rightclick", "hover", "input", "select", "scroll", "tabs", "newTab", "switchTab", "closeTab", "getCookies", "setCookie", "clearCookies", "pressKey", "type", "getElementText", "getElementValue", "getElementAttributes", "getElementBoundingBox", "getHtml", "getTitle", "uploadFile", "exportCookies", "importCookies", "waitForText", "extract", "extractFromPlan", "clearCache"];
+type CloudActionMethod = (typeof cloudActionMethods)[number];
+declare const cloudErrorCodes: readonly ["CLOUD_AUTH_FAILED", "CLOUD_SESSION_NOT_FOUND", "CLOUD_SESSION_CLOSED", "CLOUD_UNSUPPORTED_METHOD", "CLOUD_INVALID_REQUEST", "CLOUD_MODEL_NOT_ALLOWED", "CLOUD_ACTION_FAILED", "CLOUD_CAPACITY_EXHAUSTED", "CLOUD_RUNTIME_UNAVAILABLE", "CLOUD_RUNTIME_MISMATCH", "CLOUD_SESSION_STALE", "CLOUD_CONTROL_PLANE_ERROR", "CLOUD_CONTRACT_MISMATCH", "CLOUD_PROXY_UNAVAILABLE", "CLOUD_PROXY_REQUIRED", "CLOUD_BILLING_LIMIT_REACHED", "CLOUD_RATE_LIMITED", "CLOUD_BROWSER_PROFILE_NOT_FOUND", "CLOUD_BROWSER_PROFILE_BUSY", "CLOUD_BROWSER_PROFILE_DISABLED", "CLOUD_BROWSER_PROFILE_PROXY_UNAVAILABLE", "CLOUD_BROWSER_PROFILE_SYNC_FAILED", "CLOUD_INTERNAL"];
+type CloudErrorCode = (typeof cloudErrorCodes)[number];
+declare const cloudSessionStatuses: readonly ["provisioning", "active", "closing", "closed", "failed"];
+type CloudSessionStatus = (typeof cloudSessionStatuses)[number];
+declare const cloudSessionContractVersion: "v3";
+type CloudSessionContractVersion = typeof cloudSessionContractVersion;
+declare const cloudSessionSourceTypes: readonly ["agent-thread", "agent-run", "project-agent-run", "local-cloud", "manual"];
+type CloudSessionSourceType = (typeof cloudSessionSourceTypes)[number];
+type CloudSessionVisibilityScope = 'team' | 'owner';
+type CloudProxyMode = 'disabled' | 'optional' | 'required';
+type CloudProxyProtocol = 'http' | 'https' | 'socks5';
+type CloudFingerprintMode = 'off' | 'auto';
+type BrowserProfileStatus = 'active' | 'archived' | 'error';
+type BrowserProfileProxyPolicy = 'strict_sticky';
+type BrowserProfileArchiveFormat = 'tar.gz';
+interface CloudViewport {
+    width: number;
+    height: number;
+}
+interface CloudGeolocation {
+    latitude: number;
+    longitude: number;
+    accuracy?: number;
+}
+interface CloudBrowserContextConfig {
+    viewport?: CloudViewport;
+    locale?: string;
+    timezoneId?: string;
+    geolocation?: CloudGeolocation;
+    colorScheme?: 'light' | 'dark' | 'no-preference';
+    userAgent?: string;
+    javaScriptEnabled?: boolean;
+    ignoreHTTPSErrors?: boolean;
+}
+interface CloudBrowserExtensionConfig {
+    includeDefaults?: boolean;
+    extensionKeys?: string[];
+}
+interface CloudBrowserLaunchConfig {
+    headless?: boolean;
+    context?: CloudBrowserContextConfig;
+    chromeArgs?: string[];
+    extensions?: CloudBrowserExtensionConfig;
+}
+interface CloudProxyPreference {
+    mode?: CloudProxyMode;
+    countryCode?: string;
+    region?: string;
+    city?: string;
+    proxyId?: string;
+}
+interface CloudFingerprintPreference {
+    mode?: CloudFingerprintMode;
+    locales?: string[];
+    minWidth?: number;
+    maxWidth?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    slim?: boolean;
+}
+interface CloudBrowserProfileLaunchPreference {
+    profileId: string;
+    reuseIfActive?: boolean;
+}
+interface CloudSessionLaunchConfig {
+    browser?: CloudBrowserLaunchConfig;
+    proxy?: CloudProxyPreference;
+    fingerprint?: CloudFingerprintPreference;
+    browserProfile?: CloudBrowserProfileLaunchPreference;
+}
+interface CloudSessionCreateRequest {
+    cloudSessionContractVersion: CloudSessionContractVersion;
+    sourceType: 'local-cloud';
+    clientSessionHint: string;
+    localRunId: string;
+    name?: string;
+    model?: string;
+    launchContext?: Record<string, unknown>;
+    launchConfig?: CloudSessionLaunchConfig;
+}
+interface CloudSessionSummary {
+    sessionId: string;
+    workspaceId: string;
+    state: CloudSessionStatus;
+    createdAt: number;
+    sourceType: CloudSessionSourceType;
+    sourceRef?: string;
+    label?: string;
+}
+interface CloudSessionCreateResponse {
+    sessionId: string;
+    actionWsUrl: string;
+    cdpWsUrl: string;
+    actionToken: string;
+    cdpToken: string;
+    expiresAt?: number;
+    cloudSessionUrl: string;
+    cloudSession: CloudSessionSummary;
+}
+interface CloudSelectorCacheImportEntry {
+    namespace: string;
+    siteOrigin: string;
+    method: string;
+    descriptionHash: string;
+    path: unknown;
+    schemaHash?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+interface CloudSelectorCacheImportRequest {
+    entries: CloudSelectorCacheImportEntry[];
+}
+interface CloudSelectorCacheImportResponse {
+    imported: number;
+    inserted: number;
+    updated: number;
+    skipped: number;
+}
+interface CloudActionRequest {
+    id: number;
+    method: CloudActionMethod;
+    args: Record<string, unknown>;
+    sessionId: string;
+    token: string;
+}
+interface CloudActionSuccess {
+    id: number;
+    ok: true;
+    result: unknown;
+}
+interface CloudActionFailure {
+    id: number;
+    ok: false;
+    error: string;
+    code: CloudErrorCode;
+    details?: CloudActionFailureDetails;
+}
+type CloudActionResponse = CloudActionSuccess | CloudActionFailure;
+interface CloudActionFailureDetails {
+    actionFailure?: ActionFailure;
+}
+interface BrowserProfileDescriptor {
+    profileId: string;
+    teamId: string;
+    ownerUserId: string;
+    name: string;
+    status: BrowserProfileStatus;
+    proxyPolicy: BrowserProfileProxyPolicy;
+    stickyProxyId?: string;
+    proxyCountryCode?: string;
+    proxyRegion?: string;
+    proxyCity?: string;
+    fingerprintMode: CloudFingerprintMode;
+    fingerprintHash?: string;
+    activeSessionId?: string;
+    lastSessionId?: string;
+    lastLaunchedAt?: number;
+    latestRevision?: number;
+    latestStorageId?: string;
+    latestSizeBytes?: number;
+    latestArchiveSha256?: string;
+    latestArchiveFormat?: BrowserProfileArchiveFormat;
+    createdAt: number;
+    updatedAt: number;
+    lastError?: string;
+}
+interface BrowserProfileListResponse {
+    profiles: BrowserProfileDescriptor[];
+    nextCursor?: string;
+}
+interface BrowserProfileCreateRequest {
+    name: string;
+    proxy?: {
+        proxyId?: string;
+        countryCode?: string;
+        region?: string;
+        city?: string;
+    };
+    fingerprint?: {
+        mode?: CloudFingerprintMode;
+    };
+}
+declare function isCloudActionMethod(value: unknown): value is CloudActionMethod;
+declare function isCloudErrorCode(value: unknown): value is CloudErrorCode;
+declare function isCloudSessionSourceType(value: unknown): value is CloudSessionSourceType;
+declare function isCloudSessionStatus(value: unknown): value is CloudSessionStatus;
+
+interface BrowserProfileListRequest {
+    cursor?: string;
+    limit?: number;
+    status?: BrowserProfileStatus;
+}
+declare class BrowserProfileClient {
+    private readonly baseUrl;
+    private readonly key;
+    private readonly authScheme;
+    constructor(baseUrl: string, key: string, authScheme?: OpensteerAuthScheme);
+    list(request?: BrowserProfileListRequest): Promise<BrowserProfileListResponse>;
+    get(profileId: string): Promise<BrowserProfileDescriptor>;
+    create(request: BrowserProfileCreateRequest): Promise<BrowserProfileDescriptor>;
+}
+
+export { type ActionFailure as A, type BrowserProfileStatus as B, type CloudErrorCode as C, type CloudFingerprintMode as D, type CloudFingerprintPreference as E, type CloudGeolocation as F, type CloudProxyMode as G, type CloudProxyPreference as H, type CloudProxyProtocol as I, type CloudSessionContractVersion as J, type CloudSessionLaunchConfig as K, type CloudSessionSourceType as L, type CloudSessionStatus as M, type CloudSessionSummary as N, type CloudSessionVisibilityScope as O, type CloudViewport as P, cloudActionMethods as Q, cloudErrorCodes as R, cloudSessionContractVersion as S, cloudSessionSourceTypes as T, cloudSessionStatuses as U, isCloudActionMethod as V, isCloudErrorCode as W, isCloudSessionSourceType as X, isCloudSessionStatus as Y, type BrowserProfileListRequest as a, type BrowserProfileListResponse as b, type BrowserProfileCreateRequest as c, type BrowserProfileDescriptor as d, type ActionFailureCode as e, type CloudActionFailureDetails as f, type CloudSessionCreateRequest as g, type CloudSessionCreateResponse as h, type CloudSelectorCacheImportRequest as i, type CloudSelectorCacheImportResponse as j, type CloudActionMethod as k, type CloudSelectorCacheImportEntry as l, type ActionFailureBlocker as m, type ActionFailureClassificationSource as n, type ActionFailureDetails as o, type BrowserProfileArchiveFormat as p, BrowserProfileClient as q, type BrowserProfileProxyPolicy as r, type CloudActionFailure as s, type CloudActionRequest as t, type CloudActionResponse as u, type CloudActionSuccess as v, type CloudBrowserContextConfig as w, type CloudBrowserExtensionConfig as x, type CloudBrowserLaunchConfig as y, type CloudBrowserProfileLaunchPreference as z };

package/dist/browser-profile-client-DHLzMf-K.d.ts

@@ -0,0 +1,228 @@
+import { O as OpensteerAuthScheme } from './types-Cr10igF3.js';
+
+type ActionFailureCode = 'TARGET_NOT_FOUND' | 'TARGET_UNAVAILABLE' | 'TARGET_STALE' | 'TARGET_AMBIGUOUS' | 'BLOCKED_BY_INTERCEPTOR' | 'NOT_VISIBLE' | 'NOT_ENABLED' | 'NOT_EDITABLE' | 'INVALID_TARGET' | 'INVALID_OPTIONS' | 'ACTION_TIMEOUT' | 'UNKNOWN';
+type ActionFailureClassificationSource = 'typed_error' | 'playwright_call_log' | 'dom_probe' | 'message_heuristic' | 'unknown';
+interface ActionFailureBlocker {
+    tag: string;
+    id: string | null;
+    classes: string[];
+    role: string | null;
+    text: string | null;
+}
+interface ActionFailureDetails {
+    blocker?: ActionFailureBlocker;
+    observation?: string;
+}
+interface ActionFailure {
+    code: ActionFailureCode;
+    message: string;
+    retryable: boolean;
+    classificationSource: ActionFailureClassificationSource;
+    details?: ActionFailureDetails;
+}
+
+declare const cloudActionMethods: readonly ["goto", "snapshot", "screenshot", "state", "click", "dblclick", "rightclick", "hover", "input", "select", "scroll", "tabs", "newTab", "switchTab", "closeTab", "getCookies", "setCookie", "clearCookies", "pressKey", "type", "getElementText", "getElementValue", "getElementAttributes", "getElementBoundingBox", "getHtml", "getTitle", "uploadFile", "exportCookies", "importCookies", "waitForText", "extract", "extractFromPlan", "clearCache"];
+type CloudActionMethod = (typeof cloudActionMethods)[number];
+declare const cloudErrorCodes: readonly ["CLOUD_AUTH_FAILED", "CLOUD_SESSION_NOT_FOUND", "CLOUD_SESSION_CLOSED", "CLOUD_UNSUPPORTED_METHOD", "CLOUD_INVALID_REQUEST", "CLOUD_MODEL_NOT_ALLOWED", "CLOUD_ACTION_FAILED", "CLOUD_CAPACITY_EXHAUSTED", "CLOUD_RUNTIME_UNAVAILABLE", "CLOUD_RUNTIME_MISMATCH", "CLOUD_SESSION_STALE", "CLOUD_CONTROL_PLANE_ERROR", "CLOUD_CONTRACT_MISMATCH", "CLOUD_PROXY_UNAVAILABLE", "CLOUD_PROXY_REQUIRED", "CLOUD_BILLING_LIMIT_REACHED", "CLOUD_RATE_LIMITED", "CLOUD_BROWSER_PROFILE_NOT_FOUND", "CLOUD_BROWSER_PROFILE_BUSY", "CLOUD_BROWSER_PROFILE_DISABLED", "CLOUD_BROWSER_PROFILE_PROXY_UNAVAILABLE", "CLOUD_BROWSER_PROFILE_SYNC_FAILED", "CLOUD_INTERNAL"];
+type CloudErrorCode = (typeof cloudErrorCodes)[number];
+declare const cloudSessionStatuses: readonly ["provisioning", "active", "closing", "closed", "failed"];
+type CloudSessionStatus = (typeof cloudSessionStatuses)[number];
+declare const cloudSessionContractVersion: "v3";
+type CloudSessionContractVersion = typeof cloudSessionContractVersion;
+declare const cloudSessionSourceTypes: readonly ["agent-thread", "agent-run", "project-agent-run", "local-cloud", "manual"];
+type CloudSessionSourceType = (typeof cloudSessionSourceTypes)[number];
+type CloudSessionVisibilityScope = 'team' | 'owner';
+type CloudProxyMode = 'disabled' | 'optional' | 'required';
+type CloudProxyProtocol = 'http' | 'https' | 'socks5';
+type CloudFingerprintMode = 'off' | 'auto';
+type BrowserProfileStatus = 'active' | 'archived' | 'error';
+type BrowserProfileProxyPolicy = 'strict_sticky';
+type BrowserProfileArchiveFormat = 'tar.gz';
+interface CloudViewport {
+    width: number;
+    height: number;
+}
+interface CloudGeolocation {
+    latitude: number;
+    longitude: number;
+    accuracy?: number;
+}
+interface CloudBrowserContextConfig {
+    viewport?: CloudViewport;
+    locale?: string;
+    timezoneId?: string;
+    geolocation?: CloudGeolocation;
+    colorScheme?: 'light' | 'dark' | 'no-preference';
+    userAgent?: string;
+    javaScriptEnabled?: boolean;
+    ignoreHTTPSErrors?: boolean;
+}
+interface CloudBrowserExtensionConfig {
+    includeDefaults?: boolean;
+    extensionKeys?: string[];
+}
+interface CloudBrowserLaunchConfig {
+    headless?: boolean;
+    context?: CloudBrowserContextConfig;
+    chromeArgs?: string[];
+    extensions?: CloudBrowserExtensionConfig;
+}
+interface CloudProxyPreference {
+    mode?: CloudProxyMode;
+    countryCode?: string;
+    region?: string;
+    city?: string;
+    proxyId?: string;
+}
+interface CloudFingerprintPreference {
+    mode?: CloudFingerprintMode;
+    locales?: string[];
+    minWidth?: number;
+    maxWidth?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    slim?: boolean;
+}
+interface CloudBrowserProfileLaunchPreference {
+    profileId: string;
+    reuseIfActive?: boolean;
+}
+interface CloudSessionLaunchConfig {
+    browser?: CloudBrowserLaunchConfig;
+    proxy?: CloudProxyPreference;
+    fingerprint?: CloudFingerprintPreference;
+    browserProfile?: CloudBrowserProfileLaunchPreference;
+}
+interface CloudSessionCreateRequest {
+    cloudSessionContractVersion: CloudSessionContractVersion;
+    sourceType: 'local-cloud';
+    clientSessionHint: string;
+    localRunId: string;
+    name?: string;
+    model?: string;
+    launchContext?: Record<string, unknown>;
+    launchConfig?: CloudSessionLaunchConfig;
+}
+interface CloudSessionSummary {
+    sessionId: string;
+    workspaceId: string;
+    state: CloudSessionStatus;
+    createdAt: number;
+    sourceType: CloudSessionSourceType;
+    sourceRef?: string;
+    label?: string;
+}
+interface CloudSessionCreateResponse {
+    sessionId: string;
+    actionWsUrl: string;
+    cdpWsUrl: string;
+    actionToken: string;
+    cdpToken: string;
+    expiresAt?: number;
+    cloudSessionUrl: string;
+    cloudSession: CloudSessionSummary;
+}
+interface CloudSelectorCacheImportEntry {
+    namespace: string;
+    siteOrigin: string;
+    method: string;
+    descriptionHash: string;
+    path: unknown;
+    schemaHash?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+interface CloudSelectorCacheImportRequest {
+    entries: CloudSelectorCacheImportEntry[];
+}
+interface CloudSelectorCacheImportResponse {
+    imported: number;
+    inserted: number;
+    updated: number;
+    skipped: number;
+}
+interface CloudActionRequest {
+    id: number;
+    method: CloudActionMethod;
+    args: Record<string, unknown>;
+    sessionId: string;
+    token: string;
+}
+interface CloudActionSuccess {
+    id: number;
+    ok: true;
+    result: unknown;
+}
+interface CloudActionFailure {
+    id: number;
+    ok: false;
+    error: string;
+    code: CloudErrorCode;
+    details?: CloudActionFailureDetails;
+}
+type CloudActionResponse = CloudActionSuccess | CloudActionFailure;
+interface CloudActionFailureDetails {
+    actionFailure?: ActionFailure;
+}
+interface BrowserProfileDescriptor {
+    profileId: string;
+    teamId: string;
+    ownerUserId: string;
+    name: string;
+    status: BrowserProfileStatus;
+    proxyPolicy: BrowserProfileProxyPolicy;
+    stickyProxyId?: string;
+    proxyCountryCode?: string;
+    proxyRegion?: string;
+    proxyCity?: string;
+    fingerprintMode: CloudFingerprintMode;
+    fingerprintHash?: string;
+    activeSessionId?: string;
+    lastSessionId?: string;
+    lastLaunchedAt?: number;
+    latestRevision?: number;
+    latestStorageId?: string;
+    latestSizeBytes?: number;
+    latestArchiveSha256?: string;
+    latestArchiveFormat?: BrowserProfileArchiveFormat;
+    createdAt: number;
+    updatedAt: number;
+    lastError?: string;
+}
+interface BrowserProfileListResponse {
+    profiles: BrowserProfileDescriptor[];
+    nextCursor?: string;
+}
+interface BrowserProfileCreateRequest {
+    name: string;
+    proxy?: {
+        proxyId?: string;
+        countryCode?: string;
+        region?: string;
+        city?: string;
+    };
+    fingerprint?: {
+        mode?: CloudFingerprintMode;
+    };
+}
+declare function isCloudActionMethod(value: unknown): value is CloudActionMethod;
+declare function isCloudErrorCode(value: unknown): value is CloudErrorCode;
+declare function isCloudSessionSourceType(value: unknown): value is CloudSessionSourceType;
+declare function isCloudSessionStatus(value: unknown): value is CloudSessionStatus;
+
+interface BrowserProfileListRequest {
+    cursor?: string;
+    limit?: number;
+    status?: BrowserProfileStatus;
+}
+declare class BrowserProfileClient {
+    private readonly baseUrl;
+    private readonly key;
+    private readonly authScheme;
+    constructor(baseUrl: string, key: string, authScheme?: OpensteerAuthScheme);
+    list(request?: BrowserProfileListRequest): Promise<BrowserProfileListResponse>;
+    get(profileId: string): Promise<BrowserProfileDescriptor>;
+    create(request: BrowserProfileCreateRequest): Promise<BrowserProfileDescriptor>;
+}
+
+export { type ActionFailure as A, type BrowserProfileStatus as B, type CloudErrorCode as C, type CloudFingerprintMode as D, type CloudFingerprintPreference as E, type CloudGeolocation as F, type CloudProxyMode as G, type CloudProxyPreference as H, type CloudProxyProtocol as I, type CloudSessionContractVersion as J, type CloudSessionLaunchConfig as K, type CloudSessionSourceType as L, type CloudSessionStatus as M, type CloudSessionSummary as N, type CloudSessionVisibilityScope as O, type CloudViewport as P, cloudActionMethods as Q, cloudErrorCodes as R, cloudSessionContractVersion as S, cloudSessionSourceTypes as T, cloudSessionStatuses as U, isCloudActionMethod as V, isCloudErrorCode as W, isCloudSessionSourceType as X, isCloudSessionStatus as Y, type BrowserProfileListRequest as a, type BrowserProfileListResponse as b, type BrowserProfileCreateRequest as c, type BrowserProfileDescriptor as d, type ActionFailureCode as e, type CloudActionFailureDetails as f, type CloudSessionCreateRequest as g, type CloudSessionCreateResponse as h, type CloudSelectorCacheImportRequest as i, type CloudSelectorCacheImportResponse as j, type CloudActionMethod as k, type CloudSelectorCacheImportEntry as l, type ActionFailureBlocker as m, type ActionFailureClassificationSource as n, type ActionFailureDetails as o, type BrowserProfileArchiveFormat as p, BrowserProfileClient as q, type BrowserProfileProxyPolicy as r, type CloudActionFailure as s, type CloudActionRequest as t, type CloudActionResponse as u, type CloudActionSuccess as v, type CloudBrowserContextConfig as w, type CloudBrowserExtensionConfig as x, type CloudBrowserLaunchConfig as y, type CloudBrowserProfileLaunchPreference as z };

package/dist/{chunk-6B6LOYU3.js → chunk-A6LF44E3.js}

@@ -2,7 +2,7 @@ import {
   cloudAuthHeaders,
   normalizeCloudBaseUrl,
   parseCloudHttpError
-} from "./chunk-KPPOTU3D.js";
+} from "./chunk-GTT3A3RU.js";
 
 // src/cloud/browser-profile-client.ts
 var BrowserProfileClient = class {

package/dist/{chunk-KPPOTU3D.js → chunk-GTT3A3RU.js}

@@ -890,6 +890,101 @@ function getCallerFilePath() {
   return null;
 }
 
+// src/cloud/contracts.ts
+var cloudActionMethods = [
+  "goto",
+  "snapshot",
+  "screenshot",
+  "state",
+  "click",
+  "dblclick",
+  "rightclick",
+  "hover",
+  "input",
+  "select",
+  "scroll",
+  "tabs",
+  "newTab",
+  "switchTab",
+  "closeTab",
+  "getCookies",
+  "setCookie",
+  "clearCookies",
+  "pressKey",
+  "type",
+  "getElementText",
+  "getElementValue",
+  "getElementAttributes",
+  "getElementBoundingBox",
+  "getHtml",
+  "getTitle",
+  "uploadFile",
+  "exportCookies",
+  "importCookies",
+  "waitForText",
+  "extract",
+  "extractFromPlan",
+  "clearCache"
+];
+var cloudErrorCodes = [
+  "CLOUD_AUTH_FAILED",
+  "CLOUD_SESSION_NOT_FOUND",
+  "CLOUD_SESSION_CLOSED",
+  "CLOUD_UNSUPPORTED_METHOD",
+  "CLOUD_INVALID_REQUEST",
+  "CLOUD_MODEL_NOT_ALLOWED",
+  "CLOUD_ACTION_FAILED",
+  "CLOUD_CAPACITY_EXHAUSTED",
+  "CLOUD_RUNTIME_UNAVAILABLE",
+  "CLOUD_RUNTIME_MISMATCH",
+  "CLOUD_SESSION_STALE",
+  "CLOUD_CONTROL_PLANE_ERROR",
+  "CLOUD_CONTRACT_MISMATCH",
+  "CLOUD_PROXY_UNAVAILABLE",
+  "CLOUD_PROXY_REQUIRED",
+  "CLOUD_BILLING_LIMIT_REACHED",
+  "CLOUD_RATE_LIMITED",
+  "CLOUD_BROWSER_PROFILE_NOT_FOUND",
+  "CLOUD_BROWSER_PROFILE_BUSY",
+  "CLOUD_BROWSER_PROFILE_DISABLED",
+  "CLOUD_BROWSER_PROFILE_PROXY_UNAVAILABLE",
+  "CLOUD_BROWSER_PROFILE_SYNC_FAILED",
+  "CLOUD_INTERNAL"
+];
+var cloudSessionStatuses = [
+  "provisioning",
+  "active",
+  "closing",
+  "closed",
+  "failed"
+];
+var cloudSessionContractVersion = "v3";
+var cloudSessionSourceTypes = [
+  "agent-thread",
+  "agent-run",
+  "project-agent-run",
+  "local-cloud",
+  "manual"
+];
+var cloudActionMethodSet = new Set(cloudActionMethods);
+var cloudErrorCodeSet = new Set(cloudErrorCodes);
+var cloudSessionSourceTypeSet = new Set(
+  cloudSessionSourceTypes
+);
+var cloudSessionStatusSet = new Set(cloudSessionStatuses);
+function isCloudActionMethod(value) {
+  return typeof value === "string" && cloudActionMethodSet.has(value);
+}
+function isCloudErrorCode(value) {
+  return typeof value === "string" && cloudErrorCodeSet.has(value);
+}
+function isCloudSessionSourceType(value) {
+  return typeof value === "string" && cloudSessionSourceTypeSet.has(value);
+}
+function isCloudSessionStatus(value) {
+  return typeof value === "string" && cloudSessionStatusSet.has(value);
+}
+
 // src/cloud/errors.ts
 var OpensteerCloudError = class extends Error {
   code;
@@ -920,6 +1015,15 @@ function cloudNotLaunchedError() {
 import {
   chromium
 } from "playwright";
+
+// src/cloud/ws-url.ts
+function withTokenQuery(wsUrl, token) {
+  const url = new URL(wsUrl);
+  url.searchParams.set("token", token);
+  return url.toString();
+}
+
+// src/cloud/cdp-client.ts
 var CloudCdpClient = class {
   async connect(args) {
     const endpoint = withTokenQuery(args.wsUrl, args.token);
@@ -974,11 +1078,6 @@ function isInternalOrEmptyUrl(url) {
   if (url === "about:blank") return true;
   return url.startsWith("chrome://") || url.startsWith("devtools://") || url.startsWith("edge://");
 }
-function withTokenQuery(wsUrl, token) {
-  const url = new URL(wsUrl);
-  url.searchParams.set("token", token);
-  return url.toString();
-}
 
 // src/utils/strip-trailing-slashes.ts
 function stripTrailingSlashes(value) {
@@ -1015,10 +1114,7 @@ async function parseCloudHttpError(response) {
   return new OpensteerCloudError(code, message, response.status, body?.details);
 }
 function toCloudErrorCode(code) {
-  if (code === "CLOUD_AUTH_FAILED" || code === "CLOUD_SESSION_NOT_FOUND" || code === "CLOUD_SESSION_CLOSED" || code === "CLOUD_UNSUPPORTED_METHOD" || code === "CLOUD_INVALID_REQUEST" || code === "CLOUD_MODEL_NOT_ALLOWED" || code === "CLOUD_ACTION_FAILED" || code === "CLOUD_INTERNAL" || code === "CLOUD_CAPACITY_EXHAUSTED" || code === "CLOUD_RUNTIME_UNAVAILABLE" || code === "CLOUD_RUNTIME_MISMATCH" || code === "CLOUD_SESSION_STALE" || code === "CLOUD_CONTRACT_MISMATCH" || code === "CLOUD_CONTROL_PLANE_ERROR" || code === "CLOUD_PROXY_UNAVAILABLE" || code === "CLOUD_PROXY_REQUIRED" || code === "CLOUD_BILLING_LIMIT_REACHED" || code === "CLOUD_RATE_LIMITED" || code === "CLOUD_BROWSER_PROFILE_NOT_FOUND" || code === "CLOUD_BROWSER_PROFILE_BUSY" || code === "CLOUD_BROWSER_PROFILE_DISABLED" || code === "CLOUD_BROWSER_PROFILE_PROXY_UNAVAILABLE" || code === "CLOUD_BROWSER_PROFILE_SYNC_FAILED") {
-    return code;
-  }
-  return "CLOUD_TRANSPORT_ERROR";
+  return isCloudErrorCode(code) ? code : "CLOUD_TRANSPORT_ERROR";
 }
 
 // src/cloud/session-client.ts
@@ -1125,7 +1221,12 @@ function parseCreateResponse(body, status) {
       status,
       "cloudSession"
     ),
-    state: requireString(cloudSessionRoot, "state", status, "cloudSession"),
+    state: requireSessionStatus(
+      cloudSessionRoot,
+      "state",
+      status,
+      "cloudSession"
+    ),
     createdAt: requireNumber(cloudSessionRoot, "createdAt", status, "cloudSession"),
     sourceType: requireSourceType(cloudSessionRoot, "sourceType", status, "cloudSession"),
     sourceRef: optionalString(cloudSessionRoot, "sourceRef", status, "cloudSession"),
@@ -1213,7 +1314,21 @@ function optionalNumber(source, field, status, parent) {
 }
 function requireSourceType(source, field, status, parent) {
   const value = source[field];
-  if (value === "agent-thread" || value === "agent-run" || value === "local-cloud" || value === "manual") {
+  if (isCloudSessionSourceType(value)) {
+    return value;
+  }
+  throw new OpensteerCloudError(
+    "CLOUD_CONTRACT_MISMATCH",
+    `Invalid cloud session create response: ${formatFieldPath(
+      field,
+      parent
+    )} must be one of ${formatAllowedValues(cloudSessionSourceTypes)}.`,
+    status
+  );
+}
+function requireSessionStatus(source, field, status, parent) {
+  const value = source[field];
+  if (isCloudSessionStatus(value)) {
     return value;
   }
   throw new OpensteerCloudError(
@@ -1221,13 +1336,26 @@ function requireSourceType(source, field, status, parent) {
     `Invalid cloud session create response: ${formatFieldPath(
       field,
       parent
-    )} must be one of "agent-thread", "agent-run", "local-cloud", or "manual".`,
+    )} must be one of ${formatAllowedValues(cloudSessionStatuses)}.`,
     status
   );
 }
 function formatFieldPath(field, parent) {
   return parent ? `"${parent}.${field}"` : `"${field}"`;
 }
+function formatAllowedValues(values) {
+  if (values.length === 0) {
+    return "";
+  }
+  if (values.length === 1) {
+    return `"${values[0]}"`;
+  }
+  if (values.length === 2) {
+    return `"${values[0]}" or "${values[1]}"`;
+  }
+  const quotedValues = values.map((value) => `"${value}"`);
+  return `${quotedValues.slice(0, -1).join(", ")}, or ${quotedValues[quotedValues.length - 1]}`;
+}
 function zeroImportResponse() {
   return {
     imported: 0,
@@ -1284,9 +1412,19 @@ export {
   resolveCloudSelection,
   resolveConfigWithEnv,
   resolveNamespace,
+  cloudActionMethods,
+  cloudErrorCodes,
+  cloudSessionStatuses,
+  cloudSessionContractVersion,
+  cloudSessionSourceTypes,
+  isCloudActionMethod,
+  isCloudErrorCode,
+  isCloudSessionSourceType,
+  isCloudSessionStatus,
   OpensteerCloudError,
   cloudUnsupportedMethodError,
   cloudNotLaunchedError,
+  withTokenQuery,
   CloudCdpClient,
   stripTrailingSlashes,
   normalizeCloudBaseUrl,