opensteer 0.6.7 → 0.6.8

package/dist/{chunk-KPPOTU3D.js → chunk-LTREUXLO.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,16 @@ 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) {
+  return values.map((value) => `"${value}"`).join(", ");
+}
 function zeroImportResponse() {
   return {
     imported: 0,
@@ -1284,9 +1402,19 @@ export {
   resolveCloudSelection,
   resolveConfigWithEnv,
   resolveNamespace,
+  cloudActionMethods,
+  cloudErrorCodes,
+  cloudSessionStatuses,
+  cloudSessionContractVersion,
+  cloudSessionSourceTypes,
+  isCloudActionMethod,
+  isCloudErrorCode,
+  isCloudSessionSourceType,
+  isCloudSessionStatus,
   OpensteerCloudError,
   cloudUnsupportedMethodError,
   cloudNotLaunchedError,
+  withTokenQuery,
   CloudCdpClient,
   stripTrailingSlashes,
   normalizeCloudBaseUrl,

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

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

package/dist/{chunk-54KNQTOL.js → chunk-UQYVMJOZ.js}

@@ -5,7 +5,7 @@ import {
   resolveConfigWithEnv,
   selectCloudCredential,
   stripTrailingSlashes
-} from "./chunk-KPPOTU3D.js";
+} from "./chunk-LTREUXLO.js";
 
 // src/cli/auth.ts
 import open from "open";
@@ -986,7 +986,7 @@ function isCiEnvironment(env) {
   const value = env.CI?.trim().toLowerCase();
   return Boolean(value && value !== "0" && value !== "false");
 }
-function isCloudModeEnabledForRootDir(rootDir, env) {
+function resolveCloudSessionEnvForRootDir(rootDir, env) {
   const resolved = resolveConfigWithEnv(
     {
       storage: { rootDir }
@@ -995,22 +995,29 @@ function isCloudModeEnabledForRootDir(rootDir, env) {
       env
     }
   );
-  return resolveCloudSelection(
-    {
-      cloud: resolved.config.cloud
-    },
-    resolved.env
-  ).cloud;
+  return {
+    cloud: resolveCloudSelection(
+      {
+        cloud: resolved.config.cloud
+      },
+      resolved.env
+    ).cloud,
+    env: resolved.env
+  };
+}
+function isCloudModeEnabledForRootDir(rootDir, env) {
+  return resolveCloudSessionEnvForRootDir(rootDir, env).cloud;
 }
 async function ensureCloudCredentialsForOpenCommand(options) {
-  const env = options.env ?? process.env;
-  if (!isCloudModeEnabledForRootDir(options.scopeDir, env)) {
+  const processEnv = options.env ?? process.env;
+  const runtime = resolveCloudSessionEnvForRootDir(options.scopeDir, processEnv);
+  if (!runtime.cloud) {
     return null;
   }
   const writeStderr = options.writeStderr ?? ((message) => process.stderr.write(message));
-  return await ensureCloudCredentialsForCommand({
+  const auth = await ensureCloudCredentialsForCommand({
     commandName: "opensteer open",
-    env,
+    env: runtime.env,
     store: options.store,
     apiKeyFlag: options.apiKeyFlag,
     accessTokenFlag: options.accessTokenFlag,
@@ -1023,6 +1030,14 @@ async function ensureCloudCredentialsForOpenCommand(options) {
     now: options.now,
     openExternalUrl: options.openExternalUrl
   });
+  applyCloudCredentialToEnv(processEnv, {
+    kind: auth.kind,
+    source: auth.source,
+    token: auth.token,
+    authScheme: auth.authScheme
+  });
+  processEnv.OPENSTEER_BASE_URL = auth.baseUrl;
+  return auth;
 }
 async function ensureCloudCredentialsForCommand(options) {
   const env = options.env ?? process.env;

package/dist/cli/auth.cjs

@@ -42,6 +42,88 @@ var import_open = __toESM(require("open"), 1);
 // src/cloud/cdp-client.ts
 var import_playwright = require("playwright");
 
+// 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 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);
+
 // src/utils/strip-trailing-slashes.ts
 function stripTrailingSlashes(value) {
   let end = value.length;
@@ -1665,7 +1747,7 @@ function isCiEnvironment(env) {
   const value = env.CI?.trim().toLowerCase();
   return Boolean(value && value !== "0" && value !== "false");
 }
-function isCloudModeEnabledForRootDir(rootDir, env) {
+function resolveCloudSessionEnvForRootDir(rootDir, env) {
   const resolved = resolveConfigWithEnv(
     {
       storage: { rootDir }
@@ -1674,22 +1756,29 @@ function isCloudModeEnabledForRootDir(rootDir, env) {
       env
     }
   );
-  return resolveCloudSelection(
-    {
-      cloud: resolved.config.cloud
-    },
-    resolved.env
-  ).cloud;
+  return {
+    cloud: resolveCloudSelection(
+      {
+        cloud: resolved.config.cloud
+      },
+      resolved.env
+    ).cloud,
+    env: resolved.env
+  };
+}
+function isCloudModeEnabledForRootDir(rootDir, env) {
+  return resolveCloudSessionEnvForRootDir(rootDir, env).cloud;
 }
 async function ensureCloudCredentialsForOpenCommand(options) {
-  const env = options.env ?? process.env;
-  if (!isCloudModeEnabledForRootDir(options.scopeDir, env)) {
+  const processEnv = options.env ?? process.env;
+  const runtime = resolveCloudSessionEnvForRootDir(options.scopeDir, processEnv);
+  if (!runtime.cloud) {
     return null;
   }
   const writeStderr = options.writeStderr ?? ((message) => process.stderr.write(message));
-  return await ensureCloudCredentialsForCommand({
+  const auth = await ensureCloudCredentialsForCommand({
     commandName: "opensteer open",
-    env,
+    env: runtime.env,
     store: options.store,
     apiKeyFlag: options.apiKeyFlag,
     accessTokenFlag: options.accessTokenFlag,
@@ -1702,6 +1791,14 @@ async function ensureCloudCredentialsForOpenCommand(options) {
     now: options.now,
     openExternalUrl: options.openExternalUrl
   });
+  applyCloudCredentialToEnv(processEnv, {
+    kind: auth.kind,
+    source: auth.source,
+    token: auth.token,
+    authScheme: auth.authScheme
+  });
+  processEnv.OPENSTEER_BASE_URL = auth.baseUrl;
+  return auth;
 }
 async function ensureCloudCredentialsForCommand(options) {
   const env = options.env ?? process.env;

package/dist/cli/auth.js

@@ -4,8 +4,8 @@ import {
   isCloudModeEnabledForRootDir,
   parseOpensteerAuthArgs,
   runOpensteerAuthCli
-} from "../chunk-54KNQTOL.js";
-import "../chunk-KPPOTU3D.js";
+} from "../chunk-UQYVMJOZ.js";
+import "../chunk-LTREUXLO.js";
 export {
   ensureCloudCredentialsForCommand,
   ensureCloudCredentialsForOpenCommand,

package/dist/cli/profile.cjs

@@ -8916,7 +8916,96 @@ function stripPositionClauses2(path7) {
 }
 
 // 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 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/action-ws-client.ts
 var import_ws2 = __toESM(require("ws"), 1);
@@ -8947,6 +9036,13 @@ function cloudNotLaunchedError() {
   );
 }
 
+// src/cloud/ws-url.ts
+function withTokenQuery(wsUrl, token) {
+  const url = new URL(wsUrl);
+  url.searchParams.set("token", token);
+  return url.toString();
+}
+
 // src/cloud/action-ws-client.ts
 var ActionWsClient = class _ActionWsClient {
   ws;
@@ -9075,11 +9171,6 @@ function rawDataToUtf8(raw) {
   if (Array.isArray(raw)) return Buffer.concat(raw).toString("utf8");
   return raw.toString("utf8");
 }
-function withTokenQuery(wsUrl, token) {
-  const url = new URL(wsUrl);
-  url.searchParams.set("token", token);
-  return url.toString();
-}
 
 // src/cloud/local-cache-sync.ts
 var import_fs4 = __toESM(require("fs"), 1);
@@ -9219,7 +9310,7 @@ function dedupeNewest(entries) {
 var import_playwright2 = require("playwright");
 var CloudCdpClient = class {
   async connect(args) {
-    const endpoint = withTokenQuery2(args.wsUrl, args.token);
+    const endpoint = withTokenQuery(args.wsUrl, args.token);
     let browser;
     try {
       browser = await import_playwright2.chromium.connectOverCDP(endpoint);
@@ -9271,11 +9362,6 @@ function isInternalOrEmptyUrl(url) {
   if (url === "about:blank") return true;
   return url.startsWith("chrome://") || url.startsWith("devtools://") || url.startsWith("edge://");
 }
-function withTokenQuery2(wsUrl, token) {
-  const url = new URL(wsUrl);
-  url.searchParams.set("token", token);
-  return url.toString();
-}
 
 // src/utils/strip-trailing-slashes.ts
 function stripTrailingSlashes(value) {
@@ -9312,10 +9398,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
@@ -9422,7 +9505,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"),
@@ -9510,7 +9598,7 @@ 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(
@@ -9518,13 +9606,30 @@ 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(cloudSessionSourceTypes)}.`,
+    status
+  );
+}
+function requireSessionStatus(source, field, status, parent) {
+  const value = source[field];
+  if (isCloudSessionStatus(value)) {
+    return value;
+  }
+  throw new OpensteerCloudError(
+    "CLOUD_CONTRACT_MISMATCH",
+    `Invalid cloud session create response: ${formatFieldPath(
+      field,
+      parent
+    )} must be one of ${formatAllowedValues(cloudSessionStatuses)}.`,
     status
   );
 }
 function formatFieldPath(field, parent) {
   return parent ? `"${parent}.${field}"` : `"${field}"`;
 }
+function formatAllowedValues(values) {
+  return values.map((value) => `"${value}"`).join(", ");
+}
 function zeroImportResponse() {
   return {
     imported: 0,

package/dist/cli/profile.d.cts

@@ -1,6 +1,6 @@
 import { Cookie } from 'playwright';
 import { O as OpensteerAuthScheme, a as OpensteerConfig, C as CookieParam } from '../types-Cr10igF3.cjs';
-import { B as BrowserProfileStatus, a as BrowserProfileListRequest, b as BrowserProfileListResponse, c as BrowserProfileCreateRequest, d as BrowserProfileDescriptor } from '../browser-profile-client-Biu6DyT6.cjs';
+import { B as BrowserProfileStatus, a as BrowserProfileListRequest, b as BrowserProfileListResponse, c as BrowserProfileCreateRequest, d as BrowserProfileDescriptor } from '../browser-profile-client-CGXc0-P9.cjs';
 
 type ParsedProfileArgs = {
     mode: 'help';

package/dist/cli/profile.d.ts

@@ -1,6 +1,6 @@
 import { Cookie } from 'playwright';
 import { O as OpensteerAuthScheme, a as OpensteerConfig, C as CookieParam } from '../types-Cr10igF3.js';
-import { B as BrowserProfileStatus, a as BrowserProfileListRequest, b as BrowserProfileListResponse, c as BrowserProfileCreateRequest, d as BrowserProfileDescriptor } from '../browser-profile-client-AGTsLQxT.js';
+import { B as BrowserProfileStatus, a as BrowserProfileListRequest, b as BrowserProfileListResponse, c as BrowserProfileCreateRequest, d as BrowserProfileDescriptor } from '../browser-profile-client-DHLzMf-K.js';
 
 type ParsedProfileArgs = {
     mode: 'help';