opensteer 0.6.13 → 0.7.1

package/dist/cli/server.js

@@ -1,977 +0,0 @@
-import {
-  Opensteer
-} from "../chunk-HBTSQ2V4.js";
-import {
-  normalizeError,
-  resolveCloudSelection,
-  resolveConfigWithEnv
-} from "../chunk-2ES46WCO.js";
-import "../chunk-K5CL76MG.js";
-import "../chunk-3H5RRIMZ.js";
-
-// src/cli/server.ts
-import { createServer } from "net";
-import { writeFileSync, unlinkSync, existsSync } from "fs";
-
-// src/cli/paths.ts
-import { tmpdir } from "os";
-import { join } from "path";
-function prefix(session2) {
-  return `opensteer-${session2}`;
-}
-function getSocketPath(session2) {
-  return join(tmpdir(), `${prefix(session2)}.sock`);
-}
-function getPidPath(session2) {
-  return join(tmpdir(), `${prefix(session2)}.pid`);
-}
-function getMetadataPath(session2) {
-  return join(tmpdir(), `${prefix(session2)}.meta.json`);
-}
-
-// src/cli/commands.ts
-import { writeFile } from "fs/promises";
-var commands = {
-  async navigate(opensteer, args) {
-    const url = args.url;
-    if (!url) throw new Error("Missing required argument: url");
-    await opensteer.goto(url, {
-      timeout: args.timeout,
-      settleMs: args.settleMs,
-      waitUntil: args.waitUntil
-    });
-    return { url: opensteer.page.url() };
-  },
-  async back(opensteer) {
-    await opensteer.page.goBack();
-    return { url: opensteer.page.url() };
-  },
-  async forward(opensteer) {
-    await opensteer.page.goForward();
-    return { url: opensteer.page.url() };
-  },
-  async reload(opensteer) {
-    await opensteer.page.reload();
-    return { url: opensteer.page.url() };
-  },
-  async snapshot(opensteer, args) {
-    const mode = args.mode || "action";
-    const html = await opensteer.snapshot({ mode });
-    return { html };
-  },
-  async state(opensteer) {
-    return await opensteer.state();
-  },
-  async cursor(opensteer, args) {
-    const mode = typeof args.mode === "string" ? args.mode : "status";
-    if (mode === "on") {
-      opensteer.setCursorEnabled(true);
-    } else if (mode === "off") {
-      opensteer.setCursorEnabled(false);
-    } else if (mode !== "status") {
-      throw new Error(
-        `Invalid cursor mode "${String(mode)}". Use "on", "off", or "status".`
-      );
-    }
-    return {
-      cursor: opensteer.getCursorState()
-    };
-  },
-  async screenshot(opensteer, args) {
-    const file = args.file || "screenshot.png";
-    const type = file.endsWith(".jpg") || file.endsWith(".jpeg") ? "jpeg" : "png";
-    const buffer = await opensteer.screenshot({
-      fullPage: args.fullPage,
-      type
-    });
-    await writeFile(file, buffer);
-    return { file };
-  },
-  async click(opensteer, args) {
-    return await opensteer.click({
-      element: args.element,
-      selector: args.selector,
-      description: args.description,
-      button: args.button,
-      clickCount: args.clickCount
-    });
-  },
-  async dblclick(opensteer, args) {
-    return await opensteer.dblclick({
-      element: args.element,
-      selector: args.selector,
-      description: args.description
-    });
-  },
-  async rightclick(opensteer, args) {
-    return await opensteer.rightclick({
-      element: args.element,
-      selector: args.selector,
-      description: args.description
-    });
-  },
-  async hover(opensteer, args) {
-    return await opensteer.hover({
-      element: args.element,
-      selector: args.selector,
-      description: args.description
-    });
-  },
-  async input(opensteer, args) {
-    const text = args.text;
-    if (text == null) throw new Error("Missing required argument: text");
-    return await opensteer.input({
-      element: args.element,
-      selector: args.selector,
-      description: args.description,
-      text,
-      clear: args.clear,
-      pressEnter: args.pressEnter
-    });
-  },
-  async select(opensteer, args) {
-    return await opensteer.select({
-      element: args.element,
-      selector: args.selector,
-      description: args.description,
-      value: args.value,
-      label: args.label,
-      index: args.index
-    });
-  },
-  async scroll(opensteer, args) {
-    return await opensteer.scroll({
-      element: args.element,
-      selector: args.selector,
-      description: args.description,
-      direction: args.direction,
-      amount: args.amount
-    });
-  },
-  async press(opensteer, args) {
-    const key = args.key;
-    if (!key) throw new Error("Missing required argument: key");
-    await opensteer.pressKey(key);
-    return { key };
-  },
-  async type(opensteer, args) {
-    const text = args.text;
-    if (text == null) throw new Error("Missing required argument: text");
-    await opensteer.type(text);
-    return { text };
-  },
-  async "get-text"(opensteer, args) {
-    const text = await opensteer.getElementText({
-      element: args.element,
-      selector: args.selector,
-      description: args.description
-    });
-    return { text };
-  },
-  async "get-value"(opensteer, args) {
-    const value = await opensteer.getElementValue({
-      element: args.element,
-      selector: args.selector,
-      description: args.description
-    });
-    return { value };
-  },
-  async "get-attrs"(opensteer, args) {
-    const attributes = await opensteer.getElementAttributes({
-      element: args.element,
-      selector: args.selector,
-      description: args.description
-    });
-    return { attributes };
-  },
-  async "get-html"(opensteer, args) {
-    const html = await opensteer.getHtml(args.selector);
-    return { html };
-  },
-  async tabs(opensteer) {
-    const tabs = await opensteer.tabs();
-    return { tabs };
-  },
-  async "tab-new"(opensteer, args) {
-    return await opensteer.newTab(args.url);
-  },
-  async "tab-switch"(opensteer, args) {
-    const index = args.index;
-    if (index == null) throw new Error("Missing required argument: index");
-    await opensteer.switchTab(index);
-    return { index };
-  },
-  async "tab-close"(opensteer, args) {
-    await opensteer.closeTab(args.index);
-    return {};
-  },
-  async cookies(opensteer, args) {
-    const cookies = await opensteer.getCookies(args.url);
-    return { cookies };
-  },
-  async "cookie-set"(opensteer, args) {
-    await opensteer.setCookie({
-      name: args.name,
-      value: args.value,
-      url: args.url,
-      domain: args.domain,
-      path: args.path,
-      expires: args.expires,
-      httpOnly: args.httpOnly,
-      secure: args.secure,
-      sameSite: args.sameSite
-    });
-    return {};
-  },
-  async "cookies-clear"(opensteer) {
-    await opensteer.clearCookies();
-    return {};
-  },
-  async "cookies-export"(opensteer, args) {
-    const file = args.file;
-    if (!file) throw new Error("Missing required argument: file");
-    await opensteer.exportCookies(file, args.url);
-    return { file };
-  },
-  async "cookies-import"(opensteer, args) {
-    const file = args.file;
-    if (!file) throw new Error("Missing required argument: file");
-    await opensteer.importCookies(file);
-    return { file };
-  },
-  async eval(opensteer, args) {
-    const expression = args.expression;
-    if (!expression)
-      throw new Error("Missing required argument: expression");
-    const result = await opensteer.page.evaluate(expression);
-    return { result };
-  },
-  async "wait-for"(opensteer, args) {
-    const text = args.text;
-    if (!text) throw new Error("Missing required argument: text");
-    await opensteer.waitForText(text, {
-      timeout: args.timeout
-    });
-    return { text };
-  },
-  async "wait-selector"(opensteer, args) {
-    const selector = args.selector;
-    if (!selector) throw new Error("Missing required argument: selector");
-    await opensteer.page.waitForSelector(selector, {
-      timeout: args.timeout ?? 3e4
-    });
-    return { selector };
-  },
-  async extract(opensteer, args) {
-    const schema = args.schema;
-    const data = await opensteer.extract({
-      schema,
-      description: args.description,
-      prompt: args.prompt
-    });
-    return { data };
-  }
-};
-function getCommandHandler(name) {
-  return commands[name];
-}
-
-// src/cli/cloud-profile-binding.ts
-function normalizeCloudProfileBinding(value) {
-  if (!value) {
-    return null;
-  }
-  const profileId = typeof value.profileId === "string" ? value.profileId.trim() : "";
-  if (!profileId) {
-    return null;
-  }
-  return {
-    profileId,
-    reuseIfActive: typeof value.reuseIfActive === "boolean" ? value.reuseIfActive : void 0
-  };
-}
-function resolveConfiguredCloudProfileBinding(config) {
-  if (!isCloudConfigured(config)) {
-    return null;
-  }
-  return normalizeCloudProfileBinding(config.cloud.browserProfile);
-}
-function resolveSessionCloudProfileBinding(config, requested) {
-  if (!isCloudConfigured(config)) {
-    return null;
-  }
-  return requested ?? resolveConfiguredCloudProfileBinding(config);
-}
-function assertCompatibleCloudProfileBinding(sessionId, active, requested) {
-  if (!requested) {
-    return;
-  }
-  if (!active) {
-    throw new Error(
-      [
-        `Session '${sessionId}' is already running without a bound cloud browser profile.`,
-        "Cloud browser profile selection only applies when the session is first opened.",
-        "Close this session or use a different --session to target another profile."
-      ].join(" ")
-    );
-  }
-  if (active.profileId === requested.profileId && active.reuseIfActive === requested.reuseIfActive) {
-    return;
-  }
-  throw new Error(
-    [
-      `Session '${sessionId}' is already bound to cloud browser profile ${formatCloudProfileBinding(active)}.`,
-      `Requested ${formatCloudProfileBinding(requested)} does not match.`,
-      "Use the same cloud profile for this session, or start a different --session."
-    ].join(" ")
-  );
-}
-function formatCloudProfileBinding(binding) {
-  if (binding.reuseIfActive === void 0) {
-    return `'${binding.profileId}'`;
-  }
-  return `'${binding.profileId}' (reuseIfActive=${String(
-    binding.reuseIfActive
-  )})`;
-}
-function isCloudConfigured(config) {
-  return Boolean(
-    config.cloud && typeof config.cloud === "object" && !Array.isArray(config.cloud)
-  );
-}
-
-// src/cli/open-cloud-auth.ts
-function normalizeCliOpenCloudAuth(value) {
-  if (value == null) {
-    return null;
-  }
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error("Invalid open request cloud auth payload.");
-  }
-  const record = value;
-  const apiKey = normalizeNonEmptyString(record.apiKey);
-  const accessToken = normalizeNonEmptyString(record.accessToken);
-  const baseUrl = normalizeNonEmptyString(record.baseUrl);
-  const authScheme = normalizeAuthScheme(record.authScheme);
-  if (!baseUrl) {
-    throw new Error("Open request cloud auth payload is missing baseUrl.");
-  }
-  if ((apiKey ? 1 : 0) + (accessToken ? 1 : 0) !== 1) {
-    throw new Error(
-      "Open request cloud auth payload must include exactly one credential."
-    );
-  }
-  if (accessToken && authScheme !== "bearer") {
-    throw new Error(
-      'Open request cloud auth payload must use authScheme "bearer" with accessToken.'
-    );
-  }
-  return {
-    ...apiKey ? { apiKey } : {},
-    ...accessToken ? { accessToken } : {},
-    baseUrl,
-    authScheme
-  };
-}
-function buildServerOpenConfig(options) {
-  const config = {
-    name: options.name,
-    storage: {
-      rootDir: options.scopeDir
-    },
-    cursor: {
-      enabled: options.cursorEnabled
-    },
-    browser: {
-      headless: options.headless,
-      mode: options.mode,
-      cdpUrl: options.cdpUrl,
-      userDataDir: options.userDataDir,
-      profileDirectory: options.profileDirectory,
-      executablePath: options.executablePath
-    }
-  };
-  if (!options.cloudAuth) {
-    return config;
-  }
-  const resolved = resolveConfigWithEnv(
-    {
-      storage: {
-        rootDir: options.scopeDir
-      }
-    },
-    {
-      env: options.env
-    }
-  );
-  const cloudSelection = resolveCloudSelection(
-    {
-      cloud: resolved.config.cloud
-    },
-    resolved.env
-  );
-  if (!cloudSelection.cloud) {
-    return config;
-  }
-  config.cloud = toOpensteerCloudOptions(options.cloudAuth);
-  return config;
-}
-function toOpensteerCloudOptions(auth) {
-  return {
-    ...auth.apiKey ? { apiKey: auth.apiKey } : {},
-    ...auth.accessToken ? { accessToken: auth.accessToken } : {},
-    baseUrl: auth.baseUrl,
-    authScheme: auth.authScheme
-  };
-}
-function normalizeNonEmptyString(value) {
-  if (typeof value !== "string") {
-    return void 0;
-  }
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-}
-function normalizeAuthScheme(value) {
-  if (value === "api-key" || value === "bearer") {
-    return value;
-  }
-  throw new Error(
-    'Open request cloud auth payload must use authScheme "api-key" or "bearer".'
-  );
-}
-
-// src/cli/open-browser-config.ts
-function resolveCliBrowserRequestConfig(options) {
-  const mode = options.browser ?? (options.profileDirectory || options.userDataDir || options.executablePath ? "real" : void 0);
-  return {
-    mode,
-    headless: options.headless ?? (mode === "real" ? true : void 0),
-    cdpUrl: options.cdpUrl,
-    profileDirectory: options.profileDirectory,
-    userDataDir: options.userDataDir,
-    executablePath: options.executablePath
-  };
-}
-
-// src/cli/server.ts
-var instance = null;
-var launchPromise = null;
-var selectorNamespace = null;
-var cloudProfileBinding = null;
-var cloudAuthOverride = null;
-var cursorEnabledPreference = readCursorPreferenceFromEnv();
-var requestQueue = Promise.resolve();
-var shuttingDown = false;
-function sanitizeNamespace(value) {
-  const trimmed = String(value || "").trim();
-  if (!trimmed || trimmed === "." || trimmed === "..") {
-    return "default";
-  }
-  const replaced = trimmed.replace(/[^a-zA-Z0-9_-]+/g, "_");
-  const collapsed = replaced.replace(/_+/g, "_");
-  const bounded = collapsed.replace(/^_+|_+$/g, "");
-  return bounded || "default";
-}
-function invalidateInstance() {
-  if (!instance) return;
-  instance.close().catch(() => {
-  });
-  instance = null;
-  cloudProfileBinding = null;
-}
-function normalizeCursorFlag(value) {
-  if (value === void 0 || value === null) {
-    return null;
-  }
-  if (typeof value === "boolean") {
-    return value;
-  }
-  if (typeof value === "number") {
-    if (value === 1) return true;
-    if (value === 0) return false;
-  }
-  throw new Error(
-    '--cursor must be a boolean value ("true" or "false").'
-  );
-}
-function readCursorPreferenceFromEnv() {
-  const value = process.env.OPENSTEER_CURSOR;
-  if (typeof value !== "string") {
-    return null;
-  }
-  const normalized = value.trim().toLowerCase();
-  if (normalized === "true" || normalized === "1") {
-    return true;
-  }
-  if (normalized === "false" || normalized === "0") {
-    return false;
-  }
-  return null;
-}
-function attachLifecycleListeners(inst) {
-  try {
-    inst.page.on("close", invalidateInstance);
-    inst.context.on("close", invalidateInstance);
-  } catch {
-  }
-}
-var sessionEnv = process.env.OPENSTEER_SESSION?.trim();
-if (!sessionEnv) {
-  process.stderr.write("Missing OPENSTEER_SESSION environment variable.\n");
-  process.exit(1);
-}
-var session = sessionEnv;
-var logicalSession = process.env.OPENSTEER_LOGICAL_SESSION?.trim() || session;
-var scopeDir = process.env.OPENSTEER_SCOPE_DIR?.trim() || process.cwd();
-var socketPath = getSocketPath(session);
-var pidPath = getPidPath(session);
-function cleanup() {
-  try {
-    unlinkSync(socketPath);
-  } catch {
-  }
-  try {
-    unlinkSync(pidPath);
-  } catch {
-  }
-  try {
-    unlinkSync(getMetadataPath(session));
-  } catch {
-  }
-}
-function beginShutdown() {
-  if (shuttingDown) return;
-  shuttingDown = true;
-  cleanup();
-  server.close(() => {
-    process.exit(0);
-  });
-  setTimeout(() => {
-    process.exit(0);
-  }, 250).unref();
-}
-function sendResponse(socket, response) {
-  try {
-    socket.write(JSON.stringify(response) + "\n");
-  } catch {
-  }
-}
-function enqueueRequest(request, socket) {
-  if (request.command === "ping") {
-    void handleRequest(request, socket);
-    return;
-  }
-  requestQueue = requestQueue.then(() => handleRequest(request, socket)).catch((error) => {
-    sendResponse(
-      socket,
-      buildErrorResponse(
-        request.id,
-        error,
-        "Unexpected server error while handling request.",
-        "CLI_INTERNAL_ERROR"
-      )
-    );
-  });
-}
-async function handleRequest(request, socket) {
-  const { id, command, args } = request;
-  if (command === "ping" && shuttingDown) {
-    sendResponse(socket, {
-      id,
-      ok: false,
-      error: `Session '${logicalSession}' is shutting down.`,
-      errorInfo: {
-        message: `Session '${logicalSession}' is shutting down.`,
-        code: "SESSION_SHUTTING_DOWN",
-        details: {
-          session: logicalSession,
-          runtimeSession: session,
-          scopeDir
-        }
-      }
-    });
-    return;
-  }
-  if (shuttingDown) {
-    sendResponse(socket, {
-      id,
-      ok: false,
-      error: `Session '${logicalSession}' is shutting down. Retry your command.`,
-      errorInfo: {
-        message: `Session '${logicalSession}' is shutting down. Retry your command.`,
-        code: "SESSION_SHUTTING_DOWN",
-        details: {
-          session: logicalSession,
-          runtimeSession: session,
-          scopeDir
-        }
-      }
-    });
-    return;
-  }
-  if (command === "open") {
-    try {
-      const url = args.url;
-      const headless = args.headless;
-      const browser = args.browser === "real" || args.browser === "chromium" ? args.browser : args.browser === void 0 ? void 0 : null;
-      const cdpUrl = args["cdp-url"];
-      const profileDirectory = args.profile;
-      const userDataDir = args["user-data-dir"];
-      const executablePath = args["browser-path"];
-      const cloudProfileId = typeof args["cloud-profile-id"] === "string" ? args["cloud-profile-id"].trim() : void 0;
-      const cloudProfileReuseIfActive = typeof args["cloud-profile-reuse-if-active"] === "boolean" ? args["cloud-profile-reuse-if-active"] : void 0;
-      const requestedCloudProfileBinding = normalizeCloudProfileBinding({
-        profileId: cloudProfileId,
-        reuseIfActive: cloudProfileReuseIfActive
-      });
-      const requestedCloudAuth = normalizeCliOpenCloudAuth(
-        args["cloud-auth"]
-      );
-      if (cloudProfileReuseIfActive !== void 0 && !cloudProfileId) {
-        throw new Error(
-          "--cloud-profile-reuse-if-active requires --cloud-profile-id."
-        );
-      }
-      if (browser === null) {
-        throw new Error(
-          '--browser must be either "chromium" or "real".'
-        );
-      }
-      if (browser === "chromium" && (profileDirectory || userDataDir || executablePath)) {
-        throw new Error(
-          "--profile, --user-data-dir, and --browser-path require --browser real."
-        );
-      }
-      if (cdpUrl && browser === "real") {
-        throw new Error(
-          "--cdp-url cannot be combined with --browser real."
-        );
-      }
-      const requestedCursor = normalizeCursorFlag(args.cursor);
-      const requestedName = typeof args.name === "string" && args.name.trim().length > 0 ? sanitizeNamespace(args.name) : null;
-      if (requestedCursor !== null) {
-        cursorEnabledPreference = requestedCursor;
-      }
-      const effectiveCursorEnabled = cursorEnabledPreference !== null ? cursorEnabledPreference : true;
-      if (selectorNamespace && requestedName && requestedName !== selectorNamespace) {
-        sendResponse(socket, {
-          id,
-          ok: false,
-          error: `Session '${logicalSession}' is already bound to selector namespace '${selectorNamespace}'. Requested '${requestedName}' does not match. Use the same --name for this session or start a different --session.`,
-          errorInfo: {
-            message: `Session '${logicalSession}' is already bound to selector namespace '${selectorNamespace}'. Requested '${requestedName}' does not match. Use the same --name for this session or start a different --session.`,
-            code: "SESSION_NAMESPACE_MISMATCH",
-            details: {
-              session: logicalSession,
-              runtimeSession: session,
-              scopeDir,
-              activeNamespace: selectorNamespace,
-              requestedNamespace: requestedName
-            }
-          }
-        });
-        return;
-      }
-      if (!selectorNamespace) {
-        selectorNamespace = requestedName ?? logicalSession;
-      }
-      const activeNamespace = selectorNamespace ?? logicalSession;
-      if (requestedCloudAuth) {
-        cloudAuthOverride = requestedCloudAuth;
-      }
-      if (instance && !launchPromise) {
-        try {
-          if (instance.page.isClosed()) {
-            invalidateInstance();
-          }
-        } catch {
-          invalidateInstance();
-        }
-      }
-      const requestedBrowserConfig = resolveCliBrowserRequestConfig({
-        browser: browser ?? void 0,
-        headless,
-        cdpUrl,
-        profileDirectory,
-        userDataDir,
-        executablePath
-      });
-      if (instance && !launchPromise) {
-        assertCompatibleCloudProfileBinding(
-          logicalSession,
-          cloudProfileBinding,
-          requestedCloudProfileBinding
-        );
-        const existingBrowserConfig = instance.getConfig().browser || {};
-        const existingBrowserRecord = existingBrowserConfig;
-        const mismatch = Object.entries(requestedBrowserConfig).find(
-          ([key, value]) => value !== void 0 && existingBrowserRecord[key] !== value
-        );
-        if (mismatch) {
-          const [key, value] = mismatch;
-          throw new Error(
-            `Session '${logicalSession}' is already bound to browser setting "${key}"=${JSON.stringify(existingBrowserRecord[key])}. Requested ${JSON.stringify(value)} does not match. Use the same browser flags for this session or start a different --session.`
-          );
-        }
-      }
-      let shouldLaunchInitialUrl = false;
-      if (!instance) {
-        instance = new Opensteer(
-          buildServerOpenConfig({
-            scopeDir,
-            name: activeNamespace,
-            cursorEnabled: effectiveCursorEnabled,
-            ...requestedBrowserConfig,
-            cloudAuth: cloudAuthOverride
-          })
-        );
-        const resolvedBrowserConfig = instance.getConfig().browser || {};
-        shouldLaunchInitialUrl = Boolean(url) && resolvedBrowserConfig.mode === "real" && !resolvedBrowserConfig.cdpUrl;
-        const nextCloudProfileBinding = resolveSessionCloudProfileBinding(
-          instance.getConfig(),
-          requestedCloudProfileBinding
-        );
-        if (requestedCloudProfileBinding && !nextCloudProfileBinding) {
-          instance = null;
-          throw new Error(
-            "--cloud-profile-id can only be used when cloud mode is enabled for this session."
-          );
-        }
-        launchPromise = instance.launch({
-          initialUrl: shouldLaunchInitialUrl ? url : void 0,
-          ...requestedBrowserConfig,
-          cloudBrowserProfile: cloudProfileId ? {
-            profileId: cloudProfileId,
-            reuseIfActive: cloudProfileReuseIfActive
-          } : void 0,
-          timeout: cdpUrl ? 12e4 : 3e4
-        });
-        try {
-          await launchPromise;
-          attachLifecycleListeners(instance);
-          cloudProfileBinding = nextCloudProfileBinding;
-        } catch (err) {
-          instance = null;
-          cloudProfileBinding = null;
-          throw err;
-        } finally {
-          launchPromise = null;
-        }
-      } else if (launchPromise) {
-        await launchPromise;
-      } else if (requestedCursor !== null) {
-        instance.setCursorEnabled(requestedCursor);
-      }
-      if (url && !shouldLaunchInitialUrl) {
-        await instance.goto(url);
-      }
-      sendResponse(socket, {
-        id,
-        ok: true,
-        result: {
-          url: instance.page.url(),
-          session: logicalSession,
-          logicalSession,
-          runtimeSession: session,
-          scopeDir,
-          name: activeNamespace,
-          cursor: instance.getCursorState(),
-          cloudSessionId: instance.getCloudSessionId() ?? void 0,
-          cloudSessionUrl: instance.getCloudSessionUrl() ?? void 0
-        }
-      });
-    } catch (err) {
-      sendResponse(
-        socket,
-        buildErrorResponse(id, err, "Failed to open browser session.")
-      );
-    }
-    return;
-  }
-  if (command === "cursor") {
-    try {
-      const mode = typeof args.mode === "string" ? args.mode : "status";
-      if (mode === "on") {
-        cursorEnabledPreference = true;
-        instance?.setCursorEnabled(true);
-      } else if (mode === "off") {
-        cursorEnabledPreference = false;
-        instance?.setCursorEnabled(false);
-      } else if (mode !== "status") {
-        throw new Error(
-          `Invalid cursor mode "${mode}". Use "on", "off", or "status".`
-        );
-      }
-      const defaultEnabled = cursorEnabledPreference !== null ? cursorEnabledPreference : true;
-      const cursor = instance ? instance.getCursorState() : {
-        enabled: defaultEnabled,
-        active: false,
-        reason: "session_not_open"
-      };
-      sendResponse(socket, {
-        id,
-        ok: true,
-        result: {
-          cursor
-        }
-      });
-    } catch (err) {
-      sendResponse(
-        socket,
-        buildErrorResponse(id, err, "Failed to update cursor mode.")
-      );
-    }
-    return;
-  }
-  if (command === "close") {
-    try {
-      if (instance) {
-        await instance.close();
-        instance = null;
-      }
-      sendResponse(socket, {
-        id,
-        ok: true,
-        result: { sessionClosed: true }
-      });
-    } catch (err) {
-      sendResponse(
-        socket,
-        buildErrorResponse(id, err, "Failed to close browser session.")
-      );
-    }
-    beginShutdown();
-    return;
-  }
-  if (command === "ping") {
-    sendResponse(socket, { id, ok: true, result: { pong: true } });
-    return;
-  }
-  if (!instance) {
-    sendResponse(socket, {
-      id,
-      ok: false,
-      error: `No browser session in session '${logicalSession}' (scope '${scopeDir}'). Call 'opensteer open --session ${logicalSession}' first, or use 'opensteer sessions' to list active sessions.`,
-      errorInfo: {
-        message: `No browser session in session '${logicalSession}' (scope '${scopeDir}'). Call 'opensteer open --session ${logicalSession}' first, or use 'opensteer sessions' to list active sessions.`,
-        code: "SESSION_NOT_OPEN",
-        details: {
-          session: logicalSession,
-          runtimeSession: session,
-          scopeDir
-        }
-      }
-    });
-    return;
-  }
-  const handler = getCommandHandler(command);
-  if (!handler) {
-    sendResponse(socket, {
-      id,
-      ok: false,
-      error: `Unknown command: ${command}`,
-      errorInfo: {
-        message: `Unknown command: ${command}`,
-        code: "UNKNOWN_COMMAND",
-        details: {
-          command
-        }
-      }
-    });
-    return;
-  }
-  try {
-    const result = await handler(instance, args);
-    sendResponse(socket, { id, ok: true, result });
-  } catch (err) {
-    sendResponse(
-      socket,
-      buildErrorResponse(id, err, `Command "${command}" failed.`, void 0, {
-        command
-      })
-    );
-  }
-}
-if (existsSync(socketPath)) {
-  unlinkSync(socketPath);
-}
-var server = createServer((socket) => {
-  let buffer = "";
-  socket.on("data", (chunk) => {
-    buffer += chunk.toString();
-    const lines = buffer.split("\n");
-    buffer = lines.pop() || "";
-    for (const line of lines) {
-      if (!line.trim()) continue;
-      try {
-        const request = JSON.parse(line);
-        enqueueRequest(request, socket);
-      } catch {
-        sendResponse(socket, {
-          id: 0,
-          ok: false,
-          error: "Invalid JSON request",
-          errorInfo: {
-            message: "Invalid JSON request",
-            code: "INVALID_JSON_REQUEST"
-          }
-        });
-      }
-    }
-  });
-  socket.on("error", () => {
-  });
-});
-server.listen(socketPath, () => {
-  writeFileSync(pidPath, String(process.pid));
-  if (process.send) {
-    process.send("ready");
-  }
-});
-server.on("error", (err) => {
-  console.error("Server error:", err.message);
-  cleanup();
-  process.exit(1);
-});
-async function shutdown() {
-  if (shuttingDown) return;
-  shuttingDown = true;
-  if (instance) {
-    try {
-      await instance.close();
-    } catch {
-    }
-    instance = null;
-  }
-  cleanup();
-  server.close(() => {
-    process.exit(0);
-  });
-  setTimeout(() => {
-    process.exit(0);
-  }, 250).unref();
-}
-process.on("SIGTERM", shutdown);
-process.on("SIGINT", shutdown);
-function buildErrorResponse(id, error, fallbackMessage, fallbackCode, details) {
-  const normalized = normalizeError(error, fallbackMessage);
-  let mergedDetails;
-  if (normalized.details || details) {
-    mergedDetails = {
-      ...normalized.details || {},
-      ...details || {}
-    };
-  }
-  return {
-    id,
-    ok: false,
-    error: normalized.message,
-    errorInfo: {
-      message: normalized.message,
-      ...normalized.code || fallbackCode ? { code: normalized.code || fallbackCode } : {},
-      ...normalized.name ? { name: normalized.name } : {},
-      ...mergedDetails ? { details: mergedDetails } : {},
-      ...normalized.cause ? { cause: normalized.cause } : {}
-    }
-  };
-}