tabctl 0.1.0

package/cli/lib/commands/params.js

@@ -0,0 +1,378 @@
+"use strict";
+/**
+ * Command parameter builders.
+ * These functions extract and validate command parameters from CLI options.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAnalyzeParams = buildAnalyzeParams;
+exports.buildInspectParams = buildInspectParams;
+exports.buildFocusParams = buildFocusParams;
+exports.buildRefreshParams = buildRefreshParams;
+exports.buildOpenParams = buildOpenParams;
+exports.buildGroupUpdateParams = buildGroupUpdateParams;
+exports.buildGroupUngroupParams = buildGroupUngroupParams;
+exports.buildGroupAssignParams = buildGroupAssignParams;
+exports.buildMoveTabParams = buildMoveTabParams;
+exports.buildMoveGroupParams = buildMoveGroupParams;
+exports.buildMergeWindowParams = buildMergeWindowParams;
+exports.buildArchiveParams = buildArchiveParams;
+exports.buildCloseParams = buildCloseParams;
+exports.buildReportParams = buildReportParams;
+exports.buildScreenshotParams = buildScreenshotParams;
+exports.buildHistoryParams = buildHistoryParams;
+exports.buildUndoParams = buildUndoParams;
+const fs_1 = __importDefault(require("fs"));
+const output_1 = require("../output");
+const args_1 = require("../args");
+// ============================================================================
+// Analyze Command Parameters
+// ============================================================================
+function buildAnalyzeParams(options) {
+    if (options.ungrouped && options["group-id"]) {
+        (0, output_1.errorOut)("--ungrouped cannot be combined with --group-id");
+    }
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    return {
+        staleDays: options["stale-days"] ? Number(options["stale-days"]) : undefined,
+        checkGitHub: Boolean(options.github),
+        tabIds: options.tab ? options.tab.map(Number) : undefined,
+        groupTitle: options.group,
+        groupId: options.ungrouped ? -1 : (options["group-id"] ? Number(options["group-id"]) : undefined),
+        windowId: windowValue,
+        all: options.all === true,
+        githubConcurrency: options["github-concurrency"] ? Number(options["github-concurrency"]) : undefined,
+        githubTimeoutMs: options["github-timeout-ms"] ? Number(options["github-timeout-ms"]) : undefined,
+        progress: Boolean(options.progress),
+    };
+}
+// ============================================================================
+// Inspect Command Parameters
+// ============================================================================
+function buildInspectParams(options) {
+    if (options.ungrouped && options["group-id"]) {
+        (0, output_1.errorOut)("--ungrouped cannot be combined with --group-id");
+    }
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    const selectorAttr = options["selector-attr"] ? String(options["selector-attr"]).trim() : "";
+    const allowedSelectorAttrs = new Set(["text", "href", "src", "href-url", "src-url"]);
+    if (options["selector-attr"] && (!selectorAttr || !allowedSelectorAttrs.has(selectorAttr))) {
+        (0, output_1.errorOut)("Invalid --selector-attr value (use text|href|src|href-url|src-url)");
+    }
+    let selectorSpecs;
+    if (options.selector) {
+        selectorSpecs = options.selector.map((value) => {
+            const trimmed = value.trim();
+            if (trimmed.startsWith("{")) {
+                try {
+                    const parsed = JSON.parse(trimmed);
+                    if (parsed && typeof parsed.selector === "string" && parsed.selector.includes(":contains(")) {
+                        (0, output_1.errorOut)("Selector :contains() is not supported; use text filters instead.");
+                    }
+                    if (selectorAttr && parsed && typeof parsed === "object" && !Object.prototype.hasOwnProperty.call(parsed, "attr")) {
+                        return { ...parsed, attr: selectorAttr };
+                    }
+                    return parsed;
+                }
+                catch {
+                    (0, output_1.errorOut)(`Invalid selector JSON: ${trimmed}`);
+                }
+            }
+            if (trimmed.includes(":contains(")) {
+                (0, output_1.errorOut)("Selector :contains() is not supported; use text filters instead.");
+            }
+            if (trimmed.includes("=")) {
+                const [name, selector] = trimmed.split(/=(.+)/);
+                return selectorAttr ? { name, selector, attr: selectorAttr } : { name, selector };
+            }
+            return selectorAttr ? { selector: trimmed, attr: selectorAttr } : { selector: trimmed };
+        }).filter(Boolean);
+    }
+    let signalConfig;
+    if (options["signal-config"]) {
+        try {
+            const configRaw = fs_1.default.readFileSync(String(options["signal-config"]), "utf8");
+            signalConfig = JSON.parse(configRaw);
+        }
+        catch {
+            (0, output_1.errorOut)("Failed to read --signal-config file");
+        }
+    }
+    return {
+        all: Boolean(options.all),
+        windowId: windowValue,
+        groupTitle: options.group,
+        groupId: options.ungrouped ? -1 : (options["group-id"] ? Number(options["group-id"]) : undefined),
+        tabIds: options.tab ? options.tab.map(Number) : undefined,
+        signals: options.signal ? options.signal : undefined,
+        selectorSpecs,
+        signalConfig,
+        signalConcurrency: options["signal-concurrency"] ? Number(options["signal-concurrency"]) : undefined,
+        signalTimeoutMs: options["signal-timeout-ms"] ? Number(options["signal-timeout-ms"]) : undefined,
+        waitFor: parseWaitFor(options["wait-for"]),
+        waitTimeoutMs: parseWaitTimeout(options["wait-timeout-ms"]),
+        progress: Boolean(options.progress),
+    };
+}
+// ============================================================================
+// Focus/Refresh Command Parameters
+// ============================================================================
+function buildFocusParams(options) {
+    return {
+        tabId: options.tab ? Number(options.tab[0]) : undefined,
+        tabIds: options.tab ? options.tab.map(Number) : undefined,
+    };
+}
+function buildRefreshParams(options) {
+    return {
+        tabId: options.tab ? Number(options.tab[0]) : undefined,
+        tabIds: options.tab ? options.tab.map(Number) : undefined,
+    };
+}
+// ============================================================================
+// Open Command Parameters
+// ============================================================================
+function buildOpenParams(options) {
+    const windowValue = parseWindowScope(options.window, { allowNew: true });
+    const openNewWindow = options["new-window"] === true || windowValue === "new";
+    if (options["before-tab"] != null && !Number.isFinite(Number(options["before-tab"]))) {
+        (0, output_1.errorOut)("Invalid --before-tab value");
+    }
+    if (options["after-tab"] != null && !Number.isFinite(Number(options["after-tab"]))) {
+        (0, output_1.errorOut)("Invalid --after-tab value");
+    }
+    if (options["before-tab"] != null && options["after-tab"] != null) {
+        (0, output_1.errorOut)("Only one target position is allowed");
+    }
+    return {
+        urls: options.url ? options.url.map(String) : undefined,
+        groupTitle: options.group,
+        color: (0, args_1.normalizeGroupColor)(options.color),
+        afterGroupTitle: options["after-group"],
+        beforeTabId: options["before-tab"] ? Number(options["before-tab"]) : undefined,
+        afterTabId: options["after-tab"] ? Number(options["after-tab"]) : undefined,
+        windowId: windowValue === "new" ? undefined : windowValue,
+        newWindow: openNewWindow,
+        windowGroupTitle: options["window-group"],
+        windowTabId: options["window-tab"] ? Number(options["window-tab"]) : undefined,
+        windowUrl: options["window-url"],
+    };
+}
+// ============================================================================
+// Group Command Parameters
+// ============================================================================
+function buildGroupUpdateParams(options) {
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    return {
+        groupTitle: options.group,
+        groupId: options["group-id"] ? Number(options["group-id"]) : undefined,
+        windowId: windowValue,
+        title: options.title,
+        color: options.color,
+        collapsed: options.collapsed === true ? true : options.expanded === true ? false : undefined,
+    };
+}
+function buildGroupUngroupParams(options) {
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    return {
+        groupTitle: options.group,
+        groupId: options["group-id"] ? Number(options["group-id"]) : undefined,
+        windowId: windowValue,
+    };
+}
+function buildGroupAssignParams(options) {
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    return {
+        tabIds: options.tab ? options.tab.map(Number) : undefined,
+        groupTitle: options.group,
+        groupId: options["group-id"] ? Number(options["group-id"]) : undefined,
+        windowId: windowValue,
+        create: Boolean(options.create),
+        color: options.color,
+        collapsed: options.collapsed === true ? true : options.expanded === true ? false : undefined,
+    };
+}
+// ============================================================================
+// Move Command Parameters
+// ============================================================================
+function buildMoveTabParams(options) {
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    return {
+        tabId: options.tab ? Number(options.tab[0]) : undefined,
+        tabIds: options.tab ? options.tab.map(Number) : undefined,
+        beforeTabId: options["before-tab"] ? Number(options["before-tab"]) : undefined,
+        afterTabId: options["after-tab"] ? Number(options["after-tab"]) : undefined,
+        beforeGroupTitle: options["before-group"],
+        afterGroupTitle: options["after-group"],
+        windowId: windowValue,
+        newWindow: options["new-window"] === true,
+    };
+}
+function buildMoveGroupParams(options) {
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    return {
+        groupTitle: options.group,
+        groupId: options["group-id"] ? Number(options["group-id"]) : undefined,
+        beforeTabId: options["before-tab"] ? Number(options["before-tab"]) : undefined,
+        afterTabId: options["after-tab"] ? Number(options["after-tab"]) : undefined,
+        beforeGroupTitle: options["before-group"],
+        afterGroupTitle: options["after-group"],
+        windowId: windowValue,
+        newWindow: options["new-window"] === true,
+    };
+}
+function buildMergeWindowParams(options) {
+    return {
+        fromWindowId: options.from ? Number(options.from) : undefined,
+        toWindowId: options.to ? Number(options.to) : undefined,
+        windowId: options.from ? Number(options.from) : undefined,
+        closeSource: options["close-source"] === true,
+        confirmed: options.confirm === true,
+    };
+}
+// ============================================================================
+// Archive/Close Command Parameters
+// ============================================================================
+function buildArchiveParams(options) {
+    if (options.ungrouped && options["group-id"]) {
+        (0, output_1.errorOut)("--ungrouped cannot be combined with --group-id");
+    }
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    return {
+        all: Boolean(options.all),
+        windowId: windowValue,
+        groupTitle: options.group,
+        groupId: options.ungrouped ? -1 : (options["group-id"] ? Number(options["group-id"]) : undefined),
+        tabIds: options.tab ? options.tab.map(Number) : undefined,
+    };
+}
+function buildCloseParams(options) {
+    if (options.ungrouped && options["group-id"]) {
+        (0, output_1.errorOut)("--ungrouped cannot be combined with --group-id");
+    }
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    if (options.apply) {
+        return { mode: "apply", analysisId: options.apply };
+    }
+    if (!options.confirm) {
+        (0, output_1.errorOut)("Direct close requires --confirm");
+    }
+    return {
+        mode: "direct",
+        confirmed: true,
+        windowId: windowValue,
+        groupTitle: options.group,
+        groupId: options.ungrouped ? -1 : (options["group-id"] ? Number(options["group-id"]) : undefined),
+        tabIds: options.tab ? options.tab.map(Number) : undefined,
+    };
+}
+// ============================================================================
+// Report Command Parameters
+// ============================================================================
+function buildReportParams(options) {
+    if (options.ungrouped && options["group-id"]) {
+        (0, output_1.errorOut)("--ungrouped cannot be combined with --group-id");
+    }
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    return {
+        all: Boolean(options.all),
+        windowId: windowValue,
+        groupTitle: options.group,
+        groupId: options.ungrouped ? -1 : (options["group-id"] ? Number(options["group-id"]) : undefined),
+        tabIds: options.tab ? options.tab.map(Number) : undefined,
+    };
+}
+// ============================================================================
+// Screenshot Command Parameters
+// ============================================================================
+function buildScreenshotParams(options) {
+    if (options.ungrouped && options["group-id"]) {
+        (0, output_1.errorOut)("--ungrouped cannot be combined with --group-id");
+    }
+    const windowValue = parseWindowScope(options.window, { allowNew: false });
+    const outDir = options.out != null ? String(options.out).trim() : "";
+    if (options.out && !outDir) {
+        (0, output_1.errorOut)("--out requires a directory path");
+    }
+    return {
+        all: Boolean(options.all),
+        windowId: windowValue,
+        groupTitle: options.group,
+        groupId: options.ungrouped ? -1 : (options["group-id"] ? Number(options["group-id"]) : undefined),
+        tabIds: options.tab ? options.tab.map(Number) : undefined,
+        mode: options.mode,
+        format: options.format,
+        quality: options.quality != null ? Number(options.quality) : undefined,
+        tileMaxDim: options["tile-max-dim"] != null ? Number(options["tile-max-dim"]) : undefined,
+        maxBytes: options["max-bytes"] != null ? Number(options["max-bytes"]) : undefined,
+        waitFor: parseWaitFor(options["wait-for"]),
+        waitTimeoutMs: parseWaitTimeout(options["wait-timeout-ms"]),
+        outDir: outDir || undefined,
+        progress: Boolean(options.progress),
+    };
+}
+const VALID_WAIT_FOR = ["load", "dom", "settle", "none"];
+function parseWaitFor(value) {
+    if (value == null) {
+        return undefined;
+    }
+    const normalized = String(value).trim().toLowerCase();
+    if (!normalized) {
+        return undefined;
+    }
+    if (!VALID_WAIT_FOR.includes(normalized)) {
+        (0, output_1.errorOut)(`Invalid --wait-for value (use ${VALID_WAIT_FOR.join("|")})`);
+    }
+    return normalized;
+}
+function parseWaitTimeout(value) {
+    if (value == null) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        (0, output_1.errorOut)("Invalid --wait-timeout-ms value");
+    }
+    return Math.floor(parsed);
+}
+function parseWindowScope(value, { allowNew }) {
+    if (value == null) {
+        return undefined;
+    }
+    if (typeof value === "string") {
+        const trimmed = value.trim().toLowerCase();
+        if (!trimmed) {
+            return undefined;
+        }
+        if (trimmed === "active" || trimmed === "last-focused") {
+            return trimmed;
+        }
+        if (trimmed === "new") {
+            if (!allowNew) {
+                (0, output_1.errorOut)("--window new is only supported by open");
+            }
+            return trimmed;
+        }
+    }
+    const numeric = Number(value);
+    if (!Number.isFinite(numeric)) {
+        (0, output_1.errorOut)("Invalid --window value");
+    }
+    return numeric;
+}
+// ============================================================================
+// History/Undo Command Parameters
+// ============================================================================
+function buildHistoryParams(options) {
+    return {
+        limit: options.limit ? Number(options.limit) : undefined,
+    };
+}
+function buildUndoParams(options) {
+    return {
+        txid: options._[0] || options.txid,
+        latest: options.latest === true,
+    };
+}

package/cli/lib/commands/profile.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runProfileList = runProfileList;
+exports.runProfileShow = runProfileShow;
+exports.runProfileSwitch = runProfileSwitch;
+exports.runProfileRemove = runProfileRemove;
+const constants_1 = require("../constants");
+const output_1 = require("../output");
+const profiles_1 = require("../../../shared/profiles");
+function runProfileList(options, prettyOutput) {
+    const profiles = (0, profiles_1.listProfiles)();
+    (0, output_1.printJson)({
+        ok: true,
+        action: "profile-list",
+        data: {
+            profiles: profiles.map(({ name, profile, isDefault }) => ({
+                name,
+                browser: profile.browser,
+                dataDir: profile.dataDir,
+                isDefault,
+            })),
+        },
+    }, prettyOutput);
+}
+function runProfileShow(options, prettyOutput) {
+    const config = (0, constants_1.resolveConfig)();
+    const active = (0, profiles_1.getActiveProfile)();
+    if (!active) {
+        (0, output_1.printJson)({
+            ok: true,
+            action: "profile-show",
+            data: {
+                mode: "legacy",
+                message: "No profiles configured. Run tabctl setup to create one.",
+                dataDir: config.dataDir,
+                socketPath: config.socketPath,
+                policyPath: config.policyPath,
+            },
+        }, prettyOutput);
+        return;
+    }
+    const registry = (0, profiles_1.loadProfiles)();
+    (0, output_1.printJson)({
+        ok: true,
+        action: "profile-show",
+        data: {
+            name: active.name,
+            browser: active.profile.browser,
+            extensionId: active.profile.extensionId,
+            dataDir: active.profile.dataDir,
+            ...(active.profile.userDataDir ? { userDataDir: active.profile.userDataDir } : {}),
+            socketPath: config.socketPath,
+            policyPath: config.policyPath,
+            isDefault: active.name === registry.default,
+        },
+    }, prettyOutput);
+}
+function runProfileSwitch(options, prettyOutput) {
+    const name = options._[0];
+    if (!name) {
+        (0, output_1.errorOut)("Usage: tabctl profile-switch <name>");
+    }
+    const registry = (0, profiles_1.loadProfiles)();
+    if (!(name in registry.profiles)) {
+        (0, output_1.errorOut)(`Profile "${name}" not found`);
+    }
+    registry.default = name;
+    (0, profiles_1.saveProfiles)(registry);
+    (0, output_1.printJson)({
+        ok: true,
+        action: "profile-switch",
+        data: { name, message: `Default profile set to "${name}"` },
+    }, prettyOutput);
+}
+function runProfileRemove(options, prettyOutput) {
+    const name = options._[0];
+    if (!name) {
+        (0, output_1.errorOut)("Usage: tabctl profile-remove <name>");
+    }
+    try {
+        const registry = (0, profiles_1.removeProfile)(name);
+        (0, output_1.printJson)({
+            ok: true,
+            action: "profile-remove",
+            data: { name, newDefault: registry.default, message: `Profile "${name}" removed` },
+        }, prettyOutput);
+    }
+    catch (err) {
+        (0, output_1.errorOut)(err.message);
+    }
+}

package/cli/lib/constants.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_SIGNAL_SET = exports.SUPPORTED_SIGNALS = exports.SKILL_REPO = exports.SKILL_NAME = exports.DEFAULT_PAGE_LIMIT = exports.GROUP_COLORS = exports.EXTENSION_ID_PATTERN = exports.HOST_DESCRIPTION = exports.HOST_NAME = exports.resolveConfig = exports.DIRTY = exports.GIT_SHA = exports.BASE_VERSION = exports.VERSION = void 0;
+// Re-export version info from shared module
+var version_1 = require("../../shared/version");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_1.VERSION; } });
+Object.defineProperty(exports, "BASE_VERSION", { enumerable: true, get: function () { return version_1.BASE_VERSION; } });
+Object.defineProperty(exports, "GIT_SHA", { enumerable: true, get: function () { return version_1.GIT_SHA; } });
+Object.defineProperty(exports, "DIRTY", { enumerable: true, get: function () { return version_1.DIRTY; } });
+var config_1 = require("../../shared/config");
+Object.defineProperty(exports, "resolveConfig", { enumerable: true, get: function () { return config_1.resolveConfig; } });
+exports.HOST_NAME = "com.erwinkroon.tabctl";
+exports.HOST_DESCRIPTION = "tabctl native host";
+exports.EXTENSION_ID_PATTERN = /^[a-p]{32}$/;
+exports.GROUP_COLORS = new Set([
+    "grey",
+    "blue",
+    "red",
+    "yellow",
+    "green",
+    "pink",
+    "purple",
+    "cyan",
+    "orange",
+]);
+exports.DEFAULT_PAGE_LIMIT = 100;
+exports.SKILL_NAME = "tabctl";
+exports.SKILL_REPO = process.env.TABCTL_SKILL_REPO || "https://github.com/ekroon/tabctl";
+exports.SUPPORTED_SIGNALS = ["page-meta", "github-state", "selector"];
+exports.SUPPORTED_SIGNAL_SET = new Set(exports.SUPPORTED_SIGNALS);