@everydaydevopsio/pilot 0.6.3 → 0.7.0

package/AGENTS.md

@@ -13,3 +13,8 @@
 - When adding, renaming, or removing a Pilot MCP tool, update the Codex tool allowlist and verify the Claude `.mcp.json` local-server configuration in the same change.
 - Build Pilot with `pnpm run build` before testing either MCP configuration so `dist/mcp/index.js` reflects the current source.
 - Preserve environment entries needed by the local development session, such as the Linux `DISPLAY` value. Do not assume one display number works on every machine or remote session.
+
+## Releases
+
+- Always release by running the `publish.yml` workflow with a `release_type` of `patch`, `minor`, or `major`, for example `gh workflow run publish.yml -f release_type=patch`. The workflow computes the version, updates `package.json` and `CHANGELOG.md`, creates and pushes the tag, publishes to npm, and creates the GitHub release.
+- Do not create or push release tags directly, and do not bump the version in `package.json` or edit the release entries in `CHANGELOG.md` by hand.

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.7.0] - 2026-11-04
+
+### Highlights
+
+- Browser MCP tools now run through a shared `BrowserDriver`, with capability checks to gate tool access based on driver support. (#63)
+
+### Fixes
+
+- No standalone bug fixes are included in this release.
+
+### Changes
+
+- Updated agent guidance to require releases through the `publish.yml` workflow. (#57)
+
+**Full changelog:** [0.6.3...0.7.0](../../compare/0.6.3...0.7.0)
+
 ## [0.6.3] - 2026-11-03
 
 This release adds browser session management tools and improves Chrome startup, recovery, and shutdown reliability.

package/README.md

@@ -469,6 +469,22 @@ pnpm run test:e2e:mcp
 pnpm run test:e2e:mcp:docker
 ```
 
+## Browser Support
+
+Pilot drives Chrome today. MCP tools call a browser-agnostic `BrowserDriver`
+(`src/browser/driver/`); `CdpDriver` implements it for Chrome over the Chrome
+DevTools Protocol. Each driver declares capabilities, and a tool whose
+capabilities the active browser lacks fails with
+`<tool> is not supported by <browser>`. `browser_status` reports the driven
+browser as `session.browser`.
+
+Planned drivers: Firefox on macOS
+([#58](https://github.com/everydaydevopsio/pilot/issues/58)), Firefox on Linux
+and Windows ([#59](https://github.com/everydaydevopsio/pilot/issues/59)), Safari
+on macOS ([#60](https://github.com/everydaydevopsio/pilot/issues/60)), and
+WebKit via Playwright
+([#61](https://github.com/everydaydevopsio/pilot/issues/61)).
+
 ## Project Structure
 
 ```
@@ -478,6 +494,7 @@ src/
 │   ├── browser-manager.ts  # BrowserManager orchestrator
 │   ├── chrome-launcher.ts  # Chrome process management
 │   ├── connection.ts       # CDP connection + reconnect
+│   ├── driver/             # BrowserDriver interface, CdpDriver, capability gating
 │   ├── events.ts           # CDP event listeners
 │   ├── sessions.ts         # Profile lock status and stop-all
 │   ├── tabs.ts             # Tab management
@@ -488,8 +505,8 @@ src/
 │   ├── performance/        # Tracing + analysis
 │   └── security/           # Origin allow/block lists
 ├── cli/                    # CLI commands (init, Linux preflight)
-├── commands/               # Tool command implementations
-├── mcp/                    # MCP server + tool registrations
+├── commands/               # CDP command implementations used by CdpDriver
+├── mcp/                    # MCP server + tool registrations (call BrowserDriver only)
 └── util/                   # Config, logger
 ```
 

package/dist/browser/driver/capabilities.d.ts

@@ -0,0 +1,22 @@
+import type { ToolName } from '../../mcp/tools/names.js';
+import type { BrowserKind, Capability } from './types.js';
+/**
+ * Capabilities each MCP tool needs from the active driver. Tools mapped to an
+ * empty list either manage the session itself (start/stop/status) or only read
+ * buffers that every driver fills.
+ */
+export declare const TOOL_CAPABILITIES: Readonly<Record<ToolName, readonly Capability[]>>;
+export declare class CapabilityError extends Error {
+    readonly tool: ToolName;
+    readonly browser: BrowserKind;
+    readonly missing: readonly Capability[];
+    constructor(tool: ToolName, browser: BrowserKind, missing: readonly Capability[]);
+}
+export declare function missingCapabilities(tool: ToolName, capabilities: ReadonlySet<Capability>): Capability[];
+export declare function assertToolSupported(tool: ToolName, driver: {
+    kind: BrowserKind;
+    capabilities: ReadonlySet<Capability>;
+}): void;
+/** Tools the given capability set cannot run, for status and docs output. */
+export declare function unsupportedTools(capabilities: ReadonlySet<Capability>): ToolName[];
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/browser/driver/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/browser/driver/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CACtC,MAAM,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC,CAuCxC,CAAC;AAEF,qBAAa,eAAgB,SAAQ,KAAK;IAEtC,QAAQ,CAAC,IAAI,EAAE,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,WAAW;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE;gBAF9B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,SAAS,UAAU,EAAE;CAO1C;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC,GACpC,UAAU,EAAE,CAEd;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC,CAAA;CAAE,GACnE,IAAI,CAKN;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC,GACpC,QAAQ,EAAE,CAIZ"}

package/dist/browser/driver/capabilities.js

@@ -0,0 +1,70 @@
+/**
+ * Capabilities each MCP tool needs from the active driver. Tools mapped to an
+ * empty list either manage the session itself (start/stop/status) or only read
+ * buffers that every driver fills.
+ */
+export const TOOL_CAPABILITIES = {
+    browser_start: [],
+    browser_stop: [],
+    browser_status: [],
+    browser_stop_all: [],
+    browser_connect: ['connectExisting'],
+    browser_screenshot: ['screenshot'],
+    browser_navigate: ['navigation'],
+    browser_click: ['input'],
+    browser_type: ['input'],
+    browser_evaluate: ['evaluate'],
+    browser_wait: ['evaluate'],
+    browser_page_info: ['evaluate'],
+    browser_list_tabs: ['tabs'],
+    browser_new_tab: ['tabs'],
+    browser_close_tab: ['tabs'],
+    browser_switch_tab: ['tabs'],
+    browser_tabs: ['tabs'],
+    browser_viewport_resize: ['viewport'],
+    browser_get_console_logs: ['console'],
+    browser_get_errors: ['console'],
+    browser_clear_errors: ['console'],
+    browser_console: ['console'],
+    browser_errors: ['console'],
+    browser_snapshot: ['accessibilitySnapshot'],
+    browser_find: ['accessibilitySnapshot'],
+    browser_fill: ['input'],
+    browser_hover: ['input'],
+    browser_press_key: ['input'],
+    browser_select: ['input'],
+    browser_check: ['input'],
+    browser_scroll: ['input'],
+    browser_network: ['network'],
+    browser_styles: ['styles'],
+    browser_dialog: ['dialogs'],
+    browser_upload: ['uploads'],
+    browser_downloads: ['downloads'],
+    browser_performance: ['performanceTrace']
+};
+export class CapabilityError extends Error {
+    tool;
+    browser;
+    missing;
+    constructor(tool, browser, missing) {
+        super(`${tool} is not supported by ${browser} (missing capabilities: ${missing.join(', ')}).`);
+        this.tool = tool;
+        this.browser = browser;
+        this.missing = missing;
+        this.name = 'CapabilityError';
+    }
+}
+export function missingCapabilities(tool, capabilities) {
+    return TOOL_CAPABILITIES[tool].filter((c) => !capabilities.has(c));
+}
+export function assertToolSupported(tool, driver) {
+    const missing = missingCapabilities(tool, driver.capabilities);
+    if (missing.length > 0) {
+        throw new CapabilityError(tool, driver.kind, missing);
+    }
+}
+/** Tools the given capability set cannot run, for status and docs output. */
+export function unsupportedTools(capabilities) {
+    return Object.keys(TOOL_CAPABILITIES).filter((tool) => missingCapabilities(tool, capabilities).length > 0);
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/browser/driver/capabilities.js.map

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

package/dist/browser/driver/cdp-driver.d.ts

@@ -0,0 +1,77 @@
+import { BrowserManager } from '../browser-manager.js';
+import type { LaunchOptions, SessionInfo, TabInfo } from '../types.js';
+import type { Config } from '../../util/config.js';
+import { type ViewportConfig } from '../../viewport.js';
+import { type CheckParams } from '../../commands/check.js';
+import { type ClickParams } from '../../commands/click.js';
+import { type DialogParams } from '../../commands/dialog.js';
+import { type EvaluateParams } from '../../commands/evaluate.js';
+import { type FillParams } from '../../commands/fill.js';
+import { type FindQuery } from '../../commands/find.js';
+import { type HoverParams } from '../../commands/hover.js';
+import { type NavigateParams } from '../../commands/navigate.js';
+import { type NetworkParams } from '../../commands/network.js';
+import { type PerformanceParams } from '../../commands/performance.js';
+import { type PressKeyParams } from '../../commands/press_key.js';
+import { type ScreenshotParams } from '../../commands/screenshot.js';
+import { type ScrollParams } from '../../commands/scroll.js';
+import { type SelectParams } from '../../commands/select.js';
+import { type StylesParams } from '../../commands/styles.js';
+import { type NewTabResult } from '../../commands/tabs.js';
+import { type TypeParams } from '../../commands/type.js';
+import { type UploadParams } from '../../commands/upload.js';
+import { type WaitParams } from '../../commands/wait.js';
+import { type BrowserDriver, type ConnectExistingOptions, type DriverSession, type ViewportResizeParams } from './types.js';
+/**
+ * Chrome driver over the Chrome DevTools Protocol. BrowserManager owns the
+ * Chrome process and CDP connection; this class wires CDP events into the
+ * session buffers and maps driver calls onto the CDP command implementations.
+ */
+export declare class CdpDriver implements BrowserDriver {
+    private readonly session;
+    private readonly manager;
+    readonly kind: "chrome";
+    readonly capabilities: ReadonlySet<"viewport" | "input" | "evaluate" | "dialogs" | "navigation" | "styles" | "tabs" | "screenshot" | "accessibilitySnapshot" | "console" | "network" | "uploads" | "downloads" | "performanceTrace" | "connectExisting">;
+    private monitoredClient;
+    constructor(session: DriverSession, manager: BrowserManager);
+    static create(config: Config, session: DriverSession): CdpDriver;
+    private onBrowserEvent;
+    private ensureMonitors;
+    private client;
+    launch(opts?: LaunchOptions): Promise<{
+        headless: boolean;
+        viewport: string;
+    }>;
+    connectExisting(opts: ConnectExistingOptions): Promise<{
+        tabs: TabInfo[];
+    }>;
+    destroy(): Promise<void>;
+    isConnected(): boolean;
+    getSessionInfo(): SessionInfo;
+    listTabs(): Promise<TabInfo[]>;
+    newTab(url?: string): Promise<NewTabResult>;
+    closeTab(targetId: string): Promise<void>;
+    switchTab(targetId: string): Promise<void>;
+    navigate(params: NavigateParams): Promise<import("../../commands/navigate.js").NavigateResult>;
+    pageInfo(): Promise<import("../../commands/page_info.js").PageInfoResult>;
+    evaluate(params: EvaluateParams): Promise<import("../../commands/evaluate.js").EvaluateResult>;
+    wait(params: WaitParams): Promise<import("../../commands/wait.js").WaitResult>;
+    screenshot(params: ScreenshotParams): Promise<import("../../commands/screenshot.js").ScreenshotResult>;
+    resizeViewport(params: ViewportResizeParams): Promise<ViewportConfig>;
+    snapshot(): Promise<import("../../commands/snapshot.js").SnapshotCommandResult>;
+    find(query: FindQuery): Promise<import("../../commands/find.js").FindCommandResult>;
+    styles(params: StylesParams): Promise<import("../../commands/styles.js").StylesCommandResult>;
+    click(params: ClickParams): Promise<import("../../commands/click.js").ClickResult>;
+    type(params: TypeParams): Promise<import("../../commands/type.js").TypeResult>;
+    fill(params: FillParams): Promise<import("../../commands/fill.js").FillResult>;
+    hover(params: HoverParams): Promise<import("../../commands/hover.js").HoverResult>;
+    pressKey(params: PressKeyParams): Promise<import("../../commands/press_key.js").PressKeyResult>;
+    select(params: SelectParams): Promise<import("../../commands/select.js").SelectResult>;
+    check(params: CheckParams): Promise<import("../../commands/check.js").CheckResult>;
+    scroll(params: ScrollParams): Promise<import("../../commands/scroll.js").ScrollResult>;
+    dialog(params: DialogParams): Promise<import("../../commands/dialog.js").DialogResult>;
+    upload(params: UploadParams): Promise<import("../../commands/upload.js").UploadResult>;
+    network(params: NetworkParams): Promise<import("../../commands/network.js").NetworkResult>;
+    performance(params: PerformanceParams): Promise<import("../../commands/performance.js").PerformanceResult>;
+}
+//# sourceMappingURL=cdp-driver.d.ts.map

package/dist/browser/driver/cdp-driver.d.ts.map

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

package/dist/browser/driver/cdp-driver.js

@@ -0,0 +1,190 @@
+import { BrowserManager } from '../browser-manager.js';
+import { resetCssState } from '../inspect/styles.js';
+import { attachDialogHandler } from '../interaction/dialogs.js';
+import { attachDownloadHandler, enableDownloads } from '../interaction/downloads.js';
+import { attachNetworkMonitor } from '../network/network-monitor.js';
+import { applyViewport } from '../../viewport.js';
+import { executeCheck } from '../../commands/check.js';
+import { executeClick } from '../../commands/click.js';
+import { executeDialog } from '../../commands/dialog.js';
+import { executeEvaluate } from '../../commands/evaluate.js';
+import { executeFill } from '../../commands/fill.js';
+import { executeFind } from '../../commands/find.js';
+import { executeHover } from '../../commands/hover.js';
+import { executeNavigate } from '../../commands/navigate.js';
+import { executeNetwork } from '../../commands/network.js';
+import { executePageInfo } from '../../commands/page_info.js';
+import { executePerformance } from '../../commands/performance.js';
+import { executePressKey } from '../../commands/press_key.js';
+import { executeScreenshot } from '../../commands/screenshot.js';
+import { executeScroll } from '../../commands/scroll.js';
+import { executeSelect } from '../../commands/select.js';
+import { executeSnapshot } from '../../commands/snapshot.js';
+import { executeStyles } from '../../commands/styles.js';
+import { executeCloseTab, executeListTabs, executeNewTab, executeSwitchTab } from '../../commands/tabs.js';
+import { executeType } from '../../commands/type.js';
+import { executeUpload } from '../../commands/upload.js';
+import { executeWait } from '../../commands/wait.js';
+import { CAPABILITIES } from './types.js';
+const CDP_CAPABILITIES = new Set(CAPABILITIES);
+/**
+ * Chrome driver over the Chrome DevTools Protocol. BrowserManager owns the
+ * Chrome process and CDP connection; this class wires CDP events into the
+ * session buffers and maps driver calls onto the CDP command implementations.
+ */
+export class CdpDriver {
+    session;
+    manager;
+    kind = 'chrome';
+    capabilities = CDP_CAPABILITIES;
+    monitoredClient = null;
+    constructor(session, manager) {
+        this.session = session;
+        this.manager = manager;
+        manager.setEventCallback((event, data) => this.onBrowserEvent(event, data));
+    }
+    static create(config, session) {
+        return new CdpDriver(session, new BrowserManager(config));
+    }
+    onBrowserEvent(event, data) {
+        if (event === 'console_message') {
+            this.session.consoleBuffer.push(data);
+        }
+        if (event === 'page_navigated') {
+            this.session.elementRefMap.invalidate();
+        }
+        if (event === 'browser_disconnected') {
+            this.monitoredClient = null;
+            resetCssState();
+            this.session.dialogQueue.clear();
+            this.session.downloadTracker.clear();
+            return;
+        }
+        // Covers browser_connected and tab switches, which swap the CDP client
+        // without emitting a connect event.
+        this.ensureMonitors();
+    }
+    ensureMonitors() {
+        const client = this.manager.getClient();
+        if (!client || client === this.monitoredClient)
+            return;
+        attachNetworkMonitor(client, this.session.networkBuffer);
+        attachDialogHandler(client, this.session.dialogQueue);
+        attachDownloadHandler(client, this.session.downloadTracker);
+        void enableDownloads(client).catch(() => {
+            // Download behavior setup may fail in some environments
+        });
+        this.monitoredClient = client;
+    }
+    client() {
+        const client = this.manager.getClient();
+        if (!client) {
+            throw new Error('Browser not started. Call browser_start first.');
+        }
+        return client;
+    }
+    launch(opts) {
+        return this.manager.launch(opts);
+    }
+    connectExisting(opts) {
+        return this.manager.connectExisting(opts);
+    }
+    destroy() {
+        return this.manager.destroy();
+    }
+    isConnected() {
+        return this.manager.isConnected();
+    }
+    getSessionInfo() {
+        return { browser: this.kind, ...this.manager.getSessionInfo() };
+    }
+    listTabs() {
+        return executeListTabs(this.manager);
+    }
+    newTab(url) {
+        return executeNewTab(this.manager, url);
+    }
+    closeTab(targetId) {
+        return executeCloseTab(this.manager, targetId);
+    }
+    switchTab(targetId) {
+        return executeSwitchTab(this.manager, targetId);
+    }
+    navigate(params) {
+        return executeNavigate(this.client(), this.manager, params);
+    }
+    pageInfo() {
+        return executePageInfo(this.client());
+    }
+    evaluate(params) {
+        return executeEvaluate(this.client(), params);
+    }
+    wait(params) {
+        return executeWait(this.client(), this.manager, params);
+    }
+    screenshot(params) {
+        return executeScreenshot(this.client(), params);
+    }
+    async resizeViewport(params) {
+        const client = this.client();
+        const current = this.manager.getViewportConfig();
+        const mobile = params.mobile ?? current?.mobile ?? false;
+        const config = {
+            width: params.width,
+            height: params.height,
+            deviceScaleFactor: params.deviceScaleFactor ?? current?.deviceScaleFactor ?? 1,
+            mobile,
+            responsive: false,
+            ...(mobile && current?.userAgent && { userAgent: current.userAgent })
+        };
+        await applyViewport(client, config);
+        this.manager.setViewportConfig(config);
+        return config;
+    }
+    snapshot() {
+        return executeSnapshot(this.client(), this.session.elementRefMap);
+    }
+    find(query) {
+        return executeFind(this.client(), this.session.elementRefMap, query);
+    }
+    styles(params) {
+        return executeStyles(this.client(), this.session.elementRefMap, params);
+    }
+    click(params) {
+        return executeClick(this.client(), params, this.session.elementRefMap);
+    }
+    type(params) {
+        return executeType(this.client(), params, this.session.elementRefMap);
+    }
+    fill(params) {
+        return executeFill(this.client(), this.session.elementRefMap, params);
+    }
+    hover(params) {
+        return executeHover(this.client(), this.session.elementRefMap, params);
+    }
+    pressKey(params) {
+        return executePressKey(this.client(), params);
+    }
+    select(params) {
+        return executeSelect(this.client(), this.session.elementRefMap, params);
+    }
+    check(params) {
+        return executeCheck(this.client(), this.session.elementRefMap, params);
+    }
+    scroll(params) {
+        return executeScroll(this.client(), this.session.elementRefMap, params);
+    }
+    dialog(params) {
+        return executeDialog(this.client(), this.session.dialogQueue, params);
+    }
+    upload(params) {
+        return executeUpload(this.client(), this.session.elementRefMap, params);
+    }
+    network(params) {
+        return executeNetwork(this.client(), this.session.networkBuffer, params);
+    }
+    performance(params) {
+        return executePerformance(this.client(), this.session.traceState, params);
+    }
+}
+//# sourceMappingURL=cdp-driver.js.map

package/dist/browser/driver/cdp-driver.js.map

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

package/dist/browser/driver/factory.d.ts

@@ -0,0 +1,10 @@
+import type { Config } from '../../util/config.js';
+import type { BrowserDriver, BrowserKind, DriverSession } from './types.js';
+/** Tracking issues for browsers that do not have a driver yet. */
+export declare const PLANNED_DRIVERS: Readonly<Record<Exclude<BrowserKind, 'chrome'>, string>>;
+export declare class UnsupportedBrowserError extends Error {
+    readonly browser: Exclude<BrowserKind, 'chrome'>;
+    constructor(browser: Exclude<BrowserKind, 'chrome'>);
+}
+export declare function createDriver(kind: BrowserKind, config: Config, session: DriverSession): BrowserDriver;
+//# sourceMappingURL=factory.d.ts.map

package/dist/browser/driver/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/browser/driver/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5E,kEAAkE;AAClE,eAAO,MAAM,eAAe,EAAE,QAAQ,CACpC,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAK/C,CAAC;AAEF,qBAAa,uBAAwB,SAAQ,KAAK;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC;gBAAvC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC;CAO7D;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,aAAa,CAKf"}

package/dist/browser/driver/factory.js

@@ -0,0 +1,23 @@
+import { CdpDriver } from './cdp-driver.js';
+/** Tracking issues for browsers that do not have a driver yet. */
+export const PLANNED_DRIVERS = {
+    firefox: 'https://github.com/everydaydevopsio/pilot/issues/58',
+    safari: 'https://github.com/everydaydevopsio/pilot/issues/60',
+    webkit: 'https://github.com/everydaydevopsio/pilot/issues/61'
+};
+export class UnsupportedBrowserError extends Error {
+    browser;
+    constructor(browser) {
+        super(`Pilot does not support ${browser} yet; only chrome is available. ` +
+            `Progress is tracked in ${PLANNED_DRIVERS[browser]}.`);
+        this.browser = browser;
+        this.name = 'UnsupportedBrowserError';
+    }
+}
+export function createDriver(kind, config, session) {
+    if (kind === 'chrome') {
+        return CdpDriver.create(config, session);
+    }
+    throw new UnsupportedBrowserError(kind);
+}
+//# sourceMappingURL=factory.js.map

package/dist/browser/driver/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/browser/driver/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAExB;IACF,OAAO,EAAE,qDAAqD;IAC9D,MAAM,EAAE,qDAAqD;IAC7D,MAAM,EAAE,qDAAqD;CAC9D,CAAC;AAEF,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC3B;IAArB,YAAqB,OAAuC;QAC1D,KAAK,CACH,0BAA0B,OAAO,kCAAkC;YACjE,0BAA0B,eAAe,CAAC,OAAO,CAAC,GAAG,CACxD,CAAC;QAJiB,YAAO,GAAP,OAAO,CAAgC;QAK1D,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAC1B,IAAiB,EACjB,MAAc,EACd,OAAsB;IAEtB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,6 @@
+export { CdpDriver } from './cdp-driver.js';
+export { TOOL_CAPABILITIES, CapabilityError, assertToolSupported, missingCapabilities, unsupportedTools } from './capabilities.js';
+export { createDriver, PLANNED_DRIVERS, UnsupportedBrowserError } from './factory.js';
+export { BROWSER_KINDS, CAPABILITIES } from './types.js';
+export type { BrowserDriver, BrowserKind, Capability, ConnectExistingOptions, DriverSession, ViewportResizeParams } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/driver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,uBAAuB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EACV,aAAa,EACb,WAAW,EACX,UAAU,EACV,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACrB,MAAM,YAAY,CAAC"}

package/dist/browser/driver/index.js

@@ -0,0 +1,5 @@
+export { CdpDriver } from './cdp-driver.js';
+export { TOOL_CAPABILITIES, CapabilityError, assertToolSupported, missingCapabilities, unsupportedTools } from './capabilities.js';
+export { createDriver, PLANNED_DRIVERS, UnsupportedBrowserError } from './factory.js';
+export { BROWSER_KINDS, CAPABILITIES } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/browser/driver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/driver/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,uBAAuB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/browser/driver/types.d.ts

@@ -0,0 +1,106 @@
+import type { ConsoleBuffer } from '../../mcp/console-buffer.js';
+import type { ElementRefMap } from '../inspect/element-ref.js';
+import type { DialogQueue } from '../interaction/dialogs.js';
+import type { DownloadTracker } from '../interaction/downloads.js';
+import type { NetworkBuffer } from '../network/network-buffer.js';
+import type { TraceState } from '../performance/trace.js';
+import type { LaunchOptions, SessionInfo, TabInfo } from '../types.js';
+import type { ViewportConfig } from '../../viewport.js';
+import type { CheckParams, CheckResult } from '../../commands/check.js';
+import type { ClickParams, ClickResult } from '../../commands/click.js';
+import type { DialogParams, DialogResult } from '../../commands/dialog.js';
+import type { EvaluateParams, EvaluateResult } from '../../commands/evaluate.js';
+import type { FillParams, FillResult } from '../../commands/fill.js';
+import type { FindCommandResult, FindQuery } from '../../commands/find.js';
+import type { HoverParams, HoverResult } from '../../commands/hover.js';
+import type { NavigateParams, NavigateResult } from '../../commands/navigate.js';
+import type { NetworkParams, NetworkResult } from '../../commands/network.js';
+import type { PageInfoResult } from '../../commands/page_info.js';
+import type { PerformanceParams, PerformanceResult } from '../../commands/performance.js';
+import type { PressKeyParams, PressKeyResult } from '../../commands/press_key.js';
+import type { ScreenshotParams, ScreenshotResult } from '../../commands/screenshot.js';
+import type { ScrollParams, ScrollResult } from '../../commands/scroll.js';
+import type { SelectParams, SelectResult } from '../../commands/select.js';
+import type { SnapshotCommandResult } from '../../commands/snapshot.js';
+import type { StylesCommandResult, StylesParams } from '../../commands/styles.js';
+import type { NewTabResult } from '../../commands/tabs.js';
+import type { TypeParams, TypeResult } from '../../commands/type.js';
+import type { UploadParams, UploadResult } from '../../commands/upload.js';
+import type { WaitParams, WaitResult } from '../../commands/wait.js';
+/** Browsers Pilot knows about. Only `chrome` has a driver today. */
+export declare const BROWSER_KINDS: readonly ["chrome", "firefox", "safari", "webkit"];
+export type BrowserKind = (typeof BROWSER_KINDS)[number];
+/**
+ * Features a driver may or may not provide. Each MCP tool declares the
+ * capabilities it needs (see capabilities.ts); a tool whose capabilities the
+ * active driver lacks fails with a CapabilityError before touching the browser.
+ */
+export declare const CAPABILITIES: readonly ["tabs", "navigation", "evaluate", "input", "screenshot", "viewport", "accessibilitySnapshot", "styles", "console", "network", "dialogs", "uploads", "downloads", "performanceTrace", "connectExisting"];
+export type Capability = (typeof CAPABILITIES)[number];
+/**
+ * Per-session buffers shared between a driver and the MCP tools. The driver
+ * fills them from browser events; tools such as browser_console read them
+ * directly.
+ */
+export interface DriverSession {
+    consoleBuffer: ConsoleBuffer;
+    elementRefMap: ElementRefMap;
+    networkBuffer: NetworkBuffer;
+    dialogQueue: DialogQueue;
+    downloadTracker: DownloadTracker;
+    traceState: TraceState;
+}
+export interface ConnectExistingOptions {
+    host?: string;
+    port?: number;
+}
+export interface ViewportResizeParams {
+    width: number;
+    height: number;
+    deviceScaleFactor?: number;
+    mobile?: boolean;
+}
+/**
+ * Browser-agnostic surface the MCP tools call. Each implementation owns its
+ * protocol (CDP, WebDriver BiDi, ...) and must not leak protocol types here.
+ */
+export interface BrowserDriver {
+    readonly kind: BrowserKind;
+    readonly capabilities: ReadonlySet<Capability>;
+    launch(opts?: LaunchOptions): Promise<{
+        headless: boolean;
+        viewport: string;
+    }>;
+    connectExisting(opts: ConnectExistingOptions): Promise<{
+        tabs: TabInfo[];
+    }>;
+    destroy(): Promise<void>;
+    isConnected(): boolean;
+    getSessionInfo(): SessionInfo;
+    listTabs(): Promise<TabInfo[]>;
+    newTab(url?: string): Promise<NewTabResult>;
+    closeTab(targetId: string): Promise<void>;
+    switchTab(targetId: string): Promise<void>;
+    navigate(params: NavigateParams): Promise<NavigateResult>;
+    pageInfo(): Promise<PageInfoResult>;
+    evaluate(params: EvaluateParams): Promise<EvaluateResult>;
+    wait(params: WaitParams): Promise<WaitResult>;
+    screenshot(params: ScreenshotParams): Promise<ScreenshotResult>;
+    resizeViewport(params: ViewportResizeParams): Promise<ViewportConfig>;
+    snapshot(): Promise<SnapshotCommandResult>;
+    find(query: FindQuery): Promise<FindCommandResult>;
+    styles(params: StylesParams): Promise<StylesCommandResult>;
+    click(params: ClickParams): Promise<ClickResult>;
+    type(params: TypeParams): Promise<TypeResult>;
+    fill(params: FillParams): Promise<FillResult>;
+    hover(params: HoverParams): Promise<HoverResult>;
+    pressKey(params: PressKeyParams): Promise<PressKeyResult>;
+    select(params: SelectParams): Promise<SelectResult>;
+    check(params: CheckParams): Promise<CheckResult>;
+    scroll(params: ScrollParams): Promise<ScrollResult>;
+    dialog(params: DialogParams): Promise<DialogResult>;
+    upload(params: UploadParams): Promise<UploadResult>;
+    network(params: NetworkParams): Promise<NetworkResult>;
+    performance(params: PerformanceParams): Promise<PerformanceResult>;
+}
+//# sourceMappingURL=types.d.ts.map