@aexol/spectral 0.8.6 → 0.8.9

package/dist/extensions/browser/browser-service.d.ts

@@ -0,0 +1,104 @@
+/**
+ * BrowserService — singleton managing Playwright browser lifecycle.
+ *
+ * One browser instance, one persistent context, multiple pages (tabs).
+ * Collects console messages and network requests automatically.
+ * Follows the same singleton pattern as fetcher-mcp's BrowserService.
+ *
+ * Playwright is loaded lazily on first use (not at import time). This allows
+ * the module to load in standalone Bun binaries where playwright is unavailable.
+ * Tools will report a clear "Browser unavailable" error instead of crashing.
+ */
+import type { Browser, BrowserContext, Page } from "playwright";
+import type { BrowserConfig } from "./config.js";
+export interface NetworkRequest {
+    index: number;
+    url: string;
+    method: string;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    responseHeaders: Record<string, string>;
+    postData?: string;
+    body?: string;
+    timestamp: number;
+}
+export declare class BrowserService {
+    private browser;
+    private context;
+    private pages;
+    private activePageIndex;
+    private config;
+    private consoleBuffer;
+    private networkBuffer;
+    private nextNetworkIndex;
+    private pendingDialogs;
+    constructor(config?: Partial<BrowserConfig>);
+    /** Get or create the singleton instance. */
+    static getInstance(config?: Partial<BrowserConfig>): BrowserService;
+    /** Reset singleton (for testing). */
+    static resetInstance(): void;
+    /** Check whether Playwright is installed and loadable (static, does NOT start a browser). */
+    static isAvailable(): boolean;
+    /**
+     * Human-readable message explaining why the browser is unavailable.
+     * Returns null when the browser is available.
+     */
+    static unavailabilityReason(): string | null;
+    /** Ensure browser, context, and at least one page are ready. */
+    ensureBrowser(): Promise<{
+        browser: Browser;
+        context: BrowserContext;
+        page: Page;
+    }>;
+    /** Get the currently active page. */
+    getActivePage(): Page;
+    /** Navigate to a URL on the active page. */
+    navigate(url: string): Promise<{
+        title: string;
+        url: string;
+    }>;
+    /** Navigate back. */
+    navigateBack(): Promise<{
+        title: string;
+        url: string;
+    }>;
+    /** Close the active page. If last page, create a blank one. */
+    closePage(): Promise<void>;
+    /** Resize the viewport. */
+    resize(width: number, height: number): Promise<void>;
+    listTabs(): Array<{
+        index: number;
+        title: string;
+        url: string;
+    }>;
+    createTab(): Promise<{
+        index: number;
+    }>;
+    closeTab(index: number): Promise<void>;
+    selectTab(index: number): Promise<{
+        index: number;
+    }>;
+    private installDialogInterceptor;
+    getPendingDialogs(): Array<{
+        message: string;
+        type: string;
+    }>;
+    handleDialog(accept: boolean, promptText?: string): Promise<string>;
+    getConsoleMessages(level?: "error" | "warning" | "info" | "debug", all?: boolean): Array<{
+        type: string;
+        text: string;
+        pageUrl: string;
+    }>;
+    clearConsoleMessages(): void;
+    trackNetworkRequest(page: Page): void;
+    getNetworkRequests(): NetworkRequest[];
+    getNetworkRequest(index: number): NetworkRequest | undefined;
+    clearNetworkRequests(): void;
+    /** Close browser, context, and all pages. */
+    close(): Promise<void>;
+    /** Reset console/network buffers. */
+    resetBuffers(): void;
+    getConfig(): BrowserConfig;
+}
+//# sourceMappingURL=browser-service.d.ts.map

package/dist/extensions/browser/browser-service.d.ts.map

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

package/dist/extensions/browser/browser-service.js

@@ -0,0 +1,333 @@
+/**
+ * BrowserService — singleton managing Playwright browser lifecycle.
+ *
+ * One browser instance, one persistent context, multiple pages (tabs).
+ * Collects console messages and network requests automatically.
+ * Follows the same singleton pattern as fetcher-mcp's BrowserService.
+ *
+ * Playwright is loaded lazily on first use (not at import time). This allows
+ * the module to load in standalone Bun binaries where playwright is unavailable.
+ * Tools will report a clear "Browser unavailable" error instead of crashing.
+ */
+import { createRequire } from "node:module";
+import { getBrowserConfig } from "./config.js";
+const _require = createRequire(import.meta.url);
+let _pw = null;
+let _pwError = null;
+function loadPlaywright() {
+    if (_pw)
+        return _pw;
+    if (_pwError)
+        throw new Error(_pwError);
+    try {
+        _pw = _require("playwright");
+        return _pw;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        _pwError = `Browser automation unavailable: playwright could not be loaded (${msg}).`;
+        throw new Error(_pwError);
+    }
+}
+let instance = null;
+export class BrowserService {
+    browser = null;
+    context = null;
+    pages = [];
+    activePageIndex = 0;
+    config;
+    consoleBuffer = [];
+    networkBuffer = new Map();
+    nextNetworkIndex = 0;
+    pendingDialogs = [];
+    constructor(config) {
+        this.config = { ...getBrowserConfig(), ...config };
+    }
+    /** Get or create the singleton instance. */
+    static getInstance(config) {
+        if (!instance) {
+            instance = new BrowserService(config);
+        }
+        return instance;
+    }
+    /** Reset singleton (for testing). */
+    static resetInstance() {
+        instance = null;
+    }
+    /** Check whether Playwright is installed and loadable (static, does NOT start a browser). */
+    static isAvailable() {
+        try {
+            loadPlaywright();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Human-readable message explaining why the browser is unavailable.
+     * Returns null when the browser is available.
+     */
+    static unavailabilityReason() {
+        if (_pwError)
+            return _pwError;
+        if (_pw)
+            return null;
+        try {
+            loadPlaywright();
+            return null;
+        }
+        catch (err) {
+            return err instanceof Error ? err.message : String(err);
+        }
+    }
+    /** Ensure browser, context, and at least one page are ready. */
+    async ensureBrowser() {
+        if (this.browser?.isConnected() && this.context && this.pages.length > 0) {
+            const page = this.pages[this.activePageIndex];
+            return { browser: this.browser, context: this.context, page };
+        }
+        await this.close();
+        const pw = loadPlaywright();
+        const launchOptions = {
+            headless: this.config.headless,
+            args: [
+                "--no-sandbox",
+                "--disable-setuid-sandbox",
+                "--disable-dev-shm-usage",
+            ],
+        };
+        switch (this.config.browserName) {
+            case "firefox":
+                this.browser = await pw.firefox.launch(launchOptions);
+                break;
+            case "webkit":
+                this.browser = await pw.webkit.launch(launchOptions);
+                break;
+            default:
+                this.browser = await pw.chromium.launch(launchOptions);
+        }
+        this.context = await this.browser.newContext({
+            viewport: this.config.viewport,
+        });
+        // Auto-collect console messages and network requests
+        this.context.on("page", (page) => {
+            page.on("console", (msg) => {
+                this.consoleBuffer.push({
+                    type: msg.type(),
+                    text: msg.text(),
+                    pageUrl: page.url(),
+                });
+            });
+            this.trackNetworkRequest(page);
+            this.installDialogInterceptor(page);
+        });
+        const page = await this.context.newPage();
+        this.trackNetworkRequest(page);
+        this.installDialogInterceptor(page);
+        this.pages = [page];
+        this.activePageIndex = 0;
+        return { browser: this.browser, context: this.context, page };
+    }
+    /** Get the currently active page. */
+    getActivePage() {
+        if (this.pages.length === 0) {
+            throw new Error("No browser pages available. Call ensureBrowser() first.");
+        }
+        return this.pages[this.activePageIndex];
+    }
+    /** Navigate to a URL on the active page. */
+    async navigate(url) {
+        const { page } = await this.ensureBrowser();
+        // Auto-prepend https if missing
+        const normalizedUrl = url.startsWith("http") ? url : `https://${url}`;
+        await page.goto(normalizedUrl, {
+            timeout: this.config.navigationTimeout,
+            waitUntil: "domcontentloaded",
+        });
+        return { title: await page.title(), url: page.url() };
+    }
+    /** Navigate back. */
+    async navigateBack() {
+        const page = this.getActivePage();
+        await page.goBack({ timeout: this.config.navigationTimeout });
+        return { title: await page.title(), url: page.url() };
+    }
+    /** Close the active page. If last page, create a blank one. */
+    async closePage() {
+        if (this.pages.length === 0)
+            return;
+        const page = this.pages[this.activePageIndex];
+        await page.close();
+        this.pages.splice(this.activePageIndex, 1);
+        if (this.pages.length === 0 && this.context) {
+            const newPage = await this.context.newPage();
+            this.pages = [newPage];
+            this.activePageIndex = 0;
+        }
+        else {
+            this.activePageIndex = Math.min(this.activePageIndex, this.pages.length - 1);
+        }
+    }
+    /** Resize the viewport. */
+    async resize(width, height) {
+        const page = this.getActivePage();
+        await page.setViewportSize({ width, height });
+        this.config.viewport = { width, height };
+    }
+    // --- Tab management ---
+    listTabs() {
+        return this.pages.map((p, i) => ({
+            index: i,
+            title: p.url() ? `Tab ${i}` : p.url(),
+            url: p.url(),
+        }));
+    }
+    async createTab() {
+        if (!this.context)
+            await this.ensureBrowser();
+        const page = await this.context.newPage();
+        this.trackNetworkRequest(page);
+        this.installDialogInterceptor(page);
+        this.pages.push(page);
+        this.activePageIndex = this.pages.length - 1;
+        return { index: this.activePageIndex };
+    }
+    async closeTab(index) {
+        if (this.pages.length <= 1)
+            return; // Keep at least one page
+        if (index < 0 || index >= this.pages.length)
+            return;
+        const page = this.pages[index];
+        await page.close();
+        this.pages.splice(index, 1);
+        if (this.activePageIndex >= this.pages.length) {
+            this.activePageIndex = this.pages.length - 1;
+        }
+    }
+    async selectTab(index) {
+        if (index < 0 || index >= this.pages.length) {
+            throw new Error(`Tab index ${index} out of range (0-${this.pages.length - 1})`);
+        }
+        this.activePageIndex = index;
+        const page = this.getActivePage();
+        await page.bringToFront();
+        return { index };
+    }
+    // --- Dialog interception ---
+    installDialogInterceptor(page) {
+        page.on("dialog", (dialog) => {
+            // Hold the dialog until agent handles it via browser_handle_dialog
+            this.pendingDialogs.push({
+                message: dialog.message(),
+                type: dialog.type(),
+                resolve: (text) => {
+                    dialog.accept(text).catch(() => { });
+                },
+                reject: () => {
+                    dialog.dismiss().catch(() => { });
+                },
+            });
+        });
+    }
+    getPendingDialogs() {
+        return this.pendingDialogs.map((d) => ({ message: d.message, type: d.type }));
+    }
+    async handleDialog(accept, promptText) {
+        if (this.pendingDialogs.length === 0) {
+            throw new Error("No pending dialogs.");
+        }
+        const dialog = this.pendingDialogs.shift();
+        if (accept) {
+            dialog.resolve(promptText);
+        }
+        else {
+            dialog.reject(new Error("Dialog dismissed"));
+        }
+        return dialog.message;
+    }
+    // --- Console messages ---
+    getConsoleMessages(level, all = false) {
+        const msgs = all ? [...this.consoleBuffer] : [...this.consoleBuffer];
+        if (level) {
+            const severity = { error: 0, warning: 1, info: 2, debug: 3 };
+            const threshold = severity[level];
+            return msgs.filter((m) => (severity[m.type] ?? 3) <= threshold);
+        }
+        return msgs;
+    }
+    clearConsoleMessages() {
+        this.consoleBuffer = [];
+    }
+    // --- Network requests ---
+    trackNetworkRequest(page) {
+        page.on("request", (request) => {
+            const index = this.nextNetworkIndex++;
+            const entry = {
+                index,
+                url: request.url(),
+                method: request.method(),
+                status: 0,
+                statusText: "",
+                headers: request.headers(),
+                responseHeaders: {},
+                postData: request.postData() ?? undefined,
+                timestamp: Date.now(),
+            };
+            this.networkBuffer.set(index, entry);
+            request.response().then((response) => {
+                if (!response)
+                    return;
+                entry.status = response.status();
+                entry.statusText = response.statusText();
+                entry.responseHeaders = response.headers();
+            }).catch(() => {
+                // Request may fail or be aborted
+            });
+        });
+    }
+    getNetworkRequests() {
+        return Array.from(this.networkBuffer.values()).sort((a, b) => a.index - b.index);
+    }
+    getNetworkRequest(index) {
+        return this.networkBuffer.get(index);
+    }
+    clearNetworkRequests() {
+        this.networkBuffer.clear();
+        this.nextNetworkIndex = 0;
+    }
+    // --- Lifecycle ---
+    /** Close browser, context, and all pages. */
+    async close() {
+        for (const page of this.pages) {
+            try {
+                await page.close();
+            }
+            catch { /* ignore */ }
+        }
+        this.pages = [];
+        this.activePageIndex = 0;
+        if (this.context) {
+            try {
+                await this.context.close();
+            }
+            catch { /* ignore */ }
+            this.context = null;
+        }
+        if (this.browser) {
+            try {
+                await this.browser.close();
+            }
+            catch { /* ignore */ }
+            this.browser = null;
+        }
+    }
+    /** Reset console/network buffers. */
+    resetBuffers() {
+        this.clearConsoleMessages();
+        this.clearNetworkRequests();
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+}

package/dist/extensions/browser/config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Browser extension configuration.
+ */
+export interface BrowserConfig {
+    /** Default browser name to launch. */
+    browserName: "chromium" | "firefox" | "webkit";
+    /** Whether to run headless. */
+    headless: boolean;
+    /** Default viewport size. */
+    viewport: {
+        width: number;
+        height: number;
+    };
+    /** Default navigation timeout (ms). */
+    navigationTimeout: number;
+    /** Default action timeout (ms). */
+    actionTimeout: number;
+    /** Directory to save screenshots and output files. */
+    outputDir: string;
+    /** Whether to enable debug mode (keep browser visible, verbose logging). */
+    debug: boolean;
+}
+export declare function getBrowserConfig(): BrowserConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/extensions/browser/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/extensions/browser/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,WAAW,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC/C,+BAA+B;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,6BAA6B;IAC7B,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,uCAAuC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAahD"}

package/dist/extensions/browser/config.js

@@ -0,0 +1,17 @@
+/**
+ * Browser extension configuration.
+ */
+export function getBrowserConfig() {
+    return {
+        browserName: process.env.BROWSER_NAME ?? "chromium",
+        headless: process.env.BROWSER_HEADLESS === "true" ? true : false,
+        viewport: {
+            width: Number(process.env.BROWSER_VIEWPORT_WIDTH) || 1280,
+            height: Number(process.env.BROWSER_VIEWPORT_HEIGHT) || 720,
+        },
+        navigationTimeout: Number(process.env.BROWSER_NAVIGATION_TIMEOUT) || 60_000,
+        actionTimeout: Number(process.env.BROWSER_ACTION_TIMEOUT) || 5_000,
+        outputDir: process.env.BROWSER_OUTPUT_DIR ?? ".spectral/browser-output",
+        debug: process.env.BROWSER_DEBUG === "true" ? true : false,
+    };
+}

package/dist/extensions/browser/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Browser Extension for spectral.
+ *
+ * Provides native browser automation tools via Playwright, registered as
+ * spectral extension tools (not MCP). This enables the coding agent to
+ * control a real browser: navigate, click, type, evaluate JS, take
+ * screenshots, inspect network traffic, and more.
+ *
+ * All 20 tools match the same API surface as playwright-mcp, but without
+ * the MCP protocol layer — they call Playwright directly from Node.js.
+ *
+ * Architecture:
+ *   - BrowserService (singleton) — one browser, one context, multiple pages
+ *   - Tools register via ext.registerTool() — same pattern as kanban-bridge
+ *   - Browser auto-closes on session_shutdown
+ *
+ * Registered tools (20):
+ *   Core:        browser_navigate, browser_navigate_back, browser_close, browser_resize
+ *   Tabs:        browser_tabs
+ *   Input:       browser_click, browser_type, browser_press_key, browser_hover,
+ *                browser_drag, browser_select_option, browser_fill_form, browser_file_upload
+ *   Evaluate:    browser_evaluate, browser_run_code_unsafe
+ *   Screenshot:  browser_take_screenshot, browser_snapshot
+ *   Network:     browser_network_requests, browser_network_request
+ *   Console:     browser_console_messages
+ *   Dialog:      browser_handle_dialog
+ *   Wait:        browser_wait_for
+ *   Drop:        browser_drop
+ *
+ * Usage:
+ *   spectral --extension ./cli-node/src/extensions/browser/index.ts
+ */
+import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
+export default function browserExtension(ext: ExtensionAPI): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAcpE,wBAA8B,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA4D/E"}

package/dist/extensions/browser/index.js

@@ -0,0 +1,126 @@
+/**
+ * Browser Extension for spectral.
+ *
+ * Provides native browser automation tools via Playwright, registered as
+ * spectral extension tools (not MCP). This enables the coding agent to
+ * control a real browser: navigate, click, type, evaluate JS, take
+ * screenshots, inspect network traffic, and more.
+ *
+ * All 20 tools match the same API surface as playwright-mcp, but without
+ * the MCP protocol layer — they call Playwright directly from Node.js.
+ *
+ * Architecture:
+ *   - BrowserService (singleton) — one browser, one context, multiple pages
+ *   - Tools register via ext.registerTool() — same pattern as kanban-bridge
+ *   - Browser auto-closes on session_shutdown
+ *
+ * Registered tools (20):
+ *   Core:        browser_navigate, browser_navigate_back, browser_close, browser_resize
+ *   Tabs:        browser_tabs
+ *   Input:       browser_click, browser_type, browser_press_key, browser_hover,
+ *                browser_drag, browser_select_option, browser_fill_form, browser_file_upload
+ *   Evaluate:    browser_evaluate, browser_run_code_unsafe
+ *   Screenshot:  browser_take_screenshot, browser_snapshot
+ *   Network:     browser_network_requests, browser_network_request
+ *   Console:     browser_console_messages
+ *   Dialog:      browser_handle_dialog
+ *   Wait:        browser_wait_for
+ *   Drop:        browser_drop
+ *
+ * Usage:
+ *   spectral --extension ./cli-node/src/extensions/browser/index.ts
+ */
+import { BrowserService } from "./browser-service.js";
+import { registerCoreTools } from "./tools/core.js";
+import { registerTabsTools } from "./tools/tabs.js";
+import { registerInputTools } from "./tools/input.js";
+import { registerEvaluateTools } from "./tools/evaluate.js";
+import { registerScreenshotTools } from "./tools/screenshot.js";
+import { registerNetworkTools } from "./tools/network.js";
+import { registerConsoleTools } from "./tools/console.js";
+import { registerDialogTools } from "./tools/dialog.js";
+import { registerWaitTools } from "./tools/wait.js";
+import { registerDropTools } from "./tools/drop.js";
+import { registerStreamTools } from "./stream/stream-tool.js";
+export default async function browserExtension(ext) {
+    const available = BrowserService.isAvailable();
+    if (!available) {
+        const reason = BrowserService.unavailabilityReason() ?? "unknown reason";
+        process.stderr.write(`[browser] Browser automation unavailable: ${reason}\n` +
+            `[browser] Install Playwright to enable browser features: npx playwright install chromium\n`);
+        // Extension still loads cleanly — just logs the warning. Tools are not
+        // registered, so the agent won't see browser tools and won't attempt to use them.
+        return;
+    }
+    const bs = BrowserService.getInstance();
+    // Auto-close browser when the session ends
+    ext.on("session_shutdown", async () => {
+        try {
+            await bs.close();
+            process.stderr.write("[browser] Browser closed.\n");
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[browser] Error closing browser: ${msg}\n`);
+        }
+    });
+    // Register all tool groups
+    const registrars = [
+        { name: "core", fn: () => registerCoreTools(ext, bs) },
+        { name: "tabs", fn: () => registerTabsTools(ext, bs) },
+        { name: "input", fn: () => registerInputTools(ext, bs) },
+        { name: "evaluate", fn: () => registerEvaluateTools(ext, bs) },
+        { name: "screenshot", fn: () => registerScreenshotTools(ext, bs) },
+        { name: "network", fn: () => registerNetworkTools(ext, bs) },
+        { name: "console", fn: () => registerConsoleTools(ext, bs) },
+        { name: "dialog", fn: () => registerDialogTools(ext, bs) },
+        { name: "wait", fn: () => registerWaitTools(ext, bs) },
+        { name: "drop", fn: () => registerDropTools(ext, bs) },
+        { name: "stream", fn: () => registerStreamTools(ext, bs) },
+    ];
+    let totalRegistered = 0;
+    for (const registrar of registrars) {
+        try {
+            const before = countRegisteredTools(ext);
+            registrar.fn();
+            const after = countRegisteredTools(ext);
+            totalRegistered += after - before;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[browser] Failed to register ${registrar.name} tools: ${msg}\n`);
+        }
+    }
+    process.stderr.write(`[browser] Registered ${totalRegistered} browser automation tool(s). ` +
+        `Browser: ${bs.getConfig().browserName}, ` +
+        `headless: ${bs.getConfig().headless}.\n`);
+}
+/** Count how many tools are registered (best-effort). */
+function countRegisteredTools(ext) {
+    try {
+        // getToolDefinition is available on ExtensionAPI
+        let count = 0;
+        const knownTools = [
+            "browser_navigate", "browser_navigate_back", "browser_close", "browser_resize",
+            "browser_tabs",
+            "browser_click", "browser_type", "browser_press_key", "browser_hover",
+            "browser_drag", "browser_select_option", "browser_fill_form", "browser_file_upload",
+            "browser_evaluate", "browser_run_code_unsafe",
+            "browser_take_screenshot", "browser_snapshot",
+            "browser_network_requests", "browser_network_request",
+            "browser_console_messages",
+            "browser_handle_dialog",
+            "browser_wait_for",
+            "browser_drop",
+            "browser_stream_start", "browser_stream_stop", "browser_stream_status",
+        ];
+        for (const name of knownTools) {
+            if (ext.getToolDefinition(name))
+                count++;
+        }
+        return count;
+    }
+    catch {
+        return 0;
+    }
+}

package/dist/extensions/browser/stream/signaling-client.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Stream signaling client — connects to the backend WebSocket endpoint
+ * for WebRTC signaling relay.
+ *
+ * The backend only relays SDP offers/answers and ICE candidates between
+ * the streamer (this extension) and viewers. No media passes through.
+ */
+export interface StreamSignalingConfig {
+    signalingUrl: string;
+    sessionId: string;
+    iceServers: Array<{
+        urls: string | string[];
+        username?: string;
+        credential?: string;
+    }>;
+}
+export declare class SignalingClient {
+    private readonly config;
+    private ws;
+    private connected;
+    constructor(config: StreamSignalingConfig);
+    connect(): Promise<void>;
+    private handleMessage;
+    send(data: Record<string, unknown>): void;
+    close(): void;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=signaling-client.d.ts.map