@opentabs-dev/browser-extension 0.0.34

package/dist/browser-commands/extension-commands.js

@@ -0,0 +1,386 @@
+import { requireStringParam, requireTabId, sendErrorResult, sendSuccessResult, sendValidationError, } from './helpers.js';
+import { bgLogCollector } from '../background-log-state.js';
+import { buildWsUrl, DEFAULT_LOG_LIMIT, DEFAULT_SERVER_PORT, EXEC_MAX_ASYNC_WAIT_MS, EXEC_POLL_INTERVAL_MS, EXEC_RESULT_TRUNCATION_LIMIT, IS_READY_TIMEOUT_MS, SCRIPT_TIMEOUT_MS, SERVER_PORT_KEY, SIDE_PANEL_TIMEOUT_MS, WS_CONNECTED_KEY, WS_FLUSH_DELAY_MS, } from '../constants.js';
+import { getActiveCapturesSummary } from '../network-capture.js';
+import { getAllPluginMeta, getPluginMeta } from '../plugin-storage.js';
+import { findAllMatchingTabs } from '../tab-matching.js';
+import { getLastKnownStates } from '../tab-state.js';
+export const handleExtensionGetState = async (id) => {
+    try {
+        // Connection state from chrome.storage.session
+        const sessionData = await chrome.storage.session
+            .get(WS_CONNECTED_KEY)
+            .catch(() => ({}));
+        const wsConnected = typeof sessionData[WS_CONNECTED_KEY] === 'boolean' ? sessionData[WS_CONNECTED_KEY] : false;
+        // MCP server URL derived from port in chrome.storage.local
+        const localData = await chrome.storage.local
+            .get(SERVER_PORT_KEY)
+            .catch(() => ({}));
+        const port = typeof localData[SERVER_PORT_KEY] === 'number' && localData[SERVER_PORT_KEY] > 0
+            ? localData[SERVER_PORT_KEY]
+            : DEFAULT_SERVER_PORT;
+        const mcpServerUrl = buildWsUrl(port);
+        // Plugin metadata with tab states
+        const pluginIndex = await getAllPluginMeta();
+        const lastKnownStates = getLastKnownStates();
+        const plugins = Object.values(pluginIndex).map(meta => ({
+            name: meta.name,
+            version: meta.version,
+            displayName: meta.displayName,
+            urlPatterns: meta.urlPatterns,
+            toolCount: meta.tools.length,
+            tabState: lastKnownStates.get(meta.name) ?? 'closed',
+        }));
+        // Active network captures
+        const networkCaptures = getActiveCapturesSummary();
+        // Offscreen document existence
+        let offscreenExists = false;
+        try {
+            const contexts = await chrome.runtime.getContexts({
+                contextTypes: ['OFFSCREEN_DOCUMENT'],
+            });
+            offscreenExists = contexts.length > 0;
+        }
+        catch {
+            // chrome.runtime.getContexts may not be available in all Chrome versions
+        }
+        sendSuccessResult(id, {
+            connection: { wsConnected, mcpServerUrl },
+            plugins,
+            networkCaptures,
+            offscreen: { exists: offscreenExists },
+        });
+    }
+    catch (err) {
+        sendErrorResult(id, err);
+    }
+};
+export const handleExtensionGetLogs = async (params, id) => {
+    try {
+        const filterOptions = {};
+        if (typeof params.level === 'string' && params.level !== 'all') {
+            filterOptions.level = params.level;
+        }
+        if (typeof params.source === 'string' && params.source !== 'all') {
+            filterOptions.source = params.source;
+        }
+        if (typeof params.limit === 'number') {
+            filterOptions.limit = params.limit;
+        }
+        if (typeof params.since === 'number') {
+            filterOptions.since = params.since;
+        }
+        // Get background logs directly from the local collector
+        const bgEntries = bgLogCollector.getEntries(filterOptions);
+        const bgStats = bgLogCollector.getStats();
+        // Get offscreen logs via internal message
+        let offscreenEntries = [];
+        let offscreenStats = {
+            totalCaptured: 0,
+            bufferSize: 0,
+            oldestTimestamp: null,
+            newestTimestamp: null,
+        };
+        try {
+            const raw = await chrome.runtime.sendMessage({
+                type: 'offscreen:getLogs',
+                options: Object.keys(filterOptions).length > 0 ? filterOptions : undefined,
+            });
+            const response = raw;
+            if (response && Array.isArray(response.entries)) {
+                offscreenEntries = response.entries;
+            }
+            if (response?.stats) {
+                offscreenStats = response.stats;
+            }
+        }
+        catch {
+            // Offscreen document may not be running
+        }
+        // Merge entries by timestamp (newest first — both arrays are already newest-first)
+        const merged = [...bgEntries, ...offscreenEntries].sort((a, b) => b.timestamp - a.timestamp);
+        // Apply limit to the merged result
+        const limit = filterOptions.limit ?? DEFAULT_LOG_LIMIT;
+        const entries = merged.slice(0, limit);
+        sendSuccessResult(id, {
+            entries,
+            stats: {
+                totalBackground: bgStats.totalCaptured,
+                totalOffscreen: offscreenStats.totalCaptured,
+                bufferSize: bgStats.bufferSize + offscreenStats.bufferSize,
+            },
+        });
+    }
+    catch (err) {
+        sendErrorResult(id, err);
+    }
+};
+export const handleExtensionGetSidePanel = async (id) => {
+    try {
+        const sidePanelResult = await Promise.race([
+            chrome.runtime.sendMessage({ type: 'sp:getState' }).then((raw) => raw),
+            new Promise(resolve => setTimeout(() => resolve(null), SIDE_PANEL_TIMEOUT_MS)),
+        ]);
+        if (!sidePanelResult || typeof sidePanelResult !== 'object') {
+            sendSuccessResult(id, { open: false });
+            return;
+        }
+        const response = sidePanelResult;
+        sendSuccessResult(id, { open: true, state: response.state, html: response.html });
+    }
+    catch {
+        // Side panel not open or message failed — return { open: false }
+        sendSuccessResult(id, { open: false });
+    }
+};
+export const handleExtensionCheckAdapter = async (params, id) => {
+    try {
+        const pluginName = requireStringParam(params, 'plugin', id);
+        if (pluginName === null)
+            return;
+        const meta = await getPluginMeta(pluginName);
+        if (!meta) {
+            sendValidationError(id, `Plugin not found: "${pluginName}"`);
+            return;
+        }
+        const matchingTabs = await findAllMatchingTabs(meta);
+        const tabResults = await Promise.allSettled(matchingTabs.map(async (tab) => {
+            const tabId = tab.id;
+            if (tabId === undefined)
+                return null;
+            // Inspect the adapter in the tab's MAIN world
+            const inspectResults = await chrome.scripting.executeScript({
+                target: { tabId },
+                world: 'MAIN',
+                func: (pName) => {
+                    const ot = globalThis.__openTabs;
+                    const adapter = ot?.adapters?.[pName];
+                    if (!adapter || typeof adapter !== 'object') {
+                        return { adapterPresent: false };
+                    }
+                    const toolNames = [];
+                    if (Array.isArray(adapter.tools)) {
+                        for (const tool of adapter.tools) {
+                            if (tool && typeof tool === 'object' && typeof tool.name === 'string') {
+                                toolNames.push(tool.name);
+                            }
+                        }
+                    }
+                    return {
+                        adapterPresent: true,
+                        adapterHash: typeof adapter.__hash === 'string' ? adapter.__hash : null,
+                        toolCount: toolNames.length,
+                        toolNames,
+                    };
+                },
+                args: [pluginName],
+            });
+            const inspectResult = inspectResults[0]?.result;
+            if (!inspectResult) {
+                return {
+                    tabId,
+                    tabUrl: tab.url ?? '',
+                    adapterPresent: false,
+                    adapterHash: null,
+                    hashMatch: false,
+                    isReady: false,
+                    toolCount: 0,
+                    toolNames: [],
+                };
+            }
+            if (!inspectResult.adapterPresent) {
+                return {
+                    tabId,
+                    tabUrl: tab.url ?? '',
+                    adapterPresent: false,
+                    adapterHash: null,
+                    hashMatch: false,
+                    isReady: false,
+                    toolCount: 0,
+                    toolNames: [],
+                };
+            }
+            // Probe isReady() with timeout
+            let isReady = false;
+            try {
+                const readyResults = await Promise.race([
+                    chrome.scripting.executeScript({
+                        target: { tabId },
+                        world: 'MAIN',
+                        func: async (pName) => {
+                            const ot = globalThis.__openTabs;
+                            const adapter = ot?.adapters?.[pName];
+                            if (!adapter || typeof adapter.isReady !== 'function')
+                                return false;
+                            return await adapter.isReady();
+                        },
+                        args: [pluginName],
+                    }),
+                    new Promise(resolve => setTimeout(() => resolve(null), IS_READY_TIMEOUT_MS)),
+                ]);
+                if (readyResults !== null) {
+                    const readyResult = readyResults[0];
+                    isReady = readyResult?.result === true;
+                }
+            }
+            catch {
+                // isReady probe failed — leave as false
+            }
+            return {
+                tabId,
+                tabUrl: tab.url ?? '',
+                adapterPresent: true,
+                adapterHash: inspectResult.adapterHash ?? null,
+                hashMatch: meta.adapterHash ? inspectResult.adapterHash === meta.adapterHash : false,
+                isReady,
+                toolCount: inspectResult.toolCount ?? 0,
+                toolNames: inspectResult.toolNames ?? [],
+            };
+        }));
+        const matchingTabResults = [];
+        for (const result of tabResults) {
+            if (result.status === 'fulfilled' && result.value !== null) {
+                matchingTabResults.push(result.value);
+            }
+        }
+        sendSuccessResult(id, {
+            plugin: pluginName,
+            expectedHash: meta.adapterHash ?? null,
+            matchingTabs: matchingTabResults,
+        });
+    }
+    catch (err) {
+        sendErrorResult(id, err);
+    }
+};
+export const handleExtensionForceReconnect = async (id) => {
+    try {
+        // Send the success response FIRST, before the WebSocket is torn down.
+        // The response travels over the current WebSocket connection; if we
+        // close it first, the response would never reach the MCP server.
+        sendSuccessResult(id, { reconnecting: true });
+        await new Promise(resolve => setTimeout(resolve, WS_FLUSH_DELAY_MS));
+        await chrome.runtime.sendMessage({
+            type: 'bg:forceReconnect',
+        });
+    }
+    catch (err) {
+        // The response was already sent above, so this catch is best-effort.
+        // If sendToServer itself failed, there's nothing more we can do.
+        console.warn('[opentabs] extension.forceReconnect failed:', err);
+    }
+};
+/**
+ * Executes a pre-written JavaScript file in a tab's MAIN world, supporting both sync and async code.
+ * @param params - Expects `{ tabId: number, execFile: string }` where execFile matches the `__exec-<uuid>.js` pattern.
+ * @returns The script's return value, serialized as JSON. Async scripts are polled until resolved or timed out.
+ */
+export const handleBrowserExecuteScript = async (params, id) => {
+    try {
+        const tabId = requireTabId(params, id);
+        if (tabId === null)
+            return;
+        const execFile = requireStringParam(params, 'execFile', id);
+        if (execFile === null)
+            return;
+        if (!/^__exec-[a-f0-9-]+\.js$/.test(execFile)) {
+            sendValidationError(id, 'Invalid execFile format');
+            return;
+        }
+        let timeoutId;
+        // Step 1: Inject the exec file into the tab's MAIN world (bypasses page CSP)
+        const injectPromise = (async () => {
+            await chrome.scripting.executeScript({
+                target: { tabId },
+                world: 'MAIN',
+                files: [`adapters/${execFile}`],
+            });
+            // Step 2: Read the result. For sync code, __lastExecResult is set
+            // immediately by the wrapper. For async code (Promises), the wrapper
+            // sets __lastExecAsync=true and resolves __lastExecResult when the
+            // Promise settles. Poll until the result is available.
+            let elapsed = 0;
+            while (elapsed <= EXEC_MAX_ASYNC_WAIT_MS) {
+                const results = await chrome.scripting.executeScript({
+                    target: { tabId },
+                    world: 'MAIN',
+                    func: (truncLimit) => {
+                        const ot = globalThis.__openTabs;
+                        if (!ot)
+                            return { pending: false, result: { error: '__openTabs not found' } };
+                        const result = ot.__lastExecResult;
+                        const isAsync = ot.__lastExecAsync === true;
+                        // Result available (sync or async resolved) — read and clean up
+                        if (result && ('value' in result || 'error' in result)) {
+                            const captured = { ...result };
+                            // undefined is dropped by structured cloning — normalize to null
+                            if (captured.value === undefined)
+                                captured.value = null;
+                            // Serialize non-primitive values
+                            if (captured.value !== null && typeof captured.value === 'object') {
+                                try {
+                                    const json = JSON.stringify(captured.value);
+                                    captured.value =
+                                        json.length > truncLimit ? json.slice(0, truncLimit) + '... (truncated)' : JSON.parse(json);
+                                }
+                                catch {
+                                    captured.value = String(captured.value);
+                                }
+                            }
+                            // Clean up globals
+                            delete ot.__lastExecResult;
+                            delete ot.__lastExecAsync;
+                            return { pending: false, result: captured };
+                        }
+                        // Async code hasn't resolved yet — keep polling
+                        if (isAsync)
+                            return { pending: true };
+                        // Sync code produced no __lastExecResult (should not happen)
+                        return { pending: false, result: { error: 'No result captured' } };
+                    },
+                    args: [EXEC_RESULT_TRUNCATION_LIMIT],
+                });
+                const first = results[0];
+                const data = first?.result;
+                if (data && !data.pending) {
+                    return { value: data.result };
+                }
+                // Still pending — wait and retry
+                await new Promise(resolve => setTimeout(resolve, EXEC_POLL_INTERVAL_MS));
+                elapsed += EXEC_POLL_INTERVAL_MS;
+            }
+            // Async timed out — clean up and report error
+            await chrome.scripting
+                .executeScript({
+                target: { tabId },
+                world: 'MAIN',
+                func: () => {
+                    const ot = globalThis.__openTabs;
+                    if (ot) {
+                        delete ot.__lastExecResult;
+                        delete ot.__lastExecAsync;
+                    }
+                },
+            })
+                .catch(() => { });
+            return { value: { error: `Async code did not resolve within ${EXEC_MAX_ASYNC_WAIT_MS}ms` } };
+        })();
+        const timeoutPromise = new Promise((_resolve, reject) => {
+            timeoutId = setTimeout(() => {
+                reject(new Error(`Script execution timed out after ${SCRIPT_TIMEOUT_MS}ms`));
+            }, SCRIPT_TIMEOUT_MS);
+        });
+        let result;
+        try {
+            result = await Promise.race([injectPromise, timeoutPromise]);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        sendSuccessResult(id, result);
+    }
+    catch (err) {
+        sendErrorResult(id, err);
+    }
+};
+//# sourceMappingURL=extension-commands.js.map

package/dist/browser-commands/extension-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-commands.js","sourceRoot":"","sources":["../../src/browser-commands/extension-commands.ts"],"names":[],"mappings":"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"}

package/dist/browser-commands/helpers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Validates that `params.tabId` is a number.
+ * Sends a JSONRPC_INVALID_PARAMS error if invalid, returning `null`.
+ */
+export declare const requireTabId: (params: Record<string, unknown>, id: string | number) => number | null;
+/**
+ * Validates that `params.selector` is a non-empty string.
+ * Sends a JSONRPC_INVALID_PARAMS error if invalid, returning `null`.
+ */
+export declare const requireSelector: (params: Record<string, unknown>, id: string | number) => string | null;
+/**
+ * Validates that `params[paramName]` is a non-empty string.
+ * Sends a JSONRPC_INVALID_PARAMS error if invalid, returning `null`.
+ */
+export declare const requireStringParam: (params: Record<string, unknown>, paramName: string, id: string | number) => string | null;
+/**
+ * Validates that `params.url` is a string and not a blocked URL scheme.
+ * Sends a JSONRPC_INVALID_PARAMS error if invalid, returning `null`.
+ */
+export declare const requireUrl: (params: Record<string, unknown>, id: string | number) => string | null;
+/**
+ * Extracts the first result from `chrome.scripting.executeScript` output.
+ * Sends a JSONRPC_INTERNAL_ERROR if no result, or JSONRPC_INVALID_PARAMS if the result has an `error` field.
+ * Returns the result or `null`.
+ */
+export declare const extractScriptResult: (results: Array<{
+    result?: unknown;
+}>, id: string | number, fallbackMsg?: string) => Record<string, unknown> | null;
+/** Sends a JSONRPC_INTERNAL_ERROR with a sanitized error message. */
+export declare const sendErrorResult: (id: string | number, err: unknown) => void;
+/** Sends a JSONRPC_INVALID_PARAMS error with the given message. */
+export declare const sendValidationError: (id: string | number, message: string) => void;
+/** Sends a JSON-RPC 2.0 success response. */
+export declare const sendSuccessResult: (id: string | number, result: unknown) => void;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/browser-commands/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/browser-commands/helpers.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,MAAM,GAAG,MAAM,KAAG,MAAM,GAAG,IAW5F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,MAAM,GAAG,MAAM,KAAG,MAAM,GAAG,IAW/F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,MAAM,EACjB,IAAI,MAAM,GAAG,MAAM,KAClB,MAAM,GAAG,IAWX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,MAAM,GAAG,MAAM,KAAG,MAAM,GAAG,IAsB1F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,KAAK,CAAC;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EACpC,IAAI,MAAM,GAAG,MAAM,EACnB,oBAA+C,KAC9C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAe5B,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,eAAe,GAAI,IAAI,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,KAAG,IAMnE,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,GAAI,IAAI,MAAM,GAAG,MAAM,EAAE,SAAS,MAAM,KAAG,IAM1E,CAAC;AAEF,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB,GAAI,IAAI,MAAM,GAAG,MAAM,EAAE,QAAQ,OAAO,KAAG,IAExE,CAAC"}

package/dist/browser-commands/helpers.js

@@ -0,0 +1,121 @@
+import { JSONRPC_INTERNAL_ERROR, JSONRPC_INVALID_PARAMS } from '../json-rpc-errors.js';
+import { sendToServer } from '../messaging.js';
+import { sanitizeErrorMessage } from '../sanitize-error.js';
+import { isBlockedUrlScheme, toErrorMessage } from '@opentabs-dev/shared';
+/**
+ * Validates that `params.tabId` is a number.
+ * Sends a JSONRPC_INVALID_PARAMS error if invalid, returning `null`.
+ */
+export const requireTabId = (params, id) => {
+    const tabId = params.tabId;
+    if (typeof tabId !== 'number') {
+        sendToServer({
+            jsonrpc: '2.0',
+            error: { code: JSONRPC_INVALID_PARAMS, message: 'Missing or invalid tabId parameter' },
+            id,
+        });
+        return null;
+    }
+    return tabId;
+};
+/**
+ * Validates that `params.selector` is a non-empty string.
+ * Sends a JSONRPC_INVALID_PARAMS error if invalid, returning `null`.
+ */
+export const requireSelector = (params, id) => {
+    const selector = params.selector;
+    if (typeof selector !== 'string' || selector.length === 0) {
+        sendToServer({
+            jsonrpc: '2.0',
+            error: { code: JSONRPC_INVALID_PARAMS, message: 'Missing or invalid selector parameter' },
+            id,
+        });
+        return null;
+    }
+    return selector;
+};
+/**
+ * Validates that `params[paramName]` is a non-empty string.
+ * Sends a JSONRPC_INVALID_PARAMS error if invalid, returning `null`.
+ */
+export const requireStringParam = (params, paramName, id) => {
+    const value = params[paramName];
+    if (typeof value !== 'string' || value.length === 0) {
+        sendToServer({
+            jsonrpc: '2.0',
+            error: { code: JSONRPC_INVALID_PARAMS, message: `Missing or invalid ${paramName} parameter` },
+            id,
+        });
+        return null;
+    }
+    return value;
+};
+/**
+ * Validates that `params.url` is a string and not a blocked URL scheme.
+ * Sends a JSONRPC_INVALID_PARAMS error if invalid, returning `null`.
+ */
+export const requireUrl = (params, id) => {
+    const url = params.url;
+    if (typeof url !== 'string') {
+        sendToServer({
+            jsonrpc: '2.0',
+            error: { code: JSONRPC_INVALID_PARAMS, message: 'Missing or invalid url parameter' },
+            id,
+        });
+        return null;
+    }
+    if (isBlockedUrlScheme(url)) {
+        sendToServer({
+            jsonrpc: '2.0',
+            error: {
+                code: JSONRPC_INVALID_PARAMS,
+                message: 'URL scheme not allowed (javascript:, data:, file:, chrome:, blob: are blocked)',
+            },
+            id,
+        });
+        return null;
+    }
+    return url;
+};
+/**
+ * Extracts the first result from `chrome.scripting.executeScript` output.
+ * Sends a JSONRPC_INTERNAL_ERROR if no result, or JSONRPC_INVALID_PARAMS if the result has an `error` field.
+ * Returns the result or `null`.
+ */
+export const extractScriptResult = (results, id, fallbackMsg = 'No result from script execution') => {
+    const result = results[0]?.result;
+    if (!result) {
+        sendToServer({ jsonrpc: '2.0', error: { code: JSONRPC_INTERNAL_ERROR, message: fallbackMsg }, id });
+        return null;
+    }
+    if (result.error) {
+        sendToServer({
+            jsonrpc: '2.0',
+            error: { code: JSONRPC_INVALID_PARAMS, message: sanitizeErrorMessage(result.error) },
+            id,
+        });
+        return null;
+    }
+    return result;
+};
+/** Sends a JSONRPC_INTERNAL_ERROR with a sanitized error message. */
+export const sendErrorResult = (id, err) => {
+    sendToServer({
+        jsonrpc: '2.0',
+        error: { code: JSONRPC_INTERNAL_ERROR, message: sanitizeErrorMessage(toErrorMessage(err)) },
+        id,
+    });
+};
+/** Sends a JSONRPC_INVALID_PARAMS error with the given message. */
+export const sendValidationError = (id, message) => {
+    sendToServer({
+        jsonrpc: '2.0',
+        error: { code: JSONRPC_INVALID_PARAMS, message },
+        id,
+    });
+};
+/** Sends a JSON-RPC 2.0 success response. */
+export const sendSuccessResult = (id, result) => {
+    sendToServer({ jsonrpc: '2.0', result, id });
+};
+//# sourceMappingURL=helpers.js.map

package/dist/browser-commands/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/browser-commands/helpers.ts"],"names":[],"mappings":"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"}

package/dist/browser-commands/index.d.ts

@@ -0,0 +1,11 @@
+export { handleBrowserGetTabContent, handleBrowserGetPageHtml, handleBrowserGetStorage, handleBrowserScreenshotTab, } from './content-commands.js';
+export { handleBrowserGetCookies, handleBrowserSetCookie, handleBrowserDeleteCookies } from './cookie-commands.js';
+export { handleBrowserExecuteScript, handleExtensionCheckAdapter, handleExtensionForceReconnect, handleExtensionGetLogs, handleExtensionGetSidePanel, handleExtensionGetState, } from './extension-commands.js';
+export { handleBrowserClickElement, handleBrowserHandleDialog, handleBrowserHoverElement, handleBrowserQueryElements, handleBrowserSelectOption, handleBrowserTypeText, handleBrowserWaitForElement, } from './interaction-commands.js';
+export { handleBrowserPressKey } from './key-press-command.js';
+export { handleBrowserScroll } from './scroll-command.js';
+export { handleBrowserClearConsoleLogs, handleBrowserDisableNetworkCapture, handleBrowserEnableNetworkCapture, handleBrowserGetConsoleLogs, handleBrowserGetNetworkRequests, } from './network-commands.js';
+export { handleBrowserGetResourceContent, handleBrowserListResources, withDebugger, findFrameForResource, isTextMimeType, TEXT_MIME_PREFIXES, TEXT_MIME_EXACT, } from './resource-commands.js';
+export type { CdpFrame, CdpFrameResourceTree, CdpResource } from './resource-commands.js';
+export { handleBrowserCloseTab, handleBrowserFocusTab, handleBrowserGetTabInfo, handleBrowserListTabs, handleBrowserNavigateTab, handleBrowserOpenTab, } from './tab-commands.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser-commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser-commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACnH,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,EAClC,iCAAiC,EACjC,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,QAAQ,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/browser-commands/index.js

@@ -0,0 +1,10 @@
+export { handleBrowserGetTabContent, handleBrowserGetPageHtml, handleBrowserGetStorage, handleBrowserScreenshotTab, } from './content-commands.js';
+export { handleBrowserGetCookies, handleBrowserSetCookie, handleBrowserDeleteCookies } from './cookie-commands.js';
+export { handleBrowserExecuteScript, handleExtensionCheckAdapter, handleExtensionForceReconnect, handleExtensionGetLogs, handleExtensionGetSidePanel, handleExtensionGetState, } from './extension-commands.js';
+export { handleBrowserClickElement, handleBrowserHandleDialog, handleBrowserHoverElement, handleBrowserQueryElements, handleBrowserSelectOption, handleBrowserTypeText, handleBrowserWaitForElement, } from './interaction-commands.js';
+export { handleBrowserPressKey } from './key-press-command.js';
+export { handleBrowserScroll } from './scroll-command.js';
+export { handleBrowserClearConsoleLogs, handleBrowserDisableNetworkCapture, handleBrowserEnableNetworkCapture, handleBrowserGetConsoleLogs, handleBrowserGetNetworkRequests, } from './network-commands.js';
+export { handleBrowserGetResourceContent, handleBrowserListResources, withDebugger, findFrameForResource, isTextMimeType, TEXT_MIME_PREFIXES, TEXT_MIME_EXACT, } from './resource-commands.js';
+export { handleBrowserCloseTab, handleBrowserFocusTab, handleBrowserGetTabInfo, handleBrowserListTabs, handleBrowserNavigateTab, handleBrowserOpenTab, } from './tab-commands.js';
+//# sourceMappingURL=index.js.map

package/dist/browser-commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser-commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACnH,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,6BAA6B,EAC7B,sBAAsB,EACtB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,EAClC,iCAAiC,EACjC,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/browser-commands/interaction-commands.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Clicks a DOM element matched by a CSS selector in a tab's page context.
+ * @param params - Expects `{ tabId: number, selector: string }`.
+ * @returns `{ clicked, tagName, text }` describing the clicked element.
+ */
+export declare const handleBrowserClickElement: (params: Record<string, unknown>, id: string | number) => Promise<void>;
+/**
+ * Types text into an input, textarea, or contentEditable element, dispatching input and change events.
+ * @param params - Expects `{ tabId: number, selector: string, text: string, clear?: boolean }`. Defaults to clearing existing value before typing.
+ * @returns `{ typed, tagName, value }` with the element's resulting value.
+ */
+export declare const handleBrowserTypeText: (params: Record<string, unknown>, id: string | number) => Promise<void>;
+export declare const handleBrowserSelectOption: (params: Record<string, unknown>, id: string | number) => Promise<void>;
+export declare const handleBrowserWaitForElement: (params: Record<string, unknown>, id: string | number) => Promise<void>;
+/**
+ * Queries DOM elements matching a CSS selector and returns their tag names, text content, and specified attributes.
+ * @param params - Expects `{ tabId: number, selector: string, limit?: number, attributes?: string[] }`. Defaults to 100 element limit and standard attribute set.
+ * @returns `{ count, elements }` where count is the total matches and elements is the (possibly limited) result array.
+ */
+export declare const handleBrowserQueryElements: (params: Record<string, unknown>, id: string | number) => Promise<void>;
+export declare const handleBrowserHoverElement: (params: Record<string, unknown>, id: string | number) => Promise<void>;
+export declare const handleBrowserHandleDialog: (params: Record<string, unknown>, id: string | number) => Promise<void>;
+//# sourceMappingURL=interaction-commands.d.ts.map

package/dist/browser-commands/interaction-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-commands.d.ts","sourceRoot":"","sources":["../../src/browser-commands/interaction-commands.ts"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,MAAM,GAAG,MAAM,KAClB,OAAO,CAAC,IAAI,CA6Bd,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAU,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,MAAM,GAAG,MAAM,KAAG,OAAO,CAAC,IAAI,CA2D9G,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,MAAM,GAAG,MAAM,KAClB,OAAO,CAAC,IAAI,CAuDd,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,MAAM,GAAG,MAAM,KAClB,OAAO,CAAC,IAAI,CA8Cd,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,MAAM,GAAG,MAAM,KAClB,OAAO,CAAC,IAAI,CAkCd,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,MAAM,GAAG,MAAM,KAClB,OAAO,CAAC,IAAI,CAwDd,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,MAAM,GAAG,MAAM,KAClB,OAAO,CAAC,IAAI,CA8Bd,CAAC"}