gologin-web-access 0.3.0

package/dist/internal-agent/commands/find.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFindCommand = runFindCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+const ACTIONS = new Set(["click", "fill", "type", "hover", "text"]);
+function parseFindLocator(positional) {
+    const mode = positional[0];
+    if (mode === "role") {
+        const role = positional[1];
+        const action = positional[2];
+        const value = positional.slice(3).join(" ") || undefined;
+        if (!role || !action || !ACTIONS.has(action)) {
+            throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access find role <role> <action> [value] [--name <name>]", 400);
+        }
+        return { locator: { strategy: "role", role }, action, value };
+    }
+    if (mode === "text") {
+        const text = positional[1];
+        const action = positional[2];
+        const value = positional.slice(3).join(" ") || undefined;
+        if (!text || !action || !ACTIONS.has(action)) {
+            throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access find text <text> <action> [value]", 400);
+        }
+        return { locator: { strategy: "text", text }, action, value };
+    }
+    if (mode === "label") {
+        const label = positional[1];
+        const action = positional[2];
+        const value = positional.slice(3).join(" ") || undefined;
+        if (!label || !action || !ACTIONS.has(action)) {
+            throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access find label <label> <action> [value]", 400);
+        }
+        return { locator: { strategy: "label", label }, action, value };
+    }
+    if (mode === "placeholder") {
+        const placeholder = positional[1];
+        const action = positional[2];
+        const value = positional.slice(3).join(" ") || undefined;
+        if (!placeholder || !action || !ACTIONS.has(action)) {
+            throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access find placeholder <placeholder> <action> [value]", 400);
+        }
+        return { locator: { strategy: "placeholder", placeholder }, action, value };
+    }
+    if (mode === "first" || mode === "last") {
+        const selector = positional[1];
+        const action = positional[2];
+        const value = positional.slice(3).join(" ") || undefined;
+        if (!selector || !action || !ACTIONS.has(action)) {
+            throw new errors_1.AppError("BAD_REQUEST", `Usage: gologin-web-access find ${mode} <selector> <action> [value]`, 400);
+        }
+        return { locator: { strategy: mode, selector }, action, value };
+    }
+    if (mode === "nth") {
+        const nth = positional[1];
+        const selector = positional[2];
+        const action = positional[3];
+        const value = positional.slice(4).join(" ") || undefined;
+        if (!nth || !selector || !action || !ACTIONS.has(action) || Number.isNaN(Number(nth))) {
+            throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access find nth <n> <selector> <action> [value]", 400);
+        }
+        return { locator: { strategy: "nth", selector, nth: Number(nth) }, action, value };
+    }
+    throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access find <role|text|label|placeholder|first|last|nth> ...", 400);
+}
+async function runFindCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const name = (0, utils_1.getFlagString)(parsed, "name");
+    const exact = (0, utils_1.getFlagBoolean)(parsed, "exact");
+    const { locator, action, value } = parseFindLocator(parsed.positional);
+    if (locator.strategy === "role" && name) {
+        locator.name = name;
+    }
+    if (exact) {
+        locator.exact = true;
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/find`, { locator, action, value });
+    if (action === "text") {
+        context.stdout.write(`${response.value ?? ""}\n`);
+        return;
+    }
+    context.stdout.write(`find ${action} session=${response.sessionId} url=${response.url} snapshot=${response.staleSnapshot ? "stale" : "fresh"}\n`);
+}

package/dist/internal-agent/commands/focus.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFocusCommand = runFocusCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runFocusCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const target = parsed.positional[0];
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    if (!target) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access focus <target> [--session <sessionId>]", 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/focus`, { target });
+    (0, shared_1.writeActionResult)(context, "focused", target, response);
+}

package/dist/internal-agent/commands/forward.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runForwardCommand = runForwardCommand;
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runForwardCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/forward`);
+    context.stdout.write(`session=${response.sessionId} url=${response.url} snapshot=${response.staleSnapshot ? "stale" : "fresh"}\n`);
+}

package/dist/internal-agent/commands/get.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGetCommand = runGetCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+const GET_KINDS = new Set(["text", "value", "html", "title", "url"]);
+async function runGetCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const kind = parsed.positional[0];
+    const target = parsed.positional[1];
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    if (!kind || !GET_KINDS.has(kind)) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access get <text|value|html|title|url> [target] [--session <sessionId>]", 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/get`, { kind, target });
+    context.stdout.write(`${response.value}\n`);
+}

package/dist/internal-agent/commands/hover.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runHoverCommand = runHoverCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runHoverCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const target = parsed.positional[0];
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    if (!target) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access hover <target> [--session <sessionId>]", 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/hover`, { target });
+    (0, shared_1.writeActionResult)(context, "hovered", target, response);
+}

package/dist/internal-agent/commands/open.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runOpenCommand = runOpenCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+function parseIdleTimeout(value) {
+    if (!value) {
+        return undefined;
+    }
+    const timeout = Number(value);
+    if (!Number.isInteger(timeout) || timeout <= 0) {
+        throw new errors_1.AppError("BAD_REQUEST", "--idle-timeout-ms must be a positive integer", 400);
+    }
+    return timeout;
+}
+function parseProxy(parsed) {
+    const country = (0, utils_1.getFlagString)(parsed, "proxy-country");
+    const mode = (0, utils_1.getFlagString)(parsed, "proxy-mode");
+    const host = (0, utils_1.getFlagString)(parsed, "proxy-host");
+    const portRaw = (0, utils_1.getFlagString)(parsed, "proxy-port");
+    const username = (0, utils_1.getFlagString)(parsed, "proxy-user");
+    const password = (0, utils_1.getFlagString)(parsed, "proxy-pass");
+    if (country) {
+        throw new errors_1.AppError("BAD_REQUEST", "--proxy-country is not available for temporary cloud profiles yet; use a preconfigured --profile or a custom proxy host/port", 400);
+    }
+    if (host || portRaw || username || password || mode) {
+        const port = Number(portRaw);
+        if (!host || !portRaw || !Number.isInteger(port) || port <= 0) {
+            throw new errors_1.AppError("BAD_REQUEST", "Custom proxy requires --proxy-host and a valid --proxy-port", 400);
+        }
+        const resolvedMode = mode ?? "http";
+        if (!["http", "socks4", "socks5"].includes(resolvedMode)) {
+            throw new errors_1.AppError("BAD_REQUEST", "--proxy-mode must be one of http, socks4, or socks5", 400);
+        }
+        return {
+            mode: resolvedMode,
+            host,
+            port,
+            username,
+            password
+        };
+    }
+    return undefined;
+}
+async function runOpenCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const url = parsed.positional[0];
+    const profileId = (0, utils_1.getFlagString)(parsed, "profile");
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const proxy = parseProxy(parsed);
+    const idleTimeoutMs = parseIdleTimeout((0, utils_1.getFlagString)(parsed, "idle-timeout-ms"));
+    if (!url) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access open <url> [--profile <profileId>] [--session <sessionId>] [--idle-timeout-ms <ms>] [--proxy-host <host> --proxy-port <port>]", 400);
+    }
+    const response = await context.client.request("POST", "/sessions/open", {
+        url,
+        profileId,
+        sessionId,
+        proxy,
+        idleTimeoutMs
+    });
+    const proxyLabel = (0, utils_1.formatProxyLabel)(response.proxy);
+    const proxyToken = proxyLabel ? ` proxy=${proxyLabel}` : "";
+    const liveView = response.liveViewUrl ? ` liveview=${response.liveViewUrl}` : "";
+    const idleTimeout = response.idleTimeoutMs !== undefined ? ` idleTimeoutMs=${response.idleTimeoutMs}` : "";
+    context.stdout.write(`session=${response.sessionId} url=${response.url}${proxyToken}${idleTimeout}${liveView}\n`);
+}

package/dist/internal-agent/commands/pdf.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPdfCommand = runPdfCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runPdfCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const inputPath = parsed.positional[0];
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    if (!inputPath) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access pdf <path> [--session <sessionId>]", 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const path = (0, utils_1.ensureAbsolutePath)(context.cwd, inputPath);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/pdf`, { path });
+    context.stdout.write(`pdf=${response.path} session=${response.sessionId}\n`);
+}

package/dist/internal-agent/commands/press.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPressCommand = runPressCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runPressCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const key = parsed.positional[0];
+    const target = parsed.positional[1];
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    if (!key) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access press <key> [target] [--session <sessionId>]", 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/press`, { key, target });
+    const targetSuffix = target ? ` target=${target}` : "";
+    context.stdout.write(`pressed key=${key}${targetSuffix} session=${response.sessionId} url=${response.url} snapshot=${response.staleSnapshot ? "stale" : "fresh"}\n`);
+}

package/dist/internal-agent/commands/reload.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runReloadCommand = runReloadCommand;
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runReloadCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/reload`);
+    context.stdout.write(`session=${response.sessionId} url=${response.url} snapshot=${response.staleSnapshot ? "stale" : "fresh"}\n`);
+}

package/dist/internal-agent/commands/screenshot.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runScreenshotCommand = runScreenshotCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runScreenshotCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const inputPath = parsed.positional[0];
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const annotate = (0, utils_1.getFlagBoolean)(parsed, "annotate");
+    const pressEscape = (0, utils_1.getFlagBoolean)(parsed, "press-escape");
+    if (!inputPath) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access screenshot <path> [--annotate] [--press-escape] [--session <sessionId>]", 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const targetPath = (0, utils_1.ensureAbsolutePath)(context.cwd, inputPath);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/screenshot`, { path: targetPath, annotate, pressEscape });
+    const annotated = response.annotated ? " annotated=yes" : "";
+    const escaped = response.pressedEscape ? " escape=yes" : "";
+    context.stdout.write(`screenshot=${response.path} session=${response.sessionId}${annotated}${escaped}\n`);
+}

package/dist/internal-agent/commands/scroll.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runScrollCommand = runScrollCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+const SCROLL_DIRECTIONS = new Set(["up", "down", "left", "right"]);
+async function runScrollCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const direction = parsed.positional[0];
+    const maybePixels = parsed.positional[1];
+    const target = (0, utils_1.getFlagString)(parsed, "target");
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    if (!direction || !SCROLL_DIRECTIONS.has(direction)) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access scroll <up|down|left|right> [pixels] [--target <target>] [--session <sessionId>]", 400);
+    }
+    if (maybePixels && !(0, utils_1.isNumericToken)(maybePixels)) {
+        throw new errors_1.AppError("BAD_REQUEST", "scroll pixels must be a number", 400);
+    }
+    const pixels = maybePixels ? Number(maybePixels) : undefined;
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/scroll`, { direction, pixels, target });
+    const targetSuffix = response.target ? ` target=${response.target}` : "";
+    context.stdout.write(`scrolled direction=${response.direction} pixels=${response.pixels}${targetSuffix} session=${response.sessionId} url=${response.url}\n`);
+}

package/dist/internal-agent/commands/scrollIntoView.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runScrollIntoViewCommand = runScrollIntoViewCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runScrollIntoViewCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const target = parsed.positional[0];
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    if (!target) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access scrollintoview <target> [--session <sessionId>]", 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/scrollintoview`, { target });
+    (0, shared_1.writeActionResult)(context, "scrolled-into-view", target, response);
+}

package/dist/internal-agent/commands/select.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSelectCommand = runSelectCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runSelectCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const target = parsed.positional[0];
+    const value = parsed.positional.slice(1).join(" ");
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    if (!target || !value) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access select <target> <value> [--session <sessionId>]", 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/select`, { target, value });
+    (0, shared_1.writeActionResult)(context, "selected", target, response);
+}

package/dist/internal-agent/commands/sessions.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSessionsCommand = runSessionsCommand;
+const utils_1 = require("../lib/utils");
+async function runSessionsCommand(context, argv) {
+    (0, utils_1.parseArgs)(argv);
+    const response = await context.client.request("GET", "/sessions");
+    if (response.sessions.length === 0) {
+        context.stdout.write("no sessions\n");
+        return;
+    }
+    for (const session of response.sessions) {
+        context.stdout.write(`${(0, utils_1.formatSessionLine)(session)}\n`);
+    }
+}

package/dist/internal-agent/commands/shared.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSessionId = resolveSessionId;
+exports.writeActionResult = writeActionResult;
+exports.parseStorageScope = parseStorageScope;
+exports.readJsonFile = readJsonFile;
+exports.writeJsonFile = writeJsonFile;
+exports.writeJsonStdout = writeJsonStdout;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+async function resolveSessionId(context, explicitSessionId) {
+    if (explicitSessionId) {
+        return explicitSessionId;
+    }
+    return (await context.client.request("GET", "/sessions/current")).sessionId;
+}
+function writeActionResult(context, verb, target, response) {
+    context.stdout.write(`${verb} target=${target} session=${response.sessionId} url=${response.url} snapshot=${response.staleSnapshot ? "stale" : "fresh"}\n`);
+}
+function parseStorageScope(value) {
+    if (!value) {
+        return undefined;
+    }
+    if (value === "local" || value === "session" || value === "both") {
+        return value;
+    }
+    throw new errors_1.AppError("BAD_REQUEST", "--scope must be one of local, session, or both", 400);
+}
+function readJsonFile(context, targetPath) {
+    const absolutePath = (0, utils_1.ensureAbsolutePath)(context.cwd, targetPath);
+    try {
+        return JSON.parse(node_fs_1.default.readFileSync(absolutePath, "utf8"));
+    }
+    catch (error) {
+        throw new errors_1.AppError("BAD_REQUEST", `Failed to read JSON file ${absolutePath}: ${error instanceof Error ? error.message : String(error)}`, 400);
+    }
+}
+function writeJsonFile(context, targetPath, payload) {
+    const absolutePath = (0, utils_1.ensureAbsolutePath)(context.cwd, targetPath);
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(absolutePath), { recursive: true });
+    node_fs_1.default.writeFileSync(absolutePath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
+    return absolutePath;
+}
+function writeJsonStdout(context, payload) {
+    context.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+}

package/dist/internal-agent/commands/snapshot.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSnapshotCommand = runSnapshotCommand;
+const utils_1 = require("../lib/utils");
+async function runSnapshotCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const interactive = (0, utils_1.getFlagBoolean)(parsed, "interactive");
+    const resolvedSessionId = sessionId ??
+        (await context.client.request("GET", "/sessions/current")).sessionId;
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/snapshot`, interactive ? { interactive: true } : {});
+    context.stdout.write(`session=${response.sessionId} url=${response.url}\n`);
+    for (const item of response.items) {
+        context.stdout.write(`${(0, utils_1.formatSnapshotItem)(item)}\n`);
+    }
+}

package/dist/internal-agent/commands/storageClear.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStorageClearCommand = runStorageClearCommand;
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runStorageClearCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const scope = (0, shared_1.parseStorageScope)((0, utils_1.getFlagString)(parsed, "scope"));
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/storage-clear`, { scope });
+    context.stdout.write(`origin=${response.origin} scope=${response.scope} session=${response.sessionId} url=${response.url} snapshot=${response.staleSnapshot ? "stale" : "fresh"}\n`);
+}

package/dist/internal-agent/commands/storageExport.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStorageExportCommand = runStorageExportCommand;
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runStorageExportCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const outputPath = parsed.positional[0];
+    const json = (0, utils_1.getFlagBoolean)(parsed, "json");
+    const scope = (0, shared_1.parseStorageScope)((0, utils_1.getFlagString)(parsed, "scope"));
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/storage-export`, { scope });
+    if (outputPath) {
+        const savedPath = (0, shared_1.writeJsonFile)(context, outputPath, response.state);
+        context.stdout.write(`${savedPath}\n`);
+        return;
+    }
+    if (json) {
+        (0, shared_1.writeJsonStdout)(context, response.state);
+        return;
+    }
+    context.stdout.write(`${JSON.stringify(response.state, null, 2)}\n`);
+}

package/dist/internal-agent/commands/storageImport.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runStorageImportCommand = runStorageImportCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runStorageImportCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const storagePath = parsed.positional[0];
+    const scope = (0, shared_1.parseStorageScope)((0, utils_1.getFlagString)(parsed, "scope"));
+    const clear = (0, utils_1.getFlagBoolean)(parsed, "clear");
+    if (!storagePath) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access storage-import <storage.json> [--scope <local|session|both>] [--clear] [--session <sessionId>]", 400);
+    }
+    const state = (0, shared_1.readJsonFile)(context, storagePath);
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/storage-import`, { state, scope, clear });
+    context.stdout.write(`origin=${response.origin} localKeys=${response.localKeys} sessionKeys=${response.sessionKeys} session=${response.sessionId} url=${response.url} snapshot=${response.staleSnapshot ? "stale" : "fresh"}\n`);
+}

package/dist/internal-agent/commands/tabClose.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTabCloseCommand = runTabCloseCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runTabCloseCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const rawIndex = parsed.positional[0];
+    let index;
+    if (rawIndex !== undefined) {
+        index = Number(rawIndex);
+        if (!Number.isInteger(index) || index <= 0) {
+            throw new errors_1.AppError("BAD_REQUEST", "tab index must be a positive integer", 400);
+        }
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/tabclose`, { index });
+    context.stdout.write(`closedTab=${response.closedTabIndex} activeTab=${response.activeTabIndex} session=${response.sessionId} url=${response.url} snapshot=${response.staleSnapshot ? "stale" : "fresh"}\n`);
+}

package/dist/internal-agent/commands/tabFocus.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTabFocusCommand = runTabFocusCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runTabFocusCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const rawIndex = parsed.positional[0];
+    if (!rawIndex) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access tabfocus <index> [--session <sessionId>]", 400);
+    }
+    const index = Number(rawIndex);
+    if (!Number.isInteger(index) || index <= 0) {
+        throw new errors_1.AppError("BAD_REQUEST", "tab index must be a positive integer", 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/tabfocus`, { index });
+    context.stdout.write(`tab=${response.tabIndex} session=${response.sessionId} url=${response.url} snapshot=${response.staleSnapshot ? "stale" : "fresh"}\n`);
+}

package/dist/internal-agent/commands/tabOpen.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTabOpenCommand = runTabOpenCommand;
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runTabOpenCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const url = parsed.positional[0];
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/tabopen`, { url });
+    context.stdout.write(`tab=${response.tabIndex} session=${response.sessionId} url=${response.url} snapshot=${response.staleSnapshot ? "stale" : "fresh"}\n`);
+}

package/dist/internal-agent/commands/tabs.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTabsCommand = runTabsCommand;
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runTabsCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("GET", `/sessions/${resolvedSessionId}/tabs`);
+    context.stdout.write(`session=${response.sessionId} tabs=${response.tabs.length}\n`);
+    for (const tab of response.tabs) {
+        const prefix = tab.active ? "*" : "-";
+        const title = tab.title ? ` title=${JSON.stringify(tab.title)}` : "";
+        context.stdout.write(`${prefix} tab=${tab.index} url=${tab.url}${title}\n`);
+    }
+}

package/dist/internal-agent/commands/type.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runTypeCommand = runTypeCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runTypeCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const target = parsed.positional[0];
+    const text = parsed.positional.slice(1).join(" ");
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    if (!target || !text) {
+        throw new errors_1.AppError("BAD_REQUEST", 'Usage: gologin-web-access type <target> <text> [--session <sessionId>]', 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/type`, { target, text });
+    (0, shared_1.writeActionResult)(context, "typed", target, response);
+}

package/dist/internal-agent/commands/uncheck.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUncheckCommand = runUncheckCommand;
+const errors_1 = require("../lib/errors");
+const utils_1 = require("../lib/utils");
+const shared_1 = require("./shared");
+async function runUncheckCommand(context, argv) {
+    const parsed = (0, utils_1.parseArgs)(argv);
+    const target = parsed.positional[0];
+    const sessionId = (0, utils_1.getFlagString)(parsed, "session");
+    if (!target) {
+        throw new errors_1.AppError("BAD_REQUEST", "Usage: gologin-web-access uncheck <target> [--session <sessionId>]", 400);
+    }
+    const resolvedSessionId = await (0, shared_1.resolveSessionId)(context, sessionId);
+    const response = await context.client.request("POST", `/sessions/${resolvedSessionId}/uncheck`, { target });
+    (0, shared_1.writeActionResult)(context, "unchecked", target, response);
+}