opensteer 0.9.6 → 0.9.8

package/dist/cli/bin.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { runLocalViewService } from '../chunk-3I3A5OLB.js';
-import { createOpensteerSemanticRuntime, dispatchSemanticOperation, isBrowserCoreError, loadEnvironment, normalizeOpensteerProviderMode, resolveOpensteerRuntimeConfig, assertProviderSupportsEngine, resolveOpensteerProvider, requireCloudAppBaseUrl, CloudSessionProxy, FlowRecorderCollector, generateReplayScript, OpensteerCloudClient } from '../chunk-BVRIPCWA.js';
-import { isOpensteerProtocolError, OpensteerBrowserManager, stopLocalViewService, setLocalViewMode, ensureLocalViewServiceRunning, buildLocalViewSessionUrl, resolveOpensteerEngineName, resolveFilesystemWorkspacePath } from '../chunk-3XBQRZZC.js';
-import { discoverLocalCdpBrowsers, inspectCdpEndpoint, readPersistedLocalBrowserSessionRecord, isProcessRunning, buildLocalViewSessionId, pathExists, readPersistedCloudSessionRecord } from '../chunk-T5P2QGZ3.js';
+import { runLocalViewService } from '../chunk-BPGXP3RF.js';
+import { createOpensteerSemanticRuntime, dispatchSemanticOperation, isBrowserCoreError, loadEnvironment, normalizeOpensteerProviderMode, resolveOpensteerRuntimeConfig, assertProviderSupportsEngine, resolveOpensteerProvider, requireCloudAppBaseUrl, CloudSessionProxy, FlowRecorderCollector, generateReplayScript, OpensteerCloudClient } from '../chunk-LFWP5RXF.js';
+import { isOpensteerProtocolError, OpensteerBrowserManager, stopLocalViewService, setLocalViewMode, ensureLocalViewServiceRunning, buildLocalViewSessionUrl, resolveOpensteerEngineName, resolveFilesystemWorkspacePath } from '../chunk-EXXRLPLI.js';
+import { discoverLocalCdpBrowsers, inspectCdpEndpoint, readPersistedLocalBrowserSessionRecord, getPersistedLocalBrowserSessionOwnership, isAttachedLocalBrowserSessionReachable, isProcessRunning, buildLocalViewSessionIdForRecord, pathExists, readPersistedCloudSessionRecord } from '../chunk-GKYBP3KD.js';
 import process4 from 'process';
 import { mkdir, writeFile } from 'fs/promises';
 import path2 from 'path';
@@ -14,7 +14,7 @@ import { fileURLToPath } from 'url';
 
 // package.json
 var package_default = {
-  version: "0.9.6"};
+  version: "0.9.8"};
 
 // src/cli/env-loader.ts
 async function loadCliEnvironment(cwd) {
@@ -656,14 +656,22 @@ async function buildOperationInput(operation, parsed, runtime) {
       return parsed.rest[0] === void 0 ? {} : { mode: parsed.rest[0] };
     case "page.evaluate":
       if (parsed.rest[0] === void 0) {
-        throw new CliError("missing_arguments", "evaluate requires a script.", CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          "evaluate requires a script.",
+          CLI_USAGE_HINTS[operation]
+        );
       }
       return {
         script: joinRest(parsed.rest, 0)
       };
     case "page.add-init-script":
       if (parsed.rest[0] === void 0) {
-        throw new CliError("missing_arguments", "init-script requires a script.", CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          "init-script requires a script.",
+          CLI_USAGE_HINTS[operation]
+        );
       }
       return {
         script: joinRest(parsed.rest, 0)
@@ -679,7 +687,11 @@ async function buildOperationInput(operation, parsed, runtime) {
       return buildElementTargetInput(parsed, "hover");
     case "dom.input": {
       if (parsed.rest[1] === void 0) {
-        throw new CliError("missing_arguments", "input requires an element number and text.", CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          "input requires an element number and text.",
+          CLI_USAGE_HINTS[operation]
+        );
       }
       const pressEnter = readOptionalBoolean(parsed.rawOptions, "press-enter");
       return {
@@ -710,7 +722,11 @@ async function buildOperationInput(operation, parsed, runtime) {
     }
     case "dom.extract": {
       if (parsed.rest[0] === void 0) {
-        throw new CliError("missing_arguments", "extract requires a template.", CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          "extract requires a template.",
+          CLI_USAGE_HINTS[operation]
+        );
       }
       const persist = readPersistKey(parsed, "extract");
       return {
@@ -746,7 +762,11 @@ async function buildOperationInput(operation, parsed, runtime) {
     }
     case "network.detail": {
       if (parsed.rest[0] === void 0) {
-        throw new CliError("missing_arguments", "network detail requires a record id.", CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          "network detail requires a record id.",
+          CLI_USAGE_HINTS[operation]
+        );
       }
       const probeFlag = readOptionalBoolean(parsed.rawOptions, "probe");
       return {
@@ -757,7 +777,11 @@ async function buildOperationInput(operation, parsed, runtime) {
     case "session.fetch": {
       const url = parsed.rest[0];
       if (url === void 0) {
-        throw new CliError("missing_arguments", "fetch requires a URL.", CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          "fetch requires a URL.",
+          CLI_USAGE_HINTS[operation]
+        );
       }
       const bodyJson = readJsonValue(parsed.rawOptions, "body");
       const bodyText = readSingle(parsed.rawOptions, "body-text");
@@ -796,7 +820,11 @@ async function buildOperationInput(operation, parsed, runtime) {
       const siteKey = readSingle(parsed.rawOptions, "site-key");
       const pageUrl = readSingle(parsed.rawOptions, "page-url");
       if (provider === void 0 || apiKey === void 0) {
-        throw new CliError("missing_arguments", 'captcha solve requires "--provider" and "--api-key".', CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          'captcha solve requires "--provider" and "--api-key".',
+          CLI_USAGE_HINTS[operation]
+        );
       }
       return {
         provider: readCaptchaProvider(provider),
@@ -826,7 +854,11 @@ async function buildOperationInput(operation, parsed, runtime) {
     case "scripts.beautify":
     case "scripts.deobfuscate": {
       if (parsed.rest[0] === void 0) {
-        throw new CliError("missing_arguments", `${parsed.command.join(" ")} requires an artifact id.`, CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          `${parsed.command.join(" ")} requires an artifact id.`,
+          CLI_USAGE_HINTS[operation]
+        );
       }
       const persist = readOptionalBoolean(parsed.rawOptions, "persist");
       return {
@@ -836,7 +868,11 @@ async function buildOperationInput(operation, parsed, runtime) {
     }
     case "scripts.sandbox":
       if (parsed.rest[0] === void 0) {
-        throw new CliError("missing_arguments", "scripts sandbox requires an artifact id.", CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          "scripts sandbox requires an artifact id.",
+          CLI_USAGE_HINTS[operation]
+        );
       }
       {
         const fidelity = readSingle(parsed.rawOptions, "fidelity");
@@ -885,14 +921,22 @@ async function buildOperationInput(operation, parsed, runtime) {
     case "interaction.get":
     case "interaction.replay":
       if (parsed.rest[0] === void 0) {
-        throw new CliError("missing_arguments", `${parsed.command.join(" ")} requires a trace id.`, CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          `${parsed.command.join(" ")} requires a trace id.`,
+          CLI_USAGE_HINTS[operation]
+        );
       }
       return {
         traceId: parsed.rest[0]
       };
     case "interaction.diff":
       if (parsed.rest[0] === void 0 || parsed.rest[1] === void 0) {
-        throw new CliError("missing_arguments", "interaction diff requires two trace ids.", CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          "interaction diff requires two trace ids.",
+          CLI_USAGE_HINTS[operation]
+        );
       }
       return {
         leftTraceId: parsed.rest[0],
@@ -900,7 +944,11 @@ async function buildOperationInput(operation, parsed, runtime) {
       };
     case "artifact.read":
       if (parsed.rest[0] === void 0) {
-        throw new CliError("missing_arguments", "artifact read requires an artifact id.", CLI_USAGE_HINTS[operation]);
+        throw new CliError(
+          "missing_arguments",
+          "artifact read requires an artifact id.",
+          CLI_USAGE_HINTS[operation]
+        );
       }
       return {
         artifactId: parsed.rest[0]
@@ -1038,7 +1086,10 @@ function buildComputerExecuteInput(parsed) {
         }
       };
     default:
-      throw new CliError("unknown_command", `Unknown computer command: ${parsed.command.join(" ")}`);
+      throw new CliError(
+        "unknown_command",
+        `Unknown computer command: ${parsed.command.join(" ")}`
+      );
   }
 }
 async function resolvePageRefByIndex(runtime, index) {
@@ -1068,7 +1119,10 @@ function readRequiredNumber(value, message) {
 }
 function readSingleDirection(value) {
   if (value === void 0 || !SCROLL_DIRECTIONS.has(value)) {
-    throw new CliError("missing_arguments", "scroll requires a direction: up, down, left, or right.");
+    throw new CliError(
+      "missing_arguments",
+      "scroll requires a direction: up, down, left, or right."
+    );
   }
   return value;
 }
@@ -1095,13 +1149,19 @@ function readCaptchaProvider(value) {
 }
 function readCaptchaType(value) {
   if (value === void 0 || !CAPTCHA_TYPES.has(value)) {
-    throw new CliError("invalid_value", 'Expected "--type" to be one of: recaptcha-v2, hcaptcha, turnstile.');
+    throw new CliError(
+      "invalid_value",
+      'Expected "--type" to be one of: recaptcha-v2, hcaptcha, turnstile.'
+    );
   }
   return value;
 }
 function readSandboxFidelity(value) {
   if (value === void 0 || !SANDBOX_FIDELITIES.has(value)) {
-    throw new CliError("invalid_value", 'Expected "--fidelity" to be one of: minimal, standard, full.');
+    throw new CliError(
+      "invalid_value",
+      'Expected "--fidelity" to be one of: minimal, standard, full.'
+    );
   }
   return value;
 }
@@ -1124,7 +1184,10 @@ function readKeyModifiers(value) {
   }
   for (const modifier of modifiers) {
     if (!KEY_MODIFIERS.has(modifier)) {
-      throw new CliError("invalid_value", 'Expected "--modifiers" to contain only: Shift, Control, Alt, Meta.');
+      throw new CliError(
+        "invalid_value",
+        'Expected "--modifiers" to contain only: Shift, Control, Alt, Meta.'
+      );
     }
   }
   return [...new Set(modifiers)];
@@ -1159,6 +1222,7 @@ function joinRest(rest, startIndex) {
 function renderOperationOutput(operation, result, input) {
   switch (operation) {
     case "session.open":
+    case "page.activate":
     case "page.goto":
       return renderJson(formatNavigationOutput(result));
     case "page.snapshot":
@@ -1167,14 +1231,14 @@ function renderOperationOutput(operation, result, input) {
     case "dom.hover":
     case "dom.input":
     case "dom.scroll":
-      return renderJson(formatActionOutput(result, input));
+      return renderJson(formatActionOutput(result));
     case "dom.extract":
       return renderJson(formatExtractOutput(result));
     case "page.list":
-    case "page.new":
-    case "page.activate":
     case "page.close":
       return formatTabOutput(result);
+    case "page.new":
+      return renderJson(formatCreatedPageOutput(result));
     case "network.query":
       return formatNetworkQueryOutput(result, input);
     case "network.detail":
@@ -1212,6 +1276,12 @@ function formatNavigationOutput(result) {
     ...readStringField(result, "title") === void 0 ? {} : { title: readStringField(result, "title") }
   };
 }
+function formatCreatedPageOutput(result) {
+  return {
+    ...readStringField(result, "pageRef") === void 0 ? {} : { pageRef: readStringField(result, "pageRef") },
+    ...formatNavigationOutput(result)
+  };
+}
 function formatSnapshotOutput(result) {
   if (result !== null && typeof result === "object" && typeof result.html === "string") {
     return `${result.html}
@@ -1219,36 +1289,11 @@ function formatSnapshotOutput(result) {
   }
   return renderJson(result);
 }
-function formatActionOutput(result, input) {
-  const target = readObjectField(result, "target");
-  const output = {
-    ...readStringField(target, "tagName") === void 0 ? {} : { tagName: readStringField(target, "tagName") },
-    ...readStringField(target, "pathHint") === void 0 ? {} : { pathHint: readStringField(target, "pathHint") }
+function formatActionOutput(result) {
+  return {
+    ...readStringField(result, "tagName") === void 0 ? {} : { tagName: readStringField(result, "tagName") },
+    ...readStringField(result, "persist") === void 0 ? {} : { persist: readStringField(result, "persist") }
   };
-  const point = readObjectField(result, "point");
-  if (point !== void 0) {
-    output.point = {
-      ...readNumberField(point, "x") === void 0 ? {} : { x: readNumberField(point, "x") },
-      ...readNumberField(point, "y") === void 0 ? {} : { y: readNumberField(point, "y") }
-    };
-  }
-  const persist = readStringField(target, "persist");
-  if (persist !== void 0) {
-    output.persist = persist;
-  }
-  const text = readStringField(input, "text");
-  if (text !== void 0) {
-    output.text = text;
-  }
-  const direction = readStringField(input, "direction");
-  if (direction !== void 0) {
-    output.direction = direction;
-  }
-  const amount = readNumberField(input, "amount");
-  if (amount !== void 0) {
-    output.amount = amount;
-  }
-  return output;
 }
 function formatExtractOutput(result) {
   const data = readUnknownField(result, "data");
@@ -1480,20 +1525,18 @@ function formatStateOutput(result) {
 `;
 }
 function formatComputerOutput(result) {
-  const action = readObjectField(result, "action");
   const screenshot = readObjectField(result, "screenshot");
   const payload = readObjectField(screenshot, "payload");
-  const timing = readObjectField(result, "timing");
   return {
-    ...action === void 0 ? {} : { action },
+    ...readStringField(result, "url") === void 0 ? {} : { url: readStringField(result, "url") },
+    ...readStringField(result, "title") === void 0 ? {} : { title: readStringField(result, "title") },
     ...payload === void 0 ? {} : {
       screenshot: {
         ...readStringField(payload, "uri") === void 0 ? {} : { uri: readStringField(payload, "uri") },
         ...readStringField(screenshot, "format") === void 0 ? {} : { format: readStringField(screenshot, "format") },
         ...readObjectField(screenshot, "size") === void 0 ? {} : { size: readObjectField(screenshot, "size") }
       }
-    },
-    ...timing === void 0 ? {} : { timingMs: timing }
+    }
   };
 }
 function formatScriptsCaptureOutput(result) {
@@ -2141,7 +2184,7 @@ async function collectOpensteerStatus(input) {
     ...output,
     rootPath,
     lanes: {
-      local: describeLocalLane(localRecord, input.provider.mode === "local"),
+      local: await describeLocalLane(localRecord, input.provider.mode === "local"),
       cloud: await describeCloudLane({
         record: cloudRecord,
         current: input.provider.mode === "cloud",
@@ -2193,8 +2236,38 @@ async function readWorkspaceCloudRecord(rootPath) {
   }
   return readPersistedCloudSessionRecord(rootPath);
 }
-function describeLocalLane(record, current) {
-  if (record === void 0 || !isProcessRunning(record.pid)) {
+async function describeLocalLane(record, current) {
+  if (record === void 0) {
+    return {
+      provider: "local",
+      status: "idle",
+      current,
+      summary: "none"
+    };
+  }
+  if (getPersistedLocalBrowserSessionOwnership(record) === "attached") {
+    if (!await isAttachedLocalBrowserSessionReachable(record)) {
+      return {
+        provider: "local",
+        status: "stale",
+        current,
+        summary: "attached browser unavailable",
+        detail: record.engine,
+        engine: record.engine
+      };
+    }
+    const browser2 = record.executablePath ? path2.basename(record.executablePath).replace(/\.[A-Za-z0-9]+$/u, "") : void 0;
+    return {
+      provider: "local",
+      status: "active",
+      current,
+      summary: "attached browser",
+      detail: browser2 ?? record.engine,
+      engine: record.engine,
+      ...browser2 === void 0 ? {} : { browser: browser2 }
+    };
+  }
+  if (!isProcessRunning(record.pid)) {
     return {
       provider: "local",
       status: "idle",
@@ -2340,13 +2413,19 @@ async function resolveWorkspaceSessionId(input) {
     workspace: input.workspace
   });
   const live = await readPersistedLocalBrowserSessionRecord(rootPath);
-  if (!live || !isProcessRunning(live.pid)) {
+  if (!live) {
     return void 0;
   }
-  return buildLocalViewSessionId({
+  if (getPersistedLocalBrowserSessionOwnership(live) === "attached") {
+    if (!await isAttachedLocalBrowserSessionReachable(live)) {
+      return void 0;
+    }
+  } else if (!isProcessRunning(live.pid)) {
+    return void 0;
+  }
+  return buildLocalViewSessionIdForRecord({
     rootPath,
-    pid: live.pid,
-    startedAt: live.startedAt
+    live
   });
 }
 function assertNoViewPreferenceFlag(parsed) {
@@ -2442,7 +2521,10 @@ async function main() {
     throw new CliError("unknown_command", `Unknown command: ${parsed.command.join(" ")}`);
   }
   if (parsed.options.workspace === void 0) {
-    throw new CliError("missing_workspace", 'Stateful commands require "--workspace <id>" or OPENSTEER_WORKSPACE.');
+    throw new CliError(
+      "missing_workspace",
+      'Stateful commands require "--workspace <id>" or OPENSTEER_WORKSPACE.'
+    );
   }
   const { engineName, provider, runtimeProvider } = resolveCliRuntimeSelection(parsed);
   if (operation === "session.close") {
@@ -2489,7 +2571,10 @@ async function main() {
 }
 async function handleExecCommand(parsed) {
   if (parsed.options.workspace === void 0) {
-    throw new CliError("missing_workspace", 'exec requires "--workspace <id>" or OPENSTEER_WORKSPACE.');
+    throw new CliError(
+      "missing_workspace",
+      'exec requires "--workspace <id>" or OPENSTEER_WORKSPACE.'
+    );
   }
   const expression = parsed.rest.join(" ");
   if (!expression) {
@@ -2500,7 +2585,7 @@ async function handleExecCommand(parsed) {
     );
   }
   const { engineName, runtimeProvider } = resolveCliRuntimeSelection(parsed);
-  const { Opensteer } = await import('../opensteer-UGA6YBRN.js');
+  const { Opensteer } = await import('../opensteer-XLPY343Y.js');
   const opensteer = new Opensteer({
     workspace: parsed.options.workspace,
     rootDir: process4.cwd(),
@@ -2632,7 +2717,10 @@ async function handleCloseCommand(parsed, engineName, providerMode, runtimeProvi
 }
 async function handleRecordCommandEntry(parsed) {
   if (parsed.options.workspace === void 0) {
-    throw new CliError("missing_workspace", 'record requires "--workspace <id>" or OPENSTEER_WORKSPACE.');
+    throw new CliError(
+      "missing_workspace",
+      'record requires "--workspace <id>" or OPENSTEER_WORKSPACE.'
+    );
   }
   const url = parsed.options.url ?? parsed.rest[0];
   if (url === void 0) {
@@ -2672,7 +2760,10 @@ async function handleRecordCommandEntry(parsed) {
     return;
   }
   if (parsed.options.launch?.headless === true) {
-    throw new CliError("config_conflict", 'record requires a headed browser. Remove "--headless true".');
+    throw new CliError(
+      "config_conflict",
+      'record requires a headed browser. Remove "--headless true".'
+    );
   }
   if (typeof recordBrowser === "object") {
     throw new CliError("config_conflict", 'record does not support browser.mode="attach".');
@@ -2744,7 +2835,10 @@ function resolveCliBootstrapAction(argv) {
 }
 function buildCliBrowserProfile(parsed) {
   if (parsed.options.cloudProfileReuseIfActive === true && parsed.options.cloudProfileId === void 0) {
-    throw new CliError("invalid_option", '"--cloud-profile-reuse-if-active" requires "--cloud-profile-id <id>".');
+    throw new CliError(
+      "invalid_option",
+      '"--cloud-profile-reuse-if-active" requires "--cloud-profile-id <id>".'
+    );
   }
   return parsed.options.cloudProfileId === void 0 ? void 0 : {
     profileId: parsed.options.cloudProfileId,