opensteer 0.6.13 → 0.7.0

package/dist/chunk-2ES46WCO.js

@@ -1,1437 +0,0 @@
-// src/error-normalization.ts
-function extractErrorMessage(error, fallback = "Unknown error.") {
-  if (error instanceof Error) {
-    const message = error.message.trim();
-    if (message) return message;
-    const name = error.name.trim();
-    if (name) return name;
-  }
-  if (typeof error === "string" && error.trim()) {
-    return error.trim();
-  }
-  const record = asRecord(error);
-  const recordMessage = toNonEmptyString(record?.message) || toNonEmptyString(record?.error);
-  if (recordMessage) {
-    return recordMessage;
-  }
-  return fallback;
-}
-function normalizeError(error, fallback = "Unknown error.", maxCauseDepth = 2) {
-  const seen = /* @__PURE__ */ new WeakSet();
-  return normalizeErrorInternal(error, fallback, maxCauseDepth, seen);
-}
-function normalizeErrorInternal(error, fallback, depthRemaining, seen) {
-  const record = asRecord(error);
-  if (record) {
-    if (seen.has(record)) {
-      return {
-        message: extractErrorMessage(error, fallback)
-      };
-    }
-    seen.add(record);
-  }
-  const message = extractErrorMessage(error, fallback);
-  const code = extractCode(error);
-  const name = extractName(error);
-  const details = extractDetails(error);
-  if (depthRemaining <= 0) {
-    return compactErrorInfo({
-      message,
-      ...code ? { code } : {},
-      ...name ? { name } : {},
-      ...details ? { details } : {}
-    });
-  }
-  const cause = extractCause(error);
-  if (!cause) {
-    return compactErrorInfo({
-      message,
-      ...code ? { code } : {},
-      ...name ? { name } : {},
-      ...details ? { details } : {}
-    });
-  }
-  const normalizedCause = normalizeErrorInternal(
-    cause,
-    "Caused by an unknown error.",
-    depthRemaining - 1,
-    seen
-  );
-  return compactErrorInfo({
-    message,
-    ...code ? { code } : {},
-    ...name ? { name } : {},
-    ...details ? { details } : {},
-    cause: normalizedCause
-  });
-}
-function compactErrorInfo(info) {
-  const safeDetails = toJsonSafeRecord(info.details);
-  return {
-    message: info.message,
-    ...info.code ? { code: info.code } : {},
-    ...info.name ? { name: info.name } : {},
-    ...safeDetails ? { details: safeDetails } : {},
-    ...info.cause ? { cause: info.cause } : {}
-  };
-}
-function extractCode(error) {
-  const record = asRecord(error);
-  const raw = record?.code;
-  if (typeof raw === "string" && raw.trim()) {
-    return raw.trim();
-  }
-  if (typeof raw === "number" && Number.isFinite(raw)) {
-    return String(raw);
-  }
-  return void 0;
-}
-function extractName(error) {
-  if (error instanceof Error && error.name.trim()) {
-    return error.name.trim();
-  }
-  const record = asRecord(error);
-  return toNonEmptyString(record?.name);
-}
-function extractDetails(error) {
-  const record = asRecord(error);
-  if (!record) return void 0;
-  const details = {};
-  const rawDetails = asRecord(record.details);
-  if (rawDetails) {
-    Object.assign(details, rawDetails);
-  }
-  const action = toNonEmptyString(record.action);
-  if (action) {
-    details.action = action;
-  }
-  const selectorUsed = toNonEmptyString(record.selectorUsed);
-  if (selectorUsed) {
-    details.selectorUsed = selectorUsed;
-  }
-  if (typeof record.status === "number" && Number.isFinite(record.status)) {
-    details.status = record.status;
-  }
-  const failure = asRecord(record.failure);
-  if (failure) {
-    const failureCode = toNonEmptyString(failure.code);
-    const classificationSource = toNonEmptyString(
-      failure.classificationSource
-    );
-    const failureDetails = asRecord(failure.details);
-    if (failureCode || classificationSource || failureDetails) {
-      details.actionFailure = {
-        ...failureCode ? { code: failureCode } : {},
-        ...classificationSource ? { classificationSource } : {},
-        ...failureDetails ? { details: failureDetails } : {}
-      };
-    }
-  }
-  return Object.keys(details).length ? details : void 0;
-}
-function extractCause(error) {
-  if (error instanceof Error) {
-    return error.cause;
-  }
-  const record = asRecord(error);
-  return record?.cause;
-}
-function asRecord(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return null;
-  }
-  return value;
-}
-function toNonEmptyString(value) {
-  if (typeof value !== "string") return void 0;
-  const normalized = value.trim();
-  return normalized.length ? normalized : void 0;
-}
-function toJsonSafeRecord(value) {
-  if (!value) return void 0;
-  const sanitized = toJsonSafeValue(value, /* @__PURE__ */ new WeakSet());
-  if (!sanitized || typeof sanitized !== "object" || Array.isArray(sanitized)) {
-    return void 0;
-  }
-  const record = sanitized;
-  return Object.keys(record).length > 0 ? record : void 0;
-}
-function toJsonSafeValue(value, seen) {
-  if (value === null) return null;
-  if (typeof value === "string" || typeof value === "boolean") {
-    return value;
-  }
-  if (typeof value === "number") {
-    return Number.isFinite(value) ? value : null;
-  }
-  if (typeof value === "bigint") {
-    return value.toString();
-  }
-  if (value === void 0 || typeof value === "function" || typeof value === "symbol") {
-    return void 0;
-  }
-  if (value instanceof Date) {
-    return Number.isNaN(value.getTime()) ? null : value.toISOString();
-  }
-  if (Array.isArray(value)) {
-    if (seen.has(value)) return "[Circular]";
-    seen.add(value);
-    const output = value.map((item) => {
-      const next = toJsonSafeValue(item, seen);
-      return next === void 0 ? null : next;
-    });
-    seen.delete(value);
-    return output;
-  }
-  if (value instanceof Set) {
-    if (seen.has(value)) return "[Circular]";
-    seen.add(value);
-    const output = Array.from(value, (item) => {
-      const next = toJsonSafeValue(item, seen);
-      return next === void 0 ? null : next;
-    });
-    seen.delete(value);
-    return output;
-  }
-  if (value instanceof Map) {
-    if (seen.has(value)) return "[Circular]";
-    seen.add(value);
-    const output = {};
-    for (const [key, item] of value.entries()) {
-      const normalizedKey = String(key);
-      const next = toJsonSafeValue(item, seen);
-      if (next !== void 0) {
-        output[normalizedKey] = next;
-      }
-    }
-    seen.delete(value);
-    return output;
-  }
-  if (typeof value === "object") {
-    const objectValue = value;
-    if (seen.has(objectValue)) return "[Circular]";
-    seen.add(objectValue);
-    const output = {};
-    for (const [key, item] of Object.entries(objectValue)) {
-      const next = toJsonSafeValue(item, seen);
-      if (next !== void 0) {
-        output[key] = next;
-      }
-    }
-    seen.delete(objectValue);
-    return output;
-  }
-  return void 0;
-}
-
-// src/storage/namespace.ts
-import path from "path";
-var DEFAULT_NAMESPACE = "default";
-function normalizeNamespace(input) {
-  const raw = String(input || "").trim().replace(/\\/g, "/");
-  if (!raw) return DEFAULT_NAMESPACE;
-  const segments = raw.split("/").map((segment) => sanitizeNamespaceSegment(segment)).filter((segment) => Boolean(segment));
-  if (!segments.length) return DEFAULT_NAMESPACE;
-  return segments.join("/");
-}
-function resolveNamespaceDir(rootDir, namespace) {
-  const selectorsRoot = path.resolve(rootDir, ".opensteer", "selectors");
-  const normalizedNamespace = normalizeNamespace(namespace);
-  const namespaceDir = path.resolve(selectorsRoot, normalizedNamespace);
-  const relative = path.relative(selectorsRoot, namespaceDir);
-  if (relative === "" || relative === ".") return namespaceDir;
-  if (relative.startsWith("..") || path.isAbsolute(relative)) {
-    throw new Error(
-      `Namespace "${namespace}" resolves outside selectors root.`
-    );
-  }
-  return namespaceDir;
-}
-function sanitizeNamespaceSegment(segment) {
-  const trimmed = String(segment || "").trim();
-  if (!trimmed || trimmed === "." || trimmed === "..") return "";
-  const replaced = trimmed.replace(/[^a-zA-Z0-9_-]+/g, "_");
-  const collapsed = replaced.replace(/_+/g, "_");
-  const bounded = collapsed.replace(/^_+|_+$/g, "");
-  return bounded || "";
-}
-
-// src/config.ts
-import fs from "fs";
-import path2 from "path";
-import { fileURLToPath } from "url";
-import { parse as parseDotenv } from "dotenv";
-
-// src/cloud/credential-selection.ts
-function selectCloudCredential(options) {
-  const apiKey = normalizeNonEmptyString(options.apiKey);
-  const accessToken = normalizeNonEmptyString(options.accessToken);
-  if (apiKey) {
-    if (options.authScheme === "bearer") {
-      return {
-        apiKey,
-        authScheme: "bearer",
-        kind: "access-token",
-        token: apiKey,
-        compatibilityBearerApiKey: true
-      };
-    }
-    return {
-      apiKey,
-      authScheme: "api-key",
-      kind: "api-key",
-      token: apiKey
-    };
-  }
-  if (accessToken) {
-    return {
-      accessToken,
-      authScheme: "bearer",
-      kind: "access-token",
-      token: accessToken
-    };
-  }
-  return null;
-}
-function selectCloudCredentialByPrecedence(layers, authScheme) {
-  for (const layer of layers) {
-    const hasApiKey = layer.hasApiKey ?? Object.prototype.hasOwnProperty.call(layer, "apiKey");
-    const hasAccessToken = layer.hasAccessToken ?? Object.prototype.hasOwnProperty.call(layer, "accessToken");
-    if (!hasApiKey && !hasAccessToken) {
-      continue;
-    }
-    return {
-      source: layer.source,
-      apiKey: layer.apiKey,
-      accessToken: layer.accessToken,
-      hasApiKey,
-      hasAccessToken,
-      credential: selectCloudCredential({
-        apiKey: layer.apiKey,
-        accessToken: layer.accessToken,
-        authScheme: layer.authScheme ?? authScheme
-      })
-    };
-  }
-  return null;
-}
-function normalizeNonEmptyString(value) {
-  if (typeof value !== "string") return void 0;
-  const normalized = value.trim();
-  return normalized.length ? normalized : void 0;
-}
-
-// src/config.ts
-var DEFAULT_CONFIG = {
-  browser: {
-    headless: void 0,
-    executablePath: void 0,
-    slowMo: 0,
-    mode: void 0,
-    cdpUrl: void 0,
-    userDataDir: void 0,
-    profileDirectory: void 0
-  },
-  storage: {
-    rootDir: process.cwd()
-  },
-  cursor: {
-    enabled: false,
-    profile: "snappy"
-  },
-  model: "gpt-5.1",
-  debug: false
-};
-function dotenvFileOrder(nodeEnv) {
-  const normalized = nodeEnv?.trim() || "";
-  const files = [];
-  if (normalized) {
-    files.push(`.env.${normalized}.local`);
-  }
-  if (normalized !== "test") {
-    files.push(".env.local");
-  }
-  if (normalized) {
-    files.push(`.env.${normalized}`);
-  }
-  files.push(".env");
-  return files;
-}
-function loadDotenvValues(rootDir, baseEnv, options = {}) {
-  const values = {};
-  if (parseBool(baseEnv.OPENSTEER_DISABLE_DOTENV_AUTOLOAD) === true) {
-    return values;
-  }
-  const debug = options.debug ?? parseBool(baseEnv.OPENSTEER_DEBUG) === true;
-  const baseDir = path2.resolve(rootDir);
-  const nodeEnv = baseEnv.NODE_ENV?.trim() || "";
-  for (const filename of dotenvFileOrder(nodeEnv)) {
-    const filePath = path2.join(baseDir, filename);
-    if (!fs.existsSync(filePath)) continue;
-    try {
-      const raw = fs.readFileSync(filePath, "utf8");
-      const parsed = parseDotenv(raw);
-      for (const [key, value] of Object.entries(parsed)) {
-        if (values[key] === void 0) {
-          values[key] = value;
-        }
-      }
-    } catch (error) {
-      const message = extractErrorMessage(
-        error,
-        "Unable to read or parse dotenv file."
-      );
-      if (debug) {
-        console.warn(
-          `[opensteer] failed to load dotenv file "${filePath}": ${message}`
-        );
-      }
-      continue;
-    }
-  }
-  return values;
-}
-function resolveEnv(rootDir, options = {}) {
-  const baseEnv = options.baseEnv ?? process.env;
-  const dotenvValues = loadDotenvValues(rootDir, baseEnv, options);
-  return {
-    ...dotenvValues,
-    ...baseEnv
-  };
-}
-function hasOwn(config, key) {
-  if (!config || typeof config !== "object") return false;
-  return Object.prototype.hasOwnProperty.call(config, key);
-}
-function hasLegacyAiConfig(config) {
-  return hasOwn(config, "ai");
-}
-function assertNoLegacyAiConfig(source, config) {
-  if (hasLegacyAiConfig(config)) {
-    throw new Error(
-      `Legacy "ai" config is no longer supported in ${source}. Use top-level "model" instead.`
-    );
-  }
-}
-function assertNoLegacyRuntimeConfig(source, config) {
-  if (!config || typeof config !== "object") return;
-  const configRecord = config;
-  if (hasOwn(configRecord, "runtime")) {
-    throw new Error(
-      `Legacy "runtime" config is no longer supported in ${source}. Use top-level "cloud" instead.`
-    );
-  }
-  if (hasOwn(configRecord, "mode")) {
-    throw new Error(
-      `Top-level "mode" config is no longer supported in ${source}. Use "cloud: true" to enable cloud mode.`
-    );
-  }
-  if (hasOwn(configRecord, "remote")) {
-    throw new Error(
-      `Top-level "remote" config is no longer supported in ${source}. Use "cloud" options instead.`
-    );
-  }
-  if (hasOwn(configRecord, "apiKey")) {
-    throw new Error(
-      `Top-level "apiKey" config is not supported in ${source}. Use "cloud.apiKey" instead.`
-    );
-  }
-}
-function loadConfigFile(rootDir, options = {}) {
-  const configPath = path2.join(rootDir, ".opensteer", "config.json");
-  if (!fs.existsSync(configPath)) return {};
-  try {
-    const raw = fs.readFileSync(configPath, "utf8");
-    return JSON.parse(raw);
-  } catch (error) {
-    const message = extractErrorMessage(
-      error,
-      "Unable to read or parse config file."
-    );
-    if (options.debug) {
-      console.warn(
-        `[opensteer] failed to load config file "${configPath}": ${message}`
-      );
-    }
-    return {};
-  }
-}
-function mergeDeep(base, patch) {
-  const out = {
-    ...base
-  };
-  for (const [key, value] of Object.entries(patch || {})) {
-    const currentValue = out[key];
-    if (value && typeof value === "object" && !Array.isArray(value) && currentValue && typeof currentValue === "object" && !Array.isArray(currentValue)) {
-      out[key] = mergeDeep(
-        currentValue,
-        value
-      );
-      continue;
-    }
-    if (value !== void 0) {
-      out[key] = value;
-    }
-  }
-  return out;
-}
-function parseBool(value) {
-  if (value == null) return void 0;
-  const normalized = value.trim().toLowerCase();
-  if (normalized === "true" || normalized === "1") return true;
-  if (normalized === "false" || normalized === "0") return false;
-  return void 0;
-}
-function parseNumber(value) {
-  if (value == null || value.trim() === "") return void 0;
-  const parsed = Number(value);
-  if (!Number.isFinite(parsed)) return void 0;
-  return parsed;
-}
-function parseRuntimeMode(value, source) {
-  if (value == null) return void 0;
-  if (typeof value !== "string") {
-    throw new Error(
-      `Invalid ${source} value "${String(value)}". Use "local" or "cloud".`
-    );
-  }
-  const normalized = value.trim().toLowerCase();
-  if (!normalized) return void 0;
-  if (normalized === "local" || normalized === "cloud") {
-    return normalized;
-  }
-  throw new Error(
-    `Invalid ${source} value "${value}". Use "local" or "cloud".`
-  );
-}
-function parseAuthScheme(value, source) {
-  if (value == null) return void 0;
-  if (typeof value !== "string") {
-    throw new Error(
-      `Invalid ${source} value "${String(value)}". Use "api-key" or "bearer".`
-    );
-  }
-  const normalized = value.trim().toLowerCase();
-  if (!normalized) return void 0;
-  if (normalized === "api-key" || normalized === "bearer") {
-    return normalized;
-  }
-  throw new Error(
-    `Invalid ${source} value "${value}". Use "api-key" or "bearer".`
-  );
-}
-function parseCloudAnnounce(value, source) {
-  if (value == null) return void 0;
-  if (typeof value !== "string") {
-    throw new Error(
-      `Invalid ${source} value "${String(value)}". Use "always", "off", or "tty".`
-    );
-  }
-  const normalized = value.trim().toLowerCase();
-  if (!normalized) return void 0;
-  if (normalized === "always" || normalized === "off" || normalized === "tty") {
-    return normalized;
-  }
-  throw new Error(
-    `Invalid ${source} value "${value}". Use "always", "off", or "tty".`
-  );
-}
-function resolveOpensteerApiKey(env) {
-  const value = env.OPENSTEER_API_KEY?.trim();
-  if (!value) return void 0;
-  return value;
-}
-function resolveOpensteerAccessToken(env) {
-  const value = env.OPENSTEER_ACCESS_TOKEN?.trim();
-  if (!value) return void 0;
-  return value;
-}
-function resolveOpensteerBaseUrl(env) {
-  const value = env.OPENSTEER_BASE_URL?.trim();
-  if (!value) return void 0;
-  return value;
-}
-function resolveOpensteerAuthScheme(env) {
-  return parseAuthScheme(env.OPENSTEER_AUTH_SCHEME, "OPENSTEER_AUTH_SCHEME");
-}
-function resolveOpensteerCloudProfileId(env) {
-  const value = env.OPENSTEER_CLOUD_PROFILE_ID?.trim();
-  if (!value) return void 0;
-  return value;
-}
-function resolveOpensteerCloudProfileReuseIfActive(env) {
-  return parseBool(env.OPENSTEER_CLOUD_PROFILE_REUSE_IF_ACTIVE);
-}
-function parseCloudBrowserProfileReuseIfActive(value) {
-  if (value == null) return void 0;
-  if (typeof value !== "boolean") {
-    throw new Error(
-      `Invalid cloud.browserProfile.reuseIfActive value "${String(
-        value
-      )}". Use true or false.`
-    );
-  }
-  return value;
-}
-function normalizeCloudBrowserProfileOptions(value, source) {
-  if (value == null) {
-    return void 0;
-  }
-  if (typeof value !== "object" || Array.isArray(value)) {
-    throw new Error(
-      `Invalid ${source} value "${String(value)}". Use an object with profileId and optional reuseIfActive.`
-    );
-  }
-  const record = value;
-  const rawProfileId = record.profileId;
-  if (typeof rawProfileId !== "string" || !rawProfileId.trim()) {
-    throw new Error(
-      `${source}.profileId must be a non-empty string when browserProfile is provided.`
-    );
-  }
-  return {
-    profileId: rawProfileId.trim(),
-    reuseIfActive: parseCloudBrowserProfileReuseIfActive(record.reuseIfActive)
-  };
-}
-function resolveEnvCloudBrowserProfile(profileId, reuseIfActive) {
-  if (reuseIfActive !== void 0 && !profileId) {
-    throw new Error(
-      "OPENSTEER_CLOUD_PROFILE_REUSE_IF_ACTIVE requires OPENSTEER_CLOUD_PROFILE_ID."
-    );
-  }
-  if (!profileId) {
-    return void 0;
-  }
-  return {
-    profileId,
-    reuseIfActive
-  };
-}
-function normalizeCloudOptions(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return void 0;
-  }
-  return value;
-}
-function parseCloudEnabled(value, source) {
-  if (value == null) return void 0;
-  if (typeof value === "boolean") return value;
-  if (typeof value === "object" && !Array.isArray(value)) return true;
-  throw new Error(
-    `Invalid ${source} value "${String(value)}". Use true, false, or a cloud options object.`
-  );
-}
-function resolveCloudCredentialFields(selectedLayer) {
-  const credential = selectedLayer?.credential;
-  if (!credential) return {};
-  if (credential.kind === "api-key" || credential.compatibilityBearerApiKey === true && selectedLayer?.source !== "env") {
-    return {
-      apiKey: credential.token
-    };
-  }
-  return {
-    accessToken: credential.token
-  };
-}
-function resolveCloudSelection(config, env = process.env) {
-  const configCloud = parseCloudEnabled(config.cloud, "cloud");
-  if (configCloud !== void 0) {
-    return {
-      cloud: configCloud,
-      source: "config.cloud"
-    };
-  }
-  const envMode = parseRuntimeMode(env.OPENSTEER_MODE, "OPENSTEER_MODE");
-  if (envMode) {
-    return {
-      cloud: envMode === "cloud",
-      source: "env.OPENSTEER_MODE"
-    };
-  }
-  return {
-    cloud: false,
-    source: "default"
-  };
-}
-function resolveConfigWithEnv(input = {}, options = {}) {
-  const processEnv = options.env ?? process.env;
-  const debugHint = typeof input.debug === "boolean" ? input.debug : parseBool(processEnv.OPENSTEER_DEBUG) === true;
-  const initialRootDir = input.storage?.rootDir ?? process.cwd();
-  const runtimeDefaults = mergeDeep(DEFAULT_CONFIG, {
-    storage: {
-      rootDir: initialRootDir
-    }
-  });
-  assertNoLegacyAiConfig("Opensteer constructor config", input);
-  assertNoLegacyRuntimeConfig("Opensteer constructor config", input);
-  const fileConfig = loadConfigFile(initialRootDir, {
-    debug: debugHint
-  });
-  assertNoLegacyAiConfig(".opensteer/config.json", fileConfig);
-  assertNoLegacyRuntimeConfig(".opensteer/config.json", fileConfig);
-  const fileCloudOptions = normalizeCloudOptions(fileConfig.cloud);
-  const fileHasCloudApiKey = hasOwn(fileCloudOptions, "apiKey");
-  const fileHasCloudAccessToken = hasOwn(fileCloudOptions, "accessToken");
-  const fileRootDir = typeof fileConfig.storage?.rootDir === "string" ? fileConfig.storage.rootDir : void 0;
-  assertNoRemovedBrowserConfig(input.browser, "Opensteer constructor config");
-  assertNoRemovedBrowserConfig(fileConfig.browser, ".opensteer/config.json");
-  const envRootDir = input.storage?.rootDir ?? fileRootDir ?? initialRootDir;
-  const env = resolveEnv(envRootDir, {
-    debug: debugHint,
-    baseEnv: processEnv
-  });
-  if (env.OPENSTEER_AI_MODEL) {
-    throw new Error(
-      "OPENSTEER_AI_MODEL is no longer supported. Use OPENSTEER_MODEL instead."
-    );
-  }
-  if (env.OPENSTEER_RUNTIME != null) {
-    throw new Error(
-      "OPENSTEER_RUNTIME is no longer supported. Use OPENSTEER_MODE instead."
-    );
-  }
-  if (env.OPENSTEER_CONNECT_URL != null) {
-    throw new Error(
-      "OPENSTEER_CONNECT_URL is no longer supported. Use OPENSTEER_CDP_URL instead."
-    );
-  }
-  if (env.OPENSTEER_CHANNEL != null) {
-    throw new Error(
-      "OPENSTEER_CHANNEL is no longer supported. Use OPENSTEER_BROWSER plus OPENSTEER_BROWSER_PATH when needed."
-    );
-  }
-  if (env.OPENSTEER_PROFILE_DIR != null) {
-    throw new Error(
-      "OPENSTEER_PROFILE_DIR is no longer supported. Use OPENSTEER_USER_DATA_DIR and OPENSTEER_PROFILE_DIRECTORY instead."
-    );
-  }
-  const envConfig = {
-    browser: {
-      headless: parseBool(env.OPENSTEER_HEADLESS),
-      executablePath: env.OPENSTEER_BROWSER_PATH || void 0,
-      slowMo: parseNumber(env.OPENSTEER_SLOW_MO),
-      mode: env.OPENSTEER_BROWSER === "real" || env.OPENSTEER_BROWSER === "chromium" ? env.OPENSTEER_BROWSER : void 0,
-      cdpUrl: env.OPENSTEER_CDP_URL || void 0,
-      userDataDir: env.OPENSTEER_USER_DATA_DIR || void 0,
-      profileDirectory: env.OPENSTEER_PROFILE_DIRECTORY || void 0
-    },
-    cursor: {
-      enabled: parseBool(env.OPENSTEER_CURSOR)
-    },
-    model: env.OPENSTEER_MODEL || void 0,
-    debug: parseBool(env.OPENSTEER_DEBUG)
-  };
-  const mergedWithFile = mergeDeep(runtimeDefaults, fileConfig);
-  const mergedWithEnv = mergeDeep(mergedWithFile, envConfig);
-  const resolved = mergeDeep(mergedWithEnv, input);
-  const browserHeadlessExplicit = input.browser?.headless !== void 0 || fileConfig.browser?.headless !== void 0 || envConfig.browser?.headless !== void 0;
-  if (!browserHeadlessExplicit && resolved.browser?.mode === "real") {
-    resolved.browser = {
-      ...resolved.browser,
-      headless: true
-    };
-  }
-  function assertNoRemovedBrowserConfig(value, source) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-      return;
-    }
-    const record = value;
-    if (record.connectUrl !== void 0) {
-      throw new Error(
-        `${source}.browser.connectUrl is no longer supported. Use browser.cdpUrl instead.`
-      );
-    }
-    if (record.channel !== void 0) {
-      throw new Error(
-        `${source}.browser.channel is no longer supported. Use browser.mode plus browser.executablePath instead.`
-      );
-    }
-    if (record.profileDir !== void 0) {
-      throw new Error(
-        `${source}.browser.profileDir is no longer supported. Use browser.userDataDir and browser.profileDirectory instead.`
-      );
-    }
-  }
-  const envApiKey = resolveOpensteerApiKey(env);
-  const envAccessTokenRaw = resolveOpensteerAccessToken(env);
-  const envBaseUrl = resolveOpensteerBaseUrl(env);
-  const envAuthScheme = resolveOpensteerAuthScheme(env);
-  const envCloudProfileId = resolveOpensteerCloudProfileId(env);
-  const envCloudProfileReuseIfActive = resolveOpensteerCloudProfileReuseIfActive(env);
-  const envCloudAnnounce = parseCloudAnnounce(
-    env.OPENSTEER_REMOTE_ANNOUNCE,
-    "OPENSTEER_REMOTE_ANNOUNCE"
-  );
-  const inputCloudOptions = normalizeCloudOptions(input.cloud);
-  const inputCloudBrowserProfile = normalizeCloudBrowserProfileOptions(
-    inputCloudOptions?.browserProfile,
-    "cloud.browserProfile"
-  );
-  const inputAuthScheme = parseAuthScheme(
-    inputCloudOptions?.authScheme,
-    "cloud.authScheme"
-  );
-  const inputCloudAnnounce = parseCloudAnnounce(
-    inputCloudOptions?.announce,
-    "cloud.announce"
-  );
-  const inputHasCloudApiKey = Boolean(
-    inputCloudOptions && Object.prototype.hasOwnProperty.call(inputCloudOptions, "apiKey")
-  );
-  const inputHasCloudAccessToken = Boolean(
-    inputCloudOptions && Object.prototype.hasOwnProperty.call(inputCloudOptions, "accessToken")
-  );
-  const inputHasCloudBaseUrl = Boolean(
-    inputCloudOptions && Object.prototype.hasOwnProperty.call(inputCloudOptions, "baseUrl")
-  );
-  const cloudSelection = resolveCloudSelection({
-    cloud: resolved.cloud
-  }, env);
-  if (cloudSelection.cloud) {
-    const resolvedCloud = normalizeCloudOptions(resolved.cloud) ?? {};
-    const {
-      apiKey: resolvedCloudApiKeyRaw,
-      accessToken: resolvedCloudAccessTokenRaw,
-      ...resolvedCloudRest
-    } = resolvedCloud;
-    const resolvedCloudBrowserProfile = normalizeCloudBrowserProfileOptions(
-      resolvedCloud.browserProfile,
-      "resolved.cloud.browserProfile"
-    );
-    const envCloudBrowserProfile = resolveEnvCloudBrowserProfile(
-      envCloudProfileId,
-      envCloudProfileReuseIfActive
-    );
-    const browserProfile = inputCloudBrowserProfile ?? envCloudBrowserProfile ?? resolvedCloudBrowserProfile;
-    let authScheme = inputAuthScheme ?? envAuthScheme ?? parseAuthScheme(resolvedCloud.authScheme, "cloud.authScheme") ?? "api-key";
-    const announce = inputCloudAnnounce ?? envCloudAnnounce ?? parseCloudAnnounce(resolvedCloud.announce, "cloud.announce") ?? "always";
-    const selectedCredentialLayer = selectCloudCredentialByPrecedence(
-      [
-        {
-          source: "input",
-          apiKey: inputCloudOptions?.apiKey,
-          accessToken: inputCloudOptions?.accessToken,
-          hasApiKey: inputHasCloudApiKey,
-          hasAccessToken: inputHasCloudAccessToken
-        },
-        {
-          source: "env",
-          apiKey: envApiKey,
-          accessToken: envAccessTokenRaw,
-          hasApiKey: envApiKey !== void 0,
-          hasAccessToken: envAccessTokenRaw !== void 0
-        },
-        {
-          source: "file",
-          apiKey: fileCloudOptions?.apiKey,
-          accessToken: fileCloudOptions?.accessToken,
-          hasApiKey: fileHasCloudApiKey,
-          hasAccessToken: fileHasCloudAccessToken
-        }
-      ],
-      authScheme
-    );
-    const { apiKey, accessToken } = resolveCloudCredentialFields(selectedCredentialLayer);
-    if (accessToken) {
-      authScheme = "bearer";
-    }
-    resolved.cloud = {
-      ...resolvedCloudRest,
-      ...apiKey ? { apiKey } : selectedCredentialLayer?.hasApiKey && !accessToken ? { apiKey: selectedCredentialLayer.apiKey } : {},
-      ...accessToken ? { accessToken } : selectedCredentialLayer?.hasAccessToken && !apiKey ? { accessToken: selectedCredentialLayer.accessToken } : {},
-      authScheme,
-      announce,
-      ...browserProfile ? { browserProfile } : {}
-    };
-  }
-  if (envBaseUrl && cloudSelection.cloud && !inputHasCloudBaseUrl) {
-    resolved.cloud = {
-      ...normalizeCloudOptions(resolved.cloud) ?? {},
-      baseUrl: envBaseUrl
-    };
-  }
-  return {
-    config: resolved,
-    env
-  };
-}
-function resolveNamespace(config, rootDir) {
-  if (config.name && config.name.trim()) {
-    return normalizeNamespace(config.name);
-  }
-  const caller = getCallerFilePath();
-  if (!caller) return normalizeNamespace("default");
-  const relative = path2.relative(rootDir, caller);
-  const cleaned = relative.replace(/\\/g, "/").replace(/\.(ts|tsx|js|mjs|cjs)$/, "");
-  return normalizeNamespace(cleaned || "default");
-}
-function getCallerFilePath() {
-  const stack = new Error().stack;
-  if (!stack) return null;
-  const lines = stack.split("\n").slice(2);
-  for (const line of lines) {
-    const match = line.match(/\((.*):(\d+):(\d+)\)/) || line.match(/at\s+(.*):(\d+):(\d+)/);
-    if (!match) continue;
-    const rawPath = match[1];
-    if (!rawPath) continue;
-    if (rawPath.includes("node:internal")) continue;
-    if (rawPath.includes("node_modules")) continue;
-    if (rawPath.includes("/opensteer-oss/src/")) continue;
-    try {
-      if (rawPath.startsWith("file://")) {
-        return fileURLToPath(rawPath);
-      }
-      return rawPath;
-    } catch {
-      continue;
-    }
-  }
-  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;
-  status;
-  details;
-  constructor(code, message, status, details) {
-    super(message);
-    this.name = "OpensteerCloudError";
-    this.code = code;
-    this.status = status;
-    this.details = details;
-  }
-};
-function cloudUnsupportedMethodError(method, message) {
-  return new OpensteerCloudError(
-    "CLOUD_UNSUPPORTED_METHOD",
-    message || `${method} is not supported in cloud mode.`
-  );
-}
-function cloudNotLaunchedError() {
-  return new OpensteerCloudError(
-    "CLOUD_SESSION_NOT_FOUND",
-    "Cloud session is not connected. Call launch() first."
-  );
-}
-
-// src/cloud/cdp-client.ts
-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);
-    let browser;
-    try {
-      browser = await chromium.connectOverCDP(endpoint);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : "Failed to connect to cloud CDP endpoint.";
-      throw new OpensteerCloudError("CLOUD_TRANSPORT_ERROR", message);
-    }
-    const contexts = browser.contexts();
-    const context = contexts[0];
-    if (!context) {
-      await browser.close();
-      throw new OpensteerCloudError(
-        "CLOUD_INTERNAL",
-        "Cloud browser returned no context."
-      );
-    }
-    const preferred = selectPreferredContextPage(browser, contexts);
-    if (preferred) {
-      return preferred;
-    }
-    const page = context.pages()[0] || await context.newPage();
-    return { browser, context, page };
-  }
-};
-function selectPreferredContextPage(browser, contexts) {
-  let aboutBlankCandidate = null;
-  for (const context of contexts) {
-    for (const page of context.pages()) {
-      const url = safePageUrl(page);
-      if (!isInternalOrEmptyUrl(url)) {
-        return { browser, context, page };
-      }
-      if (!aboutBlankCandidate && url === "about:blank") {
-        aboutBlankCandidate = { browser, context, page };
-      }
-    }
-  }
-  return aboutBlankCandidate;
-}
-function safePageUrl(page) {
-  try {
-    return page.url();
-  } catch {
-    return "";
-  }
-}
-function isInternalOrEmptyUrl(url) {
-  if (!url) return true;
-  if (url === "about:blank") return true;
-  return url.startsWith("chrome://") || url.startsWith("devtools://") || url.startsWith("edge://");
-}
-
-// src/utils/strip-trailing-slashes.ts
-function stripTrailingSlashes(value) {
-  let end = value.length;
-  while (end > 0 && value.charCodeAt(end - 1) === 47) {
-    end -= 1;
-  }
-  return end === value.length ? value : value.slice(0, end);
-}
-
-// src/cloud/http-client.ts
-function normalizeCloudBaseUrl(baseUrl) {
-  return stripTrailingSlashes(baseUrl);
-}
-function cloudAuthHeaders(key, authScheme) {
-  if (authScheme === "bearer") {
-    return {
-      authorization: `Bearer ${key}`
-    };
-  }
-  return {
-    "x-api-key": key
-  };
-}
-async function parseCloudHttpError(response) {
-  let body = null;
-  try {
-    body = await response.json();
-  } catch {
-    body = null;
-  }
-  const code = typeof body?.code === "string" ? toCloudErrorCode(body.code) : "CLOUD_TRANSPORT_ERROR";
-  const message = typeof body?.error === "string" ? body.error : `Cloud request failed with status ${response.status}.`;
-  return new OpensteerCloudError(code, message, response.status, body?.details);
-}
-function toCloudErrorCode(code) {
-  return isCloudErrorCode(code) ? code : "CLOUD_TRANSPORT_ERROR";
-}
-
-// src/cloud/session-client.ts
-var CACHE_IMPORT_BATCH_SIZE = 200;
-var CloudSessionClient = class {
-  baseUrl;
-  key;
-  authScheme;
-  constructor(baseUrl, key, authScheme = "api-key") {
-    this.baseUrl = normalizeCloudBaseUrl(baseUrl);
-    this.key = key;
-    this.authScheme = authScheme;
-  }
-  async create(request) {
-    const response = await fetch(`${this.baseUrl}/sessions`, {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        ...cloudAuthHeaders(this.key, this.authScheme)
-      },
-      body: JSON.stringify(request)
-    });
-    if (!response.ok) {
-      throw await parseCloudHttpError(response);
-    }
-    let body;
-    try {
-      body = await response.json();
-    } catch {
-      throw new OpensteerCloudError(
-        "CLOUD_CONTRACT_MISMATCH",
-        "Invalid cloud session create response: expected a JSON object.",
-        response.status
-      );
-    }
-    return parseCreateResponse(body, response.status);
-  }
-  async close(sessionId) {
-    const response = await fetch(`${this.baseUrl}/sessions/${sessionId}`, {
-      method: "DELETE",
-      headers: {
-        ...cloudAuthHeaders(this.key, this.authScheme)
-      }
-    });
-    if (response.status === 204) {
-      return;
-    }
-    if (!response.ok) {
-      throw await parseCloudHttpError(response);
-    }
-  }
-  async importSelectorCache(request) {
-    if (!request.entries.length) {
-      return zeroImportResponse();
-    }
-    let totals = zeroImportResponse();
-    for (let offset = 0; offset < request.entries.length; offset += CACHE_IMPORT_BATCH_SIZE) {
-      const batch = request.entries.slice(
-        offset,
-        offset + CACHE_IMPORT_BATCH_SIZE
-      );
-      const response = await this.importSelectorCacheBatch(batch);
-      totals = mergeImportResponse(totals, response);
-    }
-    return totals;
-  }
-  async importSelectorCacheBatch(entries) {
-    const response = await fetch(`${this.baseUrl}/selector-cache/import`, {
-      method: "POST",
-      headers: {
-        "content-type": "application/json",
-        ...cloudAuthHeaders(this.key, this.authScheme)
-      },
-      body: JSON.stringify({ entries })
-    });
-    if (!response.ok) {
-      throw await parseCloudHttpError(response);
-    }
-    return await response.json();
-  }
-};
-function parseCreateResponse(body, status) {
-  const root = requireObject(
-    body,
-    "Invalid cloud session create response: expected a JSON object.",
-    status
-  );
-  const sessionId = requireString(root, "sessionId", status);
-  const actionWsUrl = requireString(root, "actionWsUrl", status);
-  const cdpWsUrl = requireString(root, "cdpWsUrl", status);
-  const actionToken = requireString(root, "actionToken", status);
-  const cdpToken = requireString(root, "cdpToken", status);
-  const cloudSessionUrl = requireString(root, "cloudSessionUrl", status);
-  const cloudSessionRoot = requireObject(
-    root.cloudSession,
-    "Invalid cloud session create response: cloudSession must be an object.",
-    status
-  );
-  const cloudSession = {
-    sessionId: requireString(cloudSessionRoot, "sessionId", status, "cloudSession"),
-    workspaceId: requireString(
-      cloudSessionRoot,
-      "workspaceId",
-      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"),
-    label: optionalString(cloudSessionRoot, "label", status, "cloudSession")
-  };
-  const expiresAt = optionalNumber(root, "expiresAt", status);
-  return {
-    sessionId,
-    actionWsUrl,
-    cdpWsUrl,
-    actionToken,
-    cdpToken,
-    expiresAt,
-    cloudSessionUrl,
-    cloudSession
-  };
-}
-function requireObject(value, message, status) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    throw new OpensteerCloudError("CLOUD_CONTRACT_MISMATCH", message, status);
-  }
-  return value;
-}
-function requireString(source, field, status, parent) {
-  const value = source[field];
-  if (typeof value !== "string" || !value.trim()) {
-    throw new OpensteerCloudError(
-      "CLOUD_CONTRACT_MISMATCH",
-      `Invalid cloud session create response: ${formatFieldPath(
-        field,
-        parent
-      )} must be a non-empty string.`,
-      status
-    );
-  }
-  return value;
-}
-function requireNumber(source, field, status, parent) {
-  const value = source[field];
-  if (typeof value !== "number" || !Number.isFinite(value)) {
-    throw new OpensteerCloudError(
-      "CLOUD_CONTRACT_MISMATCH",
-      `Invalid cloud session create response: ${formatFieldPath(
-        field,
-        parent
-      )} must be a finite number.`,
-      status
-    );
-  }
-  return value;
-}
-function optionalString(source, field, status, parent) {
-  const value = source[field];
-  if (value == null) {
-    return void 0;
-  }
-  if (typeof value !== "string") {
-    throw new OpensteerCloudError(
-      "CLOUD_CONTRACT_MISMATCH",
-      `Invalid cloud session create response: ${formatFieldPath(
-        field,
-        parent
-      )} must be a string when present.`,
-      status
-    );
-  }
-  return value;
-}
-function optionalNumber(source, field, status, parent) {
-  const value = source[field];
-  if (value == null) {
-    return void 0;
-  }
-  if (typeof value !== "number" || !Number.isFinite(value)) {
-    throw new OpensteerCloudError(
-      "CLOUD_CONTRACT_MISMATCH",
-      `Invalid cloud session create response: ${formatFieldPath(
-        field,
-        parent
-      )} must be a finite number when present.`,
-      status
-    );
-  }
-  return value;
-}
-function requireSourceType(source, field, status, parent) {
-  const value = source[field];
-  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(
-    "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) {
-  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,
-    inserted: 0,
-    updated: 0,
-    skipped: 0
-  };
-}
-function mergeImportResponse(first, second) {
-  return {
-    imported: first.imported + second.imported,
-    inserted: first.inserted + second.inserted,
-    updated: first.updated + second.updated,
-    skipped: first.skipped + second.skipped
-  };
-}
-
-// src/cloud/runtime.ts
-var DEFAULT_CLOUD_BASE_URL = "https://api.opensteer.com";
-function createCloudRuntimeState(key, baseUrl = resolveCloudBaseUrl(), authScheme = "api-key") {
-  const normalizedBaseUrl = normalizeCloudBaseUrl(baseUrl);
-  return {
-    sessionClient: new CloudSessionClient(
-      normalizedBaseUrl,
-      key,
-      authScheme
-    ),
-    cdpClient: new CloudCdpClient(),
-    baseUrl: normalizedBaseUrl,
-    actionClient: null,
-    sessionId: null,
-    localRunId: null,
-    cloudSessionUrl: null
-  };
-}
-function resolveCloudBaseUrl() {
-  const value = process.env.OPENSTEER_BASE_URL?.trim();
-  if (!value) return DEFAULT_CLOUD_BASE_URL;
-  return normalizeCloudBaseUrl(value);
-}
-function readCloudActionDescription(payload) {
-  const description = payload.description;
-  if (typeof description !== "string") return void 0;
-  const normalized = description.trim();
-  return normalized.length ? normalized : void 0;
-}
-
-export {
-  extractErrorMessage,
-  normalizeError,
-  selectCloudCredential,
-  normalizeNamespace,
-  resolveNamespaceDir,
-  resolveCloudSelection,
-  resolveConfigWithEnv,
-  resolveNamespace,
-  cloudActionMethods,
-  cloudErrorCodes,
-  cloudSessionStatuses,
-  cloudSessionContractVersion,
-  cloudSessionSourceTypes,
-  isCloudActionMethod,
-  isCloudErrorCode,
-  isCloudSessionSourceType,
-  isCloudSessionStatus,
-  OpensteerCloudError,
-  cloudUnsupportedMethodError,
-  cloudNotLaunchedError,
-  withTokenQuery,
-  CloudCdpClient,
-  stripTrailingSlashes,
-  normalizeCloudBaseUrl,
-  cloudAuthHeaders,
-  parseCloudHttpError,
-  CloudSessionClient,
-  DEFAULT_CLOUD_BASE_URL,
-  createCloudRuntimeState,
-  readCloudActionDescription
-};