opensteer 0.8.10 → 0.8.11

package/dist/cli/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { assertProviderSupportsEngine, createOpensteerSemanticRuntime, OpensteerBrowserManager, dispatchSemanticOperation, loadEnvironment, normalizeOpensteerProviderMode, discoverLocalCdpBrowsers, inspectCdpEndpoint, resolveOpensteerRuntimeConfig, resolveOpensteerEngineName, resolveOpensteerProvider, resolveFilesystemWorkspacePath, FlowRecorderCollector, generateReplayScript, pathExists, readPersistedLocalBrowserSessionRecord, readPersistedCloudSessionRecord, OpensteerCloudClient, isProcessRunning } from '../chunk-F3X6UOEN.js';
+import { assertProviderSupportsEngine, createOpensteerSemanticRuntime, OpensteerBrowserManager, dispatchSemanticOperation, loadEnvironment, normalizeOpensteerProviderMode, discoverLocalCdpBrowsers, inspectCdpEndpoint, resolveOpensteerRuntimeConfig, resolveOpensteerEngineName, resolveOpensteerProvider, resolveFilesystemWorkspacePath, CloudSessionProxy, FlowRecorderCollector, generateReplayScript, pathExists, readPersistedLocalBrowserSessionRecord, readPersistedCloudSessionRecord, OpensteerCloudClient, isProcessRunning } from '../chunk-33FDEOQY.js';
 import process2 from 'process';
 import { spawn } from 'child_process';
 import { existsSync } from 'fs';
@@ -10,7 +10,7 @@ import { mkdir, writeFile } from 'fs/promises';
 
 // package.json
 var package_default = {
-  version: "0.8.9"};
+  version: "0.8.10"};
 
 // src/cli/env-loader.ts
 async function loadCliEnvironment(cwd) {
@@ -313,6 +313,65 @@ async function runOpensteerRecordCommand(input) {
     }
   }
 }
+async function runOpensteerCloudRecordCommand(input) {
+  const stdout = input.stdout ?? process.stdout;
+  const stderr = input.stderr ?? process.stderr;
+  const outputPath = resolveRecordOutputPath({
+    rootDir: input.rootDir,
+    workspace: input.workspace,
+    ...input.outputPath === void 0 ? {} : { outputPath: input.outputPath }
+  });
+  let cloud;
+  const resolveCloud = () => {
+    cloud ??= new OpensteerCloudClient(input.cloudConfig);
+    return cloud;
+  };
+  const runtime = input.runtime ?? new CloudSessionProxy(resolveCloud(), {
+    rootDir: input.rootDir,
+    workspace: input.workspace
+  });
+  const client = input.client ?? resolveCloud();
+  const sleep = input.sleep ?? delay;
+  let closed = false;
+  try {
+    await runtime.open({
+      url: input.url,
+      ...input.browser === void 0 ? {} : { browser: input.browser },
+      ...input.launch === void 0 ? {} : { launch: input.launch },
+      ...input.context === void 0 ? {} : { context: input.context }
+    });
+    const sessionId = await resolveCloudRecordingSessionId(runtime);
+    const sessionUrl = buildCloudRecordingSessionUrl(input.cloudConfig, sessionId);
+    await client.startSessionRecording(sessionId);
+    stderr.write(
+      `Recording browser actions for workspace "${input.workspace}". Open ${sessionUrl} and click "Stop recording" in the browser session toolbar when you're done.
+`
+    );
+    const completed = await waitForCloudRecordingCompletion({
+      client,
+      sessionId,
+      ...input.pollIntervalMs === void 0 ? {} : { pollIntervalMs: input.pollIntervalMs },
+      sleep
+    });
+    if (completed.result === void 0) {
+      throw new Error("Cloud recording completed without a replay script.");
+    }
+    await mkdir(path.dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, completed.result.script, "utf8");
+    await runtime.close();
+    closed = true;
+    stdout.write(`${outputPath}
+`);
+    stderr.write(`Cloud browser session: ${sessionUrl}
+`);
+    stderr.write(`Wrote replay script to ${outputPath}
+`);
+  } finally {
+    if (!closed) {
+      await runtime.close().catch(() => void 0);
+    }
+  }
+}
 function resolveRecordOutputPath(input) {
   if (input.outputPath !== void 0) {
     return path.resolve(input.rootDir, input.outputPath);
@@ -347,6 +406,35 @@ function createRecorderRuntimeAdapter(runtime) {
     }
   };
 }
+function buildCloudRecordingSessionUrl(cloudConfig, sessionId) {
+  const baseUrl = cloudConfig.appBaseUrl;
+  if (!baseUrl || baseUrl.trim().length === 0) {
+    throw new Error(
+      'record with provider=cloud requires OPENSTEER_CLOUD_APP_BASE_URL or "--cloud-app-base-url".'
+    );
+  }
+  return `${baseUrl.replace(/\/+$/, "")}/browsers/${encodeURIComponent(sessionId)}`;
+}
+async function resolveCloudRecordingSessionId(runtime) {
+  const info = await runtime.info();
+  if (typeof info.sessionId !== "string" || info.sessionId.length === 0) {
+    throw new Error("Cloud recording could not resolve the created session id.");
+  }
+  return info.sessionId;
+}
+async function waitForCloudRecordingCompletion(input) {
+  const pollIntervalMs = input.pollIntervalMs ?? 1e3;
+  for (; ; ) {
+    const state = await input.client.getSessionRecording(input.sessionId);
+    if (state.status === "completed") {
+      return state;
+    }
+    if (state.status === "failed") {
+      throw new Error(state.error ?? "Cloud recording failed.");
+    }
+    await input.sleep(pollIntervalMs);
+  }
+}
 function formatRecordedAction(action) {
   const time = new Date(action.timestamp).toISOString().slice(11, 19);
   switch (action.kind) {
@@ -378,6 +466,11 @@ function formatRecordedAction(action) {
       return `[${time}] reload ${action.pageId}`;
   }
 }
+function delay(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
 
 // src/cli/bin.ts
 var OPERATION_ALIASES = /* @__PURE__ */ new Map([
@@ -627,22 +720,39 @@ async function handleRecordCommandEntry(parsed) {
   }
   const provider = resolveCliProvider(parsed);
   assertCloudCliOptionsMatchProvider(parsed, provider.mode);
-  if (provider.mode !== "local") {
-    throw new Error(
-      'record requires provider=local. Set "--provider local" or clear OPENSTEER_PROVIDER.'
-    );
-  }
   const engineName = resolveCliEngineName(parsed);
   if (engineName !== "playwright") {
     throw new Error("record requires engine=playwright.");
   }
-  if (parsed.options.browser !== void 0 && parsed.options.browser !== "persistent") {
-    throw new Error('record only supports "--browser persistent".');
+  const rootDir = process2.cwd();
+  const recordBrowser = parsed.options.browser;
+  if (provider.mode === "cloud") {
+    if (typeof recordBrowser === "object") {
+      throw new Error('record does not support browser.mode="attach".');
+    }
+    const runtimeProvider = buildCliRuntimeProvider(parsed, provider.mode);
+    const runtimeConfig = resolveOpensteerRuntimeConfig({
+      ...runtimeProvider === void 0 ? {} : { provider: runtimeProvider },
+      environment: process2.env
+    });
+    await runOpensteerCloudRecordCommand({
+      cloudConfig: runtimeConfig.cloud,
+      workspace: parsed.options.workspace,
+      url,
+      rootDir,
+      ...recordBrowser === void 0 ? {} : { browser: recordBrowser },
+      ...parsed.options.launch === void 0 ? {} : { launch: parsed.options.launch },
+      ...parsed.options.context === void 0 ? {} : { context: parsed.options.context },
+      ...parsed.options.output === void 0 ? {} : { outputPath: parsed.options.output }
+    });
+    return;
   }
   if (parsed.options.launch?.headless === true) {
     throw new Error('record requires a headed browser. Remove "--headless true".');
   }
-  const rootDir = process2.cwd();
+  if (recordBrowser !== void 0 && recordBrowser !== "persistent") {
+    throw new Error('record only supports "--browser persistent".');
+  }
   const launch = {
     ...parsed.options.launch ?? {},
     headless: false
@@ -782,6 +892,7 @@ var CLI_OPTION_SPECS = {
   provider: { kind: "value" },
   "cloud-base-url": { kind: "value" },
   "cloud-api-key": { kind: "value" },
+  "cloud-app-base-url": { kind: "value" },
   "cloud-profile-id": { kind: "value" },
   "cloud-profile-reuse-if-active": { kind: "boolean" },
   json: { kind: "boolean" },
@@ -911,6 +1022,7 @@ function parseCommandLine(argv) {
   const provider = providerValue === void 0 ? void 0 : normalizeOpensteerProviderMode(providerValue, "--provider");
   const cloudBaseUrl = readSingle(rawOptions, "cloud-base-url");
   const cloudApiKey = readSingle(rawOptions, "cloud-api-key");
+  const cloudAppBaseUrl = readSingle(rawOptions, "cloud-app-base-url");
   const cloudProfileId = readSingle(rawOptions, "cloud-profile-id");
   const cloudProfileReuseIfActive = readOptionalBoolean(
     rawOptions,
@@ -932,6 +1044,7 @@ function parseCommandLine(argv) {
     ...provider === void 0 ? {} : { provider },
     ...cloudBaseUrl === void 0 ? {} : { cloudBaseUrl },
     ...cloudApiKey === void 0 ? {} : { cloudApiKey },
+    ...cloudAppBaseUrl === void 0 ? {} : { cloudAppBaseUrl },
     ...cloudProfileId === void 0 ? {} : { cloudProfileId },
     ...cloudProfileReuseIfActive === void 0 ? {} : { cloudProfileReuseIfActive },
     ...json === void 0 ? {} : { json },
@@ -1016,7 +1129,7 @@ function buildCliRuntimeProvider(parsed, providerMode) {
     return explicitProvider?.mode === "local" ? explicitProvider : void 0;
   }
   const browserProfile = buildCliBrowserProfile(parsed);
-  const hasCloudOverrides = parsed.options.cloudBaseUrl !== void 0 || parsed.options.cloudApiKey !== void 0 || browserProfile !== void 0;
+  const hasCloudOverrides = parsed.options.cloudBaseUrl !== void 0 || parsed.options.cloudApiKey !== void 0 || parsed.options.cloudAppBaseUrl !== void 0 || browserProfile !== void 0;
   if (!hasCloudOverrides && explicitProvider?.mode !== "cloud") {
     return void 0;
   }
@@ -1024,11 +1137,12 @@ function buildCliRuntimeProvider(parsed, providerMode) {
     mode: "cloud",
     ...parsed.options.cloudBaseUrl === void 0 ? {} : { baseUrl: parsed.options.cloudBaseUrl },
     ...parsed.options.cloudApiKey === void 0 ? {} : { apiKey: parsed.options.cloudApiKey },
+    ...parsed.options.cloudAppBaseUrl === void 0 ? {} : { appBaseUrl: parsed.options.cloudAppBaseUrl },
     ...browserProfile === void 0 ? {} : { browserProfile }
   };
 }
 function assertCloudCliOptionsMatchProvider(parsed, providerMode) {
-  if (providerMode !== "cloud" && (parsed.options.cloudBaseUrl !== void 0 || parsed.options.cloudApiKey !== void 0 || parsed.options.cloudProfileId !== void 0 || parsed.options.cloudProfileReuseIfActive === true)) {
+  if (providerMode !== "cloud" && (parsed.options.cloudBaseUrl !== void 0 || parsed.options.cloudApiKey !== void 0 || parsed.options.cloudAppBaseUrl !== void 0 || parsed.options.cloudProfileId !== void 0 || parsed.options.cloudProfileReuseIfActive === true)) {
     throw new Error(
       'Cloud-specific options require provider=cloud. Set "--provider cloud" or OPENSTEER_PROVIDER=cloud.'
     );
@@ -1170,6 +1284,7 @@ Common options:
   --provider local|cloud
   --cloud-base-url <url>
   --cloud-api-key <key>
+  --cloud-app-base-url <url>
   --cloud-profile-id <id>
   --cloud-profile-reuse-if-active <true|false>
   --json <true|false>