@everydaydevopsio/pilot 0.5.0

package/dist/util/config.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+const ConfigSchema = z.object({
+    cdpPort: z.number().int().min(1).max(65535).default(9222),
+    cdpHost: z.string().default('127.0.0.1'),
+    cdpRetryMs: z.number().int().min(100).default(2000),
+    cdpMaxRetryMs: z.number().int().min(1000).default(30000),
+    logLevel: z
+        .enum(['trace', 'debug', 'info', 'warn', 'error', 'fatal'])
+        .default('info'),
+    chromePath: z.string().optional(),
+    headless: z.boolean().default(true),
+    profileName: z.string().default('profile1'),
+    viewport: z.string().default('desktop'),
+    responsive: z.boolean().optional()
+});
+export function loadConfig(cliArgs = {}) {
+    const env = {
+        cdpPort: process.env.PILOT_CDP_PORT
+            ? parseInt(process.env.PILOT_CDP_PORT, 10)
+            : undefined,
+        cdpHost: process.env.PILOT_CDP_HOST,
+        cdpRetryMs: process.env.PILOT_CDP_RETRY_MS
+            ? parseInt(process.env.PILOT_CDP_RETRY_MS, 10)
+            : undefined,
+        cdpMaxRetryMs: process.env.PILOT_CDP_MAX_RETRY_MS
+            ? parseInt(process.env.PILOT_CDP_MAX_RETRY_MS, 10)
+            : undefined,
+        logLevel: process.env.PILOT_LOG_LEVEL,
+        chromePath: process.env.PILOT_CHROME_PATH,
+        headless: process.env.PILOT_HEADLESS !== undefined
+            ? process.env.PILOT_HEADLESS !== 'false'
+            : undefined,
+        profileName: process.env.PILOT_PROFILE_NAME,
+        viewport: process.env.PILOT_VIEWPORT,
+        responsive: process.env.PILOT_RESPONSIVE !== undefined
+            ? process.env.PILOT_RESPONSIVE !== 'false'
+            : undefined
+    };
+    const merged = {
+        cdpPort: cliArgs.cdpPort ?? env.cdpPort,
+        cdpHost: cliArgs.cdpHost ?? env.cdpHost,
+        cdpRetryMs: env.cdpRetryMs,
+        cdpMaxRetryMs: env.cdpMaxRetryMs,
+        logLevel: cliArgs.logLevel ?? env.logLevel,
+        chromePath: cliArgs.chromePath ?? env.chromePath,
+        headless: cliArgs.headless ?? env.headless,
+        profileName: cliArgs.profileName ?? env.profileName,
+        viewport: cliArgs.viewport ?? env.viewport,
+        responsive: cliArgs.responsive ?? env.responsive
+    };
+    return ConfigSchema.parse(merged);
+}
+//# sourceMappingURL=config.js.map

package/dist/util/config.js.map

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

package/dist/util/logger.d.ts

@@ -0,0 +1,4 @@
+import pino from 'pino';
+export declare function createLogger(level?: string): pino.Logger;
+export declare function getLogger(): pino.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/util/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB,wBAAgB,YAAY,CAAC,KAAK,SAAS,GAAG,IAAI,CAAC,MAAM,CAMxD;AAED,wBAAgB,SAAS,IAAI,IAAI,CAAC,MAAM,CAKvC"}

package/dist/util/logger.js

@@ -0,0 +1,16 @@
+import pino from 'pino';
+let _logger = null;
+export function createLogger(level = 'info') {
+    // Always write to stderr: this is an MCP server that communicates over stdio,
+    // so stdout must carry only MCP protocol messages. pino-pretty is a
+    // devDependency and is not available in production/global installs.
+    _logger = pino({ level }, process.stderr);
+    return _logger;
+}
+export function getLogger() {
+    if (!_logger) {
+        _logger = createLogger();
+    }
+    return _logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/util/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,IAAI,OAAO,GAAuB,IAAI,CAAC;AAEvC,MAAM,UAAU,YAAY,CAAC,KAAK,GAAG,MAAM;IACzC,8EAA8E;IAC9E,oEAAoE;IACpE,oEAAoE;IACpE,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,YAAY,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/viewport.d.ts

@@ -0,0 +1,105 @@
+import type { Client } from 'chrome-remote-interface';
+export interface ViewportConfig {
+    width: number;
+    height: number;
+    deviceScaleFactor: number;
+    mobile: boolean;
+    userAgent?: string;
+    responsive?: boolean;
+}
+export declare const VIEWPORT_PRESETS: {
+    desktop: {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: false;
+        responsive: true;
+    };
+    'desktop-small': {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: false;
+        responsive: true;
+    };
+    tablet: {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: true;
+        userAgent: string;
+    };
+    'tablet-landscape': {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: true;
+        userAgent: string;
+    };
+    mobile: {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: true;
+        userAgent: string;
+    };
+    'mobile-landscape': {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: true;
+        userAgent: string;
+    };
+    'mobile-small': {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: true;
+        userAgent: string;
+    };
+    'desktop-scaled': {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: false;
+    };
+    'desktop-qhd': {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: false;
+        responsive: true;
+    };
+    'mobile-pro': {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: true;
+        userAgent: string;
+    };
+    'mobile-large': {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: true;
+        userAgent: string;
+    };
+    'mobile-android': {
+        width: number;
+        height: number;
+        deviceScaleFactor: number;
+        mobile: true;
+        userAgent: string;
+    };
+};
+export type ViewportPresetName = keyof typeof VIEWPORT_PRESETS;
+export interface ResolveViewportOptions {
+    preset?: string;
+    width?: number;
+    height?: number;
+    deviceScaleFactor?: number;
+    responsive?: boolean;
+}
+export declare function resolveViewport(opts?: ResolveViewportOptions): ViewportConfig;
+export declare function applyViewport(client: Client, config: ViewportConfig): Promise<void>;
+//# sourceMappingURL=viewport.d.ts.map

package/dist/viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AA0BtD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAKD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFa,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,eAAe,CAC7B,IAAI,GAAE,sBAA2B,GAChC,cAAc,CAoBhB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/viewport.js

@@ -0,0 +1,145 @@
+const MOBILE_USER_AGENT = 'Mozilla/5.0 (Linux; Android 14; Pixel 8) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Mobile Safari/537.36';
+export const VIEWPORT_PRESETS = {
+    desktop: {
+        width: 1920,
+        height: 1080,
+        deviceScaleFactor: 1,
+        mobile: false,
+        responsive: true
+    },
+    'desktop-small': {
+        width: 1366,
+        height: 768,
+        deviceScaleFactor: 1,
+        mobile: false,
+        responsive: true
+    },
+    tablet: {
+        width: 768,
+        height: 1024,
+        deviceScaleFactor: 2,
+        mobile: true,
+        userAgent: MOBILE_USER_AGENT
+    },
+    'tablet-landscape': {
+        width: 1024,
+        height: 768,
+        deviceScaleFactor: 2,
+        mobile: true,
+        userAgent: MOBILE_USER_AGENT
+    },
+    mobile: {
+        width: 390,
+        height: 844,
+        deviceScaleFactor: 3,
+        mobile: true,
+        userAgent: MOBILE_USER_AGENT
+    },
+    'mobile-landscape': {
+        width: 844,
+        height: 390,
+        deviceScaleFactor: 3,
+        mobile: true,
+        userAgent: MOBILE_USER_AGENT
+    },
+    'mobile-small': {
+        width: 360,
+        height: 800,
+        deviceScaleFactor: 3,
+        mobile: true,
+        userAgent: MOBILE_USER_AGENT
+    },
+    'desktop-scaled': {
+        width: 1536,
+        height: 864,
+        deviceScaleFactor: 1.25,
+        mobile: false
+    },
+    'desktop-qhd': {
+        width: 2560,
+        height: 1440,
+        deviceScaleFactor: 1,
+        mobile: false,
+        responsive: true
+    },
+    'mobile-pro': {
+        width: 393,
+        height: 852,
+        deviceScaleFactor: 3,
+        mobile: true,
+        userAgent: MOBILE_USER_AGENT
+    },
+    'mobile-large': {
+        width: 430,
+        height: 932,
+        deviceScaleFactor: 3,
+        mobile: true,
+        userAgent: MOBILE_USER_AGENT
+    },
+    'mobile-android': {
+        width: 412,
+        height: 915,
+        deviceScaleFactor: 2.625,
+        mobile: true,
+        userAgent: MOBILE_USER_AGENT
+    }
+};
+export function resolveViewport(opts = {}) {
+    const presetName = opts.preset ?? 'desktop';
+    const presets = VIEWPORT_PRESETS;
+    const base = presets[presetName];
+    if (!base) {
+        const valid = Object.keys(VIEWPORT_PRESETS).join(', ');
+        throw new Error(`Unknown viewport preset "${presetName}". Valid presets: ${valid}`);
+    }
+    return {
+        ...base,
+        ...(opts.width !== undefined && { width: opts.width }),
+        ...(opts.height !== undefined && { height: opts.height }),
+        ...(opts.deviceScaleFactor !== undefined && {
+            deviceScaleFactor: opts.deviceScaleFactor
+        }),
+        ...(opts.responsive !== undefined && { responsive: opts.responsive })
+    };
+}
+export async function applyViewport(client, config) {
+    const emulation = client.Emulation;
+    const browser = client.Browser;
+    // Resize the actual browser window so it matches the viewport dimensions.
+    // This is needed because --window-size is unreliable (Chrome may restore
+    // a previous size from the profile) and setDeviceMetricsOverride only
+    // overrides the rendering viewport, not the window itself.
+    try {
+        const { windowId } = await browser.getWindowForTarget();
+        await browser.setWindowBounds({
+            windowId,
+            bounds: { width: config.width, height: config.height }
+        });
+    }
+    catch {
+        // Best-effort: headless Chrome or older versions may not support this.
+    }
+    // In responsive mode, skip setDeviceMetricsOverride so the page uses the
+    // real window dimensions and reflows naturally when the window is resized
+    // — just like a normal browser. This is the default for desktop presets.
+    if (!config.responsive) {
+        await emulation.setDeviceMetricsOverride({
+            width: config.width,
+            height: config.height,
+            deviceScaleFactor: config.deviceScaleFactor,
+            mobile: config.mobile
+        });
+    }
+    if (config.mobile) {
+        await emulation.setTouchEmulationEnabled({
+            enabled: true,
+            maxTouchPoints: 5
+        });
+    }
+    if (config.userAgent) {
+        await emulation.setUserAgentOverride({
+            userAgent: config.userAgent
+        });
+    }
+}
+//# sourceMappingURL=viewport.js.map

package/dist/viewport.js.map

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

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@everydaydevopsio/pilot",
+  "version": "0.5.0",
+  "description": "DevTools-grade browser control for AI agents via MCP + CDP",
+  "type": "module",
+  "main": "dist/mcp/index.js",
+  "bin": {
+    "pilot": "dist/mcp/index.js"
+  },
+  "scripts": {
+    "build": "rimraf ./dist && tsc",
+    "start": "node dist/mcp/index.js",
+    "dev": "tsx src/mcp/index.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "prettier": "prettier . --check",
+    "prettier:fix": "prettier . --write",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "test:e2e:mcp": "PILOT_HEADLESS=false jest --config jest.e2e-mcp.config.js --verbose",
+    "test:e2e:mcp:ci": "jest --config jest.e2e-mcp.config.js --verbose",
+    "test:e2e:mcp:docker": "docker compose -f docker-compose.e2e.yml up --build --abort-on-container-exit --exit-code-from e2e",
+    "pretest:smoke": "pnpm run build",
+    "test:smoke": "tsx smoke/mcp-smoke.ts",
+    "test:smoke:docker": "docker compose -f docker-compose.smoke.yml up --build --abort-on-container-exit --exit-code-from smoke"
+  },
+  "keywords": [
+    "browser",
+    "cdp",
+    "ai-agent",
+    "websocket",
+    "chrome"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "packageManager": "pnpm@10.33.2+sha512.a90faf6feeab71ad6c6e57f94e0fe1a12f5dcc22cd754db40ae9593eb6a3e0b6b12e3540218bb37ae083404b1f2ce6db2a4121e979829b4aff94b99f49da1cf8",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "ajv": "^8.17.1",
+    "chrome-remote-interface": "^0.34.0",
+    "pino": "^10.3.1",
+    "zod": "^4.4.3"
+  },
+  "pnpm": {
+    "overrides": {
+      "picomatch": ">=4.0.4"
+    },
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "unrs-resolver"
+    ]
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/chrome-remote-interface": "^0.34.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.4.0",
+    "eslint": "^10.8.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.6",
+    "globals": "^17.11.0",
+    "jest": "^30.4.2",
+    "pino-pretty": "^13.1.3",
+    "prettier": "^3.9.6",
+    "rimraf": "^6.1.3",
+    "ts-jest": "^29.4.12",
+    "tsx": "^4.23.12",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.67.0"
+  }
+}

package/smoke/mcp-smoke.ts

@@ -0,0 +1,161 @@
+/**
+ * MCP Smoke Test
+ *
+ * Verifies the MCP server starts and exposes the expected tool list.
+ * Does NOT require a running browser — no Chrome/Chromium needed.
+ *
+ * Output: one [PASS] / [FAIL] line per use case, then a final summary.
+ * Exit code: 0 if all checks pass, 1 on any failure.
+ */
+
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { resolve } from 'node:path';
+import { EXPECTED_TOOLS } from '../src/mcp/tools/names.js';
+
+const CONNECT_TIMEOUT_MS = 15_000;
+
+interface CheckResult {
+  name: string;
+  passed: boolean;
+  detail?: string;
+}
+
+const results: CheckResult[] = [];
+
+function pass(name: string, detail?: string): void {
+  results.push({ name, passed: true, detail });
+  const suffix = detail ? ` — ${detail}` : '';
+  console.log(`[PASS] ${name}${suffix}`);
+}
+
+function fail(name: string, detail?: string): void {
+  results.push({ name, passed: false, detail });
+  const suffix = detail ? ` — ${detail}` : '';
+  console.log(`[FAIL] ${name}${suffix}`);
+}
+
+function printSummary(): void {
+  const total = results.length;
+  const passed = results.filter((r) => r.passed).length;
+  const failed = total - passed;
+  console.log(`\n=== Results: ${passed}/${total} passed ===`);
+  if (failed === 0) {
+    console.log('SMOKE TEST PASSED');
+  } else {
+    const failures = results
+      .filter((r) => !r.passed)
+      .map((r) => `  - ${r.name}${r.detail ? `: ${r.detail}` : ''}`)
+      .join('\n');
+    console.log(`Failures:\n${failures}`);
+    console.log('SMOKE TEST FAILED');
+  }
+}
+
+function withTimeout<T>(
+  promise: Promise<T>,
+  ms: number,
+  label: string
+): Promise<T> {
+  return Promise.race([
+    promise,
+    new Promise<never>((_, reject) =>
+      setTimeout(
+        () => reject(new Error(`Timed out after ${ms}ms: ${label}`)),
+        ms
+      )
+    )
+  ]);
+}
+
+async function main(): Promise<void> {
+  console.log('=== MCP Smoke Test ===\n');
+
+  const transport = new StdioClientTransport({
+    command: 'node',
+    args: [resolve('dist/mcp/index.js')],
+    env: {
+      ...process.env,
+      NODE_ENV: 'test'
+    }
+  });
+
+  const client = new Client({ name: 'mcp-smoke-test', version: '1.0.0' });
+
+  // ── Use case 1: server starts and accepts a connection ─────────────────────
+  try {
+    await withTimeout(
+      client.connect(transport),
+      CONNECT_TIMEOUT_MS,
+      'client.connect'
+    );
+    pass('MCP server starts and accepts connections');
+  } catch (err) {
+    fail('MCP server starts and accepts connections', String(err));
+    printSummary();
+    process.exit(1);
+  }
+
+  // ── Use case 2: tools/list returns a non-empty list ────────────────────────
+  let toolNames: string[] = [];
+  try {
+    const response = await withTimeout(
+      client.listTools(),
+      CONNECT_TIMEOUT_MS,
+      'client.listTools'
+    );
+    toolNames = response.tools.map((t) => t.name);
+    if (toolNames.length > 0) {
+      pass('Tool list is non-empty', `${toolNames.length} tools returned`);
+    } else {
+      fail('Tool list is non-empty', 'server returned 0 tools');
+    }
+  } catch (err) {
+    fail('Tool list is non-empty', String(err));
+    await client.close().catch(() => undefined);
+    printSummary();
+    process.exit(1);
+  }
+
+  // ── Use case 3: expected tool count matches ────────────────────────────────
+  if (toolNames.length === EXPECTED_TOOLS.length) {
+    pass(
+      `Tool count matches expected`,
+      `${toolNames.length} of ${EXPECTED_TOOLS.length}`
+    );
+  } else {
+    fail(
+      `Tool count matches expected`,
+      `got ${toolNames.length}, want ${EXPECTED_TOOLS.length}`
+    );
+  }
+
+  // ── Use case 4: each expected tool is present ──────────────────────────────
+  for (const name of EXPECTED_TOOLS) {
+    if (toolNames.includes(name)) {
+      pass(`Tool registered: ${name}`);
+    } else {
+      fail(`Tool registered: ${name}`, 'missing from tool list');
+    }
+  }
+
+  // ── Use case 5: no unrecognised extra tools ────────────────────────────────
+  const extra = toolNames.filter((t) => !EXPECTED_TOOLS.includes(t as never));
+  if (extra.length === 0) {
+    pass('No unrecognised tools registered');
+  } else {
+    fail('No unrecognised tools registered', `unexpected: ${extra.join(', ')}`);
+  }
+
+  await client.close().catch(() => undefined);
+
+  printSummary();
+
+  const anyFailed = results.some((r) => !r.passed);
+  process.exit(anyFailed ? 1 : 0);
+}
+
+main().catch((err) => {
+  console.error('Unexpected error:', err);
+  process.exit(1);
+});